Show Menu
SUJETS×

Guide de dépannage d’Identity Service

Ce document fournit des réponses aux questions fréquentes sur Adobe Experience Platform Identity Service, ainsi qu’un guide de dépannage pour les erreurs courantes. Pour toute question ou dépannage concernant les API de plateforme en général, consultez le guide de dépannage de l’API Adobe Experience Platform.
Les données qui identifient un client unique sont souvent fragmentées entre les divers périphériques et systèmes qu’ils utilisent pour interagir avec votre marque. Le service d’identité rassemble ces identités fragmentées, ce qui facilite une compréhension complète du comportement des clients afin que vous puissiez fournir des expériences numériques impactées en temps réel. Pour plus d'informations, consultez la présentation du service d'identité.

FAQ

Vous trouverez ci-dessous une liste de réponses aux questions fréquentes sur Identity Service.

Qu'est-ce que les données d'identité ?

Les données d’identité sont des données qui peuvent être utilisées pour identifier une personne. Selon le contexte d’utilisation des données au sein de votre organisation, les données d’identité peuvent inclure des noms d’utilisateur, des adresses électroniques et des identifiants provenant de systèmes de gestion de la relation client. Les données d’identité ne sont pas limitées aux utilisateurs enregistrés de votre site Web ou service, car les utilisateurs anonymes peuvent également être identifiés par leur appareil ou leur identifiant de cookie.

Quel est l'avantage de définir les champs de données comme des identités ?

L’étiquetage de certains champs de données en tant qu’identités dans vos données d’enregistrement et de série chronologique vous permet de mettre en correspondance les relations d’identité dans la structure naturelle de vos données et de concilier les données de duplicata entre les canaux. See the Identity Service overview for more information.

Quelles sont les identités connues et anonymes ?

Une identité ​connue désigne une valeur d'identité qui peut être utilisée seule ou avec d'autres informations pour identifier, contacter ou localiser une personne. Les adresses électroniques, les numéros de téléphone et les identifiants CRM sont des exemples d’identités connues.
Une identité ​anonyme fait référence à une valeur d'identité qui ne peut pas être utilisée seule ou avec d'autres informations pour identifier, contacter ou localiser une personne (par exemple un ID de cookie).

Qu'est-ce qu'un graphique d'identité privée ?

Un graphique d'identité privé est une carte privée des relations entre les identités recoupées et liées, visible uniquement pour votre entreprise.
Lorsque plusieurs identités sont incluses dans des données ingérées à partir d’un point de terminaison de diffusion en continu ou envoyées à un jeu de données activé pour Identity Service, elles sont liées dans le graphique d’identité privée. Identity Service utilise ce graphique pour rassembler les identités d'un consommateur ou d'une entité donné, ce qui permet l'assemblage d'identité et la fusion de profils.

Comment créer plusieurs champs d'identité dans un schéma XDM ?

Les schémas de modèle de données d’expérience (XDM) prennent en charge plusieurs champs d’identité. Tout champ de données de type string dans un schéma qui implémente le Profil individuel XDM ou la classe XDM ExperienceEvent peut être étiqueté comme champ d'identité. Une fois étiquetées, toutes les données contenues dans ces champs sont ajoutées à la carte d’identité du profil.
Pour savoir comment étiqueter un champ XDM en tant que champ d’identité à l’aide de l’interface utilisateur, consultez la section Création d’un schéma à l’aide de l’éditeur de Schéma Identité du didacticiel de l’éditeur de Schémas. Si vous utilisez l'API, reportez-vous à la section descripteur d'identité du didacticiel sur l'API de registre de Schéma.

Y a-t-il des contextes où certains champs ne doivent pas être étiquetés comme identités ?

Les champs d’identité doivent être réservés aux valeurs propres à chaque individu. Prenons l’exemple d’un jeu de données pour un programme de fidélité des clients. Le champ "niveau de fidélité" (or, argent, bronze) ne serait pas un champ d’identité utile, tandis que l’ID de fidélité, une valeur unique, le serait.
Les champs tels que les codes postaux et les adresses IP ne doivent pas être étiquetés comme des identités pour des individus, car ces valeurs peuvent s’appliquer à plusieurs personnes. Ces types de champs ne doivent être étiquetés que comme identités pour les stratégies marketing au niveau des ménages.

Pourquoi mes champs d'identité ne sont-ils pas liés comme je m'y attends ?

En utilisant le /cluster/members de l'API Identity Service, vous pouvez vue les identités associées pour un ou plusieurs champs d'identité. Si la réponse ne renvoie pas les identités liées attendues, veillez à fournir les informations d’identité appropriées dans vos données XDM. Pour plus d'informations, consultez la section relative à la fourniture de données XDM au service d'identité dans l'aperçu du service d'identité.

Qu'est-ce qu'un espace de nommage d'identité ?

