Добавление кодов событий

Похоже, вы находитесь в регионе, в котором тег Pinterest еще не доступен. Узнайте, в каких странах владельцы аккаунтов Pinterest Business могут использовать тег Pinterest.

Подробнее

Коды событий позволяют отслеживать влияние рекламных объявлений Pinterest на определенные действия на сайте. Их также используют для запуска кампаний с автоматической оптимизацией конкретных событий, например для кампаний по увеличению конверсии или объявлений с динамическим ретаргетингом. Кроме того, коды событий необходимы для доступа к таким разделам, как Показатели конверсии.

После добавления базового кода можно добавить коды событий для отслеживания определенных конверсий на вашем веб-сайте. При этом базовый код должен присутствовать на каждой странице веб-сайта, а коды событий нужно размещать только на тех страницах, где вы хотите отслеживать определенные конверсии. Для рекламных кампаний с разными целями необходимо использовать разные коды событий. Например, покупка, добавление в корзину или регистрация являются обязательными событиями для цели «Конверсия».

Типы кодов событий

В таблице ниже показаны события, которые можно отслеживать с помощью тега Pinterest. Их можно использовать, чтобы создать аудитории для таргетинга объявлений, а затем просматривать отчеты о соответствующих платных или органических конверсиях в менеджере объявлений. Примечание. Отчеты недоступны для событий, заданных пользователями.

Событие	Назначение
Checkout	Отслеживание пользователей, которые осуществляют транзакции.
AddToCart	Отслеживание пользователей, которые добавляют товары в корзину.
Pagevisit	Отслеживание пользователей, которые просматривают целевые страницы, например страницы с товарами или статьями.
Signup	Отслеживание пользователей, которые подписываются на ваш товар или услугу.
WatchVideo	Отслеживание пользователей, которые просматривают видео.
Lead	Отслеживание пользователей, которые проявляют интерес к вашему товару или услуге.
Search	Отслеживание пользователей, которые ищут определенные товары или адреса магазинов на вашем веб-сайте.
ViewCategory	Отслеживание пользователей, которые просматривают страницы категорий.
Custom	Отслеживание другого события. Это название можно использовать для особого события, которое вы хотите отслеживать и видеть в отчетах о конверсии.
[User-defined event]	Вы можете задать и добавить любые другие события, которые необходимы для таргетинга аудитории. Уникальные события не будут представлены в отчетах о конверсии. Помните, что при передаче через тег из их названий будут удалены пробелы.

Необходимо добавить хотя бы одно из следующих событий:

Checkout
AddToCart
Signup
Lead

Необходимо добавить следующие события:

Checkout
Идентификатор товара передается через событие покупки
Ценность и валюта передаются через тег покупки

Для повышения эффективности рекомендуется добавить следующие события:

Pagevisit
AddToCart
Идентификатор товара передается через событие PageVisit (посещение страницы) и AddToCart (добавление в корзину).

Добавление кодов событий на веб-сайт

Если в менеджере объявлений все еще открыто окно, из которого вы копировали базовый код, нажмите кнопку Продолжить в правом нижнем углу поля на экране, чтобы просмотреть все доступные вам варианты, после чего нажмите Скопировать код рядом с событием, которое вы хотите отслеживать.

Если окно не открыто, выполните указанные ниже действия.

Скопируйте код для события, которое вы хотите добавить на свой веб-сайт, из приведенного ниже списка примеров.

Откройте код страницы веб-сайта ,на которой нужно отслеживать событие.

Вставьте код события на страницу после базового кода между тегами <head> и </head>. Обязательно замените все значения из примера соответствующими значениями для своего веб-сайта. Событие будет срабатывать каждый раз при загрузке страницы.

Примечание. Если событие должно срабатывать только после того, как пользователь выполнит на странице определенное действие, например нажмет кнопку или отправит форму, убедитесь, что код события выполняется только в результате этого действия. Для этого вы должны понимать, какие обработчики событий используются в JavaScript-коде вашей страницы.

Добавление данных о событии

Вы можете предоставить дополнительную информацию о событии, прикрепив объект, содержащий данные о нем. Для таргетинга аудитории доступны все данные о событиях, однако в отчетах о платных и органических конверсиях для событий будут отображаться только value (ценность) и order_quantity (количество).

Данные о событии	Пример значения	Тип
value	100,00	Число (целое или с плавающей запятой)
event_id	eventId0001	Строка (уникальный идентификатор события) Примечание. Для этого идентификатора можно использовать любое из следующих названий полей (все чувствительны к регистру): eventID event_id eid
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

Тег IMG — это фрагмент кода в теге Pinterest, который используется в качестве запасного варианта в тех случаях, когда в браузерах пользователей отключен JavaScript. Рекомендуем включать данные о событиях еще и в тег IMG, поскольку это позволит добиться более точного таргетинга. Вы можете использовать только тег IMG без тега JavaScript, но тогда нужно будет удалить из кода теги <noscript>.

 <img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=ИДЕНТИФИКАТОР_ТЕГА&event=checkout&ed[value]=10.00&ed[order_quantity]=2&ed[currency]=RUB&ed[event_id]=ИДЕНТИФИКАТОР_СОБЫТИЯ&ed[line_items][0][product_name]=Ботинки+Parker&[line_items][0][product_id]='1414'&ed[line_items][0][product_price]=5000.00&ed[line_items][0][product_quantity]=1&ed[line_items][1][product_name]=Сандали+Parker&ed[line_items][1][product_id]='ABC'&ed[line_items][1][product_price]=5000.00&ed[line_items][1][product_quantity]=1&noscript=1"/>

