ID-Synchronisation nach URL oder Datenquelle

Mit den ID-Dienstfunktionen idSyncByURL und idSyncByDataSource können Sie eine ID-Synchronisation manuell im Destination Publishing iFrame implementieren. Diese sind in VisitorAPI.js Version 1.10 oder höher verfügbar.

Syntax, Eigenschaften und Makros

Syntax

Code Synchronisiert Benutzer-IDs

visitor.idSyncByURL();

Zwischen unterschiedlichen Datenpartnern und Audience Manager mithilfe einer benutzerdefinierten URL für die ID-Synchronisierung.

visitor.idSyncByDataSource();

Wenn Sie die DPID und DPUUID bereits kennen und sie im URL-Format für die ID-Standardsynchronisierung an Audience Manager senden möchten.

Eigenschaften

In der folgenden Tabelle werden die für beide Funktionen verfügbaren Eigenschaften aufgelistet und definiert.

Name Typ Beschreibung
dpid Zeichenfolge

Vom Audience Manager zugewiesene Datenanbieter-ID.

dpuuid Zeichenfolge

Die eindeutige ID des Datenanbieters für den Benutzer.

minutesToLive Zahl

(Optional) Legt die Ablaufzeit des Cookies fest. Muss eine Ganzzahl sein. Der Standardwert ist 20.160 Minuten (14 Tage).

url Zeichenfolge

Ziel-URL.

Makros

Beide Funktionen akzeptieren die folgenden Makros:

  • %TIMESTAMP%: Generiert einen Zeitstempel (in Millisekunden). Wird für das Cache-Busting verwendet.
  • %DID%: Fügt die Audience Manager-ID für den Benutzer ein.
  • %HTTP_PROTO%: Legt das Kommunikationsprotokoll fest (http oder https).

Beispielcode und -ausgabe

Beide Funktionen melden Successfully queued bei Erfolg. Falls nicht, wird eine Fehlermeldungszeichenfolge zurückgegeben.

visitor.idSyncByURL

Beispielcode

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

Beispielausgabe

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

Beispielcode

  //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
     dpuuid: '98765', // must be a string 
     minutesToLive: 20160 // optional, defaults to 20160 minutes (14 days) });

Beispielausgabe

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

Auf dieser Seite