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.

Trang này được dịch bởi Cloud Translation API.

Định dạng tệp đọc thực thể – V2

Các loại nội dung được chia sẻ
Bảng riêng tư
Bảng công khai

Loại được chia sẻ

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ã số được 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 lựa chọn có thể áp dụng. 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 theo đơn vị tiền tệ cụ thể 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, thì `75000000` sẽ có nghĩa là 75 EUR hoặc nếu đơn vị tiền tệ là USD, thì `250000` sẽ có nghĩa là 0,25 USD. Không có chuyển đổi thành hoặc từ số tiền bằng đô la.

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 nhóm hoặc tên 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. Số lượng này có thể thay đổi nếu các phiên bản mới của định dạng dữ liệu thực thể được tạo trong tương lai.

Kiểu `EntityCommonData`

Tên trường	Loại	Mô tả
`id`	`Numeric Id`	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.
`integration_code`	`string`	Mã tích hợp do người dùng đặt

Kiểu `ExchangeSettings`

Tên trường	Loại	Mô tả
`exchange_id`	`Numeric Id`	Mã của giao dịch. Có thể tham gia bằng SupportedExchange.id
`seat_id`	`string`	Mã chỗ ngồi của giao dịch hoán đổi
`seat_user_name`	`string`	Tên người dùng liên quan đến vị trí này (chỉ áp dụng cho các vị trí không phải RTB của Right Media).

Kiểu `ApprovalStatus`

Tên trường	Loại	Mô tả
`auditor`	`Enum`	`0=DOUBLECLICK_BID_MANAGER 1=DOUBLECLICK_AD_EXCHANGE 2=APPNEXUS 3=APPNEXUS_MICROSOFT 4=RIGHT_MEDIA_NON_RTB`
`status`	`Enum`	`0=APPROVED 1=REJECTED 2=PENDING 3=NO_AUDIT 4=UN_AUDITABLE 5=UNKNOWN 6=IN_AUDIT`
`feedback`	`string`	Ý kiến phản hồi của người kiểm tra có thể chứa thêm thông tin như lý do từ chối.
`sync_time`	`Time`	Lần gần đây nhất mà thực thể được đồng bộ hoá với `auditor`
`external_id`	`Numeric Id`	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 thực thể trong không gian của người kiểm tra.

Kiểu `Budget`

