Google Cloud Storage

Adapty UA 与 Google Cloud Storage 的集成允许您将用户获取活动数据安全地存储在一个中心位置。您可以将活动效果数据、归因数据和用户获取事件以 .csv 文件的形式保存到您的 Google Cloud Storage 存储桶中。
要设置此集成，您需要在 Google Cloud Console 和 Adapty UA 看板中执行几个简单的步骤。

调度计划

Adapty UA 每 24 小时在 UTC 时间 4:00 将您的数据发送到 Google Cloud Storage。

每个文件将包含前一个完整日历日（UTC 时间）内创建的事件数据。例如，3 月 8 日 UTC 时间 4:00 自动导出的数据将包含 3 月 7 日 UTC 时间 00:00:00 至 23:59:59 期间创建的所有事件。

如何设置 Google Cloud Storage 集成

步骤 1. 创建 Google Cloud Storage 凭证

本指南将帮助您在 Google Cloud Platform Console 中创建必要的凭证。

为使 Adapty UA 能够将原始数据报告上传到您指定的存储桶，需要提供服务账号密钥以及对应存储桶的写入权限。通过提供服务账号密钥并授予存储桶写入权限，您允许 Adapty UA 安全高效地将原始数据报告从其平台传输到您的存储环境。

请注意，我们仅支持 Service Account HMAC 密钥授权，因此必须确保您的 Service Account HMAC 密钥已添加”Storage Object Viewer”、“Storage Legacy Bucket Writer”和”Storage Object Creator”角色，以启用对 Google Cloud Storage 的正确访问。

2.1. 创建服务账号

  1. 前往您 Google Cloud 账号的 IAM 部分，选择相关项目或创建一个新项目
30a81ef-CleanShot_2023-03-17_at_15.22.142x.webp
  1. 接下来，点击”+ CREATE SERVICE ACCOUNT”按钮，为 Adapty UA 创建一个新的服务账号
98f8ebf-CleanShot_2023-03-17_at_15.40.062x.webp
  1. 填写第一步中的字段，访问权限将在后续阶段授予。如需了解此页面的更多详情，请阅读此处的文档
2190c50-CleanShot_2023-03-17_at_15.48.552x.webp
  1. 要创建并下载私有 JSON 密钥，请导航至 KEYS 部分并点击”ADD KEY”按钮
8a45468-CleanShot_2023-03-17_at_15.58.092x.webp
  1. 在 DETAILS 部分，找到与最近创建的服务账号关联的 Email 值并复制。此信息在后续步骤中将用于授权账号并允许其写入存储桶
6ccd0f0-CleanShot_2023-03-17_at_16.03.162x.webp

2.2. 配置存储桶权限

  1. 前往 Google Cloud Storage 的存储桶页面，选择现有存储桶或创建一个新存储桶，用于存储来自 Adapty UA 的用户获取数据报告
  2. 导航至 PERMISSIONS 部分，选择授予访问权限选项
3cdd937-CleanShot_2023-03-17_at_16.14.232x.webp
  1. 在 PERMISSIONS 部分，输入第五步中获取的服务账号 Email，然后选择 Storage Object Creator 角色
  2. 最后，点击 SAVE 应用更改
62801f4-CleanShot_2023-03-17_at_16.17.312x.webp

  1. 请记住存储桶的名称以备后用

  2. 完成上述步骤后，您已成功完成 Google Cloud Console 中的必要配置！最后一步是在 Adapty UA 中输入存储桶名称并上传 JSON 文件

c967e16-CleanShot_2023-03-17_at_16.23.332x.webp

步骤 2. 在 Adapty UA 中配置集成

  1. 前往 Integrations -> Google Cloud Storage
  2. 开启 Export install events to Google Cloud Storage 开关
  3. 填写所需字段以在 Google Cloud Storage 和 Adapty UA 之间建立连接：
字段描述
Google Cloud service account key file下载的私有 JSON 密钥文件。
Google Cloud bucket nameGoogle Cloud Storage 中用于存储数据的存储桶名称。该名称在 Google Cloud Storage 环境中必须唯一，且不能包含空格。
Folder inside the bucket存储桶内用于存储数据的文件夹名称。该名称在存储桶内必须唯一，可用于整理您的数据。此字段为可选填写。
ua-google-cloud.webp

手动数据导出

除了自动将事件数据导出到 Google Cloud Storage 外，Adapty UA 还提供手动文件导出功能。通过此功能，您可以选择特定日期的用户获取数据并手动将其导出到您的 GCS 存储桶。这使您能够更好地控制导出的数据内容和导出时间。

数据表结构

在 Google Cloud Storage 集成中，Adapty UA 提供一个表来存储安装事件的历史数据。该表包含用户画像信息、收入和收益、来源商店等数据。

请注意，此结构可能会随时间增长——我们或我们合作的第三方可能会引入新数据。请确保您处理该数据的代码足够健壮，依赖特定字段而非整体结构。

以下是事件的数据表结构：

列名描述
adapty_profile_idAdapty 用户画像唯一标识符
install_id安装唯一标识符
created_at记录创建时间戳（ISO 8601）
installed_at应用安装时间戳（ISO 8601）
store应用商店（ios、android）
country用户国家代码（ISO 3166-1 alpha-2）
ip_address客户端 IP 地址
idfaiOS 广告标识符
idfviOS 供应商标识符
gaidGoogle 广告 ID（Android）
android_idAndroid 设备 ID
app_set_idAndroid App Set ID
channel归因渠道
campaign_id活动标识符
campaign_name活动名称
adset_id广告组标识符
adset_name广告组名称
ad_id广告标识符
ad_name广告名称
keyword_id关键词标识符
keyword_name关键词名称
asa_org_idApple Search Ads 组织 ID
asa_keyword_match_typeASA 关键词匹配类型（Exact、Broad）
asa_attributionASA 归因数据（JSON 字符串）
asa_conversion_typeASA 转化类型
asa_country_or_regionASA 国家或地区
asa_creative_set_nameASA 创意组名称
fbclidFacebook 点击 ID
ttclidTikTok 点击 ID
utm_sourceUTM 来源参数
utm_mediumUTM 媒介参数
utm_campaignUTM 活动参数
utm_termUTM 词条参数
utm_contentUTM 内容参数