Show Menu
TÓPICOS×

Macros de destino definidas

Descreve as macros que podem ser adicionadas a um destino URL.
Ao criar um URL destino, você pode inserir as seguintes macros na URL string. Verifique com seu parceiro de dados/destino se a macro está posicionada corretamente no destino URL.
As macros são opcionais, salvo indicação em contrário. Itálico indica um marcador de posição variável.
Macro Explicação
%alias%
Obrigatório.
Define o local do valor do segmento mapeado em um URL de destino. Geralmente, essa é a ID do segmento, mas também pode ser o código de integração.
%did%
Insere a ID do gerente de Audiência do usuário no URL de destino.
%dpid_ data source id %
A ID da fonte de dados corresponde ao identificador de uma fonte de dados transmitida para a macro.
Vejamos como isto funciona num exemplo simples. Nesse caso, temos um parceiro do Gerenciador de Audiências com as seguintes IDs e condições:
  • ID da fonte de dados: 1
  • Uma ID interna do cliente: CustomerABC
  • ID declarada: O parceiro deseja transmitir esses valores como a ID declarada 1:CustomerABC .
Para fazer isso com o %dpid_ data source id % , o parceiro do Gerenciador de Audiências formataria a macro da seguinte maneira:
  • %dpid_1%
A macro será substituída 1 por CustomerABC .
${GDPR}
Indica se os regulamentos RGPD se aplicam ao visitante ou não. Use essa macro para incluir o consentimento em segmentos enviados para destinos de URL integrados com o IAB. Consulte Plug-in Audiência Manager para IAB TCF para obter detalhes.
${GDPR_CONSENT_XXXX}
A sequência de caracteres de consentimento (incluindo a ID de fornecedor IAB) coletada quando os visitantes fornecem ou negam o consentimento em seu site. Use essa macro para incluir a sequência de caracteres de consentimento nos segmentos enviados para destinos de URL integrados com IAB. Substitua XXXX pela ID do parceiro de destino. Consulte Plug-in Audiência Manager para IAB TCF 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, esta macro será substituída por https ://url-destination.com
  • se a página da Web for http ://aam_client.com, esta macro será substituída por http ://url-destination.com
%mcid%
Insere a Experience Cloud ID no URL de destino.
%region%
Insere a região Data Collection Server (DCS) no URL de destino. Para minimizar a latência, quando o visitante faz uma chamada HTTP para o Gerenciador de Audiências, eles estão sendo redirecionados para o data center DCS mais próximo. Isso é feito por meio do DNS, que é capaz de detectar o local do visitante e direcioná-lo para o data center apropriado.
%rnd%
Executa uma função de cache busting inserindo um número aleatório no URL de destino. Isso impede que os navegadores disponibilizem conteúdo em cache.
%timestamp%
Insere um carimbo de data e hora UNIX no URL de destino para impedir que os navegadores disponibilizem conteúdo em cache.

Compuração de cache com macros de destino

As macros %rnd% e %timestamp% os inserem valores exclusivos em uma URL sequência de caracteres para impedir o armazenamento em cache do navegador.

Cache Busting com %rnd% e %timestamp%

O cache dos navegadores (salvar) solicitava com frequência o conteúdo na memória. Quando uma página é carregada, o conteúdo salvo serve do cache em vez de de um servidor remoto. Esse processo ajuda a manter tempos de download eficientes, pois os dados são fornecidos localmente, em vez de em outro local. No entanto, como o cache não requer uma chamada de servidor, ele pode distorcer o relatórios reduzindo artificialmente o número de solicitações exclusivas.
A eliminação de cache impede que os navegadores salvem e reutilizem conteúdo. Essa técnica usa um código que insere um número aleatório ou carimbo de data e hora em uma string de URL, o que faz com que pareça exclusivo para o navegador. Como resultado, cada HTTP chamada é 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 do relatórios e a reduzir as discrepâncias. Audience Manager fornece duas macros para o cache busting:
  • %rnd% : Insere um número aleatório em um URL.
  • %timestamp% : Insere a data/hora do Unix em um URL.

Comparar %rnd% e %timestamp%

Ambas as macros impedem o cache, mas %rnd% podem ser mais eficientes. Por exemplo, com %timestamp% , se vários usuários visualizações uma página simultaneamente, eles obterão o mesmo valor de data/hora. Como resultado, as chamadas não URL são exclusivas e várias são contadas apenas uma vez. No entanto, %rnd% gera um valor numérico exclusivo para cada chamada (mesmo quando os usuários veem a mesma página simultaneamente). Isso significa que a URL string contém valores diferentes e é contada como exclusiva.