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

Vào ngày 31 tháng 10 năm 2024, Entity Read Files sẽ ngừng hoạt động và không được tạo nữa. Để biết thêm thông tin, hãy xem hướng dẫn di chuyển sang Display & Video 360 API của chúng tôi.

• Loại nội dung được chia sẻ
• Bàn riêng tư
• Bảng công khai

Loại hình được chia sẻ

Loại này xác định các trường lồng nhau trong một số bảng; những trường này không có bảng riêng.

Kiểu Numeric Id

Vô hướng	Nội dung mô tả
integer	Mã số nhận dạng bằng số được dùng làm thông tin nhận dạng cho các pháp nhân. Không được coi mã nhận dạng là duy nhất trên toàn cầu, ví dụ: có thể có cùng một giá trị mã nhận dạng được sử dụng cho một Chiến dịch mà cũng được sử dụng cho một điện thoại Pixel.

Kiểu Enum

Vô hướng	Nội dung mô tả
integer	Một bảng liệt kê nhiều tuỳ chọn có thể sử dụng. Các tuỳ chọn khác nhau được mô tả chi tiết hơn trong kiểu mẹ.

Kiểu Time

Vô hướng	Nội dung mô tả
integer	Thời gian unix tính bằng micrô giây (1/1.000.000 giây), ví dụ: 1330403779608570 biểu thị thứ Ba ngày 28 tháng 2 năm 2012 04:36:19.608570.

Kiểu Currency Micro

Vô hướng	Nội dung mô tả
integer	Số tiền cụ thể theo micrô (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ó sự chuyển đổi thành hoặc từ số tiền bằng đô la Mỹ.

Kiểu Percentage Milli

Vô hướng	Nội dung mô tả
integer	Tỷ lệ phần trăm hiển thị bằng mili giây (1/1.000 của phần trăm), ví dụ: 100 có nghĩa là 0,1%.

Kiểu FileSummary

Tên trường	Loại	Nội dung mô tả
name	string	Tên tệp của tệp (không bao gồm tên bộ chứa 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. Con số này có thể thay đổi nếu 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	Nội dung mô tả
id	Numeric Id	Mã nhận dạng duy nhất trong mỗi loại thực thể. Ví dụ: với các thực thể Đối tác, mã nhận dạng này sẽ là Mã đối tác, còn đối với Nhà quảng cáo, mã nhận dạng này sẽ là Mã nhận dạng nhà quảng cáo, v.v.
name	string	Tên của thực thể mà người dùng thấy được.
active	boolean	Trạng thái do người dùng đặt – thực thể có thể không phân phát vì những lý do khác, ví dụ: ngân sách đã cạn, hết thời gian hiển thị, 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	Nội dung mô tả
exchange_id	Numeric Id	Mã của sàn giao dịch. Có thể tham gia bằng SupportedExchange.id
seat_id	string	Mã chỗ ngồi của sàn giao dịch
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í Phải Media không phải RTB).

Kiểu ApprovalStatus

Tên trường	Loại	Nội dung 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 từ người kiểm tra có thể chứa thông tin bổ sung như lý do từ chối.
sync_time	Time	Lần gần đây nhất thực thể này được đồng bộ hoá với auditor
external_id	Numeric Id	Chỉ được điền sẵ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	Nội dung mô tả
start_time_usec	Time	Thời gian bắt đầu của khoảng thời gian ngân sách.
end_time_usec	Time	Thời gian kết thúc của khoảng thời gian ngân sách.
max_impressions	integer	Số lần hiển thị tối đa cho ngân sách này. Nếu trường này bị thiếu, đó là ngân sách hiển thị không giới hạn.
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.
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ì 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 theo micrô đơn vị tiền tệ của nhà quảng cáo) cho mỗi khoảng tốc độ do pacing_type đặt. Nếu thiếu trường này thì tức là 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	Nội dung mô tả
max_impressions	integer	Số lần 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	Nội dung mô tả
cpm_fee_1_advertiser_micros	integer	Phí CPM 1 tính bằng 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 tính bằng phần triệu đơn vị tiền tệ của nhà quảng cáo.
cpm_fee_3_advertiser_micros	integer	Phí CPM 3 tính bằng phần triệu đơn vị tiền tệ của nhà quảng cáo.
cpm_fee_4_advertiser_micros	integer	Phí CPM 4 tính bằng phần triệu đơn vị tiền tệ của nhà quảng cáo.
cpm_fee_5_advertiser_micros	integer	Phí CPM 5 tính bằng phần triệu đơn vị tiền tệ 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	Phí truyền thông 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 ở Percentage Milli
media_fee_percent_5_millis	integer	Phí truyền thông 5 ở 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 đại diện cho phí Bộ phận chuyên trách giao dịch đạ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	Nội dung 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 phần triệu hiện tại của nhà quảng cáo. Giá trị này chỉ được đặt nếu kiểu dữ liệu là CPM.
media_cost_markup_percent_millis	integer	Mức tăng theo tỷ lệ phần trăm doanh thu trong Percentage Milli. Giá trị này chỉ được đặt nếu loại dữ liệu là MEDIA_COST_MARKUP hoặc TOTAL_MEDIA_COST_MARKUP.
post_view_conversion_tracking_fraction	float	Phần số lượt chuyển đổi sau khi xem sẽ đượ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ỉ các lượt chuyển đổi sau khi nhấp được tính; nếu giá trị này là 1.0, thì tất cả các lượt chuyển đổi đều được theo dõi.

