Show Menu
TOPICS×

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

As funções idSyncByURL e idSyncByDataSource do serviço de ID permitem que você implemente manualmente uma sincronização de ID no iFrame de publicação de destino. Elas estão disponíveis no VisitorAPI.js versão 1.10 ou posterior.

Sintaxe, propriedades e macros

Sintaxe
Código
Sincroniza as IDs do 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
A 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 o tempo de expiração do cookie. Deve ser um inteiro. O padrão é de 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