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

A ID exclusiva 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