Un espace de nommage d'identité fournit le contexte de la manière dont les champs d'identité se rapportent à l'identité d'un client. Par exemple, les champs d’identité sous l’espace de nommage "E-mail" doivent être conformes à un format d'un email standard (name @emailprovider.com), tandis que les champs utilisant l’espace de nommage "Téléphone" doivent être conformes à un numéro de téléphone standard (par exemple, 987-555-1234 en Amérique du Nord).
Les Espaces de nommage distinguent des valeurs d’identité similaires entre différents systèmes de gestion de la relation client. Prenons l’exemple d’un profil qui contient un identifiant de fidélité numérique associé à votre programme de récompenses de société. Un espace de nommage de "Fidélité" séparerait cette valeur d’un ID numérique similaire pour votre système de commerce électronique qui s’affiche également dans le même profil.
See the identity namespace overview for more information.

Comment associer une identité à un espace de nommage d'identité ?

Les champs d'identité doivent être associés à un espace de nommage d'identité existant lors de leur création. Tout nouvel espace de nommage doit être créé à l'aide de l'API avant de l'associer aux champs d'identité.
Pour obtenir des instructions détaillées sur la définition d'un espace de nommage lors de la création d'un descripteur d'identité à l'aide de l'API, reportez-vous à la section relative à la création d'un descripteur dans le guide du développeur du registre des Schémas. Pour marquer un champ de schéma comme une identité dans l’interface utilisateur, suivez les étapes du didacticiel de l’éditeur de Schémas.

Quels sont les espaces de nommage d’identité standard fournis par Experience Platform ?

Les espaces de nommage standard suivants peuvent être utilisés par toutes les organisations au sein de la plate-forme d’expérience :
Nom d’affichage
ID
Code
Description
CORE
0
CORE
nom hérité : "Adobe AudienceManager"
ECID
4
ECID
alias : "Adobe Marketing Cloud ID", "Adobe Experience Cloud ID", "Adobe Experience Platform ID"
Courriel
6
Courriel
E-mail (SHA256, avec un format réduit)
11
Emails
espace de nommage standard pour les messages électroniques préhachés. Les valeurs fournies dans cet espace de nommage sont converties en minuscules avant le hachage avec SHA-256.
Téléphone
7
Téléphone
Windows AID
8
WAID
AdCloud
411
AdCloud
alias : Ad Cloud
Adobe Target
9
TNTID
ID de Cible
Identifiant de publicité Google
20914
GAID
GAID
Apple IDFA
20915
IDFA
ID des annonceurs

Où puis-je trouver la liste des espaces de nommage d'identité disponibles pour mon organisation ?

A l’aide de l’API id-service-api.yaml Identity Service, vous pouvez liste tous les espaces de nommage d’identité disponibles pour votre organisation en envoyant une demande GET au /idnamespace/identities point de terminaison. Pour plus d'informations, consultez la section relative à la liste des espaces de nommage disponibles dans l'aperçu de l'API Identity Service.

Comment créer un espace de nommage personnalisé pour mon entreprise ?

A l’aide de l’API id-service-api.yaml Identity Service, vous pouvez créer un espace de nommage d’identité personnalisé pour votre organisation en envoyant une demande POST au /idnamespace/identities point de terminaison. Pour plus d'informations, consultez la section sur la création d'un espace de nommage personnalisé dans l'aperçu de l'API Identity Service.

Que sont les identités composites et les XID ?

Les identités sont référencées dans les appels d’API par leur identité composite ou XID. Une identité ​composite est une représentation d'une identité qui contient une valeur d'ID et un espace de nommage. Un XID est un identifiant de valeur unique qui représente le même concept qu’une identité composite (un identifiant et un espace de nommage) et qui est automatiquement affecté à de nouvelles identités lorsqu’il est conservé par Identity Service. Pour plus d'informations, consultez la présentation de l'API Identity Service.

Comment le service d'identité gère-t-il les informations d'identification personnelle ?

Identity Service crée un hachage cryptographique à sens unique et puissant des informations d’identification personnelle avant la persistance des valeurs. Les données d’identité des espaces de nommage "Téléphone" et "Adresse électronique" sont automatiquement hachées à l’aide de SHA-256, les valeurs "Courriel" étant automatiquement converties en minuscules avant le hachage.

Dois-je chiffrer toutes les informations d’identification personnelle avant de les envoyer à la plate-forme ?

Vous n’avez pas besoin de chiffrer manuellement les données d’identification personnelle avant de les importer dans Platform. En appliquant le libellé I1 d’utilisation des données à tous les champs de données applicables, Platform convertit automatiquement ces champs en valeurs d’ID hachées lors de l’assimilation.
Pour savoir comment appliquer et gérer des étiquettes d’utilisation des données, consultez le didacticiel sur les étiquettes d’utilisation des données.

