รูปแบบไฟล์อ่านเอนทิตี - V2

ประเภทที่แชร์

ประเภทเหล่านี้จะกำหนดช่องที่ฝังในบางตาราง โดยช่องเหล่านี้จะไม่มีตารางของตนเอง

ประเภท Numeric Id

Scalarคำอธิบาย
integerหมายเลขประจำตัวที่เป็นตัวเลขซึ่งใช้เป็นตัวระบุสำหรับเอนทิตี รหัสเหล่านี้ไม่ควรถือเป็นรหัสสากลที่ไม่ซ้ำกัน เช่น อาจมีค่ารหัสเดียวกันกับที่ใช้สำหรับแคมเปญที่ใช้กับ Pixel ด้วย

ประเภท Enum

Scalarคำอธิบาย
integerการแจกแจงตัวเลือกที่เป็นไปได้หลายรายการ ตัวเลือกต่างๆ จะมีการอธิบายไว้อย่างละเอียดในประเภทหลัก

ประเภท Time

Scalarคำอธิบาย
integerเวลา Unix เป็นไมโครวินาที (1/1,000,000 วินาที) เช่น 1330403779608570 หมายถึงวันอังคารที่ 28 กุมภาพันธ์ 2012 เวลา 04:36:19.608570

ประเภท Currency Micro

Scalarคำอธิบาย
integerจํานวนเงินเฉพาะสกุลเงินเป็นไมโคร (1/1,000,000 ของหน่วยสกุลเงิน) เช่น หากสกุลเงินคือ EUR 75000000 จะหมายถึง €75 หรือหากสกุลเงินคือ USD 250000 จะหมายถึง $0.25 ไม่มีการแปลงเป็นหรือจากจำนวนเงินดอลลาร์

ประเภท Percentage Milli

Scalarคำอธิบาย
integerเปอร์เซ็นต์ที่แสดงเป็นมิลลิ (1/1,000 ของเปอร์เซ็นต์) เช่น 100 หมายถึง 0.1%

ประเภท FileSummary

ชื่อช่องประเภทคำอธิบาย
namestringชื่อไฟล์ (ไม่รวมชื่อที่เก็บข้อมูลหรือไดเรกทอรี)
num_recordsintegerจำนวนเอนทิตีในไฟล์
versionintegerหมายเลขเวอร์ชันหลักของไฟล์ ตัวเลขนี้อาจเปลี่ยนแปลงหากมีการสร้างรูปแบบข้อมูลเอนทิตีเวอร์ชันใหม่ในอนาคต

ประเภท EntityCommonData

ชื่อช่องประเภทคำอธิบาย
idNumeric Idรหัสที่ไม่ซ้ำกันภายในประเภทเอนทิตีแต่ละประเภท เช่น สำหรับเอนทิตีพาร์ทเนอร์ รหัสนี้จะถือเป็นรหัสพาร์ทเนอร์ ส่วนสำหรับผู้ลงโฆษณา รหัสนี้จะถือเป็นรหัสผู้ลงโฆษณา เป็นต้น
namestringชื่อเอนทิตีที่แสดงใน UI
activebooleanสถานะที่ผู้ใช้ตั้งค่าไว้ - รายการอาจไม่แสดงด้วยเหตุผลอื่นๆ เช่น งบประมาณหมด ไม่ได้อยู่ในเส้นทาง เป็นต้น
integration_codestringโค้ดการผสานรวมที่ผู้ใช้ตั้งค่าไว้

ประเภท ExchangeSettings

ชื่อช่องประเภทคำอธิบาย
exchange_idNumeric Idรหัสสําหรับการแลกเปลี่ยน เข้าร่วมได้กับ SupportedExchange.id
seat_idstringรหัสที่นั่งสำหรับการแลกเปลี่ยน
seat_user_namestringชื่อผู้ใช้ที่เกี่ยวข้องกับที่นั่งนี้ (ใช้ได้กับที่นั่งที่ไม่ใช่ RTB ของ Right Media เท่านั้น)

ประเภท ApprovalStatus

ชื่อช่องประเภทคำอธิบาย
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ความคิดเห็นจากผู้ตรวจสอบซึ่งอาจมีข้อมูลเพิ่มเติม เช่น เหตุผลในการปฏิเสธ
sync_timeTimeครั้งล่าสุดที่เอนทิตีซิงค์กับ auditor
external_idNumeric Idป้อนข้อมูลต่อเมื่อ auditor คือ APPNEXUS, APPNEXUS_MICROSOFT หรือ RIGHT_MEDIA_NON_RTB นี่คือรหัสของเอนทิตีในพื้นที่ทำงานของผู้ตรวจสอบ

ประเภท Budget

ชื่อช่องประเภทคำอธิบาย
start_time_usecTimeเวลาเริ่มต้นของระยะเวลางบประมาณ
end_time_usecTimeเวลาสิ้นสุดของระยะเวลางบประมาณ
max_impressionsintegerจำนวนการแสดงผลสูงสุดสำหรับงบประมาณนี้ หากไม่มีช่องนี้ แสดงว่าเป็นงบประมาณการแสดงผลแบบไม่จํากัด
max_spend_advertiser_microsintegerการใช้จ่ายสูงสุด (ในสกุลเงินของผู้ลงโฆษณา) สำหรับงบประมาณนี้ หากไม่มีช่องนี้ แสดงว่าเป็นงบประมาณแบบไม่จํากัดการใช้จ่าย
pacing_typeEnum0=FLIGHT
1=DAILY
pacing_max_impressionsintegerจำนวนการแสดงผลสูงสุดต่อช่วงการกำหนดอัตราการแสดงโฆษณาที่กำหนดโดย pacing_type หากไม่มีฟิลด์นี้ จะไม่มีการจำกัดการแสดงผล
pacing_max_spend_advertiser_microsintegerการใช้จ่ายสูงสุด (เป็นไมโครสกุลเงินของผู้ลงโฆษณา) ต่อช่วงเวลาการกำหนดอัตราการแสดงโฆษณาที่กำหนดโดย pacing_type หากไม่มีช่องนี้ แสดงว่าไม่มีการจำกัดการใช้จ่าย
pacing_distributionEnum0=ASAP
1=EVEN
2=AHEAD

