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

จะยกเว้นในอาร์เรย์ที่ว่างเปล่า

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

ประเภทเหล่านี้จะระบุฟิลด์ที่ซ้อนกันในบางตาราง ฟิลด์เหล่านี้จะไม่มีตารางของตัวเอง

ประเภท Numeric Id

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

ประเภท Enum

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

ประเภท Time

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

ประเภท Currency Micro

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

ประเภท Percentage Milli

สเกลาร์คำอธิบาย
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 เท่านั้น นี่คือรหัสของเอนทิตีในพื้นที่ของ Auditor

ประเภท 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_microsintegerCPM 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 (สายบริการผู้ติดตามแบบดิจิทัล 768 kbps ขึ้นไป)
7=HSDPA (การเข้าถึงแพ็กเก็ตดาวน์ลิงก์ความเร็วสูง (3.5G) 1.8 mpbbs ขึ้นไป)

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) AND (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
ispsTargetUnionTargetUnion ประเภทสำหรับผู้ให้บริการอินเทอร์เน็ต 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เมื่อตั้งค่าเป็น "จริง" ระบบจะแนะนำใบสั่งซื้อการใส่โฆษณาแบบ Display
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รหัส DFA Floodlight ที่เชื่อมโยงกับพิกเซลนี้
allow_google_redirectboolean
allow_rm_redirectbooleanเมื่อตั้งค่าเป็น true ระบบจะเปิดใช้พิกเซลสำหรับการแก้ไขไปยัง/จากสื่อด้านขวา
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_idNumeric Idรหัสของการแลกเปลี่ยนที่มีแหล่งที่มาของพื้นที่โฆษณานี้ เข้าร่วมได้ด้วย 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คีย์ที่ไม่ซ้ำกันสำหรับการแลกเปลี่ยน
namestringชื่อของการแลกเปลี่ยน เช่น 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สตริงสถานที่ตั้งที่คั่นด้วยคอมมาและสถานที่ตั้งระดับบนสุด เช่น "Seattle, Washington, United States"
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ชื่อของคอลเล็กชันแอปนี้