Динамический ретаргетинг в VK Рекламе: мобильные и веб-события

Динамический ретаргетинг в VK Рекламе строится на событиях: обязательны 3 — просмотр карточки товара, добавление в корзину и покупка; добавление в избранное по желанию. С сайта их передаёт пиксель (JS-вызов _tmr.push с целью, ценой и product_id), из приложения — трекер постбеками; поддерживаются 5 трекеров: MyTracker, Adjust, AppsFlyer, AppMetrica, Branch. ID товара должен быть таким же, как в фиде.

Цифры

События и что в них передают

СобытиеВ приложенииНа сайте (цель в примере кода)Что передают
Просмотр карточки товараviewProductviewProductв приложении и на сайте: ID и стоимость
Добавление в корзинуaddToCartaddToCartв приложении: ID, количество, стоимость; на сайте: ID и суммарная стоимость
Покупкаpurchasepurchaseв приложении: ID, количество, стоимость; на сайте: ID и суммарная стоимость
Добавление в избранное (необязательное)add_to_wishlistaddToWishlistв приложении: ID и стоимость; на сайте: ID и суммарная стоимость

Мобильные трекеры

ТрекерМетод в SDKЧто настраивают в кабинете трекера
MyTrackertrackEventпостбеки на вкладке Postbacks, отправка на вкладке Events Sending
AdjustaddPartnerParameterпартнёр VK Ads (ex. myTarget) в Campaign Lab, сопоставление событий и параметров, ссылка
AppsFlyertrackEventIntegrated Partners → myTarget → In-App Events Postback
AppMetricaв справке не нашлиотдельный трекер на iOS и на Android, вкладка Ecommerce, шаблоны постбеков
Branchв справке не нашлиPartner Management → POSTBACK CONFIG: события и параметр partner_parameters

ID товара в приложении

ПараметрЗначение
Названия параметра по умолчанию (раздел про обязательный параметр)13: af_content_id, productid, fb_content_id, offerId, content_id, content, product_id, product, offer_id, offerid, af_content_list, item_id, contentid
Названия по умолчанию (раздел про редактирование параметра)11: те же без item_id и contentid
Формат IDкак в файле продуктового фида
Категории событий в настройках приложения3: «Просмотр карточки товара», «Покупка», «Добавление в корзину»
Ecomm-категории, где можно вручную указать параметр4: «Просмотр контента», «Добавление в корзину», «Покупка», «Добавление в список желаний»

Веб-события через пиксель

ПараметрЗначение
Где настраивают«Источники событий» → «Сайты» → «Настройка» у пикселя
Вкладки«Код пикселя», «События»
Обязательных событий3
Категории«Просмотр карточки товара», «Добавление в избранное», «Добавление в корзину», «Покупка»
Условие наступления«JS-событие» и название цели
Параметр valueстоимость товара
Несколько товаров в покупкемассив в params.product_id

Подробности

Порядок действий для приложения

  • На стороне рекламодателя через SDK трекера настроить передачу обязательных in-app событий.
  • На стороне рекламодателя сделать нужные настройки в кабинете трекера.
  • В кабинете VK Рекламы выбрать категории для обязательных событий.
  • При необходимости вручную указать название параметра для ID товара.

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

Что значит каждое мобильное событие

  • viewProduct: просмотр экрана с описанием товара; передают ID товара и его стоимость.
  • addToCart: добавление товара в корзину или просмотр экрана корзины; передают ID товаров, количество и стоимость.
  • purchase: оформление покупки или просмотр экрана подтверждения покупки по факту совершения; передают ID товаров, количество и стоимость.
  • add_to_wishlist (необязательное): добавление в избранное; передают ID товара и стоимость.

Параметр с ID товара

Чтобы событие из трекера записалось в базу, в нём должен быть параметр с ID товара, с которым совершено действие. По умолчанию система ищет его автоматически среди названий из таблицы выше. Если нужного параметра в событии нет, название вписывают в текстовое поле вручную. Это доступно только для ecomm-категорий; для другой категории в поле остаётся прежнее значение, чтобы его сменить, выбирают ecomm-категорию. Найденный параметр подставляется в столбец «ID товара из фида» сам.

Категории событий в приложении

