Часто задаваемые вопросы

Есть ли ограничения на загрузку контента?

При этом действуют следующие ограничения:

• В одном запросе batchinsert и batchupdate может быть не более 1000 конверсий.
• Срок регистрации конверсии на момент отправки не должен превышать 28 дней.
• Вы можете отправлять конверсии только в ту конфигурацию Floodlight, к которой у вашего профиля пользователя Менеджера кампаний 360 есть доступ.

Что лучше использовать для загрузки конверсий – Менеджер кампаний 360 или Поисковую рекламу 360?

Подробное сравнение функций обоих продуктов вы найдете в Справочном центре Поисковой рекламы 360.

Что произойдет, если я добавлю одну и ту же конверсию и в Менеджер кампаний 360, и в Поисковую рекламу 360?

Если вы добавите одну и ту же конверсию и в Менеджер кампаний 360, и в Поисковую рекламу 360, то записи не будут дедуплицированы. В этом случае используйте отдельные действия Floodlight.

Какой API использовать для загрузки офлайн-конверсий?

Рекомендуем использовать Data Manager API, чтобы получить доступ к дополнительным функциям и улучшить взаимодействие с API.

Что такое порядковое значение и как оно используется?

Порядковые значения определяют, как обрабатываются повторяющиеся конверсии. Если вставляется несколько конверсий с одинаковыми действием Floodlight, идентификатором конфигурации Floodlight, идентификатором пользователя и временной меткой конверсии, то порядковый номер используется для определения того, что нужно сделать:

• Конверсии дедуплицируются, и остается только одна. Это происходит, если у всех конверсий одинаковое порядковое значение.
• Конверсии обрабатываются по отдельности, и все они сохраняются. Это происходит, если у всех конверсий разные порядковые номера.

Сами значения не обязательно должны иметь смысл. Как правило, для дедупликации достаточно использовать фиксированное значение (например, 1) для всех конверсий. Если вы используете случайное или уникальное значение для каждой конверсии, дедупликация будет отключена.

Как обрабатывать ошибки в ответе API и какие ошибки требуют повторной попытки?

batchinsert и batchupdate обрабатывают конверсии по мере возможности: пакетный запрос может вернуть ответ HTTP 200 OK, даже если отдельные конверсии в пакете не будут обработаны. Всегда проверяйте поле hasFailures в ответе и список errors[] в каждом объекте ConversionStatus.

• INTERNAL (повторить попытку) – временная ошибка в системах Google при обработке конверсии. Конверсия не была добавлена или обновлена. Повторите попытку загрузки конверсий, используя экспоненциальную выдержку (например, через несколько минут, а затем через несколько часов), сохраняя те же значения ordinal, timestampMicros, floodlightActivityId и идентификатор пользователя или клика.
• NOT_FOUND (повторить попытку позже). Идентификатор (gclid, dclid, matchId или mobileDeviceId) или редактируемая конверсия пока не найдены. Поскольку обработка и индексирование онлайн-кликов, тегов Floodlight и конверсий может занимать от одного до двух часов, периодически повторяйте попытки загрузки конверсий NOT_FOUND (например, каждые 1–3 часа в течение 6 часов). Если NOT_FOUND не исчезает через 6 часов, ознакомьтесь с распространенными причинами для разных типов идентификаторов в разделах ниже.
• INVALID_ARGUMENT и PERMISSION_DENIED (повторная попытка не выполняется). Данные о конверсиях недействительны (например, временная метка конверсии относится к периоду, который завершился более 28 дней назад, или поле заполнено неправильно) или у вашего профиля пользователя нет разрешения на доступ к целевой конфигурации Floodlight. Не пытайтесь повторно загрузить эти конверсии, не устранив проблему.

Если весь HTTP-запрос завершается ошибкой сервера 5xx или ошибкой квоты/ограничения частоты запросов 429, повторите запрос, используя экспоненциальную выдержку.

Безопасные повторные попытки и дедупликация. При повторной попытке передачи конверсии, которая не была выполнена из-за ошибки INTERNAL или NOT_FOUND (или после тайм-аута HTTP 5xx, когда результат неизвестен), всегда отправляйте точно такие же значения ordinal и timestampMicros. Если конверсия уже была зарегистрирована, Менеджер кампаний 360 автоматически удаляет ее дубликат на основе ordinal, идентификатора пользователя, действия Floodlight и даты конверсии.

Что означает ошибка NOT_FOUND при загрузке файла mobileDeviceId?

Наиболее распространенные причины этой ошибки:

• Недопустимое значение mobileDeviceId.
• mobileDeviceId неизвестен Поисковой рекламе 360. Это означает, что на устройство ещё не было показано ни одного объявления из Менеджера кампаний 360.

Что означает ошибка NOT_FOUND при загрузке файла gclid?

Наиболее распространенные причины этой ошибки:

• Недопустимое значение gclid.
• gclid не связан с кампанией Поисковой рекламы 360 или позицией Дисплея и Видео 360 для YouTube. Это может произойти, если значение gclid было получено в результате перенаправления клика по объявлению Google Рекламы, которое не прошло через Поисковую рекламу 360 (например, клики по адресам), или в результате перенаправления клика по рекламе на YouTube, не связанному с позицией YouTube в Дисплее и Видео 360.
• Клик, связанный с событием gclid, произошел слишком давно. Конверсии можно добавлять только для кликов, которые были совершены не более 60 дней назад.
• Клик, связанный с gclid, произошел слишком недавно. Рекомендуем загружать конверсии на основе gclid с задержкой в один час, чтобы gclid успел обработаться и стать доступным для сопоставления.

Что означает ошибка NOT_FOUND при загрузке файла dclid?

Обычно это происходит в следующих случаях:

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

Что означает ошибка NOT_FOUND при загрузке файла matchId?

Наиболее распространенные причины этой ошибки:

• matchId неизвестен Менеджеру кампаний 360. Это может произойти, если значение matchId было получено из вызова Floodlight, который не был должным образом передан через Менеджер кампаний 360. Убедитесь, что вызовы Floodlight работают правильно, в том числе параметр тега matchId.
• Вызов Floodlight, связанный с matchId, не содержал файл cookie. Вызов Floodlight должен содержать файл cookie или идентификатор, чтобы Менеджер кампаний 360 мог правильно сохранить matchId (например, пользователь мог заблокировать файлы cookie или отказаться от них).
• Вызов Floodlight, связанный с matchId, произошел слишком давно. Загрузка офлайн-конверсий должна быть выполнена в течение 60 дней после вызова Floodlight, содержащего matchId.
• Вызов Floodlight, связанный с matchId, произошел слишком недавно. Рекомендуем отложить загрузку конверсий на основе matchId на два часа, чтобы убедиться, что matchId обработан и доступен для сопоставления.

Включаются ли в отчеты офлайн-конверсии с временной меткой, предшествующей созданию действия Floodlight?

Загруженные офлайн-конверсии с временной меткой, предшествующей созданию действия Floodlight, могут быть зарегистрированы как показы Floodlight и как атрибутированные или неатрибутированные конверсии, если они произошли не ранее чем за 28 дней до момента отправки. Однако это не гарантируется, и полагаться на такое поведение не следует. Рекомендуем создавать действия Floodlight до самой ранней временной метки офлайн-конверсии.

Какое согласие необходимо, чтобы использовать вставку офлайн-конверсий для создания списка аудиторий?

Чтобы можно было создавать списки аудиторий, необходимо не только получить согласие на использование данных пользователей, но и явно задать для поля nonPersonalizedAd значение false.