在應用程式之間同步處理同意聲明 (Beta 版)

選取平台： Android iOS

為減少使用者收到的重複 GDPR 訊息，請在多個應用程式中同步處理同意聲明。如果使用者在啟用同意聲明同步功能的應用程式中做出同意聲明決定，系統會使用您提供的同意聲明同步 ID 儲存這項選擇。該同意聲明決定會自動套用至共用相同同意聲明同步 ID 的所有其他應用程式。只有 Google 會使用這個 ID 儲存及擷取使用者的同意聲明決定。

本指南說明如何在行動應用程式中，透過 User Messaging Platform (UMP) SDK 同步處理 GDPR 同意聲明。

必要條件

開始之前，請先執行下列操作：

  • 完成入門指南的步驟。
  • 在 AdMob 使用者介面的「隱私權與訊息」分頁中，為符合資格的應用程式啟用同意聲明同步功能。

在可識別使用者的應用程式中，將同意聲明同步 ID 提供給 UMP SDK。如果應用程式沒有使用者 ID，請使用其他 ID (例如 App Set ID API) 識別不同應用程式中的使用者。

在 ConsentRequestParameters 物件上設定同意聲明同步 ID：

Java

import com.google.android.gms.appset.AppSet;
import com.google.android.gms.appset.AppSetIdClient;

// Example fetching App Set ID to identify the user across apps.
AppSetIdClient client = AppSet.getClient(this);
client.getAppSetIdInfo().addOnSuccessListener(
  info -> {
    String appSetId = info.getId();
    ConsentRequestParameters params = new ConsentRequestParameters.Builder()
        .setConsentSyncId(appSetId)
        .build();
  }
);

Kotlin

import com.google.android.gms.appset.AppSet
import com.google.android.gms.appset.AppSetIdInfo

// Example fetching App Set ID to identify the user across apps.
val client = AppSet.getClient(this)
client.appSetIdInfo.addOnSuccessListener { info: AppSetIdInfo ->
  val appSetId = info.id
  val params = ConsentRequestParameters.Builder()
    .setConsentSyncId(appSetId)
    .build()
}

您提供的 ID 必須能跨所有同步處理同意聲明的應用程式，專屬識別使用者。雜湊處理或加密 ID，避免將個人識別資訊 (PII) 傳送給 Google。

提供的身分證件必須符合下列規定：

  • 建構為 UUID 字串，或符合規則運算式 ^[0-9a-zA-Z+.=\/_\-$,{}]{22,150}$。
  • 最少包含 22 個字元。
  • 最多包含 150 個字元。

以下是正確的同意聲明同步 ID 範例：

  • 12JD92JD8078S8J29SDOAKC0EF230337
  • 12jd92jd8078s8j29sdoakc0ef230337
  • 12Jd92jD8078s8j29sDoakc0ef230337
  • 123e4567-e89b-12d3-a456-426614174000

如未符合規定，系統就不會設定同意聲明同步 ID，且 UMP SDK 會在控制台中記錄警告