Tên trường	Loại	Mô tả
`start_time_usec`	`Time`	Thời gian bắt đầu của khoảng thời gian áp dụng ngân sách.
`end_time_usec`	`Time`	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 đơn vị tiền tệ cực nhỏ của nhà quảng cáo) cho ngân sách này. Nếu trường này bị thiếu, thì đó là ngân sách chi tiêu không giới hạn.
`pacing_type`	`Enum`	`0=FLIGHT 1=DAILY`
`pacing_max_impressions`	`integer`	Số lượt hiển thị tối đa trên mỗi khoảng tốc độ do `pacing_type` đặt. Nếu thiếu trường này, thì sẽ không có giới hạn về số lượt hiển thị.
`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ì không có giới hạn về mức chi tiêu.
`pacing_distribution`	`Enum`	`0=ASAP 1=EVEN 2=AHEAD`

Kiểu `FrequencyCap`

Tên trường	Loại	Mô tả
`max_impressions`	`integer`	Số lượt hiển thị tối đa trong mỗi khoảng thời gian giới hạn.
`time_unit`	`Enum`	Đơn vị thời gian: `0=MINUTE 1=HOUR 2=DAY 3=WEEK 4=MONTH 5=LIFE_TIME`
`time_range`	`integer`	Số lượng `time_units`, ví dụ: nếu `time_unit` là `1` thì giá trị 6 cho `time_range` là 6 giờ.

Kiểu `PartnerCosts`

Tên trường	Loại	Mô tả
`cpm_fee_1_advertiser_micros`	`integer`	Phí CPM 1 tính theo phần triệu đơn vị tiền tệ của nhà quảng cáo.
`cpm_fee_2_advertiser_micros`	`integer`	Phí CPM 2 bằng đơn vị tiền tệ vi mô của nhà quảng cáo.
`cpm_fee_3_advertiser_micros`	`integer`	Phí CPM 3 bằng đơn vị tiền tệ vi mô của nhà quảng cáo.
`cpm_fee_4_advertiser_micros`	`integer`	Phí CPM 4 bằng đơn vị tiền tệ vi mô của nhà quảng cáo.
`cpm_fee_5_advertiser_micros`	`integer`	Phí CPM 5 bằng đơn vị tiền tệ vi mô của nhà quảng cáo.
`media_fee_percent_1_millis`	`integer`	Phí truyền thông 1 trong `Percentage Milli`
`media_fee_percent_2_millis`	`integer`	Media Fee 2 trong `Percentage Milli`
`media_fee_percent_3_millis`	`integer`	Phí truyền thông 3 trong `Percentage Milli`
`media_fee_percent_4_millis`	`integer`	Phí truyền thông 4 trong `Percentage Milli`
`media_fee_percent_5_millis`	`integer`	Phí truyền thông 5 trong `Percentage Milli`
`cpm_fee_1_cost_type`	`Enum`	`0=DEFAULT_COST_TYPE 1=BID_MANAGER_FEE 2=THIRDPARTY_AD_SERVER 3=DOUBLE_VERIFY 4=ADSAFE 5=ADXPOSE 6=VIZU 7=AGGREGATE_KNOWLEDGE 8=TERACENT 9=EVIDON 10=ATD_FEE 11=DMP_FEE 12=INTEGRAL_AD_SCIENCE_PREBID 13=DOUBLE_VERIFY_PREBID 14=SHOP_LOCAL 15=TRUST_METRICS 16=MEDIACOST_DATA 17=INTEGRAL_AD_SCIENCE_VIDEO 18=MOAT_VIDEO 19=NIELSON_OCR 20=COMSCORE_VCE 21=ADLOOX 22=ADLOOX_PREBID 23=EXTRA_XBID_FEE 24=ADLINGO_FEE 25=CUSTOM_FEE_1 26=CUSTOM_FEE_2 27=CUSTOM_FEE_3 28=CUSTOM_FEE_4 29=CUSTOM_FEE_5` `ATD_FEE` thể hiện phí Bộ phận chuyên trách giao dịch của đại lý.
`cpm_fee_2_cost_type`	`Enum`	Tương tự như đối với `cpm_fee_1_cost_type`.
`cpm_fee_3_cost_type`	`Enum`	Tương tự như đối với `cpm_fee_1_cost_type`.
`cpm_fee_4_cost_type`	`Enum`	Tương tự như đối với `cpm_fee_1_cost_type`.
`cpm_fee_5_cost_type`	`Enum`	Tương tự như đối với `cpm_fee_1_cost_type`.
`media_fee_percent_1_cost_type`	`Enum`	Tương tự như đối với `cpm_fee_1_cost_type`.
`media_fee_percent_2_cost_type`	`Enum`	Tương tự như đối với `cpm_fee_1_cost_type`.
`media_fee_percent_3_cost_type`	`Enum`	Tương tự như đối với `cpm_fee_1_cost_type`.
`media_fee_percent_4_cost_type`	`Enum`	Tương tự như đối với `cpm_fee_1_cost_type`.
`media_fee_percent_5_cost_type`	`Enum`	Tương tự như đối với `cpm_fee_1_cost_type`.
`cpm_fee_1_bill_to_type`	`Enum`	`0=DEFAULT_BILL_TO_TYPE 1=INVITE_MEDIA 2=PARTNER`
`cpm_fee_2_bill_to_type`	`Enum`	Tương tự như đối với `cpm_fee_1_bill_to_type`.
`cpm_fee_3_bill_to_type`	`Enum`	Tương tự như đối với `cpm_fee_1_bill_to_type`.
`cpm_fee_4_bill_to_type`	`Enum`	Tương tự như đối với `cpm_fee_1_bill_to_type`.
`cpm_fee_5_bill_to_type`	`Enum`	Tương tự như đối với `cpm_fee_1_bill_to_type`.
`media_fee_percent_1_bill_to_type`	`Enum`	Tương tự như đối với `cpm_fee_1_bill_to_type`.
`media_fee_percent_2_bill_to_type`	`Enum`	Tương tự như đối với `cpm_fee_1_bill_to_type`.
`media_fee_percent_3_bill_to_type`	`Enum`	Tương tự như đối với `cpm_fee_1_bill_to_type`.
`media_fee_percent_4_bill_to_type`	`Enum`	Tương tự như đối với `cpm_fee_1_bill_to_type`.
`media_fee_percent_5_bill_to_type`	`Enum`	Tương tự như đối với `cpm_fee_1_bill_to_type`.

Kiểu `PartnerRevenueModel`

Tên trường	Loại	Mô tả
`type`	`Enum`	`0=CPM 1=MEDIA_COST_MARKUP 2=TOTAL_MEDIA_COST_MARKUP`
`amount_advertiser_micros`	`integer`	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 loại 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 kiểu 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.

Kiểu `CostTrackingPixel`

Tên trường	Loại	Mô tả
`pixel_id`	`Numeric Id`	Mã của pixel theo dõi – lưu ý rằng hai `CostTrackingPixel` có thể có cùng `pixel_id` nhưng có các giá trị cửa sổ lượt xem hoặc lượt nhấp khác nhau. Bạn có thể kết hợp giá trị này với `Pixel.common_data.id`.
`view_window_minutes`	`integer`	Số phút cần tìm lượt chuyển đổi sau khi xem.
`click_window_minutes`	`integer`	Số phút để tìm lượt chuyển đổi sau khi nhấp chuột.
`floodlight_activity_id`	Mã nhận dạng dạng số	Mã hoạt động Floodlight Campaign Manager. Bạn có thể kết hợp giá trị này với `Pixel.dcm_floodlight_id`.

Kiểu `Target`

Tên trường	Loại	Mô tả
`criteria_id`	`Numeric Id`	Có thể kết hợp với một bảng khác tuỳ thuộc vào loại được xác định trong `TargetList`. Có thể thiếu giá trị này.
`parameter`	`string`	Tham số bổ sung có định nghĩa phụ thuộc vào loại được xác định trong `TargetList`. Giá trị này có thể bị thiếu.
`excluded`	`boolean`	Khi `true`, điều này có nghĩa là mục tiêu bị loại trừ. Giá trị bị thiếu có nghĩa là `false`.

Kiểu `TargetUnion`

Tên trường	Loại	Mô tả
`union`	`[Target]`	Một mảng các loại `Target` đại diện cho tập hợp các mục tiêu.
`excluded`	`boolean`	Khi `true`, điều này có nghĩa là hợp nhất mục tiêu sẽ bị loại trừ. Giá trị bị thiếu có nghĩa là `false`.

Kiểu `TargetList`

Tên trường	Loại	Mô tả
`inventory_sources`	`[Target]`	Mảng các loại `Target` cho 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.
`geo_locations`	`[Target]`	Mảng các loại `Target` cho vị trí địa lý. `Target.criteria_id` có thể kết hợp với `GeoLocation.id` và `Target.parameter` không được xác định.
`ad_position`	`Target`	`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.
`net_speed`	`Target`	`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` (Dữ liệu nâng cao trong quá trình phát triển GSM (2G). 57 kbps trở lên). `5=UMT` (Universal Mobile Telecom System (3G). 384 Kb/giây trở lên). `6=DSL` (Đường dây thuê bao số. 768 kbps trở lên). `7=HSDPA` (Gói đường truyền truy cập tốc độ cao (3,5G). 1,8 mpb/giây trở lên). `Target.parameter` chưa được xác định.
`browsers`	`TargetUnion`	Loại `TargetUnion` cho trình duyệt. `Target.criteria_id` có thể kết hợp với `Browser.id` và `Target.parameter` không được xác định.
`device_criteria`	`[Target]`	Các loại `Array of Target` cho tiêu chí về thiết bị. `Target.criteria_id` có thể kết hợp với `DeviceCriteria.id` và `Target.parameter` không được xác định.
`languages`	`TargetUnion`	Loại `TargetUnion` cho ngôn ngữ. `Target.criteria_id` có thể kết hợp với `Language.id` và `Target.parameter` không được xác định.
`day_parting`	`TargetUnion`	Loại `TargetUnion` để phân tách ngày. `Target.criteria_id` có 6 chữ số: `(TimeZone)(DayOfWeek)(StartTime)(EndTime)` TimeZone: `0=USER 1=EASTERN 2=PACIFIC 3=LONDON 4=COPENHAGEN 5=SYDNEY 6=AUCKLAND 7=HONG_KONG 8=TOKYO 9=CALCUTTA 10=ADVERTISER` DayOfWeek: `0=MONDAY 1=TUESDAY 2=WEDNESDAY 3=THURSDAY 4=FRIDAY 5=SATURDAY 6=SUNDAY` StartTime: Số phút kể từ nửa đêm, chia cho 15. Phạm vi từ 0 đến 95. EndTime: Số phút kể từ nửa đêm, chia cho 15. Phạm vi từ 1 đến 96. Ví dụ: giá trị `200380` có nghĩa là thứ Hai từ 00:45 đến 20:00 theo giờ Thái Bình Dương. `Target.parameter` không được xác định.
`audience_intersect`	`[TargetUnion]`	Mảng `TargetUnion` cho giao điểm của các đối tượng, ví dụ: [{“union”: [A, B]}, {“union”: [C, D]}, {“union”: [E, F], “excluded”: true}] Có nghĩa là "(A OR B) AND (C OR D) AND NOT (E OR 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.
`keywords`	`[Target]`	Mảng `Target` loại cho từ khoá. `Target.criteria_id` chưa được xác định và `Target.parameter` là một từ khoá duy nhất.
`kct_include_uncrawled_sites`	`boolean`	Cờ cho biết liệu các trang web chưa được lập chỉ mục có được đưa vào KCT hay không.
`page_categories`	`[Target]`	Mảng các loại `Target` cho ngành dọc của trang AdExchange. `Target.criteria_id` là mã số của một dải quảng cáo dọc và `Target.parameter` chưa được xác định.
`universal_channels`	`[Target]`	Mảng `Target` loại cho các kênh. `Target.criteria_id` có thể kết hợp với `UniversalChannel.id` và `Target.parameter` không xác định.
`sites`	`[Target]`	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`.
`isps`	`TargetUnion`	Loại `TargetUnion` cho Nhà cung cấp dịch vụ Internet. `Target.criteria_id` có thể kết hợp với `ISP.id` và `Target.parameter` không xác định.

Kiểu `SummaryFile`

Tên trường	Loại	Mô tả
`file`	`[FileSummary]`	Một mảng gồm không có hoặc có nhiều mục `FileSummary`. Nếu mảng này trống thì tức là không có dữ liệu nào được tạo vào ngày đó.

Kiểu `UserListAdvertiserPricing`

Tên trường	Loại	Mô tả
`pricing`	`UserListPricing`
`advertiser_id`	`Numeric Id`

Kiểu `UserListPricing`

Tên trường	Loại	Mô tả
`cost_type`	`string`
`currency_code`	`string`	Mã đơn vị tiền tệ gồm 3 chữ cái theo ISO 4217, ví dụ: USD cho đô la Mỹ.
`cost_micros`	`Currency Micro`

Bảng riêng tư

Bảng `Partner`

Tên trường	Loại	Mô tả
`common_data`	`EntityCommonData`	Chứa dữ liệu chung về đối tác này, chẳng hạn như tên và mã nhận dạng.
`currency_code`	`string`	Mã đơn vị tiền tệ gồm 3 chữ cái theo ISO 4217, ví dụ: `USD` cho đô la Mỹ.
`exchange_settings`	`[ExchangeSettings]`	Mảng `ExchangeSettings` loại chứa thông tin, chẳng hạn như mã chỗ ngồi. Chỉ những sàn giao dịch đã bật mới xuất hiện.
`default_partner_costs`	`PartnerCosts`	Chứa thông tin về chi phí mặc định cho đối tác này.
`default_partner_revenue_model`	`PartnerRevenueModel`	Chứa thông tin về mô hình doanh thu mặc định cho đối tác này.
`default_target_list`	`TargetList`	Chứa các lựa chọn nhắm mục tiêu mặc định dành cho đối tác. Hiện tại, chúng tôi chỉ hỗ trợ tính năng nhắm mục tiêu theo vị trí địa lý mặc định.

Bảng `Advertiser`

Tên trường	Loại	Mô tả
`common_data`	`EntityCommonData`	Chứa dữ liệu chung về nhà quảng cáo này, chẳng hạn như tên và mã nhận dạng.
`partner_id`	`Numeric Id`	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 `dfa_configuration` được đặt 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 DFA đượ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 danh sách cấm của nhà quảng cáo này. Có thể tham gia bằng `UniversalChannel.id`.
`dcm_configuration`	`Enum`	`0=NONE 1=NORMAL 2=HYBRID`
`dcm_network_id`	`Numeric Id`	Mã nhận dạng của mạng CM360. Giá trị này sẽ bị thiếu nếu bạn đặt `dcm_configuration` thành `NONE`.
`dcm_advertiser_id`	`Numeric Id`	Mã nhận dạng của nhà quảng cáo CM360. Giá trị này sẽ bị thiếu nếu bạn đặt `dcm_configuration` thành `NONE`.
`dcm_floodlight_group_id`	`Numeric Id`	Giá trị này sẽ bị thiếu nếu bạn đặt `dcm_configuration` thành `NONE`.
`dcm_syncable_site_ids`	`[Numeric Id]`	Mảng các loại `Numeric Id` cho từng trang web có thể đồng bộ hoá cho nhà quảng cáo này.
`enable_oba_tags`	`boolean`	Thẻ OBA được bật khi bạn đặt giá trị này thành `true`.

Bảng `Campaign`

Tên trường	Loại	Mô tả
`common_data`	`EntityCommonData`	Chứa dữ liệu chung về chiến dịch này (chẳng hạn như tên và mã nhận dạng).
`advertiser_id`	`Numeric Id`	Mã của đối tượng nhà quảng cáo chính. Có thể tham gia bằng `Advertiser.common_data.id`
`budget`	`Budget`	Ngân sách dự kiến cho chiến dịch này. Bao gồm thời gian bắt đầu và thời gian kết thúc.
`frequency_cap`	`FrequencyCap`	Giới hạn tần suất đang hoạt động cho chiến dịch này. Giá trị này sẽ bị thiếu nếu bạn không đặt giới hạn tần suất.
`default_target_list`	`TargetList`	Chứa thông tin về tiêu chí nhắm mục tiêu đang có hiệu lực cho chiến dịch này.
`uses_video_creatives`	`boolean`	Khi bạn đặt thành true, hệ thống sẽ đề xuất thứ tự chèn video.
`uses_display_creatives`	`boolean`	Khi bạn đặt giá trị này thành true, hệ thống sẽ đề xuất các đơn đặt hàng chèn quảng cáo hiển thị.
`uses_audio_creatives`	`boolean`	Khi bạn đặt thành true, hệ thống sẽ đề xuất thứ tự chèn âm thanh.
`objective`	`Enum`	Giá trị là: `1 = BRAND_AWARENESS` `2 = ONLINE_ACTION` `3 = OFFLINE_ACTION` `4 = APP_INSTALL`
`metric`	`Enum`	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ể 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ố.
`metric_amount_micros`	`integer`	Số tiền mục tiêu cho chỉ số tính theo micro.

Bảng `InsertionOrder`

Tên trường	Loại	Mô tả
`common_data`	`EntityCommonData`
`advertiser_id`	`Numeric Id`	Mã của đối tượng nhà quảng cáo chính. Có thể tham gia bằng `Advertiser.common_data.id`.
`campaign_id`	`Numeric Id`	Mã của đối tượng chiến dịch mẹ.
`overall_budget`	`Budget`	Ngân sách tổng thể cho đơn đặt hàng quảng cáo này. Bao gồm thời gian bắt đầu và thời gian kết thúc.
`scheduled_segments`	`[Budget]`	Chứa mọi phân đoạn ngân sách đã lập lịch. Mảng này có thể trống hoặc hoàn toàn không có.
`frequency_cap`	`FrequencyCap`	Giới hạn tần suất đang hoạt động cho đơn đặt hàng quảng cáo này. Giá trị này sẽ bị thiếu nếu bạn không đặt giới hạn tần suất.
`default_partner_costs`	`PartnerCosts`
`default_target_list`	`TargetList`

Bảng `LineItem`

Tên trường	Loại	Mô tả
`common_data`	`EntityCommonData`
`line_item_type`	`Enum`	`0=RTB 1=RMX_NON_RTB 2=RTB_EXPANDABLE 3=RTB_MOBILE 4=RTB_VIDEO 5=TRUEVIEW 6=NON_RTB_EXCHANGES 7=RTB_AUDIO 8=GMAIL 9=ADWORDS_UAC 11=OUT_OF_HOME`
`insertion_order_id`	`Numeric Id`	Mã của đối tượng thứ tự chèn mẹ. Có thể tham gia bằng `InsertionOrder.common_data.id`.
`creative_ids`	`[Numeric Id]`	Một mảng mẫu quảng cáo được chỉ định cho mục hàng này. Có thể tham gia bằng `Creative.common_data.id`.
`max_cpm_advertiser_micros`	`integer`	Giá trị CPM tối đa tính bằng phần triệu đơn vị tiền tệ của nhà quảng cáo.
`performance_goal`	`Enum`	`0=NONE` (vCPM đang tắt) `1=CPC 2=CPA 3=ROI 4=CPCV 5=CPM 6=AVCPM 7=IMP_VALUE_ROAS 8=CIVA 9=IVO_TEN 10=AV_VIEWED 11=INCREMENTAL_CONVERSIONS`
`goal_advertiser_micros`	`integer`	Mục tiêu vCPM tính bằng phần triệu đơn vị tiền tệ của nhà quảng cáo. Giá trị này sẽ bị thiếu nếu bạn đặt `performance_goal` thành `NONE`.
`partner_revenue_model`	`PartnerRevenueModel`	Mô hình doanh thu đối tác đang được sử dụng cho mục hàng này.
`cost_tracking_pixels`	`[CostTrackingPixel]`	Mảng CostTrackingPixels được chỉ định để theo dõi mục hàng này.
`Budget`	`Budget`	Tổng ngân sách cho mục hàng này. Bao gồm thời gian bắt đầu và thời gian kết thúc.
`frequency_cap`	`FrequencyCap`	Giới hạn tần suất đang hoạt động cho mục hàng này. Giá trị này sẽ bị thiếu nếu bạn không đặt giới hạn tần suất.
`partner_costs`	`PartnerCosts`
`target_list`	`TargetList`	Chứa thông tin về tiêu chí nhắm mục tiêu đang có hiệu lực cho mục hàng này.

Bảng `Creative`

Tên trường	Loại	Mô tả
`common_data`	`EntityCommonData`
`advertiser_id`	`Numeric Id`	Mã của đối tượng nhà quảng cáo chính. Có thể tham gia bằng `Advertiser.common_data.id`.
`dcm_placement_id`	`Numeric Id`	Mã vị trí CM360 được liên kết với mẫu quảng cáo này.
`width_pixels`	`integer`	Chiều rộng của mẫu quảng cáo, tính bằng pixel.
`height_pixels`	`integer`	Chiều cao của mẫu quảng cáo tính bằng pixel.
`approval_status`	`[ApprovalStatus]`	Một mảng chứa các đối tượng `ApprovalStatus` thể hiện trạng thái của mẫu quảng cáo trong các nền tảng trao đổi phê duyệt mẫu quảng cáo.
`expanding_direction`	`Enum`	`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`
`creative_type`	`Enum`	`0=Image or HTML5 1=Expandable 2=Video 3=Mobile 4=Native Site 5=Facebook Exchange Page Post (News Feed) Ads 6=Templated App Install Mobile Ads (Banner) 10=Native Site Square 12=Templated App Install Mobile Ads (Interstitial/Video Interstitial) 13=Lightbox 14=Native App Install 15=Native App Install Square 16=Audio 17=Publisher Hosted 18=Native Video 22=Flipbook 23=Templated App Install Video 24=TRACKING`

Bảng `Pixel`

Tên trường	Loại	Mô tả
`common_data`	`EntityCommonData`
`advertiser_id`	`Numeric Id`	Mã của đối tượng nhà quảng cáo chính. Có thể tham gia bằng `Advertiser.common_data.id`.
`partner_id`	`Numeric Id`	Mã của đối tượng đối tác mẹ. Có thể tham gia bằng `Partner.common_data.id`.
`dcm_floodlight_id`	`Numeric Id`	Mã Floodlight DFA liên kết với pixel này.
`allow_google_redirect`	`boolean`
`allow_rm_redirect`	`boolean`	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 được đặt thành `true`, pixel này sẽ được bật để sử dụng trong tiêu chí 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`.

