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

Каждый раз, когда вы отправляете события в приложении, такие как покупка или бронирование перелета, вы отправляете их с соответствующей выручкой. Единственным параметром, несущим выручку в событиях в приложении, является 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?

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

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

      "event_value": {
          "af_projected_revenue": 0.79
      }

Прогнозируемая выручка в дэшборде AppsFlyer и отчетах

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

Отправлять постбэки прогнозируемой выручки

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

Важно понимать, как 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.

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

{
  "af_revenue":"50.87",
  "af_currency":"USD",
  "af_receipt_id":"57601333",
  "product":[ 
   { 
	 "af_content_id":"1164_8186",
	 "af_price":"8.97",
	 "af_quantity":"1"
   },
   { 
	 "af_content_id":"1164_8186",
	 "af_price":"8.97",
	 "af_quantity":"1"
   },
   { 
	 "af_content_id":"1164_8186",
	 "af_price":"8.97",
	 "af_quantity":"1"
   },
   { 
	 "af_content_id":"1177_8185",
	 "af_price":"8.97",
	 "af_quantity":"1"
   },
   { 
	 "af_content_id":"0153_9077",
	 "af_price":"14.99",
	 "af_quantity":"1"
   }
  ]
}

Вы можете добавить несколько товаров в одну транзакцию. Вместо отдельных значений для параметра события можно использовать массив элементов, описывающих транзакцию, разделённых запятыми. Формат должен быть строкой 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 хранит данные на уровне пользователя (необработанные данные) в течение 24 месяцев, если иное не предусмотрено, не требуется или не разрешено законом. Некоторые SRN/партнеры требуют от атрибуционных поставщиков, включая AppsFlyer, удаления данных уровня пользователя, связанных с ними, до истечения 24-месячного периода.

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

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