Эта страница переведена с помощью Cloud Translation API.

Диагностика

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

Отправка запросов на отправку событий или отправку или удаление участников аудитории .
Проверьте общий статус каждого запроса. Успешному запросу присваивается Status с code 0 (значение перечисления OK , HTTP-ответ 200 OK ), и возвращается IngestEventsResponse , IngestAudienceMembersResponse или RemoveAudienceMembersResponse .
Если запрос не удался, измените его, чтобы устранить ошибку, и отправьте запрос еще раз.
Если запрос выполнен успешно, сохраните request_id ответа, чтобы его можно было использовать для получения диагностических данных на следующем этапе.
Примечание: диагностику можно получить только для тех запросов, которые были выполнены успешно и для которых validate_only не установлен в true .
Отправляйте запрос RetrieveRequestStatus для каждого успешного request_id .
Проверьте каждый RetrieveRequestStatusResponse чтобы убедиться, что ваши загрузки работают правильно, и выявить любые проблемы с вашими данными.
Исправление проблем с данными.
Вернитесь к шагу 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
audience_members_ingestion_status
audience_members_removal_status

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

Поле 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 , указывающее количество записей, не обработанных из-за этого типа ошибки.