Эта статья устарела. Продвижение мобильных приложений доступно только через VK Рекламу

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

Получите больше информации по подключению и настройке кабинета VK Рекламы у вашего менеджера или команды поддержки: caresupport@vk.company.
  • /
  • /

Настройка счетчиков и трекеров для продуктовых событий


События — это посещение страниц сайтов или экранов мобильных приложений и выполнение целевых действий на сайтах и в приложениях. Информация о событиях используется для анализа поведения пользователей и дальнейшего показа рекламы именно тех продуктов рекламодателя, которыми интересуются пользователи.
События с сайта
Изначально базовым источником событий для динамического ремаркетинга в myTarget был сайт рекламодателя. С помощью специального JavaScript кода счетчика Top.Mail.Ru, интегрированного на страницы сайта, информация о событиях передается в myTarget. Для анализа поведения пользователей на сайте используется несколько основных сущностей и параметров, которыми размечаются страницы сайта:

  • product — посещение страницы продукта, передается идентификатор продукта и его стоимость;

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

  • purchase — посещение страницы подтверждения покупки (по факту совершения покупки), передаются идентификаторы продуктов и их суммарная стоимость.
Особенности: Название сущностей (событий/страниц), информация об идентификаторах продуктов и их суммарной стоимости передается в параметрах pagetype, productid и totalvalue соответственно. Параметр productid должен содержать те же идентификаторы, что указаны в продуктовом фиде магазина. Параметр totalvalue всегда должен содержать сумму стоимости всех продуктов. Помимо этого, в служебном параметре list должен быть указан идентификатор фида, к которому относится продукт.
Пример передачи данных (вызов JS-кода на сайте рекламодателя):

<script type="text/javascript">
var _tmr = _tmr || [];
_tmr.push({
type: 'itemView',
productid: '12345',
pagetype: 'product',
totalvalue: '3499.50',
list: '1'
});
</script>

Более подробная информация о динамическом ремаркетинге на основе событий с сайтов и о создании продуктовых фидов (источник данных для формирования рекламных объявлений) — в статье.
События из мобильных приложений, постбеки от трекинговых систем к 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
Идентификация фидов — параметры list и trg_feed
Рекламодатель может загрузить неограниченное количество продуктовых фидов в свой аккаунт в myTarget.

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

В общем случае идентификатор фида составляется из ID счетчика Top.Mail.Ru (каждый фид должен быть привязан к счетчику) и ID фида, присвоенного рекламодателем.

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

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

Параметр trg_feed должен содержать в себе значение вида <ID счетчика>_<ID фида> (например, 12345_1). Получить эти ID можно в личном кабинете рекламодателя myTarget в разделе «Продуктовые фиды».

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

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

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

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

Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put("productid","10001");
eventValue.put("value","499.05");
eventValue.put("quantity","1");
eventValue.put("trg_feed","12345_1");
AppsFlyerLib.getInstance().trackEvent(context,"addToCart",eventValue);
 
Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put("productid","10002");
eventValue.put("value","145.75");
eventValue.put("quantity","3");
eventValue.put("trg_feed","12345_1");
AppsFlyerLib.getInstance().trackEvent(context,"addToCart",eventValue);
Обратите внимание: SDK AppsFlyer позволяет использовать множественные значения и комплексные постбеки по событиям, для передачи данных о нескольких товарах в одном событии, но в текущей реализации учета событий в 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

Обработка постбеков о событиях в 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», и так далее.

Использование диплинков — добавление в файл фида

Для того чтобы пользователи при клике на рекламные объявления кампаний динамического ремаркетинга переходили не на сайт рекламодателя, а напрямую в мобильные приложения, в файле фида для каждого продукта необходимо указать диплинк (deeplink) и идентификатор приложения в маркетплейсе (App Store, Google Play). Диплинки используются при показе объявлений в мобильных приложениях ОК и ВК, а также в приложениях рекламных партнеров myTarget.

Подробнее о том, какие диплинки поддерживает myTarget

Прямые диплинки

Добавьте в файл фида элементы ios_url, android_url, bundle_id (идентификатор приложения в Google Play) и ios_app_store_id (идентификатор приложения в App Store) для каждого продукта.
Пример:

<ios_url> sunlight://product?article=100001 </ios_url>
<android_url> sunlight://product?article=100001 </android_url>
<bundle_id> ru.sunlight.sunlight </bundle_id>
<ios_app_store_id>1068913968</ios_app_store_id>

Трекинговые ссылки и отложенные диплинки

Для учета кликов и их корректной атрибуции на стороне трекинговой системы следует использовать трекинговые ссылки. Потребуется указать отдельные ссылки для iOS и Android, их нужно разместить в тегах <android_ tracking_url> и <ios_tracking_url> соответственно, для каждого товара в файле фида. Эти трекинговые ссылки будут вызваны S2S при каждом клике, так трекинговая система узнает о клике, а трафик будет перенаправлен напрямую по диплинку, либо на мобильный сайт или в стор (в зависимости от настроек рекламной кампании).

