Запуск кампаний с динамическим ремаркетингом доступен через VK Рекламу

Мы перенесли продвижение товаров и услуг с помощью динамического ремаркетинга и динамических рекламных объявлений в VK Рекламу — на платформе рекламные кампании запускаются в 5 простых шагов. Подробнее

Динамический ремаркетинг на базе мобильных событий


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

События — это посещение страниц сайтов или экранов мобильных приложений и выполнение целевых действий на сайтах и в приложениях. Информация о событиях используется для анализа поведения пользователей и дальнейшего показа рекламы именно тех продуктов рекламодателя, которыми интересуются пользователи.
События из мобильных приложений, постбеки от трекинговых систем к myTarget
Помимо использования основных сведений о действиях пользователей на сайте теперь рекламодатель может использовать данные о событиях, производимых пользователями в его мобильных приложениях (in-app events). В рамках интеграции myTarget и трекинговой системы рекламодатель может настроить передачу данных о мобильных событиях. Трекинговая система автоматически передает сведения о событиях и параметрах этих событий к myTarget в постбеках (postbacks), в соответствии с настройками модуля myTarget в личном кабинете клиента, заданными рекламодателем.

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

  • viewProduct — событие просмотра продукта (экрана с описанием продукта), в событии передается идентификатор продукта и его стоимость;

  • addToCart — событие добавления продукта в корзину, либо просмотр экрана корзины (экрана с перечнем выбранных покупателем продуктов), передаются идентификаторы продуктов, их количество и стоимость;

  • purchase — событие оформления покупки, либо просмотр экрана подтверждения покупки (по факту совершения покупки), передаются идентификаторы продуктов, их количество и стоимость.
Обратите внимание: Названия событий должны быть указаны и передаваться именно в том виде, в котором они перечислены выше.
Для AppsFlyer задать названия событий можно только на уровне SDK, интегрированного в мобильное приложение рекламодателя.

Для Adjust задать названия событий можно одним из стандартных способов — либо на уровне SDK Adjust, интегрированного в мобильное приложение рекламодателя, либо на уровне личного кабинета Adjust в разделе мэппинга (сопоставления/соответствия) названий событий и параметров, используемых для постбеков. Также существует возможность задать правила сопоставления всех названий событий и некоторых параметров (идентификатор продукта, идентификатор фида) со стороны myTarget, если по каким-то причинам рекламодатель не имеет возможности задать их стандартными способами.

Каждое событие должно содержать в себе параметры (все или только обязательные):

  • productid — идентификатор продукта, с которым выполнил действие (событие) пользователь;
Примечание: Идентификатор продукта должен быть указан в том же виде, что представлен в файле продуктового фида. Информация о формате файла фида, его загрузке в личном кабинете myTarget и использовании для рекламных кампаний динамического ремаркетинга — в статье.
  • value — текущая стоимость одной единицы продукта;

  • quantity — количество единиц продуктов в событии;

  • trg_feed — идентификатор счетчика Top.Mail.Ru и идентификатор фида, в формате <ID счетчика>_<ID фида> (например, 12345_1).
Параметр
Тип данных
Обязательный
Передается в событиях
productid
string
да
viewProduct, addToCart, purchase
trg_feed
string
да
viewProduct, addToCart, purchase
value
string
нет
viewProduct, addToCart, purchase
quantity
string
нет
addToCart, purchase
Идентификация фидов — параметр trg_feed
Рекламодатель может загрузить неограниченное количество продуктовых фидов в свой аккаунт в myTarget.

При этом важно отметить, что при передаче события динамического ремаркетинга из приложения достаточно указать в параметре trg_feed соответственно идентификатор любого фида, который был загружен в аккаунт myTarget.

В общем случае идентификатор фида составляется из ID счетчика Top.Mail.Ru (каждый фид должен быть привязан к счетчику) и ID фида, присвоенного рекламодателем.
В кабинет загружено три фида с разными ID. При передаче событий динамического ремаркетинга из сайта или приложения вы можете указать в параметре "trg_feed" id любого фида: 3, 5, 7

