Tổng quan: Báo cáo dữ liệu thô SKAN chứa dữ liệu cấp hàng được tạo sau khi dịch và giải mã đăng lại mà AppsFlyer nhận được từ iOS, cũng như các lượt đăng lại SKAN thô. Dữ liệu có sẵn thông qua Data Locker và API Push. Nếu gói đăng ký của bạn gồm dữ liệu thô thì không cần đăng ký Data Locker.
Báo cáo dữ liệu thô SKAN
Nguyên tắc:
-
Dữ liệu được cung cấp bởi:
-
Data Locker
- Lưu ý! Có sẵn cho các tài khoản có đăng ký dữ liệu thô. Nghĩa là, không cần đăng ký Data Locker. Nếu bạn hiện không sử dụng Data Locker, người dùng quản trị phải định cấu hình Data Locker và bật báo cáo SKAN. Để thực hiện, đi đến Integration > Data Locker. Chọn các báo cáo SKAN.
- Tần suất cập nhật dữ liệu: Hàng ngày. Dữ liệu được chứa trong thư mục h=23 kể từ ngày AppsFlyer nhận được đăng lại. Ví dụ: Nếu được nhận vào thứ Hai, thì lượt đăng lại sẽ được xử lý sau khi ngày đó kết thúc. Quá trình xử lý sẽ hoàn tất trước 12:00 UTC ngày thứ Ba, dữ liệu được ghi vào thư mục h=23 thứ Hai.
-
API Đẩy
- Tính cập nhật của dữ liệu: Xem API Push để lấy dữ liệu SKAN.
-
Data Locker
-
Ngày cài đặt: Được AppsFlyer tính từ thời gian có bài đăng lại như sau:
-
Nếu bài đăng lại là SKAN V4 thì công thức ngày cài đặt là: Ngày cài đặt = thời gian có bài đăng lại - [độ dài khung thời gian tích lũy] - [độ trễ đăng lại trung bình].
- Đăng lại 1: ngày cài đặt = thời gian có bài đăng lại - 48h - 36h
- Đăng lại 2: ngày cài đặt = thời gian có bài đăng lại - 168h - 84h
- Đăng lại 3: ngày cài đặt = thời gian có bài đăng lại - 840h - 84h
-
Nếu bài đăng lại là SKAN V3 thì công thức ngày cài đặt là: Ngày cài đặt = thời gian có bài đăng lại - 36 giờ - [phạm vi hoạt động lần cuối trung bình].
- [Phạm vi hoạt động lần cuối trung bình] mặc định là 12 giờ.
- Đối với giá trị chuyển đổi là 0, phạm vi hoạt động lần cuối trung bình được đặt thành 0.
- Google tự ước tính thời gian cài đặt và AppsFlyer sử dụng thời gian cài đặt đó. Lưu ý: Có thể mất tới 13 ngày để Google báo cáo số lượt cài đặt. Tìm hiểu thêm
-
Nếu bài đăng lại là SKAN V4 thì công thức ngày cài đặt là: Ngày cài đặt = thời gian có bài đăng lại - [độ dài khung thời gian tích lũy] - [độ trễ đăng lại trung bình].
Các loại báo cáo có sẵn là:
- Đăng lại của thiết bị: 1 đăng lại thiết bị cho mỗi lượt cài đặt hoặc tải xuống lại nhận được từ thiết bị iOS.
-
Dữ liệu thô SKAN:
- AppsFlyer giải mã và chuyển lượt đăng lại của thiết bị thành bản ghi dữ liệu thô.
- Mỗi lượt đăng lại sẽ tạo ra một bản ghi cài đặt hoặc tải xuống lại và các bản ghi sự kiện trong ứng dụng.
- Số lượng bản ghi sự kiện trong ứng dụng tùy thuộc vào giá trị chuyển đổi (CV) như sau:
- CV = 0, blank hoặc null: Không có bản ghi trong ứng dụng nào được tạo.
- Phạm vi CV:
- 1-63: Đối với giá trị mịn của khung thời gian 1 SKAN 3 và SKAN 4, đây là số lượng bản ghi trong ứng dụng, tùy thuộc vào cài đặt đo lường của bạn.
- Thấp, trung bình hoặc cao: Đối với giá trị thô SKAN 4, đây là số lượng bản ghi trong ứng dụng, tùy thuộc vào cài đặt đo lường của bạn.
Tại sao có một số trường trống? Điều này phát sinh là vì bất kỳ lý do nào sau đây:
- Các trường bổ sung không bắt buộc như campaign_name, ad_network_campaign_id, ip mà mạng quảng cáo không cung cấp.
- Apple đã giữ lại dữ liệu do chính sách ngưỡng áp dụng của Apple. Các trường như source_app_id, skad_campaign_id, skad_conversion_value.
Định dạng và nội dung báo cáo dữ liệu thô SKAN
Các loại báo cáo dữ liệu thô
Loại báo cáo | Tên báo cáo | Mô tả | |||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Đăng lại | Đăng lại |
Lượt đăng lại được iOS gửi tới mạng quảng cáo. Bài đăng lại, sau khi được mạng quảng cáo làm phong phú, sẽ được chuyển tiếp đến AppsFlyer. Tải xuống ví dụ đăng lại (CSV). Lưu ý: Đăng lại không được đưa vào khi did_win=false. Tên chủ đề trong Data Locker: skad_postbacks |
|||||||||||||||||||||||
Đăng lại | Bản sao đăng lại (trực tiếp từ Apple) |
Đăng lại được iOS gửi trực tiếp tới AppsFlyer. Có sẵn bắt đầu từ iOS 15 trở lên và yêu cầu nhà quảng cáo định cấu hình ứng dụng để gửi bài đăng lại thành công tới AppsFlyer. Tải xuống ví dụ bản sao đăng lại (CSV). Lưu ý: Chủ đề này chỉ chứa các bài đăng lại thành công. Tên chủ đề trong Data Locker: skad_postbacks_copy |
|||||||||||||||||||||||
Sự kiện được giải mã | Lượt cài đặt |
Lượt cài đặt ứng dụng lần đầu SKAN đã báo cáo reddownload=false. Có nghĩa rằng đây là lần đầu tiên người dùng, được đại diện bởi ID Apple, tải xuống ứng dụng. Tên chủ đề trong Data Locker: skad_installs |
|||||||||||||||||||||||
Sự kiện được giải mã | Tải lại |
Lượt cài đặt ứng dụng không phải là lượt cài đặt lần đầu SKAN đã báo cáo reddownload=true. Có nghĩa rằng đây không phải là lần đầu tiên người dùng, được đại diện bởi ID Apple, tải xuống ứng dụng. Báo cáo này có cấu trúc tương tự như lượt cài đặt. Tên chủ đề trong Data Locker: skad_redownloads |
|||||||||||||||||||||||
Sự kiện được giải mã | Sự kiện trong ứng dụng |
Sự kiện trong ứng dụng Kể từ ngày 21 tháng 7 năm 2021, sẽ có những thay đổi về cách chúng tôi cung cấp dữ liệu thô về sự kiện trong ứng dụng như được nêu chi tiết trong bảng. Số lượng bản ghi sự kiện trong ứng dụng tùy thuộc vào cài đặt đo lường của bạn. Tải xuống ví dụ về sự kiện trong ứng dụng (CSV). Tên chủ đề trong Data Locker: skad_inapps Hợp lệ đối với các bài đăng lại trên iOS nhận được kể từ ngày 21 tháng 7 năm 2021:
Hợp lệ đối với các bài đăng lại trên iOS nhận được cho đến ngày 20 tháng 7 năm 2021:
|
|||||||||||||||||||||||
Sự kiện được giải mã | Phương diện quảng cáo SRN |
Tên chủ đề trong Data Locker: skad_srn_advertising_dimensions |
Các loại định dạng trường dữ liệu thô
Định dạng trường
Tên định dạng | Mô tả |
---|---|
Chuỗi [n] |
Độ dài tối đa của chuỗi. Chúng tôi thường không thực thi các giới hạn độ dài trường khi nhận dữ liệu nhưng về sau dữ liệu có thể bị cắt ngắn. |
Chuỗi thời gian |
Chuỗi có định dạng |
Enum [n] | Các trường Enum chỉ có thể chứa các giá trị cụ thể. Ví dụ, Tiền tệ chi phí có 3 ký tự và chỉ có thể chứa mã tiền tệ như được chỉ định. |
Nhãn thời gian |
Nhãn thời gian UNIX 10 chữ số. Ví dụ: Ngày 4 tháng 8 năm 2020, 07:25 UTC dịch thành |
Boolean |
Giá trị của trường có thể là |
Số nguyên |
Số nguyên |
Float |
Số thực dấu phẩy động có thể có dấu thập phân và các giá trị sau dấu thập phân. |
Các trường có sẵn trong báo cáo đăng lại và bản sao đăng lại
Tên trường | Nguồn hoặc phiên bản bắt đầu SKAN iOS | Mô tả | Định dạng | Có sẵn trong bản sao đăng lại |
---|---|---|---|---|
ad_network_campaign_id |
Mạng quảng cáo | ID chiến dịch được mạng quảng cáo báo cáo cho AppsFlyer | Chuỗi | Không |
ad_network_campaign _name |
Mạng quảng cáo |
Tên chiến dịch được mạng quảng cáo báo cáo cho AppsFlyer.
|
Chuỗi | Không |
ad_network_timestamp |
Mạng quảng cáo |
Thời gian mạng quảng cáo nhận được bài đăng lại. Trong trường hợp Google Ads, thời gian được lấy từ thời gian nhấp chuột cuối cùng do Google báo cáo. |
Nhãn thời gian | Không |
app_id |
AppsFlyer | ID ứng dụng (ứng dụng của nhà quảng cáo) có ID tiền tố. | Chuỗi | Có |
city |
AppsFlyer | Bắt đầu từ ngày 30 tháng 8 năm 2021, giá trị luôn là null | Chuỗi | Không |
country_code |
Mạng quảng cáo | Chuỗi | Không | |
dma | Bắt đầu từ ngày 30 tháng 8 năm 2021, giá trị luôn là null | Chuỗi | Không | |
postal_code |
Bắt đầu từ ngày 30 tháng 8 năm 2021, giá trị luôn là null | Chuỗi | Không | |
region |
AppsFlyer | Theo country_code được báo cáo | Chuỗi | Không |
skad_ad_network_id |
1.0 |
Một số SRN không chia sẻ ID của họ, và trường này để trống. Ví dụ, Twitter. |
Chuỗi |
Có |
skad_attribution_signature |
1.0 | Chuỗi | Có | |
skad_campaign_id | 1.0 | ID Chiến dịch được sử dụng để đăng quảng cáo. Phạm vi 0-100 | Chuỗi | Có |
skad_conversion_value | 2.0 |
Giá trị chuyển đổi do iOS báo cáo. Phạm vi 0-63. Nếu là null thì iOS sẽ không điền vào trường này** |
Số nguyên | Có |
skad_redownload | 2.0 | Nếu là true, ứng dụng đã được tải xuống lại |
Boolean |
Có |
skad_source_app_id | 2.0 |
ID trang web. Ứng dụng đăng quảng cáo. Trường này giống hệt với source_app_id. Trường có được điền hay không phụ thuộc vào ngưỡng quyền riêng tư** |
Chuỗi | Có |
skad_transaction_id | 1.0 | Chuỗi | Có | |
skad_version | 2.0 | Chuỗi | Có | |
timestamp | Mạng quảng cáo |
Thời gian AppsFlyer nhận được đăng lại SKAN. |
Chuỗi thời gian | Có |
ad_network_name | Mạng quảng cáo |
Tên mạng quảng cáo được mạng quảng cáo báo cáo cho AppsFlyer.
|
Chuỗi | Không |
ip |
Địa chỉ IP trong thông báo HTTP của thiết bị iOS gửi bài đăng lại. Trường này sẽ được nhập nếu mạng quảng cáo cung cấp địa chỉ cho chúng tôi. Lưu ý! SDK không liên quan đến việc lấy địa chỉ. |
Chuỗi | Không | |
skad_app_id |
1.0 | Chuỗi | Không | |
source_app_id |
AppsFlyer | ID Trang web. Ứng dụng đăng quảng cáo. Trường này giống với skad_source_app_id | Chuỗi | Không |
ad_network_adset_id |
Mạng quảng cáo | Chuỗi | Không | |
ad_network_adset_name |
Mạng quảng cáo | Chuỗi | Không | |
ad_network_ad_name |
Mạng quảng cáo | Chuỗi | Không | |
ad_network_ad_id |
Mạng quảng cáo | Chuỗi | Không | |
did_win |
3.0 (iOS 14.6) |
Được sử dụng để phân biệt giữa các chiến dịch đóng góp cho hoặc được phân bổ bằng lượt cài đặt.
|
Boolean | Có |
fidelity_type |
2.2 (iOS 14.5) |
Phân biệt giữa các tùy chọn trình bày quảng cáo ảnh hưởng đến phân bổ. Được biểu thị bằng cách sử dụng các giá trị 0 và 1 như sau:
Bỏ qua giá trị trường nếu phiên bản SKAN là phiên bản trước 2.2 |
Số nguyên | Có |
ad_network_source_app_id |
Mạng quảng cáo | ID ứng dụng của nhà phát hành được mạng quảng cáo báo cáo. Sử dụng để giúp đối chiếu chi phí do mạng quảng cáo báo cáo. Ứng dụng của nhà phát hành cung cấp cơ sở cho dữ liệu này. | Chuỗi | Không |
ad_network_channel |
Mạng quảng cáo | Chuỗi | Không | |
af_prt |
Mạng quảng cáo | Chuỗi | Không | |
skad_postback_sequence_index |
4.0 (iOS 16.2) |
|
Số nguyên | Có |
skad_coarse_conversion_value |
4.0 (iOS 16.2)
|
|
Chuỗi | Có |
skad_source_identifier | 4.0 (iOS 16.2) |
|
Chuỗi | Có |
skad_source_domain | 4.0 (iOS 16.2) |
|
Chuỗi | Có |
ad_network_creative | Mạng quảng cáo |
|
Chuỗi | Không |
** Apple xác định xem trường này có được điền bằng cơ chế ngưỡng quyền riêng tư hay không |
|
Các trường có sẵn trong báo cáo sự kiện được giải mã
Tên trường | Nguồn | Mô tả | Định dạng | Được đưa vào báo cáo phương diện quảng cáo SRN |
---|---|---|---|---|
ad_network_campaign_id | Mạng quảng cáo | ID chiến dịch được mạng quảng cáo báo cáo cho AppsFlyer | Chuỗi | Có |
ad_network_campaign _name |
Mạng quảng cáo | Tên chiến dịch được mạng quảng cáo báo cáo cho AppsFlyer | Chuỗi | Có |
ad_network_timestamp | Mạng quảng cáo |
Thời gian mạng quảng cáo nhận được bài đăng lại Trong trường hợp của Google Ads, trường này không được điền. |
Nhãn thời gian (chuỗi thời gian cho báo cáo phương diện quảng cáo SRN) |
Có |
app_id | iOS | ID ứng dụng (ứng dụng của nhà quảng cáo) | Chuỗi | Có |
city | Bắt đầu từ ngày 30 tháng 8 năm 2021, giá trị luôn là null | Chuỗi | Không | |
country_code | Mạng quảng cáo | Chuỗi | Không | |
dma | Bắt đầu từ ngày 30 tháng 8 năm 2021, giá trị luôn là null | Chuỗi | Không | |
event_name | AppsFlyer |
Tên sự kiện trong ứng dụng như được định cấu hình trong AppsFlyer. Đối với báo cáo ___SRN, đây là tên sự kiện trong ứng dụng như được cấu hình trong Meta ads. |
Chuỗi | Có |
event_uuid | AppsFlyer | Một mã định danh ngẫu nhiên duy nhất cho phép các đối tác xác định các bài đăng lại trùng lặp | Chuỗi | Không |
install_date | iOS | Ước tính bởi AppsFlyer dựa trên thời gian đến của bài đăng lại. | Chuỗi thời gian | Không |
install_type | iOS | Lượt cài đặt mới | Chuỗi | Không |
ip | iOS |
Địa chỉ IP trong thông báo HTTP của thiết bị iOS gửi bài đăng lại. Trường này sẽ được nhập nếu mạng quảng cáo cung cấp địa chỉ cho chúng tôi. Lưu ý! SDK không liên quan đến việc lấy địa chỉ. |
Chuỗi | Không |
media_source | iOS | Mạng quảng cáo được phân bổ bằng cách sử dụng tên mạng AppsFlyer | Chuỗi | Có |
postal_code | Bắt đầu từ ngày 30 tháng 8 năm 2021, giá trị luôn là null | Chuỗi | Không | |
region | AppsFlyer | Được xác định theo country_code | Chuỗi | Không |
skad_ad_network_id | iOS | ID của mạng quảng cáo đã được gửi bài đăng lại | Chuỗi | Không |
skad_ambiguous_event | AppsFlyer | Nếu là true, đăng lại trên iOS đã được nhận trong 72 giờ đầu tiên sau khi nhà quảng cáo thay đổi cài đặt SKAN trong bảng điều khiển. Do SKAN sử dụng nhiều bộ đếm thời gian khác nhau, AppsFlyer không thể ánh xạ sự kiện một cách chính xác. | Boolean | Không |
skad_attribution_signature | iOS | Chuỗi | Không | |
skad_campaign_id | iOS | ID Chiến dịch được sử dụng để đăng quảng cáo. Phạm vi 0-100 | Số nguyên | Không |
skad_conversion_value | iOS |
Giá trị chuyển đổi do iOS báo cáo. Phạm vi 0-63. Nếu là null thì iOS sẽ không nhập vào trường này** |
Số nguyên | Không |
skad_mode | AppsFlyer |
Chế độ đo lường chuyển đổi được sử dụng để giải mã đăng lại của iOS. Tùy chọn:
|
Chuỗi | Không |
skad_redownload | iOS | Nếu là true, ứng dụng đã được tải xuống lại | Boolean | Không |
skad_revenue | iOS | Số tiền doanh thu sự kiện tính bằng USD. | Float | Không |
skad_source_app_id | iOS |
ID Trang web - ứng dụng đăng quảng cáo. Trường có được điền hay không phụ thuộc vào ngưỡng quyền riêng tư** |
Chuỗi | Không |
skad_transaction_id | iOS | - | Chuỗi | Không |
skad_version | iOS | - | Chuỗi | Không |
timestamp | iOS |
Thời gian AppsFlyer nhận được đăng lại SKAN. Đối với Google Ads và Meta ads, đây là lúc AppsFlyer lần lượt lấy dữ liệu từ API Google và Meta ads. |
Nhãn thời gian (chuỗi thời gian cho báo cáo phương diện quảng cáo SRN) |
Có |
event_value | S2S |
Giá trị mặc định: null Chứa một chuỗi do ứng dụng triển khai giải mã tùy chỉnh đặt. Các nhà quảng cáo sử dụng giá trị này trong hệ thống của họ. Còn AppsFlyer thì không sử dụng giá trị đó. |
String (JSON) | Không |
ad_network_adset_id |
Mạng quảng cáo | Chuỗi | Có | |
ad_network_adset_name |
Mạng quảng cáo | Chuỗi | Có | |
ad_network_ad_name |
Mạng quảng cáo | Chuỗi | Có | |
ad_network_ad_id |
Mạng quảng cáo |
|
Chuỗi | Có |
skad_did_win (1) |
3.0 (iOS 14.6) |
Được sử dụng để phân biệt giữa các chiến dịch đóng góp cho hoặc được phân bổ bằng lượt cài đặt.
|
Boolean | Không |
skad_fidelity_type (1) |
2.2 (iOS 14.5) |
Phân biệt giữa các tùy chọn trình bày quảng cáo ảnh hưởng đến phân bổ. Được biểu thị bằng cách sử dụng các giá trị 0 và 1 như sau:
Bỏ qua giá trị trường nếu phiên bản SKAN là phiên bản trước 2.2 |
Số nguyên | Có |
ad_network_source_app_id (1) |
Mạng quảng cáo | ID ứng dụng của nhà phát hành được báo cáo bởi mạng quảng cáo. Sử dụng để giúp điều hòa chi phí; được báo cáo bởi mạng quảng cáo. Ứng dụng của nhà phát hành cung cấp cơ sở cho dữ liệu này. | Chuỗi | Không |
ad_network_channel (1) |
Mạng quảng cáo | Chuỗi | Không | |
af_prt (1) |
Mạng quảng cáo | Chuỗi | Không | |
min_revenue |
AppsFlyer | Xem lưu ý (4) | Số thực | Không |
max_revenue |
AppsFlyer | Xem lưu ý (4) | Số thực | Không |
event_revenue |
AppsFlyer |
Công thức: [tổng giá trị cho sự kiện cụ thể bằng USD]/[Số lượng sự kiện đã diễn ra trong một ngày cụ thể] |
Float | Có |
min_event_counter |
AppsFlyer | Dùng để tính số lần người dùng thực hiện một sự kiện. Xem lưu ý (3) | Số nguyên | Không |
max_event_counter |
AppsFlyer | Xem ghi chú (3) | Số nguyên | Không |
min_time_post_install |
AppsFlyer | Xem lưu ý (5) | Số nguyên | Không |
max_time_post_install |
AppsFlyer | Xem lưu ý (5) | Số nguyên | Không |
af_attribution_flag |
AppsFlyer |
Khi cơ chế Nguồn dữ liệu Tin cậy Duy nhất (SSOT) được bật: Nếu là true, thì lượt cài đặt được phân bổ cho cả AppsFlyer và SKAN. Nếu là false, lượt cài đặt không được phân bổ bởi AppsFlyer. Nếu skad_conversion_value là null thì cờ báo là true hoặc false (dựa trên mô hình). |
Boolean | Không |
measurement_window |
AppsFlyer | Thời lượng của khung thời gian hoạt động. Mặc định là 24 giờ. | Số nguyên | Không |
interval |
AppsFlyer | Khoảng thời gian của khung thời gian hoạt động. | Số nguyên | Không |
user_agent |
AppsFlyer | Tác nhân người dùng thiết bị | Chuỗi | Không |
skad_postback_sequence_index |
4.0 (iOS 16.2) |
|
Số nguyên | Có |
skad_coarse_conversion_value |
4.0 (iOS 16.2) |
|
Chuỗi | Có |
skad_source_identifier | 4.0 (iOS 16.2) |
|
Chuỗi | Có |
skad_source_domain | 4.0 (iOS 16.2) |
|
Chuỗi | Có |
ad_network_creative | Mạng quảng cáo |
|
Chuỗi | Không |
** Apple xác định xem trường này có được điền bằng cơ chế ngưỡng quyền riêng tư hay không (1) Bắt đầu từ ngày 2 tháng 6 năm 2021, trường này sẽ được thêm vào báo cáo nhưng không nhất thiết phải được điền. (3) Để xác định số lần người dùng thực hiện một sự kiện trong ứng dụng cụ thể, hãy sử dụng công thức: (4) Doanh thu luôn được cung cấp trong trường (5)
|
|
Thông tin bổ sung
Đặc điểm và hạn chế
Đặc điểm | Nhận xét |
---|---|
Truy cập mạng quảng cáo | Các mạng quảng cáo được cung cấp các bài đăng lại |
Truy cập đại lý | Không có sẵn |
Tính minh bạch của đại lý | Không áp dụng |
Múi giờ | UTC |
Tiền tệ | USD |
Dữ liệu tự nhiên | Dựa trên dữ liệu sự kiện SDK. Ví dụ, số liệu về lượt cài đặt tự nhiên được tính như sau: Dữ liệu của tất cả các lượt cài đặt do SDK báo cáo trừ số lượt cài đặt không tự nhiên do SKAN báo cáo. |
Dữ liệu không tự nhiên | Dựa trên các bài đăng lại của SKAN |
Tính cập nhật của dữ liệu |
Hằng ngày. Thời gian SKAN có nghĩa là iOS báo cáo về lượt cài đặt 24-48 giờ sau khi thời hạn đóng. |
Dữ liệu lịch sử |
Giới hạn trong cửa sổ khả dụng của Data Locker. |
Quyền truy cập tài khoản của người dùng | Có sẵn. Theo quyền tài khoản |