Pinterest conversion API

Pinterest нещодавно випустив бета-версію Pinterest Conversion API. Впровадження Pinterest CAPI — це чудовий спосіб підвищити точність відстеження конверсій і, як наслідок, отримати кращу віддачу від інвестицій у платну рекламу.

Ця публікація в блозі пояснює можливості Pinterest CAPI і як працює Pinterest conversion API tag для серверного GTM.

Pinterest conversion API

1. Pinterest рекомендує використовувати відстеження як у браузері, так і на сервері.

2. Підтримує дедуплікацію подій. Щоб видалити дублікати відповідних подій, надісланих із веб та сервера, Pinterest використовує ідентифікатор події.

3. Pinterest CAPI підтримує стандартні та спеціальні події. Список стандартних подій:

• add_to_cart
• checkout
• lead
• page_visit
• search
• signup
• view_category
• watch_video

4. Pinterest CAPI підтримує тестування серверних подій у реальному часі. Коли ви додаєте ?test=true, події позначаються як тести; вони не будуть записані.

5. Подібно FB CAPI, Pinterest просить надіслати дані користувача в хешованому форматі нижнього регістру. Це дані користувачів, які підтримує Pinterest:

• адреси електронної пошти
• номери телефонів
• гендер
• дата дня народження
• прізвище
• ім'я
• місто
• місце проживання
• ЗІП код
• країни ISO-3166
• IP адресу
• User-agent

6. Pinterest CAPI не потребує Access Token. Ви повинні використовувати лише ідентифікатор рекламодавця Pinterest.

7. Разом із подією ви можете надіслати дані про подію та продукт

• Контент. JSON об’єкт, який містить дані про товар, це може бути item_price і quantity
• Валюта ISO-4217 стандарт
• значення
• IDs продуктів
• Num_items. Загальна кількість товарів у події.
• order_id

Як працює тег Pinterest conversion API для GTM на стороні сервера?

Логіка Pinterest CAPI tag від stape схожа на тег Facebook CAPI або TikTok events API. Якщо у вас уже є досвід налаштування цих двох, то Pinterest CAPI буде досить простим.

Event Name Setup Method - виберіть зі списку стандартних подій, додайте спеціальну подію або виберіть Успадкувати назву події від клієнта. Якщо вибрано «Успадкувати від клієнта», тег Pinterest CAPI намагатиметься автоматично зіставити події зі стандартними подіями або використати спеціальну назву, якщо неможливо зіставити події із зірочкою.

Pinterest Advertiser ID - ви можете знайти його, увійшовши в обліковий запис Pinterest, якому належить ваш обліковий запис рекламодавця, а потім перейдіть на сторінку "ads.pinterest.com". У верхньому розділі навігації натисніть «Перегляд: », і ідентифікатор рекламодавця буде номером під іменем рекламного облікового запису в спадному меню. Якщо у вашому обліковому записі Pinterest є кілька рекламних облікових записів, переконайтеся, що ви вибрали правильний, який хочете використовувати для володіння подіями конверсії API. Ще один спосіб підтвердити свій ідентифікатор рекламодавця – перейти до Ads > Overview і знайти ідентифікатор у URL-шляху. Це буде виглядати так: "ads.pinterest.com/advertiser/ADVERTISER_ID/?...".

Test request - події не будуть записані, але API все одно повертатиме ті самі повідомлення відповіді. Використовуйте цей режим, щоб переконатися, що ваші запити працюють і що ваші події створені правильно.

Server Event Data Override - виберіть зі списку кастомних даних.

User Data - виберіть зі списку даних користувача.

Custom Data - виберіть зі списку даних про продукт.

Logs Settings - виберіть, чи хочете ви реєструвати запити до свого облікового запису stape. Ця функція зручна під час налаштування тегів на стороні сервера, оскільки вона дозволяє бачити вхідні та вихідні запити та відповіді мережі.