Tích hợp của Adapty UA với Amazon S3 cho phép bạn lưu trữ dữ liệu chiến dịch thu hút người dùng một cách an toàn tại một vị trí tập trung. Bạn có thể lưu dữ liệu hiệu suất chiến dịch, dữ liệu attribution và các sự kiện thu hút người dùng vào Amazon S3 bucket của mình dưới dạng file .csv.
Để thiết lập tích hợp này, bạn cần thực hiện một vài bước đơn giản trong AWS Console và dashboard Adapty UA.

Cách thiết lập tích hợp Amazon S3

Để bắt đầu nhận dữ liệu, bạn cần có các thông tin xác thực sau:

1. Access key ID
2. Secret access key
3. Tên S3 bucket
4. Tên thư mục bên trong S3 bucket

Bước 1. Tạo thông tin xác thực Amazon S3

Hướng dẫn này sẽ giúp bạn tạo các thông tin xác thực cần thiết trong AWS Console.

1.1. Tạo Access Policy

1. Truy cập IAM Policy Dashboard trong AWS Console của bạn
2. Chọn tùy chọn Create Policy

3. Trong Policy editor, dán JSON sau và thay adapty-s3-integration-test bằng tên bucket của bạn:

{
    "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. Sau khi hoàn tất cấu hình policy, bạn có thể thêm tags (tùy chọn) rồi nhấn Next để chuyển sang bước cuối
5. Ở bước này, bạn đặt tên cho policy và nhấn nút Create policy để hoàn tất quá trình tạo

1.2. Tạo IAM user

Để cho phép Adapty UA tải các báo cáo dữ liệu thô lên bucket của bạn, bạn cần cung cấp Access Key ID và Secret Access Key cho một người dùng có quyền ghi vào bucket cụ thể đó.

1. Truy cập IAM Console và chọn phần Users
2. Nhấn nút Add users

3. Đặt tên cho người dùng, chọn Access key – Programmatic access, rồi chuyển sang phần quyền

4. Ở bước tiếp theo, chọn tùy chọn Add user to group rồi nhấn nút Create group

5. Tiếp theo, đặt tên cho User Group và chọn policy mà bạn đã tạo trước đó
6. Sau khi chọn policy, nhấn nút Create group để hoàn tất

7. Sau khi tạo group thành công, hãy chọn group đó và tiếp tục bước tiếp theo

8. Đây là bước cuối cùng của phần này, bạn chỉ cần nhấn nút Create User để hoàn tất

9. Cuối cùng, bạn có thể tải thông tin xác thực dưới dạng .csv hoặc sao chép và dán thông tin xác thực trực tiếp từ dashboard

Bước 2. Cấu hình tích hợp trong Adapty UA

1. Vào Integrations -> Amazon S3
2. Bật toggle Export install events to Amazon S3.
3. Điền các trường sau để kết nối Amazon S3 với hồ sơ người dùng Adapty UA:

Trường	Mô tả
Access Key ID	Mã định danh duy nhất dùng để xác thực quyền truy cập của người dùng hoặc ứng dụng vào dịch vụ AWS. Tìm ID này trong file csv đã tải về.
Secret Access Key	Khóa bí mật dùng kết hợp với Access Key ID để xác thực quyền truy cập vào dịch vụ AWS. Tìm khóa này trong file csv đã tải về.
S3 Bucket Name	Tên duy nhất toàn cầu xác định một S3 bucket cụ thể trong AWS cloud. S3 bucket là dịch vụ lưu trữ đơn giản cho phép người dùng lưu trữ và truy xuất các đối tượng dữ liệu như file và hình ảnh trên cloud.
Folder Inside the Bucker	Tên thư mục bạn muốn tạo bên trong S3 bucket đã chọn. Lưu ý rằng S3 mô phỏng thư mục bằng cách sử dụng tiền tố khóa đối tượng, về cơ bản là tên thư mục.
Region (Tùy chọn)	Lấy Region của bạn từ AWS Management Console trong tài khoản IAM user.

Xuất dữ liệu thủ công

Ngoài tính năng tự động xuất dữ liệu sự kiện sang Amazon S3, Adapty UA còn cung cấp chức năng xuất file thủ công. Với tính năng này, bạn có thể chọn một ngày cụ thể để lấy dữ liệu thu hút người dùng và xuất sang S3 bucket theo cách thủ công. Điều này giúp bạn kiểm soát tốt hơn dữ liệu cần xuất và thời điểm xuất.

Cấu trúc bảng

Trong tích hợp AWS S3, Adapty UA cung cấp một bảng để lưu trữ dữ liệu lịch sử cho các sự kiện cài đặt. Bảng chứa thông tin về hồ sơ người dùng, doanh thu và lợi nhuận, cửa hàng gốc và nhiều điểm dữ liệu khác.

Dưới đây là cấu trúc bảng cho các sự kiện:

Cột	Mô tả
adapty_profile_id	Mã định danh hồ sơ người dùng Adapty duy nhất
install_id	Mã định danh cài đặt duy nhất
created_at	Timestamp tạo bản ghi (ISO 8601)
installed_at	Timestamp cài đặt ứng dụng (ISO 8601)
store	Cửa hàng ứng dụng (ios, android)
country	Mã quốc gia của người dùng (ISO 3166-1 alpha-2)
ip_address	Địa chỉ IP của client
idfa	iOS Identifier for Advertisers
idfv	iOS Identifier for Vendors
gaid	Google Advertising ID (Android)
android_id	ID thiết bị Android
app_set_id	Android App Set ID
channel	Kênh attribution
campaign_id	Mã định danh chiến dịch
campaign_name	Tên chiến dịch
adset_id	Mã định danh ad set
adset_name	Tên ad set
ad_id	Mã định danh quảng cáo
ad_name	Tên quảng cáo
keyword_id	Mã định danh từ khóa
keyword_name	Tên từ khóa
asa_org_id	ID tổ chức Apple Search Ads
asa_keyword_match_type	Loại khớp từ khóa ASA (Exact, Broad)
asa_attribution	Dữ liệu attribution ASA (chuỗi JSON)
asa_conversion_type	Loại chuyển đổi ASA
asa_country_or_region	Quốc gia hoặc khu vực ASA
asa_creative_set_name	Tên creative set ASA
fbclid	Facebook Click ID
ttclid	TikTok Click ID
utm_source	Tham số UTM source
utm_medium	Tham số UTM medium
utm_campaign	Tham số UTM campaign
utm_term	Tham số UTM term
utm_content	Tham số UTM content