Настройка постбэков по внутренним событиям приложения

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

Обзор

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

Выбор внутреннего события для постбэка

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

 Примечание

  • В число внутренних событий входят отклоненные события, т. е. внутренние события приложения, заблокированные Protect360, или события, не прошедшие проверку по целевым правилам валидации.
  • Если на вкладке Интеграция нет раздела Постбэки по внутренним событиям приложения, это означает, что партнер еще не настроил в своей предварительной конфигурации регистрацию таких событий с помощью AppsFlyer. Партнер может связаться с AppsFlyer через виджет помощи партнерам, чтобы завершить интеграцию.

Окно постбэка по внутренним событиям приложения

С помощью окна постбэка по внутренним событиям приложения маркетологи, сотрудничающие с сетями по модели CPA (плата за действие), могут настроить окна после конверсии, по истечении которых постбэки по событиям больше не отправляются.

Например, если с вас взимается плата за события, происходившие в течение 15 дней с момента установки пользователем, задайте окно следующим образом:

15-day_in_app_event_postback_setting.png

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

Постбэки всегда отправляются в соответствии с текущими настройками окна. Рассмотрим следующий пример.

1 января

Окно составляет 15 дней.

Пользователь устанавливает приложение.

2 января Окно изменено на 10 дней.
14 января

Пользователь совершает покупку.

Постбэк не отправляется рекламной сети, потому что событие не попадает в текущее окно (10 дней).

15 января

Окно изменено на 20 дней.

18 января

Пользователь совершает еще одну покупку.

В этот раз постбэк отправляется, потому что событие попадает в текущее окно (20 дней).

Окно постбэков по умолчанию

Когда вы начинаете настраивать постбэки по внутренним событиям, окно по умолчанию устанавливается на шесть месяцев.

 Примечание

Если вы начали использовать постбэки по внутренним событиям приложения с конкретным партнером до 30 июля 2019 года, по умолчанию окно имеет значение Lifetime (Бессрочно). Это значит, что постбэки по внутренним событиям отправляются всегда.

Кто может настраивать окна постбэков

  • Маркетологи
  • Агентства, если им предоставлено разрешение настраивать постбэки по внутренним событиям приложения.
    Примечание. Маркетолог и рекламное агентство, работающие с одной рекламной сетью, могут настраивать окна постбэков независимо друг от друга в соответствии со своим контрактом с сетью.
  • Партнеры, если им предоставлено разрешение настраивать постбэки по внутренним событиям приложения.

Сопоставление событий

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

Например, когда пользовать что-то покупает через приложение, один маркетолог может назвать это purchase или выбрать менее информативный идентификатор, например, event5, а партнер может назвать это purchase_event.

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

 Примечание

События, сопоставленные на вкладке «Интеграция» конкретному партнеру, применимы как для стандартных постбэков, так и для постбэков SKAN.

Методы сопоставления

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

 Примечание

Ввести идентификатор события партнера

  • Событие AppsFlyer: выберите событие из списка событий вашего приложения.
  • Сопоставлено с событием партнера: в текстовом поле введите ID события, полученный от партнера, который соответствует событию вашего приложения (событие AppsFlyer).

 Примечание

  • Названия событий чувствительны к регистру. Чтобы избежать расхождений, убедитесь, что вы используете правильное название события для всех медиа-источников и версий приложений.
  • При вводе названия события можно использовать подчеркнутые пробелы (нижние подчеркивания) до или после названия события. Используйте нижние подчеркивания только в тех названиях событий, которые были получены от AppsFlyer с такими же пробелами.
enter_event_name.png

Выбрать идентификатор события из списка

  • Событие AppsFlyer: выберите событие из списка событий вашего приложения.
  • Сопоставлено с событием партнера: из списка предзаданных событий партнера выберите событие, соответствующее событию вашего приложения (событие AppsFlyer).

In-app_event_postbacks_en-us.png

Отправлять события «как есть» (без сопоставления)

Некоторые партнеры предпочитают получать постбэки о событиях в приложении без сопоставления — то есть названия событий отправляются в том виде, как они названы в вашем приложении. Не имеет значения, называется ли событие purchase, acquisition или event5.

