Bật tích hợp Google Cloud Storage để lưu trữ an toàn các sự kiện gói đăng ký và dữ liệu lượt xem paywall tại một nơi duy nhất: bucket Google Cloud Storage của bạn.

Mỗi ngày lúc 4 giờ sáng UTC, Adapty sẽ tải các file .csv chứa dữ liệu của ngày hôm trước lên bucket của bạn. Bạn có thể chọn nhận dữ liệu event, dữ liệu paywall visit, hoặc cả hai. Bạn cũng có thể xuất dữ liệu này thủ công bất cứ lúc nào, cho bất kỳ khoảng thời gian nào.

Để thiết lập tích hợp, hãy tạo khóa truy cập bucket trong Google Cloud console của bạn, rồi thêm vào cài đặt Adapty.

Lịch tải lên và thời gian xử lý

Adapty tải dữ liệu lên Google Cloud Storage mỗi 24 giờ, lúc 04:00 UTC.

Các file chứa dữ liệu cho các sự kiện được tạo trong ngày dương lịch trước đó (UTC). File được tải lên vào ngày 8 tháng 3 sẽ chứa tất cả sự kiện được tạo vào ngày 7 tháng 3, từ 00:00:00 đến 23:59:59 UTC.

Quá trình này có thể mất đến vài giờ, tùy thuộc vào tổng số file trong hàng đợi cũng như lượng dữ liệu bạn yêu cầu. Nếu Adapty đưa dữ liệu lịch sử vào lần tải lên đầu tiên, thời gian xử lý sẽ lâu hơn so với các lần tải lên hàng ngày sau đó.

Thiết lập tích hợp Google Cloud Storage

Bạn cần có khóa tài khoản dịch vụ Google Cloud hợp lệ với quyền ghi. Để tạo khóa, làm theo các bước trong phần tạo thông tin xác thực.

Vào Integrations -> Google Cloud Storage, mở tab cần thiết (Events hoặc Paywall visits). Bật tích hợp.

Tải lên file chứa khóa tài khoản dịch vụ Google Cloud của bạn. Chỉ định bucket và folder đích. Lưu các thay đổi.

Cài đặt tùy chọn cho dữ liệu sự kiện

Bạn có thể chỉ định những sự kiện nào được đưa vào báo cáo và đặt tên tùy chỉnh cho các sự kiện. Xem bài viết events để biết danh sách đầy đủ các sự kiện khả dụng.

Tên	Mặc định	Mô tả
Exclude historical events	true	Loại trừ thông tin về các sự kiện xảy ra trước khi bạn tích hợp Adapty SDK vào ứng dụng. Nếu nền tảng phân tích của bạn đã nhận các sự kiện gói đăng ký trước khi bạn bắt đầu dùng Adapty, tùy chọn này đảm bảo nền tảng không nhận các sự kiện trùng lặp. Ví dụ thực tế Một người dùng đã mua gói đăng ký hàng tháng vào ngày 10 tháng 1. Bản cập nhật ngày 1 tháng 3 của ứng dụng là bản đầu tiên tích hợp Adapty SDK. Nếu cài đặt này bật, báo cáo sẽ không bao gồm sự kiện “subscription started” từ tháng 1, cũng như sự kiện “subscription renewed” từ tháng 2. Nhưng sẽ bao gồm sự kiện “subscription renewed” từ ngày 10 tháng 3.
Include events without profile	false	Bao gồm các giao dịch không được liên kết với hồ sơ người dùng, hoặc không thể liên kết ngay với một người dùng cụ thể. Có thể bao gồm các giao dịch thực hiện trước khi cài Adapty SDK, hoặc các giao dịch nhận qua thông báo từ server.
Send user attributes	false	Bao gồm các thuộc tính người dùng tùy chỉnh, chẳng hạn như dữ liệu người dùng và dữ liệu sử dụng ứng dụng. Chọn tùy chọn này nếu gói OneSignal của bạn hỗ trợ hơn 10 thẻ. Lưu ý rằng vượt quá giới hạn thẻ có thể gây ra lỗi.

Tạo thông tin xác thực Google Cloud Storage

Hướng dẫn này giúp bạn tạo các thông tin xác thực cần thiết trong Google Cloud Platform Console.

Để Adapty có thể tải báo cáo dữ liệu thô lên bucket của bạn, cần có khóa tài khoản dịch vụ cùng với quyền ghi vào bucket tương ứng. Bằng cách cung cấp khóa tài khoản dịch vụ và cấp quyền ghi vào bucket, bạn cho phép Adapty chuyển báo cáo dữ liệu thô từ nền tảng của Adapty sang môi trường lưu trữ của bạn một cách an toàn và hiệu quả.

1. Đầu tiên, truy cập phần IAM trong tài khoản Google Cloud của bạn và chọn dự án phù hợp hoặc tạo dự án mới.

1. Tiếp theo, tạo tài khoản dịch vụ mới cho Adapty bằng cách nhấp vào nút ”+ CREATE SERVICE ACCOUNT”.

   