Kiểu CostTrackingPixel

Tên trường	Loại	Nội dung mô tả
pixel_id	Numeric Id	Mã của pixel theo dõi. Xin lưu ý rằng hai CostTrackingPixel có thể dùng chung một 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 tìm kiếm lượt chuyển đổi sau khi xem.
click_window_minutes	integer	Số phút tìm kiếm lượt chuyển đổi sau khi nhấp.
floodlight_activity_id	Mã số	Mã hoạt động Floodlight Campaign Manager. Bạn có thể kết hợp giá trị này bằng Pixel.dcm_floodlight_id.

Kiểu Target

Tên trường	Loại	Nội dung 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. Giá trị này có thể bị thiếu.
parameter	string	Tham số bổ sung có định nghĩa phụ thuộc vào loại đã 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 sẽ bị loại trừ. Giá trị bị thiếu nghĩa là false.

Kiểu TargetUnion

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

Kiểu TargetList

Tên trường	Loại	Nội dung mô tả
inventory_sources	[Target]	Mảng gồm 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 là không xác định.
geo_locations	[Target]	Mảng gồm 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 là không 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. Giá trị Target.criteria_id là 0=ALL_POSITIONS 1=ABOVE_THE_FOLD 2=BELOW_THE_FOLD 3=UNKNOWN_POSITION Target.parameter là không xác định.
net_speed	Target	Target cho biết tốc độ mạng. Giá trị Target.criteria_id là: 0=ALL_CONNECTION_SPEEDS 1=BROADBAND (2,0 mb/giây trở lên). 2=DIALUP (56 Kb/giây trở xuống). 3=UNKNOWN_CONNECTION_SPEED 4=EDGE (Dữ liệu nâng cao cho quá trình phát triển GSM (2G). 57 Kb/giây trở lên). 5=UMT (Hệ thống viễn thông di động toàn cầu (3G). 384 Kb/giây trở lên). 6=DSL (Đường dây thuê bao kỹ thuật số). 768 Kb/giây trở lên). 7=HSDPA (Gói đường truyền truy cập tốc độ cao (3,5G). 1,8mpb và nhanh hơn). Target.parameter là không 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 là không xác định.
device_criteria	[Target]	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 là không xác định.
languages	TargetUnion	Nhập TargetUnion cho ngôn ngữ. Target.criteria_id có thể kết hợp với Language.id và Target.parameter là không xác định.
day_parting	TargetUnion	Loại TargetUnion để phân chia trong 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: phút kể từ nửa đêm, chia cho 15. Phạm vi từ 0 đến 95. Thời gian kết thúc: phút kể từ nửa đêm, chia cho 15. Trong khoảng từ 1 đến 96. Ví dụ: giá trị 200380 có nghĩa là từ 00:45 đến 20:00 thứ Hai theo giờ Thái Bình Dương. Target.parameter là không xác định.
audience_intersect	[TargetUnion]	Mảng TargetUnion loại cho phần giao nhau 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ị số pixel gần đây tính theo micrô giây. Nếu thiếu giá trị này thì tức là bạn đang nhắm đến tất cả các đối tượng.
keywords	[Target]	Mảng gồm loại Target cho từ khoá. Target.criteria_id có giá trị không xác định và Target.parameter là một từ khoá duy nhất.
kct_include_uncrawled_sites	boolean	Gắn 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 Target loại cho ngành dọc trang AdExchange. Target.criteria_id là mã dạng số của một ngành dọc và Target.parameter là không xác định.
universal_channels	[Target]	Mảng gồm loại Target cho các kênh. Target.criteria_id có thể kết hợp với UniversalChannel.id và Target.parameter là không xác định.
sites	[Target]	Mảng gồm loại Target cho trang web. Target.criteria_id có thể kết hợp với UniversalSite.id hoặc không được thiết lập nếu trang web không có trong UniversalSite. Target.parameter là một trang web như google.com nhưng không nhất thiết sẽ được tìm thấy trong UniversalSite.
isps	TargetUnion	Loại TargetUnion dành 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 là không xác định.

