Отправка событий Pinterest Conversions API через Pixel Activator
event_idЧитайте также: учётные данные Meta, TikTok Events API, дедупликация.
Что даёт отправка событий Pinterest Conversions API?
Ad account ID - это не profile name, Pin ID, campaign ID и не Tag ID.
Где взять ad account ID и token?
- Откройте Pinterest Ads Manager.
- Выберите Ad Account Overview > Conversions > Conversions API > Set up API.
- Выберите Conversion access token и создайте token.
- Скопируйте token и отображённый ad account ID, token сохраните как secret.
OAuth token нужен, только если вы используете и другие Pinterest API endpoints с нужными scopes.
Не подставляйте личный token, не относящийся к нужному advertiser account: он не подтверждает доступ к выбранному destination.
Какое Pinterest event выбрать?
| Действие | Типичный Pinterest event | Контекст |
|---|---|---|
| Просмотр товара/категории | view_category или page_visit | ID товара или страницы |
| Добавление товара | add_to_cart | Товар и количество |
| Checkout завершён | checkout | Order ID, value и currency |
| Регистрация по email | signup или supported equivalent | Только после создания регистрации |
Pinterest отклоняет неподдерживаемые event names. Используйте официальные события API вроде view_category, page_visit или checkout и не переносите названия из других систем.
Как провести тест Pinterest?
- Введите ad account ID и conversion token.
- Выберите одно поддерживаемое событие.
- Включите test mode в Pixel Activator, если он доступен.
- Откройте Campaign manager > Conversions > Test events.
- Исправьте warning по event name или параметрам до production.
Pinterest обрабатывает только первые двадцать событий в test batch, поэтому первый одиночный test удобнее.
Для разовой проверки доставки события используйте бесплатный Pixel Activator - он отправляет тестовый сигнал за пару минут. Если вам нужна постоянная автоматическая маршрутизация и дедупликация конверсий, настройте Most.
Как работает дедупликация Pinterest?
Уникальный order number подходит как общий ID для заказа. В остальных events создавайте ID в момент действия и передавайте его неизменно по браузерному и серверному путям. См. дедупликацию.
Какие проверки качества важны?
Передавайте только точные matching identifiers и event-specific data, на обработку которых у вас есть основание.
Частые ошибки Pinterest CAPI
| Ошибка | Последствие | Исправление |
|---|---|---|
| Campaign ID вместо destination | Event не попадёт в нужный account | Скопируйте ad account ID рядом с conversion token |
| Неподдерживаемое имя | Pinterest вернёт event-name error | Выберите имя из official list |
| Постоянный purchase ID | Разные заказы могут объединиться | Передавайте уникальный order ID |
| Разные Tag и CAPI IDs | Действие посчитается дважды | Передавайте одинаковые ID и name |
Что проверить до запуска?
- Верный Pinterest ad account ID.
- Conversion token хранится только как secret.
- Supported event соответствует завершённому действию.
- Test event виден в Ads Manager.
- У каждого action уникальный ID, у дублей общий ID.
Sources
Sources
- Ручной тест и валидация: используйте Pixel Activator для бесплатной отправки тестовых событий и проверки параметров до запуска кампании.
- Автоматизация и маршрутизация: подключайте Most для стабильной доставки серверных конверсий с дедупликацией, защитой от сбоев и готовыми интеграциями.