Adiscope React Native

• ${\color{red}Expo 지원 불가}$
• Android Target API Level : 31+
• Android Minimum API Level : 21
• iOS Minimum Version : 12.0
• Xcode Minimum Version : Xcode 15.1

Contents

Add the Adiscope package to Your Project

• Installation
• Setup Android
• Setup iOS

Adiscope Overview

• Import
• Initialize
• 사용자 정보 설정
• Offerwall
• RewardedVideo
• Interstitial
• RewardedInterstitial
• AdEvent
• Etc

웹사이트 필수 등록

Adiscope Server 연동하기

Privacy Manifest 정책 적용

Adiscope Error Information

etc

• Sample App 폴더 이동
• Releases

Add the Adiscope package to Your Project

1. Installation

A. Latest version Installation

npm install @adiscope.ad/adiscope-react-native

• 프로젝트의 IDE루트 경로에서 터미널을 열고 위과 같이 실행하여 설치

B. Specific version Installation

npm install @adiscope.ad/[email protected]

• 프로젝트의 IDE루트 경로에서 터미널을 열고 위과 같이 특정 버전을 추가로 실행하여 설치
  

2. Setup Android

A. Setup AndroidManifest

<application>
    <meta-data android:name="adiscope_media_id" android:value="${adiscope_media_id}"/>
    <meta-data android:name="adiscope_media_secret" android:value="${adiscope_media_secret}"/>
    <meta-data android:name="com.google.android.gms.ads.APPLICATION_ID" android:value="${adiscope_admob_id}"/>
</application>

• Android 프로젝트의 AndroidManifest.xml파일에 다음과 같은 설정
• meta-data 복사해서 변경 없이 추가 (아래 B의 Module Gradle의 변수 값을 참조 함)

B. Setup Module Gradle

android {
    defaultConfig {
        manifestPlaceholders = [
                adiscope_media_id    : "media id 기입 필요",
                adiscope_media_secret: "media secret 기입 필요",
                adiscope_sub_domain  : "sub domain 기입 필요",		// 옵션값 (오퍼월 상세페이지 이동 기능, 필요시 담당자 전달 예정)
                adiscope_admob_id    : "admob_app_id 기입 필요"           // Admob 사용 시 필요
        ]
    }
}

• 애디스콥 측에 media_id 와 media_secret, sub_domain 문의!
• adiscope_media_id: 매체 아이디
• adiscope_media_secret: 매체 시크릿키
• adiscope_sub_domain: 옵션값 (오퍼월 상세페이지 이동 기능, 필요시 담당자 전달 예정)
• adiscope_admob_id: admob을 접속 하기 위한 키
• 프로젝트 파일 내에 {projectroot}/android/app/build.gradle 파일에 manifestPlaceholders 추가
  

3. Setup iOS

A. Setup Podfile

target 'AdiscopeReactNativeExample' do
  config = use_native_modules!

  pod 'AdiscopeMediaAdManager', '3.10.0'
  pod 'AdiscopeMediaAdMob', '3.10.0'
  pod 'AdiscopeMediaChartBoost', '3.10.0'
  pod 'AdiscopeMediaPangle', '3.10.0'
  pod 'AdiscopeMediaVungle', '3.10.0'
  pod 'AdiscopeMediaMax', '3.10.0'
  pod 'AdiscopeMediaMaxAdapterAdMob', '3.10.0'
  pod 'AdiscopeMediaMaxAdapterAmazon', '3.10.0'
  pod 'AdiscopeMediaMaxAdapterBidMachine', '3.10.0'
  pod 'AdiscopeMediaMaxAdapterDTExchange', '3.10.0'
  pod 'AdiscopeMediaMaxAdapterFan', '3.10.0'
  pod 'AdiscopeMediaMaxAdapterInMobi', '3.10.0'
  pod 'AdiscopeMediaMaxAdapterMobVista', '3.10.0'
  pod 'AdiscopeMediaMaxAdapterMoloco', '3.10.0'
  pod 'AdiscopeMediaMaxAdapterOgury', '3.10.0'
  pod 'AdiscopeMediaMaxAdapterPangle', '3.10.0'
  pod 'AdiscopeMediaMaxAdapterUnityAds', '3.10.0'
  pod 'AdiscopeMediaMaxAdapterVungle', '3.10.0'

  use_react_native!(
    :path => config[:reactNativePath],
    # An absolute path to your application root.
    :app_path => "#{Pod::Config.instance.installation_root}/.."
  )

  target 'AdiscopeReactNativeExampleTests' do
    inherit! :complete
    # Pods for testing
  end

  post_install do |installer|
    # https://github.com/facebook/react-native/blob/main/packages/react-native/scripts/react_native_pods.rb#L197-L202
    react_native_post_install(
      installer,
      config[:reactNativePath],
      :mac_catalyst_enabled => false,
      # :ccache_enabled => true
    )
  end
