Adicionar um elemento de dados, uma regra e uma biblioteca

Nesta lição, você criará seu primeiro Elemento de dados, Regra e Biblioteca.

Elementos de dados e regras são os blocos de construção básicos das tags. Os Elementos de dados armazenam os atributos que você deseja enviar para as soluções de marketing e publicidade, enquanto as Regras acionam as solicitações para essas soluções nas condições certas. As bibliotecas são arquivos JavaScript carregados na página para fazer todo o trabalho. Nesta lição, você usará todos os três para forçar a página de amostra faça algo.

OBSERVAÇÃO

O Adobe Experience Platform Launch está sendo integrado à Adobe Experience Platform como um conjunto de tecnologias de coleção de dados. Várias alterações de terminologia foram implementadas na interface de que você deve estar ciente ao usar este conteúdo:

  • Agora o Platform launch (lado do cliente) é tags
  • O lado do servidor do Platform launch agora é event forwarding
  • As configurações de borda agora são datastreams

Objetivos de aprendizagem

No final desta lição, você poderá:

  • Criar um elemento de dados
  • Criar uma regra
  • Criar uma biblioteca
  • Adicionar alterações a uma biblioteca
  • Validar se a biblioteca está sendo carregada no navegador web
  • Use o recurso "Biblioteca de trabalho" para trabalhar com mais eficiência

Criar um elemento de dados para o Nome da página

Os elementos de dados são a versão das tags de uma camada de dados. Eles podem armazenar valores de seu próprio objeto de camada de dados, de cookies, objetos de armazenamento local, parâmetros da cadeia de caracteres de consulta, elementos da página, metatags etc. Neste exercício, você criará um elemento de dados para Nome da página, que será usado posteriormente nas implementações do Target e do Analytics.

Para criar um elemento de dados

  1. Na navegação à esquerda, clique em Elementos de dados

  2. Como você ainda não criou elementos de dados nessa propriedade, um breve vídeo é exibido com informações adicionais sobre este tópico. Assista a este vídeo se desejar

  3. Clique no botão Criar novo elemento de dados:

    Clique no botão Criar novo elemento de dados

  4. Nomeie o elemento de dados, por exemplo Page Name

  5. Use o tipo de elemento de dados Variável JavaScript para apontar para um valor na camada de dados da página de exemplo: digitalData.page.pageInfo.pageName

  6. Marque as caixas Forçar valor minúsculo e Texto limpo para padronizar o caso e remover espaços irrelevantes

  7. Deixe Nenhum como a configuração da Duração do armazenamento, pois esse valor normalmente será diferente em cada página

  8. Clique no botão Salvar para salvar o elemento de dados

    Criar o elemento de dados Nome da página.

OBSERVAÇÃO

Os recursos do elemento de dados podem ser ampliados com extensões. Por exemplo, a extensão ContextHub permite adicionar elementos de dados usando recursos da extensão.

Criar uma regra

Em seguida, você usará esse elemento de dados em uma regra simples. As regras são um dos recursos mais avançados nas tags e permitem que você especifique o que deve ocorrer quando o visitante interagir com o site. Quando os critérios definidos nas regras são cumpridos, a regra aciona a ação especificada.

Você criará uma regra que transmita o valor do elemento de dados Nome da página para o console do navegador.

Para criar uma regra

  1. Na navegação à esquerda, clique em Regras

  2. Como você ainda não criou regras nessa propriedade, um breve vídeo é exibido com informações adicionais sobre este tópico. Assista a este vídeo se desejar

  3. Clique no botão Criar nova regra:

    Clique no botão Criar nova regra

  4. Atribua um nome à regra All Pages - Library Loaded. Essa convenção de nomenclatura indica onde e quando a regra será acionada, facilitando a identificação e reutilização da propriedade da tag.

  5. Em Eventos, clique em Adicionar. O Evento informa as tags quando a regra deve ser acionada e as causas podem ser muitas, incluindo um carregamento de página, um clique, um evento JavaScript personalizado etc.

    Nomear a regra e adicionar um evento

    1. Como Tipo de evento, selecione Biblioteca carregada (Parte superior da página). Observe que ao selecionar Tipo de evento, as tags preenchem um nome para o evento usando sua seleção. Observe também que a ordem padrão do evento é 50. A ordenação é um recurso poderoso nas tags, que oferece controle preciso sobre a sequência de ações quando você tem várias regras acionadas pelo mesmo evento. Você usará esse recurso posteriormente no tutorial.

    2. Clique no botão Manter alterações

    Selecionar um evento

  6. Como essa regra deve ser acionada em todas as páginas, deixe Condições em branco. Se você abrir a modal Condições, verá que as condições podem adicionar restrições e exclusões com base em uma grande variedade de opções, incluindo URLs, valores de elemento de dados, intervalos de datas e muito mais.

  7. Em Ações, clique em Adicionar

  8. Selecione Tipo de ação > Código personalizado, que neste momento é a única opção. Posteriormente no tutorial, à medida que você adiciona extensões, mais opções serão disponibilizadas.

  9. Selecione </> Abrir editor para abrir o editor de código

    Selecionar uma ação

  10. Adicione o seguinte ao editor de código. Esse código exibirá o valor do elemento de dados Nome da página no console do navegador para que você possa confirmar se está funcionando:

    console.log('The page name is '+_satellite.getVar('Page Name'));
    
  11. Salve o editor de código

    Inserir código personalizado

  12. Na tela Configuração de ação, clique em Manter alterações

  13. Clique em Salvar para salvar a regra

