このページは Cloud Translation API によって翻訳されました。

使ってみる

Google の EU ユーザーの同意ポリシー）を使用するには、欧州経済領域（EEA）のユーザー向けに特定の情報を開示する Cookie またはその他のローカルストレージを使用することについて個人データ（AdID など）を使用して広告を配信する必要がある。このポリシーには、EU の e プライバシー指令と一般データ保護規則（GDPR）。

パブリッシャー様がこのポリシーで定められた義務を遂行できるよう、Google では User Messaging Platform（UMP）SDK をご利用ください。UMP SDK が更新され、対応していますこれらすべての構成をプライバシーと Ad Manager 説明します。

前提条件

スタートガイドを完了している。

GDPR 関連の要件に取り組む場合は、 IAB の要件が EU ユーザーの同意に与える影響メッセージ

メッセージタイプを作成する

ユーザーメッセージは、いずれかの利用可能なユーザーメッセージタイプ [プライバシーと[メッセージ] タブをアドマネージャーあります。UMP SDK は、アプリケーション ID から Ad Manager 作成されたユーザーメッセージ必要があります。アプリケーションにメッセージが構成されていない場合、SDK はエラーが返されます。

詳しくは、プライバシーとメッセージについて

アプリケーション ID を追加する

アプリケーション ID は、アドマネージャーの管理画面: ID をこれを次のコードスニペットに置き換えます。

アプリごとにユーザーの同意情報の更新をリクエストする必要があります requestConsentInfoUpdate()を使用して起動します。これにより、ユーザーがまだ同意していない場合に、同意する必要があるかどうか。または、通知します。

アプリ起動時のステータスの確認方法の例を次に示します。

@override
void initState() {
  super.initState();

  // Create a ConsentRequestParameters object.
  final params = ConsentRequestParameters();

  // Request an update for the consent information.
  ConsentInformation.instance.requestConsentInfoUpdate(
    params,
    () async {
      // TODO: Load and present the consent form.
    },
    (FormError error) {
      // Handle the error.
    },
  );
}

必要に応じて同意フォームを読み込んで表示する

最新の同意ステータスを受け取ったら、 loadAndShowConsentFormIfRequired() 日付 ConsentForm クラスを使用して同意フォームを読み込みます。もし同意ステータスが必須の場合、SDK はフォームを読み込んですぐに表示します提供されたものから取得できます。 callback はフォームが閉じられた後に呼び出されます。同意が不要な場合、 callback は直ちに呼び出されます。

@override
void initState() {
  super.initState();

  // Create a ConsentRequestParameters object.
  final params = ConsentRequestParameters();

  // Request an update for the consent information.
  ConsentInformation.instance.requestConsentInfoUpdate(
    params,
    () async {
      ConsentForm.loadAndShowConsentFormIfRequired((loadAndShowError) {
        if (loadAndShowError != null) {
          // Consent gathering failed.
        }

        // Consent has been gathered.
      });
    },
    (FormError error) {
      // Handle the error.
    },
  );
}

ユーザーが選択または拒否した後になんらかのアクションを行う必要がある場合そのロジックを callbackに配置します。選択します。

広告をリクエスト

アプリで広告をリクエストする前に、同意を得ているかどうかを確認してください canRequestAds()を使用してユーザーから取得できます。2 つのモデル同意を取得する際に確認する項目:

現在のセッションで同意が得られたら、
requestConsentInfoUpdate()を呼び出した直後。前回のセッションで同意を取得した可能性があります。レイテンシおすすめします。コールバックの完了を待たずに、アプリのリリース後、できるだけ早く広告の読み込みを開始してください。

同意取得プロセス中にエラーが発生した場合でも、広告をリクエストできます。UMP SDK は、前のステップのあります。

class AppExampleState extends State<AppExample> {

  // Use a bool to initialize the Mobile Ads SDK and load ads once.
  var _isMobileAdsInitializeCalled = false;

  @override
  void initState() {
    super.initState();

    // Create a ConsentRequestParameters object.
    final params = ConsentRequestParameters();

    // Request an update for the consent information.
    ConsentInformation.instance.requestConsentInfoUpdate(
      params,
      () async {
        ConsentForm.loadAndShowConsentFormIfRequired((loadAndShowError) {
          if (loadAndShowError != null) {
            // Consent gathering failed.
          }

          // Consent has been gathered.
          _initializeMobileAdsSDK();
        });
      },
      (FormError error) {
        // Handle the error.
      },
    );

    // Check if you can initialize the Mobile Ads SDK in parallel while
    // checking for new consent information. Consent obtained in the
    // previous session can be used to request ads.
    _initializeMobileAdsSDK();
  }

  void _initializeMobileAdsSDK() async {
    if (_isMobileAdsInitializeCalled) {
      return;
    }

    // Initialize the Mobile Ads SDK if the SDK has gathered consent aligned with
    // the app's configured messages.
    var canRequestAds = await ConsentInformation.instance.canRequestAds();
    if (canRequestAds) {
      setState(() {
        _isMobileAdsInitializeCalled = true;
      });

      // Initialize the Mobile Ads SDK.
      MobileAds.instance.initialize();

      // TODO: Request an ad.
    }
  }
}

プライバシー設定

一部の同意フォームでは、ユーザーがいつでも同意を変更する必要があります。遵守必要に応じてプライバシーオプションボタンを実装できます。

手順は次のとおりです。

アプリの設定ページのボタンなどの UI 要素を実装するプライバシーオプションフォームをトリガーできます。
完了したら loadAndShowConsentFormIfRequired() 確認 getPrivacyOptionsRequirementStatus() プライバシーオプションフォームを提示できる UI 要素です。
ユーザーが UI 要素を操作すると、 showPrivacyOptionsForm() : ユーザーがフォームを表示できるようにユーザーがいつでもプライバシーオプションを更新できるようにします。

class AppExampleState extends State<AppExample> {
  static const _privacySettingsText = 'Privacy Settings';

  // Use a bool to initialize the Mobile Ads SDK and load ads once.
  var _isMobileAdsInitializeCalled = false;

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'App Example',
      home: Scaffold(
          appBar: AppBar(
            title: const Text('App Example'),
            actions: _isMobileAdsSDKInitialized
                // Regenerate the options menu to include a privacy setting.
                ? _privacySettingsAppBarAction()
                : null
          ),
          body: // ...
      ),
    );
  }

  List<Widget> _privacySettingsAppBarAction() {
    return <Widget>[
      FutureBuilder(
          future: ConsentInformation.instance.isPrivacyOptionsRequired(),
          builder: (context, snapshot) {
            final bool visibility = snapshot.data ?? false;
            return Visibility(
                visible: visibility,
                child: PopupMenuButton<String>(
                  onSelected: (String result) {
                    if (result == _privacySettingsText) {
                      ConsentForm.showPrivacyOptionsForm((formError) {
                        if (formError != null) {
                          debugPrint(
                              "${formError.errorCode}: ${formError.message}");
                        }
                      });
                    }
                  },
                  itemBuilder: (BuildContext context) =>
                      <PopupMenuEntry<String>>[
                    const PopupMenuItem<String>(
                        value: _privacySettingsText,
                        child: Text(_privacySettingsText))
                  ],
                ));
          })
    ];
  }
}

