Intégration directe avec le service Experience Cloud Identity

Dernière mise à jour : 2023-05-24
  • Créé pour :
  • Developer
    User
    Admin
    Leader

Cette implémentation permet aux clients d’utiliser le service d’ID sur les périphériques qui ne peuvent pas accepter ou utiliser notre code JavaScript ou SDK. Cela inclut les périphériques tels que les consoles de jeux, les téléviseurs intelligents ou d’autres appareils compatibles avec Internet. Reportez-vous à cette section pour connaître la syntaxe, voir des exemples de code et les définitions.

Syntaxe

Les appareils qui ne peuvent pas utiliser les bibliothèques de code VisitorAPI.js ou du SDK peuvent appeler directement les serveurs de collecte de données (DCS) utilisés par le service d’ID. Pour ce faire, appelez dpm.demdex.net et formatez votre requête comme indiqué ci-dessous. Le format italique indique un espace réservé variable.

Dans cet exemple de syntaxe, le d_ préfixe identifie les paires clé-valeur de l’appel en tant que variable de niveau système. Vous pouvez transmettre plusieurs d_ paramètres au service d’ID, mais restez concentré sur les paires clé-valeur comme indiqué dans le code ci-dessus. Pour plus d’informations sur les autres variables, voir Attributs pris en charge pour les appels d’API DCS.

Le service d’ID prend en charge les appels HTTP et HTTPS. Utilisez HTTPS pour transmettre des données à partir d’une page sécurisée.

Exemple de requête

Votre demande peut ressembler à l’exemple ci-dessous. De longues variables ont été raccourcies.

Exemple de réponse

Le service d’ID renvoie des données dans un objet JSON, comme illustré ci-dessous. Votre réponse peut être différente.

{
     "d_mid":"12345",
     "dcs_region":"6",
     "id_sync_ttl":"604800",
     "d_blob":"wxyz5432"
}

Paramètres de requête et de réponse définis

Paramètres de requête

Paramètre Description

dpm.demdex.net

Domaine hérité contrôlé par Adobe. Voir Signification des appels vers le domaine Demdex (Understanding Calls to the Demdex Domain).

d_mid

ID de visiteur Experience Cloud. Voir Cookies et service d’identités Experience Cloud.

d_orgid

ID d’organisation Experience Cloud. Pour obtenir de l’aide sur la recherche de cet ID, voir Conditions requises pour le service Experience Cloud Identity.

d_cid

Paramètre facultatif qui transmet l’ID du fournisseur de données (DPID), l’ID d’utilisateur unique (DPUUID) et un ID d’état authentifié au service d’ID. Comme indiqué dans l’exemple de code, séparez le DPID et le DPUUID par le caractère de contrôle non imprimable %01.

DPID et DPUUID

Dans le paramètre d_cid, affectez chaque combinaison DPID et DPUUID associée au même paramètre d_cid. Vous pouvez ainsi renvoyer plusieurs jeux d’ID dans une même requête. En outre, séparez le DPID, le DPUUID et l’indicateur d’authentification facultatif par le caractère de contrôle non imprimable %01. Dans les exemples ci-dessous, les ID de fournisseur et d’utilisateur sont mis en évidence en gras dans la syntaxe.

  • Syntaxe : ...d_cid=DPID%01DPUUID%01état d’authentification...
  • Exemple : ...d_cid=123%01456%011...

État d’authentification

Il s’agit d’un ID facultatif dans le paramètre d_cid. Exprimé sous la forme d’un entier, il identifie les utilisateurs en fonction de leur état d’authentification comme indiqué ci-dessous :

  • 0 (Inconnu)
  • 1 (Authentifié)
  • 2 (Déconnecté)

Pour indiquer un état d’authentification, vous devez définir cet indicateur après la variable ID d’utilisateur (UUID). Séparez l’UUID et l’indicateur d’authentification par le caractère de contrôle non imprimable %01. Dans les exemples ci-dessous, les ID d’authentification sont mis en évidence en gras dans la syntaxe.

Syntaxe : ...d_cid=DPID%01DPUUID%01état d’authentification

Exemples :

  • Inconnu : ...d_cid=123%01456%010...
  • Authentifié : ...d_cid=123%01456%011...
  • Déconnecté : ...d_cid=123%01456%012...

dcs_region

Le service d’ID est un système géographiquement réparti et dont la charge est équilibrée. L’identifiant identifie la région du centre de données qui gère l’appel. Voir ID de zone géographique, emplacements et noms d’hôte du serveur de collecte de données (DCS Region IDs, Locations, and Host Names).

d_cb

(Facultatif) Paramètre de rappel permettant d’exécuter une fonction JavaScript dans le corps de la requête.

d_blob

Bloc chiffré de métadonnées JavaScript. Les contraintes de taille limitent l’objet blob à 512 octets ou moins.

d_ver

Obligatoire. Cette opération définit le numéro de version de l’API. Laissez ce paramètre défini sur d_ver=2.

Paramètres de réponse

Certains paramètres de réponse font partie de la requête et ont été définis dans la section ci-dessus.

Paramètre Description

id_sync_ttl

Intervalle de resynchronisation, défini en secondes. L’intervalle par défaut est de 604 800 secondes (7 jours).

Page précédente
Next page

Sur cette page