Synchronisation des ID par URL ou source de données

Les fonctions du service d’ID idSyncByURL et idSyncByDataSource vous permettent de mettre en œuvre manuellement une synchronisation des identifiants dans l’iFrame de publication de destination. Elles sont disponibles dans VisitorAPI.js 1.10 ou version ultérieure.

Syntaxe, propriétés et macros

Syntaxe

Code Synchronise les ID utilisateur

visitor.idSyncByURL();

Entre différents partenaires de données et Audience Manager en utilisant une URL de synchronisation d’identifiant personnalisé.

visitor.idSyncByDataSource();

Si vous connaissez déjà le DPID et DPUUID et si vous voulez l’envoyer à Audience Manager dans le format d’URL de synchronisation d’identifiant standard.

Propriétés

Le tableau suivant répertorie et définit les propriétés disponibles pour les deux fonctions.

Nom Type Description
Dpid Chaîne

ID de fournisseur de données attribué par Audience Manager.

dpuuid Chaîne

ID unique du fournisseur de données pour l’utilisateur.

minutesToLive Nombre

(Facultatif) Définit l’heure d’expiration du cookie. Doit être un nombre entier. La valeur par défaut est de 20160 minutes (14 jours).

url Chaîne

URL de destination.

Macros

Les deux fonctions acceptent les macros suivantes :

  • %TIMESTAMP% : génère un horodatage (en millisecondes). Utilisé pour la mise en cache.
  • %DID% : insère l’identifiant Audience Manager pour l’utilisateur.
  • %HTTP_PROTO% : définit le protocole de communication (http ou https).

Exemple de code et résultat

Les deux fonctions renvoient Successfully queued en cas de réussite. Autrement, elles renvoient une chaîne contenant un message d’erreur.

visitor.idSyncByURL

Exemple de code

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

Exemple de résultat

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

Exemple de code

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

Exemple de résultat

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

Sur cette page