Documentação Guia do Serviço de identidade

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

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:

Criado para:

Desenvolvedor
Usuário
Administrador
Líder

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 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

9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a