Với tích hợp SplitMetrics Acquire, bạn có thể xem chính xác số tiền mà Apple Search Ads mang lại từ các gói đăng ký. Và bạn có thể theo dõi người dùng trong nhiều tháng để biết quảng cáo của mình sinh ra bao nhiêu doanh thu theo thời gian.

Ngoài ra, Adapty gửi các sự kiện gói đăng ký đến SplitMetrics Acquire để bạn có thể xây dựng dashboard tùy chỉnh và tự động hóa dựa trên attribution từ Apple Search Ads. Tích hợp này không thêm dữ liệu attribution nào vào Adapty, vì chúng ta đã có đầy đủ dữ liệu cần thiết trực tiếp từ ASA.

Cách thiết lập tích hợp SplitMetrics Acquire

Để tích hợp SplitMetrics Acquire, vào Integrations > SplitMetrics Acquire và điền thông tin xác thực.

Mở tài khoản SplitMetrics Acquire của bạn, di chuột qua một trong các logo MMP và nhấn nút Settings. Tìm Client ID trong hộp thoại tại mục 5, sao chép và dán vào Adapty tại trường Client ID.

Bạn cũng cần thiết lập Apple App ID để sử dụng tích hợp. Để tìm App ID, mở trang ứng dụng trong App Store Connect, vào trang App Information trong phần General, và tìm Apple ID ở góc dưới bên trái màn hình.

Sự kiện và tag

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 từ Adapty đến SplitMetrics Acquire. Chỉ cần bật những sự kiện bạn cần. 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. Adapty sẽ gửi các sự kiện gói đăng ký đến SplitMetrics Acquire thông qua tích hợp server-to-server, cho phép bạn xem toàn bộ sự kiện gói đăng ký trong dashboard SplitMetrics.

Cấu hình SDK

Bạn không cần cấu hình gì thêm ở phía SDK, nhưng chúng tôi khuyến nghị gửi customerUserId đến Adapty để đảm bảo độ chính xác cao hơn.

Khắc phục sự cố

Nếu tích hợp với SplitMetrics Acquire không hoạt động dù đã cấu hình đúng:

• Đảm bảo bạn đã bật toggle Receive Apple Search Ads attribution in Adapty trong App Settings -> Apple Search Ads tab, đã cấu hình Apple Search Ads trong Adapty và tải lên thông tin xác thực. Nếu không có chúng, SplitMetric sẽ không hoạt động.
• Đảm bảo các hồ sơ người dùng có attribution ASA không phải organic. Chỉ những hồ sơ người dùng có attribution ASA chi tiết, không phải organic mới gửi sự kiện đến Adapty.

Cấu trúc sự kiện SplitMetrics Acquire

Adapty gửi sự kiện đến SplitMetrics Acquire qua GET request sử dụng query parameter. Mỗi sự kiện có cấu trúc như sau:

{
  "source": "Apple Search Ads",
  "app_id": "123456789",
  "name": "subscription_renewed",
  "type": "subscription_renewed",
  "revenue": 9.99,
  "currency": "USD",
  "tap_time": "2024-03-01 12:00:00",
  "open_time": "2024-03-01 12:05:00",
  "event_time": "2024-03-02 12:00:00",
  "adaccount_id": "123456",
  "campaign_id": "123456789",
  "adgroup_id": "123456789",
  "keyword_id": "123456789",
  "creative_set_id": "123456789",
  "Ad_id": "123456789",
  "country_or_region": "US",
  "conversion_type": "Download",
  "user_id": "user_12345",
  "att_status": "3",
  "device_type": "iphone",
  "app_version": "1.2.3",
  "sdk_version": "2.10.0",
  "ios_version": "17.2",
  "event_value": "{\"vendor_product_id\":\"yearly.premium.6999\",\"original_transaction_id\":\"GPA.3383...\"}",
  "event_id": "123e4567-e89b-12d3-a456-426614174000"
}

Trong đó:

Tham số	Kiểu	Mô tả
source	String	Luôn là “Apple Search Ads”.
app_id	String	Apple App ID.
name	String	Tên sự kiện (ánh xạ từ sự kiện Adapty).
type	String	Loại sự kiện (giống với name).
revenue	Float	Số tiền doanh thu.
currency	String	Mã tiền tệ.
tap_time	String	Ngày và giờ nhấn vào quảng cáo.
open_time	String	Ngày và giờ mở ứng dụng (cài đặt).
event_time	String	Ngày và giờ xảy ra sự kiện.
adaccount_id	String	ID tổ chức ASA.
campaign_id	String	ID chiến dịch ASA.
adgroup_id	String	ID nhóm quảng cáo ASA.
keyword_id	String	ID từ khóa ASA.
creative_set_id	String	ID bộ sáng tạo ASA.
Ad_id	String	ID quảng cáo ASA.
country_or_region	String	Quốc gia hoặc khu vực của cửa hàng.
conversion_type	String	Loại chuyển đổi (ví dụ: “Download”).
user_id	String	Customer User ID hoặc Adapty Profile ID.
att_status	String	Trạng thái sử dụng tracking (0-3).
device_type	String	Loại thiết bị (ví dụ: “iphone”, “ipad”).
app_version	String	Phiên bản ứng dụng.
sdk_version	String	Phiên bản Adapty SDK.
ios_version	String	Phiên bản iOS.
event_value	String	Chuỗi JSON chứa tất cả chi tiết sự kiện hiện có.
event_id	String	ID sự kiện duy nhất (UUID).