end

• 프로젝트 파일 내에 {projectroot}/ios/Podfile 파일에 pod 추가
• Third Party 네트워크사들을 확인 후 필요한 네트워크사들만 추가
• Adapter Version이 상이할 경우 Initialize시 Xcode Log를 통해 확인 가능

B. Pod Install

pod install --repo-update

• 프로젝트 파일 내에 ios 폴더에서 다음의 명령어를 실행해서 Library를 Xcode Project로 추가

C. Setup Plist

• 프로젝트 파일 내에 {projectroot}/ios/{프로젝트 이름}/Info.plist 파일에 추가

가. AdiscopeMediaId, AdiscopeMediaSecret 추가

<key>AdiscopeMediaId</key>
<string>{media id 기입 필요}</string>
<key>AdiscopeMediaSecret</key>
<string>{media secret 기입 필요}</string>

나. App Tracking Permission 추가

<key>NSUserTrackingUsageDescription</key>
<string></string>

• ex : Some ad content may require access to the user tracking.

다. SKAdNetwork 추가 (Download)

<dict>
    <key>SKAdNetworkItems</key>
    <array>
	<dict>
	    <key>SKAdNetworkIdentifier</key>
	    <string></string>
	</dict>
    </array>
</dict>

• SKAdNetwork Download File 내용 추가 (Download)

라. Admob, Max의 Admob 사용 시 추가

<key>GADIsAdManagerApp</key>
<true/>
<key>GADApplicationIdentifier</key>
<string>{admob_app_id 기입 필요}</string>

• "GADIsAdManagerApp" 설정 및 "GADApplicationIdentifier"의 Key 설정

마. Max 사용 시 추가

<key>AppLovinSdkKey</key>
<string>{applovin_app_id 기입 필요}</string>

• AppLovinSdkKey의 Key 설정

D. AppDelegate 추가

가. Max의 InMobi 사용 시 추가

a. Object-C

@property (nonatomic, strong) UIWindow *window;

• iOS 폴더 내 AppDelegate.h 파일의 AppDelegate interface 내에 추가

b. Swift

var window: UIWindow?

• iOS 폴더 내 AppDelegate.swift 파일의 AppDelegate class 내에 추가

Adiscope Overview

1. Import

// 초기 실행
import { initialize4Adiscope, isInitialize4Adiscope, setUserId4Adiscope } from '@adiscope.ad/adiscope-react-native';
// Offerwall, RewardedVideo, Interstitial, RewardedInterstitial
import { useOfferwall4Adiscope, useRewardedVideo4Adiscope, useInterstitial4Adiscope,
  useRewardedInterstitial4Adiscope, useAdEvent4Adiscope } from '@adiscope.ad/adiscope-react-native';
// Other
import { getSDKVersion4Adiscope, getNetworksVersions4Adiscope, getUnitStatus4Adiscope, setVolumeOff4Adiscope, 
  showAdmobMediationDebugger4Adiscope, showMaxMediationDebugger4Adiscope } from '@adiscope.ad/adiscope-react-native';

