[Alpha]{class="badge informative"}

idMigrationEnabled (服务器SDK)

本页介绍了Server SDK configure方法中的idMigrationEnabled。 对于Web SDK,请参阅idMigrationEnabled.

idMigrationEnabled属性允许服务器SDK重用旧版Adobe访客ID服务(VisitorAPI.js)分配给访客的Experience Cloud ID (ECID)。 访客ID服务将ECID存储在名为AMCV_<orgId>的Cookie中。 当您从访客ID服务转到Web SDK或服务器SDK时,重用这些ID可防止独特访客数量急剧增加。

标识迁移在服务器上如何工作 how-it-works

SDK通过您传递给forRequest的Cookie服务读取和写入Cookie。 当idMigrationEnabled为true时:

  1. 如果访客没有kndctr_<orgId>_identity Cookie,但具有AMCV_<orgId> Cookie,则SDK将从AMCV_ Cookie中读取ECID并将其添加到事件的identityMap。 然后,Edge Network会继续将该ECID用于访客。
  2. 在Edge Network返回访客身份后,SDK会将其写入kndctr_<orgId>_identity Cookie和AMCV_<orgId> Cookie,以便仍使用访客ID服务的页面识别同一访客。

仅当您的Cookie服务为SDK提供对访客真实浏览器Cookie的访问权限时,并且仅当访客ID服务在使用相同orgId的同一域上运行时,身份迁移才有效。 服务器SDK无法从访客ID服务库本身读取身份,因为该库仅在浏览器中运行。

如果您的Cookie服务未读取访客的浏览器Cookie,或者您的网站从未使用访客ID服务,则标识迁移没有任何效果。

代码示例

调用configure时设置idMigrationEnabled布尔值。 如果省略,则默认为true。 将其设置为false可阻止SDK读取和写入AMCV_ Cookie。

await alloy.configure({
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  edgeCredentials: {
    clientId: process.env.ADOBE_CLIENT_ID,
    clientSecret: process.env.ADOBE_CLIENT_SECRET,
    scopes: process.env.ADOBE_SCOPES.split(",")
  },
  idMigrationEnabled: false
});
recommendation-more-help
experience-platform-help-collection