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