Elementos de dados

NOTE
O Adobe Experience Platform Launch foi reformulado como um conjunto de tecnologias de coleção de dados na Adobe Experience Platform. Como resultado, várias alterações de terminologia foram implementadas na documentação do produto. Consulte o seguinte documento para obter uma referência consolidada das alterações de terminologia.

Os elementos de dados são os blocos fundamentais do seu dicionário de dados (ou mapa de dados). Use elementos de dados para coletar, organizar e entregar dados em toda a tecnologia de marketing e anúncios.

Um único elemento de dados é uma variável cujo valor pode ser mapeado para consultar strings, URLs, valores de cookie, variáveis JavaScript e assim por diante. Você pode fazer referência a esse valor pelo nome da variável em toda a Adobe Experience Platform. Esta coleção de elementos de dados se torna o dicionário de dados definidos que você pode usar para criar suas regras (eventos, condições e ações). Esse dicionário de dados é compartilhado em todas as tags para uso com qualquer extensão adicionada à propriedade.

IMPORTANT
As alterações não entrarão em vigor até serem publicadas.

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 em vários lugares.

O conceito de elementos de dados reutilizáveis é muito eficaz, e você deve usá-lo como prática recomendada.

Por exemplo, se houver um modo específico pelo qual você faz referência a nomes de páginas ou IDs de produtos ou captura informações de parâmetros de string de consulta de um link de marketing de afiliado ou do AdWords e assim por diante, será possível criar um dicionário de dados (elementos de dados) obtendo informações da origem e usando esses dados em várias regras 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. As tags na Adobe Experience Platform permitem 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.

NOTE
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.

Os elementos de dados são preenchidos com dados quando usados em regras ou chamados manualmente em um script. 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.

Uso do elemento de dados

Nas regras

É possível usar elementos de dados na interface de edição de regras usando a caixa de pesquisa para localizar o nome do elemento de dados.

No script personalizado

Você pode usar elementos de dados em scripts personalizados usando a _satellite sintaxe de objeto:

_satellite.getVar('data element name');

Criar um elemento de dados create-a-data-element

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 (strings de consulta, URLs ou valores de cookie) para qualquer objeto contido no seu site.

  1. Em uma página Propriedade, abra a guia Elementos de dados e selecione Criar novo elemento de dados.

  2. Nomeie o elemento de dados.

  3. Selecione uma extensão e um tipo.

    Os tipos de elementos de dados disponíveis são determinados pela extensão. Para obter informações sobre os tipos disponíveis com a extensão de tag principal, consulte Tipos de elementos de dados.

  4. Forneça quaisquer informações solicitadas sobre o tipo escolhido nos campos fornecidos.

  5. (Opcional) Insira um valor padrão.

    Se você não selecionar essa opção, não haverá valor padrão. A maioria dos usuários deixa essa opção no estado padrão. Sistemas diferentes lidam com uma variável vazia de forma diferente. Algumas pessoas escolhem inserir algo como "nenhum" ou "n/a" para que possam criar consistência no relatórios quando o elemento de dados não retornar um valor.

  6. Selecione se deseja forçar um valor em minúsculas e se deseja remover quebras de linha e espaços.

  7. Selecione uma duração.

    As opções disponíveis são:

    • None

      • O valor não está armazenado.
    • Page view

      • O valor é mantido em uma variável JavaScript até que a página seja atualizada ou que uma nova página seja carregada.

      • Pode ser criada e definida nos scripts usando a sintaxe do objeto _satellite:

        _satellite.setVar('data_element_name')

    • Session

      • Os valores persistem no armazenamento de sessão do navegador até que a guia do navegador seja fechada.
      • Disponível durante toda a visita ao site.
    • Visitor

      • O valor é armazenado indefinidamente no armazenamento local do navegador.
  8. Selecione Salvar.

Ao criar ou editar elementos, você pode salvar e construir sua biblioteca ativa. Isso salva imediatamente sua alteração na biblioteca e executa uma build. O status da build será exibido. Também é possível criar uma nova biblioteca por meio do menu suspenso Biblioteca principal.

Tipos de elementos de dados types-of-data-elements

NOTE
Os tipos de elementos de dados são determinados pela extensão. Não há limite para os tipos que podem ser criados.

As seções a seguir descrevem os tipos de elementos de dados disponíveis no Extensão principal. Outras extensões usam outros tipos de elementos de dados.

Qualquer cookie de domínio disponível pode ser referenciado no campo de nome do cookie.

Exemplo:

cookieName

Custom code

JavaScript personalizado pode ser inserido na interface selecionando Abrir editor e inserindo o código na janela do editor.

É preciso haver uma instrução de retorno na janela do editor indicando que o valor deve ser definido como aquele valor do elemento de dados. Se uma declaração de retorno não for incluída, o elemento de dados será resolvido como undefined. O fallback será acionado para procurar um valor armazenado e, em seguida, um valor padrão se nenhum valor armazenado estiver presente.

