รูปแบบไฟล์อ่านเอนทิตี - 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รหัสสำหรับ Exchange สามารถเข้าร่วมได้ด้วย SupportedExchange.id
seat_idstringรหัสที่นั่งสำหรับ Exchange
seat_user_namestringชื่อผู้ใช้ที่เกี่ยวข้องกับที่นั่งนี้ (ใช้ได้สำหรับที่นั่งสื่อด้านขวาที่ไม่ใช่ RTB เท่านั้น)

ประเภท 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 (ข้อมูลที่ปรับปรุงแล้วสำหรับ GSM Evolution (2G) 57 kbps และเร็วกว่า)
5=UMT (ระบบ Universal Mobile Telecom (3G) 384 kbps และเร็วกว่า)
6=DSL (สายบริการดิจิทัล 768 kbps และเร็วกว่า)
7=HSDPA (การเข้าถึงแพ็กเก็ตดาวน์ลิงก์ความเร็วสูง (3.5G) 1.8mpbs และเร็วกว่า)

ระบุ 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

เวลาสิ้นสุด:
นาทีนับตั้งแต่เที่ยงคืน หารด้วย 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 OR B) และ (C OR D) AND NOT (E OR 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]อาร์เรย์ของ CostTrackingPixel ที่กำหนดให้ติดตามรายการโฆษณานี้
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รหัส DFA Floodlight ที่เชื่อมโยงกับพิกเซลนี้
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 เป็น "จริง" จะหมายถึงพื้นที่โฆษณาที่ไม่ระบุประเภทของ Exchange หากไม่ระบุและ unclassified เป็นเท็จ แหล่งที่มาของพื้นที่โฆษณาจะเป็นพื้นที่โฆษณาระดับ Exchange
exchange_idNumeric Idรหัสของ Exchange ที่มีแหล่งที่มาของพื้นที่โฆษณานี้ เข้าร่วมได้ด้วย SupportedExchange.id
accessing_advertisers[Numeric Id]อาร์เรย์ของรหัสผู้ลงโฆษณาที่เข้าร่วมได้ด้วย Advertiser.common_data.id ที่ได้รับสิทธิ์ให้ใช้แหล่งที่มาของพื้นที่โฆษณานี้

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

external_idstringรหัสภายนอกที่ให้กับแหล่งที่มาของพื้นที่โฆษณานี้และกำหนดโดย Exchange โดยทั่วไปเรียกว่าดีลหรือรหัสผู้ขาย ช่องนี้อาจไม่มี
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 การแมปรหัสเว็บไซต์สากลกับรหัสตําแหน่งเว็บ
placementId Numeric Id URL หรือชื่อตำแหน่งเว็บ เช่น google.com หรือ Google Unclassified

ตาราง GeoLocation

ชื่อช่องประเภทคำอธิบาย
idNumeric Idคีย์ที่ไม่ซ้ำกันสำหรับตำแหน่งทางภูมิศาสตร์
canonical_namestringสตริงตำแหน่งที่คั่นด้วยเครื่องหมายจุลภาคและระดับบนสุด ตัวอย่างเช่น "เชียงใหม่ ประเทศไทย"
geo_namestringชื่อสถานที่ ตัวอย่างเช่น "เชียงใหม่"
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ชื่อของคอลเล็กชันแอปนี้