将标识从移动应用程序共享到移动Web/WebViews
当访客从移动应用程序移至WebView或移动网页时,应用程序和Web上下文将分别维护各自的身份。 如果没有明确切换,则Web体验会将访客视为新的未知人员,这会分割报表并重新启动个性化。
移动到Web身份共享可通过查询字符串参数将访客的Experience Cloud ID (ECID)adobe_mc从移动应用程序传递到Web目标,从而解决此问题。 参数包含ECID、您的Experience Cloud组织ID和时间戳。 当Web目标加载有效的adobe_mc参数时,Web SDK会自动读取该参数,并在其第一个Edge Network请求中应用切换身份,因此两个上下文共享同一访客。
当您的移动应用程序打开由组织控制的WebView或移动网页,并且您希望应用程序活动和Web活动保持绑定到同一访客时,请使用此模式。 如果您的目标是不同域上的网站之间的标识连续性,请改用跨域共享。
先决条件
在开始之前,请确保您的实施满足以下要求:
- 移动设备应用程序: Adobe Experience Platform移动设备SDK,具有Edge Network扩展版本1.1.0或更高版本 (iOS和Android)的标识。
- Web目标: Web SDK版本2.11.0或更高版本,或Web SDK标记扩展。
- URL控件:您的代码控制应用程序传递给WebView或浏览器的URL,以便您可以向其附加查询字符串参数。
- 匹配配置:在移动和Web实施中配置了相同的Experience Cloud组织ID。
从移动设备应用程序中检索身份 retrieve-identity
使用Edge Network Identity扩展中的getUrlVariables API以查询字符串形式检索访客身份。 然后,您可以在打开WebView或浏览器之前将该字符串附加到URL中。
返回的字符串包含以下URL编码的参数:
参数
描述
MCIDExperience Cloud ID (ECID)。
MCORGID您的Experience Cloud组织ID。 此参数必须与目标页面上的Web SDK中配置的组织匹配。
TS时间戳。 目标必须在 5分钟 内收到此值,否则切换被拒绝。
以下代码示例显示了切换在您的移动应用程序中可能显示的内容:
Swift (iOS)
| code language-swift |
|---|
|
科特林(Android)
| code language-kotlin |
|---|
|
在Web端接收身份 receive-identity
Web目标上不需要其他代码。 如果页面上存在Web SDK,且URL包含有效的adobe_mc参数,则SDK会自动提取ECID,并将其应用于首次Edge Network请求中的访客身份映射。
如果您的Web目标使用Web SDK标记扩展,并且需要在保留身份的同时将访客重定向到其他页面,请使用带有身份的重定向操作将adobe_mc参数转发到下一页。
NOTE
adobe_mc参数将在 5分钟 后过期。 确保Web目标在打开URL后立即加载并发送其第一个Edge Network请求。recommendation-more-help
1ae86b30-e55e-49c1-ab11-9d0356a5f3e1