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 mang lại 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 tại đó, dựa trên attribution từ Apple Search Ads. Tích hợp này không thêm bất kỳ dữ liệu attribution nào vào Adapty, vì chúng tôi đã có đầy đủ thông tin 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ố

Sự kiện không đến được SplitMetrics Acquire

Nếu integration với SplitMetrics Acquire không hoạt động dù đã thiết lập đú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 — thiếu những bước này, 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 được sự kiện tới Asapty.

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.

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 (được ánh xạ từ sự kiện Adapty).
type	String	Loại sự kiện (giống 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	ASA Organization ID.
campaign_id	String	ASA Campaign ID.
adgroup_id	String	ASA Ad Group ID.
keyword_id	String	ASA Keyword ID.
creative_set_id	String	ASA Creative Set ID.
Ad_id	String	ASA Ad ID.
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 theo dõi (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).