Help Center
25/5/2025 | https://help.adjust.com
Loại hoạt động: Lượt cài đặt SKAdNetwork (SKAdNetwork install)
Để nhận thông tin phân bổ về lượt cài đặt SKAdNetwork trong dữ liệu thô, vui lòng sử dụng loại hoạt động: lượt cài đặt SKAdNetwork (SKAdNetwork install) .
Callback này sẽ chuyển tiếp thông tin từ postback xác thực lượt cài đặt (install validation postback) của Apple. Đây là postback được gửi đến mạng quảng cáo sau khi người dùng cài và mở ứng dụng. Postback này không được gửi trực tiếp đến Adjust hay nhà phát hành (publisher).
❌ - Loại hoạt động lượt cài đặt SKAdNetwork không được thêm vào global callback.
Tùy vào cách bạn xuất dữ liệu, cập nhật định nghĩa CSV hoặc callback URLbằng các trường dữ liệu có trong bảng sau.
Trường dữ liệu được hỗ trợ
| Trường dữ liệu | Định nghĩa | Ví dụ |
|---|---|---|
{sk_ts} | Dấu thời gian UNIX (tính bằng giây), cho biết thời điểm mạng quảng cáo nhận được postback lần đầu. | 1403568849 |
{sk_payload} | SKAdNetwork payload hoàn chỉnh nhận được từ Apple. Lưu ý: URL được mã hóa trong callback, nhưng trong CSV upload thì không. | Encoded URL:%7B%22version%22%20%3A%20%222.0%22%2C%22ad-network-id%22%20%3A%20%225UX5ZH24HU.skadnetwork%22%2C%22campaign-id%22%20%3A%2042%2C%22transaction-id%22%20%3A%20%226aafb7a5-0170-41b5-bbe4-fe71dedf1e28%22%2C%22app-id%22%20%3A%20525463029%2C%22attribution-signature%22%20%3A%20%22MDYCGQD0AdGn5gUnSuVGk8Wi0IgxzWiKdBzwJrQCGQCJfkrI5bda93EC4Xm1H%2BMtNxstFmnVBn0%3D%22%0A%22redownload%22%3A%20true%2C%22source-app-id%22%3A%201234567891%2C%22conversion-value%3A%2020%22%7D |
{sk_version} | Phiên bản của postback được gửi đến mạng quảng cáo. | 2,0 |
{sk_network_id} | Mã định danh của mạng quảng cáo. | 123456789x.skadnetwork |
{sk_campaign_id} | Campaign ID được cung cấp khi hiển thị quảng cáo. | 42 |
{sk_transaction_id} | Một giá trị duy nhất; được sử dụng để tránh gây trùng lặp thông báo xác thực lượt cài đặt. | 6aafb7a5-0170 |
{sk_app_id} | Mã định danh mặt hàng của sản phẩm được quảng cáo. | 525463029 |
{sk_attribution_signature} | Chữ ký phân bổ (attribution signature) của Apple. | ABCDGBdK%2BUupx6rZA2XO%2B6c0nYUhEg3dm%2BXIFAIZALqlLLnCh7ZFhI2fFPG4PF9wlVGJpKAL%2Fw%3D%3D |
{sk_invalid_signature} | Kết quả xác minh SKAdNetwork install postback của mạng quảng cáo. Nếu postback không hợp lệ, thì giá trị trả về sẽ là 1. Nếu postback hợp lệ, thì giá trị trả về là 0. | 0 |
{sk_redownload} | Boolean flag [1/0] được hiển thị khi người dùng tải và cài đặt lại ứng dụng.Apple ID được dùng để nhận diện lượt tải lại. Sau khi một lượt cài đặt được ghi nhận trong lịch sử giao dịch của Apple ID, Apple sẽ tính lượt cài đặt tiếp theo là lượt tải lại. | 1 |
{sk_fidelity_type} | Giá trị0cho biết đó là quảng cáo view-through; giá trị 1 cho biết đó là quảng cáo do Storekit hiển thị (StoreKit-rendered (click) ad). | 0 |
{sk_source_app_id} | Mã định danh mục (item identifier) của ứng dụng hiển thị quảng cáo Lưu ý: App ID của ứng dụng nguồn chỉ xuất hiện khi tham số đáp ứng yêu cầu bảo mật của Apple. | 1234567891 |
{sk_conversion_value} | Giá trị chuyển đổi (conversion value), là một số nguyên nằm trong khoảng từ 0-63 Lưu ý: Giá trị chuyển đổi chỉ xuất hiện khi ứng dụng cung cấp giá trị đó (ứng dụng đã được cài đặt, và quá trình cung cấp tham số đáp ứng yêu cầu của Apple về quyền riêng tư). | 20 |
{sk_did_win} | Cho biết lượt tương tác có được ghi nhận phân bổ hoặc có đủ điều kiện phân bổ hay không. Nếu giá trị 1 được trả về, thì mạng quảng cáo được ghi nhận phân bổ cho lượt cài đặt hoặc cài đặt lại.Nếu giá trị 0 được trả về, thì mạng quảng cáo mang đến lượt tương tác đủ điều kiện phân bổ, nhưng không được ghi nhận phân bổ cho lượt cài đặt hoặc cài đặt lại. | 0 |
{sk_coarse_conversion_value} | Giá trị chuyển đổi thô có thể là none, low, medium hoặc high. Nếu ứng dụng có cung cấp giá trị chuyển đổi thô thì trường dữ liệu sẽ hiển thị giá trị, nhưng vẫn còn tùy thuộc vào bậc dữ liệu của cơ chế crowd anonymity. | Cao |
{sk_postback_sequence_index} | Số nguyên 0, 1 hoặc 2, cho biết thứ tự postback được trả về, tương ứng với khung thời gian đo lường. Trường dữ liệu này chỉ khả dụng cho Phiên bản 4 trở về sau. | 2 |
{sk_source_domain} | Mã định danh mục (item identifier) trên trang web, mục này được dùng để hiển thị quảng cáo. | example.com |
{sk_source_identifier} | Mã định danh có chức năng tương tự campaign ID, mã này được cung cấp khi quảng cáo liên quan đến SKAD4 được hiển thị. | 5329 |
{network_name} | Tên của mạng quảng cáo trong SKAdNetwork postback mở rộng. | Hiện trường này chỉ áp dụng cho Snapchat. |
{campaign_name} | Tên của chiến dịch trong SKAdNetwork postback mở rộng. | Giáng Sinh |
{adgroup_name} | Tên của adgroup trong SKAdNetwork postback mở rộng. | Reindeers |
{creative_name} | Tên của creative trong SKAdNetwork postback mở rộng. | 320x70_en |
{activity_kind} | Loại hoạt động của người dùng | sk_install |
{tracker} | Tracker token của Adjust, gồm sáu ký tự. | abc123 |
{ip_address} | Địa chỉ IP của thiết bị trong SKAdNetwork postback mở rộng. | 192.168.0.50 |
{user_agent} | User agent (chuỗi đến ở dạng thô) trong SKAdNetwork postback mở rộng. | Mozilla%2F5.0+%28 |
{partner} | Phần mở rộng của mã định danh (đã đạt thỏa thuận trước đó với mạng quảng cáo), hiển thị tên của đối tác theo đúng tên được lưu trong cơ sở dữ liệu của Adjust. | |
{country} | Mã gồm hai ký tự giúp xác định thiết bị đang ở quốc gia nào. Lưu ý: Thông tin này chỉ được xác định nếu thiết bị chạy trên iOS 14.5 trở về trước và địa chỉ IP được đề cập trong SKAdNetwork postback. | de |
{random} | Số ngẫu nhiên (duy nhất cho từng callback). | 825884036 |
{nonce} | Chuỗi bao gồm chữ và số ngẫu nhiên, viết thường (duy nhất cho từng callback). | cncf378yd |