Событие динамического ремаркетинга из приложения

Параметр trg_feed должен содержать в себе значение вида <ID счетчика>_<ID фида> (например, 12345_1). Получить эти ID можно в личном кабинете рекламодателя myTarget в разделе «Продуктовые фиды».
Передача постбеков по событиям Adjust
Если мобильное приложение рекламодателя уже интегрировано с Adjust с помощью SDK, убедитесь, что генерируются необходимые для работы динамического ремаркетинга события и параметры к ним. Имена событий и параметров могут быть произвольными, задать их сопоставление с именами, используемыми в myTarget, можно в личном кабинете Adjust для каждого партнера индивидуально.
Для передачи постбеков Adjust необходимо:

  1. Настроить передачу постбеков через Adjust SDK.
  2. Добавить события viewProduct, addToCart и purchase через кабинет Adjust.

Настройки в SDK (в коде мобильного приложения)

Для передачи параметров событий, предназначенных для отправки от Adjust к партнерам (myTarget), используйте метод addPartnerParameter SDK Adjust.
Примечание: Описание метода addPartnerParameter SDK Adjust представлено в официальной документации:

SDK для native приложений:

SDK для WebView приложений:

Пример использования метода addPartnerParameter при событии просмотра экрана приложения о продукте (событие viewProduct), который имеет стоимость "3499.50 руб" и идентификатор "12345":
Пример кода для native приложений Android:

AdjustEvent event = new AdjustEvent("viewProduct");
event.addPartnerParameter("productid", "10001");
event.addPartnerParameter("value", "3499.50");
event.addPartnerParameter("trg_feed", "12345_1");
Adjust.trackEvent(event);

Пример кода для native приложений iOS:

ADJEvent *event = [ADJEvent eventWithEventToken:@"viewProduct"];
[event addPartnerParameter:@"productid" value:@"10001"];
[event addPartnerParameter:@"value" value:@"3499.50"];
[event addPartnerParameter:@"trg_feed" value:@"12345_1"];
[Adjust trackEvent:event]

Пример кода для WebView приложений Android:

let adjustEvent = new AdjustEvent('viewProduct');
adjustEvent.addPartnerParameter('productid', '10001');
adjustEvent.addPartnerParameter('value', '3499.50');
adjustEvent.addPartnerParameter('trg_feed', '12345_1');
Adjust.trackEvent(adjustEvent);

Пример кода для WebView приложений iOS:

var adjustEvent = new AdjustEvent('viewProduct');
adjustEvent.addPartnerParameter('productid', '10001');
adjustEvent.addPartnerParameter('value', '3499.50');
adjustEvent.addPartnerParameter('trg_feed', '12345_1');
Adjust.trackEvent(adjustEvent);

Просмотр товара в приложении

AdjustEvent event = new AdjustEvent("viewProduct"); // определяем событие viewProduct - просмотр товара
event.addPartnerParameter("productid", "10001"); // добавляем идентификатор товара из фида
event.addPartnerParameter("value", "3499.50"); // добавляем цену товара
event.addPartnerParameter("trg_feed", "12345_1"); // добавляем параметр trg_feed
Adjust.trackEvent(event); // отправляем событие при просмотре карточки товара
Добавление товара в корзину/Просмотр корзины

AdjustEvent event = new AdjustEvent("addToCart");
event.addPartnerParameter("productid", "10001");
event.addPartnerParameter("value", "3499.50");
event.addPartnerParameter("trg_feed", "12345_1");
Adjust.trackEvent(event);
Покупка товара

AdjustEvent event = new AdjustEvent("purchase");
event.addPartnerParameter("productid", "10001");
event.addPartnerParameter("value", "3499.50");
event.addPartnerParameter("trg_feed", "12345_1");
Adjust.trackEvent(event);
Подробнее про параметр trg_feed можно узнать в этом разделе
Передача нескольких продуктов в событии

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

