Adapty Attribution 与 Amazon S3 的集成，可让您将用户获取活动数据安全地存储在一个中央位置。您可以将活动表现数据、归因数据和用户获取事件以 .csv 文件的形式保存到 Amazon S3 存储桶中。 要设置此集成，您只需在 AWS 控制台和 Adapty Attribution 看板中完成几个简单步骤。

如何设置 Amazon S3 集成

要开始接收数据，您需要以下凭证：

1. Access key ID
2. Secret access key
3. S3 存储桶名称
4. S3 存储桶内的文件夹名称

步骤 1. 创建 Amazon S3 凭证

本指南将帮助你在 AWS 控制台中创建所需的凭证。

1.1. 创建访问策略

1. 在 AWS 控制台中进入 IAM 策略看板
2. 选择 Create Policy 选项

3. 在策略编辑器中，粘贴以下 JSON，并将 adapty-s3-integration-test 替换为你的存储桶名称：

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowListObjectsInBucket",
            "Effect": "Allow",
            "Action": "s3:ListBucket",
            "Resource": "arn:aws:s3:::adapty-s3-integration-test"
        },
        {
            "Sid": "AllowAllObjectActions",
            "Effect": "Allow",
            "Action": "s3:*Object",
            "Resource": [
                "arn:aws:s3:::adapty-s3-integration-test/*",
                "arn:aws:s3:::adapty-s3-integration-test"
            ]
        },
        {
            "Sid": "AllowBucketLocation",
            "Effect": "Allow",
            "Action": "s3:GetBucketLocation",
            "Resource": "arn:aws:s3:::adapty-s3-integration-test"
        }
    ]
}

4. 完成策略配置后，您可以选择添加标签（可选），然后点击 Next 进入最后一步
5. 在此步骤中，为您的策略命名，然后点击 Create policy 按钮完成创建

1.2. 创建 IAM 用户

要允许 Adapty Attribution 将原始数据报告上传到您的存储桶，您需要为拥有该存储桶写入权限的用户提供 Access Key ID 和 Secret Access Key。

1. 前往 IAM 控制台，选择 Users 部分
2. 点击 Add users 按钮

3. 为用户设置名称，选择 Access key – Programmatic access，然后继续配置权限

4. 在下一步中，请选择 Add user to group 选项，然后点击 Create group 按钮

5. 接下来，您需要为用户组指定一个名称，并选择之前创建的策略
6. 选择策略后，点击 Create group 按钮完成操作

7. 成功创建群组后，请选择它并继续下一步

8. 这是本部分的最后一步，直接点击 Create User 按钮即可。

9. 最后，你可以选择以 .csv 格式下载凭据，或者直接从看板中复制并粘贴凭据。

第 2 步：在 Adapty Attribution 中配置集成

1. 前往 Integrations -> Amazon S3
2. 开启 Export install events to Amazon S3 开关。
3. 填写以下字段，以建立 Amazon S3 与 Adapty Attribution 用户画像之间的连接：

字段	描述
Access Key ID	用于验证用户或应用程序访问 AWS 服务的唯一标识符。可在下载的 csv 文件 中找到此 ID。
Secret Access Key	与 Access Key ID 配合使用的私钥，用于验证用户或应用程序访问 AWS 服务。可在下载的 csv 文件 中找到此密钥。
S3 Bucket Name	在 AWS 云中标识特定 S3 存储桶的全局唯一名称。S3 存储桶是一种简单的存储服务，允许用户在云中存储和检索文件、图片等数据对象。
Folder Inside the Bucker	您希望在所选 S3 存储桶中创建的文件夹名称。请注意，S3 通过对象键前缀来模拟文件夹，这些前缀本质上就是文件夹名称。
Region（可选）	在 AWS 管理控制台中，于您的 IAM 用户账户下获取您的区域信息。

手动导出数据

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

表结构

在 AWS S3 集成中，Adapty Attribution 提供一张表用于存储安装事件的历史数据。该表包含用户画像、收入与实际所得、来源商店等多项数据信息。

以下是事件的表结构：

列名	描述
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 参数
click_time	归因点击的时间戳，以 Unix 秒为单位。若该安装未归因到任何点击，则为空。