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

Для:
маркетологов разработчиков
Последнее обновление:

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

Обзор

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

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

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

Примечание

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

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

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

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

15-дневная_настройка_постбэков_по_событиям_приложения.png

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

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

1 января

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

Пользователь устанавливает приложение.
2 января Окно изменено на 10 дней.
14 января

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

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

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

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

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

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

Примечание

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

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

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

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

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

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

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

 Примечание

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

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

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

Примечание

  • Не все методы сопоставления доступны для всех партнёров
  • Вы можете дать партнеру разрешение выполнить сопоставление самостоятельно

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

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

Примечание

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

altenter_event_name.pngalt

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

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

altIn-app_event_postbacks_en-us.pngalt

Отправляйте события как есть (неотображенные)

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

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

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

Примечание

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

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

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

send_postbacks_as_is_en-us.png

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

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

send_postbacsk_as_is_no_mapping.png

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

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

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

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

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

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

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

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

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

В постбэках af_revenue и af_currency записываются вне event_value JSON как монетарная и валюта и могут быть отправлены отдельно. Пример структуры постбэка: 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 (значение события) денежный валюта
Нет ценностей и выручки  Н\/Д Н\/Д  Н\/Д
Ценности без выручки

{"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=1.856918&content_id=1234567

 50.87 USD

Поделиться прогнозируемой выручкой

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

Когда прогнозируемое событие выручки передается партнеру, AppsFlyer отправляет постбэк со структурой, аналогичной фактическому постбэку выручки, но с двумя различиями:

  • Ключ af_projected_revenue заменяет ключ af_revenue.
  • Поле revenue_type принимает значение projected.

Пример

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

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

Имя поля event_value (значение события) денежный валюта тип_выручки
Нет ценностей и выручки  Н\/Д Н\/Д  Н\/Д Н\/Д
Ценности без выручки

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

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

&monetary=N/A&content_id=1234567

 Н\/Д  Н\/Д Н\/Д
Ценности и выручка

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

"af_projected_revenue":50.87,"af_content_type":"category_a"}

&monetary=1.856918&content_id=1234567

 50.87 USD projected

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

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

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

Пример

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

altin_app_event_condition__1_.pngalt

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

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

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

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

Соображения

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

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

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

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

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

Примечание

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

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

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

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

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

altIn-app_event_postbacks_en-us.pngalt

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

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

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

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

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

Примечание

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

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

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

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

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

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

adnetwork-permissions-postbacks.png

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

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

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

Чтобы предоставить агентству разрешение на настройку постбэков:

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

agency-events.png

См. также