Код події

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

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

Подія

Мета

Формування аудиторії

Звітність про конверсію

Checkout

Відстеження завершення транзакцій.

AddToCart

Відстеження додавання товарів до кошика.

PageVisit

Відстеження переглядів основних сторінок, як-от сторінок товарів чи статей.

Signup

Відстеження реєстрації на товар або послугу.

WatchVideo

Відстеження переглядів відео.

Lead

Відстеження зацікавленості в товарі чи послузі.

Search

Відстеження пошукових запитів на сайті (як-от пошук конкретного товару чи місцезнаходження магазину).

ViewCategory

Відстеження переглядів сторінок категорій.

Custom

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

[User-defined event]

Створіть будь-яку додаткову подію для таргетингу своєї аудиторії. Унікальні події не включаються в звітність про конверсію. Пам’ятайте, що пробіли в назві події буде видалено після додавання до тегу.

 

Розміщення

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

Наприклад, ви хочете відстежувати успішні оформлення замовлення. Для цього між тегами <head> і </head> на сторінці підтвердження замовлення розмістіть базовий код, а після нього — код події Checkout. Таке розміщення кодів гарантує їхню успішну роботу після завантаження сторінки.

З іншого боку, якщо подія відбувається лише після певної дії користувача на сторінці (наприклад, натискання кнопки або надсилання форми), потрібно переконатися, що код події спрацьовує лише в результаті цієї дії. Для цього необхідно розуміти принцип дії наявних обробників подій у коді JavaScript на вашій сторінці.

Дані про події

Ви можете надати додаткову інформацію про подію, прикріпивши об'єкт, що містить дані про неї.

Зверніть увагу на те, що наразі у звітах про конверсію доступні дані лише двох подій: value і order_quantity. Будь-які додаткові дані про події можна використовувати для таргетингу аудиторії, але вони недоступні для звітності про конверсію.

Значення мають передаватися з відповідним кодом валюти. Ми перетворимо значення конверсії у звітах служби управління рекламою у валюту відповідно до вашого облікового запису, використовуючи обмінний курс між кодом валюти у тегу конверсії та валютою вашого облікового запису.

Дані про події

Зразок

Тип

Формування аудиторії

Звітність про конверсію

value

100,00

Число (ціле або з рухомою комою)

order_quantity

1

Ціле число

currency

USD

Один із варіантів: USD, GBP, CAD, EUR, AUD або NZD

 

product_name

Черевики Parker

Масив line_items

 

product_id

1414

Масив line_items

 

product_category

Взуття

Масив line_items

 

product_variant_id

1414-Червоний

Масив line_items

 

product_variant

Червоний

Масив line_items

 

product_price

99,99

Число (ціле або з рухомою комою), масив позицій

 

product_quantity

1

Ціле число, масив line_items

 

product_brand

Parker

Масив line_items

 

promo_code

WINTER10

Рядок

 

property

Athleta

Рядок

 

search_query

черевики

Рядок

 

video_title

Як зробити черевики Parker частиною вашого стилю

Рядок

 

lead_type

Розсилка

Рядок

 

 

Наведений нижче приклад коду події відстежує подію Checkout з даними про подію, що описують придбання двох товарів. Зверніть увагу, що цей приклад є частиною коду події JavaScript. У цьому прикладі значення order_quantity (кількість) і value (вартість) статичні, але вам може знадобитися зробити їх динамічними.

Приклади динамічних подій вартості та кількості можна знайти в розділі даних про події вартості та кількості нижче.
 

<script>
 pintrk('track', 'checkout', {
   value: 10.00,
   order_quantity: 2,
   currency: 'USD',
   line_items: [
     {
       product_name: 'Parker Boots',
       product_id: '1414',
       product_price: 5.00,
       product_quantity: 1
     },
     {
       product_name: 'Parker Sandals',
       product_id: 'ABC',
       product_price: 5.00,
       product_quantity: 1
     }
   ]
 });
</script>

Дані про події вартості та кількості

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

Приклад статичних вартості та кількості:

<script>
 pintrk('track', 'checkout', {
   value: 10.00, // Read this value (must be a number)
   order_quantity: 5 // Read this quantity (must be an integer)
 });
</script>
<noscript>
 <img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=checkout&ed[value]=10.00&ed[order_quantity]=5&noscript=1"/>
</noscript>

Повідомлена вартість: 10,00

Повідомена кількість: 5

Приклад динамічних вартості та кількості:

<script>
 pintrk('track', 'checkout', {
   value: {{Enhanced Transaction Revenue}},
   order_quantity: {{item.quantity}}
 });
</script>
<noscript>
 <img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=checkout&ed[value]={{Enhanced Transaction Revenue}}&ed[order_quantity]={{item.quantity}}&noscript=1" />
</noscript>

Повідомлена вартість: динамічна сума, указана під час оформлення відповідного замовлення.

Повідомлена кількість: динамічна кількість, указана під час оформлення відповідного замовлення.

Зауважте, що налаштування динамічних кількості та вартості замовлення є унікальним для вашого веб-сайту.

Зворотній виклик

Крім даних про подію, ви можете передати функцію зворотного виклику JavaScript як необов’язковий аргумент функції pintrk(). Ця функція зворотного виклику виконується за кожної активації відстеження події функцією pintrk().

Функція зворотного виклику приймає два аргументи:

function(didInit, error) {}
  • didInit: цей аргумент отримує логічне значення, яке встановлюється як істинне, якщо відстеження події успішно розпочато, і як хибне, якщо під час запуску відстеження події виникла помилка.

  • error: цей аргумент отримує рядок з описом помилки, якщо значення аргументу didInit хибне; якщо значення аргументу didInit істинне, цей рядок залишається невизначеним.

Приклад

<script>
 pintrk('track', 'checkout', {
   value: 10.00,
   order_quantity: 2,
   currency: 'USD',
   line_items: [
     {
       product_name: 'Parker Boots',
       product_id: '1414',
       product_price: 5.00,
       product_quantity: 1
     },
     {
       product_name: 'Parker Sandals'
       product_id: 'ABC',
       product_price: 5.00,
       product_quantity: 1
     }
   ]
 }, function(didInit, error) { if (!didInit) { console.log(error); }
 });
</script>

Наступні кроки

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

Потрібна допомога?
Зв’яжіться з нами