Adapty 归因中的自定义 S3

Adapty Attribution 与自定义 S3 兼容存储的集成，允许您将用户获取活动数据安全存储在自己的 S3 兼容存储解决方案中。您可以将活动效果数据、归因数据和用户获取事件以 .csv 文件的形式保存到自定义 S3 存储桶中。要完成此集成配置，您只需在 S3 兼容存储控制台和 Adapty Attribution 看板中按照几个简单步骤操作即可。

Note

Adapty 归因导出每个日历日生成一组文件。导出调度程序每天运行三次——分别在 UTC 02:00、04:00 和 06:00。每次运行要么创建前一天的导出任务（如果尚不存在），要么在之前运行失败时重试。因此，您的数据通常在 02:00 运行后即可获取，后续两次运行是为了从失败中恢复，而非新增数据。

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

Warning

定时导出仅适用于付费计划或试用期内的公司。如果您的公司两者皆不符合，调度器将跳过导出并不写入任何文件，即使该集成在看板中仍处于启用状态。如果您的存储桶为空且配置看起来正确，请先检查您的计划状态。

设置自定义 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 等）。

Note

你也可以在 S3 存储桶名称字段中指定嵌套目录，例如 adapty-ua-events/com.sample-app

手动数据导出

除了将事件数据自动导出到您的自定义 S3 存储之外，Adapty Attribution 还提供手动文件导出功能。通过此功能，您可以选择用户获取数据的日期，并手动将其导出到您的 S3 存储桶。这让您能够更灵活地控制导出哪些数据以及何时导出。

表格结构

在自定义 S3 集成中，Adapty 归因提供了一张用于存储安装事件历史数据的表格。该表格包含用户画像信息、收入与收益、原始应用商店等多项数据。

Warning

请注意，随着我们或合作第三方引入新数据，该结构可能会持续扩展。请确保你处理该数据的代码具有足够的健壮性，依赖特定字段而非整体结构。

以下是事件的表格结构：

字段	描述
`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`	主要操作系统版本
`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 秒为单位。当安装未关联到任何点击时为空。