Adapty 归因中的自定义 S3
Adapty Attribution 与自定义 S3 兼容存储的集成，让您能够将用户获取广告系列数据安全地保存在您自己的 S3 兼容存储中。您可以将广告系列效果数据、归因数据和用户获取事件以 .csv 文件的形式保存到自定义 S3 存储桶中。 要完成此集成配置，您需要在 S3 兼容存储控制台和 Adapty Attribution 看板中按照几个简单步骤操作。
Adapty Attribution 每 24 小时在 UTC 时间 4:00 发送一次数据。 每个文件将包含前一个完整日历日（UTC）内创建的所有事件数据。例如，3 月 8 日 UTC 4:00 自动导出的数据，将涵盖 3 月 7 日 00:00:00 至 23:59:59（UTC）期间创建的全部事件。
设置自定义 S3 集成
要开始接收数据，请在 Adapty Attribution 中配置集成：
- 前往 Integrations -> Custom S3
- 开启 Export install events to custom S3 开关。
- 填写必填字段，以在您的自定义 S3 存储与 Adapty Attribution 用户画像之间建立连接。 | 字段 | 描述 | |:----------------------------------------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Access Key ID | 用于验证用户或应用程序访问 S3 兼容存储服务的唯一标识符。可在存储服务提供商的控制台中找到此 ID。 | | Secret Access Key | 与 Access Key ID 配合使用的私钥，用于验证用户或应用程序访问 S3 兼容存储服务。可在存储服务提供商的控制台中找到此密钥。 | | S3 Bucket Name | 用于标识存储环境中特定 S3 存储桶的全局唯一名称。S3 存储桶是一种简单的存储服务，允许用户在云端存储和检索文件、图片等数据对象。 | | Region（可选） | 从管理控制台获取您的 Region。 | | Folder Inside the Bucket（可选） | 您希望在所选 S3 存储桶内创建的文件夹名称。请注意，S3 使用对象键前缀来模拟文件夹，这些前缀本质上就是文件夹名称。 | | Custom Endpoint URL | S3 兼容存储服务的端点 URL，由存储服务提供商提供（例如 MinIO、DigitalOcean Spaces、Wasabi 等）。 |
你也可以在 S3 存储桶名称字段中指定嵌套目录，例如 adapty-ua-events/com.sample-app
手动数据导出
除了将事件数据自动导出到您的自定义 S3 存储之外，Adapty Attribution 还提供手动文件导出功能。通过此功能，您可以选择用户获取数据的日期，并手动将其导出到您的 S3 存储桶。这让您能够更灵活地控制导出哪些数据以及何时导出。
表格结构
在自定义 S3 集成中，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 source 参数 |
utm_medium | UTM medium 参数 |
utm_campaign | UTM campaign 参数 |
utm_term | UTM term 参数 |
utm_content | UTM content 参数 |