Xử lý lỗi trong tích hợp

Khi sử dụng bất kỳ tích hợp attribution, messaging hay analytics nào, bạn có thể gặp một số lỗi phổ biến. Xem hướng dẫn này để biết cách xử lý các trường hợp đó.

Sai lệch dữ liệu

Nguyên nhân: Điều này có thể xảy ra vì không phải tất cả người dùng đều đang dùng phiên bản app có tích hợp Adapty SDK.

Giải pháp: Để đảm bảo tính nhất quán của dữ liệu, bạn có thể yêu cầu người dùng cập nhật app lên phiên bản có Adapty SDK.

Lỗi mạng

Nguyên nhân: Nhiều khả năng là do mất kết nối internet giữa server Adapty và server tích hợp.

Giải pháp: Những sự cố này thường không kéo dài và chỉ ảnh hưởng đến một số ít sự kiện.

Server tích hợp không xử lý được sự kiện

Nguyên nhân: Tích hợp được thiết lập không đúng cách.

Giải pháp: Xem bài viết về tích hợp trong tài liệu của chúng tôi. Đảm bảo bạn đã hoàn tất tất cả các bước thiết lập trên Adapty Dashboard, phía công cụ bên thứ ba, và trong code của app.

Thiếu dữ liệu tích hợp

Nguyên nhân: Hồ sơ người dùng thiếu một số ID đặc thù cho tích hợp. Điều này có thể xảy ra khi tích hợp chưa được thiết lập đúng cách trong code của app.

Giải pháp: Xem bài viết về tích hợp trong tài liệu của chúng tôi. Đảm bảo bạn đã triển khai các phương thức từ đoạn code mẫu trong app, và các phương thức này thực sự tương tác với hồ sơ người dùng của bạn.

Thiếu thông tin xác thực tích hợp

Nguyên nhân: Một số thông tin xác thực của tích hợp bị thiếu hoặc không chính xác.

Giải pháp: Vui lòng kiểm tra lại tất cả thông tin xác thực cho tích hợp đó trên Adapty Dashboard. Sự cố có thể xảy ra do không khớp về phiên bản hoặc môi trường.

Sự kiện đã hết hạn

Nguyên nhân: Tùy chọn Exclude historical events được bật trong cài đặt tích hợp, và ngày tạo sự kiện xảy ra trước ngày tạo hồ sơ người dùng trong hệ thống của chúng tôi.

Điều này có thể xảy ra khi một chuỗi giao dịch bắt đầu từ nhiều năm trước được đưa vào Adapty thông qua xác thực biên lai cho một hồ sơ người dùng mới tạo gần đây.

Giải pháp: Đảm bảo điều này không xảy ra với các sự kiện mới. Nếu bạn muốn gửi các sự kiện lịch sử đến tích hợp, hãy tắt Exclude historical events.

Loại sự kiện bị vô hiệu hóa/không được hỗ trợ

Nguyên nhân: Sự kiện này không được hỗ trợ trong integration này, hoặc bạn đã vô hiệu hóa nó khi thiết lập integration.

Giải pháp:

Kiểm tra xem integration có hỗ trợ loại sự kiện này không. Các sự kiện sau đây không gửi đến tất cả các integration:
- access_level_updated: chỉ dành cho webhook.
- Sự kiện tổng hợp (trial_active, subscription_active): Adjust, Amplitude, AppMetrica, AppsFlyer, Branch, Facebook Analytics, Firebase, Mixpanel, OneSignal, PostHog, Singular, SplitMetrics, và webhook.
Nếu tích hợp được hỗ trợ, hãy đảm bảo sự kiện đã được bật trong cài đặt tích hợp.

Một sự kiện tổng hợp không bao giờ đến

Lý do: Sự kiện tổng hợp chỉ kích hoạt một lần, theo bộ đếm thời gian, và có bốn tình huống có thể ngăn chúng lại mà không có lỗi:

Gói dùng thử hoặc gói đăng ký kết thúc trước khi hết thời gian delay. Một lần mua đã chuyển đổi, hết hạn hoặc hoàn tiền sẽ không tạo ra sự kiện nào, và Adapty cũng không kiểm tra lại. Hãy tìm trial_converted, trial_expired, subscription_expired, hoặc subscription_refunded thay thế.
Người dùng đã tắt tự động gia hạn trước khi hết thời gian delay. Quyền truy cập của họ vẫn chạy đến hết kỳ đã thanh toán, nhưng Adapty bỏ qua việc gửi. Hãy tìm trial_renewal_cancelled hoặc subscription_renewal_cancelled thay thế.
Bạn bật sự kiện sau khi lần mua đã bắt đầu. Adapty bắt đầu đếm giờ khi nhận được trial_started hoặc subscription_started, vì vậy chỉ những lần mua được thực hiện sau khi bạn bật sự kiện mới tạo ra sự kiện này.
Bạn thay đổi thời gian delay sau khi lần mua đã bắt đầu. Những lần gửi đã được lên lịch sẽ giữ nguyên thời gian delay được tạo ban đầu.

Giải pháp: Không có sự kiện nào trong số này là lỗi gửi, nên không có gì cần thử lại và không có gì xuất hiện trong Event Feed. Để xác nhận thiết lập hoạt động đúng, hãy bật sự kiện lên và theo dõi một giao dịch mua được thực hiện sau thời điểm đó.