Custom S3 в Adapty Attribution
Интеграция Adapty Attribution с пользовательским S3-совместимым хранилищем позволяет безопасно хранить данные кампаний по привлечению пользователей в вашем собственном S3-совместимом решении. Вы сможете сохранять данные об эффективности кампаний, данные атрибуции и события привлечения пользователей в ваш S3-бакет в формате .csv.
Чтобы настроить интеграцию, выполните несколько простых шагов в консоли вашего S3-совместимого хранилища и дашборде Adapty Attribution.
Adapty Attribution отправляет данные каждые 24 часа в 4:00 UTC. Каждый файл содержит данные о событиях, созданных за весь предыдущий календарный день по UTC. Например, данные, экспортируемые автоматически в 4:00 UTC 8 марта, охватывают все события, созданные 7 марта с 00:00:00 до 23:59:59 по UTC.
Настройка интеграции с Custom S3
Чтобы начать получать данные, настройте интеграцию в Adapty Attribution:
- Перейдите в Integrations -> Custom S3
- Включите переключатель Export install events to custom S3.
- Заполните обязательные поля для установки соединения между вашим хранилищем Custom S3 и профилями Adapty Attribution. | Поле | Описание | |:----------------------------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | 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 bucket, например adapty-ua-events/com.sample-app
Ручной экспорт данных
Помимо автоматического экспорта данных о событиях в ваше S3-хранилище, Adapty UA поддерживает ручной экспорт файлов. С помощью этой функции вы можете выбрать дату и экспортировать данные о привлечении пользователей в S3-бакет вручную. Это даёт больший контроль над тем, какие данные и когда экспортировать.
Структура таблицы
В кастомной S3-интеграции Adapty Attribution предоставляет таблицу для хранения исторических данных о событиях установки. Таблица содержит информацию о профиле пользователя, выручке и поступлениях, исходном сторе и других параметрах.
Обратите внимание, что эта структура может расширяться со временем — по мере добавления новых данных нами или сторонними сервисами, с которыми мы работаем. Убедитесь, что ваш код, обрабатывающий эти данные, достаточно устойчив и опирается на конкретные поля, а не на структуру в целом.
Ниже приведена структура таблицы для событий:
| Столбец | Описание |
|---|---|
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 |
bundle_id | Идентификатор бандла приложения (например, com.example.app) |
device_brand | Бренд устройства (например, Apple, Samsung) |
device_model | Модель устройства (например, iPhone15,2) |
os_version | Основная версия ОС |
app_version | Версия приложения, переданная Adapty SDK |
sdk_version | Версия Adapty SDK |
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 |