Extensão da camada de dados do Google

A extensão Camada de dados do Google permite usar uma camada de dados do Google na implementação de tags. A extensão pode ser usada de forma independente ou simultânea com as soluções da Google e com o código aberto da Google Biblioteca de ajuda da camada de dados.

A Biblioteca de ajuda fornece funcionalidade semelhante orientada por eventos para a Camada de dados de clientes Adobe (ACDL). Os elementos de dados, as regras e as ações da extensão da Camada de dados do Google fornecem funcionalidade semelhante àqueles na Extensão ACDL.

Instalação

Para instalar a extensão, navegue até o catálogo de extensões na interface da Coleção de dados e selecione Camada de dados Google.

Depois de instalada, a extensão cria ou acessa uma camada de dados em cada carregamento da biblioteca de tags do Adobe Experience Platform.

Exibição de extensão

A configuração de extensão pode ser usada para definir o nome da camada de dados que a extensão consome. Se nenhuma camada de dados com o nome configurado estiver presente quando as Tags do Adobe Experience Platform forem carregadas, a extensão criará uma.

O nome padrão da camada de dados é o nome padrão do Google dataLayer.

NOTE
Não importa se o código Google ou Adobe é carregado primeiro e cria a camada de dados. Ambos os sistemas se comportam da mesma forma: crie a camada de dados se ela não estiver presente ou use a camada de dados existente.

Eventos

NOTE
A palavra evento é sobrecarregado quando uma camada de dados orientada por eventos é usada em Tags do Adobe Experience Platform. Eventos pode ser:
  • Eventos de tags do Adobe Experience Platform (biblioteca carregada e assim por diante).
  • Eventos JavaScript.
  • Os dados enviados para a camada de dados com o evento palavra-chave.

A extensão oferece a possibilidade de acompanhar as alterações na camada de dados.

NOTE
É importante compreender a utilização do evento palavra-chave quando os dados são enviados para uma camada de dados do Google, de forma semelhante à Camada de dados do cliente Adobe. A variável evento Essa palavra-chave altera o comportamento da camada de dados do Google e, portanto, dessa extensão.
Leia a documentação do Google ou faça uma pesquisa se não tiver certeza sobre esse ponto.

Tipos de evento do Google

O Google oferece suporte a dois meios de enviar eventos: o Google Tag Manager, usando o push() e Google Analytics 4, utilizando o método gtag() método.

As versões de extensão da Camada de dados do Google anteriores à 1.2.1 eram compatíveis apenas com eventos criados pela push(), conforme mostrado nos exemplos de código desta página.

As versões 1.2.1 e posteriores são compatíveis com eventos criados com o gtag(). Isso é opcional e pode ser ativado na caixa de diálogo Configuração de extensão.

Para obter mais informações sobre push() e gtag() eventos, consulte a Documentação do Google. As informações também são fornecidas nas caixas de diálogo de configuração e regra da extensão.

Analise todos os envios para a camada de dados

Se você selecionar essa opção, seu ouvinte de eventos ouvirá qualquer alteração feita na camada de dados.

Analise os eventos de push, exceto

Se você selecionar essa opção, o ouvinte do evento ouvirá qualquer envio de dados para a camada de dados, excluindo eventos.

O exemplo de eventos de push a seguir seria rastreado pelo ouvinte:

dataLayer.push({"data":"something"})

O exemplo de eventos de push a seguir não seria rastreado pelo ouvinte:

dataLayer.push({"event":"myevent"})
dataLayer.push({"event":"myevent","data":"something"})

Ouvir todos os eventos

Se você selecionar essa opção, o ouvinte do evento ouvirá qualquer evento enviado para a camada de dados.

O exemplo de eventos de push a seguir seria rastreado pelo ouvinte:

dataLayer.push({"event":"myevent"})
dataLayer.push({"event":"myevent","data":"something"})

O exemplo de evento de push a seguir não seria rastreado pelo ouvinte:

dataLayer.push({"data":"something"})

Ouvir um evento específico

No caso de você especificar um evento, o ouvinte do evento rastreia todos os eventos que correspondem a uma string específica.

Por exemplo, definir myEvent ao usar essa configuração faz com que o ouvinte rastreie somente o seguinte evento de push:

dataLayer.push({"event":"myEvent"})

Um regex (ECMAScript / JavaScript) pode ser usado para corresponder nomes de eventos.

Por exemplo, definir 'myEvent\d' rastrearia myEvent com um dígito (\d):

dataLayer.push({"event":"myEvent1"})
dataLayer.push({"event":"myEvent2"})

Ações

Encaminhar para a camada de dados push-to-data-layer

A extensão fornece duas ações para enviar JSON para a camada de dados: um campo de texto livre para criar manualmente o JSON a ser enviado e, da versão 1.2.0, uma caixa de diálogo de vários campos com valores-chave.

JSON de texto livre

A ação de texto livre permite usar elementos de dados diretamente no JSON. No editor de JSON, os elementos de dados devem ser referenciados usando a notação de porcentagem. Por exemplo, %dataElementName%.

{
  "page": {
    "url": "%url%",
    "previous_url": "%previous_url%",
    "concatenated_values": "static string %dataElement%"
  }
}

Chave-Valor multicampo

A caixa de diálogo de vários campos de valor-chave mais recente é uma interface mais amigável que permite a configuração de um push sem gravar manualmente o JSON.

Google DL Redefinido para Estado Calculado

A extensão fornece uma ação para redefinir a camada de dados. Se usada em uma regra que processa uma alteração de camada de dados do Google, a camada de dados é redefinida para o estado calculado da camada de dados no momento em que a regra foi acionada. Se a ação for usada em uma regra que não processa uma alteração na camada de dados do Google, a ação esvazia a camada de dados.

Elementos de dados

O elemento de dados fornecido pode ser usado durante a execução de uma regra acionada por uma alteração na camada de dados do Google (evento de push) ou em uma regra não relacionada, como Biblioteca carregada. No primeiro caso, o elemento de dados retorna um valor obtido do estado calculado no momento da alteração da camada de dados. No último caso, o estado calculado no momento da execução da regra é usado.

Um switch de alternância permite selecionar se o elemento de dados deve retornar valores de todo o estado calculado ou somente de informações do evento (se usado em uma regra acionada por uma alteração de camada de dados).

O elemento de dados pode, portanto, retornar:

  • Campo vazio: estado calculado da camada de dados.
  • Campo com a chave (como page.previous_url no exemplo acima): valor da chave no objeto do evento ou estado calculado.

Informações adicionais

O elemento de dados da extensão e as caixas de diálogo do evento contêm informações de uso detalhadas e exemplos.

Informações gerais adicionais estão na LEIAME do projeto

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743