Google Cloud Storage
Интеграция Adapty UA с Google Cloud Storage позволяет централизованно и безопасно хранить данные кампаний по привлечению пользователей. Вы сможете сохранять данные о результативности кампаний, данные атрибуции и события привлечения пользователей в виде .csv-файлов в своём бакете Google Cloud Storage.
Для настройки интеграции потребуется выполнить несколько простых шагов в Google Cloud Console и дашборде Adapty UA.
Расписание
Adapty UA отправляет данные в Google Cloud Storage каждые 24 часа в 4:00 UTC.
Каждый файл содержит данные о событиях за весь предыдущий календарный день по UTC. Например, данные, автоматически экспортированные в 4:00 UTC 8 марта, охватывают все события, созданные 7 марта с 00:00:00 до 23:59:59 UTC.
Как настроить интеграцию с Google Cloud Storage
Шаг 1. Создайте учётные данные Google Cloud Storage
Этот гайд поможет создать необходимые учётные данные в консоли Google Cloud Platform.
Чтобы Adapty UA мог загружать отчёты с исходными данными в ваш бакет, необходим ключ сервисного аккаунта и доступ на запись в соответствующий бакет. Предоставив ключ сервисного аккаунта и разрешив запись в бакет, вы позволяете Adapty UA безопасно и эффективно передавать отчёты с исходными данными в вашу среду хранения.
Обратите внимание: поддерживается только авторизация через HMAC-ключ сервисного аккаунта. Убедитесь, что вашему HMAC-ключу сервисного аккаунта назначены роли «Storage Object Viewer», «Storage Legacy Bucket Writer» и «Storage Object Creator» — это необходимо для корректного доступа к Google Cloud Storage.
2.1. Создайте сервисный аккаунт
- Перейдите в раздел IAM вашего аккаунта Google Cloud и выберите нужный проект или создайте новый
- Создайте новый сервисный аккаунт для Adapty UA, нажав кнопку + CREATE SERVICE ACCOUNT
- Заполните поля на первом шаге — доступы будут настроены позже. Подробнее об этой странице можно прочитать в документации
- Чтобы создать и скачать приватный JSON-ключ, перейдите в раздел KEYS и нажмите кнопку ADD KEY
- В разделе DETAILS найдите Email, привязанный к только что созданному сервисному аккаунту, и скопируйте его. Эти данные понадобятся на следующих шагах для авторизации аккаунта и предоставления прав на запись в бакет
2.2. Настройте права доступа к бакету
- Перейдите на страницу Buckets в Google Cloud Storage и выберите существующий бакет или создайте новый для хранения отчётов по привлечению пользователей из Adapty UA
- Перейдите в раздел PERMISSIONS и выберите опцию GRANT ACCESS
- В разделе PERMISSIONS введите Email сервисного аккаунта, полученный на пятом шаге, и выберите роль Storage Object Creator
- Нажмите SAVE, чтобы применить изменения
-
Запомните название бакета — оно понадобится в дальнейшем
-
После выполнения всех этих шагов настройка в Google Cloud Console завершена. Остаётся только ввести название бакета и загрузить JSON-файл в Adapty UA
Шаг 2. Настройте интеграцию в Adapty UA
- Перейдите в Integrations -> Google Cloud Storage
- Включите переключатель Export install events to Google Cloud Storage
- Заполните обязательные поля для подключения Google Cloud Storage к Adapty UA:
| Поле | Описание |
|---|---|
| Google Cloud service account key file | Скачанный приватный JSON-файл ключа. |
| Google Cloud bucket name | Название бакета в Google Cloud Storage, в котором будут храниться данные. Должно быть уникальным в рамках среды Google Cloud Storage и не содержать пробелов. |
| Folder inside the bucket | Название папки внутри бакета для хранения данных. Должно быть уникальным в рамках бакета и может использоваться для организации данных. Поле необязательно для заполнения. |
Ручной экспорт данных
Помимо автоматического экспорта событий в Google Cloud Storage, Adapty UA поддерживает ручной экспорт файлов. С его помощью можно выбрать конкретную дату и вручную экспортировать данные по привлечению пользователей в бакет GCS. Это даёт больше контроля над тем, какие данные и когда экспортировать.
Структура таблицы
В интеграции с Google Cloud Storage 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 | Идентификатор организации 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 |