Tích hợp Adapty Attribution với Amazon S3 cho phép bạn lưu trữ dữ liệu chiến dịch thu thập người dùng một cách an toàn tại một vị trí trung tâm. 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 thập người dùng vào bucket Amazon S3 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à Adapty Attribution dashboard.

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 đoạ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ể chọn thêm tag (tùy chọn) rồi nhấn Next để tiếp tục bước cuối cùng
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 Attribution 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 user có quyền ghi vào bucket đó.

1. Điều hướng đến IAM Console và chọn mục Users
2. Nhấn vào nút Add users

3. Đặt tên cho người dùng, chọn Access key – Programmatic access, rồi tiến hành cài đặt quyền

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

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

7. Sau khi tạo nhóm thành công, hãy chọn nhóm đó 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 vào nút Create User để tiếp tục

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

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

1. Truy cập Integrations -> Amazon S3
2. Bật toggle Export install events to Amazon S3.
3. Điền vào các trường sau để thiết lập kết nối giữa Amazon S3 và các hồ sơ người dùng Adapty Attribution: | 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 tệp csv đã tải xuống. | | Secret Access Key | Khóa riêng tư dùng kết hợp với Access Key ID để 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 khóa này trong tệp csv đã tải xuống. | | S3 Bucket Name | Tên duy nhất trên toàn cầu để xác định một S3 bucket cụ thể trong đám mây AWS. 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ư tệp và hình ảnh trên đám mây. | | 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 chính 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 người dùng IAM. |

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 Attribution 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, cùng nhiều điểm dữ liệu khác.

Đâ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
install_id	Mã định danh cài đặt duy nhất
created_at	Thời điểm tạo bản ghi (ISO 8601)
installed_at	Thời điểm 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 nhóm quảng cáo
adset_name	Tên nhóm quảng cáo
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	Kiểu 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 bộ creative 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