[集成]{class="badge positive"}
集成AEM Sites和Experience Platform Web SDK
[AEM Sites as a Cloud Service]{class="badge informative"}
了解如何将AEM as a Cloud Service与Experience Platform Web 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 Platform Web SDK时需要满足以下条件。
在 AEM as 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
数据流指示Platform Edge 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架构内部版本。
- 规则：每当使用触发的
cmp:show事件的Adobe客户端数据层访问WKND网页时，将数据发送到Platform Edge 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核心组件结合使用指南。
将Tag属性连接到AEM
了解如何通过AEM中的Adobe IMS和Adobe Experience Platform配置中的标记，将最近创建的标记属性链接到AEM。 建立AEM as a Cloud Service环境后，会自动生成多个Adobe IMS技术帐户配置，包括标记。 有关分步说明，请参阅使用IMS连接AEM Sites与标记属性。
但是，对于AEM 6.5版本，您必须手动配置一个。
关联Tag属性后，WKND站点便能够使用Adobe Experience Platform云服务配置中的标记将标记属性的JavaScript库加载到网页上。
验证WKND上是否加载了标记属性
使用Adobe Experience Platform Debugger Chrome扩展，验证WKND页面上是否加载了标记属性。 你可以确认，
- 标记属性详细信息，例如扩展、版本、名称等。
- 平台Web SDK库版本，数据流ID
- XDM对象作为Experience Platform Web SDK中的
events属性的一部分
创建数据集 — Experience Platform
使用Web SDK收集的Pageview数据将作为数据集存储在Experience Platform数据湖中。 数据集是用于数据集合的存储和管理结构，如跟踪架构的数据库表。 了解如何创建数据集并配置之前创建的数据流以将数据发送到Experience Platform。
数据集概述提供了有关概念、配置和其他摄取功能的更多信息。
Experience Platform中的WKND pageview数据
在使用AEM设置Web SDK后（尤其是在WKND网站上），现在可以通过导航站点页面来生成流量。 然后，确认是否正在将pageview数据摄取到Experience Platform数据集中。 在数据集UI中，各种详细信息（如总记录数、大小和摄取的批次）都会与直观的条形图一起显示。
摘要
做得好！您已使用Experience Platform Web SDK完成AEM的设置，以便从网站收集和摄取数据。 利用此基础，您现在可以探索更多可能性来增强和集成Analytics、Target、Customer Journey Analytics (CJA)和许多其他产品，为您的客户打造丰富的个性化体验。 不断学习和探索，以充分挖掘Adobe Experience Cloud的潜力。