• Adiscope을 사용하기 위해서 추가
  

2. Initialize

A. Code에서 Media 없이 Initialize 방법

const [statusInitialize, setStatusInitialize] = useState({
  isSuccess: false,
});

const result = await initialize4Adiscope();
setStatusInitialize(result);

• Android는 AndroidManifest 파일과 Module Gradle 파일 세팅 필요
• iOS는 Plist 파일 세팅 필요
• App 실행 시 1회 설정 권장
• Adiscope에서는 Google Play 가족 정책을 준수해야 함 (Android 전용 - Adiscope Google Play 가족 정책 확인)
  • ${정책\ {\color{red}미준수시}}\ 광고에\ 제한이\ 생김$ (광고 물량 축소 및 오퍼월 진입 불가)

B. Code에서 직접 Media 넣어서 Initialize 방법

const [statusInitialize, setStatusInitialize] = useState({
  isSuccess: false,
});

const mediaId = "";        // 관리자를 통해 발급
const mediaSecret = "";    // 관리자를 통해 발급
const callbackTag = "";    // 관리자를 통해 발급, 기본 ""
const childYN = "";        // 어린이 여부를 설정 해주는 값(Google GMA에 세팅)
const result = await initialize4Adiscope(mediaId, mediaSecret, callbackTag, childYN);
setStatusInitialize(result);

• App 실행 시 1회 설정 권장
• Adiscope에서는 Google Play 가족 정책을 준수해야 함 (Android 전용 - Adiscope Google Play 가족 정책 확인)
  • ${정책\ {\color{red}미준수시}}\ 광고에\ 제한이\ 생김$ (광고 물량 축소 및 오퍼월 진입 불가)

C. Callbacks

useEffect(() => {
  console.log(statusInitialize['isSuccess']);
}, [statusInitialize]);

• Initialize를 실행 해야 Callbacks 호출
• statusInitialize로 Initialize 결과를 받을 수 있음
  

3. 사용자 정보 설정

const userId = "";        // set unique user id to identify the user in reward information
await setUserId4Adiscope(userId);

• Offerwall, RewardedVideo, RewardedInterstitial를 사용하기 위해 ${\color{red}필수}$ 설정
• 64자까지 설정 가능
  

4. Offerwall

A. Hook 호출

const { showOfferwall4Adiscope, showOfferwallDetail4Adiscope, showOfferwallDetailFromUrl4Adiscope, 
  openedOfferwall4Adiscope, closedOfferwall4Adiscope, failedToShowOfferwall4Adiscope } = useOfferwall4Adiscope();

• 함수 및 콜백 변수를 사용 하기 위해서 선언

B. Show

const unitId = "";        // 관리자를 통해 발급
await showOfferwall4Adiscope(unitId);

• Show가 실행되면 (return값이 True일 경우) openedOfferwall4Adiscope와 failedToShowOfferwall4Adiscope 중 하나가 항상 호출되고, openedOfferwall4Adiscope가 호출되었다면 이후 closedOfferwall4Adiscope가 항상 호출

C. Callbacks

useEffect(() => {
  if (openedOfferwall4Adiscope) {
    console.log(openedOfferwall4Adiscope['unitId']);
  }
}, [openedOfferwall4Adiscope]);
useEffect(() => {
  if (closedOfferwall4Adiscope) {
    console.log(closedOfferwall4Adiscope['unitId']);
  }
}, [closedOfferwall4Adiscope]);
useEffect(() => {
  if (failedToShowOfferwall4Adiscope) {
    console.log(failedToShowOfferwall4Adiscope['unitId'] + ", " + failedToShowOfferwall4Adiscope['errorDescription'] + ", " + failedToShowOfferwall4Adiscope['errorXB3TraceID']);
  }
}, [failedToShowOfferwall4Adiscope]);

• Initialize를 실행 해야 Callbacks 호출
• Show 성공 시 openedOfferwall4Adiscope, closedOfferwall4Adiscope callback이 순차적으로 호출
• failedToShowOfferwall4Adiscope시 AdiscopeError 참고
  