Na página Regras , você deve ver sua nova regra:
A regra aparece na página

Salvar as alterações em uma biblioteca

Após configurar uma coleção de extensões, elementos de dados e regras na interface da Coleta de dados, é necessário disponibilizar esses recursos e lógicas em um conjunto de códigos JavaScript que você possa implantar em seu site para que as tags de marketing sejam acionadas quando os visitantes chegarem ao site. Uma biblioteca é o conjunto de códigos JavaScript que faz essa função.

Em uma aula anterior, você implementou o código incorporado de seu ambiente de desenvolvimento na página de exemplo. Quando você carregava a página de exemplo, um erro 404 era retornado para o URL do código incorporado porque uma biblioteca de tags ainda não tinha sido criada e atribuída ao ambiente. Agora, você colocará o novo elemento de dados e nova regra em uma biblioteca para que sua página de exemplo possa fazer algo.

Para adicionar e criar uma biblioteca

  1. Na navegação à esquerda, clique em Fluxo de publicação

  2. Clique em Adicionar nova biblioteca

    Adicionar nova biblioteca

  3. Nomeie a Biblioteca, por exemplo Initial Setup

  4. Selecione Ambiente > Desenvolvimento

  5. Clique em Adicionar todos os recursos alterados

    Adicionar todos os recursos alterados

  6. Observe que depois de clicar nas tags Adicionar todos os recursos alterados , elas resume as alterações que você acabou de fazer.

  7. Clique em Salvar e criar para desenvolvimento

    Salvar e criar para desenvolvimento

Após alguns minutos, o status fica verde, indicando que a biblioteca foi criada com êxito.

Biblioteca criada

Validar seu trabalho

Agora, valide se sua regra está funcionando como esperado.

Recarregue sua página de exemplo. Se você observar a guia Ferramentas do desenvolvedor -> Rede, verá agora uma resposta 200 para sua Biblioteca de tags!

Carregamento da biblioteca com resposta 200

Se você observar a guia Ferramentas do desenvolvedor -> Console, verá o texto "O nome da página é inicial"

Mensagem do console

Parabéns, você criou seu primeiro elemento de dados e regra e criou sua primeira biblioteca de tags!

Usar o recurso Biblioteca de trabalho

Quando você faz muitas alterações nas tags, é inconveniente ir até a guia Publicação , adicionar alterações e criar a biblioteca toda vez que quiser ver o resultado. Depois de criar a biblioteca "Configuração inicial", você pode usar um recurso chamado "Biblioteca de trabalho" para salvar rapidamente as alterações e reconstruir a biblioteca em uma única etapa.

Faça uma pequena alteração na regra "Todas as páginas - Biblioteca carregada". Na navegação à esquerda, clique em Rules e clique na regra All Pages - Library Loaded para abri-la.

Reabrir a regra

Na página Edit Rule, clique na lista suspensa Biblioteca de trabalho e selecione sua biblioteca Initial Setup.

Selecione Configuração inicial como a biblioteca de trabalho

Após selecionar a biblioteca, você deve ver que o botão Salvar agora assume o padrão Salvar na biblioteca. Ao fazer uma alteração nas tags, você pode usar essa opção para adicionar automaticamente a alteração diretamente à sua biblioteca de trabalho e/ou recriá-la.

Experiente. Abra a ação Código personalizado e adicione um sinal de dois pontos depois do texto "O nome da página é" para que o bloco inteiro de código diga:

console.log('The page name is: '+_satellite.getVar('Page Name'));

Salve o código, mantenha as alterações na ação e clique no botão Salvar na biblioteca e Criar.

A opção Salvar e criar agora existe

Aguarde até que o ponto verde reapareça ao lado da lista suspensa Biblioteca de trabalho. Agora, recarregue a página de amostra e você deverá ver sua alteração refletida na mensagem do console (talvez seja necessário limpar o cache do navegador e recarregar para ver a alteração na página):

Mensagem de console com dois pontos

Essa é uma maneira muito mais rápida de trabalhar e você usará essa abordagem no restante do tutorial.

Próximo "Alternar ambientes com o Experience Cloud Debugger" >

Nesta página