Documentação AEM Tutoriais do AEM Tutorials do AEM Sites

[Integração]{class="badge positive"}

Integrar o AEM Sites e o SDK da Web do Experience Platform

Last update: Tue Sep 03 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:
Integrações

Criado para:

Iniciante
Intermediário
Administrador
Desenvolvedor

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

Saiba como integrar o AEM as a Cloud Service ao Experience Platform SDK da Web. Esta etapa fundamental é essencial para a integração de produtos Adobe Experience Cloud, como Adobe Analytics, Target ou produtos inovadores recentes, como Real-time Customer Data Platform, Customer Journey Analytics e Journey Optimizer.

Você também aprenderá a coletar e enviar dados de visualização de página do WKND - projeto de amostra do Adobe Experience Manager no Experience Platform.

Após concluir esta configuração, você implementou uma base sólida. Além disso, você está pronto para avançar na implementação de Experience Platform usando aplicativos como Real-time Customer Data Platform (Real-Time CDP), Customer Journey Analytics (CJA) e Adobe Journey Optimizer (AJO). A implementação avançada ajuda a impulsionar um melhor engajamento do cliente padronizando a Web e os dados do cliente.

Pré-requisitos

Os seguintes requisitos são necessários ao integrar o SDK da Web do Experience Platform.

Em AEM como Cloud Service:

Acesso do administrador do AEM ao ambiente do AEM as a Cloud Service
Acesso do gerente de implantação ao Cloud Manager
Clonar e implantar o WKND - projeto de amostra do Adobe Experience Manager no ambiente do AEM as a Cloud Service.

Em Experience Platform:

Acesso à sandbox de produção padrão, Prod.
Acesso a Esquemas em Gerenciamento de dados
Acesso a Conjuntos de dados em Gerenciamento de dados
Acesso a Datastreams em Coleção de dados
Acesso a Tags em Coleção de dados

Caso você não tenha as permissões necessárias, o administrador do sistema que usa o Adobe Admin Console poderá conceder as permissões necessárias.

https://video.tv.adobe.com/v/3418856?quality=12&learn=on

Criar esquema XDM - Experience Platform

O esquema do Experience Data Model (XDM) ajuda a padronizar os dados de experiência do cliente. Para coletar os dados de visualização de página do WKND, crie um Esquema XDM e use os grupos de campos fornecidos pelo Adobe AEP Web SDK ExperienceEvent para a coleta de dados da Web.

Há informações genéricas e específicas de setores, por exemplo, Varejo, Serviços financeiros, Saúde e muito mais, conjunto de modelos de dados de referência. Consulte Visão geral dos modelos de dados do setor para obter mais informações.

https://video.tv.adobe.com/v/3436007?quality=12&learn=on&captions=por_br

Saiba mais sobre o Esquema XDM e conceitos relacionados, como grupos de campos, tipos, classes e tipos de dados na visão geral do Sistema XDM.

A visão geral do Sistema de XDM é um ótimo recurso para aprender sobre o Esquema de XDM e conceitos relacionados, como grupos de campos, tipos, classes e tipos de dados. Ele fornece uma compreensão abrangente do modelo de dados XDM e como criar e gerenciar esquemas XDM para padronizar dados na empresa. Explore-o para obter uma compreensão mais profunda do esquema XDM e como ele pode beneficiar seus processos de coleta e gerenciamento de dados.

Criar sequência de dados - Experience Platform

Um fluxo de dados instrui o Edge Network da plataforma para onde enviar os dados coletados. Por exemplo, ela pode ser enviada para o Experience Platform, Analytics ou Adobe Target.

https://video.tv.adobe.com/v/3418895?quality=12&learn=on

Familiarize-se com o conceito de Datastreams e tópicos relacionados, como governança e configuração de dados, visitando a página Visão geral das Datastreams.

Criar propriedade de tag - Experience Platform

Saiba como criar uma propriedade de tag no Experience Platform para adicionar a biblioteca JavaScript do SDK da Web ao site da WKND. A propriedade de tag recém-definida tem os seguintes recursos:

Extensões de Marca: Core e Adobe Experience Platform Web SDK
Elementos de dados: os elementos de dados do tipo de código personalizado que extraem o nome da página, a seção do site e o nome do host usando a Camada de dados do cliente Adobe do site WKND. Além disso, o elemento de dados do tipo Objeto XDM é compatível com a nova etapa do Esquema XDM do WKND recém-criada anteriormente Criar Esquema XDM.
Regra: Enviar dados para o Platform Edge Network sempre que uma página da Web WKND for visitada usando o evento cmp:show acionado pela Camada de Dados do Cliente Adobe.

