メインコンテンツへスキップ

​
概要

UMP（User Messaging Platform）SDKは、GDPR（一般データ保護規則）およびCCPA（カリフォルニア消費者プライバシー法）準拠のために、パーソナライズド広告に対するユーザーの同意を管理します。
UMP連携にはadrop-ads-backfillモジュールが必要です。はじめにのインストールガイドを先に完了してください。

​
基本的な使い方

Adrop初期化後にConsent Managerを使用してユーザーの同意を要求します。 
import io.adrop.ads.Adrop
import io.adrop.ads.consent.AdropConsentListener
import io.adrop.ads.consent.AdropConsentResult

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        // Adrop.initialize()の後に呼び出し
        Adrop.consentManager?.requestConsentInfoUpdate(this, object : AdropConsentListener {
            override fun onConsentInfoUpdated(result: AdropConsentResult) {
                if (result.error != null) {
                    Log.e("Consent", "エラー: ${result.error}")
                }
            }
        })
    }
}

​
同意ステータス

Consent Managerは次のステータスのいずれかを返します：
ステータス説明
UNKNOWN同意ステータスがまだ決定されていない
REQUIRED同意が必要（ポップアップが表示される）
NOT_REQUIRED同意は不要（非GDPR地域）
OBTAINEDすでに同意を取得済み

​
デバッグ設定（テストモード）

開発中にGDPR/CCPA同意フローをテストしてください： 
import io.adrop.ads.consent.AdropConsentDebugGeography

if (BuildConfig.DEBUG) {
    // 同意リクエスト前にデバッグ地域を設定
    Adrop.consentManager?.setDebugSettings(
        testDeviceHashedIds = listOf("YOUR_HASHED_DEVICE_ID"),  // Logcatで確認
        geography = AdropConsentDebugGeography.EEA  // GDPRテスト
    )

    // テスト用に同意状態をリセット
    Adrop.consentManager?.reset(this)
}

​
デバッグ地域

地域説明
DISABLED実際のデバイス位置を使用
EEAGDPRテスト（欧州経済領域）
REGULATED_US_STATECCPAテスト（カリフォルニアなど）
OTHER非規制地域テスト
デバッグ設定は開発中のみ使用してください。本番リリース前に削除または無効化してください。

​
ベストプラクティス

早期リクエスト

SDK初期化直後、アプリライフサイクルの早い段階で同意を要求してください。

エラー処理

同意エラーを適切に処理し、フォールバック動作を提供してください。

全シナリオテスト

リリース前にデバッグ設定を使用してすべての同意シナリオをテストしてください。

ユーザー選択の尊重

同意を得たり拒否された後は、ユーザーの選択を尊重し、繰り返し要求しないでください。

​
関連ドキュメント

ターゲティング

ユーザーおよびコンテキストターゲティング設定

はじめに

SDKインストールおよび設定ガイド

リファレンス

クラス、リスナー、エラーコード