アドバンス設定
広告プレースメント
各広告ユニットにプレースメント名を設定することができます(例:「Rewarded VideoLevels」、「INTER_levelEnd」、「RewardedVideoCoinStore」など)。 これにより、異なるプレースメントカテゴリーの統計を集計することができます。 以下のスニペットは、さまざまな広告フォーマットのプレースメント名を設定する方法を示しています。
バナーおよびMREC広告
AppLovinMAX.createBanner(«ad-unit-ID», «position»);AppLovinMAX.setBannerPlacement(«ad-unit-ID», «placement»);
import { AdView, AdFormat } from 'react-native-applovin-max';⋮<AdView adUnitId={«ad-unit-ID»} adFormat={AdFormat.BANNER} placement={«placement»} />
import { MRecAd } from 'react-native-applovin-max';⋮MRecAd.createAd(«ad-unit-ID», «position»);MRecAd.setPlacement(«ad-unit-ID», «placement»);
import { AdView, AdFormat } from 'react-native-applovin-max';⋮<AdView adUnitId={«ad-unit-ID»} adFormat={AdFormat.MREC} placement={«placement»} />
インタースティシャル広告
import { InterstitialAd } from 'react-native-applovin-max';⋮InterstitialAd.showAd(«ad-unit-ID», «placement»);
リワード広告
import { RewardedAd } from 'react-native-applovin-max';⋮RewardedAd.showAd(«ad-unit-ID», «placement»);
音声をミュート
アプリを起動する際に、一部のメディエーションSDKネットワークの音声をミュートすることができます。 AppLovin SDKをとおしてこの機能をサポートしているネットワークは、Google Bidding、 Google AdMob 、AppLovin、DT Exchange、 Google アド マネージャー、LINE、Mintegral、Tencent、Verveです。 他のネットワークについては、この機能が利用可能かどうか、またそのアクセス方法について、ネットワークのアカウントチームにお問い合わせください。
以下のコードスニペットは、この機能をサポートするネットワークで音声をミュートする方法を示しています。
AppLovinMAX.setMuted(true);
AppLovinMAX.setMuted(false);
Verboseログの有効化
Verboseログを有効にするには、以下の呼び出しを行います:
AppLovinMAX.setVerboseLogging(true);
Verboseログを正常に有効化したことを確認するには、AppLovin SDKのログの初期化セクションに、Verbose Logging On: true
と表示される行を確認してください。
AppLovin SDKVersion: 11.4.2⋮Verbose Logging On: true⋮
AppLovin SDKは、そのログに「/AppLovinSdk: [AppLovinSdk]
」というタグを付けます。
クリエイティブIDとネットワーク名
さまざまなメディエーションネットワークから表示された広告のクリエイティブIDとネットワーク名を取得できます。 詳細については、the Creative Debugger documentation を参照してください。
DSP名
AppLovin Exchangeから配信されたMAX広告のdspName
プロパティを使用して、DSP名を取得できます。
InterstitialAd.addAdLoadedEventListener((adInfo: AdInfo) = { console.log("AppLovin Exchange DSP Name: " + adInfo.dspName);}
インプレッションレベルのユーザー収益API
React Nativeプラグイン3.1.1より、クライアント側でインプレッションレベルのユーザー収益データにアクセスできるようになりました。 このデータは、異なるソースやキャンペーンの比較に利用できます。 また、MAXの ユーザー収益APIを使用して、このデータにアクセスすることも可能です。
サポートされているすべてのネットワークに対して、Adjust などのモバイル計測パートナーとインプレッションレベルの広告収益データを共有できます。
すべての広告ライフサイクルコールバックで、収益額を取得できます。 以下の例は、「広告収益支払い済み」コールバックでこれを行う方法を示しています。
InterstitialAd.addAdRevenuePaidListener((adInfo: AdRevenueInfo) => {…});RewardedAd.addAdRevenuePaidListener((adInfo: AdRevenueInfo) => {…});BannerAd.addAdRevenuePaidListener((adInfo: AdRevenueInfo) => {…});MRecAd.addAdRevenuePaidListener((adInfo: AdRevenueInfo) => {…});AppOpenAd.addAdRevenuePaidListener((adInfo: AdRevenueInfo) => {…});
InterstitialAd.addAdRevenuePaidListener((adInfo: AdRevenueInfo) => { const revenue = adInfo.revenue; // Miscellaneous data const countryCode = adInfo.countryCode; // "US" for the United States, etc - Note: Do not confuse this with currency code which is "USD" const networkName = adInfo.networkName; // Display name of the network that showed the ad const adUnitId = adInfo.adUnitId; // The MAX Ad Unit ID const placement = adInfo.placement; // The placement this ad's postbacks are tied to const networkPlacement = adInfo.networkPlacement; // The placement ID from the network that showed the ad});
特定ユニットのみの初期化
React Nativeモジュールバージョン6.1.0以降では、特定の広告ユニットに対してSDKを初期化できます。 このとき、SDKは、指定の広告ユニットに設定されたネットワークのみを初期化します。 (広告ユニットを指定しない場合、SDKは、現在のセッションにすべての広告ユニットが必要だと見なします。 その場合、広告ユニットに設定したすべてのネットワークが初期化されます。) 以下の例は、この機能の実装方法を示したものです。
AppLovinMAX.setInitializationAdUnitIds([ "«ad-unit-ID-1»", "«ad-unit-ID-2»" ]);AppLovinMAX.initialize(«SDK-key»).then((conf: Configuration) => { ... });
Waterfall Information API
Waterfall Information APIは、広告の現在のウォーターフォール(ロードされたもの、またはロードに失敗したもの)について通知します。APIは、ウォーターフォール内の各広告のロード状態、待ち時間、資格情報、およびメディエーションネットワーク情報を返します。 ウォーターフォール内の広告がロードに失敗した場合、APIはエラー情報を提供します。
このAPIは、React Nativeプラグインバージョン3.1.1でサポートされています。
adLoadStateの値
値 | 説明 |
---|---|
0 | Ad Load Not Attempted |
1 | Ad Loaded |
2 | Ad Failed To Load |
例
InterstitialAd.addAdLoadedEventListener((adInfo: AdInfo) => { console.log('Waterfall Name: ' + adInfo.waterfall.name + ' and Test Name: ' + adInfo.waterfall.testName); console.log('Waterfall latency was: ' + adInfo.waterfall.latencyMillis + ' milliseconds');
adInfo.waterfall.networkResponses.forEach((networkResponse: AdNetworkResponseInfo) => { console.log('Network name:' + networkResponse.mediatedNetwork.name + ' adapterClassName:'+ networkResponse.mediatedNetwork.adapterClassName + ' sdkVersion:' + networkResponse.mediatedNetwork.sdkVersion + ' adapterVersion:' + networkResponse.adapterVersion); console.log('...adLoadState:' + networkResponse.adLoadState); console.log('...latency:' + networkResponse.latencyMillis); });});
InterstitialAd.addAdLoadFailedEventListener((errorInfo: AdLoadFailedInfo) => { console.log('Waterfall Name: ' + errorInfo.waterfall.name + ' and Test Name: ' + errorInfo.waterfall.testName); console.log('Waterfall latency was: ' + errorInfo.waterfall.latencyMillis + ' milliseconds');
errorInfo.waterfall.networkResponses.forEach((networkResponse: AdNetworkResponseInfo) => { console.log('Network name:' + networkResponse.mediatedNetwork.name + ' adapterClassName:'+ networkResponse.mediatedNetwork.adapterClassName + ' sdkVersion:' + networkResponse.sdkVersion + ' adapterVersion:' + networkResponse.adapterVersion); console.log('...latency:' + networkResponse.latencyMillis); console.log('...error code:' + networkResponse.error.code + ' message:' + networkResponse.error.message); });});
アウトプット
Waterfall Name: Default Waterfall and Test Name: ControlWaterfall latency was: 2793 millisecondsNetwork adapterClassName:com.applovin.mediation.adapters.UnityAdsMediationAdapter name:Unity Ads sdkVersion:4.2.1.0 adapterVersion:4.2.1...adLoadState:2...latency:25...credentials placement_id:BN_0_9...error code:-5212 message:WebView ErrorNetwork adapterClassName:com.applovin.mediation.adapters.LineMediationAdapter name:LINE Ads sdkVersion:2.4.20211029 adapterVersion:2021.10.29.2...adLoadState:2...latency:275...credentials placement_id:872167...error code:-5205 message:Ad Not ReadyNetwork adapterClassName:com.applovin.mediation.adapters.ByteDanceMediationAdapter name:Pangle sdkVersion:4.3.0.9 adapterVersion:4.3.0.9...adLoadState:1...latency:337...credentials placement_id:980034018