Вы можете выбрать, какие несопоставленные события отправлять партнеру:

  • Добавить вручную: Выберите конкретные события.
  • Отправить все события (кроме удалений и сессий): отправьте все события. Сюда не входят удаления, сессии (запуски приложений) и событие af_app_opened.

 Примечание

Чтобы защитить рекламодателей/маркетологов от непреднамеренного предоставления сторонним аналитическим платформам лишней информации, в марте 2019 года мы удалили опцию Отправлять все события (кроме удалений и сессий) для аналитических платформ. Для аналитических платформ, настроенных до этой даты, этот параметр остается доступным.

Чтобы добавить события вручную:

  1. Нажмите Добавить событие.
  2. Выберите параметры постбэка:
    • Событие AppsFlyer: выберите событие из списка событий вашего приложения.
    • для пользователей из: выберите вариант отправки для события.
    • включая: выберите, какие данные о событии включать в постбэк.
  3. Повторите эту процедуру для других событий. 

send_postbacks_as_is_en-us.png

Чтобы отправить все события:

  1. Выберите Отправить все события (кроме удалений и сессий).
  2. Выберите параметры постбэка:

send_postbacsk_as_is_no_mapping.png

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

Опции для отправки постбэков

По каждому событию можно выбрать, в каких случаях будут отправляться постбэки (в пределах окна постбэков):

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

Данные для включения в постбэк

Вы можете выбрать, какими данными о событиях делиться с партнером в постбэке. Выберите один из следующих вариантов:

  • Нет значений и нет дохода: отправляет само событие без каких-либо параметров (значений или доходов).
  • Значения, нет дохода: отправляет все параметры, кроме значения дохода.
  • Значения и доход: отправляет все параметры события, включая значение дохода (если оно есть в событии).

Рекомендуется отправлять значение дохода, если вы хотите, чтобы рекламные сети оптимизировали ваши кампании и улучшили их результаты. Однако отправка доходов не является обязательной. Убедитесь, что включили отправку доходов только для событий, у которых в значении события определен параметр af_revenue. В противном случае рекламные сети получат события с пустым значением дохода.

В постбэках параметры af_revenue и af_currency записываются вне файла JSON с event_value как monetary и currency и могут быть отправлены отдельно. Пример структуры постбэка: https://appsflyer.com/push?event_value=(event-value)&monetary=(monetary)&content_id=(af_content_id)

Примечание. При выборе вариантов Нет значений и нет дохода или Значения, нет дохода, соответствующие параметры маскируются N/A (Н/Д).

 Пример

Маркетолог отправляет событие покупки со следующим значением event_value:
{af_revenue: 50.87, af_currency: USD, af_level=2, af_receipt_id=57601333}

В таблице ниже показано, как передаются параметры:

Имя поля event_value денежные события валюта
Без значения и дохода  N/A N/A 
Значение без дохода

{"af_currency":"N/A","af_content_id":"1234567",

"af_revenue":"N/A","af_content_type":"category_a"}

&monetary=N/A&content_id=1234567

N/A 
Значение и доход

"af_currency":"USD","af_content_id":"1234567",

"af_revenue":200,"af_content_type":"category_a"}

&monetary=1.856918&content_id=1234567

50.87 USD

Постбэки внутренних событий с условиями

Настройте фильтрацию постбэков по внутренним событиям, используя различные условия, которые можно сопоставить различным событиям. Только те события, которые соответствуют условиям фильтра, отправляются партнерам, в том числе SRN и партнерам по аналитике. Используйте эту функцию для следующего:

  • Оптимизация сегментации, персонализации и удержания пользователей
  • Минимизация данных
  • Защита конфиденциальности пользователей

 Пример

Маркетолог с игровым приложением хочет оптимизировать кампании, запущенные через рекламную сеть, но только для пользователей, которые прошли 10-й или 50-й уровень, или для пользователей, которые потратили 3 доллара на покупки в приложении.

in_app_event_condition__1_.png

Вот так задаются условия для этого события:

  • Если уровень равен 10, сопоставить с fb_mobile_level_achieved
    В противном случае (ИЛИ), 
  • Если уровень равен 50, сопоставить с fb_mobile_level_achieved
    В противном случае (ИЛИ), 
  • Если затраты равны 3, сопоставить с fb_mobile_purchase

