Thông số kỹ thuật báo cáo dữ liệu thô V5

Các trường (cột) trong báo cáo dữ liệu thô. Mô tả nội dung, tên và định dạng của dữ liệu được cung cấp trong các báo cáo dữ liệu thô.

Tệp CSV dữ liệu thô được phân phối theo các phương pháp sau:

  • Tải xuống:  Truy cập  Báo cáo > Dữ liệu xuất.  
  • API:  Chọn đúng API 
  • Khóa dữ liệu:  Gửi các tệp trong tủ khóa dữ liệu của bạn. 

Các tham số thông báo API đẩy tương tự như thông số kỹ thuật dữ liệu thô này, với một số biến thể (xem danh sách đầy đủ). 

Các trường dữ liệu thô cũng được tìm thấy trong API Chính  và truy vấn URL API Pull. 

Câu hỏi thường gặp và mẹo tiếp thị về cách sử dụng báo cáo dữ liệu thô

Lưu ý về các trường ngày trong tệp CSV: 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ách sử dụng cài đặt ngày và giờ của máy tính của bạn. Đảm bảo chọn  hiển thị ngày thích hợp trong Excel

Bảng thông số kỹ thuật trường báo cáo

Mỗi trường báo cáo chứa các mục sau:

  • Tên API: được sử dụng bởi API
  • Tên hiển thị: như xuất hiện trong các báo cáo được tạo bởi AppsFlyer
  • Nguồn: vị trí nguồn ban đầu của nội dung trường như sau:
  • Mô tả
  • Loại và Độ dài tối đa: Nói chung,  trừ khi được chỉ định khác, các giá trị trường là các chuỗi, không giới hạn về độ dài, vì chúng có thể chứa các giá trị do người dùng tạo. Tuy nhiên, một số trường có độ dài tối đa hoặc loại dữ liệu logic được nêu cụ thể theo từng trường bên dưới. Một số trường không giới hạn có thể có một số cụ thể trong các ngoặc vuông trong cột loại & độ dài tối đa, thể hiện giới hạn trên logic (nhưng không được thực hiện) đối với độ dài của trường.
Các trường dữ liệu thô V5 được sắp xếp theo nguồn

Tên tham số API

Tên hiển thị

Nguồn

Mô tả

Loại và chiều dài  tối đa

af_ad

ad

Liên kết

Cũng bao gồm thông tin Facebook

Chuỗi - tối đa 100 ký tự

 

af_ad_id

 

ID Quảng cáo

Liên kết

Cũng bao gồm thông tin Facebook

Chuỗi - tối đa 24 ký tự

 

af_ad_type

Loại Quảng cáo

Liên kết

Loại quảng cáo (biểu ngữ, chân trang, v.v.)

Chuỗi - tối đa 24 ký tự

af_adset

Bộ quảng cáo

Liên kết

Cũng bao gồm thông tin Facebook

Chuỗi - tối đa 100 ký tự

af_adset_id

ID Bộ quảng cáo

Liên kết

 

Chuỗi - tối đa 24 ký tự

af_c_id

ID Chiến dịch

Liên kết

Chiến dịch Chuỗi - tối đa 24 ký tự

af_channel

Kênh

Liên kết

Kênh nguồn phương tiện, Ví dụ: YouTube cho Google, Instagram cho Facebook Enum động - Chuỗi - tối đa 20 ký tự

af_cost_currency*

Đơn vị tiền tệ của chi phí

Liên kết

Chi phí tiền tệ (danh sách) Enum - tối đa 3 ký tự

af_cost_model

Mô hình Chi phí

Liên kết

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 - tối đa 20 ký tự

af_cost_value

Giá trị Chi phí

Liên kết

Chi phí bằng tiền tệ gốc. Hỗ trợ lên tới 4 chữ số sau dấu thập phân. Ví dụ: 320.5095 Chuỗi - tối đa 20 ký tự

af_keywords

Từ khóa

Liên kết

Nhận được từ các đối tác tích hợp

Chuỗi - tối đa 100 ký tự

af_click_lookback

Xem lại phân bổ Liên kết Cửa sổ xem lại cho phân bổ nhấp chuột. Thời lượng của cửa sổ này là CTIT (Thời gian nhấp để cài đặt) tối đa cho người dùng mới được phân bổ đến nguồn hiển thị quảng cáo/liên kết.

