Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

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

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

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

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

統合
入札
ウォーターフォール	¹
フォーマット
アプリの起動
バナー
インタースティシャル
リワード
リワードインタースティシャル

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

前提条件

続行する前に、次のことを確認してください。

最新の Google Mobile Ads Unity Plugin バージョン。
Unity Editor バージョン 2019.4 以降。
Android にデプロイする場合
- Android API レベル 24 以降。
iOS にデプロイする場合
- iOS のデプロイターゲット 13.0 以降。
Google Mobile Ads Unity Plugin で構成された正常に動作する Unity プロジェクト。詳しくは、スタートガイドをご覧ください。

AdMob メディエーションを設定する

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

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

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

[ソース] タブに移動し、[ソース] テーブルで [編集] ボタンを選択します。

[Sources] ダッシュボード

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

[ソースを編集] ダイアログ

[プレースメントタイプ] として [入札] を選択します。フォームに記入して [保存] をクリックします。

Android

Android プレースメントを作成する

iOS

iOS プレースメントを作成

最後に、プレースメント ID をメモしておきます。

Android

Android Place Details

iOS

iOS プレースメントの詳細

app-ads.txt を更新する

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

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

ステップ 2: AdMob の管理画面で BidMachine のデマンドを設定する

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

Android

手順については、Android のガイドの手順 2 をご覧ください。

iOS

手順については、iOS のガイドの手順 2 をご覧ください。

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

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

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

OpenUPM-CLI

OpenUPM-CLI がインストールされている場合は、プロジェクトのルートディレクトリから次のコマンドを実行して、Unity 用 Google Mobile Ads BidMachine メディエーションプラグインをプロジェクトにインストールできます。

openupm add com.google.ads.mobile.mediation.bidmachine

OpenUPM

Unity プロジェクトエディタで、[Edit] > [Project Settings] > [Package Manager] を選択して、Unity Package Manager の設定を開きます。

[Scoped Registries] タブで、OpenUPM をスコープ付きレジストリとして追加し、次の詳細を入力します。

名前: OpenUPM
URL: https://package.openupm.com
スコープ: com.google

OpenUPM の詳細

次に、[Window] > [Package Manager] に移動して Unity Package Manager を開き、プルダウンメニューから [My Registries] を選択します。

Unity レジストリ

[Google Mobile Ads BidMachine Mediation] パッケージを選択し、[Install] をクリックします。

OpenUPM からインストールする

Unity パッケージ

変更履歴のダウンロードリンクから BidMachine 用の Google Mobile Ads メディエーションプラグインの最新バージョンをダウンロードし、ZIP ファイルから GoogleMobileAdsBidMachineMediation.unitypackage を解凍します。

Unity プロジェクトエディタで、[Assets] > [Import Package] > [Custom Package] を選択し、ダウンロードした GoogleMobileAdsBidMachineMediation.unitypackage ファイルを探します。すべてのファイルのチェックボックスがオンになっていることを確認して、[Import]（インポート）をクリックします。

Unity からインポートする

次に、[Assets] > [External Dependency Manager] > [Android Resolver] > [Force Resolve] を選択します。External Dependency Manager ライブラリにより、依存関係の解決が最初から実行され、宣言された依存関係が Unity アプリの Assets/Plugins/Android ディレクトリにコピーされます。

強制解決

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

EU ユーザーからの同意と GDPR

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

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

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

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

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

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

Android

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

iOS

SKAdNetwork の統合

BidMachine の SKAdNetwork サポートに関するドキュメントに沿って、SKAdNetwork ID をプロジェクトの Info.plist ファイルに追加します。

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

テスト広告を有効にする

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

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

テスト広告を確認する

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

エラーコード

アダプタが BidMachine から広告を受信できなかった場合は、次のクラスの ResponseInfo を使用して、広告レスポンスから根本原因のエラーを確認できます。

Android

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

iOS

GADMediationAdapterBidMachine

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

Android

エラーコード	ドメイン	理由
100	com.google.ads.mediation.bidmachine	無効なプレースメント ID または空のプレースメント ID が受信されました。
101	com.google.ads.mediation.bidmachine	シグナル収集中のエラー: シグナルデータ構成が見つかりません。
102	com.google.ads.mediation.bidmachine	シグナルの収集中に無効な広告フォーマットが受信されました。
103	com.google.ads.mediation.bidmachine	リクエストされた広告サイズを `bidmachine.BannerSize` にマッピングできませんでした
104	com.google.ads.mediation.bidmachine	読み込まれた BidMachine 広告リクエストの有効期限が切れています。
105	com.google.ads.mediation.bidmachine	全画面広告を表示できませんでした。
106	com.google.ads.mediation.bidmachine	BidMachine SDK が `null` 広告データを含む `onAdLoaded()` コールバックを返しました。

iOS

エラーコード	ドメイン	理由
101	com.google.mediation.bidmachine	サーバー構成に必要なパブリッシャー ID がありません。
102	com.google.mediation.bidmachine	RTB パラメータに広告フォーマットが含まれていないか、指定されたフォーマットがサポートされていないため、入札シグナル収集リクエストが失敗しました。
103	com.google.mediation.bidmachine	広告を読み込むための広告設定が無効です。
104	com.google.mediation.bidmachine	BidMachine SDK が、バナー広告の `BidMachineAdProtocol didLoadAd` デリゲートメソッドにバナー広告以外の広告を返しました。本来発生しないはずの処理。
105	com.google.mediation.bidmachine	全画面広告を表示する準備ができていません。
106	com.google.mediation.bidmachine	Bid Machine SDK が、ネイティブ広告の `BidMachineAdProtocol didLoadAd` デリゲートメソッドにネイティブ広告以外の広告を返しました。本来発生しないはずの処理。
107	com.google.mediation.bidmachine	ネイティブ広告の画像ソースの 1 つを読み込めませんでした。
108	com.google.mediation.bidmachine	BidMachine はこのバナー広告サイズをサポートしていません。