Огляд

API Pinterest для конверсій дає змогу рекламодавцям надсилати конверсії безпосередньо в Pinterest завдяки з’єднанню між серверами. Конверсії, зареєстровані за допомогою API Pinterest, можна використовувати для ретаргетингу в кампаніях і переглядати у звітах про конверсії для кращої видимості конверсії.

Через API Pinterest для конверсій рекламодавці можуть надсилати:

  • Конверсії в Інтернеті
  • Конверсії в додатку
  • Конверсії офлайн
  • Події можна отримувати в режимі реального часу або протягом години після настання та реєстрації події. Події, отримані за межами цього вікна або у вигляді частини затриманої пакетної події, враховуватимуться як конверсії офлайн. 

    Використання API Pinterest для конверсій разом із тегом Pinterest може допомогти максимально збільшити видимість конверсій. Ми рекомендуємо використовувати обидва рішення для реєстрації конверсії з метою забезпечення повного огляду ефективності кампанії зі збільшення конверсії.

    API Pinterest

    API Pinterest для конверсій — це один із кількох продуктів у межах екосистеми API Pinterest. Усі власники корпоративного облікового запису Pinterest можуть користуватися API Pinterest для конверсій, але це не забезпечує автоматичний доступ до ширших функцій API Pinterest. 

    Платформа Pinterest для розробників містить інформацію про всі продукти API Pinterest. 

    Початок роботи

    Усі користувачі із корпоративним обліковим записом Pinterest мають доступ до API Pinterest для конверсій.

    Для початку вам потрібно буде створити маркер доступу. Маркер доступу — це рядок символів, який підтверджує, що запити створюються та надсилаються до правильного облікового запису користувача. 

    Щоб створити маркер доступу: 

  • Увійдіть у свій корпоративний обліковий запис Pinterest
  • Натисніть Рекламні оголошення у верхній частині меню і виберіть Конверсії
  • Виберіть сторінку Маркер доступу до конверсії на панелі навігації зліва
  • Натисніть кнопку Згенерувати новий маркер
  • Скопіюйте новий маркер доступу та поверніться до процесу налаштування.
  • Якщо ви намагаєтеся отримати доступ до облікового запису, який вам не належить, спочатку вам потрібно налаштувати Бізнес-доступ. 

    Впровадження

    Події конверсії: усі типи подій, доступні для реєстрації з використанням тегу Pinterest, також доступні через API Pinterest для конверсій. Повний список подій і докладні відомості про їхню важливість можна знайти в нашій документації для розробників API Pinterest.

    Налаштування інтеграції API з сервера на сервер вимагає від власника сайту розробницьких та інженерних знань. Обсяг технічних зусиль розробника залежатиме від:

  • Знайомство розробника з інтеграцією API. Якщо раніше вони ніколи не займалися інтеграцією з API, їм доведеться над цим попрацювати.  Якщо у вас уже є інші API для конверсій, вашому розробнику потрібно внести лише декілька додаткових змін.
  • Кількості подій, що відстежуються, та на якому етапі конверсії нам буде надіслано дані.
  • Рекламодавець хоче або потребує інтеграції з третьою стороною (напр., Shopify, GTM, Tealium).
  • Якщо ви вже використовуєте тег Pinterest

    Наполегливо радимо використовувати API Pinterest для конверсій разом із тегом Pinterest, щоб максимально збільшити кількість конверсій. 

    Якщо ви попередньо вже налаштували тег Pinterest, вам потрібно буде переконатися, що конверсії не враховуються двічі — один раз із використанням тегу Pinterest і один раз із використанням API. 

    Для цього потрібно переконатися, що разом із конверсіями, зареєстрованими тегом Pinterest і API Pinterest для конверсій, передається параметр event_id. 

    В такому разі наша система розпізнаватиме ідентифікатори event_id як дублікати та зберігатиме тільки перші зареєстровані конверсії. Щоб ця дедуплікація була успішною, ідентифікатори event_id повинні:

  • ідентифікатори event_id повинні бути ідентичними між однаковими конверсіями. Коли користувач переходить на вебсторінку, і тег Pinterest, і API Pinterest запускають конверсію відвідування сторінки. Щоб наша система розпізнала дві конверсії як одну, ці конверсії повинні мати однакові ідентифікатори event_id. 
  • ідентифікатори event_id повинні бути унікальними для різних конверсій. Коли користувач переходить на вебсторінку, і тег Pinterest, і API Pinterest запускають конверсію відвідування сторінки. Потім користувач додає футболку до кошика, що активує подію AddToCart, яка запускається як тегом Pinterest, так і API Pinterest. Хоча ідентифікатори event_id, що запускаються для одних і тих самих подій, мають бути однаковими, ідентифікатори event_id, які надсилаються для події відвідування сторінки та події AddToCart, мають бути унікальними. Таким чином наша система розпізнаватиме їх як окремі події.
  • На основі цього ідентифікатора події та event_name Pinterest видалить із запису будь-які повторювані події за умови, що (a) подія не відбулася в автономному режимі (action_source не в автономному режимі) і (b) Pinterest отримає дубльовані події, які відбулися протягом 48-годинного інтервалу.

    Підтвердження налаштування

    Після завершення налаштування API ви можете перевірити, чи надсилаються події конверсії:

  • Коди відповіді: розробник, який налаштовує інтеграцію з API, може переглянути коди відповіді, які надсилаються з кожним запитом, надісланим після запуску конверсії. 
  • Сторінка дедуплікації в службі управління рекламою: конверсії після дедуплікації відображатимуться на сторінці дедуплікації в службі управління рекламою. Щоб перейти на сторінку дедуплікації:
    • Увійдіть у свій корпоративний обліковий запис Pinterest
    • Натисніть Рекламні оголошення у верхній частині меню і виберіть Конверсії
    • Виберіть Дедуплакація на панелі навігації зліва.
  • Якість і стійкість

    Стійкість — це статус налаштування API для конверсій, який дає змогу досягти найвищого рівня відповідності та віднесення сигналів. Ці додаткові дані допоможуть нам надавати точніші звіти, оскільки політика в рекламній індустрії змінюється та розвивається.

    Статус стійкості

    Існують дві категорії статусу стійкості: добрий і низький. Ваш статус стійкості відображається в розділі «Стан конверсій» служби управління рекламою.

    Добрий рівень стійкості

    Варіант 1: охоплення конкретного ідентифікатора

  • Охоплення ідентифікатора
    • 90% або більше подій повинні мати IP/UA, 
    • 10% або більше подій нижнього рівня воронки продажів повинні мати хешовану електронну пошту або MAID, 
    • 10% або більше подій повинні мати зовнішній ідентифікатор.
  • Збіги з даними тегів (якщо це можливо)
    • 90%* або більше подій тегів мають надходити через CAPI 
  • Або:

    Варіант 2: досягнення базового коефіцієнта відповідності

  • Коефіцієнт відповідності користувачів CAPI повинен становити 60% або більше
  • Збіги з даними тегів (якщо це можливо)
  • 90%* або більше подій тегів мають надходити через CAPI 


  • Низький рівень стійкості

    Будь-які налаштування, які не відповідають доброму рівню.

    Ідентифікатори стійкості та сигнали

    Щоб досягти статусу стійкого рекламодавця, надішліть наступні сигнали.

    Ідентифікатори/Сигнали API Значимість/Ранг
    client_ip_address + client_user_agent Високий
    em Високий
    external_id Високий
    hashed_maid Високий
    click_id Високий
    fn + ln Низький
    ph Низький
    ge, bd, ct, st, zp, country Низький

    Значення/ранг залежить від ймовірності збільшення частоти виявлення відповідності

    Впровадження зі сторонніми системами

    Pinterest пропонує декілька варіантів інтеграції зі сторонніми системами для підтримки процесу впровадження API. 

    Менеджер тегів Google — серверна сторона

    Щоб оцінити вплив Pinterest на трафік магазину та продажі товарів, підключіть обліковий запис Менеджера тегів Google до API Pinterest для конверсій.

    Ця інтеграція потребує розгортання серверного контейнера за допомогою обраного хмарного сховища та знання тегів серверної сторони. Докладніше про необхідні умови дізнайтеся на сайті розробника

    Shopify;

    Ця інтеграція API Pinterest для конверсій доповнює тег Pinterest, щоб забезпечити високе охоплення та якість даних. Якщо додаток Shopify встановлено, не потрібно робити жодних дій, щоб скористатися перевагами цього розширення. Зміни буде автоматично застосовано до магазину продавця.

    Tealium;

    Рекламодавці, зацікавлені в Tealium, можуть налаштувати API для конверсій безпосередньо у третьої сторони. Tealium створить шаблон і сприятиме інтеграції з рекламодавцем. 

    Процес впровадження коротко описано у Навчальному центрі Tealium. Будь-які запитання щодо впровадження надсилайте на support [at] tealium.com (support[at]tealium[dot]com)

    Якщо вас цікавить будь-яка інтеграція зі сторонніми системами, за додатковою інформацією зверніться до представника служби продажу. 

    Пояснення щодо обмеженої обробки даних

    З 1 січня 2023 року рекламодавці можуть використовувати прапорець обмеженої обробки даних, щоб дотримуватися Закону штату Каліфорнія про конфіденційність споживачів, внесеного до Закону штату Каліфорнія про конфіденційність (разом — CCPA). Якщо ви встановите цей прапорець, Pinterest обмежить використання певних даних, щоб допомогти рекламодавцям дотримуватися налаштувань конфіденційності користувачів. Наприклад, рекламодавець може застосувати прапорець обмеженої обробки даних для користувачів з Каліфорнії, які відмовилися від продажу або обміну своїми даними відповідно до CCPA. Якщо використовується прапорець обмеженої обробки даних, Pinterest буде діяти як постачальник послуг відповідно до CCPA щодо позначених прапорцем даних користувачів у Каліфорнії.

    Рекламодавці несуть відповідальність за дотримання відмов користувачів, а також за визначення штату проживання користувача в разі застосування прапорця обмеженої обробки даних.

    End of Other articles Links
    Потрібна допомога? Зв’яжіться з нами
    User feedback
    Чи була ця стаття корисна?

    collection_fields

    Як ми можемо покращити цю статтю?