Show Menu
TÓPICOS×

Data elements

Os elementos de dados são os blocos de construção das regras. Os elementos de dados permitem criar um dicionário de dados (ou mapa de dados) dos itens usados comumente em uma página, independentemente da sua origem (sequências de consulta, URLs ou valores de cookie) para qualquer objeto contido no seu site. Os elementos de dados são usados para construir uma camada de dados que pode ser usada pelo Analytics e outras ferramentas de coleção de dados.
Rules > Data Elements > Edit
Use elementos de dados o mais amplamente possível em todo o processo de criação de regras, para consolidar a definição de dados dinâmicos e aumentar a eficiência do seu processo de marcação. Você os define uma vez e usa muitas vezes.
O conceito de elementos de dados reutilizáveis é muito eficaz, e você deve usá-lo como prática recomendada.
Por exemplo, se houver uma maneira específica de referenciar nomes de páginas ou IDs de produto, ou pegar informações de parâmetros da sequência de consulta de um link de marketing afiliado ou de adwords, e assim por diante, você pode criar um dicionário de dados (elementos de dados) obtendo informações de várias fontes e usando esses dados em várias regras do Gerenciamento dinâmico de tags.
Usando o nome de página como exemplo, suponhamos que você use um esquema de nome de página específico referenciando uma camada de dados, elemento document.title , ou uma tag de título dentro do site. No Gerenciamento dinâmico de tags, é possível criar um elemento de dados como um ponto de referência único para aquele ponto de dados específico. Pode-se, então, usar esse elemento de dados em qualquer regra que precise referenciar o nome da página. Se futuramente, por algum motivo, você decidir mudar o modo como referencia o nome da página (por exemplo, se estiver referenciando document.title e, a partir de determinado momento quiser referenciar uma camada de dados específica), não precisará editar muitas e diferentes regras para alterar essa referência. Bastará alterá-la uma vez no elemento de dados, e todas as regras que referenciarem esse elemento serão automaticamente atualizadas.
Os elementos de dados são preenchidos com dados quando usados em regras ou chamados manualmente nos scripts. Em um alto nível, você:
  1. Crie um elemento de dados , se ainda não o fez.
  2. Use the data element in a rule or a custom script.

Types of data elements

A tabela a seguir descreve os tipos de elementos de dados.
Tipo
Descrição
Exemplo
Objeto do JavaScript
Todo objeto ou variável disponíveis do JavaScript podem ser referenciados usando o campo campo de caminho.
window.document.title
Seletor de CSS
Todo valor de elemento pode ser recuperado, como uma tag div ou H1.
Corrente do seletor de CSS: id#dc logo img Obtenha o valor de: src
Cookie
Todo cookie de domínio disponível pode ser referenciado no campo cookie campo de nome.
cookieName
Parâmetro de URL
Especifique um único parâmetro de URL no campo URL Parameter . Somente a seção do nome é necessária e qualquer designador especial como "?" ou "=" deve ser omitido
contentType

No script personalizado

