Pinterest Conversions API за Shopify: ръководство за настройка

Pinterest Conversions API е начинът на Pinterest за изпращане на събития за конверсия от сървър към сървър. Вашият магазин или инструмент като ROASaurus изпраща събития като покупки направо към вашия рекламен акаунт в Pinterest, вместо да разчита само на Pinterest Tag в браузъра на купувача. Pinterest използва данните за отчитане на конверсиите, оптимизация на кампании и таргетиране.

Това ръководство обхваща API v5 и събитията, които приема, click ID epik, как се хешират данните за клиента, как работи дедупликацията с Pinterest Tag, как да тествате и как да настроите всичко в Shopify.

Какво е Pinterest Conversions API?

Pinterest Tag е скрипт в браузъра на купувача. Conversions API върши същата работа от сървър. В API версия 5 изпращате събития към endpoint за събития на вашия рекламен акаунт, като заявката се упълномощава с токен за достъп за конверсии, който създавате в Pinterest Ads Manager. Всяко събитие казва къде се е случило: за онлайн магазин източникът на действието е web.

Pinterest моли рекламодателите, които използват и Tag, да избягват двойното отчитане на конверсия, като подават event_id с всяко събитие. Моли и за събития в реално време или най-късно един час след като се случат.

В Shopify връзката от страна на сървъра има едно ясно предимство: покупките идват от самата поръчка. Shopify съобщава за всяка платена поръчка на ROASaurus чрез webhook, а ROASaurus я изпраща към Pinterest скоро след плащането, независимо дали Tag е сработил в браузъра. Ръководството за проследяване от страна на сървъра в Shopify обяснява идеята по-подробно.

Кои събития приема Pinterest Conversions API?

Pinterest има фиксиран списък със стандартни имена на събития, записани с малки букви и долни черти, като page_visit, add_to_cart и checkout. Можете да определите и до 15 персонализирани типа събития на рекламодател. ROASaurus съпоставя петте събития за пазаруване в Shopify така:

Името може да обърка. Checkout в Pinterest е завършената покупка, а не началото на плащането. Началото на плащането е отделно събитие, initiate_checkout.

За събитието checkout Pinterest препоръчва да се изпращат стойността, валутата, ID на поръчката, ID на съдържанието и броят артикули. ROASaurus изпраща и петте, плюс количеството и цената на всеки артикул. Pinterest иска стойността преди данък и доставка. В Shopify ROASaurus изпраща точно това: общата сума на поръчката минус данък и доставка, от сървъра и от тага в браузъра. Когато платформата на онлайн магазина не отчита данъка и доставката поотделно, ROASaurus изпраща общата сума на поръчката.

Как Pinterest съпоставя събитие с човек?

Всяко събитие носи потребителски данни. Pinterest изисква поне едно от три неща: хеширан имейл адрес, хеширан мобилен рекламен идентификатор или IP адрес заедно с user agent. Онлайн магазинът няма рекламен идентификатор, затова му трябва имейлът или IP адресът с user agent. ROASaurus пропуска събитие, което няма нито едното, нито другото, вместо да изпраща такова, което Pinterest не може да използва.

Click ID epik

Click ID на Pinterest може да дойде от две места: параметър epik в URL адреса на целевата страница или бисквитката _epik във вашия домейн. Ръководството на Pinterest за API препоръчва да се подава стойността на бисквитката _epik, защото тя работи и когато параметърът в URL адреса липсва или е премахнат, което дава по-добро покритие.

ROASaurus чете и двете във вашата витрина, като използва параметъра от URL адреса, когато ново кликване донесе такъв, а в противен случай бисквитката. Запазва click ID при посетителя и го изпраща в полето click_id на всяко събитие от сървъра, включително при покупката. Посещенията с epik се броят като посещения от Pinterest в отчетите за атрибуция на ROASaurus.

POST https://api.pinterest.com/v5/ad_accounts/549755885175/events

{
  "data": [{
    "event_name": "checkout",
    "action_source": "web",
    "event_time": 1793016000,
    "event_id": "order-5512345678901",
    "event_source_url": "https://example-store.com/checkouts/…/thank-you",
    "user_data": {
      "em": ["a3f1…9c2e"],
      "ph": ["7b40…11d8"],
      "external_id": ["e05c…4a7f"],
      "client_ip_address": "203.0.113.24",
      "client_user_agent": "Mozilla/5.0 (iPhone; …)",
      "click_id": "dj0yJnU9…"
    },
    "custom_data": {
      "currency": "USD",
      "value": "84",
      "order_id": "5512345678901",
      "content_ids": ["44123456789"],
      "contents": [{ "id": "44123456789", "quantity": 2, "item_price": "42" }],
      "num_items": 2
    }
  }]
}

Как работи дедупликацията с Pinterest Tag?

Ако Tag и API отчетат покупка, Pinterest получава две събития за една поръчка. За да ги третира като едно, са му нужни еднакви ID-та от двете страни: ID на събитието в Tag трябва да съвпада с event_id в събитието от сървъра. Pinterest запазва първото получено събитие и премахва дубликатите, които пристигат в рамките на 48 часа.

ROASaurus изгражда ID на покупката от ID на поръчката в Shopify. Покупката от поръчка 5512345678901 има ID на събитието order-5512345678901, както в Tag, който се задейства при плащането, така и в събитието от сървъра.