Kiểu SummaryFile

Tên trường	Loại	Nội dung mô tả
file	[FileSummary]	Một mảng có từ 0 mục nhập FileSummary trở lên. Nếu mảng này trống thì không có dữ liệu nào được tạo vào ngày đó.

Kiểu UserListAdvertiserPricing

Tên trường	Loại	Nội dung mô tả
pricing	UserListPricing
advertiser_id	Numeric Id

Kiểu UserListPricing

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

Bàn riêng

Partner bảng

Tên trường	Loại	Nội dung mô tả
common_data	EntityCommonData	Chứa dữ liệu phổ biến 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 ba chữ cái theo ISO 4217, ví dụ: USD cho Đô la Mỹ.
exchange_settings	[ExchangeSettings]	Mảng gồm các loại ExchangeSettings chứa thông tin, chẳng hạn như mã chỗ ngồi. Chỉ những sàn giao dịch được bật mới được hiển thị.
default_partner_costs	PartnerCosts	Chứa thông tin về chi phí sửa lỗi 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 cho đối tác. Hiện tại, chỉ tiêu chí nhắm mục tiêu theo địa lý mặc định mới được hỗ trợ tại đây.

Advertiser bảng

Tên trường	Loại	Nội dung mô tả
common_data	EntityCommonData	Chứa dữ liệu phổ biến 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ác đố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 ba chữ cái theo ISO 4217, ví dụ: USD cho Đô la Mỹ.
timezone_code	string	Mã múi giờ chuẩn, ví dụ: "Châu Mỹ/Thu_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 AGP đượ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 cho 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ã 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 gồm 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 sẽ được bật khi bạn đặt giá trị này thành true.

Campaign bảng

Tên trường	Loại	Nội dung mô tả
common_data	EntityCommonData	Chứa dữ liệu phổ biến về chiến dịch này, chẳng hạn như tên và mã.
advertiser_id	Numeric Id	Mã của đối tượng nhà quảng cáo gốc. Có thể tham gia bằng Advertiser.common_data.id
budget	Budget	Ngân sách theo kế hoạch 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 áp dụng cho chiến dịch này.
uses_video_creatives	boolean	Khi bạn đặt chính sách này thành true, hệ thống sẽ đề xuất đơn đặt hàng quảng cáo dạng video.
uses_display_creatives	boolean	Khi bạn đặt chính sách này thành true, hệ thống sẽ đề xuất hiển thị đơn đặt hàng quảng cáo.
uses_audio_creatives	boolean	Khi bạn đặt chính sách này 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. Hãy sử dụng trường này để theo dõi chỉ số chính mà bạn sẽ sử dụng để đánh giá mức độ thành công của chiến dịch. Các giá trị có thể sử dụng 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 là nội dung mô tả ngắn của chỉ số.
metric_amount_micros	integer	Số tiền mục tiêu cho chỉ số tính bằng micrô.