Custom JavaScript can be entered into the UI by clicking Open Editor and inserting code into the editor window. É preciso haver uma instrução de retorno na janela do editor indicando que o valor deve ser definido como aquele do elemento de dados.
Se não houver, será retornado o valor padrão ou uma sequência vazia como valor do elemento de dados.
var pageType = $('div.page-wrapper').attr('class').split(' 
    ')[1]; 
    if  
    (window.location.pathname == '/'){return 'homepage';    
    }     
    else  
    {  
return pageType; 
    }|

Persistência

Atributo
Descrição
Exibição da página
Disponível somente enquanto a página persistir.
Pode ser criada e definida em scripts usando _satellite sintaxe de objeto: _satellite.setVar('data_element_name')
Sessão
Define um cookie de nível de sessão no navegador.
Disponível durante toda a visita do site.
Visitante
Define um cookie de 2 anos.
Manipulação de cookie
Pode ser manipulado usando os métodos de cookie _satellite:
_satellite.setCookie(name,value,days);
_satellite.readCookie(name);
_satellite.removeCookie(name);

Built-in data elements

Atributo
Descrição
URI
Used in rule: URI
Returns document.location.pathname + document.location.search
Protocolo
Used in rule: protocol
Returns document.location.protocol
Nome de host
Used in rule: hostname
Returns document.location.hostname

Data element usage

Em regras

Você pode usar os elementos de dados na interface de edição de regras usando a sintaxe do sinal de porcentagem (%). Digite um sinal de porcentagem no campo e um menu suspenso será exibido com os elementos de dados que você criou.

No script personalizado

You can use data elements in custom scripts by using the _satellite object.
_satellite.getVar('data element name');

Data element availability

Se um elemento de dados não estiver referenciado em uma regra, não será carregado na página até que seja chamado especificamente no script personalizado

Recuperação de elemento de dados por meio de identificadores personalizados

Os elementos de dados podem ser definidos na seção do código personalizado de um identificador de regra para garantir que o elemento de dados esteja disponível para a regra. Essa situação às vezes é necessária para considerações de tempo de execução específicos e problemas com o código de implementação existente.
Por exemplo, inserir o código a seguir obriga a recuperação do elemento de dados chamado sample data durante a etapa de identificação de regra, antes de qualquer manipulação de dados que ocorre no resto da regra.
The custom code section in the identifier must return true , regardless of whether a valid value is available for the data element. Otherwise, the rule never evaluates as true or runs.

How to collect values from JavaScript variables

Quando você tem variáveis javascript ou propriedades de objetos na marcação e deseja coletar esses valores no Gerenciamento dinâmico de tags para usar com as ferramentas de análise ou as ferramentas de teste, ou mesmo com tags de terceiros, uma maneira de capturar esses valores é usar os Elementos de dados no Gerenciamento dinâmico de tags. Dessa forma, você pode consultar o Elemento de dados em todas as regras e, se a fonte de dados mudar, basta alterar a referência à fonte (o Elemento de dados) em um local no Gerenciamento dinâmico de tags.
Por exemplo, considere que a marcação contém uma variável de JavaScript chamada "Page_Name":
<script> 
    //data layer 
    var Page_Name = "Homepage" 
  </script> 

Ao criar o Elemento de dados no Gerenciamento dinâmico de tags, forneça apenas o caminho para essa variável:
If you use a data collector object as party of your data layer, simply use dot notation in the Path to reference the object and property you want to capture into the Data Element, like _myData.pageName , or digitalData.pageName , etc.

Adobe training video: Data Elements


Ao final deste vídeo, você deverá ser capaz de:
  • Entender o que um elemento de dados é
  • Explicar os diferentes tipos de elemento
  • Criar um elemento de dados
  • Usar um elemento de dados em uma regra

Criar um elemento de dados

Crie um elemento de dados no Dynamic Tag Management.
  1. In the web property, click Rules > Data Elements .
  2. Clique em Create New Data Element .
  3. Preencha os campos e opções a seguir:
    • Name O nome fácil do elemento de dados que um profissional de marketing consegue reconhecer. Por exemplo, Product ID .
      O nome é referenciado pelo construtor de regras, e não uma ID. Se você mudar o nome do Elemento de dados, deverá mudar sua referência em todas as regras que o utilizarem.
    • Type Especifica de onde os dados são extraídos, como Objeto JS, Seletor de CSS, Cookie, Parâmetro de URL ou Script personalizado. Dependendo do tipo selecionado, serão exibidas diferentes opções. Consulte Tipos de elementos de dados para obter mais informações e exemplos.
    • Default Value Um elemento padrão. Esse valor garante que o elemento de dados sempre tenha um valor, mesmo que um parâmetro de URL não exista ou não possa ser encontrado pelo Dynamic Tag Management.
      Se não houver valor nem valor padrão, nada será retornado. Nenhuma variável que referencie esse elemento de dados será definida. Observe também que o campo de valor padrão será ignorado no caso de um elemento de dados de "código personalizado".
    • Force lowercase value O gerenciamento dinâmico de tags coloca automaticamente o valor em minúsculas.
    • Remember this value for Por quanto tempo você deseja que o gerenciamento dinâmico de tags lembre-se deste valor.
    • Force lowercase value O Dynamic Tag Management altera o valor automaticamente para letras minúsculas.
    • Remember this value for Por quanto tempo você deseja que o Dynamic Tag Management se lembre desse valor. Os valores válidos incluem:
    • Sessão: o cronograma baseado na sessão pode variar dependendo da implementação. Os elementos de dados da sessão são definidos para o cookie da sessão. Contudo, essa configuração pode basear-se em um servidor da Web ou no navegador. Ela não se relaciona com a sessão usada no Reports & Analytics de marketing.
    • Pageview
    • Visitante See Data Elements for more information about how to use data elements.
  4. Clique em Save Data Element .