Diagnostyka

Oto zalecany proces sprawdzania stanu przesyłania zdarzeń i list odbiorców oraz identyfikowania problemów z danymi.

  1. Wysyłaj żądania przesyłania zdarzeń lub dodawania bądź usuwania członków list odbiorców.

  2. Sprawdź ogólny stan każdego żądania. Prawidłowe żądanie ma Status z code równą 0 (wartość wyliczeniowa OK, odpowiedź HTTP 200 OK) i zwraca IngestEventsResponse, IngestAudienceMembersResponse lub RemoveAudienceMembersResponse.

    Jeśli żądanie nie powiedzie się, zmodyfikuj je, aby rozwiązać problem, i wyślij je ponownie.

    Jeśli żądanie się powiedzie, zapisz request_id z odpowiedzi, aby móc go użyć do pobrania danych diagnostycznych w następnym kroku.

  3. W przypadku każdego prawidłowego request_id wyślij żądanie RetrieveRequestStatus.

  4. Sprawdź każdą odpowiedź RetrieveRequestStatusResponse, aby potwierdzić , że przesyłanie działa prawidłowo, i zidentyfikować problemy z danymi.

  5. Rozwiąż problemy z danymi.

  6. Wróć do kroku 1 i powtarzaj go, aż rozwiążesz wszystkie problemy z przesyłaniem.

Przesyłanie żądań

A RetrieveRequestStatusRequest ma jedno pole request_id. Wyślij 1 żądanie na każdy prawidłowy identyfikator żądania, który został zapisany podczas wysyłania żądań pozyskiwania.

Wypróbuj żądanie w przeglądarce za pomocą narzędzia API Explorer.

Sprawdzanie odpowiedzi

Pole request_status_per_destination w RetrieveRequestStatusResponse zawiera osobny wpis dla każdego miejsca docelowego w odpowiednim żądaniu pozyskiwania.

Jeśli na przykład IngestAudienceMembersRequest zawierało 3 wpisy na liście destinations do wysyłania danych do 3 różnych list odbiorców, odpowiedź o stanie będzie zawierać 3 wpisy w request_status_per_destination (po 1 na każdą listę odbiorców).

Sprawdzanie ogólnego stanu miejsca docelowego

W pierwszym kroku sprawdź pole request_status, aby określić, czy interfejs Data Manager API zakończył przetwarzanie danych dla destination w RequestStatusPerDestination. Oto możliwe wartości request_status:

  • PROCESSING: dane dla miejsca docelowego są nadal przetwarzane.
  • SUCCESS: przetwarzanie żądania dla miejsca docelowego zostało zakończone bez błędów.
  • FAILURE: wszystkie rekordy dla miejsca docelowego nie powiodły się z powodu błędów.
  • PARTIAL_SUCCESS: niektóre rekordy dla miejsca docelowego zostały przetworzone, ale inne nie powiodły się z powodu błędów.

Sprawdzanie stanu zdarzenia lub listy odbiorców w każdym miejscu docelowym

Sprawdź pole stanu, które odpowiada typowi żądania pozyskiwania. W każdym RequestStatusPerDestination ustawione jest tylko jedno z tych pól:

Stan pozyskiwania zdarzeń

Pole events_ingestion_status jest wypełniane, jeśli żądanie było IngestEventsRequest.

Sprawdź record_count w IngestEventStatus , aby potwierdzić, że łączna liczba otrzymanych rekordów jest zgodna z oczekiwaniami. record_count obejmuje zarówno rekordy przetworzone, jak i nieprzetworzone.

Stan pozyskiwania członków listy odbiorców

Pole audience_members_ingestion_status jest wypełniane, jeśli żądanie było IngestAudienceMembersRequest. Oto pole IngestAudienceMembersStatus, które należy sprawdzić w przypadku każdego typu danych o odbiorcach. Ustawione jest tylko jedno z tych pól.

user_data_ingestion_status

Sprawdź record_count w IngestUserDataStatus, aby potwierdzić, że łączna liczba otrzymanych rekordów jest zgodna z oczekiwaniami. record_count obejmuje zarówno rekordy przetworzone, jak i nieprzetworzone.

Sprawdź user_identifier_count, aby potwierdzić, że liczba identyfikatorów użytkowników otrzymanych jest zgodna z Twoimi oczekiwaniami.

Jeśli żądanie zawierało wystarczającą liczbę rekordów, upload_match_rate_range zawiera zakres współczynnika dopasowania rekordów w żądaniu.

