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

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

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

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

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

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

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

Тип кампании Обязательные события Рекомендуемые события Данные обязательных событий Данные рекомендуемых событий
Узнаваемость бренда Нет
  • Pagevisit
  • Checkout
  • AddToCart
  • Lead
  • Signup
Нет Внутреннее соответствие
Продажи из каталога
  • Pagevisit
  • AddToCart
  • Checkout
  • Signup
  • Lead
  • Идентификатор товара
  • № заказа
  • Value
  • Валюта (необходимо для добавления в корзину и покупки)
  • Категория товаров
  • Внутреннее соответствие
Рассмотрение Нет
  • Pagevisit
  • Checkout
  • AddToCart
  • Lead
  • Signup
Нет Внутреннее соответствие
Конверсия

Хотя бы один из приведенных ниже вариантов:

  • Signup
  • Lead
  • AddToCart
  • Checkout
  • Идентификатор товара
  • № заказа
  • Value
  • Внутреннее соответствие
Нет
  • Категория товаров
  • currency
  • Внутреннее соответствие
Просмотры видео Нет Нет Нет Внутреннее соответствие
Обязательные и рекомендуемые события для функций

Для каждого типа функции существует свой набор обязательных и рекомендуемых событий.

Функция Обязательные события Рекомендуемые события Данные обязательных событий Данные рекомендуемых событий
Показатели конверсии
  • Pagevisit
  • AddToCart
  • Checkout
Нет currency Нет
Программа подтверждения продавцов (VMP)
  • Pagevisit
  • AddToCart
  • Checkout
Нет currency Нет
Динамический ретаргетинг
  • Pagevisit
  • AddToCart
  • Checkout
Нет
  • Идентификатор товара
  • Value
  • currency
Нет
Добавление кодов событий на веб-сайт

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

  1. Выполните вход в бизнес-аккаунт Pinterest в браузере компьютера.
  2. Нажмите значок гамбургера в левом верхнем углу страницы.
  3. В разделе Бизнес нажмите Конверсии
  4. Нажмите Начать.
  5. Выберите Только тег Pinterest и нажмите Продолжить.
  6. Нажмите Пропустить в правом нижнем углу экрана.
  7. Нажмите Перейти к настройке вручную.
  8. Скопируйте базовый код и нажмите Продолжить.
  9. Выберите, нужно ли включить автоматическое внутреннее соответствие, и нажмите Продолжить.
  10. Нажмите Копировать код под серым полем рядом с кодом события, который вы хотите добавить.
  11. Откройте код страницы веб-сайта, на которой нужно отслеживать событие.
  12. Вставьте код события на страницу, на которой оно должно произойти, и замените приведенные в примерах значения на соответствующие значения для своего веб-сайта. Событие будет срабатывать каждый раз при загрузке страницы.
  13. Нажмите Готово.

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

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

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

    Проверьте тег Pinterest, чтобы убедиться, что все работает правильно.

    End of Other articles Links
    Все еще нужна помощь? Контакты
    User feedback
    Была ли эта статья полезной?

    collection_fields

    Как можно улучшить эту статью?