# Работа с API AppsFlyer на R

    library(rappsflyer)
    #> INFO  [09:17:00.325] Set api_token from system variable APPSFLYER_API_TOKEN
    #>
    #> ---------------------
    #> Welcome to rappsflyer version 0.2.0
    #>
    #> Author:           Alexey Seleznev (Head of analytics dept at Netpeak).
    #> Telegram channel: https://t.me/R4marketing
    #> Email:            selesnow@gmail.com
    #> Blog:             https://alexeyseleznev.wordpress.com
    #> Facebook:         https://facebook.com/selesnown
    #> Linkedin:         https://www.linkedin.com/in/selesnow
    #>
    #> Type ?rappsflyer for the main documentation.
    #> The github page is: https://github.com/selesnow/rappsflyer/
    #>
    #> Suggestions and bug-reports can be submitted at: https://github.com/selesnow/rappsflyer/issues
    #> Or contact: <selesnow@gmail.com>
    #>
    #>  To suppress this message use:  suppressPackageStartupMessages(library(rappsflyer))
    #> ---------------------

# Авторизационный токен

Для работы с API AppsFlyer вам необходимо получить авторизационный токен. Более подробно об этом можно узнать в этой статье.

Если в кратце то администраторы могут выдавать пользователям токены.

Где найти авторизационный токен

После того как вам выдали авторизационный токен вы можете установить его в своей R сессии функцией `af_set_api_token()`, передав в качестве единственного аргумента ваш API токен.

Так же вы можете сохранить токен в переменной среды `APPSFLYER_API_TOKEN`, в таком случае при загрузке пакета токен будет прочитан автоматически.

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

# Приложение по которому вы запрашиваете данные

В каждой из функций есть аргумент `app_id` в который необходимо передавать id вашего приложения, найти id можно в интерфейсе AppsFlyer.

Где найти ID приложения

# Запрос данных из API AppsFlyer

После того как установили свой API token вы можете запрашивать данные из Pull API. Для большего понимания структуры пакета `rappsflyer` вы можете перейти в интерфейсе AppsFlyer в Интеграции > API Доступ.

API Доступ

Каждая из функций пакета соответвует определённому разделу API доступа.

## Агрегированные данные (Aggregate (user acquisition and retargeting))

Для работы с агрегированными отчётами используйте функцию `af_get_aggregate_data()`.

Аргументы:

- date_from - начальная дата
- date_to - конечная дата
- report_type - тип отчёта
  - partners_report - Партнеры (медиаисточник)
  - partners_by_date_report - Партнеры — по датам
  - daily_report - Ежедневно
  - geo_report - Геоданные
  - geo_by_date_report - Геоданные — по датам
- additional_fields - дополнительные поля отчёта
- media_source - фильтр по источнику
- attribution_touch_type - Установите этот параметр, чтобы получить ключевые показатели эффективности атрибуции (VTA). Например: `attribution_touch_type="impression"`
- currency - Валюта выручки и стоимость. Агрегированные отчеты Pull API всегда используют валюту приложения.
- timezone - Часовой пояс
- retargeting - Получить данные по конверсии ретаргетинга.

Официальная справка по получению агрегированных отчётов из API AppsFlyer доступна по ссылке.

## Отчеты по сырым данным

Для получения сырых данных используйте функцию `af_get_raw_data()`.

Доступные в ней типы отчётов:

- installs_report
- in_app_events_report
- uninstall_events_report

Официальная справка по получению отчётов с сырыми данными из API AppsFlyer доступна по ссылке.

## Отчёты по рекламной прибыли

Для полученния этой группы отчётов используйте функцию `af_get_ad_revenue_raw_data()`.

Ссылка на официальную документацию.

## Группа отчётов по неудачным установкам и событиям

Для получения отчётов из данной группы используйте функцию `af_get_targeting_validation_rules()`.

Доступные типы отчётов:

- invalid_installs_report
- invalid_in_app_events_report