Diagnose

Hier finden Sie den empfohlenen Workflow, um den Status Ihrer Ereignis- und Zielgruppen-Uploads zu prüfen und Probleme mit Ihren Daten zu ermitteln.

  1. Senden Sie Anfragen zum Senden von Ereignissen oder zum Hinzufügen oder Entfernen von Zielgruppenmitgliedern.

  2. Prüfen Sie den Gesamtstatus jeder Anfrage. Eine erfolgreiche Anfrage hat eine Status mit code gleich 0 (Enum-Wert OK, HTTP Antwort 200 OK) und gibt eine IngestEventsResponse, IngestAudienceMembersResponse oder RemoveAudienceMembersResponse zurück.

    Wenn eine Anfrage nicht erfolgreich ist, ändern Sie sie, um den Fehler zu beheben, und senden Sie die Anfrage noch einmal.

    Wenn eine Anfrage erfolgreich ist, erfassen Sie die request_id der Antwort, damit Sie sie im nächsten Schritt zum Abrufen von Diagnosedaten verwenden können.

  3. Senden Sie für jede erfolgreiche request_id eine RetrieveRequestStatus-Anfrage.

  4. Prüfen Sie jede RetrieveRequestStatusResponse, um zu bestätigen , dass Ihre Uploads ordnungsgemäß funktionieren, und um Probleme mit Ihren Daten zu ermitteln.

  5. Beheben Sie Datenprobleme.

  6. Kehren Sie zu Schritt 1 zurück und wiederholen Sie die Schritte, bis alle Probleme mit Ihren Uploads behoben sind.

Anfragen senden

Eine RetrieveRequestStatusRequest hat ein einzelnes request_id -Feld. Senden Sie eine Anfrage für jede erfolgreiche Anfrage-ID, die Sie beim Senden von Aufnahmeanfragen erfasst haben.

Sie können eine Anfrage in Ihrem Browser mit dem API Explorer testen.

Antworten überprüfen

Die request_status_per_destination in einer RetrieveRequestStatusResponse enthält einen separaten Eintrag für jedes Ziel in der entsprechenden Aufnahmeanfrage.

Wenn Ihre IngestAudienceMembersRequest drei Einträge in der Liste destinations enthielt, um Daten an drei verschiedene Zielgruppen zu senden, würde die Statusantwort drei Einträge in request_status_per_destination enthalten (einen Eintrag pro Zielgruppe).

Gesamtstatus des Ziels prüfen

Prüfen Sie zuerst das request_status Feld, um festzustellen, ob die Data Manager API die Daten für das destination der RequestStatusPerDestination verarbeitet hat. Folgende Werte sind für request_statusmöglich:

  • PROCESSING: Die Daten für das Ziel werden noch verarbeitet.
  • SUCCESS: Die Verarbeitung der Anfrage für das Ziel wurde ohne Fehler abgeschlossen.
  • FAILURE: Alle Datensätze für das Ziel sind aufgrund von Fehlern fehlgeschlagen.
  • PARTIAL_SUCCESS: Einige Datensätze für das Ziel waren erfolgreich, andere sind aufgrund von Fehlern fehlgeschlagen.

Ereignis- oder Zielgruppenstatus pro Ziel prüfen

Prüfen Sie das Statusfeld, das dem Typ der Aufnahmeanfrage entspricht. Für jede RequestStatusPerDestination wird nur eines der folgenden Felder festgelegt:

Status der Ereignisaufnahme

Das Feld events_ingestion_status wird ausgefüllt, wenn die Anfrage eine IngestEventsRequest war.

Prüfen Sie record_count der IngestEventStatus , um zu bestätigen, dass die Gesamtzahl der empfangenen Datensätze Ihren Erwartungen entspricht. record_count umfasst sowohl erfolgreiche als auch fehlgeschlagene Datensätze.

Status der Aufnahme von Zielgruppenmitgliedern

Das Feld audience_members_ingestion_status wird ausgefüllt, wenn die Anfrage eine IngestAudienceMembersRequest war. Hier ist das IngestAudienceMembersStatus Feld, das für jeden Typ von Zielgruppendaten geprüft werden muss. Nur eines dieser Felder ist festgelegt.

user_data_ingestion_status

Prüfen Sie record_count der IngestUserDataStatus, um zu bestätigen, dass die Gesamtzahl der empfangenen Datensätze Ihren Erwartungen entspricht. record_count umfasst sowohl erfolgreiche als auch fehlgeschlagene Datensätze.

Prüfen Sie user_identifier_count, um zu bestätigen, dass die Anzahl der Nutzerkennungen empfangenen Ihren Erwartungen entspricht.

Wenn die Anfrage eine ausreichende Anzahl von Datensätzen enthielt, enthält die upload_match_rate_range den Bereich der Übereinstimmungsrate range für Datensätze in der Anfrage.

