Android向け広告品質SDKの統合
設定手順と設定の変更をカバーする、Android 向け LevelPlay 広告品質 SDK のインテグレーションを容易にします。
読み終わるまでの所要時間 9 分最終更新 6日前
広告品質を使用すると、ユーザーに表示される広告コンテンツを監視および管理して、アプリケーションの目標に即した広告が表示されるようにし、ユーザー体験を向上させることができます。オーディエンスにとって関連性の高い魅力的な広告を配信して、収益の可能性を最大化しましょう。
注
バージョン 8.9.0 から、広告品質は LevelPlay SDK に統合され、LevelPlay が実装されると自動的に初期化されます。LevelPlay がビルドに実装されていない場合、または 8.9.0 より前の LevelPlay SDK バージョンを使用している場合は、以下の手順が適用されます。
前提条件
ステップ別ガイドに従って、LevelPlay プラットフォームでアプリケーションを構成します。
ステップ 1: アプリケーションに広告品質 SDK をインポート
Gradle
- アプリケーションの build.gradle ファイル inside repositories セクションに、以下のコードを追加します。
repositories { mavenCentral()}
- 次に、 dependencies セクションに以下のコードを追加します。
dependencies { // Ad Quality SDK (standalone; from 8.9.0 Ad Quality is integrated in LevelPlay SDK) implementation 'com.unity3d.ads-mediation:adquality-sdk:9.3.1'}
ステップ 2: SDK を初期化する
- Unity LevelPlay プラットフォームにある LevelPlay キー 品質 SDK を初期化します。
- アプリケーションのメインスレッド、または他の広告ネットワークSDKと同じスレッドに以下のコードを追加して、広告品質SDKを初期化します。
import com.ironsource.adqualitysdk.sdk.IronSourceAdQuality;protected void onCreate(Bundle savedInstanceState) { // Initialize IronSourceAdQuality.getInstance().initialize(this, appKey);}
ステップ 3 (任意):高度な SDK 初期化
注
以下の設定を使用するには、LevelPlay SDK を初期化する前に広告品質 SDK を初期化します。
インテグレーション設定をカスタマイズすることで、さらに多くの機能を利用できます。
- ユーザー ID:広告品質のデフォルト ID の代わりに独自のユーザー ID を使用する
- テストモード:広告品質 SDK インテグレーションをテストします (デフォルトは false)
- ログレベル:コードの問題をデバッグするログレベルを選択します (デフォルトは INFO)
ビルダーで以下のコードを使用して、設定オブジェクトを作成します。
ISAdQualityConfig.Builder adQualityConfigBuilder = new ISAdQualityConfig.Builder();
ユーザー ID
広告品質 SDK には、ユーザー ID を設定するための 2 つのオプションがあります。
- 独自のユーザー ID を使用し、初期化の前または中に追加します。
adQualityConfigBuilder.setUserId(userId);// The default user id is Ad Quality internal id.// The user id cannot be null and must be between 2 and 100 characters, otherwise it will be blocked.
- デフォルトのユーザー ID は、後で ID が設定されるように、広告品質 SDK を初期化した後に変更してください。
IronSourceAdQuality.getInstance().changeUserId(userId);// The default user id is Ad Quality internal id.// The user id cannot be null and must be between 2 and 100 characters, otherwise it will be blocked.
テストモード
adQualityConfigBuilder.setTestMode(true); // The default is false - set to true only to test your Ad Quality integration
ログレベル
adQualityConfigBuilder.setLogLevel(ISAdQualityLogLevel.INFO);// There are 5 different log levels:// ERROR, WARNING, INFO, DEBUG, VERBOSE// The default is INFOISAdQualityConfig adQualityConfig = adQualityConfigBuilder.build();IronSourceAdQuality.getInstance().initialize(this, appKey, adQualityConfig);
ステップ 4 (任意):SDK コールバックイベントの設定
注
LevelPlay を使用している場合、以下の機能を使用する前に Ad Quality を初期化してください。
ISAdQualityInitListener:
ISAdQualityConfig.Builder builder = new ISAdQualityConfig.Builder().setAdQualityInitListener(new ISAdQualityInitListener() { @Override public void adQualitySdkInitSuccess() { Log.d("AdQualityInitListener", "adQualitySdkInitSuccess"); } @Override public void adQualitySdkInitFailed(ISAdQualityInitError error, String message) { Log.d("AdQualityInitListener", "adQualitySdkInitFailed " + error + " message: " + message); } }); ISAdQualityConfig adQualityConfig = builder.build();IronSourceAdQuality.getInstance().initialize(this, appKey, adQualityConfig);
注
Ad Quality SDK の初期化にかかる時間は、アプリに統合される広告ネットワーク SDK の数に応じて決まります。ネットワーク接続に問題があると、さらに遅延が生じる場合があります。平均して、初期化には 3 - 4 秒かかります。
ステップ 5 (任意):インプレッションレベルの広告収益を Ad Quality SDK にレポートする
注
LevelPlay を使用している場合、以下の機能を使用する前に Ad Quality を初期化してください。
注
特徴は全画面広告のみのサポートです。LevelPlay、MAX、DT FairBid では、このデータは自動的に収集されます。
広告品質SDK 7.2.0以降では、インプレッションレベルの広告収益レポートがサポートされます。
Ad Quality SDK でインプレッションレベルの広告収益をレポートするには、以下のコードスニペットを SDK インテグレーションに追加します。
重要
sendCustomMediationRevenueISAdQualityCustomMediationRevenue.Builder builder = new ISAdQualityCustomMediationRevenue.Builder() .setMediationNetwork(ISAdQualityMediationNetwork.SELF_MEDIATED) .setAdType(ISAdQualityAdType.REWARDED_VIDEO) .setPlacement("placement") .setRevenue(0.12);IronSourceAdQuality.getInstance().sendCustomMediationRevenue(builder.build());
AdMob メディエーションを使用している場合は、次の手順に従います。
- 担当の AdMob アカウントマネージャーに、AdMob インプレッションレベル LTV (iLTV) を有効にするよう依頼します。
- Android 用または iOS 用の GMA SDK 8.12.0 以上を使用していることを確認し、さらにそのバージョンで iLTV がサポートされることを確認します。
- Ad Quality SDK インテグレーションに以下のコードスニペットを追加します。
RewardedAd mRewardedAd; @Overridepublic void onAdLoaded(@NonNull RewardedAd rewardedAd) { mRewardedAd = rewardedAd; // Set paid event listener mRewardedAd.setOnPaidEventListener(new OnPaidEventListener() { @Override public void onPaidEvent(AdValue adValue) { ISAdQualityCustomMediationRevenue.Builder builder = new ISAdQualityCustomMediationRevenue.Builder() .setMediationNetwork(ISAdQualityMediationNetwork.ADMOB) .setAdType(ISAdQualityAdType.REWARDED_VIDEO) .setPlacement(mRewardedAd.getAdUnitId()) .setRevenue(adValue.getValueMicros()/1000000.0); IronSourceAdQuality.getInstance().sendCustomMediationRevenue(builder.build()); } });}