Чтобы настроить условия для события:

  1. На странице интеграции партнера определите и сопоставьте внутренние события для отправки партнеру.
  2. У необходимого события нажмите значок Добавить условие image.png.
  3. Заполните поля условия, как они отображаются в значении события
    • Имя свойства
    • значение
    • Событие партнера, которому нужно сопоставить условие (используя любой из этих вариантов сопоставления
  4. Вы можете добавить дополнительные условия, но проверьте, что сначала заполнили все поля для имеющегося условия.
  5. Нажмите кнопку Save Integration (Сохранить интеграцию). 

Факторы, которые необходимо учитывать

При настройке условий убедитесь, что соблюдены следующие условия для отправки события партнеру:

Структура условия

  • И свойство, и значение в условии должны соответствовать данным о событии. 
  • В настоящее время условия могут быть установлены только на «равно». 
  • Сложные структуры данных, такие как массивы, не поддерживаются.

Несколько условий для события 

  • Максимальное количество условий для одного события — 5.
  • Для отправки постбэка должно быть соблюдено хотя бы одно условие, но только одно условие выполняется.  
  • Каждое условие проверяется в порядке появления. Выполняется первое условие, которое должно быть соблюдено.
  • Каждое условие сопоставляется отдельно. Затем имя события партнера изменяется на На основе условий.
  • Несколько условий могут иметь одно и то же свойство или одно и то же значение, но никакие два условия не могут иметь одинаковое свойство и значение.
  • Одному событию можно сопоставить более одного условия.

 Примечание

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

Редактирование нескольких событий

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

Чтобы редактировать несколько событий:

  1. Выберите события, которые требуется обновить.
  2. Нажмите Bulk actions (Применить к выбранным).
  3. Выберите новый параметр для применения ко всем выбранным событиям:
    • для пользователей из (выберите только одну опцию)
      • Только данный партнер
      • Все медиа-источники и органический трафик
    • включая (выберите только одну опцию)
      • Нет данных (по умолчанию)
      • Значения без дохода
      • Значения и доход

In-app_event_postbacks_en-us.png

Настраиваемые события

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

  • Ни один пользователь еще не выполнил это событие
  • Последний раз это событие произошло более двух недель назад
  • У вас большой список активных событий

В любом из этих случаев для сопоставления события с идентификатором партнера:

  1. Введите имя события.
  2. Нажмите Create custom (Добавить другое).

    In-app_event_postbacks_en-us.png

  3. Сопоставьте событие с идентификатором партнера.
  4. Нажмите Сохранить интеграцию, чтобы убедиться, что сопоставление записано.

 Примечание

  • При добавлении пользовательского события для определенного партнера, событие добавляется в список событий для всех партнеров. Это значит, что это событие будет отображаться в раскрывающихся меню каждого партнера.
  • См. советы и ограничения для определения имен и параметров событий. 

Агентства и рекламные сети:

  • Не могут добавлять настраиваемые события.
  • Могут просматривать и/или сопоставлять события, когда маркетолог добавил событие и предоставил необходимое разрешение.

Сопоставление событий рекламными сетями

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

  1. На странице Активные интеграции найдите партнера, которому требуется предоставить разрешение.
  2. На вкладке Permissions (Разрешения) переведите переключатель Allow to configure in-app event postbacks (Разрешить настройку постбэков по внутренним событиям) в положение ВКЛ.

adnetwork-permissions-postbacks.png

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

Сопоставление событий агентствами

Маркетологи могут разрешить агентствам настраивать постбэки по внутренним событиям приложения.

Чтобы разрешить агентству настраивать постбэки по внутренним событиям приложения:

  1. Найдите агентство на странице Активные интеграции.
  2. Выберите, может ли агентство передавать данные обо всех событиях, или только о тех, которые атрибутированы конкретной рекламной сети.
  3. Укажите, разрешено ли агентству отправлять данные о доходах от событий.
  4. Выберите события, данные о которых агентству разрешено передавать.

agency-events.png