Từ điển trường dữ liệu thô

Phân bổ

Ad

Liên kết

Chuỗi 100

Phân bổ

Ad ID

Liên kết

Chuỗi 24

Phân bổ

Ad type

Liên kết

Ví dụ: biểu ngữ, chân trang

Chuỗi 24

Phân bổ

Adset

Liên kết

Chuỗi 100

Phân bổ

Adset ID

Liên kết

ID bộ quảng cáo, ID của một bộ quảng cáo. 

Chuỗi 24

Phân bổ

Ad placement

Liên kết

Được điền vào CTV.vị trí đặt quảng cáo 

Chuỗi 64

Phân bổ

Không áp dụng

Phân bổ

Campaign ID

Liên kết

Phân bổ

Channel

Liên kết

Phân bổ

Campaign type

AF

Nguồn mang đến người dùng:

• UA
• Tự nhiên
• Nhắm mục tiêu lại
• Không xác định

Phân bổ

Conversion type

AF

Loại chuyển đổi:

• Cài đặt
• Lượt cài đặt lại (1)
• Thu hút lại 
• Không xác định (2)

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

Phân bổ

Cost currency

Liên kết

Phân bổ

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ổ

Cost value

Liên kết

Phân bổ

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

Phân bổ

Attribution lookback window

Liên kết

Khoảng thời gian tối đa khi lượt cài đặt có thể được phân bổ cho một quảng cáo cụ thể.

• UA: Đối với phân bổ lượt nhấp, hãy đặt thông số đường dẫn phân bổ af_click_lookback. 
• Nhắm mục tiêu lại: Xem lại lượt nhấp nhắm mục tiêu lại. 

Tối đa 3 ký tự

Phân bổ

Partner

Liên kết

Đại lý hoặc PMD

Chuỗi 50

Phân bổ

Re-engagement window

Liên kết

Nhắm mục tiêu lại: Khoảng thời gian trong đó các sự kiện được phân bổ cho một chiến dịch nhắm mục tiêu lại

Lưu ý: Trường này không được điền vào các chiến dịch nhắm mục tiêu lại.

Phân bổ

Site ID

Liên kết

Phân bổ

Sub site ID

ID nhà phát hành phụ

Chuỗi 50

Phân bổ

Sub param [n]

(n=1-5)

Liên kết

Phân bổ

Campaign

Liên kết

Tên chiến dịch

Chuỗi 100

Phân bổ

Is retargeting

Liên kết

• UA: False
• Nhắm mục tiêu lại: True cho lượt chuyển đổi và sự kiện nhắm mục tiêu lại

Enum 5 ký tự boolean

Phân bổ

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

Phân bổ

Original URL

Liên kết

• UA: URL lượt nhấp/hiển thị được sử dụng. Nếu liên kết là Liên kết có gắn Thương hiệu: trường được điền bằng liên kết gắn thương hiệu đó.
• Nhắm mục tiêu lại: chứa một trong các mục sau: Liên kết nhắm mục tiêu lại, dữ liệu liên kết sâu, giá trị trống cho SRN.

Thông tin thiết bị

User agent

Liên kết

Thông tin thiết bị

Advertising ID

SDK

• ID thiết bị người dùng có thể đặt lại, AKA GAID.
• Đối với CTV, đây là ID CTV, ví dụ như RIDA hoặc VIDA.

Thông tin 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.

Thông tin thiết bị

Android ID

SDK

Ứng dụng

App ID

SDK

• iOS: id123456789
• Android: com.appsflyer.referrersender

iOS: Chuỗi 12

Android: Chuỗi 100

Ứng dụng

App name

SDK

Ứng dụng

App version

SDK

Thông tin thiết bị

AppsFlyer ID

SDK

• ID duy nhất do SDK tạo ra khi ứng dụng được cài đặt trên thiết bị. ID được sử dụng để phân bổ các sự kiện trong ứng dụng trong luồng LTV, tìm nạp dữ liệu chuyển đổi và liên kết các sự kiện trong ứng dụng. 
• ID mới sẽ được tạo nếu ứng dụng bị xóa và cài đặt lại. Việc khôi phục ứng dụng từ bản sao lưu iCloud không được coi là một lượt cài đặt.
• Đối với CTV, trường này được điền với custom_device_id (ID thiết bị do nhà quảng cáo quản lý). 