Y a-t-il des considérations à prendre en compte lors du hachage des identités basées sur les informations d'identification personnelle ?

Si vous envoyez des valeurs d’identification personnelle hachées à Identity Service, vous devez utiliser la même méthode de chiffrement pour vos jeux de données. Ainsi, la même valeur d'identité entre les jeux de données génère les mêmes valeurs hachées et peut être correctement mise en correspondance et liée dans le graphique d'identité.

Résolution des problèmes

La section suivante fournit des suggestions de dépannage pour des codes d'erreur spécifiques et le comportement inattendu que vous pouvez rencontrer lors de l'utilisation de l'API Identity Service.

Messages d’erreur du service d’identité

Voici une liste de messages d'erreur que vous pouvez rencontrer lors de l'utilisation de l'API Identity Service.

Paramètre de requête requis manquant

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "Missing required query parameter - namespace"
}

Cette erreur s’affiche lorsqu’un paramètre de requête requis n’a pas été inclus dans le chemin d’accès à la requête. Le message detail d’erreur indique le nom du paramètre manquant. Les variantes de ce message d’erreur incluent :
  • Paramètre de requête requis manquant - nsId
  • Paramètre de requête requis manquant - id
  • Paramètre de requête requis manquant - xid ou (nsid, id)
  • Paramètre de requête requis manquant - targetNs
  • Paramètre de requête requis manquant - xids ou compositeXids
Vérifiez que vous incluez correctement le paramètre indiqué dans le chemin d’accès à la requête avant de réessayer.

L'horodatage doit être compris dans les 180 derniers jours

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "Timestamp should be within last 180 days"
}

Identity Service purge les données datant de plus de 180 jours. Ce message d’erreur s’affiche lorsque vous tentez d’accéder à des données antérieures à cette date.

Il existe une limite de 1 000 XID dans un seul appel.

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "There is a limit of 1000 XIDs in a single call"
}

Ce message d’erreur s’affiche lorsque vous tentez de récupérer des informations d’identité pour plus de XID autorisés dans un seul appel d’API. Réduisez le nombre de XID dans votre requête à un niveau inférieur à la limite affichée pour résoudre ce problème.

Il existe une limite de 1 000 Xids composite dans un seul appel.

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "There is a limit for 1000 compositeXids in a single call"
}

Ce message d’erreur s’affiche lorsque vous tentez de récupérer des informations d’identité pour plus d’identités #what-are-composite-identities-and-xids composites autorisées dans un seul appel d’API. Pour résoudre ce problème, réduisez le nombre d’identités composites dans votre requête jusqu’à ce qu’il soit inférieur à la limite affichée.

Le type de graphique spécifié n'est pas valide

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "The graph-type abc specified is invalid. Please provide a valid graph-type"
}

Ce message d’erreur s’affiche lorsqu’un paramètre de graph-type requête reçoit une valeur non valide dans le chemin d’accès à la requête. Consultez la section sur les graphiques Présentation du service Identity Service d'identité dans l'aperçu du service d'identité pour savoir quels types de graphiques sont pris en charge.

Le jeton de service n'a pas d'étendue valide

{
    "title": "UnauthorizedAccess",
    "status": 401,
    "detail": "Service token does not have valid scope. Either acp.core.identity or acp.foundation is required"
}

Ce message d'erreur s'affiche lorsque votre organisation IMS n'a pas reçu les autorisations appropriées pour Identity Service. Contactez votre administrateur système pour résoudre ce problème.

Le jeton de service de passerelle n'est pas valide

{
    "title": "UnauthorizedAccess",
    "status": 401,
    "detail": "Gateway service token is not valid"
}

Dans le cas de cette erreur, votre jeton d'accès n'est pas valide. Les Jetons d'accès expirent toutes les 24 heures et doivent être régénérés pour continuer à utiliser les API de plateforme. Consultez le didacticiel sur l’ authentification pour obtenir des instructions sur la génération de nouveaux jetons d'accès.

Jeton de service d'autorisation non valide

{
    "title": "UnauthorizedAccess",
    "status": 401,
    "detail": "Authorization service token is not valid"
}

Dans le cas de cette erreur, votre jeton d'accès n'est pas valide. Les Jetons d'accès expirent toutes les 24 heures et doivent être régénérés pour continuer à utiliser les API de plateforme. Consultez le didacticiel sur l’ authentification pour obtenir des instructions sur la génération de nouveaux jetons d'accès.

Le jeton utilisateur ne dispose pas d'un contexte de produit valide

{
    "title": "UnauthorizedAccess",
    "status": 401,
    "detail": "User token does not have valid product context"
}

