Chúng tôi hiện đang di chuyển một số loại báo cáo từ báo cáo ngoại tuyến sang báo cáo tức thì. Sau khi người dùng được di chuyển, các phản hồi trong queries.list sẽ bao gồm các báo cáo tức thì hiện có. Hãy xem bài đăng trên blog của chúng tôi để biết thêm thông tin.
Các loại này xác định các trường lồng nhau trong một số bảng; các trường này không có bảng riêng.
Kiểu Numeric Id
Scalar
Mô tả
integer
Mã nhận dạng dạng số dùng làm giá trị nhận dạng cho các thực thể. Bạn không nên coi các mã nhận dạng là duy nhất trên toàn hệ thống, ví dụ: có thể cùng một giá trị mã nhận dạng được dùng cho một Chiến dịch cũng được dùng cho một Pixel.
Kiểu Enum
Scalar
Mô tả
integer
Bảng liệt kê nhiều tuỳ chọn có thể có. Các tuỳ chọn khác nhau được mô tả chi tiết hơn trong loại mẹ.
Kiểu Time
Scalar
Mô tả
integer
Thời gian Unix tính bằng micro giây (1/1.000.000 giây), ví dụ: 1330403779608570 thể hiện thứ Ba,ngày 28 tháng 2 năm 2012, 04:36:19.608570.
Kiểu Currency Micro
Scalar
Mô tả
integer
Số tiền cụ thể theo đơn vị tiền tệ tính bằng micro (1/1.000.000 của một đơn vị tiền tệ), ví dụ nếu đơn vị tiền tệ là EUR, 75000000 có nghĩa là €75 hoặc nếu đơn vị tiền tệ là USD, 250000 sẽ có nghĩa là 0,25 USD. Không có quy đổi sang hoặc từ đô la Mỹ.
Kiểu Percentage Milli
Scalar
Mô tả
integer
Tỷ lệ phần trăm được hiển thị bằng mili (1/1.000 phần trăm), ví dụ: 100 có nghĩa là 0,1%.
Kiểu FileSummary
Tên trường
Loại
Mô tả
name
string
Tên tệp của tệp (không bao gồm tên bộ chứa hoặc thư mục).
num_records
integer
Số lượng thực thể trong tệp.
version
integer
Số phiên bản chính của tệp. Con số này có thể thay đổi nếu sau này bạn tạo phiên bản mới của định dạng dữ liệu thực thể.
Mã nhận dạng duy nhất trong mỗi loại thực thể – ví dụ: đối với các thực thể Đối tác, mã này sẽ là Mã đối tác, đối với Nhà quảng cáo, mã này sẽ là Mã nhận dạng nhà quảng cáo, v.v.
name
string
Tên hiển thị trên giao diện người dùng của thực thể.
active
boolean
Trạng thái do người dùng đặt – thực thể có thể không phân phát vì các lý do khác, chẳng hạn như ngân sách đã cạn kiệt, hết chuyến bay, v.v.
Chỉ được điền nếu auditor là APPNEXUS, APPNEXUS_MICROSOFT hoặc RIGHT_MEDIA_NON_RTB. Đây là mã nhận dạng của pháp nhân trong không gian của người kiểm tra.
Thời gian kết thúc của khoảng thời gian áp dụng ngân sách.
max_impressions
integer
Số lượt hiển thị tối đa cho ngân sách này. Nếu trường này bị thiếu, thì đó là ngân sách không giới hạn số lượt hiển thị.
max_spend_advertiser_micros
integer
Mức chi tiêu tối đa (tính bằng phần triệu đơn vị tiền tệ của nhà quảng cáo) cho ngân sách này. Nếu thiếu trường này, thì đó là ngân sách chi tiêu không giới hạn.
Số lượt hiển thị tối đa trên mỗi khoảng thời gian đặt tốc độ do pacing_type đặt. Nếu thiếu trường này thì tức là số lượt hiển thị sẽ không bị giới hạn.
pacing_max_spend_advertiser_micros
integer
Mức chi tiêu tối đa (tính bằng micro đơn vị tiền tệ của nhà quảng cáo) cho mỗi khoảng thời gian đặt tốc độ đặt giá thầu do pacing_type đặt. Nếu thiếu trường này thì tức là trang web không bị giới hạn mức chi tiêu.
Số tiền doanh thu tính theo micro hiện tại của nhà quảng cáo. Giá trị này chỉ được đặt nếu kiểu là CPM.
media_cost_markup_percent_millis
integer
Tỷ lệ phần trăm doanh thu trong Percentage Milli. Giá trị này chỉ được đặt nếu loại là MEDIA_COST_MARKUP hoặc TOTAL_MEDIA_COST_MARKUP.
post_view_conversion_tracking_fraction
float
Phần trăm lượt chuyển đổi sau khi xem được tính cho tính năng theo dõi lượt chuyển đổi. Nếu giá trị này là 0, thì chỉ lượt chuyển đổi sau lượt nhấp mới được tính; nếu là 1.0, thì tất cả lượt chuyển đổi đều được theo dõi.
Mảng
Target loại cho các nguồn khoảng không quảng cáo.
Target.criteria_id có thể kết hợp với InventorySource.id và Target.parameter không được xác định.
Target cho biết vị trí của quảng cáo trên trang của nhà xuất bản. Các giá trị Target.criteria_id là 0=ALL_POSITIONS 1=ABOVE_THE_FOLD
2=BELOW_THE_FOLD 3=UNKNOWN_POSITION Target.parameter không xác định.
Target cho biết tốc độ mạng.
Các giá trị Target.criteria_id là: 0=ALL_CONNECTION_SPEEDS 1=BROADBAND (2,0 mbps trở lên). 2=DIALUP (56 Kb/giây trở xuống). 3=UNKNOWN_CONNECTION_SPEED 4=EDGE (Enhanced Data for GSM Evolution (2G). 57 kb/giây trở lên). 5=UMT (Universal Mobile Telecom System (3G). 384 Kb/giây trở lên). 6=DSL (Đường dây thuê bao kỹ thuật số. 768 kbps trở lên). 7=HSDPA (Gói đường truyền truy cập tốc độ cao (3,5G). 1,8 Mb/giây trở lên).
Có nghĩa là "(A HOẶC B) VÀ (C HOẶC D) VÀ KHÔNG PHẢI (E HOẶC F)".
Target.criteria_id có thể kết hợp với
UserList.id và
Target.parameter là giá trị gần đây nhất của pixel tính bằng micro giây.
Nếu thiếu giá trị này, thì tức là bạn đang nhắm đến tất cả đối tượng.
Mảng các loại Target cho trang web.
Bạn có thể kết hợp Target.criteria_id với UniversalSite.id hoặc không đặt nếu trang web không nằm trong UniversalSite. Target.parameter là một trang web như google.com nhưng không nhất thiết phải có trong UniversalSite.
Mã của đối tượng đối tác mẹ. Có thể tham gia bằng Partner.common_data.id.
currency_code
string
Mã đơn vị tiền tệ gồm 3 chữ cái theo ISO 4217, ví dụ: USD cho đô la Mỹ.
timezone_code
string
Mã múi giờ chuẩn, ví dụ: "Hoa Kỳ/Los_Angeles". Nếu bạn đặt dfa_configuration thành NORMAL hoặc HYBRID, thì giá trị này sẽ giống với múi giờ của nhà quảng cáo TXT được liên kết.
landing_page_url
string
URL trang đích mặc định.
available_channel_ids
[integer]
Mảng số nguyên chứa các kênh có sẵn được liên kết với nhà quảng cáo này. Có thể tham gia bằng UniversalChannel.id.
blacklist_channel_id
[integer]
Mảng số nguyên chứa các kênh trong danh sách đen của nhà quảng cáo này. Có thể tham gia bằng UniversalChannel.id.
Chỉ báo hiệu suất chính. Sử dụng trường này để theo dõi chỉ số chính mà bạn sẽ dùng để đánh giá mức độ thành công của chiến dịch.
Các giá trị có thể có là: 1 = IMPRESSIONS 2 = VIEWABLE_IMPRESSIONS 3 = CPM 4 = CPV 5 = UNIQUES 6 = GRP 7 = TRP 8 = VCR 9 = CPA 10 = ROAS 11 = CTR 12 = CPC 13 = CVR 14 = CPI 15 = VIEWABLE_PERCENT 16 = CPIAVC 17 = OTHER
objective_description
String
Khi chỉ số là OTHER, đây sẽ là nội dung mô tả ngắn gọn về chỉ số.
0=Not Expandable 1=Expanding Up 2=Expanding Down 3=Expanding Left 4=Expanding Right 5=Expanding Up Left 6=Expanding Up Right 7=Expanding Down Left 8=Expanding Down Right 9=Expanding Up or Down 10=Expanding Left or Right 11=Expanding Any Diagonal
Khi bạn đặt giá trị này thành true, pixel sẽ được bật để chuyển hướng đến/từ Right Media.
remarketing_enabled
boolean
Khi bạn đặt thành true, pixel này sẽ được bật để sử dụng trong quá trình nhắm mục tiêu. Giá trị này sẽ chỉ xuất hiện nếu dfa_configuration của nhà quảng cáo mẹ được đặt thành NONE.
is_secure
boolean
Khi được đặt thành true, pixel này sẽ sử dụng HTTPS. Giá trị này sẽ chỉ xuất hiện nếu dfa_configuration của nhà quảng cáo mẹ được đặt thành NONE.
Khi được đặt thành true, tất cả khoảng không quảng cáo chưa phân loại sẽ được đưa vào.
inventory_name
string
Tên của nguồn khoảng không quảng cáo như hiển thị trong giao diện người dùng. Trường này có thể không có. Nếu không có inventory_name và unclassified là đúng, thì giá trị này sẽ tham chiếu đến khoảng không quảng cáo chưa phân loại của sàn giao dịch. Nếu không có và unclassified là false, thì nguồn khoảng không quảng cáo là khoảng không quảng cáo cấp trao đổi.
Một loạt mã nhận dạng nhà quảng cáo, có thể kết hợp với Advertiser.common_data.id, được phép sử dụng nguồn khoảng không quảng cáo này.
Lưu ý: Nếu một nguồn khoảng không quảng cáo có sẵn cho TẤT CẢ nhà quảng cáo, thì trường này sẽ không xuất hiện.
external_id
string
Mã nhận dạng bên ngoài được cung cấp cho nguồn khoảng không quảng cáo này và do bên trao đổi xác định, thường được gọi là mã giao dịch hoặc mã người bán. Trường này có thể không có.
min_cpm_micros
integer
Giá sàn hiệu quả của nguồn khoảng không quảng cáo này tính theo đơn vị tiền tệ cực nhỏ.
min_cpm_currency_code
string
Mã tiền tệ ISO 4217 gồm 3 chữ cái dùng cho min_cpm_micros.
Một loạt mã nhận dạng nhà quảng cáo, có thể tham gia với Advertiser.common_data.id, được phép sử dụng kênh này.
Lưu ý: Nếu một kênh có sẵn cho TẤT CẢ nhà quảng cáo, thì trường này sẽ không xuất hiện.
is_deleted
boolean
Khi bạn đặt giá trị này thành true, không có mục hàng mới nào có thể nhắm đến kênh này, nhưng các mục hàng hiện tại đã nhắm đến kênh này sẽ tiếp tục nhắm đến kênh này.
is_brand_safe_channel
boolean
Khi được đặt thành true, kênh này có thể được dùng để lọc quảng cáo theo tiêu chí an toàn thương hiệu. Hiện tại, giá trị này chỉ là true cho 4 cấp an toàn thương hiệu được tích hợp sẵn.
Mã ISO-639-1 cho ngôn ngữ này hoặc một trong các mã zh_CN cho tiếng Trung (giản thể), zh_TW cho tiếng Trung (phồn thể) hoặc other cho các ngôn ngữ khác.
Nếu đúng, tiêu chí này chỉ áp dụng cho thiết bị di động. Nếu giá trị là false, mục này chỉ áp dụng cho các thiết bị không phải thiết bị di động, ngay cả khi tên của thiết bị (ví dụ: "Khác") không cho biết điều đó.
Nếu đúng, tiêu chí này chỉ áp dụng cho thiết bị di động. Nếu giá trị là false, mục này chỉ áp dụng cho các thiết bị không phải thiết bị di động, ngay cả khi tên của thiết bị (ví dụ: "Khác") không cho biết điều đó.
name
string
Tên quen thuộc của trình duyệt, ví dụ: Safari 5. Chuỗi này không bao gồm toàn bộ chuỗi tác nhân người dùng.
Khoá duy nhất cho Nhà cung cấp dịch vụ Internet này.
is_mobile
boolean
Nếu đúng, tiêu chí này chỉ bao gồm thiết bị di động. Nếu sai, mục này chỉ đề cập đến thiết bị không phải là thiết bị di động, ngay cả khi tên của thiết bị (ví dụ: "Khác") không cho biết điều đó.
name
string
Tên của Nhà cung cấp dịch vụ Internet này.
secondary_criteria_id
integer
Mã nhận dạng thay thế không bắt buộc có thể dùng để xác định thực thể.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2024-11-15 UTC."],[[["Entity Read Files, providing data on advertisers, campaigns, and other entities, will be sunset on October 31, 2024, requiring migration to the Display & Video 360 API."],["Shared data types like `Numeric Id`, `Enum`, `Time`, and custom types like `Budget` and `FrequencyCap` are used across various entities to represent specific attributes."],["Data is organized into tables like `Advertiser`, `Campaign`, `LineItem`, and `Creative`, each containing specific fields relevant to their respective entities."],["Tables are interconnected via joinable fields, enabling linking and analysis of data across entities, such as joining `Advertiser` and `Campaign` using `advertiser_id`."],["The `InventorySource` table provides details about ad inventory, including its source, accessibility for advertisers, and associated costs."]]],["Key data elements include numerical IDs for entities, with non-unique values across different types. Files omit null scalars and empty arrays. Time is recorded as Unix timestamps. Currency is measured in micros. Percentages are in millis. Entity files contain common data like IDs, names, and statuses. Budget settings specify timeframes, impression caps, spending, and pacing. Partner costs and revenue models define fees, markup percentages, and billing. Targeting information involves criteria, exclusions, and unions for inventory sources, geo-locations, devices, and more. Entity Read files are to be replaced by Display & Video 360 API.\n"]]