Amazon S3 trong Adapty Attribution

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.

Adapty Attribution gửi dữ liệu của bạn mỗi 24h lúc 4:00 UTC. Mỗi file sẽ chứa dữ liệu cho các sự kiện được tạo trong toàn bộ ngày dương lịch trước đó theo giờ UTC. Ví dụ: dữ liệu được xuất tự động lúc 4:00 UTC ngày 8 tháng 3 sẽ chứa tất cả các sự kiện được tạo vào ngày 7 tháng 3 từ 00:00:00 đến 23:59:59 theo giờ UTC.

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:

Access key ID
Secret access key
Tên S3 bucket
Tên thư mục bên trong S3 bucket

Thư mục lồng nhau

Bạn có thể chỉ định các thư mục lồng nhau trong trường tên Amazon S3 bucket, ví dụ: adapty-ua-events/com.sample-app

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

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

7af075c-CleanShot_2023-03-21_at_10.52.002x.webp

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"
        }
    ]
}

d4e474a-CleanShot_2023-03-21_at_10.56.212x.webp

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
Ở 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

7dcb02f-CleanShot_2023-03-21_at_11.03.372x.webp

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 đó.

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

bb612c8-CleanShot_2023-03-21_at_11.12.392x.webp

Đặ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

Ở 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

bfd0e80-CleanShot_2023-03-21_at_11.24.592x.webp

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

df29c12-CleanShot_2023-03-21_at_11.28.052x.webp

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

1f3722e-CleanShot_2023-03-21_at_11.36.192x.webp

Đâ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

ea43722-CleanShot_2023-03-21_at_11.40.462x.webp

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

Truy cập Integrations -> Amazon S3
Bật toggle Export install events to Amazon S3.
Đ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.

Lưu ý rằng cấu trúc này có thể phát triển th��eo thời gian — khi có dữ liệu mới được chúng tôi hoặc các bên thứ ba mà chúng tôi hợp tác giới thiệu. Hãy đảm bảo rằng code xử lý dữ liệu của bạn đủ linh hoạt và chỉ phụ thuộc vào các trường cụ thể, không phụ thuộc vào toàn bộ cấu trú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