Documentatie Handleiding voor Identity Service

ID-synchronisatie met URL of Data Source

Laatst bijgewerkt: 17 juli 2024

Onderwerpen:

Gemaakt voor:

Ontwikkelaar
Gebruiker
Beheerder
Leider

Met de ID-servicefuncties idSyncByURL en idSyncByDataSource kunt u handmatig een id-synchronisatie implementeren in de iFrame voor doelpublicatie. Deze zijn beschikbaar in VisitorAPI.js versies 1.10, of hoger.

Syntaxis, eigenschappen en macro's

Syntaxis

Code	Gebruikersnamen synchroniseren
bezoeker.idSyncByURL();	Tussen verschillende gegevenspartners en Audience Manager via een aangepaste id-sync-URL.
bezoeker.idSyncByDataSource();	Wanneer u de DPID en DPUUID al kent en deze naar Audience Manager wilt verzenden in de standaard-id-synchronisatie-URL-indeling.

Eigenschappen

In de volgende tabel worden de eigenschappen weergegeven en gedefinieerd die voor beide functies beschikbaar zijn.

Naam	Type	Beschrijving
dpid	String	ID gegevensaanbieder toegewezen door Audience Manager.
dpuuid	String	De unieke id van de gegevensaanbieder voor de gebruiker.
minutesToLive	Getal	(Facultatief) plaatst de koekjesvervaltijd. Moet een geheel getal zijn. De standaardwaarde is 20160 minuten (14 dagen).
url	String	Doel-URL.

Macro's

Beide functies accepteren de volgende macro's:

%TIMESTAMP%: genereert een tijdstempel (in milliseconden). Wordt gebruikt voor het busten van cache.
%DID%: voegt de Audience Manager-id voor de gebruiker in.
%HTTP_PROTO%: stelt het communicatieprotocol in (http of https).

Voorbeeldcode en uitvoer

Beide functies retourneren Successfully queued als dit gelukt is. Ze retourneren een foutbericht als dat niet het geval is.

visitor.idSyncByURL

Code van de Steekproef

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

Uitvoer van de Steekproef

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

Code van de Steekproef

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

Uitvoer van de Steekproef

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

recommendation-more-help