Show Menu
TOPICS×

Intégration directe avec le service Experience Cloud Identity

Cette mise en œuvre permet aux clients d’utiliser le service d’ID sur des appareils qui ne peuvent pas accepter ou utiliser notre code JavaScript ou SDK. Cela inclut les appareils tels que les consoles de jeu, les téléviseurs intelligents ou d’autres appareils compatibles avec Internet. Reportez-vous à cette section pour la syntaxe, des exemples de code et des 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 (Supported Attributes for DCS API Calls).
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 requête pourrait ressembler à l’exemple ci-dessous. Les variables longues ont été raccourcies.

Exemple de réponse

Le service d’ID renvoie les données dans un objet JSON comme indiqué 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
Identifiant visiteur Experience Cloud. Voir Cookies et service Experience Cloud Identity .
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 de l’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 réparti géographiquement et équilibré en charge. L’ID identifie la zone géographique du centre de données traitant 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 restrictions de taille limitent le blob à 512 octets ou moins.
d_ver
Obligatoire. 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, indiqué en secondes. L’intervalle par défaut est de 604 800 secondes (7 jours).