Extensão Google Data Layer (Beta)

IMPORTANTE

Atualmente, essa extensão está em beta e não foi totalmente testada na produção.

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 do Auxiliar fornece funcionalidade semelhante orientada por eventos ao Adobe Client Data Dayer (ACDL). Os elementos de dados, as regras e as ações da extensão da Camada de dados da Google oferecem funcionalidade semelhante àquelas no Extensão ACDL.

Prazo

A versão 1.0.x da extensão é um beta. Esta extensão não foi totalmente testada na produção.

Instalação

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

Depois de instalada, a extensão cria ou acessa uma camada de dados sempre que a biblioteca de tags for carregada no site.

Exibição de extensão

Ao configurar a extensão (ao instalar a extensão ou ao selecionar Configurar no catálogo de extensões), você deve definir o nome da camada de dados consumida pela extensão. Se nenhuma camada de dados com o nome configurado estiver presente quando a biblioteca for carregada, a extensão criará uma.

OBSERVAÇÃO

Não importa se o código Google ou Adobe é carregado primeiro e cria a camada de dados. Ambos os sistemas criarão a camada de dados, se não estiver presente, ou usarão a camada de dados existente.

Por padrão, a camada de dados usa o nome padrão do Google dataLayer.

Eventos

A extensão permite acompanhar as alterações (eventos) na camada de dados. Um evento pode ser qualquer um dos seguintes:

  • Marcar eventos (como uma biblioteca que está sendo carregada)
  • Eventos JavaScript
  • Dados enviados para a camada de dados com a event palavra-chave.

É importante compreender o uso da variável event palavra-chave quando os dados são enviados para uma camada de dados do Google, de forma semelhante à Camada de dados do cliente do Adobe. O event A palavra-chave altera o comportamento da camada de dados do Google e, portanto, o comportamento da extensão é atualizado adequadamente.

As seções abaixo destacam os diferentes tipos de evento que a extensão pode acompanhar.

Analisar todos os envios para a camada de dados

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

Analisar os envios excluindo eventos

Se você selecionar essa opção, a extensão ouvirá qualquer coisa que está sendo enviada para a camada de dados, excluindo eventos.

O exemplo de evento 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"})

Analisar todos os eventos

Se você selecionar essa opção, a extensão 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"})

Acompanhamento de evento específico

Se desejar ouvir um evento específico, selecione essa opção para que o ouvinte do evento rastreie 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"})

Você também pode usar uma sequência de caracteres regex para corresponder aos nomes dos eventos. Por exemplo, definir myEvent\d rastrearia eventos começando com myEvent seguido de um dígito:

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

Ações

As seções abaixo destacam as diferentes ações que a extensão pode executar quando incluída em um regra.

Encaminhar para a camada de dados

Essa ação envia o conteúdo JSON para a própria camada de dados, possibilitando o uso de elementos de dados diretamente nas cargas JSON. No editor JSON fornecido, você pode fazer referência a elementos de dados usando notação de porcentagem (por exemplo, %dataElementName%).

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

Google DL Redefinir para Estado Calculado

OBSERVAÇÃO

Esta ação está disponível a partir da v1.0.5.

Essa ação redefine a camada de dados. Se usada em uma regra que processa uma alteração na 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 de camada de dados do Google, a ação esvaziará a camada de dados.

Elementos de dados

A extensão fornece um elemento de dados exclusivo que acessa a camada de dados usando uma chave (por exemplo, page.url no trecho acima).

O elemento de dados pode fornecer qualquer um dos seguintes itens:

  • Um valor específico da camada de dados (por exemplo, page.url)
  • Toda a matriz da camada de dados (campo de chave vazio)
  • Valores de um evento de camada de dados usando a chave (se a variável event palavra-chave foi usada)
  • O objeto de evento inteiro (campo de chave vazio)

A extensão sempre dá prioridade às informações do evento. Se uma camada de dados event estiver sendo processado, os valores sempre serão lidos a partir desse evento. Se uma event não estiver presente, os valores serão lidos a partir da camada de dados direta.

Informações adicionais

Informações adicionais estão disponíveis no LEITURA DO projeto e nas caixas de diálogo do evento e do elemento de dados da extensão.

Nesta página