[集成]{class="badge positive"}
集成AEM Sites和Experience PlatformWeb SDK
[AEM Sites as a Cloud Service]{class="badge informative"}
了解如何将AEM as a Cloud Service与Experience PlatformWeb SDK集成。 此基础步骤对于集成Adobe Experience Cloud产品(例如Adobe Analytics、Target)或最近的创新产品(例如Real-time Customer Data Platform、Customer Journey Analytics和Journey Optimizer)至关重要。
您还将了解如何在Experience Platform中收集和发送WKND — 示例Adobe Experience Manager项目页面查看数据。
完成此设置后,您便奠定了坚实的基础。 此外,您已准备好使用诸如Real-time Customer Data Platform (Real-Time CDP)、Customer Journey Analytics(CJA)和Adobe Journey Optimizer (AJO)之类的应用程序来推进Experience Platform实施。 高级实施通过标准化Web和客户数据来帮助提高客户参与度。
先决条件
集成Experience PlatformWeb SDK时,需要满足以下条件。
在 AEM中,作为Cloud Service:
- AEM管理员对AEM as a Cloud Service环境的访问权限
- 部署管理员对Cloud Manager的访问权限
- 克隆WKND — 示例Adobe Experience Manager项目并将其部署到您的AEM as a Cloud Service环境。
在 Experience Platform 中:
- 访问默认生产 Prod 沙盒。
- 访问数据管理下的 架构
- 访问数据管理下的 数据集
- 访问数据收集下的 数据流
- 访问数据收集下的 标记
如果您没有必要的权限,则使用Adobe Admin Console的系统管理员可以授予必要的权限。
创建XDM架构 — Experience Platform
体验数据模型(XDM)架构可帮助您标准化客户体验数据。 要收集 WKND pageview 数据,请创建XDM架构并使用Adobe提供的字段组AEP Web SDK ExperienceEvent
进行Web数据收集。
有通用和特定行业,例如零售、金融服务、医疗保健等,以及参考数据模型套件。有关详细信息,请参阅行业数据模型概述。
从XDM系统概述了解XDM架构和相关概念,如字段组、类型、类和数据类型。
XDM系统概述是了解XDM架构和相关概念(如字段组、类型、类和数据类型)的绝佳资源。 它全面了解了XDM数据模型以及如何创建和管理XDM架构以标准化整个企业中的数据。 探索它以更深入地了解XDM架构以及它如何使您的数据收集和管理流程受益。
创建数据流 — Experience Platform
数据流指示PlatformEdge Network将收集的数据发送到何处。 例如,可以将其发送到Experience Platform或Analytics,或者Adobe Target。
请访问数据流概述页面,了解数据流的概念以及数据管理和配置等相关主题。
创建标记属性 — Experience Platform
了解如何在Experience Platform中创建标记属性以将Web SDK JavaScript库添加到WKND网站。 新定义的标记属性具有以下资源:
- 标记扩展: Core和Adobe Experience Platform Web SDK
- 数据元素:使用WKND站点的Adobe客户端数据层提取page-name、site-section和host-name的自定义代码类型的数据元素。 另外,XDM对象类型数据元素符合之前创建XDM架构步骤中新建的WKND XDM架构内部版本。
- 规则:每当使用Adobe客户端数据层触发
cmp:show
事件访问WKND网页时,将数据发送到PlatformEdge Network。
使用 发布流 生成和发布标记库时,您可以使用 添加所有更改的资源 按钮。 选择所有资源,如数据元素、规则和标记扩展,而不是标识和选取单个资源。 此外,在开发阶段,您可以仅将库发布到 开发 环境,然后验证并将其提升到 暂存 或 生产 环境。
-
Page Name
数据元素代码。code language-javascript if(event && event.component && event.component.hasOwnProperty('dc:title')) { // return value of 'dc:title' from the data layer Page object, which is propogated via 'cmp:show` event return event.component['dc:title']; }
-
Site Section
数据元素代码。code language-javascript if(event && event.component && event.component.hasOwnProperty('repo:path')) { let pagePath = event.component['repo:path']; let siteSection = ''; //Check of html String in URL. if (pagePath.indexOf('.html') > -1) { siteSection = pagePath.substring(0, pagePath.lastIndexOf('.html')); //replace slash with colon siteSection = siteSection.replaceAll('/', ':'); //remove `:content` siteSection = siteSection.replaceAll(':content:',''); } return siteSection }
-
Host Name
数据元素代码。code language-javascript if(window && window.location && window.location.hostname) { return window.location.hostname; }
-
all pages - on load
规则事件代码code language-javascript var pageShownEventHandler = function(evt) { // defensive coding to avoid a null pointer exception if(evt.hasOwnProperty("eventInfo") && evt.eventInfo.hasOwnProperty("path")) { // trigger tags Rule and pass event console.debug("cmp:show event: " + evt.eventInfo.path); var event = { // include the path of the component that triggered the event path: evt.eventInfo.path, // get the state of the component that triggered the event component: window.adobeDataLayer.getState(evt.eventInfo.path) }; // Trigger the tags Rule, passing in the new 'event' object // the 'event' obj can now be referenced by the reserved name 'event' by other tags data elements // i.e 'event.component['someKey']' trigger(event); } } // set the namespace to avoid a potential race condition window.adobeDataLayer = window.adobeDataLayer || []; // push the event listener for cmp:show into the data layer window.adobeDataLayer.push(function (dl) { //add event listener for 'cmp:show' and callback to the 'pageShownEventHandler' function dl.addEventListener("cmp:show", pageShownEventHandler); });
标记概述提供了有关数据元素、规则和扩展等重要概念的深入知识。
有关将AEM核心组件与Adobe客户端数据层集成的其他信息,请参阅将Adobe客户端数据层与AEM核心组件结合使用指南。
将标记属性连接到AEM
了解如何通过AEM中的Adobe IMS和Adobe Experience Platform配置中的标记,将最近创建的标记属性链接到AEM。 建立AEM as a Cloud Service环境后,会自动生成多个Adobe IMS技术帐户配置,包括标记。 但是,对于AEM 6.5版本,您必须手动配置一个。
关联Tag属性后,WKND站点便能够使用Adobe Experience Platform云服务配置中的标记将标记属性的JavaScript库加载到网页上。
验证WKND上是否加载了标记属性
使用Adobe Experience Platform DebuggerChrome扩展,验证WKND页面上是否加载了标记属性。 你可以确认,
- 标记属性详细信息,例如扩展、版本、名称等。
- 平台Web SDK库版本,数据流ID
- XDM对象作为Experience PlatformWeb SDK中的
events
属性的一部分
创建数据集 — Experience Platform
使用Web SDK收集的Pageview数据将作为数据集存储在Experience Platform数据湖中。 数据集是用于数据集合的存储和管理结构,如跟踪架构的数据库表。 了解如何创建数据集并配置之前创建的数据流以将数据发送到Experience Platform。
数据集概述提供了有关概念、配置和其他摄取功能的更多信息。
Experience Platform中的WKND pageview数据
在使用AEM设置Web SDK后(尤其是在WKND网站上),现在可以通过导航站点页面来生成流量。 然后,确认是否正在将pageview数据摄取到Experience Platform数据集中。 在数据集UI中,各种详细信息(如总记录数、大小和摄取的批次)都会与直观的条形图一起显示。
摘要
做得好!您已使用Experience PlatformWeb SDK完成AEM的设置,可从网站中收集和摄取数据。 利用此基础,您现在可以探索更多可能性来增强和集成Analytics、Target、Customer Journey Analytics (CJA)和许多其他产品,为您的客户创造丰富的个性化体验。 不断学习和探索,以充分挖掘Adobe Experience Cloud的潜力。