Пример использования метода addPartnerParameter при событии просмотра экрана корзины (событие addToCart — может использоваться как при добавлении товара в корзину, так и при просмотре содержимого корзины), в которую пользователь добавил два товара, в разном количестве:
Пример кода для native приложений Android:

AdjustEvent event = new AdjustEvent("addToCart");
event.addPartnerParameter("productid", "10001");
event.addPartnerParameter("value", "499.05");
event.addPartnerParameter("quantity", "1");
event.addPartnerParameter("trg_feed", "12345_1");
Adjust.trackEvent(event);
 
AdjustEvent event = new AdjustEvent("addToCart");
event.addPartnerParameter("productid", "10002");
event.addPartnerParameter("value", "145.75");
event.addPartnerParameter("quantity", "3");
event.addPartnerParameter("trg_feed", "12345_1");
Adjust.trackEvent(event);

Настройки в кабинете Adjust

Чтобы передаваемые из мобильного приложения в Adjust данные о событиях и параметрах, предназначенных для передачи партнёрам, поступали в myTarget, включите отправку постбеков, задайте список передаваемых событий и, при необходимости, выполните сопоставление названий событий и параметров.
Обратите внимание: Инструкция ниже обязательна к выполнению вне зависимости от того, какие названия событий и параметров используются в мобильном приложении.
Последовательность действий в личном кабинете Adjust:

1. Добавить партнера myTarget в настройках приложения, если еще не добавлен, и включить передачу событий и параметров:

  • Перейдите в раздел "All Settings" приложения;
  • В боковом меню выберите раздел "Partner Setup", нажмите "Add Partners" (см. скриншот 1 — шаг 1)
Скриншот 1
  • Укажите "myTarget" в строке поиска (см. скриншот 2 — шаг 1), нажмите плюс (см. скриншот 2 — шаг 2)
Скриншот 2
  • Установите переключатели "Enabled" и "Parameter Forwarding" в состояние "On" (см. скриншот 3 — шаги 1 и 2);

Примечание: Если ваше приложение в Adjust заведено как мультиплатформенное, то включить переключатели "Enabled" и "Parameter Forwarding" необходимо как для iOS версии приложения, так и Android. Эти же условия распространяются на разделы "Event Linking" и "Partner Parameter Mapping", инструкция по настройке которых представлена ниже.

  • Нажмите "Save" (см. скриншот 3 — шаг 3).
Скриншот 3
2. Настроить передачу событий, задать правила соответствия названий событий:

  • После добавления партнера в разделе "Partner Setup" в списке будет отображен пункт "myTarget", выберите его;
  • Перейдите в раздел "Event Linking" — выберите те из событий SDK, которые соответствуют событиям, необходимым для динамического ремаркетинга, и задайте им соответствующие названия (см. скриншот 4 — шаги с 1 по 3), нажмите кнопку "Ok" (см. скриншот 4 — шаг 4), затем кнопку "Save".

Примечание: Названия событий, которые следует указать, описаны в разделе «События из мобильных приложений, постбеки от трекинговых систем к myTarget». В постбеках из Adjust в myTarget будут передаваться только те события, для которых явно задано название в разделе "Event Linking", поэтому, вне зависимости от того используются ли в приложении нужные для динамического ремаркетинга названия событий или нет, необходимо указать названия в пустых строках напротив событий из приложений — в противном случае события передаваться не будут. Если необходимо, чтобы события передавались с оригинальными названиями, используемыми в SDK, укажите эти имена как есть.
Скриншот 4
3. Настроить передачу параметров событий — сопоставление названий:

  • В разделе "Partner Setup" выберите пункт "myTarget", затем выберите раздел "Partner Parameter Mapping";
  • Укажите названия параметров, используемых в SDK, и задайте им названия, необходимые для динамического ремаркетинга (см. скриншот 5 — шаги 1 и 2);
  • Нажмите "Save" (см. скриншот 5 — шаг 3).