Tối đa 3 ký tự

af_prt

Đối tác

Liên kết

Đại lý hoặc PMD

Chuỗi - tối đa 50 ký tự

af_reengagement_window

Cửa sổ Tương tác lại

Liên kết

Khung thời gian phân bổ tương tác lại là số ngày trong đó một sự kiện có thể được phân bổ vào một chiến dịch nhắm mục tiêu lại Tối đa 3 ký tự

af_siteid

ID trang

Liên kết

ID nhà phát hành Chuỗi - tối đa 24 ký tự

af_sub_siteid

ID Trang phụ

Liên kết

ID nhà phát hành phụ

Chuỗi - tối đa 50 ký tự

af_sub1

Thông số phụ 1

Liên kết

Thông số tùy chỉnh tùy chọn được xác định bởi nhà quảng cáo Chuỗi - tối đa 100 ký tự

af_sub2

Thông số phụ 2

Liên kết

Thông số tùy chỉnh tùy chọn được xác định bởi nhà quảng cáo Chuỗi - tối đa 100 ký tự

af_sub3

Thông số phụ 3

Liên kết

Thông số tùy chỉnh tùy chọn được xác định bởi nhà quảng cáo Chuỗi - tối đa 100 ký tự

af_sub4

Thông số phụ 4

Liên kết

Thông số tùy chỉnh tùy chọn được xác định bởi nhà quảng cáo Chuỗi - tối đa 100 ký tự

af_sub5

Thông số phụ 5

Liên kết

Thông số tùy chỉnh tùy chọn được xác định bởi nhà quảng cáo Chuỗi - tối đa 100 ký tự

chiến dịch

Chiến dịch

Liên kết

Tên chiến dịch cho các tích hợp đặc biệt (ví dụ: Facebook) trả lại qua API và không phải qua liên kết.

Chuỗi - tối đa 100 ký tự

is_retargeting

Đang nhắm mục tiêu lại

Liên kết

đúng / sai

Enum - tối đa 5 ký tự

media_source

Nguồn truyền thông

Liên kết

Các mạng thông thường (loại trừ FB) sẽ xuất hiện trong liên kết.

Chuỗi - tối đa 50 ký tự

original_url

URL gốc

Liên kết

URL lượt hiển thị/lượt nhấp. Ví dụ: http://your.url.com URL - 2083 ký tự tối đa

user_agent

Tác nhân người dùng

Liên kết

Tác nhân người dùng cho URL Chuỗi - tối đa 200 ký tự

advertising_id

ID quảng cáo

SDK

ID quảng cáo là ID ẩn danh, duy nhất, có thể cài đặt lại theo người dùng dành cho quảng cáo được cung cấp bởi các dịch vụ Google Play. Tối đa 40 ký tự

android_id

ID Android

SDK

ID thiết bị Android Tối đa 20 ký tự

amazon_aid

Amazon Fire ID

SDK

ID quảng cáo Amazon Fire TV

Tối đa 40 ký tự

app_id

ID ứng dụng

SDK

ID của ứng dụng.

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

Với iOS - tối đa12 ký tự
Với Android - Chuỗi - tối đa 100 ký tự

app_name

Tên ứng dụng

SDK

Tên của ứng dụng Chuỗi - tối đa 100 ký tự

app_version

Phiên bản ứng dụng

SDK

Phiên bản ứng dụng  Tối đa 8 ký tự

appsflyer_id

ID AppsFlyer

SDK

Mã định danh cài đặt duy nhất. ID duy nhất được tạo bởi AppsFlyer khi ứng dụng khởi chạy lần đầu tiên. ID là duy nhất cho mỗi lần cài đặt ứng dụng. Điều này có nghĩa là một id mới được phân bổ nếu ứng dụng bị xóa và sau đó được cài đặt lại.  Xem thêm về Customer User ID.

Tối đa 24 ký tự (iOS)

Tối đa 33 ký tự (Android)

bundle_id

ID gói

SDK

Xác định để khớp với một ứng dụng duy nhất hoặc nhóm ứng dụng (đối với iOS) Chuỗi - tối đa 100 ký tự

nhà cung cấp dịch vụ

nhà cung cấp dịch vụ