2. Điền vào các trường ở bước đầu tiên; quyền truy cập sẽ được cấp ở bước sau. Để tìm hiểu thêm về trang này, đọc tài liệu tại đây.

   

3. Để tạo và tải xuống khóa JSON riêng tư, điều hướng đến phần KEYS và nhấp vào nút “ADD KEY”.

   

4. Trong phần DETAILS, tìm giá trị Email liên kết với tài khoản dịch vụ vừa tạo và sao chép lại. Thông tin này sẽ cần thiết cho các bước tiếp theo để xác thực tài khoản và cho phép ghi vào bucket.

   

5. Tiếp theo, vào trang Buckets của Google Cloud Storage, chọn bucket hiện có hoặc tạo bucket mới để lưu trữ báo cáo dữ liệu Sự kiện hoặc Lượt xem từ Adapty. Sau đó điều hướng đến phần PERMISSIONS và chọn tùy chọn GRANT ACCESS.

   

6. Trong phần PERMISSIONS, nhập Email của tài khoản dịch vụ đã lấy ở bước năm, chọn vai trò Storage Object Creator. Cuối cùng, nhấp SAVE để áp dụng các thay đổi.

   

   Hãy ghi nhớ tên bucket để sử dụng sau này.

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 Google Cloud Storage, Adapty 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 khoảng thời gian cụ thể cho dữ liệu sự kiện và xuất thủ công vào bucket GCS 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.

Khoảng thời gian được chỉ định sẽ dùng để xuất các sự kiện được tạo từ Ngày A 00:00:00 UTC đến Ngày B 23:59:59 UTC.

Cấu trúc dữ liệu

Adapty sử dụng file .csv để xuất dữ liệu ở định dạng bảng.

Sự kiện

Bạn có thể chỉnh sửa danh sách sự kiện được đưa vào báo cáo của mình.

Cột	Mô tả
profile_id	ID người dùng Adapty.
event_type	Tên sự kiện viết thường. Tham khảo phần Sự kiện để tìm hiểu các loại sự kiện.
event_datetime	Ngày theo định dạng ISO 8601.
transaction_id	Mã định danh duy nhất cho một giao dịch như mua hàng hoặc gia hạn.
original_transaction_id	Mã định danh giao dịch của lần mua hàng gốc.
subscription_expires_at	Ngày hết hạn của gói đăng ký. Thường là ngày trong tương lai.
environment	Có thể là Sandbox hoặc Production.
revenue_usd	Doanh thu tính bằng USD. Có thể để trống.
proceeds_usd	Tiền thu về tính bằng USD. Có thể để trống.
net_revenue_usd	Doanh thu thuần (thu nhập sau thuế) tính bằng USD. Có thể để trống.
tax_amount_usd	Số tiền bị khấu trừ cho thuế tính bằng USD. Có thể để trống.
revenue_local	Doanh thu tính bằng tiền tệ địa phương. Có thể để trống.
proceeds_local	Tiền thu về tính bằng tiền tệ địa phương. Có thể để trống.
net_revenue_local	Doanh thu thuần (thu nhập sau thuế) tính bằng tiền tệ địa phương. Có thể để trống.
tax_amount_local	Số tiền bị khấu trừ cho thuế tính bằng tiền tệ địa phương. Có thể để trống.
customer_user_id	ID người dùng do nhà phát triển cung cấp. Ví dụ: có thể là UUID, email hoặc bất kỳ ID nào khác của người dùng. Null nếu bạn chưa thiết lập.
store	Có thể là app_store hoặc play_store.
product_id	ID sản phẩm trên Apple App Store, Google Play Store hoặc Stripe. Đối với gói cam kết 12 tháng, giá trị là <product_id>:monthly.
base_plan_id	ID gói cơ bản trên Google Play Store hoặc ID giá trên Stripe.
developer_id	ID nhà phát triển (SDK) của paywall nơi giao dịch phát sinh.
ab_test_name	Tên của A/B test nơi giao dịch phát sinh. Đối với A/B test đa placement, là tên của test trên một placement (<tên test> child-N). Để gộp A/B test đa placement theo các placement, hãy dùng ab_test_id.
ab_test_revision	Phiên bản của A/B test nơi giao dịch phát sinh.
paywall_name	Tên của paywall nơi giao dịch phát sinh. Đối với flow, là ID của màn hình paywall (scr_...). Tên flow nằm ở flow_name.
paywall_revision	Phiên bản của paywall nơi giao dịch phát sinh.
profile_country	Quốc gia của hồ sơ người dùng được Adapty xác định dựa trên địa chỉ IP.
install_date	Ngày cài đặt theo định dạng ISO 8601.
idfv	identifierForVendor trên thiết bị iOS
idfa	advertisingIdentifier trên thiết bị iOS
advertising_id	Advertising ID là mã duy nhất được Hệ điều hành Android cấp, mà các nhà quảng cáo có thể dùng để nhận diện thiết bị của người dùng
ip_address	Địa chỉ IP của thiết bị (có thể là IPv4 hoặc IPv6, ưu tiên IPv4 khi có). Được cập nhật mỗi khi IP của thiết bị thay đổi
cancellation_reason	Lý do người dùng hủy gói đăng ký. Các giá trị có thể có: iOS & Android — voluntarily_cancelled, billing_error, refund Chỉ iOS — price_increase, product_was_not_available, unknown, upgraded Chỉ Android — new_subscription_replace, cancelled_by_developer
android_app_set_id	Một AppSetId — ID duy nhất theo từng thiết bị, theo từng tài khoản nhà phát triển, người dùng có thể đặt lại, dùng cho các trường hợp quảng cáo không liên quan đến kiếm tiền.
android_id	Trên Android 8.0 (API cấp 26) và các phiên bản cao hơn, đây là một số 64-bit (biểu diễn dưới dạng chuỗi thập lục phân), duy nhất cho mỗi tổ hợp khóa ký ứng dụng, người dùng và thiết bị. Xem thêm tại tài liệu dành cho nhà phát triển Android.
device	Tên model thiết bị hiển thị với người dùng cuối.
currency	Mã tiền tệ 3 chữ cái (ISO-4217) của giao dịch.
store_country	Quốc gia của hồ sơ người dùng được Apple/Google store xác định.
attribution_source	Nguồn attribution.
attribution_network_user_id	ID được nguồn attribution gán cho người dùng.
attribution_status	Có thể là organic, non_organic hoặc unknown.
attribution_channel	Tên kênh marketing.
attribution_campaign	Tên chiến dịch marketing.
attribution_ad_group	Nhóm quảng cáo attribution.
attribution_ad_set	Bộ quảng cáo attribution.
attribution_creative	Từ khóa creative của attribution.
attributes	JSON của thuộc tính người dùng tùy chỉnh. Bao gồm mọi thuộc tính tùy chỉnh bạn đã thiết lập để gửi từ ứng dụng mobile. Để gửi, hãy bật tùy chọn Send User Attributes trong trang Integrations -> Webhooks.
integration_ids	Tất cả các ID tích hợp liên kết với một hồ sơ người dùng. Dạng Dictionary. Ví dụ: {‘mixpanel_user_id’: ‘mixpanelUserId-test’, ‘facebook_anonymous_id’: ‘facebookAnonymousId-test’}
variation_id	ID duy nhất của paywall nơi giao dịch phát sinh. Đối với flow, là ID của màn hình paywall bên trong flow, không phải ID biến thể A/B test.
flow_id	ID của flow nơi giao dịch phát sinh.
flow_name	Tên của flow nơi giao dịch phát sinh.
flow_variation_id	ID của biến thể flow trên placement này, giống với flow.variationId trong SDK.
ab_test_id	ID của A/B test nơi giao dịch phát sinh. Đối với A/B test đa placement, giá trị này giống nhau trên mọi placement.
ab_test_variant_id	ID của biến thể A/B test nơi giao dịch phát sinh. Dùng để phân tách giao dịch theo biến thể test.
ab_test_variant_name	Tên của biến thể A/B test.
ab_test_parent_name	Tên của A/B test đa placement. Để trống đối với các A/B test khác.

