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

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

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

Android Studio の統合（推奨）

プロジェクト レベルの settings.gradle.kts ファイルに、次のリポジトリを追加します。

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://artifact.bytedance.com/repository/pangle/")
    }
  }
}

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

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

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.25.0-beta01'
    implementation 'com.google.ads.mediation:pangle:7.9.1.1.0'
}

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

手動による統合

1. Android 用の Pangle SDK の最新バージョンをダウンロードし、ダウンロードしたアーカイブ フォルダから open_ad_sdk.aar を抽出して プロジェクトに追加します。

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

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

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

Pangle SDK バージョン 7.9.0.9 以降では、Google の追加の同意仕様をサポートする同意管理プラットフォームによって設定された GDPR の同意が自動的に読み取られます。これには、UMP SDKが含まれます。

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

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

Pangle アダプタには、同意情報を Pangle アダプタ、次に Pangle SDK に転送する PangleMediationAdapter.setPAConsent() メソッドが用意されています。次のサンプルコードは、同意情報を Pangle SDK に渡す方法を示しています。同意情報が Pangle SDK に正しく転送されるように、 を初期化する前に同意情報を設定してください。GMA Next-Gen SDK

import com.google.ads.mediation.pangle.PangleMediationAdapter;
// ...

PangleMediationAdapter.setPAConsent(PAGConstant.PAGPAConsentType.PAG_PA_CONSENT_TYPE_CONSENT);

import com.google.ads.mediation.pangle.PangleMediationAdapter
// ...

PangleMediationAdapter.setPAConsent(PAGConstant.PAGPAConsentType.PAG_PA_CONSENT_TYPE_CONSENT)

詳細と各メソッドで指定できる値については、Pangle の Android 統合 ガイド をご覧ください。

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

ProGuard による難読化

ProGuard を使用して Android コードを難読化する場合は、 Pangle のドキュメント の手順に沿って、Pangle SDK コードが難読化されないようにしてください。

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

テスト広告を有効にする

AdMob 用のテストデバイスを 登録し 、Pangle の管理画面で テストモードを有効にしてください 。

テスト広告を確認する

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

省略可能なステップ

ネイティブ広告

広告レンダリング

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

¹ Pangle アダプタは、ネイティブ広告のメイン画像アセットに直接アクセスできません。代わりに、 アダプタは MediaView に動画または画像を入力します。

エラーコード

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

com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter

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