BidMachine をメディエーションと統合する

プラットフォームを選択: Android Android iOS Unity Flutter

このガイドでは、Google Mobile Ads SDK を使用して BidMachine の広告を読み込んで表示する方法を説明します。AdMob メディエーション を使用し、入札の統合についても説明します。また、広告ユニットのメディエーション設定に BidMachine を追加する方法と、BidMachine SDK とアダプタを Android アプリに統合する方法についても取り上げます。

サポートされている統合と広告フォーマット

BidMachine 用のメディエーション アダプタには、次の機能があります。

¹ ウォーターフォール統合は クローズド ベータ版です。アクセス権をリクエストするには、アカウント マネージャーにお問い合わせください。

要件

• Android API レベル 23 以降

• [入札]: 入札でサポートされているすべての広告フォーマットを統合するには、 BidMachine アダプタ 3.4.0.1 以降を使用します（最新バージョンを推奨）。

• 最新の Google Mobile Ads SDK

• メディエーションのスタートガイドの手順を完了していること

ステップ 1: BidMachine の管理画面で構成を設定する

ログインして BidMachine アカウントのダッシュボードにアクセスします。

新しいプレースメントを作成する

[Source] タブに移動し、[Sources] 表で [Edit] ボタンを選択します。

プレースメントのリストが表示されます。新しいプレースメントを作成するには、ダイアログの [Add Placement] ボタンをクリックします。

[Placement Type] で [Bidding] を選択します。フォームに入力して [Save] をクリックします。

最後に、Placement ID をメモしておきます。

app-ads.txt を更新する

アプリの認定販売者 app-ads.txt は、IAB Tech Lab が推進するイニシアチブで、承認されたチャネルでのみアプリ広告枠を販売できるようにするものです。広告収入の大幅な減少を防ぐためには、app-ads.txt ファイルを実装する必要があります。まだ設定していない場合は、 アプリの app-ads.txt ファイルを設定します。

BidMachine 用に app-ads.txt を実装するには、[Dashboard] から [app-ads.txt] タブに移動します。次に、リストをコピーして、ウェブサイトの app-ads.txt ファイルに追加します。

ステップ 2: AdMob の UI で BidMachine のデマンドを設定する

広告ユニットのメディエーション設定を構成する

広告ユニットのメディエーション設定に BidMachine を追加する必要があります。

まず、AdMob アカウントにログインします。次に、[メディエーション] タブに移動します。変更したい既存のメディエーション グループがある場合は、 そのメディエーション グループの名前をクリックして編集し、 広告のソースとして BidMachine を追加するステップに進みます。

新しいメディエーション グループを作成するには、[メディエーション グループを作成] をクリックします。

広告フォーマットとプラットフォームを入力し、[続行] をクリックします。

メディエーション グループに名前を付け、ターゲットとする地域を選択します。次に、メディエーション グループのステータスを [有効] に設定し、[広告ユニットを追加] をクリックします。

このメディエーション グループを、1 つ以上の既存の AdMob 広告ユニットに関連付けます。次に [完了] をクリックします。

広告ユニット カードに選択した広告ユニットが表示されます。

広告のソースとして BidMachine を追加する

入札

[広告ソース] セクションの [入札] カードで、[広告ソースを追加] を選択します。次に [BidMachine] を選択します。

[**パートナー契約への署名手順**] をクリックし、 [入札パートナーシップを設定] して BidMachine と提携します。



[確認して同意する] をクリックし、[続行] をクリックします。



BidMachine のマッピングがすでにある場合は、 それを選択できます。それ以外の場合は、[マッピングを追加] をクリックします。



次に、前のセクションで取得した Source IDとPlacement ID を入力します。次に [完了] をクリックします。

ウォーターフォール

[広告ソース] セクションの [ウォーターフォール] カードで、[広告ソースを追加] を選択します。

[BidMachine] を選択します。 次に、BidMachine の eCPM 値 を入力し、[続行] をクリックします。



BidMachine のマッピングがすでにある場合は、それを選択できます。 それ以外の場合は、[マッピングを追加] をクリックします。

次に、 Placement ID を前のセクションで取得したものを入力します。次に [完了] をクリックします。

GDPR と米国の州規制の広告パートナー リストに BidMachine を追加する

欧州の規制に関する設定と米国の州の規制に関する設定の手順に沿って、AdMob 管理画面の欧州および米国の州の規制に関する広告パートナーのリストにBidMachine を追加します。

ステップ 3: BidMachine SDK とアダプタをインポートする

Android Studio の統合（推奨）

アプリレベルの Gradle ファイルに、次の実装の依存関係を追加します。

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.3.0")
    implementation("com.google.ads.mediation:bidmachine:3.7.0.0")
}

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.3.0'
    implementation 'com.google.ads.mediation:bidmachine:3.7.0.0'
}

ステップ 4: BidMachine SDK にプライバシー設定を実装する