Ce message d’erreur s’affiche lorsque votre jeton d'accès n’a pas été généré à partir d’une intégration de la plateforme d’expérience. Consultez le didacticiel sur l’ authentification pour obtenir des instructions sur la génération de nouveaux jetons d'accès pour une intégration à la plate-forme d’expérience.

Erreur interne lors de l’obtention du XID natif à partir de l’identité et du code d’espace de nommage

{
    "title": "UnauthorizedAccess",
    "status": 401,
    "detail": "Invalid IMS Token/IMS Org | Internal error - when tried to get native XID from identity and namespace code"
}

Lorsque Identity Service conserve une identité, l'ID de l'identité et l'ID d'espace de nommage associé se voient attribuer un identifiant unique appelé XID. Ce message s’affiche lorsqu’une erreur se produit lors du processus de recherche du XID pour une valeur et un espace de nommage d’ID donnés.

L'organisation IMS n'est pas configurée pour l'utilisation d'Identity Service

{
    "title": "AccountNotProvisioned",
    "status": 403,
    "detail": "The IMS Org. {IMS_ORG_NAME} is not provisioned for Identity Service usage"
}

Ce message d'erreur s'affiche lorsque votre organisation IMS n'a pas reçu les autorisations appropriées pour Identity Service. Contactez votre administrateur système pour résoudre ce problème.

Erreur du serveur interne

{
    "title": "InternalError",
    "status": 500,
    "detail": "Internal Server Error. There was a problem processing your request"
}

Cette erreur s’affiche lorsqu’une exception inattendue se produit lors de l’exécution d’un appel de service Plateforme. La meilleure pratique consiste à programme vos appels automatisés afin de relancer leurs requêtes quelques fois à un intervalle de temps donné lors de la réception de cette erreur. Si le problème persiste, contactez votre administrateur système.

Codes d'erreur d'importation par lot

Identity Service ingère les données d'identité des données d'enregistrement et de série chronologique qui sont téléchargées sur la plate-forme à l'aide de l'Ingestion par lots. Comme l'assimilation par lot est un processus asynchrone, vous devez vue les détails d'un lot à des erreurs de vue. Les erreurs s’accumulent au fur et à mesure que le lot avance jusqu’à ce que le lot soit terminé.
Voici une liste de messages d'erreur relatifs à Identity Service que vous pouvez rencontrer lors de l'utilisation de l'API d'administration des données.

schéma XDM inconnu

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "Unknown XDM schema"
}

Identity Service ne consomme que les identités des données d'enregistrement ou de série chronologique conformes aux classes Profil ou ExperienceEvent, respectivement. Toute tentative d'assimilation de données pour Identity Service qui n'adhère à aucune classe déclenchera cette erreur.

Il y avait 0 identité valide dans les 100 premières lignes du lot traité

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "There were 0 valid identities in the first 100 rows of the processed batch"
}

Cette erreur s’affiche lorsque les 100 premières lignes d’un lot ne présentent aucune identité. Cette erreur n'indique toutefois pas de façon concluante qu'aucune identité n'a été trouvée dans les enregistrements ultérieurs.

Les enregistrements ont été ignorés car ils n'avaient qu'une identité par enregistrement XDM.

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "Skipped {NUMBER_OF_RECORDS} records as they had only 1 identity per XDM record"
}

Identity Service ne lie les identités que lorsque des enregistrements uniques présentent plusieurs valeurs d'identité. Ce message d'erreur survient une fois pour chaque lot assimilé et affiche le nombre d'enregistrements dans lesquels une seule identité a été trouvée et n'a pas entraîné de modification du graphique d'identité.

Le code d'Espace de nommage n'est pas enregistré pour cette organisation IMS

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "Namespace Code {ERRONEOUS_CODE} is not registered for this IMS Org"
}

Cette erreur s'affiche lorsqu'un enregistrement assimilé présente une identité dont l'espace de nommage associé n'existe pas ou n'est pas accessible par votre organisation IMS.

Ignorer l'assimilation par lot en tant qu'organisation IMS n'est pas prévu pour le graphique d'identité privée

{
    "title": "AccountNotProvisioned",
    "status": 403,
    "detail": "Skipping batch ingestion as IMS Org is not provisioned for Private Identity Graph"
}

Lors de l’importation de données par lot, ce message d’erreur s’affiche lorsque votre organisation IMS n’a pas reçu les autorisations appropriées pour Identity Service. Contactez votre administrateur système pour résoudre ce problème.

Erreur interne

{
    "title": "InternalError",
    "status": 500,
    "detail": "Internal Error. There was a problem during the ingestion"
}

Cette erreur s'affiche lorsqu'une exception inattendue se produit lors de l'assimilation d'un lot. La meilleure pratique consiste à programme vos appels automatisés afin de relancer leurs requêtes quelques fois à un intervalle de temps donné lors de la réception de cette erreur. Si le problème persiste, contactez votre administrateur système.