5. RewardedVideo

A. Hook 호출

const { loadRewardedVideo4Adiscope, isLoadedRewardedVideo4Adiscope, showRewardedVideo4Adiscope,
  loadedRewardedVideo4Adiscope, failedToLoadRewardedVideo4Adiscope, openedRewardedVideo4Adiscope,
  closedRewardedVideo4Adiscope, rewardedRewardedVideo4Adiscope,
  failedToShowRewardedVideo4Adiscope } = useRewardedVideo4Adiscope();

• 함수 및 콜백 변수를 사용 하기 위해서 선언

B. Load

const unitId = "";      // 관리자를 통해 발급
await loadRewardedVideo4Adiscope(unitId);

• 해당 유닛에 속한 ad 네크워크들의 광고를 load
• Load가 실행되면 loadedRewardedVideo4Adiscope 와 failedToLoadRewardedVideo4Adiscope 중 하나의 callback은 항상 호출
• loadedRewardedVideo4Adiscope callback이 호출되면 load가 완료
• Load 동작 수행 중에 Load를 여러 번 호출할 수 없음
• Rewarded Video Ad의 Load와 Show는 pair로 호출
• Load를 한 후 Show를 하고, 광고를 Show한 후에는 다시 Load를 하여 다음 번 Show를 준비
• Load & Show 후 다시 Load를 하려 할 때 Load 는 Show 이후 언제든 호출가능
  • 광고가 Show되는 동안 다음 광고를 load를 할 수도 있지만 이는 사용하는 mediation ad network company의 종류에 따라 달라질 수 있으므로 항상 보장되는 동작은 아님
• Show의 callback 인 closedRewardedVideo4Adiscope에서 다시 Load를 하는 것을 권장
  • Abusing 방지를 위해 Rewarded Video Ad를 연속으로 보여주는 것을 제한하여 한번 광고를 보고 나면 일정 시간이 지난 후에 다시 Show를 할 수 있도로록 Admin page에서 서비스 설정 가능
• (Optional) Load의 시간이 필요해 ProgressBar 노출 추천

C. IsLoaded

const unitId = "";      // 관리자를 통해 발급
const result = await isLoadedRewardedVideo4Adiscope(unitId);
if (result) {
  // show ad here
} else {
  // do something else
}

• 광고가 Load 되었는지 상태를 확인

D. Show

const unitId = "";      // 관리자를 통해 발급
const result = await isLoadedRewardedVideo4Adiscope(unitId);
if (result) {
  const resultShow = await showRewardedVideo4Adiscope();
  if (resultShow) {
    // Success
  } else {
    // This Show request is duplicated
  }
} else {
  // ad is not loaded
}

• 마지막으로 Load된 광고를 사용자에게 보여줌
• Show 후에는 다시 Load를 호출 할 수 있음
• Show method는 중복하여 호출 할 수 없음
• Show가 실행되면 (return값이 True일 경우) openedRewardedVideo4Adiscope와 failedToShowRewardedVideo4Adiscope 중 하나가 항상 호출되고, openedRewardedVideo4Adiscope가 호출되었다면 이후 closedRewardedVideo4Adiscope가 항상 호출
• Rewarded Video Ad의 Load와 Show는 pair로 호출
  • Load를 한 후 Show를 하고, 광고를 Show한 후에는 다시 Load를 하여 다음번 Show를 준비 할 수 있음

E. Callback Reward

useEffect(() => {
  if (rewardedRewardedVideo4Adiscope) {
    console.log(rewardedRewardedVideo4Adiscope['amount'] + rewardedRewardedVideo4Adiscope['unit']);
  }
}, [rewardedRewardedVideo4Adiscope]);

