[集成]{class="badge positive"}

集成AEM Sites和Experience PlatformWeb SDK

[AEM Sites as a Cloud Service]{class="badge informative"}

了解如何将AEMas a Cloud Service与Experience Platform集成 Web SDK. 此基础步骤对于集成Adobe Experience Cloud产品(例如Adobe Analytics、Target)或最近的创新产品(例如Real-time Customer Data Platform、Customer Journey Analytics和Journey Optimizer)至关重要。

您还将学习如何收集和发送 WKND — 示例Adobe Experience Manager项目 页面查看数据 Experience Platform.

完成此设置后,您便奠定了坚实的基础。 此外,您还可以使用如下应用程序来推进Experience Platform实施 Real-time Customer Data Platform (Real-Time CDP)Customer Journey Analytics(CJA)、和 Adobe Journey Optimizer (AJO). 高级实施通过标准化Web和客户数据来帮助提高客户参与度。

先决条件

集成Experience PlatformWeb SDK时,需要满足以下条件。

AEM作为Cloud Service

Experience Platform

  • 访问默认生产, Prod 沙盒。
  • 访问 架构 在“数据管理”下
  • 访问 数据集 在“数据管理”下
  • 访问 数据流 在数据收集下
  • 访问 标记 在数据收集下

如果您没有必要权限,您的系统管理员使用 Adobe Admin Console 可以授予必要的权限。

创建XDM架构 — Experience Platform

体验数据模型(XDM)架构可帮助您标准化客户体验数据。 要收集 WKND页面查看 数据,创建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网站。 新定义的标记属性具有以下资源:

  • 标记扩展: 核心Adobe Experience Platform Web SDK
  • 数据元素:使用WKND站点的Adobe客户端数据层提取page-name、site-section和host-name的自定义代码类型的数据元素。 此外,XDM对象类型数据元素也符合之前新创建的WKND XDM模式内部版本 创建XDM架构 步骤。
  • 规则:每当使用触发的Adobe客户端数据层访问WKND网页时,将数据发送到Platform Edge Network cmp:show 事件。

使用构建和发布标记库时 发布流,您可以使用 添加所有已更改资源 按钮。 选择所有资源,如数据元素、规则和标记扩展,而不是标识和选取单个资源。 此外,在开发阶段,您可以将库仅发布到 开发 环境,然后验证并将其提升到 Stage生产 环境。

TIP
视频中显示的数据元素和规则事件代码可供您参考, 展开下面的折叠元素. 但是,如果您未使用Adobe客户端数据层,则必须修改以下代码,但是定义数据元素并在规则定义中使用数据元素的概念仍然适用。
数据元素和规则事件代码
  • 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。 建立AEMas a Cloud Service环境后,会自动生成多个Adobe IMS技术帐户配置,包括标记。 但是,对于AEM 6.5版本,您必须手动配置一个。

在链接标记属性后,WKND网站可以使用Adobe Experience Platform云服务配置中的标记将标记属性的JavaScript库加载到网页上。

验证WKND上是否加载了标记属性

使用Adobe Experience Platform Debugger 铬黄 扩展,验证WKND页面上是否加载了标记属性。 你可以确认,

  • 标记属性详细信息,例如扩展、版本、名称等。
  • 平台Web SDK库版本,数据流ID
  • XDM对象作为部分 events Experience PlatformWeb SDK中的属性

创建数据集 — 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的潜力。

AVAILABILITY
如果您更喜欢 端到端视频 ,而不是单个设置步骤视频,您可以 此处 以访问它。

其他资源

recommendation-more-help
bb44cebf-d964-4e3c-b64e-ce882243fe4d