SDK

Tên nhà mạng Chuỗi - tối đa 50 ký tự

country_code

Mã quốc gia

SDK

Mã quốc gia. Ví dụ: GB, US Enum - tối đa 2 ký tự

custom_data

Dữ liệu tùy chỉnh

SDK

  • Dữ liệu được gửi bằng SDK
  • Xem AndroidiOS
Chuỗi - tối đa 1024 ký tự

customer_user_id

Customer User ID

SDK

Được đặt bởi chủ sở hữu ứng dụng, sử dụng SDK,  để sử dụng làm mã định danh người dùng duy nhất.  Chuỗi - tối đa 100 ký tự

device_category

Danh mục thiết bị

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
Chuỗi - tối đa 20 ký tự

device_type

Loại thiết bị

SDK

Tên model thương mại của thiết bị.  Ví dụ: SM-GM284 hoặc iPhone7

Chuỗi - tối đa 100 ký tự

event_name

Tên của sự kiện

SDK

Tên sự kiện đã xảy ra Chuỗi - tối đa 100 ký tự

event_revenue

Doanh thu sự kiện

SDK

Số tiền hoặc doanh thu theo Tiền tệ doanh thu sự kiện. Chuỗi - tối đa 20 ký tự

event_revenue_currency*

Tiền tệ doanh thu sự kiện

SDK

Tiền tệ doanh thu sự kiện như đã báo cáo với SDK . Chuỗi - tối đa 20 ký tự

event_time

Thời gian sự kiện

SDK

Thời gian sự kiện đã xảy ra Thời gian ngày - 24 ký tự tối đa

event_value

Giá trị của sự kiện

SDK

Giá trị sự kiện Chuỗi - tối đa 1000 ký tự

idfa

idfa

SDK

Đối với iOS - IDFA thiết bị Tối đa 40 ký tự

idfv

IDFV

SDK

Mã định danh cấp ứng dụng cho một nhà cung cấp cụ thể Tối đa 40 ký tự

imei

imei

SDK

IMEI thiết bị đối với Android và iOS Tối đa 14 ký tự

install_app_store

Cài đặt App Store

SDK

Xác định cửa hàng Android nơi ứng dụng được tải từ đó về (chi tiết) Chuỗi - tối đa 50 ký tự

install_time

Thời gian cài đặt

SDK

Thời gian ra mắt đầu tiên sau khi cài đặt. Định dạng "mm/dd/yyyy hh:mm:ss PM/AM". Ví dụ: "11/19/2016 8:32:12 PM"

 

 

Thời gian ngày - 24 ký tự tối đa

ip

IP

SDK

Địa chỉ IP IP - tối đa 15 ký tự (đối với IPv4)

ngôn ngữ

ngôn ngữ

SDK

Ngôn ngữ thiết bị Chuỗi - tối đa 20 ký tự

người điều hành

người điều hành

SDK

Tên nhà mạng Chuỗi - tối đa 50 ký tự

os_version

Phiên bản hệ điều hành

SDK

Phiên bản hệ điều hành Tối đa 8 ký tự

nền tảng

nền tảng

SDK

Các giá trị có thể có: iOS, Android hoặc Windows Mobile

Enum - tối đa 8 ký tự

sdk_version

Phiên bản SDK

SDK

Phiên bản SDK Tối đa 8 ký tự

wifi

wifi

SDK

đúng / sai

Enum - tối đa 5 ký tự

gp_broadcast_referrer

Liên kết giới thiệu GP Broadcast

SDK

Google Play Broadcast Referrer

Chuỗi - tối đa 100 ký tự

amazon_aid

Amazon Fire ID

 

ID quảng cáo Amazon

Chuỗi - tối đa 100 ký tự

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

Chuỗi - tối đa 100 ký tự

attributed_touch_time

Thời gian tiếp xúc được phân bổ

AF

Thời gian của tương tác mà chúng tôi đã phân bổ. Định dạng "mm/dd/yyyy hh:mm:ss PM/AM". Ví dụ: "11/19/2016 8:32:12 PM"

Thời gian ngày - 24 ký tự tối đa

attributed_touch_type

Loại tiếp xúc được phân bổ

AF

