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

Tệp đọc thực thể đã ngừng hoạt động. Di chuyển để sử dụng API Display & Video 360.

Các đại lượng vô hướng rỗng cũng như các mảng trống sẽ bị bỏ qua khỏi tệp.

• Loại dùng chung
• 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ã 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ể.

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ể kết hợp với 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 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 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 pháp nhân 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 kỳ 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 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 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.
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 bằng đơn vị tiền tệ vi mô 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 tính theo 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 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 bằng 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 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.

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 để 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.
floodlight_activity_id	Mã nhận dạng dạng số	Mã hoạt động Floodlight trên 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. 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 được xác định trong TargetList. Có thể thiếu giá trị này.
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 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.
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 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. 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 (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). 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 các loại 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 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.
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 các loại Target cho kênh. Target.criteria_id có thể kết hợp với UniversalChannel.id và Target.parameter không được 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 được 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 ba 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 tuỳ chọn nhắm mục tiêu mặc đị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.

Advertiser bảng

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 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.
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ã.
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 chính sách này thành true, hệ thống sẽ đề xuất đơn đặt hàng quảng cáo 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	Các 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ể 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ố.
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 khúc ngân sách theo 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 đơ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	Ngân sách tổng thể 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 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 đại diện cho 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

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

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

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 danh sách người dùng đượ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.
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 cho 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 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.

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ã của đối tượng nhà quảng cáo chính. 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 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.

Bảng UniversalSite

Tên trường	Loại	Mô tả
id	Numeric Id	Khoá duy nhất cho trang web chung.
name	string	Tên hoặc URL 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 được nối bằng dấu phẩy của vị trí và các vị trí mẹ. Ví dụ: "Seattle, Washington, United States".
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 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 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 chính 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 cho biết điều đó.
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 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 khi criteria_type 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 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ỉ 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ể.

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.