Коды событий позволяют отслеживать влияние рекламных объявлений Pinterest на определенные действия на сайте. Их используют для запуска кампаний с автоматической оптимизацией конкретных событий, например для кампаний по увеличению конверсии или объявлений с динамическим ретаргетингом. Коды событий также понадобятся, чтобы
После добавления
В таблице ниже показаны события, которые можно отслеживать с помощью тега Pinterest. Их можно использовать, чтобы
Событие | Назначение |
---|---|
Checkout | Отслеживание пользователей, которые осуществляют транзакции. |
AddToCart | Отслеживание пользователей, которые добавляют товары в корзину. |
Pagevisit | Отслеживание пользователей, которые просматривают целевые страницы, например страницы с товарами или статьями. |
Signup | Отслеживание пользователей, которые подписываются на ваш товар или услугу. |
WatchVideo | Отслеживание пользователей, которые просматривают видео. |
Lead | Отслеживание пользователей, которые проявляют интерес к вашему товару или услуге. |
Поиск | Отслеживание пользователей, которые ищут определенные товары или адреса магазинов на вашем веб-сайте. |
ViewCategory | Отслеживание пользователей, которые просматривают страницы категорий. |
Custom | Отслеживание другого события. Это название можно использовать для особого события, которое вы хотите отслеживать и видеть в отчетах о конверсии. |
[User-defined event] | Вы можете задать и добавить любые другие события, которые необходимы для таргетинга аудитории. Уникальные события не будут представлены в отчетах о конверсии. Помните, что при передаче через тег из их названий будут удалены пробелы. |
Для каждого типа рекламной кампании существует свой набор обязательных и рекомендуемых событий.
Тип кампании | Обязательные события | Рекомендуемые события | Данные обязательных событий | Данные рекомендуемых событий |
---|---|---|---|---|
Узнаваемость бренда | Нет |
|
Нет | Внутреннее соответствие |
Продажи из каталога |
|
|
|
|
Рассмотрение | Нет |
|
Нет | Внутреннее соответствие |
Конверсия |
Хотя бы один из приведенных ниже вариантов:
|
|
Нет |
|
Просмотры видео | Нет | Нет | Нет | Внутреннее соответствие |
Для каждого типа функции существует свой набор обязательных и рекомендуемых событий.
Функция | Обязательные события | Рекомендуемые события | Данные обязательных событий | Данные рекомендуемых событий |
---|---|---|---|---|
Показатели конверсии |
|
Нет | currency | Нет |
Программа подтверждения продавцов (VMP) |
|
Нет | currency | Нет |
Динамический ретаргетинг |
|
Нет |
|
Нет |
Если вы решили настроить тег вручную, вам потребуется самостоятельно добавить коды событий на свой веб-сайт. Ниже приведены инструкции для пользователей, использующих ручную настройку.
- Выполните вход в бизнес-аккаунт Pinterest в браузере компьютера.
- Нажмите
значок гамбургера в левом верхнем углу страницы. - В разделе Бизнес нажмите Конверсии.
- Нажмите Начать.
- Выберите Только тег Pinterest и нажмите Продолжить.
- Нажмите Пропустить в правом нижнем углу экрана.
- Нажмите Перейти к настройке вручную.
- Скопируйте базовый код и нажмите Продолжить.
- Выберите, нужно ли включить автоматическое внутреннее соответствие, и нажмите Продолжить.
- Нажмите Копировать код под серым полем рядом с кодом события, который вы хотите добавить.
- Откройте код страницы веб-сайта, на которой нужно отслеживать событие.
- Вставьте код события на страницу, на которой оно должно произойти, и замените приведенные в примерах значения на соответствующие значения для своего веб-сайта. Событие будет срабатывать каждый раз при загрузке страницы.
- Нажмите Готово.
Примечание. Если событие должно срабатывать только после того, как пользователь выполнит на странице определенное действие, например нажмет кнопку или отправит форму, убедитесь, что код события выполняется только в результате этого действия. Для этого вы должны понимать, какие обработчики событий используются в JavaScript-коде вашей страницы.
Вы можете предоставить дополнительную информацию о событии, прикрепив объект, содержащий данные о нем. Для таргетинга аудитории доступны все данные о событиях, однако в отчетах о платных и органических конверсиях для событий будут отображаться только value (ценность) и order_quantity (количество).
Данные о событии | Пример значения | Тип |
---|---|---|
value | 100,00 | Число (целое или с плавающей запятой) |
event_id | eventId0001 |
Строка (уникальный идентификатор события) Примечание. Для этого идентификатора можно использовать любое из следующих названий полей (все чувствительны к регистру): |
order_quantity | 1 | Целое число |
order_id | 1234OrderID | Строка (order_id требуется для создания отчета об анализе конверсии) |
product_name | Parker Boots | Массив line_items, строка |
product_id | 1414 | Массив line_items, строка |
product_category | Обувь | Массив line_items, строка |
product_variant_id | 1414-Red | Массив line_items, строка |
product_variant | Red | Массив line_items, строка |
product_price | 99,99 | Число (целое или с плавающей запятой), массив line_items, строка |
product_quantity | 1 | Целое число, массив line_items, строка |
product_brand | Parker | Массив line_items, строка |
promo_code | WINTER10 | Строка |
property | Athleta | Строка |
search_query | ботинки | Строка |
video_title | Как подобрать ботинки Parker Boots под свой стиль | Строка |
lead_type | Новостная рассылка | Строка |
currency | USD |
Одна из следующих валют: AED, AMD, ARS, AUD, AZN, BAM, BGN, BHD, BMD, BND, BOB, BRL, BSD, CAD, CHF, CLP, CNY, COP, CRC, CZK, DKK, DOP, EGP, EUR, FJD, GBP, GEL, GIP, HKD, HNL, HRK, HUF, IDR, ILS, INR, ISK, JMD, JPY, KGS, KRW, KWD, KZT, MAD, MDL, MOP, MXN, MYR, NOK, NZD, OMR, PAB, PEN, PHP, PKR, PLN, QAR, RON, RSD, RUB, SAR, SEK, SGD, THB, TRY, TWD, UAH, USD, UYU, VND or ZAR. Примечание. Когда вы указываете валюту с событием тега, мы рассчитываем курс обмена в соответствии с валютой аккаунта рекламодателя. |
Тег IMG — это фрагмент кода в теге Pinterest, который используется в качестве запасного варианта в тех случаях, когда в браузерах пользователей отключен JavaScript. Рекомендуем включать данные о событиях еще и в тег IMG, поскольку это позволит добиться более точного таргетинга. Вы можете использовать только тег IMG без тега JavaScript, но тогда нужно будет
Ниже приведены примеры событий всех типов. Вы можете скопировать их и вставить на свой веб-сайт. Не забудьте заменить приведенные в примерах значения динамическими переменными, актуальными для вашего веб-сайта.
Checkout
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=checkout&ed[event_id]=YOUR_EVENT_ID&ed[value]=10.00&ed[order_quantity]=2&noscript=1" />
Данные о событии: event_id, value, order_quantity и currency.
Обязательно укажите правильный код валюты для своего веб-сайта.
AddToCart
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=AddToCart&ed[value]=10.00&ed[order_quantity]=2&noscript=1" />
Данные о событии: value, order_quantity и currency.
Обязательно укажите правильный код валюты для своего веб-сайта.
Pagevisit
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=pagevisit&noscript=1" />
Данные о событии: нет.
Signup
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=signup&noscript=1" />
Данные о событии: нет.
WatchVideo
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=watchvideo&ed[video_title]=My+Product+Video+01&noscript=1" />
Данные о событии: video_title
Lead
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=lead&ed[lead_type]=Newsletter&noscript=1" />
Данные о событии: lead_type.
Поиск
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=search&ed[search_query]=horse&noscript=1" />
Данные о событии: search_query
ViewCategory
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=viewcategory&noscript=1" />
Данные о событии: нет.
Custom
Если вы хотите отслеживать событие, которого нет в этом списке, назовите его custom, иначе зафиксированные тегом конверсии не будут отображены в отчетах менеджера объявлений.
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=custom&noscript=1" />
Данные о событии: нет.
Значения value (ценность) и order_quantity (количество) — это данные о событиях, которые представлены в отчетах о платных и органических конверсиях. Для них можно настроить динамическую передачу. Динамическое значение может меняться в зависимости от действий, выполняемых на вашем сайте. Передача value и order_quantity даст вам возможность собирать уникальные для вашего веб-сайта сведения, которые к тому же будут согласованы с вашей системой регистрации продаж. Ведь, как правило, ценность и количество товаров меняются от заказа к заказу.
<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>
Ценность в отчете: динамически изменяемая сумма покупки в соответствующем событии checkout.
Количество в отчете: динамически изменяемое количество товаров в соответствующем событии checkout.
Примечание. Настройка динамических значений количества и ценности уникальна для веб-сайта.
Помимо данных о событии можно передавать функцию обратного вызова JavaScript как необязательный аргумент функции pintrk(). Если тег будет выдавать ошибку, эта функция предоставит дополнительную информацию, которую можно будет проверить в инструменте разработчика. Функция обратного вызова выполняется каждый раз, когда срабатывает вызов для отслеживания события, то есть функция pintrk().
Функция обратного вызова принимает два следующих аргумента:
function(didInit, error) {}
didInit: это первый аргумент, который принимает логическое значение true, если вызов для отслеживания события происходит успешно, и false, если при вызове обнаруживается ошибка.
error: это второй аргумент, принимает строковое значение, описывающее ошибку, когда аргумент didInit возвращает значение false; если аргумент didInit имеет значение true, эта строка будет неопределена.
<script>
pintrk('track', 'checkout', {
value: 10.00,
order_quantity: 2,
currency: 'USD',
event_id: 'eventId0001',
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>
Чтобы начать отслеживание конверсии и формирование отчетов, в коде события нужно обозначить один из девяти типов событий. Вы также должны заменить YOUR_TAG_ID на ID тега конверсии Pinterest. Вы можете включить в код каждого события любую комбинацию данных о нем, не ограничиваясь данными из примеров.
В этом разделе представлены готовые примеры кода для событий каждого типа, и вы можете скопировать их на свой сайт. В каждом примере содержатся все необходимые данные о событии, чтобы вы могли начать отслеживание действий пользователей на своем веб-сайте. Не забудьте заменить приведенные в примерах значения на статические значения или динамические переменные, актуальные для вашего веб-сайта. Вероятно, вы захотите отслеживать ценность заказа динамически, потому что ценность каждого оформленного на вашем веб-сайте заказа будет разной в зависимости от того, что покупает пользователь. Однако для категории данных lead_type, например, будет лучше назначить статическое значение при размещении на одной конкретной странице.
Checkout
<script>
pintrk('track', 'checkout', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Данные о событии: value, order_quantity, currency и event_id.
Обязательно укажите правильный код валюты для своего веб-сайта.
AddToCart
<script>
pintrk('track', 'addtocart', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Данные о событии: value, order_quantity и currency.
Обязательно укажите правильный код валюты для своего веб-сайта.
Pagevisit
<script>
pintrk('track', 'pagevisit', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Signup
<script>
pintrk('track', 'signup', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
WatchVideo
<script>
pintrk('track', 'watchvideo', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Данные о событии: Video_title.
Lead
<script>
pintrk('track', 'lead', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Данные о событии: lead_type.
Поиск
<script>
pintrk('track', 'search', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Данные о событии: search_query
ViewCategory
<script>
pintrk('track', 'viewcategory', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
User-defined events
<script>
pintrk('track', 'user_defined_event_name', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Custom
Если вы хотите отслеживать событие, которого нет в этом списке, назовите его custom, иначе зафиксированные тегом конверсии не будут отображены в отчетах менеджера объявлений.
<script>
pintrk('track', 'custom', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Ниже приведено несколько примеров базового кода, скомбинированного с кодами событий. Важно помнить, что на веб-сайте код события всегда должен размещаться после базового кода.
Пример ID тега конверсии: 123456789 (замените на свой ID тега конверсии Pinterest)
Пример кода события: PageVisit
<head>
<script type="text/javascript">
!function(e){if(!window.pintrk){window.pintrk=function(){window.pintrk.queue.push(
Array.prototype.slice.call(arguments))};var
n=window.pintrk;n.queue=[],n.version="3.0";var
t=document.createElement("script");t.async=!0,t.src=e;var
r=document.getElementsByTagName("script")[0];r.parentNode.insertBefore(t,r)}}
("https://s.pinimg.com/ct/core.js"); pintrk('load', '123456789'); pintrk('page');
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&noscript=1" />
</noscript>
<script>
pintrk('track', 'pagevisit');
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=pagevisit&noscript=1" />
</noscript>
</head>
Пример ID тега конверсии: 123456789 (замените на свой ID тега конверсии Pinterest)
Пример кодов событий: PageVisit и AddToCart
<head>
<script type="text/javascript">
!function(e){if(!window.pintrk){window.pintrk=function(){window.pintrk.queue.push(
Array.prototype.slice.call(arguments))};var
n=window.pintrk;n.queue=[],n.version="3.0";var
t=document.createElement("script");t.async=!0,t.src=e;var
r=document.getElementsByTagName("script")[0];r.parentNode.insertBefore(t,r)}}
("https://s.pinimg.com/ct/core.js"); pintrk('load', '123456789'); pintrk('page');
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&noscript=1" />
</noscript>
<script>
pintrk('track', 'pagevisit');
pintrk('track', 'addtocart');
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=pagevisit&noscript=1" />
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=addtocart&noscript=1" />
</noscript>
</head>