Категория нужна, чтобы сопоставить названия событий из трекера с событиями динамического ретаргетинга. Если приложения ещё нет в VK Рекламе, его сначала добавляют в кабинет. Затем в настройках приложения в списке событий, в столбце «Название события», находят нужные события и каждому задают одну из категорий. Например, addToCart соответствует «Добавление в корзину», viewProduct — «Просмотр карточки товара».

MyTracker

  • SDK: метод trackEvent, партнёр в настройках — myTarget. В примере для Android и iOS событие viewProduct уходит с параметром productid.
  • Постбеки: на вкладке Postbacks кнопкой «Add» добавляют inapp-постбек для событий просмотра товара, избранного, корзины и покупки. URL шаблона справка даёт готовым: адрес на домене r.vk.ru (путь internal/mtpro_event) с параметрами clickid, idfa, advertising_id, android_id, app_id, event_name и partner_parameters с ID товара в JSON. Название параметра с префиксом mtep в шаблоне должно совпадать с названием параметра ID в коде приложения.
  • Отправка: на вкладке Events Sending найти партнёра «VK Ads + myTarget», выбрать приложение, для каждого события выбрать режим Attributed или All, выбрать «In-app event name», добавить кастомные события просмотра товара, корзины и покупки, нажать «Save».

Adjust

  • До начала: приложение добавлено в Adjust, в него встроен Adjust SDK.
  • SDK: метод addPartnerParameter, партнёр — myTarget. Примеры в справке для native- и webview-приложений на Android и iOS.
  • Несколько товаров в событии: разделить на отдельные события. В примере корзины с двумя товарами каждый уходит своим addToCart с productid, value и quantity.
  • Кабинет: плитка «Campaign Lab» → «New Partner» → партнёр VK Ads (ex. myTarget) → приложение. В блоке «Enable data sharing for VK Ads (ex. myTarget)» кнопка «Edit», переключатель «Enabled», в поле APP ID код, полученный при подключении приложения в VK Рекламе.
  • Дальше: сопоставить события Adjust с событиями VK Рекламы, через «Map parameter» связать «SDK parameter» (название в SDK) и «Partner parameter» (название в постбеке с ID товара), задать название ссылки, выбрать, куда вести пользователей с установленным приложением и без него, проверить атрибуцию по умолчанию, нажать «Create Link».
  • Click URL сохраняют: он нужен при создании кампании в VK Рекламе.

AppsFlyer

  • SDK: метод trackEvent, партнёр — myTarget. В примере событие viewProduct уходит с productid.
  • Кабинет: в настройках приложения раздел «Integrated Partners» → поиск myTarget → «Edit» у модуля «myTarget (Mail.ru)».
  • На вкладке «Integration» включить «In-App Events Postback», выбрать «Add Manually».
  • В списке «SDK event name» выбрать события: подходят и названия AppsFlyer из SDK, и названия myTarget (VK Рекламы).
  • «Sending Options»: «All media sources, including organic», чтобы постбеки шли со всего видимого трафика, а не только из VK Рекламы.
  • «Send Revenue»: «Values & revenue», чтобы VK Реклама получала значения параметров.

AppMetrica

  • Создать новый трекер отдельно для iOS и для Android: выбрать приложение, в списке «Партнер» выбрать «VK Ads (ex. myTarget)», платформу, вкладку Ecommerce.
  • В списке событий выбрать «Просмотр карточки товара», «Добавление в корзину» или «Завершение покупки».
  • В поле Postback URL выбрать шаблон: «ViewProduct Ecom Postback», «AddToCart Ecom Postback» или «Purchase Ecom Postback». Метод запроса GET.
  • Примеры кода для SDK справка не приводит, а отсылает к документации AppMetrica для Android и iOS.

Branch

  • Добавить события просмотра товара, добавления в корзину, покупки и при желании добавления в избранное: «Partner Management» → вкладка POSTBACK CONFIG → «Add New Postback», выбрать событие, «Save».
  • Для каждого события добавить пользовательский параметр partner_parameters с ID товара: «…» → «Advanced Edit» → блок «Add Custom Macros». В «Key» вписывают partner_parameters, в «Value» — закодированный JSON с content_id, значение берётся макросом из первого элемента content_items (поле $sku). Точная строка приведена в справке.

Сайт: события и пиксель