ประเภท FrequencyCap

ชื่อช่องประเภทคำอธิบาย
max_impressionsintegerจํานวนการแสดงผลสูงสุดในแต่ละช่วงเวลาที่กําหนดขีดจํากัด
time_unitEnumหน่วยเวลา:
0=MINUTE
1=HOUR
2=DAY
3=WEEK
4=MONTH
5=LIFE_TIME
time_rangeintegerจํานวน time_units เช่น หาก time_unit คือ 1 ค่า 6 สําหรับ time_range คือ 6 ชั่วโมง

ประเภท PartnerCosts

ชื่อช่องประเภทคำอธิบาย
cpm_fee_1_advertiser_microsintegerค่าธรรมเนียม CPM 1 ในสกุลเงินไมโครของผู้ลงโฆษณา
cpm_fee_2_advertiser_microsintegerค่าธรรมเนียม CPM 2 ในไมโครสกุลเงินของผู้ลงโฆษณา
cpm_fee_3_advertiser_microsintegerค่าธรรมเนียม CPM 3 ในสกุลเงินไมโครของผู้ลงโฆษณา
cpm_fee_4_advertiser_microsintegerค่าธรรมเนียม CPM 4 ในไมโครสกุลเงินของผู้ลงโฆษณา
cpm_fee_5_advertiser_microsintegerค่าธรรมเนียม CPM 5 ในไมโครสกุลเงินของผู้ลงโฆษณา
media_fee_percent_1_millisintegerค่าธรรมเนียมสื่อ 1 ใน Percentage Milli
media_fee_percent_2_millisintegerค่าธรรมเนียมสื่อ 2 ใน Percentage Milli
media_fee_percent_3_millisintegerค่าธรรมเนียมสื่อ 3 ใน Percentage Milli
media_fee_percent_4_millisintegerค่าธรรมเนียมสื่อ 4 ใน Percentage Milli
media_fee_percent_5_millisintegerค่าธรรมเนียมสื่อ 5 ใน 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 แสดงถึงค่าธรรมเนียมจุดซื้อขายของเอเจนซี
cpm_fee_2_cost_typeEnumเหมือนกับ cpm_fee_1_cost_type
cpm_fee_3_cost_typeEnumเหมือนกับ cpm_fee_1_cost_type
cpm_fee_4_cost_typeEnumเหมือนกับ cpm_fee_1_cost_type
cpm_fee_5_cost_typeEnumเหมือนกับ cpm_fee_1_cost_type
media_fee_percent_1_cost_typeEnumเหมือนกับ cpm_fee_1_cost_type
media_fee_percent_2_cost_typeEnumเหมือนกับ cpm_fee_1_cost_type
media_fee_percent_3_cost_typeEnumเหมือนกับ cpm_fee_1_cost_type
media_fee_percent_4_cost_typeEnumเหมือนกับ cpm_fee_1_cost_type
media_fee_percent_5_cost_typeEnumเหมือนกับ 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_typeEnumเหมือนกับ cpm_fee_1_bill_to_type
cpm_fee_3_bill_to_typeEnumเหมือนกับ cpm_fee_1_bill_to_type
cpm_fee_4_bill_to_typeEnumเหมือนกับ cpm_fee_1_bill_to_type
cpm_fee_5_bill_to_typeEnumเหมือนกับ cpm_fee_1_bill_to_type
media_fee_percent_1_bill_to_typeEnumเหมือนกับ cpm_fee_1_bill_to_type
media_fee_percent_2_bill_to_typeEnumเหมือนกับ cpm_fee_1_bill_to_type
media_fee_percent_3_bill_to_typeEnumเหมือนกับ cpm_fee_1_bill_to_type
media_fee_percent_4_bill_to_typeEnumเหมือนกับ cpm_fee_1_bill_to_type
media_fee_percent_5_bill_to_typeEnumเหมือนกับ cpm_fee_1_bill_to_type

ประเภท PartnerRevenueModel

ชื่อช่องประเภทคำอธิบาย
typeEnum0=CPM
1=MEDIA_COST_MARKUP
2=TOTAL_MEDIA_COST_MARKUP
amount_advertiser_microsintegerจํานวนรายได้ในไมโครสกุลเงินปัจจุบันของผู้ลงโฆษณา ระบบจะตั้งค่านี้เฉพาะในกรณีที่ประเภทเป็น CPM
media_cost_markup_percent_millisintegerมาร์กอัปเปอร์เซ็นต์รายได้ใน Percentage Milli ค่านี้จะตั้งก็ต่อเมื่อเป็นประเภท MEDIA_COST_MARKUP หรือ TOTAL_MEDIA_COST_MARKUP
post_view_conversion_tracking_fractionfloatส่วนหนึ่งของ Conversion ที่เกิดหลังดูที่จะนับสําหรับเครื่องมือวัด Conversion หากเป็น 0 ระบบจะนับเฉพาะ Conversion หลังการคลิกเท่านั้น หากมีการติดตาม Conversion ทั้งหมดเป็น 1.0

