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

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

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

• 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; những 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ể. Không được coi ID là duy nhất trên toàn cầu, ví dụ: có thể có cùng một giá trị ID được sử dụng cho một Chiến dịch cũng được sử dụng cho 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 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

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ó 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 tính bằng mili giây (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. 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 pháp nhân (ví dụ: với các thực thể Đối tác, mã này sẽ là Mã đối tác, còn đố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 thực thể mà giao diện người dùng nhìn thấy.
active	boolean	Trạng thái do người dùng đặt – thực thể không được phân phát vì những lý do khác, chẳng hạn như 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	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 vị trí không phải RTB của Nội dung truyền thông phải).

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 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 kỳ ngân sách.
end_time_usec	Time	Thời gian kết thúc của kỳ 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 thiếu trường này, thì nghĩa là ngân sách cho số lượt 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ì 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 phần triệu đơ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à 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ố 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 tính theo 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 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 tính theo 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 theo 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 bằng Percentage Milli
media_fee_percent_2_millis	integer	Phí truyền thông 2 bằng Percentage Milli
media_fee_percent_3_millis	integer	Phí truyền thông 3 bằng Percentage Milli
media_fee_percent_4_millis	integer	Phí truyền thông 4 bằng 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 đạ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 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 là CPM.
media_cost_markup_percent_millis	integer	Mức tăng 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	Một phần của số lượt chuyển đổi sau khi xem được tính để 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 chuột mới được tính; nếu 1.0, tất cả cá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ó 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ã 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. 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 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à 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 nguồn khoảng không quảng cáo. Target.criteria_id có thể tham gia với InventorySource.id và Target.parameter là chưa xác định.
geo_locations	[Target]	Mảng Target loại cho vị trí địa lý. Target.criteria_id có thể tham gia với GeoLocation.id và Target.parameter là chưa xác định.
ad_position	Target	Target cho biết vị trí của quảng cáo trên trang nhà xuất bản. Các giá trị Target.criteria_id 0=ALL_POSITIONS 1=ABOVE_THE_FOLD 2=BELOW_THE_FOLD 3=UNKNOWN_POSITION Target.parameter là chưa 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,0mb/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 trong quá trình phát triển GSM (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 kb/giây 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 là chưa 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 xác định.
device_criteria	[Target]	Array of Target loại cho tiêu chí thiết bị. Target.criteria_id có thể kết hợp với DeviceCriteria.id và Target.parameter không 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 xác định.
day_parting	TargetUnion	Loại TargetUnion để phân chia theo thời gian trong ngày. Target.criteria_id có 6 chữ số: (TimeZone)(DayOfWeek)(StartTime)(EndTime) Múi giờ: 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 Thời gian bắt đầu: 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ị của 200380 có nghĩa là 00:45 đến 20:00 thứ Hai theo giờ Thái Bình Dương. Target.parameter chưa đượ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ể tham gia với UserList.id và Target.parameter là giá trị số ngày gần đây của pixel tính bằng micrô 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 là không xác định và Target.parameter là một từ khóa 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ó nên đưa vào KCT hay không.
page_categories	[Target]	Mảng Target loại cho các ngành dọc trang AdExchange. Target.criteria_id là mã nhận dạng dạng số của ngành dọc và Target.parameter là không 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 Target loại cho các trang web. Target.criteria_id có thể tham gia với UniversalSite.id hoặc không được đặt nếu trang web là không phải trong UniversalSite. Target.parameter là một trang web như google.com nhưng không nhất thiết được tìm thấy 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 không có hoặc có nhiều mục nhập FileSummary. 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	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 ba 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 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. Bạn chỉ có thể sử dụng những sàn giao dịch đã bật.
default_partner_costs	PartnerCosts	Chứa thông tin về chi phí phát sinh 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 của đố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ỉ nhắm mục tiêu theo địa lý mặc định được hỗ trợ ở đây.

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 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 ba chữ cái theo ISO 4217, ví dụ: USD cho Đô la Mỹ.
timezone_code	string	Mã múi giờ chuẩn, ví dụ: "America/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 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 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 Numeric Id loại cho mỗi trang web có thể đồng bộ hóa của 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 là 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 như tên và mã nhận 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
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 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 chính sách này thành true, thì đơn đặt hàng quảng cáo hiển thị sẽ được đề xuất.
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 sẽ là nội dung mô tả ngắn gọn về chỉ số.
metric_amount_micros	integer	Lượng mục tiêu cho chỉ số tính bằng phần triệu.

Bảng InsertionOrder

Tên trường	Loại	Mô tả
common_data	EntityCommonData
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.
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 đã 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

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 đơ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 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 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 đơ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	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 có hiệu lực đối với 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ã 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.
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 đạ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ã 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.
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	ID Floodlight TXT được liên kết với pixel này.
allow_google_redirect	boolean
allow_rm_redirect	boolean	Khi bạn đặt thành true, pixel sẽ được bật để hồi âm đến/từ Bên phải.
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 bạn đặ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ã 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.
partner_id	Numeric Id	Mã nhận dạng đối tượng đối tác quản lý của nhà quảng cáo mẹ. 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 để sử dụng trong quá trình nhắm mục tiêu.
ssl_required	boolean	Khi bạn đặ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 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ư hiển thị trong giao diện người dùng. Có thể không có trường này. Nếu không có inventory_name và unclassified là đúng, thì mục 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 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 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 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ã bên ngoài được cấp cho nguồn khoảng không quảng cáo này và được 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 thực tế của nguồn khoảng không quảng cáo này tính bằng đơn vị tiền tệ một phần triệu.
min_cpm_currency_code	string	Mã tiền tệ gồm 3 chữ cái theo ISO 4217 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 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 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 chung sở thích 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ư 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 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 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 chính sách này thành true, thì không có mục hàng mới nào có thể nhắm mục tiêu đến kênh này. Tuy nhiên, các mục hàng hiện có đã nhắm mục tiêu đến kênh này sẽ tiếp tục nhắm mục tiêu đến kênh này.
is_brand_safe_channel	boolean	Khi bạn đặt thành true, kênh này có thể được dùng để lọc sự an toàn cho 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ư 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 để 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 của bên thứ ba.
name	string	Tên của nhà cung cấp dữ liệu của 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	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	Tên hoặc URL 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 với dấu phẩy và thành phần mẹ. Ví dụ: "Seattle, Washington, United States".
geo_name	string	Tên vị trí. Ví dụ: "Seattle".
country_code	string	Mã quốc gia theo 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 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ỉ 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 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 sẵ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ố kiểu máy 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.
device_type	Enum	Cho biết loại thiết bị. Trường này chỉ được điền sẵ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 dành 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 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 thể hiện như vậy.
name	string	Tên quen thuộc của trình duyệt, ví dụ: Safari 5. Không bao gồm chuỗi tác nhân người dùng đầy đủ.

Bảng Isp

Tên trường	Loại	Mô tả
id	Numeric Id	Khoá duy nhất dành 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 thể hiện như 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ể.

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.