Логика myTarget устроена так, что если по каким-то причинам системе не удается открыть диплинк в момент клика, а в настройках кампании выбран пункт «Редирект в cтор: да», то указанный в трекинговой ссылке диплинк может быть использован как отложенный после установки приложения пользователем. Именно поэтому трекинговые ссылки необходимо указывать индивидуально для каждого товара.
Пример

<android_tracking_url>https://abc.adj.st/adjust_t=dsfdsfsd&deep_link=app%3A%2F%2Fpath%2Fto%2Fproduct</android_ tracking_url> 
<ios_tracking_url>https://abc.adj.st/adjust_t=dsfdsfsd&deep_link=app%3A%2F%2Fpath%2Fto%2Fproduct</ios_ tracking_url> 
Не забудьте, что содержимое параметра "deep_link" трекинговой ссылки должно быть закодировано.
Пример: прямые диплинки и трекинговые ссылки

<offer id="NI464AMDNAN4" available="true">
<url>https://www.somesite.ru/q/lorem/ipsumdolorsitamet/</url>
<price>3860</price>
<oldprice>4290</oldprice>
<currencyId>RUB</currencyId>
<picture>https://somesite.ru/pics/loremipsumdolorsitamet.jpg</picture>
<typePrefix>loremipsumdolorsitamet</typePrefix>
<vendor>abc</vendor>
<model>abc</model>
<description>Lorem ipsum dolor sit amet, consectetur adipiscing elit</description>
<ios_url>app://ru/d/NI464AMDNAN4/?adjust_tracker=abc</ios_url>
<android_url>app://ru/d/NI464AMDNAN4/?adjust_tracker=abc</android_url>
<bundle_id>your_app_bundle_id</bundle_id>
<ios_app_store_id>your_app_store_id</ios_app_store_id>
<ios_tracking_url>https://app.adjust.com/abcd?campaign=&amp;creative=&amp;deep_link=app%3A%2F%2Fru%2Fd%2FNI464AMDNAN4</ios_tracking_url>
<android_tracking_url>https://app.adjust.com/abcd?campaign=&amp;creative=&amp;deep_link=app%3A%2F%2Fru%2Fd%2FNI464AMDNAN4</android_tracking_url>
</offer>

Добавление динамических параметров в диплинки и ссылки

Динамические параметры (макросы) в файлах фида не поддерживаются, но их можно добавить на уровне рекламной кампании. Например, для сегментирования источников трафика в Adjust по кампаниям и объявлениям можно использовать параметры adjust_campaign и adjust_creative, со значениями {{campaign_id}} и {{banner_id}}. Эти значения будут автоматически заменены на идентификаторы кампании и объявления, при клике на баннер. Параметры добавляются как к ссылке на сайт (элемент url фида), так и к диплинкам (элементы ios_url и android_url).

Для этого укажите следующую строку в разделе «Разметка объявлений — добавлять метки вручную» настроек кампании:

adjust_campaign={{campaign_id}}&adjust_creative={{banner_id}}

Adjust — атрибуция кликов

Реализация диплинков с параметрами атрибуции в Adjust имеет несколько особенностей. При использовании обычных диплинков (реализованных на базе технологии "URL Scheme" в iOS или "Intent URL" в Android) для корректной атрибуции кликов и сбора статистики со стороны Adjust необходимо:

  • Использовать в диплинке специальные GET-параметры — adjust_campaign, adjust_adgroup и adjust_creative;
Примечание: Для прямых диплинков SDK Adjust обрабатывает только заданные параметры, и именно с указанием префикса "adjust_", а все остальные параметры, в том числе стандартные UTM-метки, игнорируются (существует возможность учета и других параметров в SDK, но они не будут отображаться в отчетах Adjust, а могут быть использованы только как raw data).
Настроить обработку параметров реатрибуции adjust_campaign, adjust_adgroup и adjust_creative в коде мобильного приложения (SDK Adjust).
Примечание: Инструкция по включению учета параметров реатрибуции в SDK Adjust представлена в документации:

AppsFlyer — атрибуция кликов

Реализация диплинков с параметрами атрибуции в AppsFlyer имеет особенность. При использовании обычных диплинков (реализованных на базе технологии "URI Scheme" в iOS или "Intent URL" в Android) для корректной атрибуции кликов и сбора статистики со стороны AppsFlyer, необходимо использовать в диплинке специальные GET-параметры — "pid=mail.ru_int" и "is_retargeting=true". Первый определяет источник перехода, второй указывает на то, что переход выполнен в рамках ретаргетинговой рекламной кампании.
Вам помогла эта статья?