本頁面由 Cloud Translation API 翻譯而成。

開始設定

根據 Google 歐盟地區使用者同意聲明政策，您必須向歐洲經濟區境內的使用者揭露特定資訊取得使用 Cookie 或其他本機儲存空間的同意聲明。並根據法律要求使用個人資料 (如 AdID) 放送廣告。本政策是配合《歐盟地區電子通訊隱私指令》和《一般資料保護規則》(GDPR) 規定)。

為了協助發布商根據這項政策履行自身職責，Google 提供 User Messaging Platform (UMP) SDK。UMP SDK 已更新，現已支援符合最新的 IAB 標準這些設定現在都很方便處理 Ad Manager 隱私權與傳送訊息

必要條件

完整閱讀入門指南

如果您正在配合 GDPR 相關規定，請參閱 IAB 規定對歐盟地區同意聲明的影響訊息

建立訊息類型

使用以下其中一則文字建立使用者訊息：可用的使用者訊息類型中，隱私權與訊息分頁廣告管理員。讓他們使用服務帳戶UMP SDK 會嘗試顯示透過應用程式 ID Ad Manager 建立的使用者訊息您在專案中設定的內容如果未設定應用程式訊息，則 SDK 傳回錯誤。

詳情請參閱關於隱私權與訊息。

新增應用程式 ID

您可以在「 Ad Manager 使用者介面。將身分證件新增至替換為下列程式碼片段：

在每個應用程式中，應要求使用者更新同意聲明資訊使用 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()存取。這裡共有兩個收集同意聲明時的檢查地點：

從目前的工作階段中收集到同意聲明後，
呼叫 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 可讓您測試應用程式行為，就像測試裝置地址在歐洲經濟區或英國境內，並使用 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();