Ниже приведены примеры событий всех типов. Вы можете скопировать их и вставить на свой веб-сайт. Не забудьте заменить приведенные в примерах значения динамическими переменными, актуальными для вашего веб-сайта.

Checkout

 <img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=ИДЕНТИФИКАТОР_ТЕГА&event=checkout&ed[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.

Search

 <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 (количество) — это данные о событиях, которые представлены в отчетах о платных и органических конверсиях. Для них можно настроить динамическую передачу. Динамическое значение может меняться в зависимости от действий, выполняемых на вашем сайте. Передача 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

Помимо данных о событии можно передавать функцию обратного вызова 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: 'RUB',
   event_id: 'eventId0001',
   line_items: [
     {
       product_name: 'Ботинки Parker',
       product_id: '1414',
       product_price: 5000.00,
       product_quantity: 1
     },
     {
       product_name: 'Сандали Parker'
       product_id: 'ABC',
       product_price: 5000.00,
       product_quantity: 1
     }
   ]
 }, function(didInit, error) { if (!didInit) { console.log(error); }
 });
</script>

Примеры кодов событий

Чтобы начать отслеживание конверсии и формирование отчетов, в коде события нужно обозначить один из девяти типов событий. Вы также должны заменить YOUR_TAG_ID на ID тега конверсии Pinterest. Вы можете включить в код каждого события любую комбинацию данных о нем, не ограничиваясь данными из примеров.

Pagevisit

<script>
 pintrk('track', 'pagevisit', {
   promo_code: 'WINTER10',
   event_id: 'eventId0001',
 });
</script>

Signup

<script>
 pintrk('track', 'signup', {
   lead_type: 'New release promotion'
 });
</script>

Checkout

<script>
 pintrk('track', 'checkout', {
   value: 116,
   order_quantity: 2,
   currency: 'USD',
   line_items: [
     {
       product_name: 'Pillows (Set of 2)',
       product_id: '11',
       product_price: 48.00,
       product_quantity: 1
     },
     {
       product_name: 'Pillows, Large (Set of 2)',
       product_id: '15',
       product_price: 68.00,
       product_quantity: 1
     },
   ]
 });
</script>

WatchVideo

<script>
 pintrk('track', 'watchVideo', {
   video_title: 'My product video 01'
 });
</script>

Lead

<script>
 pintrk('track', 'lead', {
   lead_type: 'Newsletter'
 });
</script>

В этом разделе представлены готовые примеры кода для событий каждого типа, и вы можете скопировать их на свой сайт. В каждом примере содержатся все необходимые данные о событии, чтобы вы могли начать отслеживание действий пользователей на своем веб-сайте. Не забудьте заменить приведенные в примерах значения на статические значения или динамические переменные, актуальные для вашего веб-сайта. Вероятно, вы захотите отслеживать ценность заказа динамически, потому что ценность каждого оформленного на вашем веб-сайте заказа будет разной в зависимости от того, что покупает пользователь. Однако для категории данных lead_type, например, будет лучше назначить статическое значение при размещении на одной конкретной странице.

Checkout

<script>
pintrk('track', 'checkout', { 
   value: 10.00, 
   order_quantity: 2, 
   currency: 'RUB', 
   event_id: 'eventId0001',
   product_ids: ['1414', '1415'] }
);
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=ИДЕНТИФИКАТОР_ТЕГА&event=checkout&ed[value]=10.00&ed[order_quantity]=2&ed[event_id]=eventId0001&noscript=1" />
</noscript>

Данные о событии: value, order_quantity, currency и event_id.

Обязательно укажите правильный код валюты для своего веб-сайта.

AddToCart

<script>
 pintrk('track', 'AddToCart', {
   value: 10.00,
   order_quantity: 1,
   currency: 'USD'
 });
</script>
<noscript>
 <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" />
</noscript>

Данные о событии: value, order_quantity и currency.

Обязательно укажите правильный код валюты для своего веб-сайта.

Pagevisit

<script>
 pintrk('track', 'pagevisit');
</script>
<noscript>
 <img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=pagevisit&noscript=1" />
</noscript>

Signup

<script>
 pintrk('track', 'signup');
</script>
<noscript>
 <img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=signup&noscript=1" />
</noscript>

WatchVideo

<script>
 pintrk('track', 'watchvideo', {
   video_title: 'My Product Video 01'
 });
</script>
<noscript>
 <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" />
</noscript>

Данные о событии: Video_title

Lead

<script>
 pintrk('track', 'lead', {
   lead_type: 'Newsletter'
 });
</script>
<noscript>
 <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" />
</noscript>

Данные о событии: lead_type.

Search

<script>
 pintrk('track', 'search', {
   search_query: 'horse'
 });
</script>
<noscript>
 <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" />
</noscript>

Данные о событии: search_query

ViewCategory

<script>
 pintrk('track', 'viewcategory');
</script>
<noscript>
 <img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=viewcategory&noscript=1" />
</noscript>

Custom

<script>
 pintrk('track', 'custom');
</script>
<noscript>
 <img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=custom&noscript=1" />
</noscript>

Примеры комбинирования базового кода и кодов событий

Ниже приведено несколько примеров базового кода, скомбинированного с кодами событий. Важно помнить, что на веб-сайте код события всегда должен размещаться после базового кода.

Пример 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>

Что дальше?

Узнайте больше о параметрах тегов и файлах cookie или включите функцию внутреннего соответствия (по желанию). Если вы не хотите пользоваться этими возможностями, проверьте свой тег Pinterest.

Checkout

AddToCart

Pagevisit

Signup

WatchVideo

Lead

Search

ViewCategory

Custom

Signup

WatchVideo

Lead

Checkout

AddToCart

Pagevisit

Signup

WatchVideo

Lead

Search

ViewCategory

Custom

collection_fields