iOS: Chuỗi 24

Android: Chuỗi 33

Ứng dụng

Bundle ID

SDK

ios: Nhận dạng để khớp với một ứng dụng hoặc một nhóm ứng dụng trong iOS (Xem ID gói nhà phát triển Apple) 

Android: Tên ứng dụng

Lưu ý: Trường này không liên quan đến PBA AppsFlyer.

Thông tin thiết bị

Carrier

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.

Vị trí thiết bị

Country code

AF

• Mã Quốc gia sử dụng ISO 3166 (alpha-2) Ví dụ: US, CN.
• Mã Vương quốc Anh được triển khai là UK, không phải GB. 

Phân bổ

Custom data

SDK

• Tập dữ liệu do 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, Đối tượng, v.v. 
• Xem Android và iOS

Thông tin thiết bị

Customer
user ID

SDK

Thông tin thiết bị

Deeplink URL

SDK

Thông tin 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
• Tương thích với SDK Android V4.8.8 trở lên

Thông tin thiết bị

Device type

SDK

Tên model thương mại của thiết bị.

[Bắt đầu từ ngày 2 tháng 2 năm 2022, trường này không còn được điền nữa]

Thay vì trường này, hãy sử dụng Model thiết bịvới cách điền tương tự.

Ví dụ:

• Model thiết bị: xiaomi::Redmi Note 8
  Loại thiết bị: xiaomi-Redmi Note 8
• Model thiết bị: iPhone7
  Loại thiết bị: iPhone 7

Chuỗi 100

 Thông tin thiết bị

Device model 

SDK 

Thông tin thiết bị

Device download time

SDK

Thời gian hoàn thành tải xuống ứng dụng bằng đồng hồ của thiết bị (Android, iOS) và được chuyển đổi sang UTC. Giá trị luôn hiển thị dưới dạng  thời gian UTC.

Định dạng: yyyy-mm-dd hh:mm:ss.sss

Sự kiện

Event name

AF/SDK

Loại sự kiện phân bổ hoặc tên sự kiện trong ứng dụng do ứng dụng gửi.  Các loại sự kiện phân bổ ví dụ:  cài đặt, thu hút lại, v.v. 

Lưu ý! Trong Data Locker, trong trường hợp báo cáo nhắm mục tiêu lại, tên sự kiện được đặt như sau: nhắm mục tiêu lại có nghĩa là thu hút lại, cài đặt có nghĩa là phân bổ lại.

Sự kiện

Event revenue

SDK

• Giá trị doanh thu sử dụng Tiền tệ Doanh thu Sự kiện.
• Các khoản tiền nằm ngoài khoảng  $-10.000- $+10.000 (hoặc tương đương) xuất hiện trong các báo cáo dữ liệu thô nhưng không phải trong báo cáo hợp nhất.

Sự kiện

Event revenue currency

SDK

Sự kiện

Event time

SDK

Thời gian sự kiện xảy ra

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.

Thông tin thiết bị

IDFA

SDK

Thông tin thiết bị

IDFV

SDK

Thông tin thiết bị

IMEI

SDK

Phân bổ

Install app store

SDK

Phân bổ

Install time

SDK

• UA: Khởi chạy lần đầu sau khi cài đặt.
• Nhắm mục tiêu lại: Khởi chạy ứng dụng lần đầu sau khi thu hút lại/phân bổ lại

Ngày Giờ

Vị trí thiết bị

IP

AF

Thông tin thiết bị

Is LAT

SDK

Giới hạn theo dõi quảng cáo (LAT):

iOS:Bắt đầu từ iOS 14, LAT không còn được Apple hỗ trợ. Xác định trạng thái quyền riêng tư của người dùng bằng ATT. Trong trường hợp này, bỏ qua is_lat.

Trước phiên bản iOS 14, nếu được đặt thành true, IDFA sẽ không khả dụng và được đặt về 0. 

Android: Khi đặt thành true, người dùng đã chọn không tham gia quảng cáo dựa trên sở thích. Điều này không ngăn chặn việc thu thập GAID.

