К содержимому

Отправьте тестовое событие в Pinterest Conversions API

Pinterest CAPI работает по ID рекламного аккаунта, а не по ID тега. Введите ID аккаунта и токен конверсий, выберите события и отправьте их в API v5. Тестовый режим добавляет test=true — песочницу, данные которой Pinterest не использует в отчётах и оптимизации.

ID пикселя и токен используются для запроса и не сохраняются и не логируются нашим сервером.

Где взять ID и токен?

Укажите код, затем проверьте результат в Events Manager → Test events.
Если пусто — события уходят без источника-сайта (offline/chat).
События 0/5 До 5 штук. События, требующие суммы, уходят с value = 1 USD.

1 239 событий отправлено через сервис

Что Way2 Pixel отправляет в Pinterest?

Way2 Pixel (Pixel Activator) отправляет запрос на api.pinterest.com/v5/ad_accounts/{ad_account_id}/events и добавляет ?test=true при включённом тестовом режиме. Токен конверсий уходит в заголовке Authorization: Bearer только для этого вызова и нашим сервером не сохраняется.

Названия событий Pinterest — строчные через подчёркивание: page_visit, add_to_cart, checkout; своё событие уходит как event_name custom.

ПолеЧто отправляет инструментПримечание
event_name Выбранное событие, например checkout Свои события уходят как custom
event_time Текущее время Unix в секундах
event_id {event}_{time}_{random} Новый для каждого события
action_source web, если указан URL источника, offline — если нет
event_source_url URL из формы Только если заполнен
user_data client_ip_address и client_user_agent Без хешированных email и телефона
custom_data value: "1", currency: USD Только checkout; Pinterest принимает value строкой

Поддерживаемые события

События с пометкой $1 уходят с суммой 1 USD. Можно добавить и одно своё событие: латиница, цифры и подчёркивание, до 50 символов.

Как работает тестовый режим Pinterest?

Pinterest включает песочницу query-параметром test=true. Галочка «Тестовый режим» его добавляет: события проверяются и видны как тестовые, но Pinterest не использует их в отчётах и оптимизации.

Из тестового пакета Pinterest обрабатывает только первые двадцать событий. Эта форма отправляет не больше пяти, так что ограничение здесь не срабатывает.

Где увидеть результат в Pinterest?

  1. Ответ 200 или 201 без полей ошибки значит, что Pinterest принял события.
  2. Откройте Pinterest Ads Manager того же рекламного аккаунта.
  3. Перейдите в Conversions > Test events для событий песочницы или в обзор конверсий для живых.
  4. Исправьте предупреждения о названии события или параметрах до отправки боевого трафика.

Где взять ID рекламного аккаунта и токен конверсий?

В Pinterest Ads Manager откройте Ad Account Overview > Conversions > Conversions API > Set up API, выберите Conversion access token и сгенерируйте его. ID рекламного аккаунта показан на том же экране. Личный OAuth-токен без нужных прав не подойдёт.

Настройка Pinterest Conversions API: ID аккаунта и токен конверсий

Ошибки Pinterest в этом инструменте

Что вы видитеВероятная причинаЧто сделать
HTTP 401 или 403 Токен конверсий неверный, отозван или не имеет доступа к аккаунту Сгенерируйте новый токен конверсий для этого рекламного аккаунта
HTTP 404 или сообщение про ad account Вместо ID рекламного аккаунта введён ID тега или другой номер Скопируйте ID аккаунта с экрана настройки Conversions API
Предупреждение о названии события Событие не входит в стандартные названия Pinterest Выберите событие из списка или отправьте его как custom
HTTP 429 Достигнут лимит запросов Сделайте паузу и попробуйте ещё раз

Коды ошибок Pinterest Conversions API

Частые вопросы

Почему Pinterest просит ID рекламного аккаунта, а не пикселя?

Conversions API v5 принимает события на эндпоинт рекламного аккаунта, поэтому для Pinterest поле формы называется «ID рекламного аккаунта».

Влияет ли test=true на отчёты?

Нет. События песочницы не попадают в отчёты и оптимизацию; чтобы записать настоящие конверсии, отправляйте без тестового режима.

Почему value "1" строкой?

Pinterest v5 принимает value как строку, поэтому checkout уходит с value "1" и currency USD.

Какие события Pinterest поддерживаются?

page_visit, view_category, search, add_to_cart, signup, lead, watch_video и checkout, а также custom.
Бесплатная тестовая форма
Без аккаунта и карты; ограничения на запросы действуют.
Без регистрации
Ничего не нужно создавать. Открыл и отправил.
Сервер не хранит токен
Токен используется для запроса и не сохраняется нашим сервером.
Нужна постоянная передача конверсий?
Most помогает сопоставлять и направлять события из подключённых источников в рекламные системы. Обсудите свою схему в Telegram.
Что делает Most →
Написать в Telegram

Обновлено: 2026-10-14