--- title: "Custom S3" description: "Xuất dữ liệu thu hút người dùng sang bộ nhớ tương thích S3 tùy chỉnh của bạn để phân tích và báo cáo nâng cao." --- 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. :::note Adapty UA 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 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 \{#set-up-custom-s3-integration\} Để 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**](https://app.adapty.io/ua/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.). | :::note Bạn cũng có thể chỉ định các thư mục lồng nhau trong trường tên S3 bucket, ví dụ: `adapty-ua-events/com.sample-app` ::: ## Xuất dữ liệu thủ công \{#manual-data-export\} 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 \{#table-structure\} 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. :::warning Lưu ý rằng cấu trúc này có thể mở rộng theo 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 mã 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 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 |