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
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
).Entrambe le funzioni restituiscono Successfully queued
in caso di esito positivo. In caso di esito negativo, restituiscono una stringa con un messaggio di errore.
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
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