Примечание: Названия параметров, которые используются в динамическом ремаркетинге, описаны в разделе «События из мобильных приложений, постбеки от трекинговых систем к myTarget». Если используемые в SDK названия параметров для событий, необходимых для динамического ремаркетина, соответствуют тем, что используются в myTarget, то заполнять таблицу соответствия в разделе "Partner Parameter Mapping" не требуется. Adjust автоматически передает все параметры событий с их оригинальными названиями, если включена передача этих событий, а переключатель "Parameter Forwarding" установлен в значение "On".
Скриншот 5
Передача постбеков по событиям AppsFlyer
Если мобильное приложение рекламодателя уже интегрировано с AppsFlyer с помощью SDK, убедитесь, что генерируются необходимые для работы динамического ремаркетинга события и параметры к ним. Допустимо использование собственных или стандартных имён событий и параметров AppsFlyer — в этом случае можно задать сопоставление всех имен и некоторых параметров (идентификатор продукта, идентификатор фида) со стороны myTarget. Но мы рекомендуем использовать имена событий и параметров myTarget — в этом случае задавать какое-либо сопоставление не потребуется, в myTarget сразу будут передаваться данные, необходимые для динамического ремаркетинга.
Для передачи постбеков AppsFlyer необходимо:
  1. Настроить передачу постбеков через AppsFlyer SDK.
  2. Добавить события viewProduct, addToCart и purchase через кабинет AppsFlyer.

Настройки в SDK (в коде мобильного приложения)

Для передачи параметров событий, предназначенных для отправки от AppsFlyer к партнерам (myTarget), используйте метод trackEvent SDK AppsFlyer.
Примечание: описание метода trackEvent SDK AppsFlyer представлено в официальной документации:

Пример использования метода trackEvent при событии просмотра экрана приложения о продукте (событие viewProduct), который имеет стоимость "3499.50 руб" и идентификатор "12345":
Пример кода для Android:

Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put("productid","10001");
eventValue.put("value","3499.50");
eventValue.put("quantity","1");
eventValue.put("trg_feed","12345_1");
AppsFlyerLib.getInstance().trackEvent(context,"viewProduct",eventValue);
Обратите внимание: В примере отображено использование имен событий и параметров myTarget. Это наиболее предпочтительный способ, не требующий дополнительных действий по сопоставлению имен и параметров на стороне myTarget.

Аналогичный пример вызова метода trackEvent на базе универсального события af_content_view AppsFlyer, но дополненный передачей параметра trg_feed ниже.
Пример кода для Android:

Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.CONTENT_ID, "10001";
eventValue.put("trg_feed","12345_1");
AppsFlyerLib.getInstance().trackEvent(getApplicationContext(), AFInAppEventType.CONTENT_VIEW, eventValue);
Обратите внимание: В примере используется универсальное событие AppsFlyer, значит, его имя будет передано в myTarget как af_content_view, а ID продукта — как af_content_id. Поскольку задать сопоставление имён событий и параметров к именам, используемым в myTarget, на стороне AppsFlyer нельзя, то потребуется задать сопоставление имен на стороне myTarget. Для этого подайте соответствующую заявку, инструкция описана в разделе «Обработка постбеков о событиях в myTarget».

Примечание: Описание стандартного события af_content_view представлено в документации AppsFlyer — пункт "Content View". В свою очередь, пункты "Add to Cart" и "Purchase" описывают использование стандартных событий af_add_to_cart и af_purchase ознакомьтесь с ними, если планируете использовать стандартные события, а не события с именами myTarget.

Настройки в кабинете Appsflyer

Чтобы передаваемые из мобильного приложения в AppsFlyer данные о событиях и параметрах поступали в myTarget, необходимо включить отправку постбеков и задать список передаваемых событий.

Последовательность действий в личном кабинете AppsFlyer:

  • Перейдите в раздел "Integrated Partners" настроек приложения;

  • Укажите "myTarget" в строке поиска (см. скриншот 6 — шаг 1), нажмите кнопку "Edit" напротив названия модуля "myTarget (Mail.ru)" (см. скриншот 6 — шаг 2)
