Чем мы можем помочь?

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

  • Обновлено

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

Обзор

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

Выбор постбэков по внутренним событиям

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

Примечание

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

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

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

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

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

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

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

1 января

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

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

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

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

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

15 января Окно изменено на 20 дней.
18 января

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

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

Примечание

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

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

При начальной настройке постбэков по событиям в приложении окно по умолчанию автоматически устанавливается на шесть месяцев.

Примечание

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

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

Следующие роли могут настраивать окна постбэков:

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

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

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

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

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

Примечание

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

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

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

Примечание

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

Примечание:

  • Названия событий чувствительны к регистру. Чтобы избежать расхождений, убедитесь, что вы используете корректное название события для всех медиа-источников и версий приложения.
  • При вводе названия события вы можете использовать подчеркнутые пробелы (нижние тире) до или после названия события. Убедитесь, что вы используете подчеркнутые пробелы только в случае, если имя события, отправляемое из AppsFlyer, имеет такие же подчеркнутые пробелы.
Ввод идентификатора события в текстовое поле «сопоставлено с событием партнера»
Выберите идентификатор события из списка
  • Событие AppsFlyer: Из списка событий вашего приложения выберите событие.
  • сопоставлено с событием партнёра: Из списка предопределенных партнерских событий выберите событие, которое соответствует внутреннему событию вашего приложения (внутреннее событие приложения AppsFlyer).
Выбор предопределенного события партнера из выпадающего списка идентификаторов событий
Отправляйте события как есть (неотображенные)

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

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

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

Примечание:

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

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

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

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

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

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

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

Для каждого события вы можете выбрать, в каком кейсе отправлять постбэки (в пределах окна постбэка):

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

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

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

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

Примечание:

Опция Показатели, валовая и чистая выручка доступна только при подписке ROI360 Advanced и применяется только для af_purchase* и af_ars_* событий.

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

Делиться выручкой

В постбэках af_revenue и af_currency записываются вне event_value JSON как monetary и currency и могут быть отправлены отдельно. Пример структуры постбэка:

https://appsflyer.com/push?event_value=(event-value)&monetary=(monetary)&content_id=(af_content_id)

Когда выбрана опция Показатели, валовая и чистая выручка, af_net_revenue также может быть записан вне event_value JSON как net-monetary и отправлен отдельно. Пример структуры постбэка:

https://appsflyer.com/push?event_value=(event-value)&monetary=(monetary)&net-monetary=(net-monetary)&content_id=(af_content_id)

Примечание:

При выборе опций «Без показателей и без выручки» или «Показатели без выручки» соответствующие параметры маскируются значением N/A

Совет

Вы также можете настроить постбэки событий в приложении так, чтобы в стандартном параметре выручки (monetary) отправлялась чистая выручка вместо валовой.. Чтобы получить доступ к этой настройке, свяжитесь с вашим менеджером по работе с клиентами (CSM).

Например

Маркетолог отправляет событие покупки со следующим event_value:

{"af_currency":"USD","af_content_id":"1234567","af_revenue":50.87,"af_content_type":"category_a"}

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

Имя поля event_value (значение события) денежные события валюта net-monetary
Без значения и дохода Н/Д Булево перечисление Булево перечисление Булево перечисление
Значение без дохода {"af_currency":"N/A","af_content_id":"1234567","af_revenue":"N/A","af_content_type":"category_a"}&monetary=N/A&content_id=1234567 Н/Д Не применимо Булево перечисление
Значение и доход {"af_currency":"USD","af_content_id":"1234567","af_revenue":50.87,"af_content_type":"category_a"}&monetary=50.87&content_id=1234567 50.87 USD (доллар США) Н/Д
Стоимость, выручка и чистая выручка {"af_currency":"USD","af_content_id":"1234567","af_revenue":50.87,"af_net_revenue":35.61,"af_content_type":"category_a"}&monetary=50.87&net-monetary=35.61&content_id=1234567 50.87 USD (доллар США) 35.61

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

Фильтруйте постбэки с событиями в приложении, используя несколько условий, которые можно сопоставить с различными событиями. Партнерам, включая сети самоотчетности (SRNs) и аналитических партнеров, отправляются только события, соответствующие условиям фильтра. Используйте эту функцию для:

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

Например

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

Пример условий постбэка для события в приложении при достижении 10-го уровня, 50-го уровня или покупке на 3 доллара

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

  • Когда уровень равен 10, сопоставьте с fb_mobile_level_acheived
    Иначе (ИЛИ),
  • Когда уровень равен 50, сопоставьте с fb_mobile_level_acheived
    Иначе (ИЛИ),
  • Когда стоимость равняется 3, сопоставьте с fb_mobile_purchase

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

  1. На странице интеграции с партнером определите и сопоставьте необходимые события в приложении для отправки партнеру.
  2. Нажмите значок Добавить условие Add condition icon для требуемого события.
  3. Введите поля условий, как они указаны в значении события :
    • Имя свойства
    • Значение
    • Партнёрское событие для сопоставления условия (с использованием любого из этих вариантов сопоставления)
  4. Вы можете добавить больше условий, только убедитесь, что сначала заполнили все поля уже существующего условия.
  5. Нажмите Сохранить интеграцию

Соображения

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

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

Примечание:

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

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

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

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

  1. Выберите события для обновления.
  2. Нажмите Массовые действия.
  3. Выберите новую настройку, которая будет применена ко всем выбранным событиям:
    • для пользователей из (выберите только один вариант)
      • Только этот партнёр
      • Все медиа-источники, включая органический
    • включая (выберите только один вариант)
      • Нет данных (по умолчанию)
      • Ценности, значения без выручки
      • Ценности, значения и выручка
Панель массовых действий для редактирования настроек «для пользователей из» и «включая» сразу для нескольких событий

Пользовательские события

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

  • Пользователь еще не выполнил это событие
  • Событие не происходило в течение более чем двух недель.
  • У вас имеется большой список Активных событий

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

  1. В выпадающем списке выберите + Добавить элемент.
  2. В текстовом поле введите название события, которое вы хотите добавить.
  3. Кликните по значку галочки, чтобы подтвердить. Добавленное вами событие теперь отображается в списке, и вы можете его выбрать. Подтверждение нового имени пользовательского события
  4. Сопоставьте событие с идентификатором партнера.
  5. Нажмите Сохранить интеграцию, чтобы удостовериться, что сопоставление сохранено.

Примечание:

  • Добавление пользовательских событий на странице постбэка не вытягивает их автоматически из вашего приложения. Для корректной работы события должны быть настроены в SDK (пакет средств разработки ПО) или S2S. Посмотрите, как отправлять события в AppsFlyer.
  • Когда пользовательское событие добавляется для определенного партнера, оно также добавляется в список событий для всех партнеров, поэтому вы можете видеть его в выпадающем списке событий любого партнера.
  • См. советы и ограничения по определению имен событий и параметров. 

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

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

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

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

  1. На странице Активные интеграции найдите партнера, которому вы хотите предоставить разрешение.
  2. На вкладке «Разрешения» переключите тумблер Разрешить настройку постбэков внутренних событий приложения в положение ВКЛ.
Переключатель разрешения «Разрешить настройку постбэков для событий в приложении» для рекламной сети

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

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

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

Примечание:

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

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

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

См. также