コンテンツにスキップ

アドバンス設定

広告プレースメント

各広告ユニットにプレースメント名を設定することができます(例:「Rewarded VideoLevels」、「INTER_levelEnd」、「RewardedVideoCoinStore」など)。 これにより、異なるプレースメントカテゴリーの統計を集計することができます。 以下のスニペットは、さまざまな広告フォーマットのプレースメント名を設定する方法を示しています。

バナーおよびMREC広告

AppLovinMAX.createBanner(«ad-unit-ID», «position»);
AppLovinMAX.setBannerPlacement(«ad-unit-ID», «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);

Verboseログの有効化

Verboseログを有効にするには、以下の呼び出しを行います:

AppLovinMAX.setVerboseLogging(true);

Verboseログを正常に有効化したことを確認するには、AppLovin SDKのログの初期化セクションに、Verbose Logging On: trueと表示される行を確認してください。

AppLovin SDK
Version: 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の値

説明
0Ad Load Not Attempted
1Ad Loaded
2Ad 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: Control
Waterfall latency was: 2793 milliseconds
Network 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 Error
Network 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 Ready
Network 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