Loại tương tác được phân bổ bởi AppsFlyer. Giá trị có thể:  nhấp chuột/hiển thị/TV/được cài đặt sẵn

Enum - 10 ký tự tối đa

contributor_1_af_prt

Đối tác Người đóng góp 1

AF

Đại lý hoặc PMD -
luôn được chuyển thành chữ thường

Chuỗi - tối đa 50 ký tự

contributor_1_campaign

Chiến dịch Người đóng góp 1

AF

Chiến dịch của Người đóng góp Chuỗi - tối đa 100 ký tự

contributor_1_match_type

Loại so khớp Người đóng góp 1

AF

Giá trị có thể bao gồm:

gp_referrer,  id_matching, srn

Chuỗi - tối đa 50 ký tự

contributor_1_media_source

Nguồn phương tiện Người đóng góp 1

AF

Nguồn phương tiện của người đóng góp Chuỗi - tối đa 50 ký tự

contributor_1_touch_time

Thời gian tương tác Người đóng góp 1

AF

Thời gian tương tác

Thời gian ngày - 24 ký tự tối đa

contributor_1_touch_type

Loại tương tác Người đóng góp 1

AF

Loại tương tác

click, impression, TV

Enum - 10 ký tự tối đa

contributor_2_af_prt

Đối tác Người đóng góp 2

AF

Đại lý hoặc PMD Chuỗi - tối đa 50 ký tự

contributor_2_campaign

Chiến dịch Người đóng góp 2

AF

Chiến dịch của Người đóng góp Chuỗi - tối đa 100 ký tự

contributor_2_match_type

Loại so khớp Người đóng góp 2

AF

Giá trị có thể bao gồm:

gp_referrer/id_matching/srn

Chuỗi - tối đa 50 ký tự

contributor_2_media_source

Nguồn phương tiện Người đóng góp 2

AF

Nguồn phương tiện của người đóng góp Chuỗi - tối đa 50 ký tự

contributor_2_touch_time

Thời gian tương tác Người đóng góp 2

AF

Thời gian tương tác Thời gian ngày - 24 ký tự tối đa

contributor_2_touch_type

Loại tương tác Người đóng góp 2

AF

Loại tương tác

(có thể là lượt nhấp/lượt hiển thị/TV)

Enum - 10 ký tự tối đa

contributor_3_af_prt

Đối tác Người đóng góp 3

AF

Đại lý hoặc PMD Chuỗi - tối đa 50 ký tự

contributor_3_campaign

Chiến dịch Người đóng góp 3

AF

Chiến dịch của Người đóng góp Chuỗi - tối đa 100 ký tự

contributor_3_match_type

Loại so khớp Người đóng góp 3

AF

Giá trị có thể bao gồm:

gp_referrer/id_matching/srn

Chuỗi - tối đa 50 ký tự

contributor_3_media_source

Nguồn phương tiện Người đóng góp 3

AF

Nguồn phương tiện của người đóng góp Chuỗi - tối đa 50 ký tự

contributor_3_touch_time

Thời gian tương tác Người đóng góp 3

AF

Thời gian tương tác Thời gian ngày - 24 ký tự tối đa

contributor_3_touch_type

Loại tương tác Người đóng góp 3

AF

Loại tương tác

(có thể là lượt nhấp/lượt hiển thị/TV)

Enum - 10 ký tự tối đa

dma

DMA

AF

Khu vực thị trường được chỉ định - khu vực địa lý tại Hoa Kỳ nơi hoạt động xem TV tại địa phương được đo lường bởi công ty Nielsen. Chuỗi - tối đa 10 ký tự

event_revenue_usd

Doanh thu sự kiện USD

AF

Số doanh thu bằng USD hoặc loại tiền tệ tùy chọn, có thể cấu hình trong Cài đặt ứng dụng. Chuỗi - tối đa 20 ký tự

event_source

Nguồn sự kiện

AF

Nguồn sự kiện - hoặc SDK hoặc S2S Enum - tối đa 3 ký tự

http_referrer

Liên kết giới thiệu HTTP

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 URL - 2083 ký tự tối đa

is_primary_attribution

Là phân bổ chính

AF