Скриншот 6
  • На вкладке "Integration" включите передачу "In-App Events Postback" (см. скриншот 7 — шаг 1);

  • Выберите вариант "Add Manually" (см. скриншот 7 — шаг 2);

  • В выпадающем списке "SDK event name" (см. скриншот 7 – шаг 3) выберите нужные названия событий, которые будут передаваться в in-app event postbacks. События можно выбрать из выпадающего списка с теми именами, которые используются в SDK: с именами Appsflyer, либо с имена myTarget;
Скриншот 7
  • В выпадающем списке "Sending Options" (см. скриншот 7 – шаг 4) необходимо выбрать вариант "All media sources, including organic" — нужно, чтобы Appsflyer отправлял in-app event postback со всего видимого трафика, не только трафика myTarget;
Скриншот 7.1
  • В выпадающем списке "Send Revenue" (см. скриншот 7 – шаг 5) нужно выбрать "Values & revenue" — нужно, чтобы myTarget получал значения параметров в in-app event postback, которые отправляет Appsflyer.
Установка единого trg_feed на все постбеки по событиям

Если передача параметра trg_feed из мобильного приложения посредствам SDK не представляется возможной, то вы можете задать единое значение trg_feed на странице настроек интеграции партнера myTarget в кабинете AppsFlyer. В этом случае AppsFlyer будет передавать в myTarget единое значение trg_feed, указанное в настройках, при каждом постбеке о событии.

Такой способ подходит, если рекламодатель использует только один фид в myTarget, при этом в мобильном приложении не используются идентификаторы фидов/клиентов из других рекламных систем, на основе которых можно было бы задать сопоставление для идентификаторов фидов на стороне myTarget (см. раздел «Сопоставление идентификаторов фида на основе идентификаторов из других рекламных систем»).

Чтобы задать единый идентификатор фида, укажите в разделе "In-App Events Settings" для поля "trg_feed" значение в формате <ID счетчика>_<ID фида> (например - 12345_1), затем нажмите кнопку "Save" (см. скриншот 8).
Скриншот 8
myTracker: передача постбеков по событиям

Настройки в SDK (в коде мобильного приложения)

Для передачи параметров событий, предназначенных для отправки от myTracker к партнерам (myTarget), используйте метод trackEvent из myTracker SDK.

Описание метода trackEvent в myTracker SDK представлено в официальной документации
Пример кода для Android:

Map<String, String> eventParams = new HashMap<>();
eventParams.put("productid", "322223");
MyTracker.trackEvent("viewProduct", eventParams);
Пример кода для iOS:

NSDictionary *eventCustomParams = @{
    @"productid" : @"322223"
  };
[MRMyTracker trackEventWithName:@"viewProduct" eventParams:eventCustomParams];

Настройки в кабинете рекламодателя myTracker

Настройка отправки событий динамического ремаркетинга

Чтобы передаваемые из мобильного приложения в myTracker данные о событиях и параметрах поступали в myTarget, необходимо выполнить следующую последовательность действий в личном кабинете myTracker:
  1. В общем списке найдите партнёра, для которого нужно настроить постбэки. В нашем случае выберите myTarget.
2. На странице Отправка событий выберите приложение. В форму будет подгружен список событий, по которым можно настроить отправку постбэков.
3. Для каждого события выберите режим отправки:
  • Отправлять атрибутированные — для отправки постбэков только по тем пользователям, которые привлечены рекламной кампанией партнёра;
  • Отправлять все — для отправки постбэков по всем пользователям приложения.
Скриншот 8
4. Выберите Название события в приложении.
5. Добавьте все кастомные события, которые соответствуют событиям динамического ремаркетинга: просмотр товара, добавление в корзину и покупка
6. Нажмите кнопку Сохранить.
Настройка шаблона inapp-постбеков

  1. Перейдите на страницу Постбэки
  2. Нажмите на кнопку Добавить
  3. В появившейся форме заполните все обязательные поля
В поле Шаблон URL используйте URL из примера ниже:

