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

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

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

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

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

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

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

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

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

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

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

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

1 января

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

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

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

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

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

15 января

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

18 января

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

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

Настройки по умолчанию

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

Если вы только приступаете к настройке постбэков, окно по умолчанию автоматически устанавливается на 180 дней.

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

Окно могут настраивать:

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

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

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

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

 Примечание

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

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

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

Указать идентификатор события в текстовом поле

  • Название события в SDK: выберите событие из списка событий приложения.
  • Идентификатор события партнера: укажите соответствующий идентификатор, полученный от партнера.

in-app-postback_type-in.png

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

Рекламная сеть заранее указывает в AppsFlyer список событий, которые хочет получать.

  • Название события в SDK: выберите событие из списка событий приложения.
  • Идентификатор события партнера: выберите самое подходящее событие из раскрывающегося списка событий партнера.

in-app-postback_dropdown.png

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

Некоторые сети предпочитают получать события «как есть», т. е. независимо от названия: purchase, acquisition или event5.

В этом случае можно выбрать один из двух вариантов:

  • сообщать обо всех событиях
  • вручную выбирать события для отправки

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

in-app-postback_as-is-send-all.png

Если вы хотите добавлять события вручную, нажмите Add Event (Добавить событие) и выберите событие для отправки. Повторите эти действия, чтобы добавить другие события.

in-app-postback_as-is.png

См. статью Интегрированные партнеры, сопоставление событий.

Варианты отправки

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

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

Если вы решили отправлять все события «как есть», выбранная здесь опция отправки также применяется ко всем событиям.

Отправка данных о событиях

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

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

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

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

 Пример

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

Ниже приведены примеры данных, отправляемых при выборе той или иной опции:

  • Без значения и дохода
    • event_value: N/A
    • monetary: N/A
    • currency: N/A
  • Значение без дохода

    • event_value: {af_revenue: N/A, af_currency: N/A, af_level=2, af_receipt_id=57601333}
    • monetary: N/A
    • currency: N/A
  • Значение и доход

    • event_value: {af_revenue: 50.87, af_currency: USD, af_level=2, af_receipt_id=57601333}
    • monetary: 50.87
    • currency: USD

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

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

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

  • AppsFlyer отправляет событие партнеру в следующих случаях:
    • И свойство, и его значение соответствуют данным о событии.
    • Условия не настроены.
  • Если свойство или значение не совпадают, событие отправлено не будет. Например, если данные о событии — "event_value": "{\"level\":\"5\"}", а в условии указано свойство "af_level", событие не будет отправлено из-за несоответствия свойства ("level" в событии и "af_level" в условии). Если данные о событии — "event_value": "{\"level\":\"6\"}", а значение в условии — 5, событие не отправится, поскольку не совпадают значения.
  • Внутренние события с условиями можно настраивать для всех партнеров, включая SRN и партнеров по аналитике.
  • Агентствам разрешено настраивать условия для внутренних событий.
  • Максимальное количество условий, включая свойство и значение, — 5 на событие.
  • На данный момент условия можно задавать только через «равно». Если у определенного события несколько условий, для отправки постбэка должно быть выполнено хотя бы одно из них.
  • Сложные структуры данных, такие как массивы, не поддерживаются.
  • Чтобы оценить влияние этой функции на оптимизацию кампании, рекомендуется проверить ее с помощью тестового приложения или малозначимых событий. 

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

  1. На странице интеграции партнера определите и сопоставьте внутренние события для отправки партнеру.
  2. У необходимого события нажмите значок Add condition (Добавить условие).

    conditional-in-app-events-postback.jpg

  3. В полях «Свойство» и «Значение» укажите свойство и его значение для сравнения.
  4. Нажмите кнопку Save Integration (Сохранить интеграцию).

 Пример

У рекламодателя есть игровое приложение, и он хотел бы оптимизировать кампании, запущенные в рекламной сети X, но только для пользователей, дошедших до 5 уровня. Для этого рекламодателю нужно перейти в раздел «Постбэки внутренних событий» на странице интеграции рекламной сети X и задать условие для события "level_up" со свойством "level" и значением "5". Теперь AppsFlyer будет отправлять это событие рекламной сети X только по пользователям, достигшим 5 уровня. Условие постбэка отображается как "event_value": "{\"level\":\"5\"}". Если рекламодателю потребуется применить два и более условий, значение event_value необходимо передать следующим образом: "{\"property1\":\"value1\",\"property2\":\"value2\"}"

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

При сопоставлении событий поля Sending option (Вариант отправки) и Send event value (Отправка значения события) можно редактировать сразу для нескольких событий.

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

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

in-app-events-bulk-actions_en-us.png

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

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

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

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

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

    in-app-postback_custom.png

  3. Сопоставьте событие с идентификатором партнера.
  4. Нажмите Save (Сохранить), чтобы сопоставление записалось.

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

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

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

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

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

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

adnetwork-permissions-postbacks.png

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

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

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

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

agency-events.png

Была ли эта статья полезной?