Динамический ретаргетинг в VK Рекламе: мобильные и веб-события
Динамический ретаргетинг в VK Рекламе строится на событиях: обязательны 3 — просмотр карточки товара, добавление в корзину и покупка; добавление в избранное по желанию. С сайта их передаёт пиксель (JS-вызов _tmr.push с целью, ценой и product_id), из приложения — трекер постбеками; поддерживаются 5 трекеров: MyTracker, Adjust, AppsFlyer, AppMetrica, Branch. ID товара должен быть таким же, как в фиде.
Цифры
События и что в них передают
| Событие | В приложении | На сайте (цель в примере кода) | Что передают |
|---|---|---|---|
| Просмотр карточки товара | viewProduct | viewProduct | в приложении и на сайте: ID и стоимость |
| Добавление в корзину | addToCart | addToCart | в приложении: ID, количество, стоимость; на сайте: ID и суммарная стоимость |
| Покупка | purchase | purchase | в приложении: ID, количество, стоимость; на сайте: ID и суммарная стоимость |
| Добавление в избранное (необязательное) | add_to_wishlist | addToWishlist | в приложении: ID и стоимость; на сайте: ID и суммарная стоимость |
Мобильные трекеры
| Трекер | Метод в SDK | Что настраивают в кабинете трекера |
|---|---|---|
| MyTracker | trackEvent | постбеки на вкладке Postbacks, отправка на вкладке Events Sending |
| Adjust | addPartnerParameter | партнёр VK Ads (ex. myTarget) в Campaign Lab, сопоставление событий и параметров, ссылка |
| AppsFlyer | trackEvent | Integrated 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 прямо требуется весь трафик, включая органику.