Khái quát: Từ điển trường dữ liệu (thông số kỹ thuật dữ liệu thô) mô tả nội dung của trường. Từ điển này nên được sử dụng để giúp bạn hiểu ý nghĩa của các trường, cách trường được định dạng và khi nào trường khả dụng. Báo cáo dữ liệu thô, công cụ và API.
Từ điển trường dữ liệu thô
Bảng sau đây là một từ điển liệt kê các trường dữ liệu thô khả dụng trong nhiều báo cáo AppsFlyer khác nhau. Bảng này liên tục được cập nhật khi các trường dữ liệu thô được bổ sung thêm vào AppsFlyer.
Các cột trong bảng từ điển là:
- Nhóm trường: Nhóm theo logic dựa trên việc sử dụng trường. Lưu ý! Các trường trong nhóm doanh thu quảng cáo được hiển thị trong báo cáo dữ liệu thô dưới dạng cột riêng hoặc được nhập như một phần của giá trị Sự kiện.
-
Tên Trường:
- Tên trường sử dụng trong các báo cáo được cung cấp qua trang Xuất và API Pull.
- Ký hiệu [n] có nghĩa là có nhiều phiên bản của cùng một trường, sự khác biệt là số phiên bản. Ví dụ: Thông số Phụ [n] có nghĩa là, Thông số Phụ 1, Thông số Phụ 2, ..., Thông số Phụ 5. Phạm vi các giá trị n được ghi là (n=1-5).
-
Tên API:
- Tên trường như được hiển thị trong báo cáo Data Locker và API Push.
- Ký hiệu [n] có nghĩa là có nhiều phiên bản của cùng một trường, sự khác biệt là số phiên bản. Ví dụ: Thông số Phụ [n] có nghĩa là, Thông số Phụ 1, Thông số Phụ 2, ..., Thông số Phụ 5. Phạm vi các giá trị n được ghi là (n=1-5).
-
Nguồn: Vị trí nguồn ban đầu của nội dung trường, ví dụ:
- Đường dẫn: Đường dẫn phân bổ (Xem Cấu trúc và thông số đường dẫn phân bổ của AppsFlyer) hoặc bằng API từ SRN nếu thích hợp.
- SDK: Được thu thập qua SDK trong ứng dụng.
- AF: Được tạo bởi AppsFlyer.
- và nhiều vị trí nguồn khác.
-
Mô tả
- Một số trường có ý nghĩa khác tùy thuộc vào ngữ cảnh của sự kiện, chẳng hạn như do kết quả của chiến dịch UA hoặc nhắm mục tiêu lại.
-
Định dạng: Loại và độ dài trường.
- Chuỗi: Độ 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. Không được vượt quá thông số kỹ thuật về độ dài trường.
-
Ngày giờ:
- Chuỗi có định dạng,
yyyy-mm-dd hh:mm:ss
. Ví dụ:2019-09-17 00:09:25
Múi giờ được sử dụng để hiển thị dữ liệu tùy thuộc vào công cụ phân phối dữ liệu như sau:- Trang dữ liệu xuất: múi giờ do ứng dụng chọn.
- API Push: các trường thời gian có tùy chọn selected_time_zone có nghĩa là múi giờ riếng cho ứng dụng khác UTC.
- API Chính: Mặc định là múi giờ ứng dụng có thể lựa chọn.
- Hộp khóa dữ liệu: UTC
- Các trường ngày trong tệp CSV có định dạng năm-tháng-ngày. Khi bạn mở tệp CSV trong Excel, các trường ngày được định dạng bằng cài đặt ngày và giờ của máy tính. Bạn có thể thay đổi định dạng hiển thị trong Excel. Để xem giá trị chưa được định dạng, hãy mở tệp tin bằng trình chỉnh sửa.
- API Push:
- Đối với các trường nhãn thời gian theo UTC: định dạng
yyyy-mm-dd hh:mm:ss.sss
. Ví dụ:2019-09-17 00:09:25.123
- Đối với các trường nhãn thời gian trong múi giờ đã chọn: định dạng
yyyy-mm-dd hh:mm:ss.±th:tm
. Ví dụ2019-01-20 04:51:16.000+0000
.
- Đối với các trường nhãn thời gian theo UTC: định dạng
- Chuỗi có định dạng,
- Enum n char: 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
-
Enum 5 ký tự boolean: Giá trị của trường có thể là
TRUE
hoặcFALSE
Lời khuyên
- Để sắp xếp bảng, hãy nhấp vào tên cột.
- Bạn cũng có thể tải xuống bảng.
- Tệp CSV đã tải xuống còn chứa các trường bổ sung ngoài những trường được đề cập ở trên:
-
Một phần của lược đồ báo cáo chính của AppsFlyer:
- Phần lớn báo cáo AppsFlyer được tạo từ cùng một lược đồ và chứa các trường giống nhau.
- Một số trường có thể bị nhập giá trị null hoặc trống, tùy thuộc vào báo cáo và liệu dữ liệu có được thu thập từ mạng quảng cáo, nhà quảng cáo, nền tảng thiết bị, v.v., hay không.
- Khi cấu hình hệ thống BI của bạn, tốt nhất bạn nên cấu hình tất cả các trường lược đồ chính của AppsFlyer, ngay cả khi một báo cáo nhất định luôn trả về chúng dưới dạng giá trị null hoặc trống. Điều này cho phép bạn dễ dàng nhập dữ liệu nếu và khi dữ liệu có sẵn.
- Nếu một trường không phải là một phần của lược đồ báo cáo chính của AppsFlyer, thì trường đó chỉ có trong các báo cáo cụ thể. Ví dụ: SKAN báo cáo.
- Phương thức xuất báo cáo: Cho biết liệu một trường nhất định có khả dụng thông qua API Push, Xuất dữ liệu/API Pull và Data Locker hay không. Lưu ý: Ngay cả khi một trường là một phần của lược đồ báo cáo chính của AppsFlyer, thì trường đó có thể không phải là một phần của các báo cáo được tạo xuất theo một phương thức cụ thể. Ví dụ: trường vị trí là một phần của lược đồ AppsFlyer chính, nhưng trường này chỉ hiển thị trong các báo cáo được tạo xuất qua Data Locker, API Pull hoặc trang Xuất dữ liệu; không thông qua API Push.
-
Một phần của lược đồ báo cáo chính của AppsFlyer:
Nhóm trường | Tên trường | Tên API | Nguồn | Mô tả | Định dạng |
---|---|---|---|---|---|
Phân bổ | Quảng cáo | af_ad | Liên kết | Tên quảng cáo | Chuỗi 100 |
SKAN | ID Quảng cáo | ad_network _ad_id |
Mạng Quảng cáo | ID Quảng cáo | chuỗi |
Phân bổ | ID Quảng cáo | af_ad_id | Liên kết | ID Quảng cáo | Chuỗi 24 |
SKAN | Tên quảng cáo | ad_network _ad_name |
Mạng Quảng cáo | Tên quảng cáo | chuỗi |
SKAN | ID mạng quảng cáo | skad_ad _network_id |
iOS | ID của mạng quảng cáo đã được gửi bài đăng lại | chuỗi |
SKAN | Tên mạng quảng cáo | ad_network _name |
Mạng Quảng cáo |
|
chuỗi |
SKAN | ID ứng dụng nguồn mạng quảng cáo | 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 |
SKAN | Nhãn thời gian của mạng quảng cáo | ad_network _timestamp |
Mạng Quảng cáo |
|
Nhãn thời gian |
Phân bổ | Vị trí đặt quảng cáo | ad_placement | Liên kết | Được nhập vào vị trí đặt quảng cáo CTV | Chuỗi 64 |
Phân bổ | Loại quảng cáo | af_ad_type | Liên kết | Ví dụ: biểu ngữ, chân trang | Chuỗi 24 |
Doanh thu Quảng cáo | Đơn vị quảng cáo | ad_unit | API doanh thu quảng cáo | Tên phân đoạn quảng cáo và doanh thu quảng cáo khi tiến hành thử nghiệm A/B | Chuỗi 1024 |
Phân bổ | Bộ quảng cáo | af_adset | Liên kết | Tên bộ quảng cáo, xác định một nhóm chứa một hoặc nhiều quảng cáo | Chuỗi 100 |
SKAN | ID Bộ quảng cáo | ad_network _adset_id |
Mạng Quảng cáo | ID Bộ quảng cáo | chuỗi |
Phân bổ | ID Bộ quảng cáo | af_adset_id | Liên kết | ID bộ quảng cáo, xác định một nhóm chứa một hoặc nhiều quảng cáo | Chuỗi 24 |
SKAN | Tên bộ quảng cáo | ad_network _adset_name |
Mạng Quảng cáo | Tên bộ quảng cáo | chuỗi |
Thông tin thiết bị | ID quảng cáo cho thiết bị Android | advertising_id | SDK |
|
Chuỗi 40 |
SKAN | Cờ phân bổ AF | af_attribution _flag |
AF | 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ổ bởi cả AppsFlyer và SKAN. Nếu là false, lượt cài đặt không được AppsFlyer phân bổ. Nếu skad_conversion_value là null, cờ sẽ là true hoặc false (dựa trên chức năng lập mô hình). | Boolean |
Thông tin thiết bị | Amazon Fire ID | amazon_aid | SDK | ID quảng cáo người dùng có thể đặt lại trên các thiết bị Amazon. | Chuỗi 100 |
SKAN | Sự kiện mơ hồ | skad_ambiguous _event |
AF | 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 |
Thông tin thiết bị | ID Android | android_id | SDK | ID thiết bị vĩnh viễn | Chuỗi 20 |
Ứng dụng | ID ứng dụng | app_id | SDK | Mã định danh ứng dụng duy nhất trong Appsflyer. Ví dụ:
|
iOS: Chuỗi 12 Android: Chuỗi 100 |
SKAN | ID ứng dụng | skad_app_id | iOS | ID ứng dụng | chuỗi |
Ứng dụng | Tên ứng dụng | app_name | SDK | Do nhà quảng cáo thiết lập | Chuỗi 100 |
Ứng dụng | Loại ứng dụng | app_type | Clip ứng dụng | Giá trị: app_clip, full_app | chuỗi |
Ứng dụng | Phiên bản ứng dụng | app_version | SDK | Do nhà quảng cáo thiết lập | Tối đa 8 ký tự |
Thông tin thiết bị | ID AppsFlyer | appsflyer_id | SDK |
|
iOS: Chuỗi 24 Android: Chuỗi 33 |
Thông tin thiết bị | ATT | att | SDK |
|
Chuỗi 20 |
Phân bổ | Thời gian chạm được phân bổ | attributed_touch _time |
AF |
|
Ngày Giờ |
Phân bổ | Kiểu tương tác được phân bổ | attributed_touch _type |
AF |
|
Enum tối đa 10 ký tự |
Phân bổ | Khung thời gian xem lại phân bổ | af_attribution _lookback |
Liên kết |
|
Tối đa 3 ký tự |
SKAN | Chữ ký phân bổ | skad_attribution _signature |
iOS | Chữ ký được mạng quảng cáo thêm vào các bài đăng lại SKAN | chuỗi |
Protect360 | Lý do bị chặn | blocked_reason | AF | Protect360: Lý do chặn lượt cài đặt. Ví dụ: install_hijacking, bot | Chuỗi 100 |
Protect360 | Quy tắc lý do cho việc bị chặn (không còn được hỗ trợ) | blocked_reason _rule |
AF | Ngưng hỗ trợ | Chuỗi 100 |
Protect360 | Giá trị Lý do Bị chặn | blocked_reason _value |
AF | Protect360: Thông tin bổ sung về việc chặn. Ví dụ: ID Trang web, (các) tên quy tắc xác thực | Chuỗi 100 |
Protect360 | Lý do phụ bị chặn | blocked_sub _reason |
AF | Protect360: Lý do phụ cụ thể đối với lượt cài đặt bị chặn. Ví dụ: Lý do: install_hijacking. Lý do phụ: đánh cắp liên kết giới thiệu, CTIT_anomalies, validation_rules | Chuỗi 100 |
Ứng dụng | ID gói | bundle_id | SDK |
|
Chuỗi 100 |
SKAN | Chiến dịch | 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 |
Phân bổ | Chiến dịch | chiến dịch | Liên kết | Tên chiến dịch | Chuỗi 100 |
SKAN | ID Chiến dịch | 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 |
Phân bổ | ID Chiến dịch | af_c_id | Liên kết | ID Chiến dịch | chuỗi |
SKAN | ID Chiến dịch | 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 |
Phân bổ | Loại chiến dịch | campaign_type | AF | Nguồn mang đến người dùng:
|
chuỗi |
Thông tin thiết bị | nhà cung cấp dịch vụ | nhà cung cấp dịch vụ | SDK | Tên nhà mạng được cung cấp bởi Android bằng cách sử dụng getSimCarrierIdName(). Xem thêm ánh xạ nhà mạng. | Chuỗi 50 |
SKAN | Kênh | ad_network _channel |
Mạng Quảng cáo | Trường được thêm vào báo cáo nhưng không nhất thiết sẽ được điền | chuỗi |
Phân bổ | Kênh | af_channel | Liên kết | Kênh nguồn truyền thông. Ví dụ: YouTube cho Google, Instagram cho quảng cáo Meta | Enum động. Chuỗi 20 |
Vị trí thiết bị | thành phố | thành phố | AF | Vị trí chi tiết nhất của người dùng dựa trên IP thiết bị. Thông thường, giá trị mang tên thành phố, nhưng nó cũng có thể là quận, thị xã, v.v., vốn mang tính chính xác cao hơn. | Chuỗi 100 |
SKAN | Giá trị chuyển đổi thô | skad_coarse _conversion _value |
iOS |
|
chuỗi |
Phân bổ | Người đóng góp[n] Chiến dịch | contributor[n] _campaign (n=1-3) |
AF | Chiến dịch Người đóng góp | Chuỗi 100 |
Phân bổ | Người đóng góp[n] loại so khớp |
contributor[n] |
AF | Các giá trị có thể có sẽ giống với loại so khớp. | Chuỗi 50 |
Phân bổ | Người đóng góp[n] nguồn truyền thông | contributor[n] _media_source (n=1-3) |
AF | Nguồn truyền thông Người đóng góp | Chuỗi 50 |
Phân bổ | Người đóng góp[n] Đối tác | contributor[n] _af_prt (n=1-3) |
AF | Đại lý hoặc PMD - luôn được chuyển thành chữ thường | Chuỗi 50 |
Phân bổ | Người đóng góp[n] thời gian tương tác | contributor[n] _touch_time (n=1-3) |
AF | Thời gian tương tác Người đóng góp | Ngày Giờ |
Phân bổ | Người đóng góp[n] Kiểu Tương tác | contributor[n] _touch_type (n=1-3) |
AF | Các giá trị có thể có: lượt nhấp, lượt hiển thị | Enum tối đa 10 ký tự |
Phân bổ | Loại chuyển đổi | conversion_type | AF |
Loại chuyển đổi:
(1) Nếu conversion_type= reinstall và campaign_type=retargeting tương đương với retargeting_conversion_type=re-attribution (2) Các sự kiện trong ứng dụng/phiên không được phân bổ cho bất kỳ nguồn truyền thông nào. |
chuỗi |
SKAN | Giá trị chuyển đổi | skad_conversion _value |
iOS |
|
Số nguyên |
Phân bổ | Đơn vị tiền tệ của chi phí | af_cost_currency | Liên kết | Mã tiền tệ gồm 3 chữ cái (USD, EUR) tuân thủ tiêu chuẩn ISO-4217. Mặc định là USD. | Chuỗi 3 ký tự |
Phân bổ | Mô hình Chi phí | af_cost_model | Liên kết | Mô hình chi phí được báo cáo trên đường dẫn phân bổ. CPC/CPI/CPM/Khác. Hiện tại, tất cả chi phí được tính theo CPI bất kể giá trị này là gì | Chuỗi 20 |
Phân bổ | Giá trị Chi phí | af_cost_value | Liên kết | Số tiền của Tiền tệ Chi phí. Cho phép đến 4 chữ số sau dấu thập phân. Ví dụ: 320,5095 | Chuỗi 20 |
Vị trí thiết bị | Mã quốc gia | country_code | AF |
|
Chuỗi Enum 2 |
SKAN | Sáng tạo | ad_network _creative |
Mạng Quảng cáo |
|
chuỗi |
Đăng ký | CUID | af_cuids | Trình kết nối SDK giao dịch mua của AppsFlyer |
|
|
Phân bổ | Dữ liệu tùy chỉnh | custom_data | SDK | Dữ liệu được đặt bởi S2S hoặc nhà quảng cáo trong SDK và thường được sử dụng nhất để tích hợp với bên thứ ba, Audiences, v.v. Xem Android và iOS | Chuỗi 1024 |
Phân bổ | Phương diện tùy chỉnh |
custom _dimension |
SDK | Dành riêng cho AppsFlyer sử dụng trong tương lai | chuỗi |
Thông tin thiết bị | Customer user ID | customer _user_id |
SDK | ID người dùng ứng dụng duy nhất, được đặt bởi chủ sở hữu ứng dụng. | Chuỗi 100 |
Thông tin thiết bị | URL Liên kết sâu | deeplink_url | SDK | Đường dẫn cho hoạt động nội bộ trong ứng dụng mà người dùng được liên kết sâu. Sử dụng để liên kết sâu và deferred deep linking. Trường này chứa giá trị af_dp trên đường dẫn phân bổ |
Chuỗi 1024 |
Protect360 | Ngày phát hiện | detection_date | AF | Ngày phát hiện gian lận hậu phân bổ. | Chuỗi 100 |
Thông tin thiết bị | Danh mục thiết bị | device_category | SDK | Các giá trị có thể bao gồm: điện thoại, máy tính bảng, khác. | Chuỗi 20 |
Thông tin thiết bị | Thời gian tải xuống của thiết bị | device_download _time |
SDK |
Thời gian hoàn tất tải xuống ứng dụng sử dụng đồng hồ Android/iOS của thiết bị và được chuyển đổi thành giờ UTC. Giá trị luôn hiển thị dưới dạng giờ UTC. Định dạng: yyyy-mm-dd hh:mm:ss.sss |
Ngày Giờ |
Thông tin thiết bị | Loại ID thiết bị | device_id_type | SDK | Được điền cho CTV với loại ID nền tảng CTV. Ví dụ: RIDA cho Roku. | Enum 4 |
Thông tin thiết bị | Model Thiết bị | device_model | SDK | Tên model thương mại của thiết bị. Ví dụ: xiaomi::Redmi hoặc iPhone7 | Chuỗi 100 |
Thông tin thiết bị | Loại thiết bị | device_type | SDK |
|
Chuỗi 100 |
SKAN | Đã thắng | skad_did_win | iOS |
|
Boolean |
Đăng ký IAP |
ID Chiết khấu | af_discount_id | Trình kết nối SDK giao dịch mua của AppsFlyer | ID ưu đãi được hiển thị cho người dùng trong lần mua đầu tiên. ID chỉ được điền khi có mã giảm giá. | |
Đăng ký | Loại chiết khấu | af_discount_type | Trình kết nối SDK giao dịch mua của AppsFlyer | Loại phiếu giảm giá mà người dùng đã quy đổi. Những giá trị có thể có:
|
|
Vị trí thiết bị | DMA | dma | AF | Khu vực Thị trường được Chỉ định hoặc các khu vực địa lý. Được xác định bởi công ty Nielsen. Xác định vị trí của người dùng. | Chuỗi 10 |
Đăng ký IAP |
Môi trường | af_environment | Trình kết nối SDK giao dịch mua của AppsFlyer | Môi trường (sản xuất hoặc sandbox) mà người dùng sẽ nhận được dữ liệu. | |
Sự kiện | Giờ sự kiện | event_time | Postback | Thời gian sự kiện làm tròn xuống đến giờ gần nhất | Ngày Giờ |
Sự kiện | Tên của sự kiện | event_name | AF/SDK |
|
Chuỗi 100 |
Sự kiện | Doanh thu sự kiện | event_revenue | SDK |
|
Chuỗi 20 |
SKAN | Doanh thu sự kiện | event_revenue | AF | 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ể] | Số thực kiểu float |
Sự kiện | Tiền tệ doanh thu sự kiện | event_revenue _currency |
SDK | Mã tiền tệ doanh thu sự kiện đã báo cáo với SDK. | Chuỗi 20 |
Sự kiện | Đơn vị tiền tệ đã chọn của doanh thu sự kiện | event_revenue _xxx |
|
Chuỗi 20 | |
Sự kiện | Doanh thu sự kiện USD | event_revenue _usd* |
AF |
|
Chuỗi 20 |
Phân bổ | Nguồn sự kiện | event_source | AF | SDK hoặc S2S | Enum tối đa 3 ký tự |
Sự kiện | Thời gian sự kiện | event_time | SDK | Thời gian sự kiện xảy ra | Ngày Giờ |
Sự kiện | Loại sự kiện | event_type | AF/SDK | Loại sự kiện phân bổ. Các loại sự kiện phân bổ ví dụ: lượt cài đặt, lượt thu hút lại, v.v. | Chuỗi 100 |
Sự kiện PBA | URL Sự kiện | event_url | SDK Web | URL của trang web diễn ra sự kiện (bằng URL Gốc trong lượt truy cập trang web) | chuỗi |
Sự kiện | Giá trị của sự kiện | event_value | SDK | Nội dung chi tiết của sự kiện được gửi từ SDK. Lưu ý: Không gửi hơn 1000 ký tự vì chúng có thể bị cắt ngắn. | Chuỗi 1000 |
SKAN | Giá trị của sự kiện | event_value | S2S |
|
Chuỗi (JSON) |
SKAN | Loại tin cậy | fidelity_type |
|
Số nguyên | |
SKAN | Loại tin cậy | skad_fidelity _type |
iOS |
|
Số nguyên |
Protect360 | Lý do gian lận | fraud_reason | AF | Protect360: Xem lý do cho việc bị chặn. | Chuỗi 100 |
Protect360 | Lý do gian lận phụ | fraud_sub _reason |
AF | Protect360: Xem lý do phụ cho việc bị chặn. | Chuỗi 100 |
Phân bổ | Liên kết giới thiệu phát Google Play | gp_broadcast _referrer |
Cửa hàng Google Play | Google Play Broadcast Referrer | Chuỗi 1024 |
Phân bổ | Thời gian nhấp Google Play | gp_click_time | Trường Google Play |
|
Nhãn thời gian |
Phân bổ | Thời gian bắt đầu cài đặt Google Play | gp_install_begin | Cửa hàng Google Play |
|
Nhãn thời gian |
Phân bổ | Liên kết giới thiệu Google Play | gp_referrer | Cửa hàng Google Play |
|
Chuỗi 1024 |
Phân bổ | Liên kết giới thiệu HTTP | http_referrer | AF | Xác định địa chỉ trang web được liên kết với URL lượt nhấp AppsFlyer. Bằng cách kiểm tra liên kết giới thiệu, bạn có thể xem yêu cầu được bắt nguồn từ đâu | Chuỗi tối đa 10.000 ký tự |
Thông tin thiết bị | idfa | idfa | SDK | ID quảng cáo người dùng có thể đặt lại có thể được tìm thấy trên các thiết bị iOS. Nếu IDFA không có sẵn thì thường được điền bằng Zero. | Tối đa 40 ký tự |
Thông tin thiết bị | IDFV | idfv | SDK | ID nhà cung cấp do iOS cung cấp | Tối đa 40 ký tự |
Thông tin thiết bị | imei | imei | SDK | ID thiết bị vĩnh viễn | Tối đa 14 ký tự |
Doanh thu Quảng cáo | Lượt hiển thị | lượt hiển thị | API doanh thu quảng cáo | Số lần người dùng nhìn thấy quảng cáo | Chuỗi 1024 |
Phân bổ | Cài đặt App Store | install_app_store | SDK | Cửa hàng Android nơi ứng dụng được tải xuống (thông tin chi tiết) | Chuỗi 50 |
SKAN | Ngày cài đặt | 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 |
Phân bổ | Thời gian cài đặt | install_time | Postback |
|
Ngày Giờ |
SKAN | Kiểu cài đặt | install_type | iOS | Lượt cài đặt mới | chuỗi |
SKAN | Khoảng thời gian | khoảng thời gian | AF | Khoảng thời gian của khung thời gian hoạt động. | Số nguyên |
Vị trí thiết bị | IP | ip | AF | Địa chỉ IP là IPV4 hoặc IPV6. AppsFlyer sử dụng địa chỉ để xác định vị trí của người dùng. Nếu cần, các nhà quảng cáo có thể che địa chỉ IP khỏi các báo cáo và đăng lại. | chuỗi |
Protect360 | Là tự nhiên | is_organic | AF | Cho biết liệu sự kiện trong ứng dụng có được liên kết với một lượt cài đặt tự nhiên hay không. | Chuỗi 100 |
Phân bổ | Là phân bổ chính | is_primary _attribution |
AF |
UA: True Nhắm mục tiêu lại: Trong khung thời gian thu hút lại, chúng tôi phân bổ cho cả nguồn truyền thông ban đầu (trước khi thu hút lại) và cho nguồn truyền thông thu hút lại. Trong khi sự kiện nằm trong khung thời gian thu hút lại. Nguồn truyền thông ban đầu sẽ là FALSE (không phải phân bổ chính). Nguồn truyền thông thu hút lại sẽ là TRUE. Thông tin chi tiết khác |
Enum tối đa 5 ký tự |
Sự kiện | Là đã xác thực nhận | is_receipt _validated |
AF | true/false/null khi được thực hiện trong SDK, nếu không thì để trống | Enum tối đa 5 ký tự |
Phân bổ | Đang nhắm mục tiêu lại | is_retargeting | Liên kết |
|
Enum 5 ký tự boolean |
Phân bổ | ID từ khóa | keyword_id | Liên kết | ID từ khóa được mạng quảng cáo trả về. Đây là ID của af_keyword. | Chuỗi 100 |
Phân bổ | Loại so khớp từ khóa | keyword_match _type |
AF |
|
Chuỗi 100 |
Phân bổ | Từ khóa | af_keywords | Liên kết | Từ được sử dụng trong phần tìm kiếm trực tuyến của người dùng. Theo báo cáo của mạng quảng cáo | Chuỗi 100 |
Thông tin thiết bị | ngôn ngữ | ngôn ngữ | SDK | Ngôn ngữ (địa phương) được báo cáo bởi thiết bị và được đặt bởi HĐH của thiết bị. Thường có dạng ll-DD. Trong đó ll là ngôn ngữ và DD là phương ngữ. Ví dụ: en-ZA có nghĩa là tiếng Anh được sử dụng ở Nam Phi. | Chuỗi 20 |
Thông tin thiết bị | Giới hạn theo dõi quảng cáo | is_lat | SDK |
Giới hạn theo dõi quảng cáo (LAT):
|
Enum 5 ký tự boolean |
Phân bổ | Loại so khớp | match_type | AF |
Loại phương thức phân bổ. Giá trị có thể có bao gồm:
|
Chuỗi 50 |
SKAN | Bộ đếm sự kiện tối đa | max_event _counter |
AF | Để xác định số lần người dùng thực hiện một sự kiện trong ứng dụng nhất định, hãy sử dụng công thức: [làm tròn (min_event_counter + max_event_counter) / 2]. Lưu ý! Bạn phải làm tròn đến số nguyên gần nhất. Ví dụ: A. Nếu min = 0 và max = 1 thì trung bình là 0,5; làm tròn lên trả về kết quả là 1. B. Nếu min = 5 và max = 10 thì trung bình là 7,5; làm tròn lên trả về kết quả là 8. |
Số nguyên |
SKAN | Doanh thu tối đa | max_revenue | AF | Doanh thu luôn được cung cấp trong trường skad_revenue. Nếu bạn sử dụng SKAN 4 hoặc chế độ Tùy chỉnh, phạm vi bộ chứa được liên kết với sự kiện và được sử dụng để tính skad_revenue sẽ được mô tả bằng min_revenue và max_revenue. | Số thực |
SKAN | Thời gian tối đa sau khi cài đặt | max_time _post_install |
AF |
|
Số nguyên |
Phân bổ PBA | Kênh truyền thông | media_channel | SDK Web | Kênh truyền thông được phân bổ cho lượt truy cập trang web | chuỗi |
Phân bổ | Nguồn truyền thông | media_source | Liên kết | Nguồn truyền thông được phân bổ cho một sự kiện hoặc bị hạn chế | Chuỗi 50 |
Doanh thu Quảng cáo | Mạng Trung gian | mediation _network |
API doanh thu quảng cáo | Mạng trung gian về doanh thu quảng cáo báo cáo sự kiện cho AppsFlyer | Chuỗi 1024 |
SKAN | Số sự kiện tối thiểu | min_event _counter |
AF | Dùng để tính số lần người dùng thực hiện một sự kiện. Để 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: [làm tròn (min_event_counter + max_event_counter) / 2] . Lưu ý! Bạn phải làm tròn đến số nguyên gần nhất. Ví dụ: A. Nếu min = 0 và max = 1 thì trung bình là 0,5; làm tròn lên trả về kết quả là 1. B. Nếu min = 5 và max = 10 thì trung bình là 7,5; làm tròn lên trả về kết quả là 8. |
Số nguyên |
SKAN | Doanh thu tối thiểu | min_revenue | AF | Doanh thu luôn được cung cấp trong trường skad_revenue. Nếu bạn sử dụng SKAN 4 hoặc chế độ Tùy chỉnh, phạm vi bộ chứa được liên kết với sự kiện và được sử dụng để tính skad_revenue sẽ được mô tả bằng min_revenue và max_revenue. | Số thực |
SKAN | Thời gian tối thiểu sau khi cài đặt | min_time _post_install |
AF |
|
Số nguyên |
Doanh thu Quảng cáo | Mạng Kiếm tiền | monetization _network |
API doanh thu quảng cáo | Mạng doanh thu quảng cáo gửi quảng cáo | Chuỗi 1024 |
Đăng ký IAP |
Doanh thu thuần | af_net_revenue | API Doanh thu Thực | Doanh thu thuần được tính dựa trên tất cả các lý do được cân nhắc. Xem af_net_revenue_factors. | |
Đăng ký IAP |
Quốc gia doanh thu thuần | af_net_revenue _country |
API Doanh thu Thực |
|
|
Đăng ký IAP |
Hệ số doanh thu thuần | af_net_revenue _factors |
API Doanh thu Thực |
|
|
Đăng ký IAP |
Mã bưu chính doanh thu thuần | af_net_revenue _postal_code |
API Doanh thu Thực |
|
|
Đăng ký IAP |
Vùng lãnh thổ doanh thu thuần | af_net_revenue _subdivision |
API Doanh thu Thực |
|
|
Đăng ký IAP |
Doanh thu thuần chưa bao gồm thuế | af_net_revenue _tax_exclusive |
API Doanh thu Thực |
|
|
Đăng ký IAP |
Tên thuế doanh thu thuần | af_net_revenue _tax_name |
API Doanh thu Thực |
|
|
Đăng ký IAP |
Thuế suất doanh thu thuần | af_net_revenue _tax_rate |
API Doanh thu Thực |
|
|
Phân bổ | ID tài khoản mạng | network _account_id |
Liên kết | ID tài khoản của nhà quảng cáo với mạng quảng cáo | Chuỗi 100 |
Thông tin thiết bị | OAID | oaid | SDK | ID người dùng có thể đặt lại trên một số thiết bị Android thường thay thế cho GAID | Tối đa 40 ký tự |
Thông tin thiết bị | người điều hành | người điều hành | SDK | Tên của nhà cung cấp dịch vụ di động bắt nguồn từ SIM MCCMNC. Có sẵn nếu người dùng đã đăng ký mạng bằng Android getNetworkOperatorName() | Chuỗi 50 |
Đăng ký IAP |
ID đặt xe | af_order_id | Trình kết nối SDK giao dịch mua của AppsFlyer |
|
|
Đăng ký IAP |
ID giao dịch gốc | af_original _transaction_id |
Trình kết nối SDK giao dịch mua của AppsFlyer |
|
|
Phân bổ | URL gốc | original_url | Liên kết |
|
Chuỗi 10.000 (URL) |
Thông tin thiết bị | Phiên bản hệ điều hành | os_version | SDK | Phiên bản hệ điều hành của thiết bị | Chuỗi 8 |
Phân bổ | Đối tác | af_prt | Liên kết | Mã định danh của cơ quan. Đối với SKAN, có thể sẽ không được điền | chuỗi |
Doanh thu Quảng cáo | Vị trí đặt | vị trí dặt | API doanh thu quảng cáo | Vị trí quảng cáo được hiển thị trong ứng dụng | Chuỗi 1024 |
Thông tin thiết bị | nền tảng | nền tảng | SDK | Nền tảng thiết bị: iOS, Android hoặc Windows Mobile | Chuỗi Enum 12 |
Vị trí thiết bị | Mã bưu chính | postal_code | AF | Sử dụng địa chỉ IP của thiết bị do SDK báo cáo. Đối với SKAN, bắt đầu từ ngày 30 tháng 8 năm 2021, luôn là null | Chuỗi tối đa 10 ký tự |
SKAN | Chỉ mục trình tự đăng lại | skad_postback _sequence_index |
iOS |
|
Số nguyên |
Đăng ký IAP |
ID sản phẩm | af_product_id | Trình kết nối SDK giao dịch mua của AppsFlyer | ID sản phẩm của gói đăng ký | |
Đăng ký IAP |
Ngày mua | af_purchase _date_ms |
Trình kết nối SDK giao dịch mua của AppsFlyer | Ngày mua cho sự kiện trong ứng dụng đối với ID sản phẩm được báo cáo | |
IAP | Trạng thái giao dịch mua | af_purchase_state | Trình kết nối SDK giao dịch mua của AppsFlyer | Những giá trị có thể có:
|
|
Đăng ký IAP |
Token giao dịch mua | af_purchase _token |
Trình kết nối SDK giao dịch mua của AppsFlyer |
|
|
PBA | Thông số truy vấn | query_params | Liên kết |
Thông số truy vấn trên URL chuyển hướng (sau ?) Nếu URL không có thông số truy vấn, giá trị sẽ là null |
chuỗi |
Đăng ký IAP |
Lý do | af_reason | Trình kết nối SDK giao dịch mua của AppsFlyer |
Trong các sự kiện liên quan đến hủy bỏ hoặc rời bỏ, lý do khiến người dùng rời bỏ hoặc hủy bỏ. Những giá trị có thể có:
|
|
SKAN | Tải lại | skad _redownload |
iOS | Nếu là true, ứng dụng đã được tải xuống lại | Boolean |
Phân bổ | Cửa sổ Tương tác lại | af_reengagement _window |
Liên kết |
|
Chuỗi tối đa 3 ký tự |
Đăng ký IAP |
ID giao dịch hoàn tiền | af_refunded _transaction_ids |
Trình kết nối SDK giao dịch mua của AppsFlyer |
|
|
Vị trí thiết bị | Vùng | vùng | AF | Sử dụng địa chỉ IP của thiết bị do SDK báo cáo. Đối với SKAN, được xác định theo country_code | Chuỗi 100 |
Protect360 | Lý do bị Từ chối | rejected_reason | AF | Protect360: Có kế hoạch ngừng hỗ trợ. Hiện chứa lý do bị chặn. | Chuỗi 100 |
Protect360 | Giá trị lý do bị từ chối | rejected _reason_value Trong Data Locker: validation _reason_value |
AF |
|
Chuỗi 100 |
Phân bổ | Loại lượt chuyển đổi nhắm mục tiêu lại | retargeting _conversion_type |
AF |
|
Enum tối đa 14 ký tự |
SKAN | Doanh thu | skad_revenue | iOS | Số tiền doanh thu sự kiện tính bằng USD. | Số thực kiểu float |
Ứng dụng | Phiên bản SDK | sdk_version | SDK | Phiên bản AppsFlyer SDK | Chuỗi 8 |
Doanh thu Quảng cáo | Phân đoạn | phân đoạn | API doanh thu quảng cáo | Tên phân đoạn quảng cáo của doanh thu quảng cáo | Chuỗi 1024 |
Phân bổ | ID trang | af_siteid | Liên kết | ID nhà phát hành | Chuỗi 24 |
SKAN | Khung thời gian đo lường SKAN | measurement _window |
AF | Thời lượng của khung thời gian hoạt động. Mặc định là 24 giờ. | Số nguyên |
SKAN | Chế độ SKAN | skad_mode | AF | 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 |
SKAN | ID giao dịch SKAN | skad _transaction_id |
iOS | ID đăng lại do Apple cung cấp | chuỗi |
SKAN | Phiên bản SKAN | skad_version | iOS | Phiên bản SKAN | chuỗi |
SKAN | ID ứng dụng nguồn | 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. Trường được thêm vào báo cáo nhưng không nhất thiết sẽ được điền | chuỗi |
SKAN | ID ứng dụng nguồn | skad_source _app_id |
iOS |
|
chuỗi |
SKAN | Miền nguồn | skad_source _domain |
iOS |
|
chuỗi |
SKAN | Mã định danh của nguồn | skad_source _identifier |
iOS |
|
chuỗi |
Vị trí thiết bị | Bang | Bang | AF | Sử dụng địa chỉ IP của thiết bị do SDK báo cáo | Chuỗi 100 |
Đăng ký IAP |
Cửa hàng | af_store | Trình kết nối SDK giao dịch mua của AppsFlyer | Cửa hàng ứng dụng bán sản phẩm của gói đăng ký | |
Đăng ký IAP |
Hoa hồng cửa hàng | store_commission | API Doanh thu Thực |
|
|
Phân bổ | Trang sản phẩm của cửa hàng | store_product _page |
AF | Trang sản phẩm tùy chỉnh trong Apple App Store, nơi người dùng đã được chuyển hướng đến. Có sẵn: phiên bản iOS 15 trở lên | Chuỗi 100 |
Thông tin thiết bị | Lưu trữ lượt cài đặt lại | store_reinstall | SDK |
|
Enum 5 ký tự boolean |
Phân bổ | Thông số phụ [n] | af_sub[n] (n=1-5) | Liên kết | Thông số được nhà quảng cáo nhập trong đường dẫn phân bổ | Chuỗi 100 |
Phân bổ | ID Trang web phụ | af_sub_siteid | Liên kết | ID nhà phát hành phụ | Chuỗi 50 |
Đăng ký | Ngày hết hạn của gói đăng ký | af_expires _date_ms |
Ngày hết hạn của chu kỳ thanh toán gói đăng ký hiện tại | ||
Đăng ký | Loại quyền sở hữu gói đăng ký | af_subscription _ownership_type |
Trình kết nối SDK giao dịch mua của AppsFlyer | FAMILY_SHARED có nghĩa là người dùng có quyền truy cập thông qua chia sẻ trong gia đình. PURCHASED có nghĩa là người dùng trả tiền đã thực hiện giao dịch mua. | |
Đăng ký | Loại thời gian gói đăng ký | af_period_type | Trình kết nối SDK giao dịch mua của AppsFlyer |
|
|
SKAN | Nhãn thời gian | nhãn thời gian | Mạng Quảng cáo | Thời gian AppsFlyer nhận được đăng lại Đối với Google Ads và quảng cáo Meta, đây là thời gian AppsFlyer nhận dữ liệu tương ứng từ API Google Ads và quảng cáo Meta. |
Nhãn thời gian |
Đăng ký IAP |
ID Giao dịch | af_transaction_id | Trình kết nối SDK giao dịch mua của AppsFlyer |
|
|
Thông tin thiết bị | Tác nhân người dùng | user_agent | Liên kết | Tác nhân người dùng URL/thiết bị | Chuỗi 1024 |
Thông tin thiết bị | wifi | wifi | SDK | Đặt thành TRUE hoặc FALSE | Enum 5 ký tự boolean |
IAP | af_cancelation _date_ms |
Trình kết nối SDK giao dịch mua của AppsFlyer | Ngày hủy bỏ | ||
SKAN | did_win | iOS |
|
Boolean | |
SKAN | event_uuid | AF | 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 | |
SKAN | source_app_id | AF | 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 |