appendIdentityToUrl

appendIdentityToUrl命令允许您向URL添加用户标识符作为查询字符串。 通过此操作,您可以在域之间携带访客身份,从而防止同时包含域或渠道的数据集出现重复访客计数。 它在Web SDK版本2.11.0或更高版本上可用。

生成并附加到URL的查询字符串是adobe_mc。 如果Web SDK找不到ECID,它将调用/acquire端点以生成一个ECID。

NOTE
如果未提供同意,则此方法的URL将保持不变。 此命令会立即运行;它不会等待同意更新。

使用Web SDK扩展将身份附加到URL extension

将身份附加到URL可作为Adobe Experience Platform数据收集标记界面中的规则中的操作执行。

  1. 使用您的Adobe ID凭据登录experience.adobe.com
  2. 导航到​ 数据收集 > 标记
  3. 选择所需的标记属性。
  4. 导航到​ 规则,然后选择所需的规则。
  5. 在操作下,选择现有操作或创建操作。
  6. 将扩展下拉字段设置为​ Adobe Experience Platform Web SDK,并将操作类型设置为​ 使用标识重定向
  7. 单击​ 保留更改,然后运行发布工作流程。

此命令通常与监听点击并检查所需域的特定规则一起使用。

规则事件条件

单击具有href属性的锚标记时触发。

  • 扩展:核心
  • 事件类型:单击
  • 用户单击 ​时:特定元素
  • 与CSS选择器匹配的元素a[href]

规则事件

规则条件

仅在所需的域上触发。

  • 逻辑类型:常规
  • 扩展:核心
  • 条件类型:值比较
  • 左操作数%this.hostname%
  • 运算符:匹配正则表达式
  • 右操作数:与所需域匹配的正则表达式。 例如:adobe.com$|behance.com$

规则条件

规则操作

将标识附加到URL。

  • 扩展: Adobe Experience Platform Web SDK
  • 操作类型:使用标识重定向

规则操作

使用Web SDK JavaScript库将身份附加到URL

以URL作为参数运行appendIdentityToUrl命令。 此方法会返回一个标识符作为查询字符串附加的URL。

alloy("appendIdentityToUrl",document.location);

您可以为页面上收到的所有点击添加事件侦听器,并检查URL是否与任何所需的域匹配。 如果超过100次,则将身份附加到URL并重定向用户。

document.addEventListener("click", event => {
  // Check if the click was a link
  const anchor = event.target.closest("a");
  if (!anchor || !anchor.href) return;

  // Check if the link points to the desired domain
  const url = new URL(anchor.href);
  if (!url.hostname.endsWith(".adobe.com") && !url.hostname.endsWith(".behance.com")) return;

  // Append the identity to the URL, then direct the user to the URL
  event.preventDefault();
  alloy("appendIdentityToUrl", {url: anchor.href}).then(result => {document.location = result.url;});
});

响应对象

如果您决定使用此命令处理响应,则响应对象包含​ url,新URL具有作为查询字符串参数添加的标识信息。

recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636