Diagnostic

Voici le workflow recommandé pour vérifier l'état de vos importations d'événements et d'audiences, et identifier les problèmes liés à vos données.

  1. Émettez des requêtes pour envoyer des événements ou envoyer ou supprimer des membres d'audience.
  2. Capturez le request_id de chaque IngestEventsResponse, IngestAudienceMembersResponse ou RemoveAudienceMembersResponse.
  3. Envoyez une requête RetrieveRequestStatus pour chaque request_id.
  4. Examinez chaque RetrieveRequestStatusResponse pour vérifier que vos importations fonctionnent correctement et identifier les éventuels problèmes liés à vos données.
  5. Corrigez les problèmes de données.
  6. Revenez à l'étape 1 et répétez l'opération jusqu'à ce que vous ayez résolu tous les problèmes liés à vos importations.

Créer des requêtes

Un RetrieveRequestStatusRequest comporte un seul champ request_id. Envoyez une requête pour chaque ID de requête que vous avez capturé lors de l'envoi de requêtes d'ingestion.

Examiner les réponses

Le request_status_per_destination d'un RetrieveRequestStatusResponse contient une entrée distincte pour chaque destination de la demande d'ingestion correspondante.

Par exemple, si votre IngestAudienceMembersRequest contenait trois entrées dans la liste destinations pour envoyer des données à trois audiences différentes, la réponse d'état contiendrait trois entrées dans request_status_per_destination (une entrée par audience).

Vérifier l'état global des destinations

Pour commencer, vérifiez le champ request_status pour déterminer si l'API Data Manager a fini de traiter les données pour le destination de RequestStatusPerDestination. Voici les valeurs possibles de request_status :

  • PROCESSING : les données de la destination sont toujours en cours de traitement.
  • SUCCESS : le traitement de la demande pour la destination s'est terminé sans erreur.
  • FAILURE : Tous les enregistrements de la destination ont échoué en raison d'erreurs.
  • PARTIAL_SUCCESS : certains enregistrements de la destination ont été traités, mais d'autres ont échoué en raison d'erreurs.

Vérifier l'état d'un événement ou d'une audience par destination

Inspectez le champ d'état qui correspond au type de demande d'ingestion. Un seul des champs suivants est défini sur chaque RequestStatusPerDestination :

État de l'ingestion des événements

Le champ events_ingestion_status est renseigné si la requête était une IngestEventsRequest.

Vérifiez le record_count de IngestEventStatus pour confirmer que le nombre total d'enregistrements reçus correspond à vos attentes. Le record_count inclut les enregistrements ayant réussi et ceux ayant échoué.

État de l'ingestion des membres de l'audience

Le champ audience_members_ingestion_status est renseigné si la requête était une IngestAudienceMembersRequest. Voici le champ IngestAudienceMembersStatus à vérifier pour chaque type de données d'audience. Un seul de ces champs est défini.

user_data_ingestion_status

Vérifiez le record_count de IngestUserDataStatus pour confirmer que le nombre total d'enregistrements reçus correspond à vos attentes. record_count inclut les enregistrements ayant réussi et ceux ayant échoué.

Vérifiez le champ user_identifier_count pour confirmer que le nombre d'identifiants utilisateur reçus correspond à vos attentes.

Si la requête contenait un nombre suffisant d'enregistrements, upload_match_rate_range contient la plage de taux de correspondance pour les enregistrements de la requête.

mobile_data_ingestion_status

Vérifiez le record_count de IngestMobileDataStatus pour confirmer que le nombre total d'enregistrements reçus correspond à vos attentes. record_count inclut les enregistrements ayant réussi et ceux ayant échoué.

Vérifiez le mobile_id_count pour confirmer que le nombre d'ID mobiles reçus correspond à vos attentes.

pair_data_ingestion_status

Vérifiez le record_count de IngestPairDataStatus pour confirmer que le nombre total d'enregistrements reçus correspond à vos attentes. record_count inclut les enregistrements ayant réussi et ceux ayant échoué.

Vérifiez le pair_id_count pour confirmer que le nombre d'ID PAIR reçus correspond à vos attentes.

État de la suppression des membres de l'audience

Le champ audience_members_removal_status est renseigné si la requête était une RemoveAudienceMembersRequest. Voici le champ RemoveAudienceMembersStatus à vérifier pour chaque type de données d'audience. Un seul de ces champs est défini.

user_data_removal_status
État de la suppression des données utilisateur.
mobile_data_removal_status
État de la suppression des données mobiles.
pair_data_removal_status
État de la suppression des données PAIR.

Vérifiez la valeur record_count pour confirmer que le nombre total d'enregistrements reçus correspond à vos attentes. Le record_count inclut les enregistrements ayant réussi et ceux ayant échoué.

Vérifiez également les champs user_identifier_count, mobile_id_count ou pair_id_count pour confirmer le nombre total d'identifiants utilisateur, d'ID mobiles ou d'ID PAIR reçus.

Vérifier les avertissements et les erreurs

En plus des champs d'état pour la destination et le type de requête, RetrieveRequestStatusResponse contient une répartition des avertissements et des erreurs pour la requête.

  • Une erreur indique que l'API a complètement rejeté l'enregistrement.
  • Un avertissement indique que l'API n'a pas rejeté l'enregistrement, mais qu'elle a dû ignorer certaines de ses données.

Par exemple, si un Event contient des données UserIdentifier chiffrées et AdIdentifiers telles que gclid, et que les données UserIdentifier ne peuvent pas être déchiffrées, l'API Data Manager traite toujours l'enregistrement à l'aide de AdIdentifiers, mais renvoie l'avertissement PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR.

Toutefois, si Event ne contient pas AdIdentifiers et que les données UserIdentifier ne peuvent pas être déchiffrées, l'API Data Manager rejette l'intégralité de l'enregistrement et signale l'erreur PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR, car un Event valide doit contenir au moins l'un des éléments suivants : ad_identifiers ou user_data.

Voici les champs de réponse qui contiennent des informations sur les avertissements et les erreurs.

warning_info
Liste d'objets WarningCount. Chaque WarningCount contient un reason avec le type d'avertissement et un record_count indiquant le nombre d'enregistrements ayant généré des avertissements de ce type.
error_info
Liste d'objets ErrorCount. Chaque ErrorCount contient un reason avec le type d'erreur et un record_count indiquant le nombre d'enregistrements ayant échoué en raison de ce type d'erreur.