In-app события

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

Внутренние события приложения: руководства по SDK

Анатомия события

Внутреннее событие приложения состоит из двух частей:

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

Имена и параметры событий могут быть предопределенными или настраиваемыми.

👍

Совет

Быстро определяйте и генерируйте код внутренних событий приложения для всех основных платформ с помощью нашего генератора внутренних событий приложения.

Константы событий

В SDK предопределенные события и параметры представлены константами.

При отправке событий рекомендуется использовать константы вместо неформатированных строк:

• Это снижает вероятность расхождений в именах.
• Изменения в соответствующих событиях/параметрах прозрачны и требуют меньше усилий.

Технически предопределенные имена/параметры событий — это строки с префиксом af_.

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

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

🚧

Внимание!

Чтобы избежать путаницы с предопределенными событиями, не используйте в именах настраиваемых событий префикс af_.

Valid custom event names

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

• Должны содержать не более 100 символов.
• Можно использовать не только латинские (английские) символы.

Valid custom event parameters

Параметры настраиваемых событий:

• Не более 1000 символов; более длинные значения могут быть урезаны
• В значениях цены и дохода можно использовать только цифры и десятичную точку, например 5 или 5.2.
• Значения цены и дохода могут иметь не более 5 знаков после десятичной точки, например 5.12345.

Определения структуры событий

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

• Первый столбец (Имя события) — это значение, которое вы передаете как второй аргумент параметра logEvent.

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

• Во втором столбце (Параметры события) перечислены параметры, связанные с событием. В данном случае вы должны передать следующие параметры события в logEvent:

  • af_price
  • af_content_type
  • af_content_id

• Третий столбец (Значения параметров) содержит дополнительную информацию о конкретных значениях, присвоенных параметрам событий. В примере выше маркетолог четко сообщает, что значением параметра события af_content_id должен быть артикул просматриваемого товара.

• В четвертом столбце маркетолог описывает, когда и где в приложении должно произойти событие.

Ознакомьтесь с реализацией приведенного выше определения для Android и iOS.

Внутренние события приложения в режиме офлайн

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

• SDK отправляет такие события на серверы AppsFlyer и ждет ответа.
• Если SDK не получает ответ «200», события кэшируются.
• Как только ответ «200» получен, сохраненные события повторно отправляются на сервер.
• Если в кэше хранится несколько событий, они отправляются на сервер одно за другим (без пакетирования, один сетевой запрос на событие).

SDK может кэшировать до 40 событий. Сохраняются только первые 40 офлайн-событий. Все последующие события отклоняются (до следующего успешного ответа).