Sincronização de ID por URL ou fonte de dados

As funções idSyncByURL e idSyncByDataSource do serviço de ID permitem implementar manualmente uma sincronização de ID no iFrame de publicação de destino. Eles estão disponíveis na VisitorAPI.js versão 1.10 ou superior.

Sintaxe, propriedades e macros

Sintaxe

Código Sincroniza IDs de usuário

visitor.idSyncByURL();

Entre os diferentes parceiros de dados e o Audience Manager ao usar o URL de sincronização de ID personalizado.

visitor.idSyncByDataSource();

Quando você já conhece o DPID e DPUUID e deseja enviá-los para o Audience Manager no formato de URL de sincronização de ID padrão.

Propriedades

A tabela a seguir lista e define as propriedades disponíveis para ambas as funções.

Nome Tipo Descrição
dpid String

ID do provedor de dados atribuída pelo Audience Manager.

dpuuid String

O identificador exclusivo do provedor de dados para o usuário.

minutesToLive Número

(Opcional) Define a hora de expiração do cookie. Deve ser um número inteiro. O padrão é 20160 minutos (14 dias).

url String

URL de destino.

Macros

Ambas as funções aceitam as seguintes macros:

  • %TIMESTAMP%: gera um carimbo de data e hora (em milissegundos). Usado para eliminação de cache.
  • %DID%: insere a ID do Audience Manager para o usuário.
  • %HTTP_PROTO%: define o protocolo de comunicação (http ou https).

Código e saída de exemplo

Ambas as funções retornam Successfully queued se bem-sucedidas. Do contrário, elas devolvem uma sequência de mensagem de erro.

visitor.idSyncByURL

Código de exemplo

   //Instatiate Visitor
    var visitor = Visitor.getInstance
    ("MARKETING-CLOUD-ORG-ID-HERE",{}); 
   // Fires url with macros replaced 
    visitor.idSyncByURL({ 
    dpid: '24', // must be a string 
    url: '//su.addthis.com/red/usync?pid=16&puid=%DID%&url=%HTTP_PROTO%://
    dpm.demdex.net/ibs:dpid=420&dpuuid={{uid}}', 
    minutesToLive: 20160 // optional, defaults to 20160 minutes (14 days) });

Saída de exemplo

http://su.addthis.com/red/usync?pid=16&puid=28777806459181003670799219185178493848&url=http%3A%2F%2Fdpm.demdex.net%2Fibs%3Adpid%3D420%26dpuuid%3D%7B%7Buid%7D%7D

visitor.idSyncByDataSource

Código de exemplo

  //Instantiate Visitor
   var visitor = Visitor.getInstance
   ("MARKETING-CLOUD-ORG-ID-HERE",{}); 
  // Fires 'http:/https:' + '//dpm.demdex.net/ibs:dpid=&dpuuid='
   visitor.idSyncByDataSource({ 
     dpid: '24', // must be a string
     dpuuid: '98765', // must be a string 
     minutesToLive: 20160 // optional, defaults to 20160 minutes (14 days) });

Saída de exemplo

http://dpm.demdex.net/ibs:dpid=24&dpuuid=98765

Nesta página

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now