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

Если вы также хотите передавать выручку с учётом собственной логики — например, за вычетом комиссии магазина и налогов — можно дополнительно отправлятьaf_net_revenue . Это дополнение кaf_revenue, не замена. См. «Чистый доход» ниже.

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

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

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

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

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

Примечание:

• AppsFlyer отображает точную выручку, отправленную из SDK вaf_revenue Эти данные не включают никаких расчетов НДС, комиссий магазина приложений и т. п., кроме случаев, когда это предусмотрено разработчиком на стороне SDK перед отправкой в AppsFlyer. Если вы хотите отправить отчет о доходах после таких вычетов, отправьте их дополнительно.af_net_revenue (см. Чистая выручка).

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

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

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

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

• Валюта следуетaf_currency (по умолчанию доллары США), аналогичноaf_revenue .
• Поскольку нет предопределенной константы SDK для af_net_revenue, необходимо передать его в качестве пользовательского параметра вместе с ключом.af_net_revenue .
• Чистая выручка лежит в основе «чистых» метрик (чистая выручка, чистый ROI, чистый ROAS, чистый ARPU и чистая валовая прибыль) в «Моих дэшбордах».

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

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

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

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

AppsFlyer использует Open Exchange Rates для конвертации валют. Курс обмена обновляется ежечасно. Всякий раз, когда 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 смотрите в Руководстве по Атрибуции выручки.

Если вы также хотите отправлять отчет по доходу с применением собственной логики, например, после вычета комиссий и налогов, отправьте af_net_revenueпоскольку пользовательский параметр наряду сaf_revenue .af_net_revenue не заменяетaf_revenue . Для получения более подробной информации см. раздел «Чистая выручка» .

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

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

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

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

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

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

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

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

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

Чтобы структурировать сложное событие в приложении, используйте af_content в качестве массива JSON. Каждый объект в массиве должен включать id и quantity. af_content_list является необязательным и может быть опущен.

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

Полную информацию об отправке сложных событий в приложении в Meta см. в Отправка сложных событий в приложении в Meta ads.

Примечание: Аудитории 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, что влияет на доступность необработанных данных.