SplitMetrics Acquire

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.

8255349-CleanShot_2023-08-14_at_17.39.422x.webp

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.

61578ee-CleanShot_2022-04-20_at_17.55.03.webp

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.

1b0c777-CleanShot_2023-08-11_at_14.56.362x.webp

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.

Hãy đảm bảo bạn đã 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, SplitMetrics Acquire sẽ không hoạt động.

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).