OneSignal
OneSignal là một nền tảng tương tác khách hàng hàng đầu cung cấp push notification, email, SMS và in-app messaging. Tích hợp Adapty với OneSignal cho phép bạn truy cập tất cả các sự kiện gói đăng ký của mình ở một nơi, giúp bạn kích hoạt các giao tiếp tự động dựa trên những sự kiện đó.
Với Adapty, bạn có thể theo dõi sự kiện gói đăng ký trên nhiều cửa hàng, phân tích hành vi người dùng và sử dụng dữ liệu đó để giao tiếp có mục tiêu hơn. Tích hợp này giúp bạn theo dõi các sự kiện gói đăng ký trong dashboard OneSignal và ánh xạ chúng với chiến dịch acquisition của bạn.
Adapty cập nhật các tag OneSignal dựa trên sự kiện gói đăng ký, cho phép bạn gửi thông báo đẩy được cá nhân hóa với thiết lập tối giản.
Đặc điểm tích hợp
| Đặc điểm tích hợp | Mô tả |
|---|---|
| Lịch trình | Cập nhật theo thời gian thực |
| Chiều dữ liệu | Một chiều: từ Adapty đến máy chủ OneSignal |
| Điểm tích hợp Adapty |
|
Thiết lập tích hợp OneSignal
Để thiết lập tích hợp:
-
Mở Integrations → OneSignal trong Adapty Dashboard của bạn.
-
Bật nút chuyển đổi tích hợp.
-
Nhập OneSignal App ID của bạn.
Để thiết lập tích hợp với OneSignal, vào Integrations -> OneSignal trong Adapty dashboard của bạn, bật nút chuyển đổi và cấu hình thông tin xác thực tích hợp.
Lấy OneSignal App ID của bạn
Tìm OneSignal App ID của bạn trong OneSignal Dashboard:
-
Điều hướng đến Settings → Keys & IDs.
-
Sao chép OneSignal App ID của bạn và dán vào trường App ID trong Adapty Dashboard.
Bạn có thể tìm thêm thông tin về OneSignal ID trong tài liệu sau.
Cấu hình sự kiện
Adapty cho phép bạn gửi ba nhóm sự kiện tới OneSignal. Bật những sự kiện bạn cần trong Adapty Dashboard. Bạn có thể xem danh sách đầy đủ các sự kiện có sẵn kèm mô tả chi tiết tại đây.
Adapty gửi các sự kiện gói đăng ký tới OneSignal thông qua tích hợp server-to-server, cho phép bạn theo dõi toàn bộ hoạt động liên quan đến gói đăng ký trong OneSignal.
Bắt đầu từ ngày 17 tháng 4 năm 2023, Gói Miễn phí của OneSignal không còn hỗ trợ tích hợp này. Tính năng này chỉ có trên các gói Growth, Professional và cao hơn. Để biết chi tiết, xem Bảng giá OneSignal.
Tag tùy chỉnh
Tích hợp này cập nhật và gán nhiều thuộc tính cho người dùng Adapty của bạn dưới dạng tag, sau đó được gửi tới OneSignal. Tham khảo danh sách tag bên dưới để tìm những tag phù hợp nhất với nhu cầu của bạn.
OneSignal có giới hạn số lượng tag. Điều này bao gồm cả các tag do Adapty tạo ra và các tag hiện có trong OneSignal. Vượt quá giới hạn có thể gây ra lỗi khi gửi sự kiện.
| Tag | Kiểu | Mô tả |
|---|---|---|
adapty_customer_user_id | String | Mã định danh duy nhất của người dùng trong ứng dụng của bạn. Phải nhất quán trong toàn hệ thống, Adapty và OneSignal. |
adapty_profile_id | String | ID hồ sơ người dùng Adapty, có sẵn trong Adapty Dashboard. |
environment | String | Sandbox hoặc Production, cho biết môi trường hiện tại của người dùng. |
store | String | Cửa hàng nơi sản phẩm được mua. Các tùy chọn: app_store, play_store, stripe, hoặc tên cửa hàng tùy chỉnh của bạn. |
vendor_product_id | String | ID sản phẩm trong cửa hàng ứng dụng (ví dụ: org.locals.12345). |
subscription_expires_at | String | Ngày hết hạn của gói đăng ký mới nhất (YYYY-MM-DDTHH:MM:SS+0000, ví dụ: 2023-02-10T17:22:03.000000+0000). |
last_event_type | String | Loại sự kiện mới nhất từ danh sách sự kiện Adapty. Lưu ý những điều sau: - Đối với sự kiện Subscription expired, Adapty gửi thuộc tính last_event_type là subscription_cancelled.- Đối với Trial renew canceled – là auto_renew_off- Đối với Subscription renew canceled – là auto_renew_off_subscription |
purchase_date | String | Ngày giao dịch gần nhất (YYYY-MM-DDTHH:MM:SS+0000, ví dụ: 2023-02-10T17:22:03.000000+0000). |
active_subscription | String | true nếu người dùng có gói đăng ký đang hoạt động và false nếu gói đăng ký đã hết hạn. |
period_type | String | Cho biết loại kỳ gần nhất cho lần mua hoặc gia hạn. Các giá trị có thể: trial cho thời gian dùng thử hoặc normal cho tất cả các trường hợp khác. |
Tất cả các giá trị float được làm tròn thành số nguyên. Các chuỗi vẫn giữ nguyên.
Ngoài các tag đã định sẵn, bạn có thể gửi thuộc tính tùy chỉnh dưới dạng tag, mang lại sự linh hoạt hơn trong dữ liệu bạn đưa vào. Điều này hữu ích cho việc theo dõi các chi tiết cụ thể liên quan đến sản phẩm hoặc dịch vụ của bạn.
Các thuộc tính người dùng tùy chỉnh được tự động gửi tới OneSignal nếu checkbox Send user attributes được bật trên trang tích hợp. Khi không được chọn, Adapty gửi đúng 10 tag. Nếu được chọn, có thể gửi hơn 10 tag, cho phép thu thập dữ liệu phong phú hơn.
Cấu hình SDK
Có hai cách để tích hợp OneSignal với Adapty:
- Legacy (trước v5): Sử dụng
playerId(đã deprecated trong OneSignal SDK v5). - Hiện tại (v5+): Sử dụng
subscriptionId.
Đảm bảo gửi playerId (cho OneSignal SDK trước v5) hoặc subscriptionId (cho OneSignal SDK v5+) tới Adapty. Nếu không có điều này, các tag OneSignal sẽ không được cập nhật và tích hợp sẽ không hoạt động đúng.
Đọc thêm trong tài liệu OneSignal:
Xử lý nhiều thiết bị
Khi một người dùng có nhiều thiết bị, việc theo dõi sự kiện mua hàng và gói đăng ký có thể là thách thức. OneSignal cung cấp cách xử lý vấn đề này thông qua external user IDs.
Để giữ dữ liệu người dùng nhất quán trên các thiết bị:
- Khớp các thiết bị khác nhau ở phía máy chủ của bạn và gửi dữ liệu này tới OneSignal.
- Sử dụng customer_user_id của Adapty làm externalUserId trong OneSignal. Nếu ứng dụng của bạn không có hệ thống đăng ký, hãy cân nhắc sử dụng một mã định danh duy nhất khác vẫn nhất quán trên tất cả thiết bị của người dùng.
Điều quan trọng là phải duy trì tính nhất quán trong mã định danh người dùng trên tất cả các thiết bị và cập nhật OneSignal mỗi khi ID người dùng thay đổi. Điều này giúp đơn giản hóa việc theo dõi hoạt động và gói đăng ký của người dùng, đồng thời đảm bảo tin nhắn nhất quán, cho phép phân tích chính xác hơn và mang lại trải nghiệm người dùng tốt hơn. Để biết thêm chi tiết, xem tài liệu về external user ID của OneSignal.
Khắc phục sự cố
access_level_updated hiển thị là thất bại trong Event Feed
access_level_updated là một sự kiện chỉ dành cho webhook. Adapty không bao giờ gửi sự kiện này đến tích hợp này. Tuy nhiên, Adapty ghi lại kết quả cho mọi tích hợp đã bật, và một sự kiện không được hỗ trợ sẽ được hiển thị là thất bại.