Перед настройкой обработки дублей разберитесь, для чего нужен идентификатор события event_id.
Читайте также: учётные данные Meta, TikTok Events API, дедупликация, настройка Pinterest Conversions API и полное руководство по Pinterest Conversions API.
Что даёт отправка событий Pinterest Conversions API?
Ad account ID обозначает рекламный аккаунт. Не путайте его с именем профиля, Pin ID, campaign ID или Tag ID.
Где взять ID аккаунта и токен?
- Откройте Pinterest Ads Manager.
- Выберите Ad Account Overview > Conversions > Conversions API > Set up API.
- Выберите Conversion access token и создайте токен.
- Скопируйте токен и показанный ad account ID. Сохраните токен в защищённом хранилище.
Токен OAuth нужен, когда вы обращаетесь и к другим методам Pinterest API. Для них должны быть выданы соответствующие разрешения.
Личный токен, не связанный с нужным рекламным аккаунтом, не подтверждает доступ к нему.
Какое событие Pinterest выбрать?
| Действие | Типичный Pinterest event | Контекст |
|---|---|---|
| Просмотр товара/категории | view_category или page_visit | ID товара или страницы |
| Добавление товара | add_to_cart | Товар и количество |
| Checkout завершён | checkout | Order ID, value и currency |
| Регистрация по email | signup или supported equivalent | Только после создания регистрации |
Pinterest отклоняет неподдерживаемые названия событий. Используйте документированные события API, например view_category, page_visit или checkout, вместо названий из других систем.
Как провести тест Pinterest?
- Введите ad account ID и токен конверсий.
- Выберите одно поддерживаемое событие.
- Включите тестовый режим в Pixel Activator, если он доступен.
- Откройте Campaign manager > Conversions > Test events.
- Исправьте предупреждения о названии события или параметрах до отправки рабочих данных.
В тестовом пакете Pinterest обрабатывает только первые двадцать событий. Начните с одного, чтобы проще разобрать результат. Ответ песочницы не подтверждает доставку рабочих конверсий или их атрибуцию.
Как работает дедупликация Pinterest?
Уникальный номер заказа можно использовать как общий ID. Для других событий создавайте ID в момент действия и передавайте его без изменений через браузер и сервер. Подробнее об этом в статье про дедупликацию.
Какие проверки качества важны?
Передавайте достоверные идентификаторы для сопоставления и данные, относящиеся к выбранному событию. Убедитесь, что у вас есть основание для их обработки.
Частые ошибки Pinterest CAPI
| Ошибка | Последствие | Исправление |
|---|---|---|
| ID кампании вместо ID рекламного аккаунта | Событие не попадёт в нужный аккаунт | Скопируйте ad account ID рядом с токеном конверсий |
| Неподдерживаемое название | Pinterest вернёт ошибку названия события | Выберите название из официального списка |
| Один ID для разных покупок | Разные заказы могут объединиться | Передавайте уникальный ID заказа |
| Разные ID у тега и CAPI | Действие может быть учтено дважды | Передавайте одинаковые ID и название события |
Что проверить до запуска?
- Выбран правильный рекламный аккаунт Pinterest.
- Токен конверсий хранится в защищённом месте.
- Поддерживаемое событие соответствует реальному действию.
- Если тестовый режим доступен, его событие видно в Ads Manager; рабочую доставку и атрибуцию проверяют отдельно.
- У каждого действия уникальный ID, у его повторных отправок общий ID.
Тестовое событие Pinterest не появляется?
Нужна помощь с тестовым режимом или отклонённым событием? Пришлите текст ошибки либо скриншот без персональных данных и секретов. Первая консультация бесплатная.
Не отправляйте пароли и API-токены.
Источники
Sources
Проверьте события конверсий Pinterest