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

プラットフォームを選択: Android（ベータ版） Android iOS Unity Flutter

このガイドでは、GMA Next-Gen SDK を使用して メディエーションで myTarget の広告を読み込んで表示する方法を、ウォーターフォール統合を含めて説明します。また、広告ユニットのメディエーション設定に myTarget を追加する方法と、myTarget SDK とアダプタを Android アプリに統合する方法についても取り上げます。

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

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

要件

• Android API レベル 24 以降

• 最新の GMA Next-Gen SDK。

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

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

myTarget アカウントにログインします。ヘッダーの [アプリ] をクリックして、[アプリ] ページに移動します。[アプリを追加] をクリックしてアプリを追加します。

次に、アプリの Google Play URL を指定します。

myTarget でアプリを追加する際は、プロセスを完了する前に広告ユニットを作成する必要があります。

広告ユニットの詳細ページで、広告ユニットの設定にあるスロット ID（slot_id）をメモします。このスロット ID は、次のセクションでアド マネージャーの広告ユニットを設定するために使用されます。

slot_id に加えて、AdMob 広告ユニット ID を設定するには、myTarget の永続アクセス トークンも必要です。[プロフィール] タブに移動し、[アクセス トークン] を選択します。[Create Token] または [Show Token] をクリックして、myTarget の永続アクセス トークンを表示します。

app-ads.txt を更新する

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

myTarget に app-ads.txt を実装するには、ファイルを作成して公開する方法をご覧ください。

テストモードをオンにする

myTarget のドキュメントの手順に沿って、myTarget の管理画面でテストデバイスを追加、設定します。

ステップ 2: アド マネージャーの管理画面で myTarget のデマンドを設定する

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

アド マネージャー アカウントにログインします。

[配信] > [収益グループ] に移動し、[新しい収益グループ] ボタンをクリックします。

収益グループの固有の名前を入力し、[ステータス] を [有効] に設定して、広告フォーマットを選択し、[広告枠タイプ] を [モバイルアプリ] に設定します。 [ターゲティング > 広告枠] セクションで、メディエーションを追加する [広告枠] と [モバイルアプリ] の広告ユニットを選択します。

次に、[収益パートナーを追加] ボタンをクリックします。

myTarget の収益パートナーがすでにある場合は、それを選択できます。そうでない場合は、[新しい収益パートナーを作成] を選択します。

[広告ネットワーク] で [myTarget] を選択し、一意の [名前] を入力して、[メディエーション] を有効にします。

[自動データ収集] をオンにして、前のセクションで取得した永続アクセス トークンを入力します。

収益パートナーを選択したら、統合タイプとして [モバイル SDK メディエーション]、プラットフォームとして [Android]、ステータスとして [有効] を選択します。前のセクションで取得したスロット ID を入力します。次に、[デフォルト CPM] の値を入力します。

完了したら、ページの下部にある [保存] をクリックします。

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

欧州の規制に関する設定と米国の州の規制に関する設定の手順に沿って、アド マネージャーの管理画面で欧州および米国の州の規制に関する広告パートナーのリストに Mail.ru を追加します。

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

Android Studio の統合（推奨）

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

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:mytarget:5.27.4.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:mytarget:5.27.4.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

手動による統合

• myTarget SDK を組み込むには、myTarget Android SDK のドキュメントをご覧ください。

• Google の Maven リポジトリで myTarget アダプタ アーティファクトに移動します。最新バージョンを選択し、myTarget アダプタの .aar ファイルをダウンロードして、プロジェクトに追加します。

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

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

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

SDK バージョン 5.1.0 で、myTarget はプライバシー要件をサポートするためにユーザーの同意 API を追加しました。次のサンプルコードは、この同意情報を myTarget SDK に渡す方法を示しています。このメソッドを呼び出す場合は、GMA Next-Gen SDK を通じて広告をリクエストする前に呼び出すことをおすすめします。

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setUserConsent(true);

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setUserConsent(true)

また、ユーザーが年齢制限カテゴリに該当することがわかっている場合は、次のコードを使用して、この同意情報を myTarget SDK に渡すことができます。

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setUserAgeRestricted(true);

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setUserAgeRestricted(true)

詳細とメソッドで指定できる値については、myTarget のプライバシーと GDPR ガイドをご覧ください。

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

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

SDK バージョン 5.9.0 で、myTarget はプライバシー要件をサポートするためにユーザーの同意 API を追加しました。次のサンプルコードは、この同意情報を myTarget SDK に渡す方法を示しています。このメソッドを呼び出す場合は、GMA Next-Gen SDK を通じて広告をリクエストする前に呼び出すことをおすすめします。

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setCcpaUserConsent(true);

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setCcpaUserConsent(true)

詳細と、メソッドで指定できる値については、myTarget サポートにお問い合わせください。

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

myTarget との統合にコードを追加する必要はありません。

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

テスト広告を有効にする

アド マネージャー用のテストデバイスを登録し、myTarget の管理画面でテストモードを有効にしてください。

テスト広告を確認する

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

省略可能なステップ

ネイティブ広告を使用する

広告のレンダリング

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

myTarget SDK は mediaView の幅と高さに対して常に 0 を返すため、myTarget アダプタは getAspectRatio() に対して常に 0 を返します。myTarget SDK は、今後のリリースでこの問題を修正する予定です。

インプレッションとクリックのトラッキング

GMA Next-Gen SDK は、インプレッションとクリックのトラッキングに myTarget SDK のコールバックを使用するため、両方のソースのレポートはほぼ一致します。

エラーコード

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

com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter

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