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

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

ScalarMô tả
integerMã 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

ScalarMô tả
integerBả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

ScalarMô tả
integerThờ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

ScalarMô tả
integerSố 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

ScalarMô tả
integerTỷ 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ườngLoạiMô tả
namestringTên tệp của tệp (không bao gồm tên nhóm hoặc tên thư mục).
num_recordsintegerSố lượng thực thể trong tệp.
versionintegerSố 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ườngLoạiMô tả
idNumeric IdMã 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.
namestringTên thực thể mà giao diện người dùng nhìn thấy.
activebooleanTrạ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_codestringMã tích hợp do người dùng đặt

Kiểu ExchangeSettings

Tên trườngLoạiMô tả
exchange_idNumeric IdMã của sàn giao dịch. Có thể tham gia bằng SupportedExchange.id
seat_idstringMã chỗ ngồi của sàn giao dịch
seat_user_namestringTê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ườngLoạiMô tả
auditorEnum0=DOUBLECLICK_BID_MANAGER
1=DOUBLECLICK_AD_EXCHANGE
2=APPNEXUS
3=APPNEXUS_MICROSOFT
4=RIGHT_MEDIA_NON_RTB
statusEnum0=APPROVED
1=REJECTED
2=PENDING
3=NO_AUDIT
4=UN_AUDITABLE
5=UNKNOWN
6=IN_AUDIT
feedbackstringÝ 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_timeTimeLần gần đây nhất thực thể được đồng bộ hoá với auditor
external_idNumeric IdChỉ được điền nếu auditorAPPNEXUS, 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ườngLoạiMô tả
start_time_usecTimeThời gian bắt đầu của kỳ ngân sách.
end_time_usecTimeThời gian kết thúc của kỳ ngân sách.
max_impressionsintegerSố 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_microsintegerMứ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_typeEnum0=FLIGHT
1=DAILY
pacing_max_impressionsintegerSố 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_microsintegerMứ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_distributionEnum0=ASAP
1=EVEN
2=AHEAD

Kiểu FrequencyCap

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

Kiểu PartnerCosts

Tên trườngLoạiMô tả
cpm_fee_1_advertiser_microsintegerPhí 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_microsintegerPhí 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_microsintegerPhí 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_microsintegerPhí 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_microsintegerPhí 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_millisintegerPhí truyền thông 1 bằng Percentage Milli
media_fee_percent_2_millisintegerPhí truyền thông 2 bằng Percentage Milli
media_fee_percent_3_millisintegerPhí truyền thông 3 bằng Percentage Milli
media_fee_percent_4_millisintegerPhí truyền thông 4 bằng Percentage Milli
media_fee_percent_5_millisintegerPhí truyền thông 5 bằng Percentage Milli
cpm_fee_1_cost_typeEnum0=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_typeEnumTương tự như đối với cpm_fee_1_cost_type.
cpm_fee_3_cost_typeEnumTương tự như đối với cpm_fee_1_cost_type.
cpm_fee_4_cost_typeEnumTương tự như đối với cpm_fee_1_cost_type.
cpm_fee_5_cost_typeEnumTương tự như đối với cpm_fee_1_cost_type.
media_fee_percent_1_cost_typeEnumTương tự như đối với cpm_fee_1_cost_type.
media_fee_percent_2_cost_typeEnumTương tự như đối với cpm_fee_1_cost_type.
media_fee_percent_3_cost_typeEnumTương tự như đối với cpm_fee_1_cost_type.
media_fee_percent_4_cost_typeEnumTương tự như đối với cpm_fee_1_cost_type.
media_fee_percent_5_cost_typeEnumTương tự như đối với cpm_fee_1_cost_type.
cpm_fee_1_bill_to_typeEnum0=DEFAULT_BILL_TO_TYPE
1=INVITE_MEDIA
2=PARTNER
cpm_fee_2_bill_to_typeEnumTương tự như đối với cpm_fee_1_bill_to_type.
cpm_fee_3_bill_to_typeEnumTương tự như đối với cpm_fee_1_bill_to_type.
cpm_fee_4_bill_to_typeEnumTương tự như đối với cpm_fee_1_bill_to_type.
cpm_fee_5_bill_to_typeEnumTương tự như đối với cpm_fee_1_bill_to_type.
media_fee_percent_1_bill_to_typeEnumTương tự như đối với cpm_fee_1_bill_to_type.
media_fee_percent_2_bill_to_typeEnumTương tự như đối với cpm_fee_1_bill_to_type.
media_fee_percent_3_bill_to_typeEnumTương tự như đối với cpm_fee_1_bill_to_type.
media_fee_percent_4_bill_to_typeEnumTương tự như đối với cpm_fee_1_bill_to_type.
media_fee_percent_5_bill_to_typeEnumTương tự như đối với cpm_fee_1_bill_to_type.

Kiểu PartnerRevenueModel