mobile_data_ingestion_status

Sprawdź record_count w IngestMobileDataStatus, aby potwierdzić, że łączna liczba otrzymanych rekordów jest zgodna z oczekiwaniami. record_count obejmuje zarówno rekordy przetworzone, jak i nieprzetworzone.

Sprawdź mobile_id_count, aby potwierdzić, że liczba otrzymanych identyfikatorów mobilnych jest zgodna z oczekiwaniami.

pair_data_ingestion_status

Sprawdź record_count w IngestPairDataStatus, aby potwierdzić, że łączna liczba otrzymanych rekordów jest zgodna z oczekiwaniami. record_count obejmuje zarówno rekordy przetworzone, jak i nieprzetworzone.

Sprawdź pair_id_count, aby potwierdzić, że liczba otrzymanych identyfikatorów PAIR jest zgodna z oczekiwaniami.

ppid_data_ingestion_status

Sprawdź record_count w IngestPpidDataStatus, aby potwierdzić, że łączna liczba otrzymanych rekordów jest zgodna z oczekiwaniami. record_count obejmuje zarówno rekordy przetworzone, jak i nieprzetworzone.

Sprawdź ppid_count, aby potwierdzić, że liczba otrzymanych identyfikatorów PPID jest zgodna z oczekiwaniami.

user_id_data_ingestion_status

Sprawdź record_count w IngestUserIdDataStatus, aby potwierdzić, że łączna liczba otrzymanych rekordów jest zgodna z oczekiwaniami. record_count obejmuje zarówno rekordy przetworzone, jak i nieprzetworzone.

Sprawdź user_id_count, aby potwierdzić, że liczba otrzymanych identyfikatorów użytkowników jest zgodna z oczekiwaniami.

Stan usuwania członków listy odbiorców

Pole audience_members_removal_status jest wypełniane, jeśli żądanie było RemoveAudienceMembersRequest. Oto pole RemoveAudienceMembersStatus, które należy sprawdzić w przypadku każdego typu danych o odbiorcach. Ustawione jest tylko jedno z tych pól.

user_data_removal_status
Stan usuwania danych użytkownika.
mobile_data_removal_status
Stan usuwania danych mobilnych.
pair_data_removal_status
Stan usuwania danych PAIR.
ppid_data_removal_status
Stan usuwania danych PPID.
user_id_data_removal_status
Stan usuwania danych identyfikatora użytkownika.

Sprawdź record_count, aby potwierdzić, że łączna liczba otrzymanych rekordów jest zgodna z oczekiwaniami. record_count obejmuje zarówno rekordy przetworzone, jak i nieprzetworzone.

Dodatkowo sprawdź user_identifier_count, mobile_id_count lub pair_id_count, aby potwierdzić łączną liczbę otrzymanych identyfikatorów użytkowników, identyfikatorów mobilnych lub identyfikatorów PAIR.

Sprawdzanie ostrzeżeń i błędów

Oprócz pól stanu miejsca docelowego i typu żądania RetrieveRequestStatusResponse zawiera zestawienie ostrzeżeń i błędów dotyczących żądania.

  • Błąd oznacza, że interfejs API całkowicie odrzucił rekord.
  • Ostrzeżenie oznacza, że interfejs API nie odrzucił rekordu, ale musiał zignorować części danych rekordu.

Jeśli na przykład Event zawiera zaszyfrowane UserIdentifier dane i AdIdentifiers takie jak gclid, a danych UserIdentifier nie można odszyfrować, interfejs Data Manager API nadal przetwarza rekord za pomocą AdIdentifiers, ale zwraca ostrzeżenie PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR.

Jeśli jednak Event nie zawiera AdIdentifiers, a danych UserIdentifier nie można odszyfrować, interfejs Data Manager API odrzuca cały rekord i zgłasza błąd PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR, ponieważ prawidłowy Event musi zawierać co najmniej 1 z tych elementów: ad_identifiers lub user_data.

Oto pola odpowiedzi, które zawierają informacje o ostrzeżeniach i błędach.

warning_info
Lista obiektów WarningCount. Każdy obiekt WarningCount zawiera reason z typem ostrzeżenia oraz record_count wskazujący liczbę rekordów, które zawierały ostrzeżenia tego typu.
error_info
Lista obiektów ErrorCount. Każdy obiekt ErrorCount zawiera reason z typem błędu oraz record_count wskazujący liczbę rekordów, które nie powiodły się z powodu tego typu błędu.