• Initialize를 실행 해야 Callbacks 호출
• 보상이 주어져야 할 경우 rewardedRewardedVideo4Adiscope가 호출되며 그 parameter로 관련 정보가 전달
• 이 보상 정보를 바탕으로 게임 내에서 보상을 지급
• rewardedRewardedVideo4Adiscope는 보통 openedRewardedVideo4Adiscope 와 closedRewardedVideo4Adiscope 사이에 호출되는 경우가 많으나 광고 System의 상황에 따라 달라 질 수 있음
• rewardedRewardedVideo4Adiscope가 호출되지 않는 경우도 존재할 수 있음(Reward 설정을 Server-to-server로 하였다면, Video 시청 후에는 rewardedRewardedVideo4Adiscope가 호출되지 않음)
• Reward 정보는 abusing 방지를 위해서 Server-to-server 방식으로 전달 받는 것을 권장
• Server-to-server 방식을 선택하더라도 보상이 전달 될 시에는 rewardedRewardedVideo4Adiscope가 호출
  • 이때는 Server를 통해 전달받은 정보를 기준으로 처리하고, rewardedRewardedVideo4Adiscope를 통해 전달받은 정보는 검증용으로 사용하거나 무시하도록 함

F. Callback Others

useEffect(() => {
  if (loadedRewardedVideo4Adiscope) {
    console.log(loadedRewardedVideo4Adiscope['unitId']);
  }
}, [loadedRewardedVideo4Adiscope]);
useEffect(() => {
  if (failedToLoadRewardedVideo4Adiscope) {
    console.log(failedToLoadRewardedVideo4Adiscope['unitId'] + ", " + failedToLoadRewardedVideo4Adiscope['errorDescription'] + ", " + failedToLoadRewardedVideo4Adiscope['errorXB3TraceID']);
  }
}, [failedToLoadRewardedVideo4Adiscope]);
useEffect(() => {
  if (openedRewardedVideo4Adiscope) {
    console.log(openedRewardedVideo4Adiscope['unitId']);
  }
}, [openedRewardedVideo4Adiscope]);
useEffect(() => {
  if (closedRewardedVideo4Adiscope) {
    console.log(closedRewardedVideo4Adiscope['unitId']);
  }
}, [closedRewardedVideo4Adiscope]);
useEffect(() => {
  if (failedToShowRewardedVideo4Adiscope) {
    console.log(failedToShowRewardedVideo4Adiscope['unitId'] + ", " + failedToShowRewardedVideo4Adiscope['errorDescription'] + ", " + failedToShowRewardedVideo4Adiscope['errorXB3TraceID']);
  }
}, [failedToShowRewardedVideo4Adiscope]);

• Initialize를 실행 해야 Callbacks 호출
• Load 성공 시 loadedRewardedVideo4Adiscope, 실패 시 failedToLoadRewardedVideo4Adiscope가 호출
• Show 성공 시 openedRewardedVideo4Adiscope, closedRewardedVideo4Adiscope가 순차적으로 호출되고, 실패시 failedToShowRewardedVideo4Adiscope가 호출
• failedToLoadRewardedVideo4Adiscope, failedToShowRewardedVideo4Adiscope시 AdiscopeError 참고
  

6. Interstitial

A. Hook 호출

const { loadInterstitial4Adiscope, isLoadedInterstitial4Adiscope, showInterstitial4Adiscope,
  loadedInterstitial4Adiscope, failedToLoadInterstitial4Adiscope, openedInterstitial4Adiscope,
  closedInterstitial4Adiscope, failedToShowInterstitial4Adiscope } = useInterstitial4Adiscope();

• 함수 및 콜백 변수를 사용 하기 위해서 선언

B. Load

const unitId = "";      // 관리자를 통해 발급
await loadInterstitial4Adiscope(unitId);

• 해당 유닛에 속한 ad 네크워크들의 광고를 Load
• loadedInterstitial4Adiscope callback이 호출되면 Load가 완료
• Interstitial의 Load와 Show는 pair로 호출
• Load를 한 후 Show를 하고, 광고를 Show한 후에는 다시 Load를 하여 다음 번 Show를 준비
• 광고가 Show되는 동안 다음 광고를 load를 할 수도 있지만 이는 사용하는 mediation ad network company의 종류에 따라 달라질 수 있으므로 항상 보장되는 동작은 아님
• Load 동작 수행 중에 Load를 여러 번 호출할 수 없음
• (Optional) Load의 시간이 필요해 ProgressBar 노출 추천