InsertionOrder bảng

Tên trường	Loại	Nội dung mô tả
common_data	EntityCommonData
advertiser_id	Numeric Id	Mã của đối tượng nhà quảng cáo gốc. Có thể tham gia bằng Advertiser.common_data.id.
campaign_id	Numeric Id	Mã của đối tượng chiến dịch gốc.
overall_budget	Budget	Tổng ngân sách 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 được 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 áp dụ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

LineItem bảng

Tên trường	Loại	Nội dung 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 đơn đặt hàng quảng cáo gốc. Có thể tham gia bằng InsertionOrder.common_data.id.
creative_ids	[Numeric Id]	Một loạt các 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 đã bị 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 của đố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 áp dụ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 có hiệu lực cho mục hàng này.

Creative bảng

Tên trường	Loại	Nội dung mô tả
common_data	EntityCommonData
advertiser_id	Numeric Id	Mã của đối tượng nhà quảng cáo gốc. Có thể tham gia bằng Advertiser.common_data.id.
dcm_placement_id	Numeric Id	Mã vị trí trên 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 quảng cáo tính bằng pixel.
approval_status	[ApprovalStatus]	Một mảng chứa đối tượng ApprovalStatus biểu thị trạng thái của mẫu quảng cáo trong các sàn giao dịch 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

Pixel bảng

Tên trường	Loại	Nội dung mô tả
common_data	EntityCommonData
advertiser_id	Numeric Id	Mã của đối tượng nhà quảng cáo gốc. Có thể tham gia bằng Advertiser.common_data.id.
partner_id	Numeric Id	Mã của đối tác đối tác mẹ. Có thể tham gia bằng Partner.common_data.id.
dcm_floodlight_id	Numeric Id	ID Floodlight Floodlight được liên kết với pixel này.
allow_google_redirect	boolean
allow_rm_redirect	boolean	Khi được đặt thành true, pixel sẽ được bật để chuyển từ/đến Phương tiện bên phải.
remarketing_enabled	boolean	Khi bạn đặt thành true, pixel này sẽ được bật để 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 gốc đượ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 gốc được đặt thành NONE.

Floodlight Activity bảng

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

InventorySource bảng

Tên trường	Loại	Nội dung mô tả
id	Numeric Id	Khoá duy nhất cho nguồn khoảng không quảng cáo.
unclassified	boolean	Khi bạn đặt thành true, tất cả khoảng không quảng cáo chưa được phân loại sẽ được bao gồm.
inventory_name	string	Tên của nguồn khoảng không quảng cáo như được 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ì điều này đề cập đến khoảng không quảng cáo chưa được phân loại của sàn giao dịch. Nếu không có và unclassified sai, nguồn khoảng không quảng cáo sẽ là khoảng không quảng cáo cấp sàn giao dịch.
exchange_id	Numeric Id	Mã của sàn giao dịch nơi nguồn khoảng không quảng cáo này có sẵn. Có thể tham gia bằng SupportedExchange.id.
accessing_advertisers	[Numeric Id]	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 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ã bên ngoài được cấp cho nguồn khoảng không quảng cáo này và được xác định bởi sàn giao dịch, 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 thực tế của nguồn khoảng không quảng cáo này tính bằng phần triệu đơn vị tiền tệ.
min_cpm_currency_code	string	Mã tiền tệ gồm 3 chữ cái theo tiêu chuẩn ISO 4217 được dùng cho min_cpm_micros.

UserList bảng

Tên trường	Loại	Nội dung 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 các danh sách người dùng bên thứ ba.
accessing_advertisers	[Numeric Id]	Một dãy 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 danh sách người dùng này. Lưu ý: Nếu danh sách người dùng có sẵn cho TẤT CẢ nhà quảng cáo, 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.

CustomAffinity bảng

Tên trường	Loại	Nội dung mô tả
id	Numeric Id	Khoá duy nhất cho đối tượng chung sở thích tùy chỉnh.
name	string	Tên của đối tượng chung sở thích tùy 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ư trong giao diện người dùng.
advertiser_id	Numeric Id	Mã của đối tượng nhà quảng cáo gốc. Có thể tham gia bằng Advertiser.common_data.id.

