---
title: "Custom S3"
description: "Экспортируйте данные о привлечении пользователей в собственное S3-совместимое хранилище для расширенной аналитики и отчётности."
---

Интеграция Adapty UA с S3-совместимым хранилищем позволяет безопасно хранить данные о кампаниях по привлечению пользователей в вашем собственном решении. Вы сможете сохранять данные о производительности кампаний, атрибуцию и события привлечения пользователей в виде .csv-файлов в вашем S3-бакете.  
Для настройки интеграции нужно выполнить несколько простых шагов в консоли S3-совместимого хранилища и на дашборде Adapty UA.

:::note
Adapty UA отправляет данные каждые **24 часа** в 4:00 UTC.

Каждый файл будет содержать данные о событиях, созданных за предыдущий календарный день по UTC. Например, файл, автоматически экспортированный в 4:00 UTC 8 марта, будет содержать все события, созданные 7 марта с 00:00:00 до 23:59:59 UTC.
:::

## Настройка интеграции с Custom S3 \{#set-up-custom-s3-integration\}

Чтобы начать получать данные, настройте интеграцию в Adapty UA:

1. Перейдите в [**Integrations** -> **Custom S3**](https://app.adapty.io/ua/integrations/custom-s3)
2. Включите переключатель **Export install events to custom S3**.
3. Заполните обязательные поля для подключения вашего 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 и т.д.).                                                                                                |

:::note
В поле имени S3-бакета можно указывать вложенные директории, например: `adapty-ua-events/com.sample-app`
:::

## Ручной экспорт данных \{#manual-data-export\}

Помимо автоматического экспорта данных о событиях в ваше S3-хранилище, Adapty UA поддерживает ручной экспорт файлов. С помощью этой функции вы можете выбрать дату и экспортировать данные о привлечении пользователей в S3-бакет вручную. Это даёт больший контроль над тем, какие данные и когда экспортировать.

## Структура таблицы \{#table-structure\}

В интеграции с Custom S3 Adapty UA предоставляет таблицу для хранения исторических данных о событиях установки. Таблица содержит информацию о профиле пользователя, выручке и поступлениях, источнике стора и другие данные.

:::warning
Обратите внимание: структура таблицы может расширяться со временем — мы или сторонние партнёры можем добавлять новые поля. Убедитесь, что ваш код обработки данных достаточно гибкий и опирается на конкретные поля, а не на структуру целиком.
:::

Структура таблицы событий:

| Колонка                  | Описание                                              |
|--------------------------|-------------------------------------------------------|
| `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                                  |