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

[プラットフォームを選択]: Android(ベータ版) New-selected Android iOS Unity Flutter

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

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

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

統合
入札
ウォーターフォール
フォーマット
バナー
インタースティシャル
リワード
ネイティブ

要件

  • Android API レベル 24 以降
  • 最新の GMA Next-Gen SDK

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

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

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

次に、アプリの Google Play の URL を入力します。

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

利用可能な広告フォーマットから [BANNER] を選択し、[ADD AD UNIT] ボタンをクリックします。

インタースティシャル

利用可能な広告フォーマットから [INTERSTITIAL] を選択し、[ADD AD UNIT] ボタンをクリックします。

リワード

利用可能な広告フォーマットから [REWARDED VIDEO] を選択し、[ADD AD UNIT] ボタンをクリックします。

ネイティブ

利用可能な広告フォーマットから [NATIVE] を選択し、[ADD AD UNIT] をクリックします。

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

AdMob の広告ユニット ID を設定するには、slot_id に加えて、myTarget の永続的な アクセス トークン も必要です。[Profile] タブに移動し、[Access Tokens] を選択します。[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 とアダプタをインポートする

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

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:mytarget:5.45.3.0")
}

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:0.25.0-beta01'
    implementation 'com.google.ads.mediation:mytarget:5.45.3.0'
}

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

手動による統合

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

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

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

Java

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

MyTargetPrivacy.setUserConsent(true);

Kotlin

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

MyTargetPrivacy.setUserConsent(true)

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

Java

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

MyTargetPrivacy.setUserAgeRestricted(true);

Kotlin

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

Java

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

MyTargetPrivacy.setCcpaUserConsent(true);

Kotlin

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

MyTargetPrivacy.setCcpaUserConsent(true)

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

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

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

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

テスト広告を有効にする

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

テスト広告を確認する

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

省略可能なステップ

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

広告レンダリング

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

フィールド myTarget アダプタによって入力
広告見出し 常時
画像 常時
本文 常時
アプリアイコン 常時
行動を促すフレーズ 常時
評価 保証なし
ストア 保証なし
価格 保証なし
ロゴ 保証なし
広告主様 常時

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 アダプタがスローするコードとメッセージは次のとおりです。

エラーコード 理由
100 myTarget SDK がエラーを返しました。
101 アド マネージャーの管理画面で構成された myTarget サーバー パラメータが欠落しているか無効です。
102 リクエストされた広告サイズが、myTarget でサポートされているバナーサイズと一致しません。
103 広告リクエストが統合ネイティブ広告リクエストではありません。
104 myTarget から読み込まれたネイティブ広告が、リクエストされたネイティブ広告と異なります。
105 myTarget から読み込まれたネイティブ広告に、必要なアセット(画像やアイコンなど)がありません。