Show Menu
TÓPICOS×

Elementos de dados

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 (cadeias de caracteres de consulta, URLs ou valores de cookie) para qualquer objeto contido no seu site. Você usa elementos de dados para criar uma camada de dados que pode ser usada para o Analytics e outras ferramentas de coleta 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ê define as regras de dados uma vez e as usa várias 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 fazer referência a nomes de páginas ou IDs de produtos, ou de obter informações de parâmetros de sequência de query de um link de marketing afiliado ou do 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 único ponto de referência para esse ponto de dados específico. Pode-se, então, usar esse elemento de dados em qualquer regra que precise fazer referência ao nome da página. Se futuramente, por algum motivo, você decidir mudar o modo como faz referência ao nome da página (por exemplo, se estiver fazendo referência a document.title e, a partir de determinado momento quiser referir 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 fizeram referência a esse elemento serão automaticamente atualizadas.
Os elementos de dados são preenchidos com dados quando são usados em regras ou ao chamar manualmente os scripts. Em um alto nível, você:
  1. Crie um elemento de dados , se ainda não o fez.
  2. Use o elemento de dados em uma regra ou um script personalizado.

Tipos de elementos de dados

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

No script personalizado

O JavaScript personalizado pode ser inserido na interface do usuário clicando em Open Editor e inserindo o código na janela do editor. Uma instrução return é necessária na janela do editor para indicar qual valor deve ser definido como o valor do elemento de dados.
Se uma declaração de retorno não for incluída, o valor padrão ou uma string vazia será retornado como o 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 criado e definido nos scripts usando a _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 ao site.
Visitante
Define um cookie de 2 anos.
Manipulação de cookie
Pode ser manipulado usando métodos de cookie _satellite:
_satellite.setCookie(name,value,days);
_satellite.readCookie(name);
_satellite.removeCookie(name);

Elementos de dados incorporados

Atributo
Descrição
URI
Usado na regra: URI
Retorna documento.location.pathname + documento.location.search
Protocolo
Usado na regra: protocol
Retorna documento.location.protocol
Nome de host
Usado na regra: hostname
Retorna documento.location.hostname

Uso do elemento de dados

Nas regras

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

No script personalizado

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

Disponibilidade do elemento de dados

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

Forçar a recuperação de elementos de dados por meio de identificadores personalizados

Os elementos de dados podem ser definidos na seção de 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 e problemas específicos com o código de implementação existente.
Por exemplo, inserir o código a seguir força a recuperação do elemento de dados nomeado sample data durante a etapa de identificação da regra, antes de qualquer manipulação de dados que ocorra no restante da regra.
A seção do código personalizado no identificador deve retornar true , independentemente de um valor válido estar disponível para o elemento de dados. Caso contrário, a regra nunca é avaliada como true ou executada.

Como coletar valores de variáveis JavaScript

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 suas ferramentas de análise, 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, é possível consultar o Elemento de dados em todas as Regras e, se a fonte dos dados mudar, você só precisará alterar sua referência à fonte (o Elemento de dados) em um local no Gerenciamento dinâmico de tags.
Por exemplo, digamos que sua marcação contenha uma variável JavaScript chamada "Page_Name", desta forma:
<script> 
    //data layer 
    var Page_Name = "Homepage" 
  </script> 

Ao criar o Elemento de dados no Gerenciamento dinâmico de tags, forneça o caminho para essa variável da seguinte maneira:
Se você utilizar um objeto coletor de dados como parte da camada de dados, utilize a notação de pontos no Caminho para fazer referência ao objeto e propriedade que você deseja capturar no elemento de dados, como _myData.pageName , ou digitalData.pageName etc.

Vídeo de treinamento da Adobe: Elementos de dados


Até o final deste vídeo, você deverá ser capaz de:
  • Entenda o que é um elemento de dados
  • Explicar os diferentes tipos de elementos
  • 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. Na propriedade da Web, clique em 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, não por 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 Gerenciamento dinâmico de tags.
      Se não houver valor e nenhum 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 é ignorado se for um elemento de dados de "código personalizado".
    • Force lowercase value O gerenciamento dinâmico de tags torna o valor em minúsculas automaticamente.
    • Remember this value for Por quanto tempo você deseja que o gerenciamento dinâmico de tags lembre desse 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 Gerenciamento dinâmico de tags lembre desse valor.
    Os valores válidos incluem:
    • Sessão: A sincronização com base em sessão pode variar dependendo da implementação. Os elementos de dados da sessão são definidos para o cookie da sessão. No entanto, essa configuração pode se basear em um servidor da Web ou no navegador. Não está relacionado à sessão usada nos relatórios e análises de marketing.
    • Pageview.
    • Visitante
    Consulte Elementos de dados para obter mais informações sobre como usar elementos de dados.
  4. Clique em Save Data Element .