Documentation Guide du service d’identités

Synchronisation des ID par URL ou source de données id-synchronization-by-url-or-data-source

Last update: Wed Jul 17 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

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 section-90ac61617482463aaf4c57009b830332

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 section-0115615c37584a19a2ab11e917c4e7e9

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

9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a