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

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

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

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

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

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

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

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

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

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

In-app_event_postbacks_en-us.png

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

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

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

In-app_event_postbacks_en-us.png

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

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

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

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

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

send_postbacsk_as_is_no_mapping.png

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

send_postbacks_as_is_en-us.png

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

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

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

  • All media sources, including organic (Все медиа-источники, включая органические): для событий, включая органические события, атрибутированных любому медиа-источнику.
  • This partner only (Только события партнера): для событий, атрибутированных только этому партнеру.

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

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

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

  • No data (default) (Нет данных (по умолчанию)): отправляет только само событие без значения.
  • Values without revenue (Значения без дохода): отправляет все параметры, кроме дохода.
  • Values and revenue (Значения и доход): отправляет все параметры события, включая доход (если оно есть в событии).

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

Примечание. При выборе вариантов Нет данных или Значения без дохода соответствующие параметры маскируются значением 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 (Добавить условие).
    In-app_event_postbacks_en-us.png
  3. В полях «Свойство» и «Значение» укажите свойство и его значение для сравнения.
  4. Нажмите кнопку Save Integration (Сохранить интеграцию).

 Пример

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

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

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

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

  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. Нажмите Save (Сохранить), чтобы сопоставление записалось.

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

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

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

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

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

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

adnetwork-permissions-postbacks.png

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

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

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

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

agency-events.png

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