Documentation Guide du service d’identités

Synchronisation des ID par URL ou source de données

Dernière mise à jour : 17 juillet 2024

Rubriques :

Créé pour :

Développeur
Utilisateur ou utilisatrice
Administration
Leader

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

recommendation-more-help