Ao criar e publicar a biblioteca de marcas usando o Fluxo de Publicação, você pode usar o botão Adicionar Todos os Recursos Alterados. Para selecionar todos os recursos como Elemento de dados, Regra e Extensões de tag, em vez de identificar e selecionar um recurso individual. Além disso, durante a fase de desenvolvimento, você pode publicar a biblioteca apenas no ambiente Desenvolvimento e, em seguida, verificá-la e promovê-la para o ambiente Preparo ou Produção.

https://video.tv.adobe.com/v/3418896?quality=12&learn=on

TIP

O elemento de dados e o código de evento de regra mostrados no vídeo estão disponíveis para sua referência, expanda o elemento de acordeão abaixo. No entanto, se você NÃO estiver usando a Camada de dados de clientes Adobe, deverá modificar o código abaixo, mas o conceito de definir os Elementos de dados e usá-los na definição de Regra ainda se aplica.

Elemento de dados e código de evento de regra

O código do Elemento de Dados Page Name.

code language-javascript

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']; }

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'];
}

O código do Elemento de Dados Site Section.

code language-javascript

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 }

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
}

O código do Elemento de Dados Host Name.

code language-javascript
`if(window && window.location && window.location.hostname) { return window.location.hostname; }`

O código Rule-Event all pages - on load

code language-javascript

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); });

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);
});

A Visão geral das tags fornece um conhecimento profundo sobre conceitos importantes como Elementos de dados, Regras e Extensões.

Para obter informações adicionais sobre a integração dos Componentes principais do AEM com a Camada de Dados de Clientes Adobe, consulte o guia Uso da Camada de Dados de Clientes Adobe AEM com Componentes Principais do.

Conectar propriedade de tag ao AEM

Descubra como vincular a propriedade de tag recém-criada ao AEM por meio do Adobe IMS e tags na Configuração do Adobe Experience Platform no AEM. Quando um ambiente do AEM as a Cloud Service é estabelecido, várias configurações de conta técnica do Adobe IMS são geradas automaticamente, incluindo tags. Para obter instruções passo a passo, consulte Conectar o AEM Sites com a Propriedade de Marca usando IMS.

No entanto, para a versão AEM 6.5, é necessário configurar um manualmente.

Depois de vincular a propriedade da tag, o site da WKND pode carregar a biblioteca de JavaScript da propriedade da tag nas páginas da Web usando as tags na configuração do serviço de nuvem da Adobe Experience Platform.

Verificar carregamento de propriedade de tag no WKND

Usando a extensão Adobe Experience Platform Debugger Chrome, verifique se a propriedade da marca está sendo carregada nas páginas WKND. Você pode verificar,

Detalhes de propriedade da tag, como extensão, versão, nome e muito mais.
Versão da biblioteca do SDK da Web da plataforma, ID da sequência de dados
Objeto XDM como parte do atributo events no SDK da Web do Experience Platform

https://video.tv.adobe.com/v/3418897?quality=12&learn=on

Criar conjunto de dados - Experience Platform

Os dados de visualização de página coletados usando o SDK da Web são armazenados no data lake do Experience Platform como conjuntos de dados. O conjunto de dados é uma construção de armazenamento e gerenciamento para uma coleção de dados, como uma tabela de banco de dados que segue um esquema. Saiba como criar um Conjunto de dados e configurar a sequência de dados criada anteriormente para enviar dados para o Experience Platform.

https://video.tv.adobe.com/v/3418898?quality=12&learn=on

A visão geral dos conjuntos de dados fornece mais informações sobre conceitos, configurações e outros recursos de assimilação.

Dados de visualização de página do WKND no Experience Platform

Após a configuração do SDK da Web com AEM, particularmente no site da WKND, é hora de gerar tráfego navegando pelas páginas do site. Em seguida, confirme se os dados de pageview estão sendo assimilados no conjunto de dados do Experience Platform. Na interface do usuário do conjunto de dados, vários detalhes, como registros totais, tamanho e lotes assimilados, são exibidos junto com um gráfico de barras visualmente atraente.

https://video.tv.adobe.com/v/3418899?quality=12&learn=on

Resumo

Excelente trabalho. Você concluiu a configuração do AEM com o SDK da Web do Experience Platform para coletar e assimilar dados de um site. Com essa base, agora é possível explorar mais possibilidades para aprimorar e integrar produtos como Analytics, Target, Customer Journey Analytics (CJA) e muitos outros, a fim de criar experiências avançadas e personalizadas para seus clientes. Continue aprendendo e explorando para liberar todo o potencial do Adobe Experience Cloud.

https://video.tv.adobe.com/v/3418900?quality=12&learn=on

AVAILABILITY

Se preferir o vídeo completo que cobre todo o processo de integração em vez de vídeos individuais da etapa de configuração, você pode clicar aqui para acessá-lo.

Recursos adicionais

recommendation-more-help

bb44cebf-d964-4e3c-b64e-ce882243fe4d