Диагностика

Ниже приведен рекомендуемый рабочий процесс для проверки состояния загрузок ваших мероприятий и аудитории, а также выявления проблем с вашими данными.

  1. Отправка запросов на отправку событий или отправку или удаление участников аудитории .
  2. Захватите request_id из каждого IngestEventsResponse , IngestAudienceMembersResponse или RemoveAudienceMembersResponse .
  3. Отправьте запрос RetrieveRequestStatus для каждого request_id .
  4. Проверьте каждый RetrieveRequestStatusResponse чтобы убедиться, что ваши загрузки работают правильно, и выявить любые проблемы с вашими данными.
  5. Исправление проблем с данными.
  6. Вернитесь к шагу 1 и повторяйте, пока не решите все проблемы с загрузками.

Запросы на создание

Запрос RetrieveRequestStatusRequest имеет одно поле request_id . Отправьте один запрос для каждого идентификатора запроса, полученного при отправке запросов на прием.

Обзор ответов

request_status_per_destination в RetrieveRequestStatusResponse содержит отдельную запись для каждого пункта назначения в соответствующем запросе на прием.

Например, если ваш IngestAudienceMembersRequest содержит 3 записи в списке destinations для отправки данных 3 разным аудиториям, то ответ о состоянии будет содержать 3 записи в request_status_per_destination (одна запись на аудиторию).

Проверить общий статус пункта назначения

Для начала проверьте поле request_status , чтобы определить, завершил ли API диспетчера данных обработку данных для destination RequestStatusPerDestination . Вот возможные значения request_status :

  • PROCESSING : Данные по пункту назначения все еще обрабатываются.
  • SUCCESS : Обработка запроса для пункта назначения завершена без ошибок.
  • FAILURE : Все записи для пункта назначения не удалось выполнить из-за ошибок.
  • PARTIAL_SUCCESS : Некоторые записи для пункта назначения были успешно обработаны, но другие не удалось выполнить из-за ошибок.

Проверьте статус мероприятия или аудитории по месту назначения

Проверьте поле статуса, соответствующее типу запроса на прием. Для каждого RequestStatusPerDestination задано только одно из следующих полей:

Статус приема событий

Поле events_ingestion_status заполняется, если запрос был IngestEventsRequest .

Проверьте значение record_count в IngestEventStatus , чтобы убедиться, что общее количество полученных записей соответствует вашим ожиданиям. record_count включает как успешные, так и неудачные записи.

Статус приема информации членами аудитории

Поле audience_members_ingestion_status заполняется, если запрос был IngestAudienceMembersRequest . Ниже приведено поле IngestAudienceMembersStatus для проверки каждого типа данных аудитории. Заполняется только одно из этих полей.

user_data_ingestion_status

Проверьте значение record_count в IngestUserDataStatus , чтобы убедиться, что общее количество полученных записей соответствует вашим ожиданиям. record_count включает как успешные, так и неудачные записи.

Проверьте user_identifier_count , чтобы убедиться, что количество полученных идентификаторов пользователей соответствует вашим ожиданиям.

Если в запросе достаточное количество записей, upload_match_rate_range содержит диапазон коэффициента соответствия для записей в запросе.

mobile_data_ingestion_status

Проверьте значение record_count в IngestMobileDataStatus , чтобы убедиться, что общее количество полученных записей соответствует вашим ожиданиям. record_count включает как успешные, так и неудачные записи.

Проверьте mobile_id_count , чтобы убедиться, что количество полученных мобильных идентификаторов соответствует вашим ожиданиям.

pair_data_ingestion_status

Проверьте значение record_count в IngestPairDataStatus , чтобы убедиться, что общее количество полученных записей соответствует вашим ожиданиям. record_count включает как успешные, так и неудачные записи.

Проверьте pair_id_count , чтобы убедиться, что количество полученных идентификаторов PAIR соответствует вашим ожиданиям.

Статус удаления участников аудитории

Поле audience_members_removal_status заполняется, если запрос был RemoveAudienceMembersRequest . Ниже приведено поле RemoveAudienceMembersStatus для проверки каждого типа данных аудитории. Заполняется только одно из этих полей.

user_data_removal_status
Статус удаления пользовательских данных .
mobile_data_removal_status
Статус удаления мобильных данных .
pair_data_removal_status
Статус удаления данных PAIR .

Проверьте значение record_count , чтобы убедиться, что общее количество полученных записей соответствует вашим ожиданиям. record_count включает как успешные, так и неудачные записи.

Кроме того, проверьте user_identifier_count , mobile_id_count или pair_id_count чтобы подтвердить общее количество полученных идентификаторов пользователей, мобильных идентификаторов или идентификаторов PAIR.

Проверьте предупреждения и ошибки

Помимо полей статуса для назначения и типа запроса, RetrieveRequestStatusResponse содержит разбивку предупреждений и ошибок для запроса.

  • Ошибка указывает на то, что API полностью отклонил запись.
  • Предупреждение указывает на то, что API не отклонил запись, но ему пришлось проигнорировать части данных записи.

Например, если Event содержит зашифрованные данные UserIdentifier и AdIdentifiers , такие как gclid , и данные UserIdentifier не могут быть расшифрованы, API диспетчера данных все равно обрабатывает запись с использованием AdIdentifiers , но возвращает предупреждение PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR .

Однако если Event не содержит AdIdentifiers и данные UserIdentifier не могут быть расшифрованы, API диспетчера данных отклоняет всю запись и сообщает об ошибке PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR , поскольку допустимое Event должно иметь по крайней мере один из ad_identifiers или user_data .

Вот поля ответа, содержащие информацию о предупреждениях и ошибках.

warning_info
Список объектов WarningCount . Каждый объект WarningCount содержит reason и тип предупреждения, а также значение record_count указывающее количество записей с предупреждениями этого типа.
error_info
Список объектов ErrorCount . Каждый объект ErrorCount содержит reason и тип ошибки, а также значение record_count , указывающее количество записей, не обработанных из-за этого типа ошибки.