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数据收集标记界面中的规则中的操作执行。
- 使用您的Adobe ID凭据登录experience.adobe.com。
- 导航到 数据收集 > 标记。
- 选择所需的标记属性。
- 导航到 规则,然后选择所需的规则。
- 在操作下,选择现有操作或创建操作。
- 将扩展下拉字段设置为 Adobe Experience Platform Web SDK,并将操作类型设置为 使用标识重定向。
- 单击 保留更改,然后运行发布工作流程。
此命令通常与监听点击并检查所需域的特定规则一起使用。
规则事件条件
单击具有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;});
});
ad108910-6329-42f1-aa1d-5920a2b13636