Tên trườngLoạiMô tả
typeEnum0=CPM
1=MEDIA_COST_MARKUP
2=TOTAL_MEDIA_COST_MARKUP
amount_advertiser_microsintegerSố 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_millisintegerMứ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_fractionfloatMộ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ườngLoạiMô tả
pixel_idNumeric IdMã 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_minutesintegerSố phút cần tìm lượt chuyển đổi sau khi xem.
click_window_minutesintegerSố phút để tìm lượt chuyển đổi sau khi nhấp chuột.
floodlight_activity_idMã 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ườngLoạiMô tả
criteria_idNumeric IdCó 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.
parameterstringTham 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.
excludedbooleanKhi 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ườngLoạiMô 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.
excludedbooleanKhi 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ườngLoạiMô 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.idTarget.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.idTarget.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.idTarget.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.idTarget.parameter không xác định.
languages TargetUnionLoại TargetUnion cho ngôn ngữ. Target.criteria_id có thể kết hợp với Language.idTarget.parameter không xác định.
day_parting TargetUnionLoạ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.idTarget.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_sitesbooleanGắ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.idTarget.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.
ispsTargetUnionLoại TargetUnion cho Nhà cung cấp dịch vụ Internet. Target.criteria_id có thể kết hợp với ISP.idTarget.parameter không xác định.

Kiểu SummaryFile

Tên trườngLoạiMô 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ườngLoạiMô tả
pricingUserListPricing
advertiser_idNumeric Id

Kiểu UserListPricing

Tên trườngLoạiMô tả
cost_typestring
currency_codestringMã đơn vị tiền tệ gồm ba chữ cái theo ISO 4217, ví dụ: USD cho Đô la Mỹ.
cost_microsCurrency Micro

Bảng riêng tư

Bảng Partner

Tên trườngLoạiMô tả
common_dataEntityCommonDataChứa dữ liệu chung về đối tác này như tên và mã nhận dạng.
currency_codestringMã đơ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_costsPartnerCostsChứa thông tin về chi phí phát sinh lỗi cho đối tác này.
default_partner_revenue_modelPartnerRevenueModelChứa thông tin về mô hình doanh thu mặc định của đối tác này.
default_target_listTargetListChứ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ườngLoạiMô tả
common_dataEntityCommonDataChứa dữ liệu chung về nhà quảng cáo này như tên và mã nhận dạng.
partner_idNumeric IdMã của đối tượng đối tác mẹ. Có thể tham gia bằng Partner.common_data.id.
currency_codestringMã đơn vị tiền tệ gồm ba chữ cái theo ISO 4217, ví dụ: USD cho Đô la Mỹ.
timezone_codestringMã 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_urlstringURL 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_configurationEnum0=NONE
1=NORMAL
2=HYBRID
dcm_network_idNumeric IdMã 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_idNumeric IdMã 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_idNumeric IdGiá 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_tagsbooleanThẻ OBA sẽ được bật khi bạn đặt giá trị này là true.

Bảng Campaign

Tên trườngLoạiMô tả
common_dataEntityCommonDataChứa dữ liệu chung về chiến dịch này như tên và mã nhận dạng.
advertiser_idNumeric IdMã 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
budgetBudgetNgâ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_capFrequencyCapGiớ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_listTargetListChứ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_creativesbooleanKhi 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_creativesbooleanKhi 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_creativesbooleanKhi bạn đặt chính sách này thành true, hệ thống sẽ đề xuất thứ tự chèn âm thanh.
objectiveEnum Giá trị là:
1 = BRAND_AWARENESS
2 = ONLINE_ACTION
3 = OFFLINE_ACTION
4 = APP_INSTALL
metricEnum 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_descriptionStringKhi chỉ số là OTHER, đây sẽ là nội dung mô tả ngắn gọn về chỉ số.
metric_amount_microsintegerLượng mục tiêu cho chỉ số tính bằng phần triệu.

Bảng InsertionOrder

Tên trườngLoạiMô tả
common_dataEntityCommonData
advertiser_idNumeric IdMã 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_idNumeric IdMã của đối tượng chiến dịch gốc.
overall_budgetBudgetTổ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_capFrequencyCapGiớ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_costsPartnerCosts
default_target_listTargetList

Bảng LineItem