mobile_data_ingestion_status

Prüfen Sie record_count der IngestMobileDataStatus, um zu bestätigen, dass die Gesamtzahl der empfangenen Datensätze Ihren Erwartungen entspricht. record_count umfasst sowohl erfolgreiche als auch fehlgeschlagene Datensätze.

Prüfen Sie mobile_id_count, um zu bestätigen, dass die Anzahl der empfangenen Mobilgeräte-IDs Ihren Erwartungen entspricht.

pair_data_ingestion_status

Prüfen Sie record_count der IngestPairDataStatus, um zu bestätigen, dass die Gesamtzahl der empfangenen Datensätze Ihren Erwartungen entspricht. record_count umfasst sowohl erfolgreiche als auch fehlgeschlagene Datensätze.

Prüfen Sie pair_id_count, um zu bestätigen, dass die Anzahl der empfangenen PAIR-IDs Ihren Erwartungen entspricht.

ppid_data_ingestion_status

Prüfen Sie record_count der IngestPpidDataStatus, um zu bestätigen, dass die Gesamtzahl der empfangenen Datensätze Ihren Erwartungen entspricht. record_count umfasst sowohl erfolgreiche als auch fehlgeschlagene Datensätze.

Prüfen Sie ppid_count, um zu bestätigen, dass die Anzahl der empfangenen PPIDs Ihren Erwartungen entspricht.

user_id_data_ingestion_status

Prüfen Sie record_count der IngestUserIdDataStatus, um zu bestätigen, dass die Gesamtzahl der empfangenen Datensätze Ihren Erwartungen entspricht. record_count umfasst sowohl erfolgreiche als auch fehlgeschlagene Datensätze.

Prüfen Sie user_id_count, um zu bestätigen, dass die Anzahl der empfangenen Nutzer-IDs Ihren Erwartungen entspricht.

Status der Entfernung von Zielgruppenmitgliedern

Das Feld audience_members_removal_status wird ausgefüllt, wenn die Anfrage eine RemoveAudienceMembersRequest war. Hier ist das RemoveAudienceMembersStatus Feld, das für jeden Typ von Zielgruppendaten geprüft werden muss. Nur eines dieser Felder ist festgelegt.

user_data_removal_status
Entfernungsstatus für Nutzerdaten.
mobile_data_removal_status
Entfernungsstatus für mobile Daten.
pair_data_removal_status
Entfernungsstatus für PAIR-Daten.
ppid_data_removal_status
Entfernungsstatus für PPID-Daten.
user_id_data_removal_status
Entfernungsstatus für Nutzer-ID-Daten

Prüfen Sie record_count, um zu bestätigen, dass die Gesamtzahl der empfangenen Datensätze Ihren Erwartungen entspricht. record_count umfasst sowohl erfolgreiche als auch fehlgeschlagene Datensätze.

Prüfen Sie außerdem user_identifier_count, mobile_id_count oder pair_id_count, um die Gesamtzahl der empfangenen Nutzerkennungen, Mobilgeräte-IDs oder PAIR-IDs zu bestätigen.

Warnungen und Fehler prüfen

Zusätzlich zu den Statusfeldern für das Ziel und den Anfragetyp enthält die RetrieveRequestStatusResponse eine Aufschlüsselung der Warnungen und Fehler für die Anfrage.

  • Ein Fehler gibt an, dass die API den Datensatz vollständig abgelehnt hat.
  • Eine Warnung gibt an, dass die API den Datensatz nicht abgelehnt hat, aber Teile der Daten des Datensatzes ignorieren musste.

Wenn ein Event verschlüsselte UserIdentifier-Daten und AdIdentifiers wie gclid enthält und die UserIdentifier-Daten nicht entschlüsselt werden können, verarbeitet die Data Manager API den Datensatz trotzdem mit den AdIdentifiers, gibt aber die Warnung PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR zurück.

Wenn das Event jedoch keine AdIdentifiers enthält und die UserIdentifier-Daten nicht entschlüsselt werden können, lehnt die Data Manager API den gesamten Datensatz ab und meldet den Fehler PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR, da ein gültiges Event mindestens eines der Felder ad_identifiers oder user_data enthalten muss.

Hier sind die Antwortfelder, die Warnungs- und Fehlerinformationen enthalten.

warning_info
Eine Liste von WarningCount-Objekten. Jede WarningCount enthält einen reason mit dem Typ der Warnung und einen record_count mit der Anzahl der Datensätze, für die Warnungen dieses Typs ausgegeben wurden.
error_info
Eine Liste von ErrorCount-Objekten. Jede ErrorCount enthält einen reason mit dem Typ des Fehlers und einen record_count mit der Anzahl der Datensätze, die aufgrund dieses Fehlertyps fehlgeschlagen sind.