Отправьте в разрешённой тестовой среде одну заведомо невалидную синтетическую запись и проследите её до журнала. Сохранять только исключения HTTP-клиента недостаточно: API может принять запрос, а обработка отдельных записей завершится иначе. Разделите событие CRM, сетевую попытку и окончательный исход.
У партии и отдельного события разные результаты
| Уровень | Что фиксировать |
|---|---|
| Бизнес-событие | Устойчивый ID и тип факта |
| Запрос | Попытка, направление и время |
| Ответ | Статус и диагностический request ID |
| Запись партии | Соответствие индексу или внешнему ключу |
| Завершение | Принято, отклонено, ожидается или неизвестно |
Google Ads рекомендует журналы вызовов и сохранение request-id для диагностики. Документация проверена 28 октября 2026 года. Собственный логгер должен маскировать чувствительные данные; наличие подробного журнала не является разрешением хранить OAuth-токен, полный контакт клиента и всё тело запроса без отбора.
Условная запись диагностики:
event_id -> локальный факт
attempt_id -> конкретная сетевая попытка
request_id -> идентификатор платформы, если получен
item_key -> запись внутри партии
result -> состояние и нормализованная причина
Нет ответа -> unknown, а не success.Асинхронный приём требует последующей проверки
Для Data Manager API метод events.ingest возвращает requestId, а requestStatus.retrieve предназначен для проверки состояния запроса. Источники проверены 28 октября 2026 года. Привяжите последующую проверку к исходной партии и сохраняйте её прогресс, не создавая вместо неё новую загрузку событий.
Если API сообщает поэлементные ошибки, храните карту «локальный ID — позиция в отправленной партии». После сортировки или исключения записей исходный индекс меняется. Без сохранённой карты оператор может приписать ошибку другому заказу и повторно отправить уже принятую конверсию.
Причина должна быть пригодна для действия: невалидное поле, нет доступа, временный отказ или неопределённый исход. Сохраняйте также исходный код поставщика в ограниченном диагностическом поле. Слишком общая метка «ошибка интеграции» не позволяет решить, исправлять данные или повторять доставку.
При сетевом таймауте не объявляйте все элементы отклонёнными. Платформа могла принять партию до потери ответа. Используйте поддержанный способ сверки и безопасного повтора; локальный журнал должен показывать эту неопределённость до разрешения, а не автоматически увеличивать счётчик успехов.
Сам журнал тоже может отказать
- Проверить валидную и невалидную синтетические записи.
- Испытать партию с разными поэлементными исходами, если API её поддерживает.
- Разорвать тестовый ответ после возможного принятия.
- Повторить запрос и сверить связь попыток с одним событием.
- Смоделировать недоступность хранилища журнала.
Если журнал пишется после отправки в отдельную ненадёжную операцию, успешный запрос может исчезнуть из истории. Предусмотрите устойчивую регистрацию попытки и явное незавершённое состояние. Отказ записи наблюдаемости не должен молча превращать повторную отправку в единственный способ узнать судьбу события.
Ограничивайте доступ к подробным данным, срок хранения и объём ошибок. Для группировки обычно достаточно кода, поля, типа операции и обезличенного ключа. Исходные пользовательские сведения при необходимости исследуются через контролируемый доступ, а не через общедоступный лог.
Для приёмки выберите одно событие и восстановите всю цепь: создание, попытки, ответ и окончательный результат. Если невозможно объяснить, почему оно осталось pending или было отклонено, наблюдаемость ещё неполна. Для обращения в поддержку подготовьте request ID и минимальные обезличенные детали причины.