Bảng `Floodlight Activity`

Tên trường	Loại	Mô tả
`common_data`	`EntityCommonData`
`advertiser_id`	`Numeric Id`	Mã của đối tượng nhà quảng cáo chính. Có thể tham gia bằng `Advertiser.common_data.id`.
`partner_id`	`Numeric Id`	Mã của đối tượng đối tác quản lý của nhà quảng cáo chính. Có thể tham gia bằng `Partner.common_data.id`.
`remarketing_enabled`	`boolean`	Khi được đặt thành `true`, hoạt động này sẽ được bật để sử dụng trong tiêu chí nhắm mục tiêu.
`ssl_required`	`boolean`	Khi được đặt thành `true`, các thẻ phải tuân thủ.

Bảng `InventorySource`

Tên trường	Loại	Mô tả
`id`	`Numeric Id`	Khoá duy nhất cho nguồn khoảng không quảng cáo.
`unclassified`	`boolean`	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.
`exchange_id`	`Numeric Id`	Mã của nền tảng trao đổi có nguồn khoảng không quảng cáo này. Có thể tham gia bằng `SupportedExchange.id`.
`accessing_advertisers`	`[Numeric Id]`	Một mảng mã nhận dạng nhà quảng cáo, có thể kết hợp với `Advertiser.common_data.id`, được cấp quyền sử dụng nguồn khoảng không quảng cáo này. Lưu ý: Nếu TẤT CẢ nhà quảng cáo đều có thể sử dụng nguồn khoảng không 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`.

Bảng `UserList`

Tên trường	Loại	Mô tả
`id`	`Numeric Id`	Khoá duy nhất cho danh sách người dùng.
`name`	`string`	Tên của danh sách người dùng như hiển thị trong giao diện người dùng.
`data_partner_id`	`Numeric Id`	Có thể tham gia bằng `DataPartner.id`. Trường này chỉ được đặt cho danh sách người dùng bên thứ ba.
`accessing_advertisers`	`[Numeric Id]`	Một mảng mã nhận dạng nhà quảng cáo, có thể kết hợp với `Advertiser.common_data.id`, được cấp quyền sử dụng danh sách người dùng này. Lưu ý: Nếu tất cả nhà quảng cáo đều có thể sử dụng danh sách người dùng, thì trường này sẽ không xuất hiện.
`partner_pricing`	`UserListPricing`	Loại chi phí sẽ luôn là CPM, Mã đơn vị tiền tệ sẽ luôn là USD.
`advertiser_pricings`	`[UserListAdvertiserPricing]`	Loại chi phí sẽ luôn là CPM, Mã đơn vị tiền tệ sẽ luôn là USD.

Bảng `CustomAffinity`

Tên trường	Loại	Mô tả
`id`	`Numeric Id`	Khoá duy nhất cho đối tượng chung sở thích tuỳ chỉnh.
`name`	`string`	Tên của đối tượng tương đồng tuỳ chỉnh như hiển thị trong giao diện người dùng.
`description`	`string`	Nội dung mô tả về đối tượng chung sở thích tuỳ chỉnh như hiển thị trong giao diện người dùng.
`advertiser_id`	`Numeric Id`	Mã của đối tượng nhà quảng cáo chính. Có thể tham gia bằng `Advertiser.common_data.id`.

Bảng `UniversalChannel`

Tên trường	Loại	Mô tả
`id`	`Numeric Id`	Khoá duy nhất của kênh.
`name`	`string`	Tên của kênh như hiển thị trong giao diện người dùng.
`site_ids`	`[Numeric Id]`	Một mảng chứa mã nhận dạng của các `UniversalSite` trong kênh này. Có thể tham gia bằng `UniversalSite.id`.
`accessing_advertisers`	`[Numeric Id]`	Một mảng mã nhận dạng nhà quảng cáo, có thể kết hợp với `Advertiser.common_data.id`, được cấp quyền sử dụng kênh này. Lưu ý: Nếu một kênh được cung cấp 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.

Bảng `NegativeKeywordList`

Tên trường	Loại	Mô tả
`id`	`Numeric Id`	Khoá duy nhất cho danh sách từ khoá phủ định.
`name`	`string`	Tên của danh sách từ khoá phủ định như hiển thị trong giao diện người dùng.
`advertiser_id`	`Numeric Id`	Mã nhận dạng của đối tượng nhà quảng cáo mẹ. Có thể tham gia bằng `Advertiser.common_data.id`.

Bảng công khai

Bảng `SupportedExchange`

Tên trường	Loại	Mô tả
`id`	`Numeric Id`	Khoá duy nhất cho lượt trao đổi.
`name`	`string`	Tên của sàn giao dịch, ví dụ: `Ad Exchange`.

Bảng `DataPartner`

Tên trường	Loại	Mô tả
`id`	`Numeric Id`	Khoá duy nhất dành cho nhà cung cấp dữ liệu của bên thứ ba.
`name`	`string`	Tên của nhà cung cấp dữ liệu bên thứ ba, ví dụ: `BlueKai`.

Bảng `UniversalSite`

Tên trường	Loại	Mô tả
`id`	`Numeric Id`	Khoá duy nhất cho trang web toàn cầu.
`name`	`string`	URL hoặc tên trang web, ví dụ: `google.com` hoặc `Google Unclassified`.

Bảng `SiteIdToPlacementId`

Tên trường	Loại	Mô tả
`siteId`	`Numeric Id`	Liên kết từ Mã trang web chung đến Mã vị trí web.
`placementId`	`Numeric Id`	URL hoặc tên vị trí trên web, ví dụ: `google.com` hoặc `Google Unclassified`.

Bảng `GeoLocation`

Tên trường	Loại	Mô tả
`id`	`Numeric Id`	Khoá duy nhất cho vị trí địa lý.
`canonical_name`	`string`	Chuỗi vị trí được nối bằng dấu phẩy và thành phần mẹ. Ví dụ: "Seattle, Washington, Hoa Kỳ".
`geo_name`	`string`	Tên địa điểm. Ví dụ: "Seattle".
`country_code`	`string`	Mã quốc gia theo chuẩn ISO-3166 alpha-2 cho vị trí địa lý này, ví dụ: `US`.
`region_code`	`string`	Mã phân khu theo tiêu chuẩn ISO-3166-2 cho vị trí địa lý này, ví dụ: `US-WA`. Trường này có thể bị thiếu.
`city_name`	`string`	Tên thành phố của vị trí địa lý này, ví dụ: `Seattle`. Trường này có thể bị thiếu.
`postal_code`	`string`	Mã bưu điện của vị trí địa lý này, ví dụ: `98033`. Trường này có thể bị thiếu.
`dma_code`	`integer`	Mã DMA cho vị trí địa lý này, ví dụ: `510`. Trường này có thể bị thiếu.

Bảng `Language`

Tên trường	Loại	Mô tả
`id`	`Numeric Id`	Khoá duy nhất cho ngôn ngữ này.
`code`	`string`	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.

Bảng `DeviceCriteria`

Tên trường	Loại	Mô tả
`id`	`Numeric Id`	Khoá duy nhất cho Tiêu chí thiết bị này.
`is_mobile`	`boolean`	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 thể hiện như vậy.
`name`	`string`	Tên quen thuộc của Tiêu chí thiết bị.
`criteria_type`	`Enum`	`0=OPERATING_SYSTEM 1=MOBILE_MAKE_MODEL 2=DEVICE_TYPE`
`operating_system_id`	`Numeric Id`	Xác định hệ điều hành. Trường này chỉ được điền sẵn khi `criteria_type` là `0`.
`mobile_brand_name`	`string`	Tên thương hiệu của thiết bị. Trường này chỉ được điền khi `criteria_type` là `1`.
`mobile_model_name`	`string`	Tên mẫu của thiết bị. Trường này chỉ được điền sẵn khi `criteria_type` là `1`. Không bắt buộc.
`mobile_make_model_id`	`Numeric Id`	Xác định số hiệu của thiết bị. Trường này chỉ được điền khi `criteria_type` là `1`. Không bắt buộc.
`device_type`	`Enum`	Cho biết loại thiết bị. Trường này chỉ được điền khi `criteria_type` là `2`. `0=COMPUTER 1=OTHER 2=SMARTPHONE 3=TABLET 4=SMARTTV 5=CONNECTEDTV 6=SET_TOP_BOX 7=CONNECTEDDEVICE`

Bảng `Browser`

Tên trường	Loại	Mô tả
`id`	`Numeric Id`	Khoá duy nhất cho trình duyệt này.
`is_mobile`	`boolean`	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.

Bảng `Isp`

Tên trường	Loại	Mô tả
`id`	`Numeric Id`	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ỉ áp dụng cho 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ể.

Bảng `AppCollection`

Tên trường	Loại	Mô tả
`id`	`Numeric Id`	Khoá duy nhất cho bộ sưu tập ứng dụng này.
`name`	`string`	Tên của bộ sưu tập ứng dụng này.

Định dạng tệp đọc thực thể – V2

Loại được chia sẻ

Kiểu Numeric Id

Kiểu Enum

Kiểu Time

Kiểu Currency Micro

Kiểu Percentage Milli

Kiểu FileSummary

Kiểu EntityCommonData

Kiểu ExchangeSettings

Kiểu ApprovalStatus

Kiểu Budget

Kiểu FrequencyCap

Kiểu PartnerCosts

Kiểu PartnerRevenueModel

Kiểu CostTrackingPixel

Kiểu Target

Kiểu TargetUnion

Kiểu TargetList

Kiểu SummaryFile

Kiểu UserListAdvertiserPricing

Kiểu UserListPricing

Bảng riêng tư

Bảng Partner

Bảng Advertiser

Bảng Campaign

Bảng InsertionOrder

Bảng LineItem

Bảng Creative

Bảng Pixel

Bảng Floodlight Activity

Bảng InventorySource

Bảng UserList

Bảng CustomAffinity

Bảng UniversalChannel

Bảng NegativeKeywordList