Три обязательных веб-события передаются пикселем: посещение страницы товара (ID и стоимость), посещение страницы корзины или добавление товара в корзину (ID и суммарная стоимость), посещение страницы подтверждения покупки по факту совершения (ID и суммарная стоимость). Необязательное — add_to_wishlist.

  • Открыть «Источники событий» → «Сайты», найти пиксель, нажать «Настройка».
  • На вкладке «Код пикселя» скопировать JavaScript-код и разместить на всех страницах сайта.
  • На вкладке «События» добавить три обязательных события.

Каждое событие добавляют одинаково: «Добавить событие», в поле «Категория» выбрать нужную, ввести название и ценность события, в поле «Условие наступления» выбрать «JS-событие» и ввести название цели, нажать «Добавить событие». Затем сайт должен вызывать JS-код с этой целью. В примерах справки цели называются viewProduct, addToWishlist, addToCart и purchase, параметр передаётся как params.product_id. В VALUE подставляют стоимость товара, в PRODUCT_ID — ID так, как он указан в фиде.

Справка советует передавать в value именно стоимость товара: это даёт более точные таргетинг и оптимизацию и позволяет смотреть метрики Доход, ДРР, ROMI.

Корзина и несколько товаров на сайте

  • Событие корзины рекомендуют вызывать в момент добавления товара; в нём указывается добавляемый товар.
  • Если вызывать его при открытии корзины со всеми товарами, оно будет срабатывать при каждом открытии и создавать лишние события в статистике.
  • Для покупки нескольких товаров в params.product_id передают массив ID. Такого примера для других событий в справке нет.

Google Tag Manager

Чтобы передавать данные через GTM, сначала настраивают расширенную электронную торговлю Google Аналитики (справка отсылает к руководствам Google). Все данные о страницах, просмотренных товарах и действиях лежат в GTM в переменной dataLayer. В примере для просмотра карточки товара событие view_item содержит товар с полями item_name, item_id, price, item_brand, item_category, item_variant, quantity. Из dataLayer берут данные о товарах и заказах и передают в VK Рекламу, а в настройках пикселя активируют сбор событий из слоя данных. Шагов этой настройки справка не расписывает.

Важно знать

  • Названия параметра с ID товара: в разделе про обязательный параметр перечислено 13 названий, в разделе про ручное редактирование — 11 (нет item_id и contentid). Проверить в кабинете, подставится ли параметр с item_id или contentid автоматически.
  • Категории событий приложения: при настройке названо 3 («Просмотр карточки товара», «Покупка», «Добавление в корзину»), а для ручного параметра перечислено 4 («Просмотр контента», «Добавление в корзину», «Покупка», «Добавление в список желаний»). Названия «Просмотр контента» и «Просмотр карточки товара» могут означать одно и то же, но справка этого не говорит. Проверить список категорий в настройках приложения.
  • Избранное называют по-разному: в тексте веб-страницы событие add_to_wishlist, в примере кода цель addToWishlist, в кабинете для сайта категория «Добавление в избранное», для приложения — «Добавление в список желаний».
  • Стоимость в веб-событиях: в описании событий указана суммарная стоимость товаров, а в инструкции по подстановке VALUE — стоимость товара. Для корзины и покупки с несколькими товарами правило надо сверить в кабинете.
  • MyTracker: в примере кода параметр называется productid, а в шаблоне URL постбека стоит макрос mtep_product_id. Справка сама требует, чтобы название после mtep совпадало с названием параметра в коде, поэтому макрос в шаблоне может потребовать правки.
  • Корзина: для приложений справка допускает addToCart и при просмотре экрана корзины, а для сайта предупреждает, что вызов при открытии корзины даёт лишние события.
  • Для приложений в справке есть количество товаров (quantity), для сайта оно не упомянуто: передаются ID и суммарная стоимость.
  • Партнёр называется в трекерах по-разному: myTarget, VK Ads (ex. myTarget), VK Ads + myTarget, myTarget (Mail.ru). Это одно и то же — старое имя VK Рекламы; искать по тому названию, что стоит в списке партнёров трекера.
  • В разделе про Google Tag Manager справка заканчивается указанием активировать сбор событий из слоя данных в настройках пикселя, без шагов и без примеров передачи.
  • Режим отправки событий в MyTracker (Attributed или All) для динамического ретаргетинга справка не называет; для AppsFlyer прямо требуется весь трафик, включая органику.