Singular
Singular là một trong những nền tảng Mobile Measurement Partner (MMP) hàng đầu, chuyên thu thập và trình bày dữ liệu từ các chiến dịch marketing, giúp các công ty theo dõi hiệu suất chiến dịch của mình.
Adapty cung cấp đầy đủ dữ liệu giúp bạn theo dõi các sự kiện gói đăng ký từ các cửa hàng tại một nơi duy nhất. Với Adapty, bạn có thể dễ dàng nắm bắt hành vi của người dùng, hiểu họ thích gì, và dùng thông tin đó để giao tiếp với họ một cách có mục tiêu và hiệu quả. Vì vậy, tích hợp này cho phép bạn theo dõi các sự kiện gói đăng ký trong Singular và phân tích chính xác doanh thu mà các chiến dịch của bạn tạo ra.
Adapty có thể gửi tất cả các sự kiện gói đăng ký đã được cấu hình trong phần tích hợp của bạn đến Singular. Nhờ đó, bạn có thể theo dõi các sự kiện này trong dashboard của Singular. Tích hợp này rất hữu ích để đánh giá hiệu quả của các chiến dịch quảng cáo.
Thiết lập tích hợp
Kết nối Adapty với Singular
Để thiết lập tích hợp với Singular, vào Integrations > Singular trong Adapty Dashboard, bật toggle và điền thông tin vào các trường.
Các thông tin xác thực sau đây có sẵn:
- Singular SDK Key: Bắt buộc. SDK key production cho ứng dụng Singular của bạn.
- Singular SDK Key (Sandbox): Không bắt buộc. SDK key cho ứng dụng Singular sandbox. Nếu không được thiết lập, các sự kiện sandbox sẽ không được gửi đến Singular.
Cả hai key đều có thể tìm thấy trong dashboard Singular tại Developer tools -> SDK Keys -> SDK Key (không phải SDK Secret):
Bên dưới phần thông tin xác thực, có ba nhóm sự kiện bạn có thể gửi đến Singular từ Adapty. Xem danh sách đầy đủ các sự kiện mà Adapty cung cấp tại đây.
Chúng tôi khuyến nghị sử dụng tên sự kiện mặc định do Adapty cung cấp. Tuy nhiên, bạn có thể thay đổi tên sự kiện theo nhu cầu của mình.
Adapty sẽ gửi các sự kiện gói đăng ký đến Singular thông qua tích hợp server-to-server, cho phép bạn xem tất cả các sự kiện gói đăng ký trong dashboard Singular và liên kết chúng với các chiến dịch quảng cáo của bạn.
Các hồ sơ người dùng được tạo trước khi cấu hình tích hợp sẽ không thể gửi sự kiện đến Singular.
Kết nối ứng dụng của bạn với Singular
Tích hợp giữa Adapty và Singular là server-to-server. Do đó, bạn không cần thêm bất kỳ đoạn code nào vào ứng dụng của mình.
Cấu trúc sự kiện
Adapty gửi sự kiện đến Singular thông qua GET request sử dụng query parameters. Mỗi sự kiện có cấu trúc như sau:
{
"n": "subscription_renewed",
"a": "singular_sdk_key_123",
"p": "iOS",
"i": "com.example.app",
"ip": "192.168.100.1",
"idfa": "00000000-0000-0000-0000-000000000000",
"idfv": "00000000-0000-0000-0000-000000000000",
"ve": "17.0.1",
"att_authorization_status": 3,
"custom_user_id": "user_12345",
"utime": 1709294400,
"amt": 9.99,
"cur": "USD",
"purchase_product_id": "yearly.premium.6999",
"purchase_transaction_id": "GPA.3383...",
"e": "{\"is_revenue_event\":true,\"amt\":9.99,\"cur\":\"USD\",\"purchase_product_id\":\"yearly.premium.6999\",\"purchase_transaction_id\":\"GPA.3383...\"}"
}Trong đó:
| Tham số | Kiểu | Mô tả |
|---|---|---|
n | String | Tên sự kiện (được ánh xạ từ sự kiện Adapty). |
a | String | Singular SDK Key của bạn. |
p | String | Nền tảng (“iOS” hoặc “Android”). |
i | String | Store App ID (Bundle ID). |
ip | String | Địa chỉ IP của người dùng. |
idfa | String | Chỉ iOS. ID for Advertisers (chữ hoa). |
idfv | String | Chỉ iOS. ID for Vendors (chữ hoa). |
aifa | String | Chỉ Android. Google Advertising ID (chữ thường). |
andi | String | Chỉ Android. Android ID (chữ thường). |
asid | String | Chỉ Android. App Set ID (chữ thường). |
ve | String | Phiên bản hệ điều hành. |
att_authorization_status | Integer | Chỉ iOS. Trạng thái ATT (ví dụ: 3 là đã được phép). |
custom_user_id | String | Customer User ID của người dùng. |
utime | Long | Timestamp UNIX của sự kiện tính bằng giây. |
amt | Float | Số tiền doanh thu. |
cur | String | Mã tiền tệ (ví dụ: “USD”). |
purchase_product_id | String | Product ID từ cửa hàng. |
purchase_transaction_id | String | Transaction ID gốc. |
e | String | Chuỗi JSON chứa thông tin chi tiết sự kiện (xem bên dưới). |
Tham số e (dữ liệu sự kiện tùy chỉnh) là một chuỗi được mã hóa JSON chứa:
| Parameter | Type | Description |
|---|---|---|
is_revenue_event | Boolean | true nếu sự kiện có chứa doanh thu. |
amt | Float | Số tiền doanh thu. |
cur | String | Mã tiền tệ. |
purchase_product_id | String | ID sản phẩm từ cửa hàng. |
purchase_transaction_id | String | ID giao dịch gốc. |
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.