Extensão da camada de dados do Google

A extensão Camada de dados da Google permite usar uma camada de dados da 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 o Adobe Client Data Day (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.

Maturidade

A versão 1.2.x é um beta tardio que está em uso de produção.

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.

Eventos

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

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

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

Recursos do Business.Adobe.com