Các cột flow và A/B test là những cột cuối cùng của file. Adapty tính toán chúng tại thời điểm xuất file, vì vậy tên trong file xuất có thể khác với tên trong webhook event trước đó nếu bạn đã đổi tên A/B test, biến thể hoặc flow trong khoảng thời gian đó. Để biết mỗi cột chứa gì trong từng loại A/B test, xem Trường flow và A/B test.

Lượt xem paywall

Cột	Mô tả
profile_id	ID người dùng Adapty.
customer_user_id	ID người dùng do nhà phát triển đặt. Ví dụ: UUID người dùng, email hoặc ID bất kỳ. Null nếu bạn chưa thiết lập.
profile_country	Quốc gia của hồ sơ người dùng được xác định bởi cửa hàng Apple/Google.
install_date	Ngày cài đặt theo định dạng ISO 8601.
store	Có thể là app_store hoặc play_store.
paywall_showed_at	Ngày paywall được hiển thị cho khách hàng.
developer_id	ID nhà phát triển (SDK) của paywall nơi giao dịch bắt nguồn.
ab_test_name	Tên A/B test nơi giao dịch bắt nguồn.
ab_test_revision	Phiên bản của A/B test nơi giao dịch bắt nguồn.
paywall_name	Tên paywall nơi giao dịch bắt nguồn.
paywall_revision	Phiên bản của paywall nơi giao dịch bắt nguồn.

Xử lý sự cố

Adapty kiểm tra tính hợp lệ của khóa truy cập trước khi bắt đầu tải lên. Ngay cả khi chỉ một trong các khóa Google Cloud Storage không hợp lệ, Adapty sẽ hủy toàn bộ quá trình tải lên và báo lỗi.

Để đảm bảo quá trình tải lên không bị gián đoạn, hãy thay thế khóa trước khi hết hạn. Nếu bạn cập nhật khóa cho sự kiện, đừng quên cập nhật khóa cho lượt xem paywall, và ngược lại.