DocumentaçãoCustomer Journey AnalyticsGuia do Customer Journey Analytics

Adicionar a lógica da coleção de dados XDM à sua tag

Last update: Mon Nov 11 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Administrador
NOTE
Siga as etapas desta página somente após concluir todas as etapas de atualização anteriores. Você pode seguir as etapas de atualização recomendadas ou seguir as etapas de atualização que foram geradas dinamicamente para a sua organização com o questionário de atualização do Adobe Analytics para o Customer Journey Analytics.
Após concluir as etapas desta página, continue seguindo as etapas de atualização recomendadas ou as etapas de atualização geradas dinamicamente.

Depois de criar a marca e adicionar a extensão SDK da Web, você deve configurá-la com elementos de dados e regras, de acordo com como deseja rastrear seu site e enviar dados para a Adobe Experience Platform. Depois de configurar elementos de dados e regras para a tag, você pode criá-la e publicá-la.

Configurar elementos de dados

Os elementos de dados são os blocos fundamentais do seu dicionário de dados (ou mapa de dados). Use elementos de dados para coletar, organizar e entregar dados em toda a tecnologia de marketing e anúncios. Você configura elementos de dados na tag que são lidos a partir da camada de dados e podem ser usados para fornecer dados à Adobe Experience Platform.

Há diferentes tipos de elementos de dados. Primeiro, configure um elemento de dados para capturar o nome da página que as pessoas estão visualizando no site. Em seguida, configure um elemento de dados que faça referência à ID do Experience Cloud. Por fim, defina um elemento de dados de objeto XDM.

Elemento de dados do nome da página

Para definir um elemento de dados de nome de página:

  1. Faça logon em experience.adobe.com usando suas credenciais da Adobe ID.

  2. No Adobe Experience Platform, vá para Coleção de Dados > Marcas.

  3. Selecione a tag criada recentemente na lista de Propriedades da tag para abri-la.

  4. Selecione Elementos de dados no painel esquerdo.

  5. Selecione Adicionar elemento de dados.

  6. Na caixa de diálogo Criar Elemento de Dados, especifique as seguintes informações:

    • Nome: o nome do seu elemento de dados. Por exemplo, Page Name.

    • Extensão: selecione Núcleo na lista.

    • Tipo de Elemento de Dados: Selecione Informações da Página na lista.

    • Atributo: selecione Título na lista.

      Criar elemento de data usando informações da página

      Como alternativa, você pode usar o valor de uma variável da camada de dados, por exemplo pageName e o tipo de elemento de dados da Variável JavaScript para definir o elemento de dados.

      Criar elemento de dados usando a variável Javascript

  7. Selecione Salvar.

    Agora você deseja configurar um elemento de dados que faça referência à ID da Experience Cloud, fornecida automaticamente pelo SDK da Web da Adobe Experience Platform e disponível por meio da extensão do Serviço da Experience Cloud ID.

  8. Continuar com elemento de dados ECID.

Elemento de dados ECID

Para definir um elemento de dados da ECID:

  1. Faça logon em experience.adobe.com usando suas credenciais da Adobe ID.

  2. No Adobe Experience Platform, vá para Coleção de Dados > Marcas.

  3. Selecione a tag criada recentemente na lista de Propriedades da tag para abri-la.

  4. Selecione Elementos de dados no painel esquerdo.

  5. Selecione Adicionar elemento de dados.

  6. Na caixa de diálogo Criar Elemento de Dados, especifique as seguintes informações:

    • Nome: o nome do seu elemento de dados. Por exemplo, ECID.

    • Extensão: selecione Serviço de ID de Experience Cloud na lista.

    • Tipo de Elemento de Dados: Selecione ECID na lista.

      Elemento de dados da ECID

  7. Selecione Salvar.

  8. Continuar com elemento de dados do objeto XDM.

Elemento de dados do objeto XDM

Por fim, agora é possível mapear qualquer um dos elementos de dados específicos para o esquema definido anteriormente. Você define outro elemento de dados que fornece uma representação do esquema XDM.

Para definir um elemento de dados de objeto XDM:

  1. Faça logon em experience.adobe.com usando suas credenciais da Adobe ID.

  2. No Adobe Experience Platform, vá para Coleção de Dados > Marcas.

  3. Selecione a tag criada recentemente na lista de Propriedades da tag para abri-la.

  4. Selecione Elementos de dados no painel esquerdo.

  5. Selecione Adicionar elemento de dados.

  6. Na caixa de diálogo Criar Elemento de Dados, especifique as seguintes informações:

    • Nome: o nome do seu elemento de dados. Por exemplo, XDM - Page View.

    • Extensão: selecione Adobe Experience Platform Web SDK na lista.

    • Tipo de Elemento de Dados: Selecione Objeto XDM na lista.

    • Sandbox: selecione sua sandbox na lista.

    • Esquema: selecione seu esquema na lista.

  7. Mapeie o atributo identification > core > ecid, definido no esquema, no elemento de dados da ECID. Selecione o ícone de cilindro para escolher facilmente o elemento de dados da ECID na lista de elementos de dados.

    Selecionar elemento de dados da ECID

    Mapear elemento de dados da ECID

  8. Mapeie o atributo web > webPageDetails > name, definido no esquema, para o elemento de dados Nome da página.

    Mapear elemento de dados do nome da página

  9. Selecione Salvar.

  10. Continuar com Configurar regras.