http://10.255.117.2/internal/mtpro_event?clickid={rb_click_id}&idfa={mt_idfa}&advertising_id={mt_gaid_lc}&android_id={mt_android_id}&app_id={mt_external_id}&event_name={mt_event_name}&viewid={rb_view_id}&partner_parameters={mtj_%7B%22productid%22%3A%22%7Bmtep_product_id%7D%22%2C%22trg_feed%22%3A%322223_1%22%7D}

Обратите внимание

Значение параметра trg_feed из примера – составное, где значение до разделителя "_" - это ID счетчика ТОПMail.ru, а значение после разделителя "_ " – это id фида в интерфейсе myTarget.
При настройке шаблона постбека замените значение из примера на вашу комбинацию ID счетчика ТОПMail.ru_id-фида.

Обработка постбеков о событиях в myTarget

Данные о событиях передаются в myTarget через трекинговые системы, с помощью постбеков. Чтобы myTarget начал учитывать постбеки по событиям из мобильного приложения, его необходимо подключить к аккаунту. Отправьте заявку на подключение приложения вашему менеджеру, или в службу поддержки (support_target@corp.my.com). В заявке укажите ссылку на страницу вашего приложения в магазине приложений (Apple App Store, Google Play), и аккаунт, к которому следует подключить приложения (тот аккаунт, на котором будут созданы рекламные кампании динамического ремаркетинга для работы на основе событий из мобильных приложений). Помимо этого укажите, необходимо ли задать правила сопоставления названий событий и их параметров, а также параметра trg_feed на стороне myTarget — информация о сопоставлении с примерами правил и заявки представлена ниже.

Сопоставление названий событий и параметров — со стороны myTarget

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

Для того чтобы мы могли выполнить сопоставление, сообщите нам правила сопоставления — название ваших событий и параметров, соответствующие используемым в myTarget. Правила задаются на уровне приложения, т.е. задать правила можно для каждого мобильного приложения индивидуально, но нельзя задать разные правила для разных аккаунтов, если приложение подключено более чем к одному аккаунту в myTarget.
Пример: К аккаунту привязано приложение для Android (например, "com.example.app"), в нем используются события с названиями fb_content_view (просмотр продукта), fb_addtocart (добавление в корзину), fb_purchase (совершение покупки) и параметр content_id, используемый в каждом событии для указания идентификатора продута, к которому относится событие. Для сопоставления данных пришлите нам описание правил вида «Для приложения com.example.app событие fb_content_view соответствует viewProduct, событие fb_addtocart соответствует addToCart, событие fb_purchase соответствует purchase, а параметр content_id соответствует productid».

Сопоставление идентификаторов фида на основе идентификаторов из других рекламных систем

Если передача параметра trg_feed в постбеках по событиям не представляется возможной, но при этом в каждом постбеке уже передается какой-либо параметр с уникальными значениями (например, ID фидов или названий ваших аккаунтов в другой рекламной системе), то со стороны myTarget возможно задать сопоставление значений этих параметров с идентификаторами счётчика и фида myTarget, принадлежащих рекламодателю.

Для того чтобы мы могли выполнить сопоставление, сообщите нам правила сопоставления — название вашего параметра и возможные варианты его значений, а также идентификаторы ваших счетчиков и фидов myTarget, соответствующие каждому из значений. Правила задаются на уровне приложения, т.е. задать правила можно для каждого мобильного приложения индивидуально, но нельзя задать разные правила для разных аккаунтов, если приложение подключено более чем к одному аккаунту в myTarget.
Пример: К аккаунту рекламодателя привязано два счетчика Top.Mail.Ru — 00001 и 00002, к счетчику 00001 привязан фид 1, а к счетчику 00002 привязан фид 2. При этом в мобильном приложении уже используется параметр customer_ID, со значениями shop1 и shop2 (будем считать их аккаунтами или ID фидов в другой рекламной системе). Для сопоставления данных пришлите нам описание правил вида «Счетчику 00001 и фиду 1 соответствует значение shop1 из параметра customer_ID», «Счетчику 00002 и фиду 2 соответствует значение shop2 из параметра customer_ID», и так далее.
Вам помогла эта статья?