移动到Web和跨域ID共享

概述

Adobe Experience Platform Web SDK支持访客ID共享功能，使客户能够在移动应用程序和移动Web内容之间以及跨域更准确地提供个性化体验。

用例

在移动应用程序和移动网站之间提供一致的个性化

一家服装公司希望根据客户的兴趣为其客户提供个性化体验，并在同时加载WebViews的移动应用程序中保持个性化的准确性。 通过使用移动到Web ID共享功能，他们可以确保在应用程序和移动Web内容中使用相同的访客标识符，通过传递 ECID 到移动Web URL。

跨域提供一致的个性化

拥有多个在线商店的零售商希望根据客户兴趣对其域中的购物者体验进行个性化。 通过使用Web SDK跨域ID共享功能，零售商可以基于客户兴趣在其所有域中提供准确的优惠。

增强访客活动报告功能

技术零售商希望提供有关访客何时从移动应用程序移动到其移动网站或何时移动到其其他域的信息来改进其访客活动报表。 通过使用Web SDK跨域ID共享功能，营销团队可以准确地跟踪其Web资产中的访客并生成活动报表。

先决条件

要使用移动到Web和跨域ID共享，您必须使用 Web SDK 版本2.11.0或更高版本。

对于Edge Network移动实施，此功能在 边缘网络的标识 从版本1.1.0(iOS和Android)开始的扩展。

此功能还与 VisitorAPI.js 版本1.7.0或更高版本。

移动到Web ID共享

使用 getUrlVariables 来自的API 边缘网络的标识 扩展名，用于在打开时检索标识符作为查询参数并将其附加到您的URL webViews.

Web SDK无需其他配置即可接受 ECID 查询字符串中的值。

查询字符串参数包括：

  • MCID：Experience CloudID (ECID)
  • MCORGID：Experience Cloud orgID 必须匹配 orgID 在中配置 Web SDK.
  • TS：时间戳参数不能早于5分钟。

移动到Web ID共享使用 adobe_mc 参数。 当 adobe_mc 参数存在且有效， ECID 来自查询字符串的域名自动添加到向Edge Network发出的第一个请求中的标识映射。 所有后续的Edge Network交互都将使用 ECID.

有关如何将访客ID从移动应用程序传递到WebView的更多信息，请参阅此文档位于 处理WebView.

跨域标识共享

对于跨域ID共享，Web SDK版本2.11.0添加了对 appendIdentityToUrl 命令。 使用此命令时，会生成 adobe_mc 查询字符串参数。

该命令接受一个具有一个属性的对象， url，并返回具有属性的对象 url.

此命令不等待任何同意更新。 如果未提供同意，则返回的URL将保持不变。

如果 ECID 未提供，则 /acquire 将调用端点以生成 ECID.

以下示例介绍了客户如何在其网站上实施跨域ID共享。

此代码会为页面上的所有点击添加一个事件侦听器，如果点击指向匹配域的链接（在本例中为） adobe.com 或 behance.com)，将标识添加到URL并在那里重定向用户。

document.addEventListener("click", event => {
  const anchor = event.target.closest("a");
  if (!anchor || !anchor.href) {
    return;
  }
  const url = new URL(anchor.href);
  if (!url.hostname.endsWith("adobe.com") && !url.hostname.endsWith("behance.com")) {
    return;
  }
  event.preventDefault();
  alloy("appendIdentityToUrl", { url: anchor.href }).then(result => {
    document.location = result.url;
  });
});

使用标记扩展

与使用 Web SDK中，不需要进行其他配置 Tags 扩展，以使用通过URL传递的标识。

要通过Tags扩展使用移动到Web和跨域ID共享，您必须使用Tags扩展版本2.12.0或更高版本。

要将当前页面中的标识共享给其他域，需在 Web SDK Tags 扩展。 此操作设计为与 核心 — 单击 事件类型和值比较条件。

按照描述的步骤操作 此处 要创建具有以下配置的规则，请执行以下操作：

  • 事件配置：

    • 扩展：核心

    • 事件类型：单击

    • 选择 用户单击>特定元素时

    • 键入 选择器： a[href]. 只要在页面上单击锚点标记，此事件就会触发。 href 属性。

      显示具有上述设置的事件配置的用户界面图像

  • 条件配置

    • 逻辑类型： 常规

    • 扩展： 核心

    • 完成情况类型： 值比较

    • 左操作数： %this.hostname%. 这是一个与配合使用的特殊数据元素 核心 — 单击 事件并解析为所单击链接的主机名。

    • 运算符： 匹配Regex

    • 右操作数：键入与要与其共享标识的域匹配的正则表达式。 例如，匹配以结尾的主机名链接 adobe.com 或 behance.com，使用此正则表达式： behance.com$|adobe.com$. 链接的页面需要具有 Web SDK 或 Visitor ID 安装以接受身份。

      显示具有上述设置的条件配置的UI图像

  • 操作配置

    • 扩展： Adobe Experience Platform Web SDK

    • 操作类型： 使用标识重定向

    • 实例：选择您的实例。 在大多数情况下，您只会配置一个实例。 如果您有多个实例，请选择具有您要共享的标识的实例。

      显示具有上述设置的操作配置的用户界面图像

此 使用标识重定向 操作将阻止浏览器导航到链接。 然后，它将调用 appendIdentityToUrl 上的方法 Web SDK 实例。

最后，它会将用户重定向到 URL 使用 adobe_mc 已附加查询字符串参数。

在此页面上