Configurar regras

As tags na Adobe Experience Platform seguem um sistema baseado em regras. Elas buscam a interação do usuário e dados associados. Quando os critérios definidos nas regras são cumpridos, a regra aciona a extensão, o script ou o código do lado do cliente identificado. Você pode usar regras para enviar dados (como um objeto XDM) para a Adobe Experience Platform usando a extensão do SDK da Web da Adobe Experience Platform.

Para definir uma regra:

NOTE
As etapas a seguir são um exemplo de definição de uma regra que envia dados XDM, contendo valores de outros elementos de dados, para o Adobe Experience Platform.
Você pode usar as regras de várias maneiras na tag para manipular variáveis (usando os elementos de dados).
Consulte Regras de para obter mais informações.

  1. Faça logon em experience.adobe.com usando suas credenciais da Adobe ID.

  2. No Adobe Experience Platform, vá para Coleção de Dados > Marcas.

  3. Selecione a tag criada recentemente na lista de Propriedades da tag para abri-la.

  4. Selecione Regras no painel esquerdo.

  5. Selecione Criar nova regra.

  6. Na caixa de diálogo Criar Regra, especifique as seguintes informações:

    • Nome: o nome da regra. Por exemplo, Page View.

    • Eventos: Selecione + Adicionar. Em seguida, na caixa de diálogo Configuração de evento, especifique as informações a seguir. Quando terminar, selecione Manter alterações.

      • Extensão: selecione Núcleo na lista.

      • Tipo de Evento: Selecione Janela Carregada na lista.

        Regra - Configuração de evento

    • Ações: Selecione + Adicionar. Em seguida, na caixa de diálogo Configuração da ação, especifique as informações a seguir. Quando terminar, selecione Manter alterações.

      • Extensão: selecione Adobe Experience Platform Web SDK na lista.

      • Tipo de ação: selecionar Enviar Evento da lista.

      • Tipo: selecione web.webpagedetails.pageViews da lista.

      • Dados XDM: selecione o ícone do cilindro e selecione XDM - Exibição de página na lista de elementos de dados.

        Regra - Configuração de ação

        Sua regra deve ter a seguinte aparência:

        Criar regra

  7. Selecione Salvar.

Criar e publicar sua tag

Depois de definir elementos de dados e regras, você deve criar e publicar sua tag. Ao criar um build de biblioteca, você deve atribuí-lo a um ambiente. As extensões, regras e elementos de dados da build são compilados e colocados no ambiente atribuído. Cada ambiente fornece um código integrado exclusivo que permite integrar a build atribuída ao site.

As tags do Adobe Experience Platform são compatíveis com fluxos de trabalho de publicação simples a complexos que devem acomodar a implantação do SDK da Web da Adobe Experience Platform. Consulte Visão geral de publicação para obter mais informações.

Para criar e publicar a tag:

  1. Faça logon em experience.adobe.com usando suas credenciais da Adobe ID.

  2. No Adobe Experience Platform, vá para Coleção de Dados > Marcas.

  3. Selecione a tag criada recentemente na lista de Propriedades da tag para abri-la.

  4. Selecione Fluxo de publicação no painel esquerdo.

  5. Selecione Selecionar uma biblioteca de trabalho, seguida de Adicionar biblioteca….

  6. Na caixa de diálogo Criar Biblioteca, especifique as seguintes informações:

    • Nome: o nome da biblioteca.

    • Ambiente: selecione Desenvolvimento (desenvolvimento) na lista.

  7. Clique em + Adicionar todos os recursos alterados.

    Publicar - Criar biblioteca

  8. Selecione Salvar e criar no desenvolvimento.

    A tag é salva e é criada para o ambiente de desenvolvimento. Um ponto verde indica uma criação bem-sucedida da tag no ambiente de desenvolvimento.

  9. Você pode selecionar … para recriar a biblioteca ou mover a biblioteca para um ambiente de preparo ou produção.

    Publicar - Criar biblioteca

recommendation-more-help
080e5213-7aa2-40d6-9dba-18945e892f79