Custom S3
Интеграция Adapty UA с S3-совместимым хранилищем позволяет безопасно хранить данные о кампаниях по привлечению пользователей в вашем собственном решении. Вы сможете сохранять данные о производительности кампаний, атрибуцию и события привлечения пользователей в виде .csv-файлов в вашем S3-бакете.
Для настройки интеграции нужно выполнить несколько простых шагов в консоли S3-совместимого хранилища и на дашборде Adapty UA.
Adapty UA отправляет данные каждые 24 часа в 4:00 UTC.
Каждый файл будет содержать данные о событиях, созданных за предыдущий календарный день по UTC. Например, файл, автоматически экспортированный в 4:00 UTC 8 марта, будет содержать все события, созданные 7 марта с 00:00:00 до 23:59:59 UTC.
Настройка интеграции с Custom S3
Чтобы начать получать данные, настройте интеграцию в Adapty UA:
- Перейдите в Integrations -> Custom S3
- Включите переключатель Export install events to custom S3.
- Заполните обязательные поля для подключения вашего S3-хранилища к профилям Adapty UA.
| Поле | Описание |
|---|---|
| Access Key ID | Уникальный идентификатор для аутентификации пользователя или приложения в вашем S3-совместимом хранилище. Найдите его в консоли вашего провайдера. |
| Secret Access Key | Приватный ключ, используемый совместно с Access Key ID для аутентификации пользователя или приложения в вашем S3-совместимом хранилище. Найдите его в консоли вашего провайдера. |
| S3 Bucket Name | Глобально уникальное имя, идентифицирующее конкретный S3-бакет в вашем хранилище. S3-бакеты — это простой сервис хранения, позволяющий сохранять и получать объекты данных, такие как файлы и изображения, в облаке. |
| Region (необязательно) | Получите значение Region в Management Console. |
| Folder Inside the Bucket (необязательно) | Название папки внутри выбранного S3-бакета. Обратите внимание, что S3 имитирует папки с помощью префиксов ключей объектов, которые по сути являются именами папок. |
| Custom Endpoint URL | URL эндпоинта вашего S3-совместимого хранилища. Его предоставляет провайдер хранилища (например, MinIO, DigitalOcean Spaces, Wasabi и т.д.). |
В поле имени S3-бакета можно указывать вложенные директории, например: adapty-ua-events/com.sample-app
Ручной экспорт данных
Помимо автоматического экспорта данных о событиях в ваше S3-хранилище, Adapty UA поддерживает ручной экспорт файлов. С помощью этой функции вы можете выбрать дату и экспортировать данные о привлечении пользователей в S3-бакет вручную. Это даёт больший контроль над тем, какие данные и когда экспортировать.
Структура таблицы
В интеграции с Custom S3 Adapty UA предоставляет таблицу для хранения исторических данных о событиях установки. Таблица содержит информацию о профиле пользователя, выручке и поступлениях, источнике стора и другие данные.
Обратите внимание: структура таблицы может расширяться со временем — мы или сторонние партнёры можем добавлять новые поля. Убедитесь, что ваш код обработки данных достаточно гибкий и опирается на конкретные поля, а не на структуру целиком.
Структура таблицы событий:
| Колонка | Описание |
|---|---|
adapty_profile_id | Уникальный идентификатор профиля Adapty |
install_id | Уникальный идентификатор установки |
created_at | Временная метка создания записи (ISO 8601) |
installed_at | Временная метка установки приложения (ISO 8601) |
store | Магазин приложений (ios, android) |
country | Код страны пользователя (ISO 3166-1 alpha-2) |
ip_address | IP-адрес клиента |
idfa | iOS Identifier for Advertisers |
idfv | iOS Identifier for Vendors |
gaid | Google Advertising ID (Android) |
android_id | Идентификатор устройства Android |
app_set_id | Android App Set ID |
channel | Канал атрибуции |
campaign_id | Идентификатор кампании |
campaign_name | Название кампании |
adset_id | Идентификатор группы объявлений |
adset_name | Название группы объявлений |
ad_id | Идентификатор объявления |
ad_name | Название объявления |
keyword_id | Идентификатор ключевого слова |
keyword_name | Ключевое слово |
asa_org_id | ID организации Apple Search Ads |
asa_keyword_match_type | Тип соответствия ключевого слова ASA (Exact, Broad) |
asa_attribution | Данные атрибуции ASA (JSON-строка) |
asa_conversion_type | Тип конверсии ASA |
asa_country_or_region | Страна или регион ASA |
asa_creative_set_name | Название набора креативов ASA |
fbclid | Facebook Click ID |
ttclid | TikTok Click ID |
utm_source | Параметр UTM source |
utm_medium | Параметр UTM medium |
utm_campaign | Параметр UTM campaign |
utm_term | Параметр UTM term |
utm_content | Параметр UTM content |