C. IsLoaded

const unitId = "";      // 관리자를 통해 발급
const result = await isLoadedInterstitial4Adiscope(unitId);
if (result) {
  // show ad here
} else {
  // do something else
}

• 광고가 Load 되었는지 상태를 확인

D. Show

const unitId = "";      // 관리자를 통해 발급
const result = await isLoadedInterstitial4Adiscope(unitId);
if (result) {
  bool resultShow = await showInterstitial4Adiscope();
  if (resultShow) {
    // Success
  } else {
    // This Show request is duplicated
  }
} else {
  // ad is not loaded
}

• 마지막으로 load된 광고를 사용자에게 보여줌
• Show 호출 후에는 다시 load를 호출
• Show method는 중복하여 호출 할 수 없음
• Show가 실행되면 (return값이 True일 경우) loadedInterstitial4Adiscope와 failedToLoadInterstitial4Adiscope 중 하나가 항상 호출되고, openedInterstitial4Adiscope가 호출되었다면 이후 closedInterstitial4Adiscope가 항상 호출
• Interstitial Ad의 Load와 Show는 pair로 호출
  • Load를 한 후 Show를 하고, 광고를 Show한 후에는 다시 Load를 하여 다음번 Show를 준비 할 수 있음

E. Callback

useEffect(() => {
  if (loadedInterstitial4Adiscope) {
    console.log(loadedInterstitial4Adiscope['unitId']);
  }
}, [loadedInterstitial4Adiscope]);
useEffect(() => {
  if (failedToLoadInterstitial4Adiscope) {
    console.log(failedToLoadInterstitial4Adiscope['unitId'] + ", " + failedToLoadInterstitial4Adiscope['errorDescription'] + ", " + failedToLoadInterstitial4Adiscope['errorXB3TraceID']);
  }
}, [failedToLoadInterstitial4Adiscope]);
useEffect(() => {
  if (openedInterstitial4Adiscope) {
    console.log(openedInterstitial4Adiscope['unitId']);
  }
}, [openedInterstitial4Adiscope]);
useEffect(() => {
  if (closedInterstitial4Adiscope) {
    console.log(closedInterstitial4Adiscope['unitId']);
  }
}, [closedInterstitial4Adiscope]);
useEffect(() => {
  if (failedToShowInterstitial4Adiscope) {
    console.log(failedToShowInterstitial4Adiscope['unitId'] + ", " + failedToShowInterstitial4Adiscope['errorDescription'] + ", " + failedToShowInterstitial4Adiscope['errorXB3TraceID']);
  }
}, [failedToShowInterstitial4Adiscope]);

• Initialize를 실행 해야 Callbacks 호출
• Load 성공 시 loadedInterstitial4Adiscope, 실패 시 failedToLoadInterstitial4Adiscope가 호출
• Show 성공 시 openedInterstitial4Adiscope, closedInterstitial4Adiscope가 순차적으로 호출되고, 실패 시 failedToShowInterstitial4Adiscope가 호출
• failedToLoadInterstitial4Adiscope, failedToShowInterstitial4Adiscope시 AdiscopeError 참고
  

7. RewardedInterstitial

A. Hook 호출

const { preLoadAllRewardedInterstitial4Adiscope, preLoadRewardedInterstitial4Adiscope,
  showRewardedInterstitial4Adiscope, skipRewardedInterstitial4Adiscope, rewardedRewardedInterstitial4Adiscope,
  openedRewardedInterstitial4Adiscope, closedRewardedInterstitial4Adiscope,
  failedToShowRewardedInterstitial4Adiscope } = useRewardedInterstitial4Adiscope();

• 함수 및 콜백 변수를 사용 하기 위해서 선언