Tên trườngLoạiMô tả
common_data EntityCommonData
line_item_typeEnum 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_microsintegerGiá 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_goalEnum0=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_microsintegerMụ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_modelPartnerRevenueModelMô 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.
BudgetBudgetNgâ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_capFrequencyCapGiớ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_costsPartnerCosts
target_listTargetListChứ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ườngLoạiMô tả
common_dataEntityCommonData
advertiser_idNumeric IdMã 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_idNumeric IdMã vị trí CM360 được liên kết với mẫu quảng cáo này.
width_pixelsintegerChiều rộng của mẫu quảng cáo tính bằng pixel.
height_pixelsintegerChiề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_directionEnum0=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_typeEnum 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ườngLoạiMô tả
common_dataEntityCommonData
advertiser_idNumeric IdMã 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_idNumeric IdMã của đối tượng đối tác mẹ. Có thể tham gia bằng Partner.common_data.id.
dcm_floodlight_idNumeric IdID Floodlight TXT được liên kết với pixel này.
allow_google_redirectboolean
allow_rm_redirectbooleanKhi bạn đặt thành true, pixel sẽ được bật để hồi âm đến/từ Bên phải.
remarketing_enabledbooleanKhi 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_securebooleanKhi 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ườngLoạiMô tả
common_dataEntityCommonData
advertiser_idNumeric IdMã 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_idNumeric IdMã 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_enabledbooleanKhi 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_requiredbooleanKhi bạn đặt thành true, các thẻ phải tuân thủ.

Bảng InventorySource

Tên trườngLoạiMô tả
idNumeric IdKhoá duy nhất cho nguồn khoảng không quảng cáo.
unclassifiedbooleanKhi 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_namestringTê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_nameunclassified 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_idNumeric IdMã 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_idstringMã 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_microsintegerGiá 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_codestringMã tiền tệ gồm 3 chữ cái theo ISO 4217 dùng cho min_cpm_micros.

Bảng UserList

Tên trườngLoạiMô tả
idNumeric IdKhoá duy nhất cho danh sách người dùng.
namestringTên của danh sách người dùng như hiển thị trong giao diện người dùng.
data_partner_idNumeric IdCó 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_pricingUserListPricingLoạ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ườngLoạiMô 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ườngLoạiMô tả
idNumeric IdKhoá duy nhất cho kênh.
namestringTê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_deletedbooleanKhi 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_channelbooleanKhi 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ườngLoạiMô 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ườngLoạiMô tả
idNumeric IdKhoá duy nhất để trao đổi.
namestringTên của sàn giao dịch, ví dụ: Ad Exchange.

Bảng DataPartner

Tên trườngLoạiMô tả
idNumeric IdKhoá duy nhất cho nhà cung cấp dữ liệu của bên thứ ba.
namestringTê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ườngLoạiMô tả
idNumeric IdKhoá duy nhất cho trang web toàn cầu.
namestringTên hoặc URL trang web, ví dụ: google.com hoặc Google Unclassified.

Bảng SiteIdToPlacementId

Tên trườngLoạiMô 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ườngLoạiMô tả
idNumeric IdKhoá duy nhất cho vị trí địa lý.
canonical_namestringChuỗ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_namestringTên vị trí. Ví dụ: "Seattle".
country_codestringMã quốc gia theo ISO-3166 alpha-2 cho vị trí địa lý này, ví dụ: US.
region_codestringMã 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_namestringTê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_codestringMã 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_codeintegerMã 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ườngLoạiMô tả
idNumeric IdKhoá duy nhất cho ngôn ngữ này.
codestringMã 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ườngLoạiMô tả
idNumeric IdKhoá duy nhất cho Tiêu chí thiết bị này.
is_mobilebooleanNế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.
namestringTên quen thuộc của Tiêu chí thiết bị.
criteria_typeEnum0=OPERATING_SYSTEM
1=MOBILE_MAKE_MODEL
2=DEVICE_TYPE
operating_system_idNumeric IdXác định hệ điều hành. Trường này chỉ được điền sẵn khi criteria_type0.
mobile_brand_namestringTên thương hiệu của thiết bị. Trường này chỉ được điền sẵn khi criteria_type1.
mobile_model_namestringTên mẫu của thiết bị. Trường này chỉ được điền sẵn khi criteria_type1. Không bắt buộc.
mobile_make_model_idNumeric IdXác định số kiểu máy của thiết bị. Trường này chỉ được điền sẵn khi criteria_type1. Không bắt buộc.
device_typeEnumCho biết loại thiết bị. Trường này chỉ được điền sẵn khi criteria_type2.

0=COMPUTER
1=OTHER
2=SMARTPHONE
3=TABLET
4=SMARTTV
5=CONNECTEDTV
6=SET_TOP_BOX
7=CONNECTEDDEVICE

Bảng Browser

Tên trườngLoạiMô tả
idNumeric IdKhoá duy nhất dành cho trình duyệt này.
is_mobilebooleanNế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.
namestringTê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ườngLoạiMô tả
idNumeric IdKhoá duy nhất dành cho Nhà cung cấp dịch vụ Internet này.
is_mobilebooleanNế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.
namestringTên của Nhà cung cấp dịch vụ Internet này.
secondary_criteria_idinteger 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ườngLoạiMô tả
idNumeric IdKhoá duy nhất cho bộ sưu tập ứng dụng này.
namestringTên của bộ sưu tập ứng dụng này.