Tích hợp của Adapty UA với bộ nhớ 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 S3 bucket tùy chỉ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 bảng điều khiển bộ nhớ tương thích S3 và Adapty UA dashboard.

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 UA:

1. Truy cập Integrations -> Custom S3
2. Bật toggle Export install events to custom S3.
3. Đ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à 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ụ lưu trữ tương thích S3 của bạn. 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 bí mật được sử 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 của bạn. 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 để 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ư file 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 các 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 được cung cấp bởi nhà cung cấp dịch vụ lưu trữ (ví dụ: MinIO, DigitalOcean Spaces, Wasabi, v.v.).

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 Custom 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 nguồn gốc, cùng 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	Dấu thời gian tạo bản ghi (ISO 8601)
installed_at	Dấu thời gian 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ã định danh bundle ứng dụng (ví dụ: com.example.app)
device_brand	Thương hiệu thiết bị (ví dụ: Apple, Samsung)
device_model	Mẫu 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 được SDK Adapty báo cáo
sdk_version	Phiên bản Adapty SDK
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	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 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