開始使用

選取平台： Android iOS Unity Flutter

Google User Messaging Platform (UMP) SDK 是一項隱私權與訊息工具，可協助您管理隱私權選項。詳情請參閱「關於隱私權與訊息」。

建立訊息類型

在 Ad Manager 帳戶的「隱私權與訊息」分頁中，使用可用的使用者訊息類型建立使用者訊息。UMP SDK 會嘗試顯示透過專案中設定的 Ad Manager 應用程式 ID 建立的隱私權訊息。

詳情請參閱「關於隱私權和訊息」。

您應在每次啟動應用程式時，使用 Update() 要求更新使用者的同意聲明資訊。這項要求會檢查下列項目：

  • 是否必須取得同意聲明。舉例來說，使用者是第一次提供同意聲明，或是先前的同意聲明已過期。
  • 是否需要隱私權選項進入點。部分隱私權訊息會要求應用程式允許使用者隨時修改隱私權選項。
void Start()
{
    // Create a ConsentRequestParameters object.
    ConsentRequestParameters requestParameters = new ConsentRequestParameters();

    // Request an update of the user's consent information.
    ConsentInformation.Update(requestParameters, OnConsentInfoUpdated);
}
UMPSnippets.cs

載入並顯示隱私權訊息表單

取得最新的同意聲明狀態後，請呼叫 LoadAndShowConsentFormIfRequired()，載入收集使用者同意聲明所需的表單。載入後，表單會立即顯示。

ConsentForm.LoadAndShowConsentFormIfRequired((FormError formError) =>
{
    if (formError != null)
    {
        // Consent gathering failed.
        Debug.LogError("Error loading/showing consent form: " + formError.Message);
    }

    // ...
});
UMPSnippets.cs

隱私權選項

部分隱私權訊息表單會從發布商算繪的隱私權選項進入點顯示，讓使用者隨時管理隱私權選項。如要進一步瞭解使用者在隱私權選項進入點看到的訊息，請參閱「可用的使用者訊息類型」。

確認是否需要隱私權選項進入點

呼叫 Update() 後，請檢查 PrivacyOptionsRequirementStatus，判斷應用程式是否需要隱私權選項進入點。如果需要，請在應用程式中新增可見且可互動的 UI 元素，顯示隱私權選項表單。如果不需要隱私權進入點，請將 UI 元素設為不可見且無法互動。

void UpdatePrivacyButton()
{
    if (_privacyButton != null)
    {
        // Enable the button only if a privacy options entry point is required.
        _privacyButton.interactable =
            ConsentInformation.PrivacyOptionsRequirementStatus == PrivacyOptionsRequirementStatus.Required;
    }
}
UMPSnippets.cs

如需隱私權選項規定狀態的完整清單，請參閱 ConsentInformation.PrivacyOptionsRequirementStatus。

顯示隱私權選項表單

使用者與元素互動時，顯示隱私權選項表單：

public void ShowPrivacyOptionsForm()
{
    ConsentForm.ShowPrivacyOptionsForm((FormError showError) =>
    {
        if (showError != null)
        {
            Debug.LogError("Error showing privacy options form: " + showError.Message);
        }
    });
}
UMPSnippets.cs

要求廣告時一併傳送使用者同意聲明

要求廣告前，請使用 CanRequestAds() 檢查是否已取得使用者同意聲明：

ConsentInformation.CanRequestAds()

收集同意聲明時，請檢查下列位置是否可以要求廣告：

  • 在目前工作階段中，UMP SDK 收集同意聲明後。
  • 呼叫 Update() 後立即執行。UMP SDK 可能已在上一個應用程式工作階段中取得同意聲明。

如果在收集同意聲明的過程中發生錯誤，請檢查是否可以請求廣告。UMP SDK 會使用上一個應用程式工作階段的同意聲明狀態。

避免重複的廣告請求作業

在收集同意聲明和呼叫 Update() 後檢查 CanRequestAds() 時，請確保您的邏輯可防止多餘的廣告請求，以免兩項檢查都傳回 true。舉例來說，使用布林變數。

測試

如要在開發應用程式時測試整合功能，請按照下列步驟，以程式輔助方式註冊測試裝置。發布應用程式前，請務必先移除用來設定測試裝置 ID 的程式碼。

  1. 歡迎致電Update()。

  2. 檢查記錄輸出內容，看是否有類似以下範例的訊息，指出裝置 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]

  3. 將測試裝置 ID 複製到剪貼簿。

  4. 修改程式碼以呼叫 DebugGeography.TestDeviceHashedIds，並傳遞測試裝置 ID 清單。

    void Start()
{
    var debugSettings = new ConsentDebugSettings
    {
        TestDeviceHashedIds =
        new List<string>
        {
            "TEST-DEVICE-HASHED-ID"
        }
    };

    // Create a ConsentRequestParameters object.
    ConsentRequestParameters request = new ConsentRequestParameters
    {
        ConsentDebugSettings = debugSettings,
    };

    // Check the current consent information status.
    ConsentInformation.Update(request, OnConsentInfoUpdated);
}

強制指定地理位置

UMP SDK 提供測試應用程式行為的方法，就像裝置位於歐洲經濟區或英國等各種區域一樣，使用 DebugGeography。請注意，偵錯設定僅適用於測試裝置。

void Start()
{
    var debugSettings = new ConsentDebugSettings
    {
        // Geography appears as in EEA for debug devices.
        DebugGeography = DebugGeography.EEA,
        TestDeviceHashedIds = new List<string>
        {
            "TEST-DEVICE-HASHED-ID"
        }
    };

    // Create a ConsentRequestParameters object.
    ConsentRequestParameters request = new ConsentRequestParameters
    {
        ConsentDebugSettings = debugSettings,
    };

    // Check the current consent information status.
    ConsentInformation.Update(request, OnConsentInfoUpdated);
}

使用 UMP SDK 測試應用程式時，您可能會發現重設 SDK 狀態有助於模擬使用者首次安裝應用程式的體驗。SDK 提供 Reset() 方法來執行這項操作。

ConsentInformation.Reset();

GitHub 上的範例

如要查看本頁面涵蓋的 UMP SDK 整合完整範例，請參閱 HelloWorld。