ประเภท CostTrackingPixel

ชื่อช่องประเภทคำอธิบาย
pixel_idNumeric Idรหัสของพิกเซลการติดตาม โปรดทราบว่า CostTrackingPixel 2 รายการอาจใช้ pixel_id เหมือนกัน แต่มีค่าของการดูหรือค่าของกรอบเวลาการคลิกต่างกัน

ค่านี้สามารถรวมกับ Pixel.common_data.id
view_window_minutesintegerจํานวนนาทีที่จะมองหา Conversion หลังการดู
click_window_minutesintegerจํานวนนาทีที่จะมองหา Conversion หลังการคลิก
floodlight_activity_idรหัสตัวเลขรหัสกิจกรรม CM Floodlight ค่านี้สามารถรวมกับ Pixel.dcm_floodlight_id ได้

ประเภท Target

ชื่อช่องประเภทคำอธิบาย
criteria_idNumeric Idเชื่อมต่อกับตารางอื่นได้ โดยขึ้นอยู่กับประเภทที่กําหนดไว้ใน TargetList ค่านี้อาจหายไป
parameterstringพารามิเตอร์เพิ่มเติมซึ่งมีคำจำกัดความที่ขึ้นอยู่กับประเภทที่กำหนดไว้ใน TargetList ค่านี้อาจหายไป
excludedbooleanเมื่อ true จะหมายถึงเป้าหมายที่ยกเว้น ค่าที่ขาดหายไปหมายถึง false

ประเภท TargetUnion

ชื่อช่องประเภทคำอธิบาย
union[Target]อาร์เรย์ประเภท Target ที่แสดงการรวมเป้าหมาย
excludedbooleanเมื่อเป็น true หมายความว่าระบบจะยกเว้นการรวมเป้าหมาย ค่าที่ขาดหายไปหมายถึง false

ประเภท TargetList

ชื่อช่องประเภทคำอธิบาย
inventory_sources [Target]อาร์เรย์ของประเภท Target สำหรับแหล่งที่มาของพื้นที่โฆษณา Target.criteria_id เข้าร่วมได้ด้วย InventorySource.id และไม่ได้ระบุ Target.parameter
geo_locations [Target] อาร์เรย์ประเภท Target สำหรับสถานที่ตั้งทางภูมิศาสตร์ Target.criteria_id เข้าร่วมได้กับ GeoLocation.id และ Target.parameter ไม่มีการระบุ
ad_position Target Target ที่ระบุตำแหน่งของโฆษณาใน หน้าของผู้เผยแพร่โฆษณา ค่า Target.criteria_id นั้นได้แก่
0=ALL_POSITIONS
1=ABOVE_THE_FOLD
2=BELOW_THE_FOLD
3=UNKNOWN_POSITION
Target.parameter ไม่ได้ระบุ
net_speed Target Target ที่แสดงถึงความเร็วของเครือข่าย
ค่า Target.criteria_id มีดังนี้
0=ALL_CONNECTION_SPEEDS
1=BROADBAND (2.0mbps และเร็วกว่า)
2=DIALUP (56 kbps และต่ำกว่า)
3=UNKNOWN_CONNECTION_SPEED
4=EDGE (Enhanced Data for GSM Evolution (2G) 57 kbps และเร็วกว่า)
5=UMT (Universal Mobile Telecom System (3G) 384 kbps และเร็วขึ้น)
6=DSL (Digital Subscriber Line 768 kbps และเร็วขึ้น)
7=HSDPA (การเข้าถึงแพ็กเก็ตดาวน์ลิงก์ความเร็วสูง (3.5G) 1.8 Mbps ขึ้นไป)

