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 秒为单位。当安装未关联到任何点击时为空。