在应用之间同步意见征求情况（Beta 版）

请选择平台： Android iOS

为了减少向用户显示的多余 GDPR 消息，请在多个应用之间同步用户意见征求情况。如果用户在启用了意见征求同步功能的应用中就意见征求做出决定，系统会使用您提供的意见征求同步标识符来存储此选择。该同意决定会自动应用于共享同一意见征求同步标识符的所有其他应用。只有 Google 会使用此标识符来存储和检索用户的同意情况。

本指南介绍了如何同步移动应用中 User Messaging Platform (UMP) SDK 的 GDPR 同意情况。

前提条件

在开始之前，请执行以下操作：

  • 完成入门指南。
  • 在 AdMob 界面的隐私权和消息标签页中，为符合条件的应用启用意见征求同步功能。

在能够识别用户的应用中，向 UMP SDK 提供意见征求结果同步 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()
}

您提供的标识符必须能够唯一标识所有同步了意见征求数据的应用中的用户。对标识符进行哈希处理或加密，以防止向 Google 发送个人身份信息 (PII)。

所提供的身份证件必须满足以下要求：

  • 构造为 UUID 字符串或与正则表达式 ^[0-9a-zA-Z+.=\/_\-$,{}]{22,150}$ 相匹配。
  • 最少包含 22 个字符。
  • 不得超过 150 个字符。

以下是正确的意见征求同步 ID 的示例：

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

未能满足要求会导致无法设置意见征求结果同步 ID，并且 UMP SDK 会向控制台记录警告