setCustomerIDs 支持 SHA256 哈希 hashing-support

访客ID服务(ECID)支持SHA-256哈希算法,该算法允许您传入客户ID或电子邮件地址,并传出经过哈希处理的ID。 这是一种可选的Javascript方法,用于将经过哈希处理的标识符发送到CX Enterprise。 在发送客户 ID 之前,您可以继续使用自己的哈希处理方法。有两种方法可以对 setCustomerIDs 实施哈希处理支持,具体如以下部分所述:

在 ECID 中使用 setCustomerIDs 方法 use-setcustomerids-method

第一种方法是使用 setCustomerIDs (customerIDs<object>, hashType<string>) 方法。

在进行哈希处理之前,ECID 库会对 customerIDs 执行数据标准化。 此过程会去除 customerIDs 两端的空格,并将所有字符转换为小写。 例如,电子邮件地址“ ecid@adobe.com ”会变为“ecid@adobe.com”

请参阅下面的代码示例,了解如何使用 SHA-256 哈希处理来设置单个客户 ID(上面提到的电子邮件地址)。

// Set single customerID with SHA-256 hashing
visitor.setCustomerIDs({email: {id: "ecid@adobe.com", authState: 1}}, "SHA-256");

除了ECID之外,您还可以将其他的客户ID、身份验证状态以及哈希类型(SHA-256)与每位访客关联。 如果您不提供任何哈希类型,则将被视为不进行哈希处理。

setCustomerIDs 方法可以接受同一访客拥有多个客户 ID。 这有助于您识别或锁定跨不同设备的单独用户。 例如,您可以将这些ID作为客户属性上传到CX Enterprise,并在不同的解决方案中访问此数据。

客户 ID、身份验证状态以及哈希类型​ 不会 ​存储在 Cookie 中以供稍后使用, 而是应存储在实例变量中,以便使用 getCustomerIDs 进行检索,如下所示:

> visitor.getCustomerIDs();
< {email: {…}}
    email: {id: "a6ea4cde5da5ae7cc68baae894d1d6544fca26254433b0fff7c2cb4843b4a097", authState: 1, hashType: "SHA-256"}
    __proto__: Object

使用setCustomerIDs方法会导致调用访客ID服务dpm.demdex.net,以及包含经过哈希处理的客户ID的d_cid_ic查询参数。 调用示例可能与以下内容类似。 为清楚起见,添加了换行符。

http://dpm.demdex.net/id?d_visid_ver=4.4.0&d_fieldgroup=AAM&d_rtbd=json&d_ver=2&
d_orgid=12A3F3F459CE0AD80A495CBE%40AdobeOrg&d_nsid=0&d_mid=12349850857640731290890207735189050123&
d_blob=6G1ynYcLPuiQxYZrsz_pkqfLG9yMXBpb2zX5dvJdYQJzPXImdj0y&
d_cid_ic=email%a6ea4cde5da5ae7cc68baae894d1d6544fca26254433b0fff7c2cb4843b4a097%011&
ts=1563299964843

请参阅下表,了解有关 d_cid_ic 参数和身份验证状态的描述。

参数
描述
d_cid_ic

将集成代码、独特用户ID (DPUUID)和经过身份验证的状态ID传递到访客ID服务。 使用非打印控制字符将集成代码与DPUUID分隔开%01
示例:d_cid_ic=Integration_code%01DPUUID%01Authentication_state
身份验证状态
这是 d_cid_ic 参数中的一个可选 ID。 此 ID 以整数形式表示,用于根据用户的身份验证状态来标识用户,如下所示:

  • 0(未知或从未验证)
  • 1(当前已经针对此实例/页面/应用程序上下文进行了身份验证)
  • 2(已注销)

示例:

  • 未知:…d_cid=123%01456%010
  • 已通过身份验证:…d_cid=123%01456%011
  • 已注销:…d_cid=123%01456%012

在标记中添加操作 add-action-launch

Adobe Experience Platform中的标记数据收集是Adobe推出的新一代标记管理功能。 请参阅标记文档以了解详情。

要在标记中添加操作,请阅读规则文档并查看下面的屏幕截图:

确认您的配置后,标记会将数据打包到一个对象中,如下所示:

{
    integration_code: {
        id: "value",
        authState: auth_state,
        hashType: "hash_algorithm"
    }
}

下面是一个代码示例:

// Set single customer ID with hash type
setCustomerIDs(Ingeration code: {
    id: "string_value",
    authState: auth_state,
    hashType: "hash_algorithm"
});

与第一部分所述的setCustomerIDs方法类似,这会导致调用访客ID服务以及d_cid_ic查询参数。

recommendation-more-help
id-service-help