Target.parameter ไม่ระบุ
browsers TargetUnion TargetUnion สำหรับเบราว์เซอร์ Target.criteria_id เข้าร่วมกับ Browser.id ได้ และ Target.parameter ไม่ได้ระบุ
device_criteria [Target]Array of Target ประเภทสำหรับเกณฑ์ของอุปกรณ์ Target.criteria_id สามารถเข้าร่วมด้วย DeviceCriteria.id ได้ และไม่ระบุ Target.parameter
languages TargetUnionTargetUnion ประเภทภาษา Target.criteria_id เข้าร่วมกับ Language.id ได้ และ Target.parameter ไม่ได้ระบุ
day_parting TargetUnionTargetUnion ประเภทสําหรับการแบ่งกลุ่มตามวัน Target.criteria_id มี 6 หลัก ได้แก่ (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:
จำนวนนาทีนับจากเที่ยงคืนหารด้วย 15 อยู่ในช่วง 0-95

EndTime:
นาทีนับตั้งแต่เที่ยงคืน หารด้วย 15 มีค่าตั้งแต่ 1 ถึง 96

เช่น ค่า 200380 หมายถึงวันจันทร์ 00:45-20:00 น. ตามเวลาแปซิฟิก

Target.parameter จะไม่ได้กำหนดไว้
audience_intersect [TargetUnion]อาร์เรย์ประเภท TargetUnion สําหรับกลุ่มเป้าหมายที่ทับซ้อนกัน เช่น
[{“union”: [A, B]},
 {“union”: [C, D]},
 {“union”: [E, F],
 “excluded”: true}]
 จะหมายถึง "(A หรือ B) และ (C หรือ D) และไม่ใช่ (E หรือ F)"

Target.criteria_id เข้าร่วมกับ UserList.id ได้ และ Target.parameter คือค่าความใหม่ของพิกเซลเป็นไมโครวินาที หากไม่มีค่านี้ หมายความว่ากําหนดเป้าหมายไปยังกลุ่มเป้าหมายทั้งหมด
keywords[Target]อาร์เรย์ประเภท Target สำหรับคีย์เวิร์ด ไม่ได้ระบุ Target.criteria_id และ Target.parameter เป็นคีย์เวิร์ดคำเดียว
kct_include_uncrawled_sitesbooleanแฟล็กเพื่อระบุว่าควรรวมเว็บไซต์ที่ไม่ได้จัดทำดัชนีไว้ใน KCT หรือไม่
page_categories[Target]อาร์เรย์ของประเภท Target สำหรับประเภทธุรกิจของหน้า AdExchange Target.criteria_id เป็นรหัสตัวเลขของประเภทธุรกิจและไม่มีการกำหนด Target.parameter
universal_channels[Target]อาร์เรย์ของประเภท Target สำหรับแชแนล Target.criteria_id เข้าร่วมกับ UniversalChannel.id ได้ และ Target.parameter ไม่ได้ระบุ
sites[Target] อาร์เรย์ของ Target ประเภทสำหรับเว็บไซต์ Target.criteria_id เข้าร่วมกับ UniversalSite.id ได้หรือไม่มีการตั้งค่าไว้หากเว็บไซต์ไม่ได้อยู่ใน UniversalSite Target.parameter คือเว็บไซต์ เช่น google.com แต่ไม่จำเป็นต้องอยู่ใน UniversalSite
ispsTargetUnionประเภท TargetUnion สำหรับผู้ให้บริการอินเทอร์เน็ต Target.criteria_id เข้าร่วมกับ ISP.id ได้ และ Target.parameter ไม่ได้ระบุ

ประเภท SummaryFile

ชื่อช่องประเภทคำอธิบาย
file[FileSummary]อาร์เรย์ที่มีรายการ FileSummary เท่ากับ 0 ขึ้นไป หากอาร์เรย์นี้ว่างเปล่า แสดงว่าไม่มีการสร้างข้อมูลในวันที่ดังกล่าว

ประเภท UserListAdvertiserPricing

ชื่อช่องประเภทคำอธิบาย
pricingUserListPricing
advertiser_idNumeric Id

ประเภท UserListPricing

ชื่อช่องประเภทคำอธิบาย
cost_typestring
currency_codestringรหัสสกุลเงิน 3 ตัวอักษรตามมาตรฐาน ISO 4217 เช่น USD สำหรับดอลลาร์สหรัฐ
cost_microsCurrency Micro

ตารางส่วนตัว

ตาราง Partner

ชื่อช่องประเภทคำอธิบาย
common_dataEntityCommonDataมีข้อมูลทั่วไปเกี่ยวกับพาร์ทเนอร์รายนี้ เช่น ชื่อและรหัส
currency_codestringรหัสสกุลเงิน 3 ตัวอักษรตามมาตรฐาน ISO 4217 เช่น USD สำหรับดอลลาร์สหรัฐ
exchange_settings[ExchangeSettings]อาร์เรย์ประเภท ExchangeSettings ที่มีข้อมูล เช่น รหัสที่นั่ง เฉพาะการแลกเปลี่ยนที่เปิดใช้เท่านั้นที่จะแสดง
default_partner_costsPartnerCostsมีข้อมูลเกี่ยวกับค่าใช้จ่ายเริ่มต้นสำหรับพาร์ทเนอร์รายนี้
default_partner_revenue_modelPartnerRevenueModelมีข้อมูลเกี่ยวกับรูปแบบรายได้เริ่มต้นสำหรับพาร์ทเนอร์รายนี้
default_target_listTargetListมีตัวเลือกการกำหนดเป้าหมายเริ่มต้นสำหรับพาร์ทเนอร์ ปัจจุบันระบบรองรับเฉพาะการกำหนดเป้าหมายตามภูมิศาสตร์เริ่มต้นเท่านั้น

ตาราง Advertiser

ชื่อช่องประเภทคำอธิบาย
common_dataEntityCommonDataมีข้อมูลทั่วไปเกี่ยวกับผู้ลงโฆษณารายนี้ เช่น ชื่อและรหัส
partner_idNumeric Idรหัสของออบเจ็กต์พาร์ทเนอร์หลัก เข้าร่วมได้กับ Partner.common_data.id
currency_codestringรหัสสกุลเงิน 3 ตัวอักษรตามมาตรฐาน ISO 4217 เช่น USD สำหรับดอลลาร์สหรัฐ
timezone_codestringรหัสเขตเวลาตามหลักเกณฑ์ เช่น "America/Los_Angeles" หากตั้งค่า dfa_configuration เป็น NORMAL หรือ HYBRID ค่านี้จะเหมือนกับเขตเวลาของผู้ลงโฆษณา DFA ที่เชื่อมโยง
landing_page_urlstringURL ของหน้า Landing Page เริ่มต้น
available_channel_ids[integer]อาร์เรย์จำนวนเต็มที่มีแชแนลที่ใช้ได้ซึ่งเชื่อมโยงกับผู้ลงโฆษณารายนี้ เข้าร่วมได้ด้วย UniversalChannel.id
blacklist_channel_id[integer]อาร์เรย์ของจำนวนเต็มที่มีแชแนลที่ขึ้นบัญชีดำสำหรับผู้ลงโฆษณารายนี้ เข้าร่วมได้กับ UniversalChannel.id
dcm_configurationEnum0=NONE
1=NORMAL
2=HYBRID
dcm_network_idNumeric Idรหัสของเครือข่าย CM360 ค่านี้จะหายไปหากตั้งค่า dcm_configuration เป็น NONE
dcm_advertiser_idNumeric Idรหัสของผู้ลงโฆษณา CM360 ค่านี้จะหายไปหากตั้งค่า dcm_configuration เป็น NONE
dcm_floodlight_group_idNumeric Idค่านี้จะหายไปหากตั้งค่า dcm_configuration เป็น NONE
dcm_syncable_site_ids[Numeric Id]อาร์เรย์ของประเภท Numeric Id สําหรับเว็บไซต์ที่ซิงค์ได้แต่ละแห่งสําหรับผู้ลงโฆษณารายนี้
enable_oba_tagsbooleanระบบจะเปิดใช้แท็ก OBA เมื่อตั้งค่านี้เป็น true

ตาราง Campaign

ชื่อช่องประเภทคำอธิบาย
common_dataEntityCommonDataมีข้อมูลทั่วไปเกี่ยวกับแคมเปญนี้ เช่น ชื่อและรหัส
advertiser_idNumeric Idรหัสของออบเจ็กต์ผู้ลงโฆษณาหลัก เข้าร่วมได้กับ Advertiser.common_data.id
budgetBudgetงบประมาณที่วางแผนไว้สําหรับแคมเปญนี้ รวมถึงเวลาเริ่มต้นและเวลาสิ้นสุด
frequency_capFrequencyCapความถี่สูงสุดที่ใช้งานอยู่สําหรับแคมเปญนี้ ค่านี้จะหายไปหากไม่มีการกําหนดความถี่สูงสุด
default_target_listTargetListมีข้อมูลเกี่ยวกับการกําหนดเป้าหมายที่มีผลกับแคมเปญนี้
uses_video_creativesbooleanเมื่อตั้งค่าเป็น "จริง" ระบบจะแนะนำคำสั่งซื้อการแทรกวิดีโอ
uses_display_creativesbooleanเมื่อตั้งค่าเป็น "จริง" ขอแนะนำให้แสดงใบสั่งซื้อการใส่โฆษณา
uses_audio_creativesbooleanเมื่อตั้งค่าเป็น "จริง" ระบบจะแนะนำใบสั่งซื้อการใส่โฆษณาเสียง
objectiveEnum ค่าคือ
1 = BRAND_AWARENESS
2 = ONLINE_ACTION
3 = OFFLINE_ACTION
4 = APP_INSTALL
metricEnum ตัวชี้วัดประสิทธิภาพ ใช้ช่องนี้เพื่อติดตามเมตริกหลักที่จะใช้ในการประเมินความสําเร็จของแคมเปญ ค่าที่เป็นไปได้ ได้แก่
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_descriptionStringเมื่อเมตริกคือ OTHER นี่เป็นคําอธิบายสั้นๆ ของเมตริก
metric_amount_microsintegerจํานวนเป้าหมายสําหรับเมตริกในหน่วยไมโคร

ตาราง InsertionOrder

ชื่อช่องประเภทคำอธิบาย
common_dataEntityCommonData
advertiser_idNumeric Idรหัสของออบเจ็กต์ผู้ลงโฆษณาหลัก เข้าร่วมได้กับ Advertiser.common_data.id
campaign_idNumeric Idรหัสของออบเจ็กต์แคมเปญหลัก
overall_budgetBudgetงบประมาณโดยรวมของใบสั่งซื้อการใส่โฆษณานี้ รวมถึงเวลาเริ่มต้นและเวลาสิ้นสุด
scheduled_segments[Budget]มีกลุ่มงบประมาณที่ตั้งเวลาไว้ อาร์เรย์นี้อาจว่างเปล่าหรือไม่มีเลย
frequency_capFrequencyCapความถี่สูงสุดที่ใช้งานอยู่สําหรับใบสั่งซื้อการใส่โฆษณานี้ ค่านี้จะหายไปหากไม่มีการกําหนดความถี่สูงสุด
default_partner_costsPartnerCosts
default_target_listTargetList

ตาราง LineItem

ชื่อช่องประเภทคำอธิบาย
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 รหัสของออบเจ็กต์ใบสั่งซื้อการใส่โฆษณาหลัก เข้าร่วมได้กับ InsertionOrder.common_data.id
creative_ids[Numeric Id]อาร์เรย์ของครีเอทีฟโฆษณาที่กำหนดให้กับรายการโฆษณานี้ เข้าร่วมได้กับ Creative.common_data.id
max_cpm_advertiser_microsintegerมูลค่า CPM สูงสุดในรูปแบบไมโครของสกุลเงินของผู้ลงโฆษณา
performance_goalEnum0=NONE (vCPM ปิดอยู่)
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_microsintegerเป้าหมาย vCPM ในไมโครสกุลเงินของผู้ลงโฆษณา ค่านี้จะหายไปหากตั้งค่า performance_goal เป็น NONE
partner_revenue_modelPartnerRevenueModelรูปแบบรายได้ของพาร์ทเนอร์ที่ใช้กับรายการโฆษณานี้
cost_tracking_pixels[CostTrackingPixel]อาร์เรย์ของ CostTrackingPixels ที่กำหนดให้ติดตามรายการโฆษณานี้
BudgetBudgetงบประมาณโดยรวมของรายการโฆษณานี้ รวมถึงเวลาเริ่มต้นและเวลาสิ้นสุด
frequency_capFrequencyCapความถี่สูงสุดที่ใช้งานอยู่สําหรับรายการโฆษณานี้ ค่านี้จะขาดหายไปหากไม่ได้ตั้งความถี่สูงสุดไว้
partner_costsPartnerCosts
target_listTargetListมีข้อมูลเกี่ยวกับการกําหนดเป้าหมายที่มีผลกับรายการโฆษณานี้

ตาราง Creative

ชื่อช่องประเภทคำอธิบาย
common_dataEntityCommonData
advertiser_idNumeric Idรหัสของออบเจ็กต์ผู้ลงโฆษณาหลัก เข้าร่วมได้กับ Advertiser.common_data.id
dcm_placement_idNumeric Idรหัสตําแหน่งโฆษณา CM360 ที่เชื่อมโยงกับครีเอทีฟโฆษณานี้
width_pixelsintegerความกว้างของครีเอทีฟโฆษณาเป็นพิกเซล
height_pixelsintegerความสูงของครีเอทีฟโฆษณาเป็นพิกเซล
approval_status[ApprovalStatus]อาร์เรย์ที่มีออบเจ็กต์ ApprovalStatus ซึ่งแสดงสถานะของครีเอทีฟโฆษณาใน Exchange ที่อนุมัติครีเอทีฟโฆษณา
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

ตาราง Pixel

ชื่อช่องประเภทคำอธิบาย
common_dataEntityCommonData
advertiser_idNumeric Idรหัสของออบเจ็กต์ผู้ลงโฆษณาหลัก เข้าร่วมได้กับ Advertiser.common_data.id
partner_idNumeric Idรหัสของออบเจ็กต์พาร์ทเนอร์หลัก เข้าร่วมได้กับ Partner.common_data.id
dcm_floodlight_idNumeric Idรหัส Floodlight ของ DFA ที่เชื่อมโยงกับพิกเซลนี้
allow_google_redirectboolean
allow_rm_redirectbooleanเมื่อตั้งค่าเป็น true ระบบจะเปิดใช้พิกเซลสำหรับการส่งซ้ำไปยัง/จาก Right Media
remarketing_enabledbooleanเมื่อตั้งค่าเป็น true ระบบจะเปิดใช้พิกเซลนี้เพื่อใช้ในการกําหนดเป้าหมาย ค่านี้จะแสดงก็ต่อเมื่อผู้ลงโฆษณาหลักตั้งค่า dfa_configuration เป็น NONE
is_securebooleanเมื่อตั้งค่าเป็น true พิกเซลนี้จะใช้ HTTPS ค่านี้จะแสดงก็ต่อเมื่อมีการตั้งค่า dfa_configuration ของผู้ลงโฆษณาหลักเป็น NONE

ตาราง Floodlight Activity

ชื่อช่องประเภทคำอธิบาย
common_dataEntityCommonData
advertiser_idNumeric Idรหัสของออบเจ็กต์ผู้ลงโฆษณาหลัก เข้าร่วมได้กับ Advertiser.common_data.id
partner_idNumeric Idรหัสออบเจ็กต์พาร์ทเนอร์จัดการของผู้ลงโฆษณาหลัก เข้าร่วมได้กับ Partner.common_data.id
remarketing_enabledbooleanเมื่อตั้งค่าเป็น true ระบบจะเปิดใช้กิจกรรมนี้เพื่อใช้ในการกําหนดเป้าหมาย
ssl_requiredbooleanเมื่อตั้งค่าเป็น true แท็กต้องเป็นไปตามข้อกําหนด

ตาราง InventorySource

ชื่อช่องประเภทคำอธิบาย
idNumeric Idคีย์ที่ไม่ซ้ำกันสำหรับแหล่งที่มาของพื้นที่โฆษณา
unclassifiedbooleanเมื่อตั้งค่าเป็น true ระบบจะรวมพื้นที่โฆษณาที่ไม่เป็นการจัดประเภททั้งหมด
inventory_namestringชื่อแหล่งที่มาของพื้นที่โฆษณาตามที่แสดงใน UI ช่องนี้อาจไม่มี หากไม่มี inventory_name และ unclassified เป็นจริง แสดงว่าหมายถึงพื้นที่โฆษณาที่ไม่มีการแบ่งประเภทของพาร์ทเนอร์การแลกเปลี่ยน หากไม่ระบุและ unclassified เป็นเท็จ แหล่งที่มาของพื้นที่โฆษณาจะเป็นพื้นที่โฆษณาระดับ Exchange
exchange_idNumeric Idรหัสของ Exchange ที่มีแหล่งที่มาของพื้นที่โฆษณานี้ เข้าร่วมได้กับ SupportedExchange.id
accessing_advertisers[Numeric Id]อาร์เรย์รหัสผู้ลงโฆษณาที่เข้าร่วมกับ Advertiser.common_data.id ได้และมีสิทธิ์ใช้แหล่งที่มาของพื้นที่โฆษณานี้

หมายเหตุ: หากแหล่งที่มาของพื้นที่โฆษณาพร้อมให้บริการแก่ผู้ลงโฆษณาทุกราย ช่องนี้จะหายไป

external_idstringรหัสภายนอกที่กำหนดให้กับแหล่งที่มาของพื้นที่โฆษณานี้และกำหนดโดยพาร์ทเนอร์การแลกเปลี่ยน ซึ่งมักเรียกว่ารหัสดีลหรือรหัสผู้ขาย ช่องนี้อาจไม่มี
min_cpm_microsintegerราคาพื้นที่มีผลของแหล่งที่มาของพื้นที่โฆษณานี้ในหน่วยไมโครของสกุลเงิน
min_cpm_currency_codestringรหัสสกุลเงิน ISO 4217 ที่เป็นตัวอักษร 3 ตัวที่ใช้สำหรับ min_cpm_micros

ตาราง UserList

ชื่อช่องประเภทคำอธิบาย
idNumeric Idคีย์ที่ไม่ซ้ำกันสำหรับรายชื่อผู้ใช้
namestringชื่อของรายชื่อผู้ใช้ตามที่แสดงใน UI
data_partner_idNumeric Idเข้าร่วมได้กับ DataPartner.id ช่องนี้ตั้งค่าไว้สำหรับรายชื่อผู้ใช้บุคคลที่สามเท่านั้น
accessing_advertisers[Numeric Id]อาร์เรย์รหัสผู้ลงโฆษณาที่เข้าร่วมกับ Advertiser.common_data.id ได้และมีสิทธิ์ใช้รายการผู้ใช้นี้

หมายเหตุ: หากรายการผู้ใช้พร้อมให้บริการแก่ผู้ลงโฆษณาทุกราย ช่องนี้จะไม่ปรากฏ

partner_pricingUserListPricingประเภทค่าใช้จ่ายจะเป็น CPM เสมอ ส่วนรหัสสกุลเงินจะเป็น USD เสมอ
advertiser_pricings[UserListAdvertiserPricing]ประเภทต้นทุนจะเป็น CPM เสมอ ส่วนรหัสสกุลเงินจะเป็น USD เสมอ

ตาราง CustomAffinity

ชื่อช่องประเภทคำอธิบาย
id Numeric Id คีย์ที่ไม่ซ้ำกันสำหรับกลุ่มความสนใจที่กำหนดเอง
name string ชื่อของกลุ่มเป้าหมายตามกลุ่มความสนใจที่กําหนดเองตามที่แสดงใน UI
description string คําอธิบายของกลุ่มความสนใจที่กําหนดเองตามที่แสดงใน UI
advertiser_id Numeric Id รหัสของออบเจ็กต์ผู้ลงโฆษณาหลัก เข้าร่วมได้กับ Advertiser.common_data.id

ตาราง UniversalChannel

ชื่อช่องประเภทคำอธิบาย
idNumeric Idคีย์ที่ไม่ซ้ำกันสำหรับช่อง
namestringชื่อของช่องตามที่แสดงใน UI
site_ids [Numeric Id] อาร์เรย์ที่มีรหัสของ UniversalSite ในช่องนี้ เข้าร่วมได้กับ UniversalSite.id
accessing_advertisers[Numeric Id]อาร์เรย์รหัสผู้ลงโฆษณาที่เข้าร่วมกับ Advertiser.common_data.id ได้และมีสิทธิ์ใช้แชแนลนี้

หมายเหตุ: หากแชแนลพร้อมให้บริการสำหรับผู้ลงโฆษณาทั้งหมด ฟิลด์นี้จะไม่แสดง

is_deletedbooleanเมื่อตั้งค่าเป็น true รายการโฆษณาใหม่จะกำหนดเป้าหมายช่องนี้ไม่ได้ แต่รายการโฆษณาที่มีอยู่ซึ่งกำหนดเป้าหมายช่องนี้แล้วจะยังคงกำหนดเป้าหมายต่อไป
is_brand_safe_channelbooleanเมื่อตั้งค่าเป็น true ช่องนี้จะใช้เพื่อกรองความปลอดภัยของแบรนด์ได้ ปัจจุบันมีราคา true สำหรับระดับความปลอดภัยของแบรนด์ 4 ระดับที่มีอยู่แล้วเท่านั้น

ตาราง NegativeKeywordList

ชื่อช่องประเภทคำอธิบาย
id Numeric Id คีย์ที่ไม่ซ้ำกันสำหรับรายการคีย์เวิร์ดเชิงลบ
name string ชื่อรายการคีย์เวิร์ดเชิงลบตามที่แสดงใน UI
advertiser_id Numeric Id รหัสของออบเจ็กต์ผู้ลงโฆษณาหลัก เข้าร่วมได้กับ Advertiser.common_data.id

ตารางสาธารณะ

ตาราง SupportedExchange

ชื่อช่องประเภทคำอธิบาย
idNumeric Idคีย์ที่ไม่ซ้ำกันสำหรับ Exchange
namestringชื่อของ Exchange เช่น Ad Exchange

ตาราง DataPartner

ชื่อช่องประเภทคำอธิบาย
idNumeric Idคีย์ที่ไม่ซ้ำกันสำหรับผู้ให้บริการข้อมูลบุคคลที่สาม
namestringชื่อผู้ให้บริการข้อมูลบุคคลที่สาม เช่น BlueKai

ตาราง UniversalSite

ชื่อช่องประเภทคำอธิบาย
idNumeric Idคีย์ที่ไม่ซ้ำกันสำหรับเว็บไซต์เวอร์ชันสากล
namestringURL หรือชื่อของเว็บไซต์ เช่น google.com หรือ Google Unclassified

ตาราง SiteIdToPlacementId

ชื่อช่องประเภทคำอธิบาย
siteId Numeric Id การแมปจากรหัสเว็บไซต์ Universal ไปยังรหัสตําแหน่งโฆษณาบนเว็บ
placementId Numeric Id URL หรือชื่อตำแหน่งโฆษณาบนเว็บ เช่น google.com หรือ Google Unclassified

ตาราง GeoLocation

ชื่อช่องประเภทคำอธิบาย
idNumeric Idคีย์ที่ไม่ซ้ำกันสำหรับตำแหน่งทางภูมิศาสตร์
canonical_namestringสตริงตำแหน่งที่คั่นด้วยเครื่องหมายจุลภาคและระดับบนสุด ตัวอย่างเช่น "ซีแอตเทิล รัฐวอชิงตัน สหรัฐอเมริกา"
geo_namestringชื่อสถานที่ตั้ง เช่น "Seattle"
country_codestringรหัสประเทศ ISO-3166 alpha-2 สำหรับสถานที่ตั้งทางภูมิศาสตร์นี้ เช่น US
region_codestringรหัสแยกย่อย ISO-3166-2 สำหรับตำแหน่งทางภูมิศาสตร์นี้ เช่น US-WA ช่องนี้อาจหายไป
city_namestringชื่อเมืองสําหรับสถานที่ตั้งทางภูมิศาสตร์นี้ เช่น Seattle ช่องนี้อาจหายไป
postal_codestringรหัสไปรษณีย์ของสถานที่ตั้งทางภูมิศาสตร์นี้ เช่น 98033 ช่องนี้อาจหายไป
dma_codeintegerรหัส DMA สำหรับสถานที่ตั้งทางภูมิศาสตร์นี้ เช่น 510 ช่องนี้อาจหายไป

ตาราง Language

ชื่อช่องประเภทคำอธิบาย
idNumeric Idคีย์ที่ไม่ซ้ำกันสำหรับภาษานี้
codestringรหัส ISO-639-1 สำหรับภาษานี้ หรือ zh_CN สำหรับจีน (ตัวย่อ) zh_TW สำหรับจีน (ตัวเต็ม) หรือ other สำหรับภาษาอื่นๆ

ตาราง DeviceCriteria

ชื่อช่องประเภทคำอธิบาย
idNumeric Idคีย์ที่ไม่ซ้ำกันสำหรับเกณฑ์อุปกรณ์นี้
is_mobilebooleanหากจริง เกณฑ์นี้จะครอบคลุมเฉพาะอุปกรณ์เคลื่อนที่เท่านั้น หากเป็นเท็จ รายการนี้จะครอบคลุมเฉพาะอุปกรณ์ที่ไม่ใช่อุปกรณ์เคลื่อนที่ แม้ว่าชื่อของอุปกรณ์ (เช่น "อื่นๆ") ไม่ได้ระบุเช่นนั้น
namestringชื่อที่คุ้นเคยของเกณฑ์อุปกรณ์
criteria_typeEnum0=OPERATING_SYSTEM
1=MOBILE_MAKE_MODEL
2=DEVICE_TYPE
operating_system_idNumeric Idระบุระบบปฏิบัติการ ช่องนี้จะป็อปปูเลตเมื่อ criteria_type คือ 0 เท่านั้น
mobile_brand_namestringชื่อแบรนด์ของอุปกรณ์ ช่องนี้จะแสดงข้อมูลก็ต่อเมื่อ criteria_type เป็น 1
mobile_model_namestringชื่อรุ่นของอุปกรณ์ ช่องนี้จะป็อปปูเลตเมื่อ criteria_type คือ 1 เท่านั้น ไม่บังคับ
mobile_make_model_idNumeric Idระบุหมายเลขรุ่นของอุปกรณ์ ช่องนี้จะแสดงข้อมูลก็ต่อเมื่อ criteria_type เป็น 1 ไม่บังคับ
device_typeEnumระบุประเภทอุปกรณ์ ช่องนี้จะแสดงข้อมูลก็ต่อเมื่อ criteria_type เป็น 2

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

ตาราง Browser

ชื่อช่องประเภทคำอธิบาย
idNumeric Idคีย์ที่ไม่ซ้ำกันสำหรับเบราว์เซอร์นี้
is_mobilebooleanหากเป็น "จริง" เกณฑ์นี้จะครอบคลุมเฉพาะอุปกรณ์เคลื่อนที่ หากเป็น "เท็จ" รายการนี้จะครอบคลุมเฉพาะอุปกรณ์ที่ไม่ใช่อุปกรณ์เคลื่อนที่ แม้ว่าชื่อของอุปกรณ์ดังกล่าว (เช่น "อื่นๆ") ไม่ได้ระบุเช่นนั้น
namestringชื่อที่คุ้นเคยของเบราว์เซอร์ เช่น Safari 5 โดยไม่รวมสตริง User Agent แบบเต็ม

ตาราง Isp

ชื่อช่องประเภทคำอธิบาย
idNumeric Idคีย์ที่ไม่ซ้ำกันสำหรับผู้ให้บริการอินเทอร์เน็ตรายนี้
is_mobilebooleanหากเป็น "จริง" เกณฑ์นี้จะครอบคลุมเฉพาะอุปกรณ์เคลื่อนที่ หากเป็นเท็จ รายการนี้จะครอบคลุมเฉพาะอุปกรณ์ที่ไม่ใช่อุปกรณ์เคลื่อนที่ แม้ว่าชื่อของอุปกรณ์ (เช่น "อื่นๆ") ไม่ได้ระบุเช่นนั้น
namestringชื่อผู้ให้บริการอินเทอร์เน็ตรายนี้
secondary_criteria_idinteger รหัสทางเลือกที่ไม่บังคับซึ่งสามารถใช้เพื่อระบุเอนทิตี

ตาราง AppCollection

ชื่อช่องประเภทคำอธิบาย
idNumeric Idคีย์ที่ไม่ซ้ำกันสำหรับคอลเล็กชันแอปนี้
namestringชื่อคอลเล็กชันแอปนี้