B. PreLoadAll

await preLoadAllRewardedInterstitial4Adiscope();

• Initialize Call Back 후 1회 설정 권장
• 관리자가 설정된 활성화된 모든 유닛들을 Load 진행

C. Unit 지정 PreLoad

const unitIds = [];
unitIds.push(unitId1);
unitIds.push(unitId2);
await preLoadRewardedInterstitial4Adiscope(unitIds);

• Initialize Call Back 후 1회 설정 권장
• 입력된 유닛들을 Load 진행

D. Show

const unitId = "";      // 관리자를 통해 발급
const result = await showRewardedInterstitial4Adiscope(unitId);

• 해당 유닛이 Load되어 있으면 안내 팝업을 보여 준 뒤 해당 광고를 사용자에게 보여줌
• Show method는 중복하여 호출 할 수 없음
• showRewardedInterstitial4Adiscope가 실행되면 (return값이 True일 경우) skipRewardedInterstitial4Adiscope와 openedRewardedInterstitial4Adiscope와 failedToShowRewardedInterstitial4Adiscope 중 하나가 항상 호출되고, openedRewardedInterstitial4Adiscope가 호출되었다면 이후 closedRewardedInterstitial4Adiscope가 항상 호출
• closedRewardedInterstitial4Adiscope와 failedToShowRewardedInterstitial4Adiscope가 호출 되면 내부에서 해당 유닛을 자동 Load 시킴

E. Callbacks Reward

useEffect(() => {
  if (rewardedRewardedInterstitial4Adiscope) {
    console.log(rewardedRewardedInterstitial4Adiscope['amount'] + rewardedRewardedInterstitial4Adiscope['unit']);
  }
}, [rewardedRewardedInterstitial4Adiscope]);

• Initialize를 실행 해야 Callbacks 호출
• 보상이 주어져야 할 경우 rewardedRewardedInterstitial4Adiscope가 호출되며 그 parameter로 관련 정보가 전달
• 이 보상 정보를 바탕으로 게임 내에서 보상을 지급
• rewardedRewardedInterstitial4Adiscope는 보통 openedRewardedInterstitial4Adiscope 와 closedRewardedInterstitial4Adiscope 사이에 호출되는 경우가 많으나 광고 System의 상황에 따라 달라 질 수 있음
• rewardedRewardedInterstitial4Adiscope가 호출되지 않는 경우도 존재할 수 있음(Reward 설정을 Server-to-server로 하였다면, Video 시청 후에는 rewardedRewardedInterstitial4Adiscope가 호출되지 않음)
• Reward 정보는 abusing 방지를 위해서 Server-to-server 방식으로 전달 받는 것을 권장
• Server-to-server 방식을 선택하더라도 보상이 전달 될 시에는 rewardedRewardedInterstitial4Adiscope가 호출
  • 이때는 Server를 통해 전달받은 정보를 기준으로 처리하고, rewardedRewardedInterstitial4Adiscope를 통해 전달받은 정보는 검증용으로 사용하거나 무시하도록 함

F. Callback Others

useEffect(() => {
  if (skipRewardedInterstitial4Adiscope) {
    console.log(skipRewardedInterstitial4Adiscope['unitId']);
  }
}, [skipRewardedInterstitial4Adiscope]);
useEffect(() => {
  if (openedRewardedInterstitial4Adiscope) {
    console.log(openedRewardedInterstitial4Adiscope['unitId']);
  }
}, [openedRewardedInterstitial4Adiscope]);
useEffect(() => {
  if (closedRewardedInterstitial4Adiscope) {
    console.log(closedRewardedInterstitial4Adiscope['unitId']);
  }
}, [closedRewardedInterstitial4Adiscope]);
useEffect(() => {
  if (failedToShowRewardedInterstitial4Adiscope) {
    console.log(failedToShowRewardedInterstitial4Adiscope['unitId'] + ", " + failedToShowRewardedInterstitial4Adiscope['errorDescription'] + ", " + failedToShowRewardedInterstitial4Adiscope['errorXB3TraceID']);
  }
}, [failedToShowRewardedInterstitial4Adiscope]);

