Custom S3 trong Adapty Attribution
Attribution của Adapty tích hợp với lưu trữ tương thích S3 tùy chỉnh, 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 trong giải pháp lưu trữ tương thích S3 của riêng bạn. 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 bucket S3 tùy chỉnh 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 console lưu trữ tương thích S3 và Adapty Attribution dashboard.
Adapty Attribution xuất một bộ tệp mỗi ngày theo lịch. Lịch xuất dữ liệu chạy ba lần mỗi ngày — vào lúc 02:00, 04:00 và 06:00 UTC. Mỗi lần chạy sẽ tạo công việc xuất dữ liệu của ngày hôm trước nếu chưa tồn tại, hoặc thử lại nếu lần chạy trước bị lỗi. Vì vậy, dữ liệu của bạn thường xuất hiện sau lần chạy 02:00, còn các lần chạy sau được dùng để khôi phục khi có sự cố chứ không phải để bổ sung thêm dữ liệu.
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 vào 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.
Tính năng xuất theo lịch chỉ chạy cho các công ty đang sử dụng gói trả phí hoặc đang trong thời gian dùng thử. Nếu công ty của bạn không thuộc trường hợp nào, trình lên lịch sẽ bỏ qua và không ghi file nào, dù tích hợp vẫn đang được bật trên dashboard. Nếu bucket của bạn trống và cấu hình có vẻ đúng, hãy kiểm tra trạng thái gói của bạn trước.
Thiết lập tích hợp Custom S3
Để bắt đầu nhận dữ liệu, hãy cấu hình tích hợp trong Adapty Attribution:
- Truy cập Integrations -> Custom S3
- Bật nút chuyển Export install events to custom S3.
- Điền vào các trường bắt buộc để thiết lập kết nối giữa bộ nhớ S3 tùy chỉnh của bạn và các hồ sơ người dùng Adapty Attribution. | Field | Description | |:----------------------------------------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | 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ụ lưu trữ tương thích S3. Tìm ID này trong bảng điều khiển của nhà cung cấp dịch vụ lưu trữ. | | Secret Access Key | Khóa riêng tư được 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ụ lưu trữ tương thích S3. Tìm khóa này trong bảng điều khiển của nhà cung cấp dịch vụ lưu trữ. | | S3 Bucket Name | Tên duy nhất toàn cầu dùng để xác định một S3 bucket cụ thể trong môi trường lưu trữ của bạn. 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. | | Region (Tùy chọn) | Lấy Region của bạn từ Management Console. | | Folder Inside the Bucket (Tùy chọn) | 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. | | Custom Endpoint URL | URL endpoint cho dịch vụ lưu trữ tương thích S3 của bạn. Thông tin này do nhà cung cấp dịch vụ lưu trữ cung cấp (ví dụ: MinIO, DigitalOcean Spaces, Wasabi, v.v.). |
Bạn cũng có thể chỉ định các thư mục con trong trường tên S3 bucket, ví dụ: adapty-ua-events/com.sample-app
Xuất dữ liệu thủ công
Ngoài tính năng xuất dữ liệu sự kiện tự động sang bộ nhớ S3 tùy chỉnh, 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 ngày cho dữ liệu thu hút người dùng và xuất thủ công vào S3 bucket của mình. Đ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 S3 tùy chỉnh, 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ể mở rộng theo thời gian — khi 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 dữ liệu mới. Hãy đảm bảo rằng code xử lý dữ liệu của bạn đủ linh hoạt, dựa vào các trường cụ thể thay vì toàn bộ cấu trúc.
Dưới đây là cấu trúc bảng cho các sự kiện:
| Cột | Mô tả |
|---|---|
adapty_profile_id | Định danh hồ sơ người dùng Adapty duy nhất |
install_id | Đị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 |
bundle_id | Định danh bundle của ứng dụng (ví dụ: com.example.app) |
device_brand | Thương hiệu thiết bị (ví dụ: Apple, Samsung) |
device_model | Model thiết bị (ví dụ: iPhone15,2) |
os_version | Phiên bản OS chính |
app_version | Phiên bản ứng dụng được SDK Adapty báo cáo |
sdk_version | Phiên bản SDK Adapty |
channel | Kênh attribution |
campaign_id | Định danh chiến dịch |
campaign_name | Tên chiến dịch |
adset_id | Định danh nhóm quảng cáo |
adset_name | Tên nhóm quảng cáo |
ad_id | Định danh quảng cáo |
ad_name | Tên quảng cáo |
keyword_id | Đị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 |
click_time | Thời điểm của lượt click được attribution, tính bằng giây Unix. Để trống khi không có lượt click nào được gán cho lần cài đặt. |