Singular

Singular là một trong những nền tảng Mobile Measurement Partner (MMP) hàng đầu, thu thập và trình bày dữ liệu từ các chiến dịch marketing. Điều này giúp các công ty theo dõi hiệu quả 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. 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à sử 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 tích hợp của bạn đến Singular. Kết quả là bạn có thể theo dõi những sự kiện này trong dashboard 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:

Tham số	Kiểu	Mô tả
`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	Product ID từ cửa hàng.
`purchase_transaction_id`	String	Transaction ID gốc.