Documentação Guia de serviço de ID de visitante

Sincronização de ID por URL ou fonte de dados id-synchronization-by-url-or-data-source

Última atualização: 4 de dezembro de 2025

Criado para:

{"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"},{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"f8a45b24-4be7-4f1b-909b-60d06b483a20"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

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

Sintaxe, propriedades e macros section-90ac61617482463aaf4c57009b830332

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 section-0115615c37584a19a2ab11e917c4e7e9

Ambas as funções retornam Successfully queued se bem-sucedidas. Do contrário, elas devolvem uma string 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
     dp     minutesToLive: 20160 // optional, defaults to 20160 minutes (14 days) });

Saída de exemplo

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

recommendation-more-help

id-service-help