Журнал доставки событий и повторная отправка
Как найти отправку по клику, понять её состояние и результат и повторить её без дубля у получателя.
В журнале доставки видна каждая запись конверсии и каждая исходящая отправка: S2S-постбек в источник и получателям кампании и событие Facebook Conversions API. По журналу видно, ушло ли событие, сколько было попыток и чем они закончились. Раздел видят владелец и администратор.
Где находится журнал
- Логи → Доставка событий — все отправки рабочего пространства за период. Как открыть раздел — на странице Раздел «Логи».
- Блок Доставка событий в карточке клика — все сохранённые доставки одного клика, без фильтров и без ограничения периодом.
Адрес получателя и содержимое запроса в журнале не показываются. Над таблицей на вкладке стоит строка вида «Время: Europe/Warsaw. Секреты получателей скрыты.» Время в таблице выведено в часовом поясе браузера.
Как найти отправку
- Откройте Логи → Доставка событий. Откроется список за последние 7 дней.
- Заполните фильтры.
- Нажмите Найти.
| Фильтр | Значения |
|---|---|
| Subid | Subid клика целиком, точное совпадение. До 64 символов: латинские буквы, цифры, _ и - |
| С и По | Период по времени создания задачи, не длиннее 93 дней. Оба поля обязательны |
| Состояние | Все состояния, Ожидает, Обрабатывается, Выполнено, Нужна проверка |
| Тип | Все типы, Конверсия, S2S, CAPI |
| Получатель | Все получатели, Источник, Кампания, Источник + кампания. С выбранным получателем в списке остаются только строки S2S с таким же получателем |
На странице 100 строк, новые сверху. Листайте кнопками ← Назад и Далее →. Кнопка Обновить перечитывает список с теми же фильтрами. Если ничего не найдено, в таблице стоит строка «Доставок за выбранный период нет». Если subid неизвестен, найдите клик по IP или external_id — см. Поиск кликов и лидов.
Колонки таблицы
| Колонка | Что показывает |
|---|---|
| Создано | Время создания задачи. При наведении — время последнего изменения |
| Тип / получатель | Тип задачи и получатель, см. ниже |
| Клик | Subid. Нажатие открывает карточку клика. В карточке клика этой колонки нет |
| Состояние | Текущее состояние задачи |
| Попытки | Сколько раз трекер выполнял задачу |
| Результат | Итог последней попытки |
Типы задач:
- Запись конверсии — трекер сохраняет принятую конверсию в статистику. Пока эта задача не выполнена, строк S2S и CAPI по этой конверсии нет: они создаются после записи.
- S2S · источник — постбек в источник трафика.
- S2S · кампания — постбек на дополнительный адрес кампании.
- S2S · источник + кампания — итоговый адрес источника и адрес кампании совпали, запрос отправляется один раз.
- CAPI — событие в Facebook.
Состояния
| Состояние | Что значит |
|---|---|
| Ожидает | Задача стоит в очереди: ждёт первой отправки, следующей автоматической попытки или продления лицензии |
| Обрабатывается | Трекер выполняет задачу прямо сейчас |
| Выполнено | Конверсия записана или получатель ответил успешно |
| Нужна проверка | Автоматических попыток больше не будет. Посмотрите колонку Результат и решите, повторять ли отправку |
Значения колонки «Результат»
| Результат | Что значит | Что делать |
|---|---|---|
| «—» | Попыток ещё не было или задача возвращена в очередь кнопкой Повторить | Ничего |
ok | Задача выполнена. Для S2S — получатель ответил кодом 2xx | Ничего |
http_404, http_500 и другие http_… | Получатель S2S ответил этим HTTP-кодом. При 5xx и 429 трекер повторяет сам, при остальных кодах сразу ставит Нужна проверка | Проверьте адрес постбека и его параметры в источнике или кампании. Исправленный адрес действует для новых конверсий, Повторить отправляет прежний |
| Нет соединения · повторяется | Соединиться с получателем не удалось, запрос не ушёл. Трекер попробует ещё раз | Подождите |
| Нет соединения · попытки исчерпаны | Соединиться не удалось, автоматические попытки закончились | Убедитесь, что получатель доступен, и повторите |
| Получение не подтверждено | Запрос ушёл, но ответ не получен. Событие могло дойти | Сверьте у получателя и только потом повторяйте |
| Некорректный URL | Адрес постбека не разобран или начинается не с http:// или https:// | Исправьте адрес в источнике или кампании. Повторить эту задачу нельзя |
| Адрес заблокирован | Адрес ведёт на непубличный IP: локальный или из внутренней сети. На такие адреса трекер не отправляет | Укажите публичный адрес. Повторить эту задачу нельзя |
| Восстановлено из копии · нужна сверка | Задача не была завершена на момент резервной копии, а трекер восстановлен из этой копии | Сверьте у получателя, затем повторите |
capi_error | Facebook не принял событие или не ответил. В состоянии Ожидает трекер повторяет отправку сам | В состоянии Нужна проверка — см. Если событие не ушло |
license_hold | Отправка отложена, пока лицензия не активна | Ничего: после продления уйдёт сама |
storage_error, ack_error | Трекер не смог записать конверсию в статистику или сохранить результат задачи. Повторяет сам | Если ошибка держится, откройте Состояние системы |
invalid_payload, invalid_kind | Задача повреждена | Повторить эту задачу нельзя |
Автоматические повторы
Успех S2S — ответ получателя с кодом 2xx.
Трекер сам повторяет отправку в трёх случаях:
- соединение с получателем не установлено;
- получатель S2S ответил кодом 5xx или 429;
- Facebook ответил кодом 5xx или 429 либо запрос к нему оборвался.
Пауза перед следующей попыткой удваивается: от 10 секунд до 85 минут. После 12 попыток S2S и CAPI переходят в состояние Нужна проверка. Запись конверсии повторяется без ограничения числа попыток.
Остальные ответы, например 404, трекер не повторяет.
«Получение не подтверждено»
Такой результат появляется у S2S, когда запрос отправлен, а ответ не получен: получатель не ответил вовремя или отправка оборвалась. Трекер не знает, засчитано ли событие, и сам его не повторяет: не каждый получатель отсеивает повторные постбеки.
- Проверьте у получателя, есть ли конверсия по этому клику.
- Если конверсия есть — ничего не делайте.
- Если её нет — нажмите Повторить.
Ручной повтор
Кнопка Повторить есть только у строк в состоянии Нужна проверка.
- Нажмите Повторить в строке задачи.
- Прочитайте вопрос: «Повторить отправку? Если получатель уже принял событие, у него может появиться дубль. Сначала сверьте данные у получателя.»
- Подтвердите.
Задача вернётся в состояние Ожидает, результат сменится на «—». Запрос уйдёт получателю в прежнем виде: изменения адреса постбека, сделанные после конверсии, на созданную задачу не действуют.
Счётчик в колонке Попытки не обнуляется. Если S2S или CAPI уже использовали 12 попыток, после ручного повтора трекер сделает одну.
Кнопки нет у результатов Некорректный URL, Адрес заблокирован, invalid_payload и invalid_kind.
Повтор после результата Получение не подтверждено или Восстановлено из копии · нужна сверка без сверки может создать у получателя вторую конверсию.
Отправки при неактивной лицензии
Пока лицензия не активна, S2S и CAPI не отправляются. Запись конверсий продолжается. Задачи ждут в состоянии Ожидает, попытки при этом не расходуются. После продления накопленные отправки уходят автоматически. Пока очередь разбирается, у ещё не отправленных задач в колонке Результат стоит license_hold или «—». Подробнее — Истечение лицензии.
Вкладка «Состояние очередей»
Логи → Состояние очередей показывает сводку по очередям. Она обновляется каждые 10 секунд.
Таблица Доставка событий считает незавершённые задачи рабочего пространства. Строки — типы задач: conversion, s2s и capi.
| Колонка | Что считает |
|---|---|
| Ожидают | Задачи в состоянии Ожидает |
| В работе | Задачи в состоянии Обрабатывается |
| Ошибки | Задачи в состоянии Нужна проверка |
| Истёк срок обработки | Задачи, обработка которых не завершилась вовремя |
| Неизвестный результат | Задачи с результатом Получение не подтверждено |
| Возраст очереди | Сколько ждёт самая старая задача в состоянии Ожидает или Обрабатывается |
Если незавершённых задач нет, в таблице строка «Незавершённых задач нет».
Таблица Приём кликов относится ко всему серверу и показывает очереди Клики и Переходы с лендинга. Её колонки и состояния разобраны на странице Состояние системы.
Частые вопросы
Конверсия есть в трекере, а строки S2S нет
Задача создаётся, только если на момент конверсии был настроен постбек источника или кампании и статус конверсии входит в отправляемые. Постбеки, добавленные позже, на старые конверсии не рассылаются. Остальные причины — в разделе Постбек в источник не ушёл.
Выберите период до 93 дней
Период между С и По длиннее 93 дней или начало позже конца. Сократите период. Доставки одного клика без ограничения периодом показаны в его карточке.
Некорректный subid
В поле Subid больше 64 символов или есть знаки, кроме латинских букв, цифр, _ и -. Введите subid клика целиком.
Задача долго в состоянии «Ожидает»
Посмотрите колонку Результат:
- Нет соединения · повторяется,
http_500и другие коды 5xx,http_429,capi_error— трекер ждёт паузу перед следующей попыткой. license_hold— отправка была отложена до продления лицензии и уйдёт в порядке очереди.- «—» — отправка ещё не начиналась. S2S и CAPI одного клика уходят по очереди: задача ждёт, пока завершится более ранняя отправка этого клика с тем же типом и получателем.