Adapty Attribution 中的 Google Cloud Storage
Adapty Attribution 与 Google Cloud Storage 的集成允许您将用户获取活动数据安全地存储在一个中心位置。您可以将活动效果数据、归因数据和用户获取事件以 .csv 文件格式保存到 Google Cloud Storage 存储桶中。
要设置此集成，您需要在 Google Cloud Console 和 Adapty Attribution 看板中完成几个简单步骤。
计划
Adapty Attribution 每个日历日向 Google Cloud Storage 导出一组文件。导出调度器每天运行三次——分别在 UTC 02:00、04:00 和 06:00。每次运行要么创建前一天的导出任务（如果尚不存在），要么在之前的运行失败时重试。因此，您的数据通常在 02:00 运行后即可获取，后续运行的目的是从失败中恢复，而非新增数据。
每个文件将包含前一个完整日历日（UTC）内产生的事件数据。例如，3 月 8 日导出的数据将包含 3 月 7 日 00:00:00 至 23:59:59（UTC）之间的所有事件。
定时导出仅适用于付费套餐或试用期内的公司。若您的公司不满足上述条件，调度器将跳过导出，不会写入任何文件，即使集成在看板中仍处于启用状态。如果您的存储桶为空且配置看起来正确，请先检查您的套餐状态。
如何设置 Google Cloud Storage 集成
第一步：创建 Google Cloud Storage 凭证
本指南将帮助你在 Google Cloud Platform Console 中创建所需的凭证。
为了让 Adapty Attribution 将原始数据报告上传到你指定的存储桶，需要提供服务账号的密钥，并授予对应存储桶的写入权限。通过提供服务账号密钥并授予存储桶写入权限，你可以让 Adapty Attribution 安全高效地将原始数据报告从其平台传输到你的存储环境。
请注意，我们仅支持服务账号 HMAC 密钥授权，因此请务必确保您的服务账号 HMAC 密钥已添加”Storage Object Viewer”、“Storage Legacy Bucket Writer”和”Storage Object Creator”角色，以便正常访问 Google Cloud Storage。
2.1. 创建服务账号
- 前往您的 Google Cloud 账号的 IAM 部分，选择相关项目或新建一个项目
- 接下来，点击 ”+ CREATE SERVICE ACCOUNT” 按钮，为 Adapty Attribution 创建一个新的服务账号。
- 填写第一步中的各个字段，访问权限将在后续步骤中授予。如需了解该页面的更多详情，请参阅文档。
- 要创建并下载 JSON 私钥，请导航至 KEYS 部分，然后点击 “ADD KEY” 按钮
- 在 DETAILS 部分，找到与刚创建的服务账户关联的 Email 值并复制。后续步骤中，授权该账户并允许其写入存储桶时需要用到这条信息。
2.2. 配置 Bucket 权限
- 前往 Google Cloud Storage 的存储桶页面，选择一个现有存储桶或新建一个存储桶，用于存储来自 Adapty Attribution 的用户获取数据报告。
- 导航至 PERMISSIONS 部分，选择授予访问权限选项。
- 在 PERMISSIONS 部分，输入第五步中获取的服务账户 Email，然后选择 Storage Object Creator 角色
- 最后，点击 SAVE 以保存更改
-
请记录存储桶的名称，以备后续使用
-
完成上述步骤后，您已成功完成在 Google Cloud Console 中的必要配置！最后一步是输入存储桶名称，并下载 JSON 文件以在 Adapty 归因中使用
第二步：在 Adapty Attribution 中配置集成
- 前往 Integrations -> Google Cloud Storage
- 打开 Export install events to Google Cloud Storage 开关
- 填写必填字段，以建立 Google Cloud Storage 与 Adapty Attribution 之间的连接： | 字段 | 描述 | |:------------------------------------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | 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 Attribution 还提供手动文件导出功能。借助此功能，您可以选择特定日期的用户获取数据，并手动将其导出到您的 GCS 存储桶。这让您能够更灵活地控制导出的数据内容及导出时机。
表结构
在 Google Cloud Storage 集成中，Adapty 归因提供了一张表，用于存储安装事件的历史数据。该表包含用户画像、收入与收益、来源商店等多个数据点的信息。
请注意，随着我们或第三方合作伙伴引入新数据，此结构可能会随时间不断扩展。请确保处理该数据的代码具有足够的健壮性，仅依赖特定字段，而不依赖整体结构。
以下是事件的表结构：
| 列名 | 描述 |
|---|---|
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 广告主标识符 |
idfv | iOS 供应商标识符 |
gaid | Google 广告 ID（Android） |
android_id | Android 设备 ID |
app_set_id | Android App Set ID |
bundle_id | 应用包标识符（例如 com.example.app） |
device_brand | 设备品牌（例如 Apple、Samsung） |
device_model | 设备型号（例如 iPhone15,2） |
os_version | 主要 OS 版本 |
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 | Apple Search Ads 组织 ID |
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 点击 ID |
ttclid | TikTok 点击 ID |
utm_source | UTM 来源参数 |
utm_medium | UTM 媒介参数 |
utm_campaign | UTM 广告系列参数 |
utm_term | UTM 词组参数 |
utm_content | UTM 内容参数 |
click_time | 归因点击的时间戳，以 Unix 秒为单位。若该安装没有关联的点击，则为空。 |