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
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
).Ambas as funções retornam Successfully queued
se bem-sucedidas. Do contrário, elas devolvem uma sequência de mensagem de erro.
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
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
dp minutesToLive: 20160 // optional, defaults to 20160 minutes (14 days) });
Saída de exemplo
http://dpm.demdex.net/ibs:dpid=24&dpuuid=98765