И петте събития се дедуплицират

Всяко събитие при пазаруване в ROASaurus има едно ID на събитието, което се използва от Tag в браузъра и от събитието от сървъра. Tag използва собствените имена на Pinterest за същите събития: pagevisit, viewcontent, addtocart, initiatecheckout и checkout, които съответстват на page_visit, view_content, add_to_cart, initiate_checkout и checkout в API. Така когато работят и двете, Pinterest запазва по едно копие на всяко посещение на страница, преглед на продукт, добавяне в количката, започване на плащане и покупка.

Можете да го пуснете по два начина:

• Tag и Conversions API заедно. Tag добавя сигнали от браузъра, сървърът допълва онова, което Tag пропуска, а Pinterest обединява копията.
• Пуснете API без Tag. Оставете Tag ID празно или изключете Also load the browser tag. Тогава всяко събитие се изпраща по веднъж, само от сървъра.

Помощната статия за двойното отчитане обхваща същите проверки за другите рекламни платформи.

Как се тества Pinterest Conversions API?

API има тестов флаг. Заявките, изпратени с test=true, отиват в sandbox: Pinterest ги обработва като тестови данни и не ги използва за отчитане или оптимизация.

1. Включете тестовия режим

   В ROASaurus редактирайте пиксела за Pinterest под Tracking & platforms и отметнете Test mode (events show under Test events, max 20). Тогава всяко събитие от сървъра се изпраща с test=true. Pinterest обработва най-много 20 тестови събития на пакет.

2. Направете тестова поръчка

   Посетете магазина си, разгледайте продукт, добавете го в количката и завършете поръчка.

3. Прочетете резултата

   Отворете Event log. Pinterest може да отговори с HTTP 200, докато едно събитие в заявката е неуспешно, затова ROASaurus проверява статуса на всяко събитие и показва неуспехите там.

4. Изключете тестовия режим

   Махнете отметката от тестовия режим, за да се броят събитията в отчитането и оптимизацията.

5. Проверете Events Overview

   В Pinterest Ads Manager отворете страницата Events Overview. Тя показва събитията, които пристигат, и дедупликираните конверсии. Pinterest препоръчва да се стремите към Good Event Quality Score.

Как да настроите Pinterest Conversions API в Shopify с ROASaurus

Нужен ви е магазин в Shopify с приложението на ROASaurus и достъп до Pinterest Ads Manager. Страницата за интеграция с Pinterest изброява всяко поле, което изпраща ROASaurus.

1. Свържете магазина си в Shopify

   Отидете в Add a store › Shopify, кликнете върху Install app и включете вграждането на приложението ROASaurus в редактора на темата. То улавя epik и бисквитката _epik на всяка страница. Ръководството за настройка на Shopify показва всяка стъпка.

2. Създайте токен за достъп за конверсии

   В Pinterest Ads Manager отидете в Conversions и създайте токен за достъп за конверсии. Запишете ID на рекламния си акаунт.

3. Добавете пиксела за Pinterest в ROASaurus

   Отидете в Tracking & platforms, кликнете върху Add pixel в картата на Pinterest и попълнете Ad account ID и Conversion access token.

4. Добавете Tag ID

   За дедупликация с Tag попълнете Pinterest Tag ID и оставете отметнато Also load the browser tag. Без Tag ID ROASaurus изпраща само събития от сървъра и не зарежда Tag.

5. Добавете пиксела за страницата за плащане

   В Shopify admin › Settings › Customer events добавете персонализиран пиксел с име ROASaurus и поставете кодовия фрагмент от страницата си Tracking & platforms. Той задейства събитието checkout на Tag в страницата за плащане на Shopify, с ID на поръчката като event_id.

6. Изберете събития от сървъра, после тествайте

   Изберете събитията от сървъра, които искате, и тествайте с тестов режим, преди да започнете на живо.

При включена опция Respect visitor consent, която е по подразбиране, ROASaurus следва избора на купувача в банера за бисквитки на Shopify. Когато купувач откаже маркетинговите бисквитки, ROASaurus не зарежда Pinterest Tag за него, не задава ID на посетителя, така че кликванията му не се свързват с него, и не изпраща събитията му от разглеждането към Pinterest. Платената му поръчка пак се изпраща към Conversions API от сървъра, с хеширани данни от поръчката и с IP адреса и user agent на поръчката, но без click ID. Ръководството за съгласието и поверителността обяснява какво се запазва и изпраща.

Свържете рекламния си акаунт в Pinterest в Setup › Ad spend и ROASaurus изтегля разходите по кампании всеки час, така че виждате ROAS на Pinterest и печалбата след реклами в анализа на печалбата. Ръководството за TikTok Events API описва същата настройка за TikTok, където всяко събитие, което минава и по двата пътя, се дедуплицира.

Източници

1. Pinterest Developers: Track conversion events in the API
2. Pinterest Business help: The Pinterest Conversions API
3. Pinterest Developers: Track conversions with Pinterest Tag

В ROASaurus

• Интеграция с Pinterest
• Проследяване от страна на сървъра в ROASaurus
• Помощ: избягване на двойно отчитане

Продължете да четете