Trong khung thời gian tương tác lại, chúng tôi có thể phân bổ về nguồn phương tiện gốc (trước lượt tương tác lại) hoặc về nguồn phương tiện tương tác lại. Trong khi sự kiện nằm trong khung thời gian tương tác lại, nguồn phương tiện gốc sẽ không phải là phân bổ chính. Ngoài khung thời gian tương tác lại, đó sẽ là phân bổ chính.

Enum - tối đa 5 ký tự

is_receipt_validated

Biên nhận đã được xác nhận chưa

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ự

match_type

Loại so khớp

AF

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

gp_referrer (Chuỗi liên kết giới thiệu Google Play)

id_matching

In dấu vân tay

srn (Mạng tự báo cáo)

tv (phân bổ truyền hình)

cài đặt sẵn

Chuỗi - tối đa 50 ký tự

postal_code

Mã bưu chính

AF

Dựa trên IP của SDK Chuỗi - tối đa 10 ký tự

vùng

Vùng

AF

Dựa trên IP từ SDK

Chuỗi - tối đa 100 ký tự

retargeting_conversion_type

Loại lượt chuyển đổi nhắm mục tiêu lại

AF

Thu hút lại / Phân bổ lại

Enum - 14 ký tự tối đa

state

Bang

AF

Dựa trên IP từ SDK

Chuỗi - tối đa 100 ký tự

keyword_match_type

Loại so khớp từ khóa

AF

Các kết quả loại khớp từ khóa bằng cách API mạng tìm kiếm hoặc liên kết phân bổ sẽ được ánh xạ tới báo cáo thô.

Lưu ý: Google AdWords và Apple Search Ads là các mạng duy nhất trả về thông số này cho các chiến dịch tìm kiếm.

Chuỗi - tối đa 100 ký tự

network_account_id

ID tài khoản mạng

AF

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

Chuỗi - tối đa 100 ký tự

rejected_reason_value

Lý do bị Từ chối

AF

Xuất hiện trong Báo cáo Quy tắc Xác thực Nhắm mục tiêu - ID quy tắc gây ra từ chối

Chuỗi - tối đa 100 ký tự

rejected_reason Lý do bị Từ chối AF Xuất hiện trong Báo cáo quy tắc xác thực nhắm mục tiêu - loại quy tắc gây ra từ chối, ví dụ: install-validation-rule Chuỗi - tối đa 100 ký tự
blocked_reason Lý do bị chặn AF Xuất hiện trong dữ liệu thô P360 - lý do cài đặt bị chặn, ví dụ: install_hijacking Chuỗi - tối đa 100 ký tự
blocked_sub_reason Lý do phụ bị chặn AF

Xuất hiện trong dữ liệu thô P360 - một lý do cụ thể cho cài đặt bị chặn, ví dụ:

lý do bị chặn: install_hijacking

blocked sub-reason: referrer_hijack

Chuỗi - tối đa 100 ký tự
blocked_reason_value Giá trị Lý do Bị chặn AF Thông tin bổ sung về việc bị chặn Chuỗi - tối đa 100 ký tự
blocked_reason_rule Quy tắc Lý do Bị chặn AF Trường không được chấp nhận - luôn null  Không áp dụng

gp_click_time

Thời gian nhấp Google Play

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

Định dạng: dấu thời gian tính bằng giây

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

Ví dụ về trường hợp sử dụng: Bằng cách so sánh install_time với gp_click, bạn có thể nhận được thông tin về thời gian người dùng mất bao lâu kể từ khi họ bắt đầu tải xuống ứng dụng cho đến khi họ mở ứng dụng. 

Thời gian ngày - 24 ký tự tối đa

gp_install_begin

Thời gian bắt đầu cài đặt Google Play

Trường Google Play

Thời gian cài đặt bắt đầu 
Nguồn thời gian: Thiết bị người dùng. Có nghĩa là thời gian hiển thị trên thiết bị. 

Định dạng: dấu thời gian tính bằng giây

Ghi chú: 

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

Thời gian ngày - 24 ký tự tối đa

gp_referrer

Liên kết giới thiệu Google Play

Trường Google Play

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

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

Chuỗi - tối đa 1024 ký tự

gp_broadcast_referrer

Liên kết giới thiệu GP Broadcast

Trường Google Play

Google Play Broadcast Referrer

Chuỗi - tối đa 1024 ký tự

Mã tiền tệ.

Bài viết này có hữu ích không?