Внутренние события приложения — Обзор

Каждый раз, когда вы отправляете внутренние события, такие как покупка или бронирование авиабилетов, вы отправляете их с соответствующим доходом. Единственным параметром, который содержит доход во внутренних событиях, является af_revenue.

• Запись выручки в SDK
• Запись выручки в Unity

Вы также можете записывать отрицательную выручку, если пользователь отменяет или если вы возвращаете деньги. Для регистрации отрицательного дохода всё, что вам нужно сделать – это добавить знак минус (-) к доходу значению, которое вы передаете в af_revenue.af_revenue – это единственный параметр, который применяется для подсчёта дохода пользователей.

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

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

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

• Не включайте никаких других символов и не форматируйте значение дохода каким-либо другим способом. Это означает отсутствие запятых, знаков валют (например, $), специальных символов и текста.
• AppsFlyer предоставляет значение выручки с точностью до пяти знаков после запятой.
• Диапазон этого значения должен составлять от -1 000 000 до +1 000 000 в долларах или эквивалентную сумму в оригинальной валюте. Суммы за пределами диапазона отображаются в отчётах по сырым данным, а не в агрегированных отчётах.
• Пример: 1234.56
• Когда выручка отправлена в виде строки, значение в кавычках отметки должны быть действительными. Например: «1234,56».

Примечание:

• AppsFlyer отображает точную выручку, отправленную из SDK. Эти данные не включают никаких расчётов НДС, комиссий магазина приложений и т. п., кроме случаев, когда это предусмотрено разработчиком на стороне SDK перед отправкой в AppsFlyer.

Параметр af_currency содержит обозначение валюты, указанной в параметре af_revenue (или af_price). Если в параметрах события нет af_currency, AppsFlyer отправляет его со значением по умолчанию – «USD».

Можно использовать af_price как денежный параметр, который не считается доходом (как, например, в событии «Добавить в корзину»).  Этот параметр относится к цене отдельного элемента. Общая сумма всех покупок отображается параметром af_revenue.

Важно понимать, как AppsFlyer обрабатывает настройки валюты и конвертацию валют.

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

На диаграмме выше показан следующий процесс:

1. События в приложении отправляются — для каждого события используется разная валюта.
2. AppsFlyer нормализует все валюты до доллара США.
3. AppsFlyer обрабатывает данные о выручке.
4. Данные о выручке отображаются в дэшборде в соответствии с настройками приложения. знаков валюты
5. AppsFlyer заполняет данные о выручке в отчетах о необработанных данных как в валюте событий, так и приложений. валюта событий и приложений.

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

Конвертация валюты

Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.REVENUE,200);
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE,"category_a");
eventValue.put(AFInAppEventParameterName.CONTENT_ID,"1234567");
eventValue.put(AFInAppEventParameterName.CURRENCY,"EUR");
AppsFlyerLib.getInstance().trackEvent(getApplicationContext() , AFInAppEventType.PURCHASE , eventValue);

Отображение валюты

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

После того как вы определите, какие in-app события вы хотите измерять, использовать наш Генератор внутренних событий приложения, чтобы задать события и параметры следующим образом:

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

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

Бизнес-сектор	Название статьи
	Рекомендуемые события для приложений в сфере гейминга
	Рекомендуемые события для приложений электронной коммерции
	Рекомендуемые события для развлекательных приложений
	Рекомендуемые события для финансовых и банковских приложений
	Рекомендуемые события для приложений P2P-кредитования
	Рекомендуемые события для приложений онлайн-образования
	Рекомендуемые события для приложений заказа поездок
	Рекомендуемые события для приложений бронирования авиабилетов
	Рекомендуемые события для приложений бронирования отелей
	Рекомендуемые события для приложений здравоохранения
	Рекомендуемые события для телекоммуникационных приложений
	Рекомендуемые события для приложений eWallet
	Рекомендуемые события для ставок на спорт

События в приложении атрибутируются медиа-источнику, ответственному за установку, на протяжении всего жизненного цикла пользователя. Данные о событиях представлены как Пожизненная ценность (LTV) или данные об активности. 

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

• Обзорная страница Дэшборда: Отображает реальную эффективность привлечения пользователей (UA) и LTV. Примечание: Это включает выручку, разделенную между органическими и неорганическими пользователями, зарегистрированную через события в приложении, а также выручку от ретаргетинга, который учитывается дважды.
• Страница событий: Отображает эффективность LTV in-app события через медиа-источники.
• Страница активности: Отображает внутренние активности за выбранный диапазон дат.

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

  {
    "af_level":"10",
    "af_score":"3387",
    "arena":"7",
    "char_type":"paladin"
  }

  Обратите внимание, что отчетность по сырым данным является премиум-функцией.

При определении названий и параметров событий в приложении держите в уме следующее:

