Adapty UA 与 Amazon S3 的集成允许您将用户获取活动数据安全地存储在一个中心位置。您可以将活动效果数据、归因数据和用户获取事件以 .csv 文件格式保存到您的 Amazon S3 存储桶中。
要设置此集成，您需要在 AWS 控制台和 Adapty UA 看板中执行几个简单步骤。

如何设置 Amazon S3 集成

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

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

步骤 1. 创建 Amazon S3 凭证

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

1.1. 创建访问策略

1. 在您的 AWS 控制台中导航到 IAM Policy Dashboard
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 UA 将原始数据报告上传到您的存储桶，您需要为具有特定存储桶写入权限的用户提供 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 UA 中配置集成

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

字段	描述
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 用户账户下获取您的 Region。

手动数据导出

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

表结构

在 AWS 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 内容参数