UniversalChannel bảng

Tên trường	Loại	Nội dung mô tả
id	Numeric Id	Chìa khoá duy nhất cho kênh.
name	string	Tên của kênh như 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 chuỗi 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 kênh này. Lưu ý: Nếu một kênh dành 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 thành true, không mục hàng mới nào có thể nhắm mục tiêu kênh này, nhưng các mục hàng hiện có đã nhắm mục tiêu đến kênh này vẫn sẽ tiếp tục nhắm mục tiêu.
is_brand_safe_channel	boolean	Khi bạn đặt thành true, kênh này có thể dùng để lọc mức độ an toàn cho thương hiệu. Hiện tại, giá trị này chỉ là true cho 4 mức độ an toàn thương hiệu được tạo sẵn.

NegativeKeywordList bảng

Tên trường	Loại	Nội dung 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ư xuất hiện trong giao diện người dùng.
advertiser_id	Numeric Id	Mã của đối tượng nhà quảng cáo gốc. Có thể tham gia bằng Advertiser.common_data.id.

Bảng công cộng

SupportedExchange bảng

Tên trường	Loại	Nội dung mô tả
id	Numeric Id	Khoá duy nhất cho giao dịch.
name	string	Tên của sàn giao dịch, ví dụ: Ad Exchange.

DataPartner bảng

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

UniversalSite bảng

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

SiteIdToPlacementId bảng

Tên trường	Loại	Nội dung mô tả
siteId	Numeric Id	Liên kết từ Mã trang web toàn cầu đến Mã vị trí web.
placementId	Numeric Id	Tên hoặc URL của vị trí trên web, ví dụ: google.com hoặc Google Unclassified.

GeoLocation bảng

Tên trường	Loại	Nội dung 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à vị trí gốc. Ví dụ: "Seattle, Washington, United States".
geo_name	string	Tên vị trí. Ví dụ: "Seattle".
country_code	string	Mã quốc gia ISO-3166 alpha-2 cho vị trí địa lý này, ví dụ: US.
region_code	string	Mã phân mục theo 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 của thành phố cho vị trí địa lý này, ví dụ: Seattle. Trường này có thể bị thiếu.
postal_code	string	Mã bưu chính cho 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.

Language bảng

Tên trường	Loại	Nội dung 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 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.

DeviceCriteria bảng

Tên trường	Loại	Nội dung 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ỉ bao gồm thiết bị di động. Nếu sai, mục nhập này chỉ bao gồm thiết bị không phải thiết bị di động, ngay cả khi tên thiết bị (ví dụ: "Khác") không có nghĩa là 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 khi criteria_type có giá trị 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 có giá trị là 1.
mobile_model_name	string	Tên mẫu của thiết bị. Trường này chỉ được điền khi criteria_type có giá trị là 1. Không bắt buộc.
mobile_make_model_id	Numeric Id	Xác định số kiểu máy của thiết bị. Trường này chỉ được điền khi criteria_type có giá trị 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 có giá trị là 2. 0=COMPUTER 1=OTHER 2=SMARTPHONE 3=TABLET 4=SMARTTV 5=CONNECTEDTV 6=SET_TOP_BOX 7=CONNECTEDDEVICE

Browser bảng

Tên trường	Loại	Nội dung 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ỉ bao gồm thiết bị di động. Nếu sai, mục nhập này chỉ bao gồm thiết bị không phải thiết bị di động, ngay cả khi tên thiết bị (ví dụ: "Khác") không có nghĩa là vậy.
name	string	Tên quen thuộc của trình duyệt, ví dụ: Safari 5. Dữ liệu này không bao gồm chuỗi tác nhân người dùng đầy đủ.

Isp bảng

Tên trường	Loại	Nội dung 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ỉ bao gồm thiết bị di động. Nếu sai, mục nhập này chỉ bao gồm thiết bị không phải thiết bị di động, ngay cả khi tên thiết bị (ví dụ: "Khác") không có nghĩa là vậy.
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ể.

AppCollection bảng

Tên trường	Loại	Nội dung 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.