Thông tin thiết bị

Language

SDK

Ngôn ngữ (địa phương) được báo cáo bởi thiết bị và được thiết lập bởi HĐH 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.

Thông tin thiết bị

OAID

SDK

Thông tin thiết bị

ATT

SDK

ATT, hay còn gọi là att_status khả dụng trên iOS 14+, và được hệ thống điền các giá trị từ một trong số các thông số sau: Returned by ATTrackingManager (Do ATTrackingManager trả về, sent by S2S (do S2S gửi), determined by AppsFlyer (do AppsFlyer xác định).

Giá trị ATT là bất kỳ giá trị nào sau đây: not_determined, restricted, denied, authorized, af_unknown, af_authorized, af_unavailable.

Thông tin thiết bị

Operator

SDK

Thông tin thiết bị

OS version

SDK

Thông tin thiết bị

Platform

SDK

Nền tảng thiết bị: iOS, Android hoặc Windows Mobile

Enum chuỗi 8

Ứng dụng

SDK version

SDK

Thông tin thiết bị

WIFI

SDK

true hoặc false

Enum 5 ký tự boolean

Thông tin thiết bị

Store reinstall

SDK

Cửa hàng ứng dụng Apple xác định xem người dùng do Apple Search Ads mang đến có được cài đặt lại bằng ID người dùng Apple hay không:

• Người dùng mới: false
• Cài đặt lại bởi người dùng hiện có: true

Thông tin thiết bị

Amazon Fire ID

SDK

ID quảng cáo người dùng có thể đặt lại trên các thiết bị Amazon.

Vị trí thiết bị

City

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, huyện, v.v. vốn mang tính chính xác cao hơn.

Chuỗi 100

Phân bổ

Attributed touch time

AF

UA: thời gian tương tác mà chúng tôi đã phân bổ.

Nhắm mục tiêu lại: thời gian thu hút mà chúng tôi đã phân bổ.

Ngày Giờ

Phân bổ

Attributed touch type

AF

UA: Các giá trị có thể có: Lượt nhấp, lượt hiển thị, TV, lượt được cài đặt sẵn

Nhắm mục tiêu lại: lượt nhấp, lượt hiển thị

Enum tối đa 10 ký tự

Phân bổ

Contributor [n] partner (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ổ

Contributor [n] campaign (n=1-3)

AF

Phân bổ

Contributor [n] match type (n=1-3)

AF

Phân bổ

Contributor [n] media source (n=1-3)

AF

Phân bổ

Contributor [n] touch time (n=1-3)

AF

Ngày Giờ

Phân bổ

Contributor [n] touch type (n=1-3)

AF

Các giá trị có thể có: lượt nhấp, hiển thị, TV

Enum tối đa 10 ký tự

Vị trí thiết bị

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. 

Sự kiện

Event revenue USD

Event revenue Preferred

Event revenue XXX

AF

Số tiền doanh thu. Tiền tệ sẽ phụ thuộc vào công cụ báo cáo được sử dụng.

Tiền tệ được ưu tiên hoặc được chọn có nghĩa là loại tiền tệ riêng cho ứng dụng được đặt trong mục cài đặt của ứng dụng.

Hộp khóa Dữ liệu: luôn là USD

Trang xuất: loại tiền tệ được chọn 

API Pull có thể lựa chọn: USD hoặc được chọn bằng cách sử dụng &currency=preferred. 

API Push: luôn chứa cả hai trường, USD và tiền tệ được chọn

Sự kiện

Event source

AF

Phân bổ

HTTP referrer

AF

Phân bổ

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.

Enum tối đa 5 ký tự

Sự kiệ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ổ

Match type

AF

Loại phương pháp phân bổ. Giá trị có thể bao gồm:

• SRN
• id_matching
• probabilistic
• deeplink
• preinstall
• gp_referrer (Chuỗi liên kết giới thiệu Google Play)
• Liên kết giới thiệu cửa hàng ứng dụng Andriod của bên thứ ba

Vị trí thiết bị

Postal code

AF

Vị trí thiết bị

Region

AF

Sử dụng địa chỉ IP của thiết bị do SDK báo cáo

Chuỗi 100

Phân bổ

Retargeting conversion Type

AF

UA : Cài đặt lại

Nhắm mục tiêu lại: Thu hút lại, phân bổ lại

Kế hoạch ngừng hỗ trợ: Trong tương lai trường này sẽ bị ngừng hỗ trợ. Sử dụng conversion_type và campaign_type để xác định trường hợp của lượt chuyển đổi.

Enum tối đa 14 ký tự

Vị trí thiết bị

State

AF

Sử dụng địa chỉ IP của thiết bị do SDK báo cáo

Chuỗi 100

Phân bổ

Keyword ID

Liên kết

Phân bổ

Keyword match type

AF

Loại so khớp từ khóa này chỉ được cung cấp bởi Google AdWords. 

Bắt đầu từ ngày 15 tháng 2 năm 2021, trường này sẽ không còn được điền nữa liên quan đến Apple Search Ads.

Phân bổ

Network account ID

Chỉ API SRN

ID tài khoản của nhà quảng cáo với đối tác

Chuỗi 100

Protect360

Rejected reason value

AF

Protect360: Hiển thị người đóng góp hợp lệ (nguồn truyền thông) đối với số lượt cài đặt/sự kiện trong ứng dụng hậu phân bổ bị đánh cắp. Được điền bằng người đóng góp[1-3] hoặc tự nhiên.

Trong Data Locker, điều này hiển thị dưới dạng validation_reason_value. 

Chuỗi 100

Protect360

Rejected reason

Protect360

Blocked reason

Protect360

Blocked sub reason

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 người giới thiệu, CTIT_anomalies, validation_rules

Protect360

Blocked reason value

Protect360

Blocked reason rule

Phân bổ

Google Play click time

Trường Google Play

Thời gian tải trang ứng dụng trong Google Play sau khi nhấp vào quảng cáo.

Nguồn thời gian: Google API

Khả dụng từ Android SDK v. 4.8.5.

Ví dụ: So sánh thời gian install_time với thời gian gp_click_time. Điều này giúp đưa ra một cái nhìn sâu sắc về thời gian từ lúc tải xuống đến lúc một người dùng mở một ứng dụng.

Phân bổ

Google Play install begin time

Cửa hàng Google Play

Thời gian cài đặt bắt đầu
Nguồn thời gian: API Google.

Có sẵn từ Android SDK V4.8.5

Phân bổ

Google Play referrer

Cửa hàng Google Play

URL giới thiệu của gói được cài đặt.

Có sẵn từ Android SDK V4.8.5

Phân bổ

Google Play broadcast referrer

Cửa hàng Google Play

Google Play Broadcast Referrer

Doanh thu Quảng cáo

Ad unit

API doanh thu quảng cáo

Loại doanh thu quảng cáo của quảng cáo

Doanh thu Quảng cáo

Segment

API doanh thu quảng cáo

Doanh thu Quảng cáo

Placement

Vị trí đặt doanh thu quảng cáo

Doanh thu Quảng cáo

Monetization network

API doanh thu quảng cáo

Mạng doanh thu quảng cáo gửi quảng cáo

Doanh thu Quảng cáo

Impressions

API doanh thu quảng cáo

Doanh thu quảng cáo: số lần người dùng đã xem quảng cáo

Doanh thu Quảng cáo

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

Phân bổ

Custom dimension

SDK

Dành riêng cho AppsFlyer sử dụng trong tương lai

Ứng dụng

App type

Clip ứng dụng

Giá trị: app_clip, full_app

Protect360

Fraud reason

AF

Protect360: Xem lý do cho việc bị chặn.

Protect360

Fraud sub reason

AF

Protect360: Xem lý do phụ cho việc bị chặn.

Protect360

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. 

Protect360

Detection date

AF

Ngày phát hiện gian lận hậu phân bổ.

Phân bổ

Attribution Touch Hour

Postback

Thời gian tiếp xúc phân bổ được làm tròn xuống đến giờ gần nhất

Phân bổ

Install Hour

Postback

Thời gian cài đặt được làm tròn xuống đến giờ gần nhất

Phân bổ

Event Hour

Đăng lại 

Thời gian sự kiện làm tròn xuống đến giờ gần nhất

Phân bổ

Store product page

AF