Apple và Google gửi các sự kiện gói đăng ký trực tiếp đến máy chủ thông qua App Store Server Notifications và Real-time Developer Notifications (RTDN). Do đó, ứng dụng di động không thể gửi sự kiện đến các hệ thống phân tích theo thời gian thực một cách đáng tin cậy. Chẳng hạn, nếu người dùng đăng ký nhưng không bao giờ mở lại ứng dụng, nhà phát triển sẽ không nhận được bất kỳ cập nhật trạng thái gói đăng ký nào nếu không có máy chủ.

Adapty lấp đầy khoảng trống này bằng cách thu thập dữ liệu gói đăng ký và chuyển đổi thành các sự kiện dễ đọc. Các sự kiện tích hợp này được gửi ở định dạng JSON. Mặc dù tất cả sự kiện có cùng cấu trúc, các trường của chúng khác nhau tùy theo loại sự kiện, cửa hàng và cấu hình cụ thể. Bạn có thể tìm thấy các trường chính xác trong từng sự kiện trên các trang tích hợp tương ứng.

Để hiểu cách xác định xem một sự kiện đã được xử lý thành công hay có sự cố gì đó, hãy xem trang Trạng thái sự kiện.

Các loại sự kiện

Hầu hết các sự kiện đều được tạo và gửi đến tất cả các tích hợp đã cấu hình nếu chúng được bật. Tuy nhiên, sự kiện Access level updated chỉ kích hoạt nếu tích hợp webhook được cấu hình và sự kiện này được bật. Sự kiện này sẽ xuất hiện trong Event Feed và cũng sẽ được gửi đến webhook, nhưng sẽ không được chia sẻ với các tích hợp khác.

Nếu tích hợp webhook chưa được cấu hình hoặc loại sự kiện này chưa được bật, sự kiện Access level updated sẽ không được tạo và sẽ không xuất hiện trong Event Feed.

Tên sự kiện	Mô tả
subscription_started	Kích hoạt khi người dùng bắt đầu gói đăng ký trả phí không có thời gian dùng thử, tức là bị tính phí ngay lập tức.
subscription_renewed	Xảy ra khi gói đăng ký được gia hạn và người dùng bị tính phí. Sự kiện này bắt đầu từ lần thanh toán thứ hai, dù là gói đăng ký có hay không có dùng thử.
subscription_renewal_cancelled	Người dùng đã tắt tính năng tự động gia hạn gói đăng ký. Người dùng vẫn có thể sử dụng các tính năng cao cấp cho đến khi kết thúc chu kỳ đăng ký đã thanh toán.
subscription_renewal_reactivated	Kích hoạt khi người dùng bật lại tính năng tự động gia hạn gói đăng ký.
subscription_expired	Kích hoạt khi gói đăng ký hết hạn hoàn toàn sau khi bị hủy. Ví dụ: nếu người dùng hủy gói đăng ký vào ngày 12 tháng 12 nhưng vẫn còn hiệu lực đến ngày 31 tháng 12, sự kiện sẽ được ghi nhận vào ngày 31 tháng 12 khi gói đăng ký hết hạn.
subscription_paused	Xảy ra khi người dùng kích hoạt tính năng tạm dừng gói đăng ký (chỉ dành cho Android).
subscription_deferred	Kích hoạt khi giao dịch mua gói đăng ký được hoãn lại, cho phép người dùng trì hoãn việc thanh toán trong khi vẫn duy trì quyền truy cập các tính năng cao cấp. Tính năng này có sẵn thông qua Google Play Developer API và có thể dùng cho các bản dùng thử miễn phí hoặc hỗ trợ người dùng gặp khó khăn về tài chính.
non_subscription_purchase	Bất kỳ sản phẩm mua một lần nào, chẳng hạn như quyền truy cập trọn đời hoặc các sản phẩm consumable như tiền trong game.
trial_started	Kích hoạt khi người dùng bắt đầu gói đăng ký dùng thử.
trial_converted	Xảy ra khi thời gian dùng thử kết thúc và người dùng bị tính phí (lần mua đầu tiên). Ví dụ: nếu người dùng có thời gian dùng thử đến ngày 14 tháng 1 nhưng bị tính phí vào ngày 7 tháng 1, sự kiện sẽ được ghi nhận vào ngày 7 tháng 1.
trial_renewal_cancelled	Người dùng đã tắt tính năng tự động gia hạn trong thời gian dùng thử. Người dùng vẫn có thể sử dụng các tính năng cao cấp cho đến khi thời gian dùng thử kết thúc nhưng sẽ không bị tính phí hay chuyển sang gói đăng ký.
trial_renewal_reactivated	Xảy ra khi người dùng bật lại tính năng tự động gia hạn trong thời gian dùng thử.
trial_expired	Kích hoạt khi thời gian dùng thử kết thúc mà không chuyển sang gói đăng ký.
entered_grace_period	Xảy ra khi một lần thanh toán thất bại và người dùng bước vào thời gian ân hạn (nếu được bật). Người dùng vẫn có thể truy cập các tính năng cao cấp trong thời gian này.
billing_issue_detected	Kích hoạt khi xảy ra sự cố thanh toán trong quá trình thực hiện giao dịch (ví dụ: số dư thẻ không đủ).
subscription_refunded	Kích hoạt khi gói đăng ký được hoàn tiền (ví dụ: do Apple Support xử lý).
non_subscription_purchase_refunded	Kích hoạt khi một sản phẩm mua một lần được hoàn tiền.
access_level_updated	Xảy ra khi mức độ truy cập của người dùng được cập nhật.

Các sự kiện trên bao quát đầy đủ trạng thái của người dùng trong quá trình mua hàng. Hãy cùng xem một số ví dụ.

Ví dụ 1

Người dùng kích hoạt gói đăng ký hàng tháng vào ngày 1 tháng 4 với thời gian dùng thử 7 ngày. Vào ngày thứ 4, anh ta hủy đăng ký.

Trong trường hợp đó, các sự kiện sau sẽ được gửi:

1. trial_started vào ngày 1 tháng 4
2. trial_renewal_cancelled vào ngày 4 tháng 4
3. trial_expired vào ngày 7 tháng 4

Ví dụ 2

Người dùng kích hoạt gói đăng ký hàng tháng vào ngày 1 tháng 4 với thời gian dùng thử 7 ngày. Vào ngày thứ 10, anh ta hủy đăng ký.

Trong trường hợp đó, các sự kiện sau sẽ được gửi:

1. trial_started vào ngày 1 tháng 4
2. trial_converted vào ngày 7 tháng 4
3. subscription_renewal_cancelled vào ngày 10 tháng 4
4. subscription_expired vào ngày 1 tháng 5

Để xem chi tiết các sự kiện nào được kích hoạt trong từng tình huống, hãy xem Luồng sự kiện.