Custom S3 trong Adapty Attribution
Tích hợp của Adapty Attribution với custom S3-compatible storage 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ữ S3-compatible 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 S3 bucket 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 S3-compatible storage và Adapty Attribution dashboard của mình.
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 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 UTC.
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 | 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 |
bundle_id | Mã 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 hệ điều hành chính |
app_version | Phiên bản ứng dụng do SDK Adapty báo cáo |
sdk_version | Phiên bản SDK Adapty |
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 | 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 bộ sáng tạo 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 |