客户用户ID字段（CUID）

推荐用于
营销人员 开发商
最近更新：

概要：您可以使用CUID对同一个用户通过不同设备、渠道或流量入口完成的事件进行统一衡量。

CUID的定义

客户用户ID（CUID）是一种具有唯一性的用户标识符。该标识符通常由应用所有者（广告主）在用户完成注册时生成并设置。广告主能依据CUID将不同设备中的用户行为串联起来，形成完整的用户链路。

 示例

某应用的用户在多个设备中使用该应用，且在该应用中具有同一个CUID。该用户在其移动端或PC端设备上完成某个事件后，AF会将该事件及用户的CUID一并记录下来。这样广告主就能将不同设备的数据整合起来，从而对该用户有更全面的了解。

使用场景：

  • 如果该应用的用户在不同设备（手机、平板、电视、PC端）上完成应用内购买，该应用的广告主就可以使用CUID将这些购买事件关联到同一个用户，集中查看。
  • 如果用户在多个平台（PC端、移动端、电视）上安装了同一个游戏，可使用CUID对其使用情况进行跨平台共享，从而对用户体验形成一体化的理解。

设置CUID

建议在SDK初始化流程中尽早设置CUID。CUID设置得越早，能关联到CUID的事件就越多。

安卓原生 iOS原生 UnityReact Native

您可以在CUID可用时调用setCustomerUserID来设置CUID。只有在CUID设置完毕后发生的事件才能关联到CUID。因此如果您在setCustomerUserID之前调用start，就无法将激活关联到CUID。

将激活关联到CUID

如果您需要将激活关联到CUID，就必须在调用start之前完成CUID的设置。

重要提示：请务必注意，如果您在调用start之前设置CUID，可能会使SDK无法发送激活，导致归因失败。比如相关应用首次启动时，如果用户在SDK完成CUID设置之前就退出应用，就会发生这种情况。

对于安卓设备，您可以选择在全局Application类或Activity类中设置CUID并调用start方法，具体取决于相关应用的实现方式。详情请见在合适的类（Class）中启动SDK。

在Application类中启动SDK

如果您想要在全局Application类中启动SDK时将CUID关联到激活，请务必使用waitForCustomerUserId方法延迟激活的发送。该方法可将SDK置于等待模式，等到CUID设置完毕后启动。

请注意：如果CUID设置失败，SDK会一直处于等待模式，不发送任何事件。

在Activity类中启动SDK

如果您想要在Activity类中启动SDK时将CUID关联到激活，无需延迟发送激活，只需在start之前调用setCustomerUserId即可。

开发人员相关说明

开发人员需要了解以下信息：

  • 如在全局Application类中启动SDK，需使用waitForCustomerUserId。
  • 开发者文档链接：
    • 如果您想将激活关联到CUID，请参见此文档。

CUID与隐私保护

AppsFlyer重视并尊重您用户的隐私，因此我们不允许收集敏感的个人数据或将此类信息传输到AppsFlyer平台。

为了确保用户的隐私不受侵犯，在设计CUID时切勿涉及任何能直接识别用户身份的信息。这类信息包括社保号码和身份证号码等。

此外，如果CUID中包含用户的邮箱地址或电话号码，请务必确保这些信息在发送到AppsFlyer时已进行哈希加密，禁止向AppsFlyer发送带有未哈希的个人数据的CUID。

另请参见