Google の EU ユーザーの同意ポリシーに準拠する には、欧州経済領域（EEA）、英国、スイスの ユーザーに対して特定の情報を開示し、法律で 義務付けられている場合は、Cookie やその他のローカル ストレージの使用、広告の パーソナライズを目的とした個人データの収集、共有、使用について ユーザーの同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則（GDPR）の要件が反映されています。パブリッシャー様には、同意がメディエーション チェーン内の各広告ソースに反映されていることを確認する責任があります。 Google は、同意に関するユーザーの選択をそのようなネットワークに自動的に渡すことはできません。

BidMachine は、UMP SDK などの同意管理 プラットフォームによって設定された GDPR の同意を自動的に読み取ります。詳しくは、 GDPRをご覧ください。

米国のプライバシー関連州法

米国のプライバシー関連州法では、ユーザーが「個人情報」の「販売」をオプトアウトする権利を付与することが義務付けられています（用語は法律の定義に基づく）。「販売者」のホームページには、「個人情報を第三者に売却しない」ことを明記したリンクを目立つように表示することによってオプトアウトの手段を提供する必要があります。米国のプライバシー関連州法遵守ガイドでは、Google 広告の配信で制限付きデータ処理を有効にできますが、Google がこの設定をメディエーション チェーン内の各広告ネットワークに適用することはできません。そのため、メディエーション チェーン内で個人情報の販売に関与する可能性のある広告ネットワークを特定し、各ネットワークのガイダンスに沿って州法を遵守する必要があります。

BidMachine は、UMP SDK などの同意管理 プラットフォームによって設定された GPP の同意を自動的に読み取ります。詳しくは、 GPPをご覧ください。

ステップ 5: 必要なコードを追加する

BidMachine の統合に必要な追加のコードはありません。

ステップ 6: 実装をテストする

テスト広告を有効にする

AdMob 用のテストデバイスを登録してください。

BidMachine のテストモードを有効にするには、BidMachine の Android 向けドキュメントの手順に沿って操作します。

テスト広告を確認する

BidMachine からテスト広告を受信していることを確認するには、BidMachine（入札）の広告のソースを使用して、広告インスペクタで単一の広告ソースのテストを有効にします。

オプション ステップ

ネイティブ広告

広告レンダリング

BidMachine アダプタは、ネイティブ広告を NativeAd オブジェクトとして返します。次の フィールド に NativeAdのデータが入力されます。

エラーコード

アダプタが BidMachine から広告を受け取れない場合は、 次のクラスの ResponseInfo.getAdapterResponses() を使用して、広告レスポンスからエラーの詳細を確認できます。

io.bidmachine
com.google.ads.mediation.bidmachine

広告の読み込みに失敗した場合に BidMachine アダプタがスローするコードとメッセージは次のとおりです。

BidMachine Android メディエーション アダプタの変更履歴

次のバージョン

• AgeRestrictedTreatment を BidMachine の COPPA API にマッピングします。

バージョン 3.7.0.0

• BidMachine SDK バージョン 3.7.0 との互換性を確認しました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 25.1.0。
• Google Mobile Ads Next-Gen SDK バージョン 1.1.0。
• BidMachine SDK バージョン 3.7.0。

バージョン 3.6.1.0

• GMA Next-Gen SDK の依存関係を使用してアダプタをビルドするプロパティを追加しました。
• BidMachine SDK バージョン 3.6.1 との互換性を確認しました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 25.1.0。
• BidMachine SDK バージョン 3.6.1。

バージョン 3.5.1.2

• AdPlacementConfig を使用するように BidMachine アダプタを更新しました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 24.9.0。
• BidMachine SDK バージョン 3.5.1。

バージョン 3.5.1.1

• Google Mobile Ads SDK パラメータ tagForUnderAgeOfConsent を BidMachine SDK に転送するサポートを追加しました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 24.9.0。
• BidMachine SDK バージョン 3.5.1。

バージョン 3.5.1.0

• BidMachine SDK バージョン 3.5.1 との互換性を確認しました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 24.9.0。
• BidMachine SDK バージョン 3.5.1。

バージョン 3.5.0.0

• BidMachine SDK バージョン 3.5.0 との互換性を確認しました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 24.7.0。
• BidMachine SDK バージョン 3.5.0。

バージョン 3.4.0.1

• メモリリークの問題を解決するため、クラスレベルの Context オブジェクトへの参照を削除しました。
• 正確なサイズの一致を必要とせず、サポートされているフォーマットに近いサイズのバナー広告リクエストをサポートするようにアダプタを更新しました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 24.7.0。
• BidMachine SDK バージョン 3.4.0

バージョン 3.4.0.0

• バナー、インタースティシャル、リワード、ネイティブの広告フォーマットのウォーターフォール サポートを追加しました。
• アダプタが全画面広告の onAdOpened() を onAdImpression() で転送するようになりました。
• BidMachine SDK バージョン 3.4.0 との互換性を確認しました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 24.6.0。
• BidMachine SDK バージョン 3.4.0。

バージョン 3.3.0.0

• 初回リリース。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 24.5.0。
• BidMachine SDK バージョン 3.3.0。