• Initialize를 실행 해야 Callbacks 호출
• Show 성공 후 Skip 시 skipRewardedInterstitial4Adiscope가 호출
• Show 성공 후 영상 시청 시 openedRewardedInterstitial4Adiscope, closedRewardedInterstitial4Adiscope가 순차적으로 호출되고, 실패 시 failedToShowRewardedInterstitial4Adiscope가 호출
• failedToShowRewardedInterstitial4Adiscope시 AdiscopeError 참고
  

8. AdEvent

A. Hook 호출

const { showAdEvent4Adiscope, openedAdEvent4Adiscope, closedAdEvent4Adiscope, failedToShowAdEvent4Adiscope } = useAdEvent4Adiscope();

• 함수 및 콜백 변수를 사용 하기 위해서 선언

B. Show

const unitId = "";        // 관리자를 통해 발급
await showAdEvent4Adiscope(unitId);

• Show가 실행되면 (return값이 True일 경우) openedAdEvent4Adiscope와 failedToShowAdEvent4Adiscope 중 하나가 항상 호출되고, openedAdEvent4Adiscope가 호출되었다면 이후 closedAdEvent4Adiscope가 항상 호출

C. Callbacks

useEffect(() => {
  if (openedAdEvent4Adiscope) {
    console.log(openedAdEvent4Adiscope['unitId']);
  }
}, [openedAdEvent4Adiscope]);
useEffect(() => {
  if (closedAdEvent4Adiscope) {
    console.log(closedAdEvent4Adiscope['unitId']);
  }
}, [closedAdEvent4Adiscope]);
useEffect(() => {
  if (failedToShowAdEvent4Adiscope) {
    console.log(failedToShowAdEvent4Adiscope['unitId'] + ", " + failedToShowAdEvent4Adiscope['errorDescription'] + ", " + failedToShowAdEvent4Adiscope['errorXB3TraceID']);
  }
}, [failedToShowAdEvent4Adiscope]);

• Initialize를 실행 해야 Callbacks 호출
• Show 성공 시 openedAdEvent4Adiscope, closedAdEvent4Adiscope callback이 순차적으로 호출
• failedToShowAdEvent4Adiscope시 AdiscopeError 참고
  

9. Etc

A. Adiscope SDK Version

const result = await getSDKVersion4Adiscope();

• Android와 iOS의 Core SDK Version 확인

B. Adiscope Network Versions

const result = await getNetworksVersions4Adiscope();

• Android와 iOS의 Third Party SDK Versions 확인

C. Set Rewarded Check Param

const result = await setRewardedCheckParam4Adiscope(param);

• Rewarded callback 시 parameters을 추가
• 해당 정보는 Rewarded 지급 등에 있어 구분하는데 사용 할 수 있음
• 내부 설정 후 사용 가능 ( 담당자에게 요청 부탁 )
• param은 Base64 Encoded(UTF8)를 처리 후 1000자내로 설정

D. Volume

const isOff = true;  // Ad Sound Off
const isOff = false; // Ad Sound On (Default)
await setVolumeOff4Adiscope(isOff);
if (isOff) {
  console.log("Ad Sound Off");
} else {
  console.log("Ad Sound On");
}

• Admob, AppLovin, Mintegral, Verve 만 적용 가능
  

웹사이트 필수 등록 (Android 전용)

• 관리자에게 전달받은 app-ads.txt를 웹사이트에 등록

• app-ads.txt 등록 방법 및 정보

Adiscope Server 연동하기

• 연동하기

Privacy Manifest 정책 적용 (iOS 전용)

• 2024년 5월 1일부터 출시/업데이트 되는 앱에 대해 3rd Party Framework의 개인정보 추가

• 참고

Adiscope Error Information

• Error 정보

Adiscope Sample App

• Sample App 폴더 이동

Releases

• Releases