Exemplo:

var pageType = $('div.page-wrapper').attr('class').split('')[1];
if (window.location.pathname == '/') {
  return 'homepage';
} else {
  return pageType;
}

O código personalizado pode aceitar o event objeto da regra de chamada como argumento. Isso permite que o código leia o valor desse local.

Exemplo:

// `event` is the default object provided by the rule
var eventType = event.$type;
return eventType; // if this data element is called from a "DOM Ready" event, then `core.dom-ready` is returned

Você pode usá-los nos scripts personalizados usando a _satellite sintaxe do objeto:

// event refers to the calling rule's event
var rule = _satellite.getVar('return event rule', event);

Ao usar porcentagem (%), você só precisa especificar o nome do elemento de dados. Você não precisa especificar event.

%data element name%

Atributo DOM

Todo valor de elemento pode ser recuperado, como uma tag div ou H1.

Exemplo:

Corrente do seletor de CSS:

id#dc logo img

Obtenha o valor de:

src

variável JavaScript

Todo objeto ou variável disponíveis do JavaScript pode ser referido usando o campo de caminho.

Se você quiser coletar variáveis do JavaScript ou propriedades de objeto na marcação e usá-las com qualquer uma das extensões ou regras, os elementos de dados poderão ser usados para capturar esses valores. Assim, você pode consultar o elemento de dados em suas regras. Além disso, se a fonte de dados mudar, será necessário alterar apenas sua referência à fonte (o elemento de dados) em um local.

Por exemplo, considere que a marcação contém uma variável de JavaScript chamada Page_Name, assim:

<script>
  //data layer
  var Page_Name = "Homepage"
</script>

Você deve fornecer o caminho dessa variável ao criar o elemento de dados.

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.pageNameou digitalData.pageName, etc.

Exemplo:

window.document.title

Armazenamento local

Forneça o nome do item de armazenamento local no campo Nome do item de armazenamento local.

O armazenamento local fornece aos navegadores uma maneira de armazenar informações de página a página (https://www.w3schools.com/html/html5_webstorage.asp). O armazenamento local funciona de forma bem semelhante aos cookies, mas é muito maior e mais flexível.

Use o campo fornecido para especificar o valor criado para um item de armazenamento local, como lastProductViewed.

Informações da página

Use esses pontos de dados para coletar informações de página para uso na lógica da regra ou para enviar informações para o Analytics ou sistemas de rastreamento externos.

Você pode selecionar um dos atributos de página a seguir para ser usado em seu elemento de dados:

  • URL
  • Hostname
  • Pathname
  • Protocolo
  • Referenciador
  • Title

Query string Parameter

Especifique um único parâmetro de URL no campo Parâmetro de URL.

Somente a seção de nome é necessária e qualquer designador especial como “?” ou "=" deve ser omitido.

Exemplo:

contentType

Número aleatório

Use esse elemento de dados para gerar um número aleatório. É usado frequentemente para amostra de dados ou para a criação de IDs, como uma ID de ocorrência. O número aleatório também pode ser usado para ofuscar ou eliminar dados confidenciais. Alguns exemplos podem incluir:

  • Gerar uma ID de ocorrência
  • Concatene o número para um token de usuário ou carimbo de data e hora para garantir exclusividade
  • Executar um hash unidirecional em dados PII
  • Decida aleatoriamente quando mostrar uma solicitação de pesquisa no site

Especifique os valores mínimos e máximos para o número aleatório.

Padrões:

Mínimo: 0

Máximo: 1000000000

Armazenamento de sessão

Forneça o nome do item de armazenamento de sessão no campo Nome do item de armazenamento da sessão.

O armazenamento de sessão é semelhante ao armazenamento local, a diferença é que os dados são descartados depois que a sessão é encerrada, enquanto o armazenamento local ou um cookie pode reter os dados.

Visitor behavior

De forma semelhante às Informações da página, esse elemento de dados usa tipos de comportamento comuns para aprimorar a lógica nas regras ou nas soluções da Platform.

Selecione um dos seguintes atributos de comportamento do visitante:

  • Página de destino
  • Traffic source
  • Minutes on site
  • Session count
  • Session page view count
  • Lifetime page view count
  • Is new visitor

Alguns casos de uso comuns incluem:

  • Mostrar uma pesquisa depois que um visitante estiver no site por cinco minutos
  • Se esta for a página de destino da visita, preencha uma métrica Analytics
  • Mostrar uma nova oferta ao visitante depois do número X de Contagens de sessão
  • Exibir um cadastro de informativo se for a primeira visita

Elementos de dados incorporados

Você deverá criar elementos de dados personalizados adicionais se tiver usado anteriormente qualquer um dos seguintes elementos de dados:

  • URI
  • Protocolo
  • Hostname
recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743