Macros de destino definidas

Última atualização em 2023-05-20

Descreve as macros que podem ser adicionadas a um destino URL.

Ao criar uma URL destino, você pode inserir as seguintes macros no URL string. Verifique com seu parceiro de dados/destino se a macro está posicionada corretamente no destino URL.

OBSERVAÇÃO

As macros são opcionais, a menos que indicado de outra forma. Itálico indica um marcador de posição variável.

Macro Explicação

%alias%

Obrigatório.

Define o local do valor de segmento mapeado em um URL de destino. Normalmente, esta é a ID do segmento, mas também pode ser o código de integração.

%did%

Insere o nome do usuário Audience Manager ID no URL de destino.

%dpid_data source id%

A variável id da fonte de dados corresponde ao identificador de uma fonte de dados transmitido para a macro.

Vejamos como isso funciona em um exemplo simples. Nesse caso, temos uma Audience Manager Faça parceria com as seguintes IDs e condições:

  • ID da fonte de dados: 1
  • Uma ID interna do cliente: CustomerABC
  • ID declarada: o parceiro deseja passar nesses valores como a ID declarada 1:CustomerABC.

Para fazer isso com o %dpid_data source id%, o Audience Manager o parceiro formataria a macro da seguinte maneira:

  • %dpid_1%

A macro substituirá 1 com CustomerABC.

${GDPR}

Indica se as regulamentações do GDPR se aplicam ao visitante ou não. Use essa macro para incluir consentimento nos segmentos enviados para destinos de URL integrados ao IAB. Consulte Plug-in do Audience Manager para a TCF do IAB para obter detalhes.

${GDPR_CONSENT_XXXX}

A cadeia de consentimento (incluindo a ID do fornecedor do IAB) coletada quando os visitantes fornecem ou negam consentimento em seu site. Use essa macro para incluir a string de consentimento nos segmentos enviados para destinos de URL integrados ao IAB. Substituir XXXX com a ID do parceiro de destino. Consulte Plug-in do Audience Manager para a TCF do IAB para obter detalhes.

%http_proto%

Detecta o protocolo usado na página da Web pai e o insere no URL de destino. Por exemplo:

  • se a página da web for https://aam_client.com, essa macro será substituída por https://url-destination.com
  • se a página da web for http://aam_client.com, essa macro será substituída por http://url-destination.com

%mcid%

Insere o Experience Cloud ID no URL de destino.

%region%

Insere o Servidor de coleta de dados (DCS) no URL de destino. Para minimizar a latência, quando o visitante faz uma chamada HTTP para Audience Manager, elas estão sendo redirecionadas para o estado mais próximo DCS data center. Isso é feito por meio do DNS, que é capaz de detectar a localização do visitante e direcioná-lo para o data center apropriado.

%rnd%

Executa uma função de eliminação de cache inserindo um número aleatório no URL de destino. Isso impede que os navegadores forneçam conteúdo em cache.

%timestamp%

Insere um carimbo de data e hora UNIX no URL de destino para impedir que os navegadores forneçam conteúdo em cache.

Busting de Cache com Macros de Destino

A variável %rnd% e %timestamp% macros inserem valores únicos em um URL string para impedir o armazenamento em cache do navegador.

Busting de Cache com %rnd% e %timestamp%

Os navegadores armazenam em cache (salvam) o conteúdo solicitado com frequência na memória. Quando uma página é carregada, o conteúdo salvo serve do cache em vez de um servidor remoto. Esse processo ajuda a manter tempos de download eficientes, pois os dados são enviados localmente, e não de outro local. No entanto, como o armazenamento em cache não requer uma chamada de servidor, pode distorcer os relatórios reduzindo artificialmente o número de solicitações exclusivas.

O impedimento de cache impede que os navegadores salvem e reutilizem conteúdo. Essa técnica usa código que insere um número aleatório ou carimbo de data e hora em uma cadeia de caracteres de URL, o que a torna exclusiva ao navegador. Como resultado, cada HTTP A chamada de é contada como uma solicitação separada para o servidor. Forçar uma nova chamada de servidor para cada solicitação ajuda a manter a precisão dos relatórios e a reduzir as discrepâncias. Audience Manager O fornece duas macros para eliminação de cache:

  • %rnd%: insere um número aleatório em um URL.
  • %timestamp%: insere a data/hora do Unix em um URL.

Comparação %rnd% e %timestamp%

Ambas as macros impedem o armazenamento em cache, mas %rnd% pode ser mais eficiente. Por exemplo, com %timestamp%, se vários usuários visualizarem uma página simultaneamente, obterão o mesmo valor de data/hora. Como resultado, a URL não é exclusiva e várias chamadas são contadas apenas uma vez. No entanto, %rnd% O gera um valor numérico exclusivo para cada chamada (mesmo quando os usuários veem a mesma página simultaneamente). Isso significa que o URL a sequência de caracteres contém valores diferentes e é contada como única.

Nesta página