ID-Synchronisation nach URL oder Datenquelle

Letzte Aktualisierung: 17. Juli 2024

Themen:

Erstellt für:

Entwickler
Benutzende
Admin
Führungskraft

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
     dp     minutesToLive: 20160 // optional, defaults to 20160 minutes (14 days) });

Beispielausgabe

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

recommendation-more-help