テスト

開発中にアプリで統合をテストする場合は、テストデバイスをプログラムで登録します。必ずテストデバイス ID を設定するコードを作成します。

requestConsentInfoUpdate()を呼び出します。

ログ出力で、次の例のようなメッセージを確認します。に、デバイス ID と、テストデバイスとして追加する方法が表示されます。

Android

Use new ConsentDebugSettings.Builder().addTestDeviceHashedId("33BE2250B43518CCDA7DE426D04EE231")
to set this as a debug device.

iOS

<UMP SDK>To enable debug mode for this device,
set: UMPDebugSettings.testDeviceIdentifiers = @[2077ef9a63d2b398840261c8221a0c9b]

テストデバイス ID をクリップボードにコピーします。

コードを変更して ConsentDebugSettings.testIdentifiers して渡すテストデバイス ID のリスト。

ConsentDebugSettings debugSettings = ConsentDebugSettings(
  testIdentifiers: ["TEST-DEVICE-HASHED-ID"],
);

ConsentRequestParameters params =
    ConsentRequestParameters(consentDebugSettings: debugSettings);

ConsentInformation.instance.requestConsentInfoUpdate(params, () async {
  // ...
};

地域を強制的に適用する

UMP SDK を使用すると、デバイスが別のデバイスで動作しているかのようにアプリの動作をテストできます。 EEA または英国に居住している（ the DebugGeography field on ConsentDebugSettingsを使用）注: デバッグ設定はテストデバイスでのみ機能します。

ConsentDebugSettings debugSettings = ConsentDebugSettings(
  debugGeography: DebugGeography.debugGeographyEea,
  testIdentifiers: ["TEST-DEVICE-HASHED-ID"],
);

ConsentRequestParameters params =
    ConsentRequestParameters(consentDebugSettings: debugSettings);

ConsentInformation.instance.requestConsentInfoUpdate(params, () async {
  // ...
};

同意ステータスをリセットする

UMP SDK でアプリをテストする場合は、 SDK の状態を評価して、ユーザーが初めてインストールする際の動作をシミュレートできるようにします。 SDK には、これを行うための reset() メソッドが用意されています。

ConsentInformation.instance.reset();