Documentazione Guida del servizio Identity

Sincronizzazione ID tramite URL o sorgente dati id-synchronization-by-url-or-data-source

Last update: Wed May 24 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

Developer
User
Admin
Leader

Le funzioni idSyncByURL e idSyncByDataSource del servizio ID consentono di implementare manualmente una sincronizzazione ID nell’iFrame di pubblicazione della destinazione. Sono disponibili in VisitorAPI.js versione 1.10 o successiva.

Sintassi, proprietà e macro section-90ac61617482463aaf4c57009b830332

Sintassi

Codice

Sincronizza gli ID utente

visitor.idSyncByURL();

Tra partner dati diversi e Audience Manager utilizzando un URL personalizzato per la sincronizzazione degli ID.

visitor.idSyncByDataSource();

Se conosci già gli identificatori DPID e DPUUID e vuoi inviarli ad Audience Manager nel formato standard di URL per la sincronizzazione degli ID.

Proprietà

Nella tabella seguente sono elencate e definite le proprietà di entrambe le funzioni.

Nome

Tipo

Descrizione

dpid

Stringa

ID del fornitore dei dati assegnato da Audience Manager.

dpuuid

Stringa

ID univoco del fornitore di dati per l’utente.

minutesToLive

Numero

(Facoltativo) Imposta la data di scadenza del cookie. Deve essere un numero intero. Il valore predefinito è 20160 minuti (14 giorni).

url

Stringa

URL di destinazione.

Macro

Entrambe le funzioni accettano le seguenti macro:

%TIMESTAMP%: genera una marca temporale (in millisecondi). Utilizzato per svuotare la cache.
%DID%: inserisce l’ID di Audience Manager per l’utente.
%HTTP_PROTO%: imposta il protocollo di comunicazione (http o https).

Codice di esempio e output section-0115615c37584a19a2ab11e917c4e7e9

Entrambe le funzioni restituiscono Successfully queued in caso di esito positivo. In caso di esito negativo, restituiscono una stringa con un messaggio di errore.

visitor.idSyncByURL

Codice campione

   //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) });

Output campione

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

Codice campione

  //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) });

Output campione

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

recommendation-more-help

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