• Для обеспечения согласованности данных в отчетности по необработанным данным мы рекомендуем определять и использовать одинаковые названия и структуры внутренних событий приложения на всех платформах.
• Используйте минимальное количество событий, чтобы было проще сравнивать качество пользователей, приходящих из разных источников.
• Важно обеспечить конфиденциальность ваших пользователей. Не заполняйте ценности, значения внутренних событий приложения данными, которые могут напрямую их идентифицировать. Например, адрес электронной почты, имя, идентификационный номер, а в некоторых местах — почтовый индекс. Для получения дополнительной информации об ограниченных данных ознакомьтесь с Политикой конфиденциальности услуг.
• Обратите внимание, что AppsFlyer включает IP адрес устройств во время взаимодействий. В некоторых юрисдикциях или сценариях использования IP адрес может рассматриваться как персональная информация. Мы используем IP адрес для определения общего географического местоположения (уровень города, района) устройства, но не конкретного адреса. При необходимости вы можете маскировать IP адреса, чтобы они не отображались в Отчетах о необработанных данных.
• Единственным источником данных о выручке в AppsFlyer являются in-app события. Вы можете присвоить каждому событию определенное значение выручки и просмотреть его на Дэшборде вашего приложения. Узнать больше о параметрах монетизации. altrevenue_data.pngalt

При определении названий и параметров событий в приложении держите в уме следующее:

• Для названий внутренних событий приложения мы рекомендуем использовать только строчные буквенно-цифровые символы (a-z и 0-9). Названия событий чувствительны к регистру, то есть af_purchase и af_PURCHASE – это два разных события в сырых данных. Однако в сводных отчетах и дэшбордах (например, обзорном или для событий) разрешены только строчные буквы, и поэтому они могут отображаться как одно событие.
• Ограничение на количество уникальных событий составляет 300 в день. Узнать больше
• Уникальные пользователи учитываются только для первых 100 событий после установки приложения.
• Имена событий не могут начинаться с этих символов: " = + -
• Значения событий не должны содержать символ +, за исключением случаев в закодированных URL-адресах или кодированных в соответствии с ASCII.
• Имена событий не могут содержать пустых пробелов. Вы можете использовать подчеркивания (нижние тире) до или после названия события.
• Значения событий не должны превышать 2000 символов, чтобы избежать их сокращения в отчетах о необработанных данных. Однако, если событие поступает из SDK (пакет средств разработки ПО), рекомендуется ограничить его длину до 1000 символов, чтобы гарантировать, что нагрузка не будет урезана при отправке в HTTP-запросе.
• Если вы указываете ссылающийся URL-адрес в качестве значения события, он должен быть закодирован в URL.
• Медиа-реклама имеет некоторые ограничения для названий событий и параметров. Подробнее об ограничениях здесь.

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

af_currency обозначает валюту, указанную в af_revenue (или af_price). Если из параметров события отсутствует af_currency, AppsFlyer отправляет его со значением по умолчанию «USD».

Дополнительную информацию о параметре af_revenue смотрите в Руководстве по Атрибуции выручки.

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

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

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

События недавно ретаргетированных пользователей могут иметь двойную атрибуцию.

AppsFlyer атрибутирует события установок как органические, если:

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

Если пользователь инициирует событие при отсутствии интернет-соединения, AppsFlyer все равно сможет его зафиксировать. Вот как это работает:

1. SDK отправляет события на серверы AppsFlyer и ожидает успешного ответа.
2. Если SDK не получает успешный ответ, событие сохраняется в кэше.
3. Как только следующий успешный ответ получен, сохраненное событие повторно отправляется на сервер.
4. Если в кэше несколько событий, они отправляются на сервер поочередно.

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

Они полезны, когда необходимо видеть несколько связанных действий пользователя, сгруппированных вместе (например, добавление нескольких товаров в корзину за одну сессию). Дополнительную информацию о комплексных событиях Meta Ads см. в Отправка комплексных внутренних событий приложения в Meta Ads.
Пример:

{
   "af_revenue": 4.99,
   "af_currency": "USD",
   "af_order_id": "12345",
   "af_content_list":"[\"ID1\",\"ID2\",\"ID3\"]",
   "af_content":"[
      {
         \"id\":\"ID1\",
         \"quantity\":\"1\"
      },
      {
         \"id\":\"ID2\",
         \"quantity\":\"1\"
      },
      {
         \"id\":\"ID3\",
         \"quantity\":\"2\"
      }
   ]"
}

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

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

"{\"af_content_id\": [\"123\",\"988\",\"399\"], \"af_quantity\": [\"2\",\"1\",\"1\"], \"af_price\": [\"25\",\"50\",\"10\"], \"af_revenue\": \"110\", \"af_currency\": \"USD\"}"

У нас есть механизм дедупликации событий в приложениях. Механизм проверяет все события в приложении, чтобы выяснить, было ли идентичное событие, поступившее с тем же идентификатором AppsFlyer менее чем за 10 секунд до этого. Если такое событие обнаруживается, механизм удаляет дубликат.

Два события считаются идентичными, если в обоих совпадают следующие поля:

• Имя события
• Значение события
• Идентификатор приложения
• AppsFlyer ID

Срок хранения сырых данных на уровне пользователя в AppsFlyer зависит от типа интеграции и требований партнёра. Агрегированные данные могут храниться до пяти лет

Сроки хранения могут различаться в зависимости от медиаисточника и методов доставки (например, Data Locker или Pull API), а также могут меняться в связи с юридическими, контрактными или партнёрскими обязательствами.

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

• Android SDK и iOS SDK автоматически добавляют параметр ОС (операционной системы).
• Для S2S API, начиная с 1 июля 2021 года, необходимо отправлять параметр ОС для iOS приложений. Если этот параметр не отправлен, данные считаются полученными от пользователя iOS 14.5, что влияет на доступность необработанных данных.