このガイドでは、GMA Next-Gen SDK を使用して AdMob メディエーションで BIGO Ads SDK の広告を読み込んで表示する方法を、入札の統合を含めて説明します。また、広告ユニットのメディエーション設定に BIGO Ads SDK を追加する方法と、BIGO Ads SDK とアダプタを Android アプリに統合する方法についても取り上げます。
サポートされている統合と広告フォーマット
BIGO Ads SDK のメディエーション アダプタには、次の機能があります。
| 統合 | |
|---|---|
| 入札 | 1 |
| ウォーターフォール | |
| フォーマット | |
| アプリを開く | |
| バナー | |
| インタースティシャル | |
| リワード | |
| リワード インタースティシャル | |
| ネイティブ | |
1 入札の統合はクローズド ベータ版です。アクセスをリクエストするには、アカウント マネージャーにお問い合わせください。
要件
- Android API レベル 24 以上
GMA Next-Gen SDK の最新動画
メディエーションのスタートガイドの手順を完了していること
ステップ 1: BIGO Ads SDK の UI で設定を行う
BIGO Ads ダッシュボードにログインします。
アプリを作成する
[在庫] タブに移動し、[アプリとサイト] の表で [+ 追加] ボタンを選択します。
フォームの残りの部分に記入し、[送信] をクリックします。
アプリケーション ID をメモします。
広告スロットを作成する
申請が審査されたら、[広告枠] テーブルに移動し、[+ 追加] ボタンを選択します。
[オークションの種類] で [サーバーサイド ビッディング] を選択し、フォームの残りの部分を入力して [送信] をクリックします。
スロット ID をメモします。
app-ads.txt を更新する
アプリの認定販売者 app-ads.txt は、IAB Tech Lab が推進するイニシアチブで、承認されたチャネルでのみアプリ広告枠を販売できるようにするものです。広告収入の大幅な減少を防ぐためには、app-ads.txt ファイルを実装する必要があります。まだ設定していない場合は、アプリの app-ads.txt ファイルを設定します。
BIGO Ads SDK の app-ads.txt を実装するには、ダッシュボードから [APP-ads.txt] タブに移動し、タブに記載されている手順に沿って操作します。
ステップ 2: AdMob の管理画面で BIGO Ads SDK のデマンドを設定する
広告ユニットのメディエーション設定を構成する
広告ユニットのメディエーション設定に BIGO Ads SDK を追加する必要があります。
まず、AdMob アカウントにログインします。次に、[メディエーション] タブに移動します。変更したい既存のメディエーション グループがある場合は、そのメディエーション グループの名前をクリックして編集し、広告のソースとして BIGO Ads SDK を追加するに進みます。
新しいメディエーション グループを作成するには、[メディエーション グループを作成] を選択します。
広告フォーマットとプラットフォームを入力し、[続行] をクリックします。
メディエーション グループに名前を付け、ターゲットとする地域を選択します。次に、メディエーション グループのステータスを [有効] に設定し、[広告ユニットを追加] をクリックします。
このメディエーション グループを、1 つ以上の既存の AdMob 広告ユニットに関連付けます。次に [完了] をクリックします。
広告ユニット カードに選択した広告ユニットが表示されます。
広告のソースとして BIGO Ads SDK を追加する
[広告ソース] セクションの [入札] カードで、[広告ソースを追加] を選択します。[BIGO Ads SDK] を選択します。
[パートナー契約への署名手順] をクリックし、BIGO Ads SDK との入札のパートナーシップを設定します。
[確認して同意する] をクリックし、[続行] をクリックします。
BIGO Ads SDK のマッピングがすでに存在する場合は、それを選択できます。それ以外の場合は、[マッピングを追加] をクリックします。
次に、前のセクションで取得したスロット ID を入力します。[完了] をクリックします。
GDPR と米国の州規制の広告パートナー リストに BIGO TECHNOLOGY PTE LTD を追加する
欧州の規制に関する設定と米国の州の規制に関する設定の手順に沿って、AdMob 管理画面の欧州および米国の州の規制に関する広告パートナーのリストに BIGO TECHNOLOGY PTE LTD を追加します。
ステップ 3: BIGO Ads の SDK とアダプタをインポートする
Android Studio の統合（推奨）
アプリレベルの Gradle ファイルに、次の実装依存関係と構成を追加します。
Kotlin
dependencies { implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.2.1") implementation("com.google.ads.mediation:bigo:5.9.0.1") } configurations.configureEach { exclude(group = "com.google.android.gms", module = "play-services-ads") exclude(group = "com.google.android.gms", module = "play-services-ads-lite") }
Groovy
dependencies { implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.2.1' implementation 'com.google.ads.mediation:bigo:5.9.0.1' } configurations.configureEach { exclude group: 'com.google.android.gms', module: 'play-services-ads' exclude group: 'com.google.android.gms', module: 'play-services-ads-lite' }
ステップ 4: BIGO Ads SDK にプライバシー設定を実装する
Google の EU ユーザーの同意ポリシーに準拠するには、欧州経済領域（EEA）、英国、スイスのユーザーに対して特定の情報を開示し、法律で義務付けられている場合は、Cookie やその他のローカル ストレージの使用、広告のパーソナライズを目的とした個人データの収集、共有、使用についてユーザーの同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則（GDPR）の要件が反映されています。パブリッシャー様には、同意がメディエーション チェーン内の各広告ソースに反映されていることを確認する責任があります。 Google は、同意に関するユーザーの選択をそのようなネットワークに自動的に渡すことはできません。
BIGO Ads SDK は、UMP SDK などの同意管理プラットフォームで設定された GDPR 同意を自動的に読み取ります。詳しくは、GDPR に関する BIGO Ads SDK の統合ガイドをご覧ください。
米国のプライバシー関連州法
米国のプライバシー関連州法では、ユーザーが「個人情報」の「販売」をオプトアウトする権利を付与することが義務付けられています（用語は法律の定義に基づく）。「販売者」のホームページには、「個人情報を第三者に売却しない」ことを明記したリンクを目立つように表示することによってオプトアウトの手段を提供する必要があります。米国のプライバシー関連州法遵守ガイドでは、Google 広告の配信で制限付きデータ処理を有効にできますが、Google がこの設定をメディエーション チェーン内の各広告ネットワークに適用することはできません。そのため、メディエーション チェーン内で個人情報の販売に関与する可能性のある広告ネットワークを特定し、各ネットワークのガイダンスに沿って州法を遵守する必要があります。
次のサンプルコードは、同意フラグを BIGO Ads SDK に渡す方法を示しています。GMA Next-Gen SDK を介して広告をリクエストする前に、このメソッドを呼び出します。
Java
BigoAdSdk.setUserConsent(context, ConsentOptions.CCPA, true);
Kotlin
BigoAdSdk.setUserConsent(context, ConsentOptions.CCPA, true)
詳しくは、CCPA に関する BIGO Ads SDK の統合ガイドをご覧ください。
ステップ 5: 必要なコードを追加する
BIGO Ads SDK の統合に、追加のコードは必要ありません。
ステップ 6: 実装をテストする
テスト広告を有効にする
AdMob 用のテストデバイスを登録してください。
BIGO Ads は、テストと統合に役立つ Android 向けのテスト用アプリケーション ID と広告スロット ID を提供しています。
テスト広告を確認する
BIGO Ads SDK からテスト広告を受信していることを確認するには、BIGO Ads SDK（入札）の広告ソースを使用して、広告インスペクタで単一の広告ソースのテストを有効にします。
省略可能な手順
ネイティブ広告
広告レンダリング
BIGO Ads SDK アダプタは、ネイティブ広告を NativeAd オブジェクトとして返します。NativeAd の次のフィールドに入力します。
| フィールド | BIGO Ads SDK アダプタによって常に含まれるアセット |
|---|---|
| 広告見出し | |
| 画像 | |
| 本文 | |
| アイコン | |
| 行動を促すフレーズ | |
| 評価 | |
| ストア | |
| 価格 | |
| 広告主様 |
エラーコード
アダプタが BIGO Ads SDK から広告を受け取れない場合は、次のクラスの ResponseInfo.getAdSourceResponses() を使用して、広告レスポンスからエラーの詳細を確認できます。
sg.bigo.ads
com.google.ads.mediation.bigo.BigoMediationAdapter
広告の読み込みに失敗した場合に BIGO Ads SDK アダプタがスローするコードとメッセージは次のとおりです。
| エラーコード | ドメイン | 理由 |
|---|---|---|
| 101 | com.google.mediation.bigoadapter | Bigo スロット ID がないか、空です。 |
| 1000-1100 | BIGO Ads SDK によって送信されたエラーコード | BIGO Ads SDK がエラーを返しました。詳しくは、BIGO Ads SDK のドキュメントをご覧ください。 |
Bigo Android メディエーション アダプタの変更履歴
バージョン 5.9.0.1
- Bigo の COPPA API に
AgeRestrictedTreatmentをマッピングします。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 25.4.0。
- Google Mobile Ads Next-Gen SDK バージョン 1.2.1。
- Bigo Ads SDK バージョン 5.9.0。
バージョン 5.9.0.0
- Bigo Ads SDK 5.9.0 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 25.2.0。
- Google Mobile Ads Next-Gen SDK バージョン 1.0.1。
- Bigo Ads SDK バージョン 5.9.0。
バージョン 5.8.0.0
- GMA Next-Gen SDK の依存関係を使用してアダプタをビルドするプロパティを追加しました。
- Bigo Ads SDK 5.8.0 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 25.1.0。
- Bigo Ads SDK バージョン 5.8.0。
バージョン 5.7.1.0
- Bigo Ads SDK 5.7.1 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 25.0.0。
- Bigo Ads SDK バージョン 5.7.1。
バージョン 5.7.0.0
tagForUnderAgeOfConsentGoogle Mobile Ads SDK パラメータを Bigo Ads SDK に転送するサポートを追加しました。- Bigo Ads SDK 5.7.0 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 24.9.0。
- Bigo Ads SDK バージョン 5.7.0。
バージョン 5.5.2.0
- バナー広告、インタースティシャル広告、リワード広告、ネイティブ広告のフォーマットのサポートを追加しました。
- Bigo Ads SDK 5.5.2 との互換性を確認しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 24.9.0。
- Bigo Ads SDK バージョン 5.5.2。