พารามิเตอร์ของ URL แท็กโฆษณา VAST

โปรแกรมเล่นใช้ URL แท็กโฆษณา VAST เพื่อดึงโฆษณาวิดีโอและโฆษณาเสียง คุณสามารถประกอบ URL แท็กโฆษณา VAST หรือแก้ไข URL ที่มีอยู่โดยใช้พารามิเตอร์ด้านล่าง จากนั้นทดสอบด้วยเครื่องมือตรวจสอบชุด VAST รวมทั้งยังตรวจสอบและทดสอบโดยใช้ตัวอย่างแท็กเหล่านี้ได้ด้วย

ข้อกำหนดทั่วไปสำหรับ URL

โปรโตคอล: แท็กโฆษณา VAST รองรับทั้งแบบ http และ https โดยที่ URL ติดตามการแสดงผลจะยึดตามการตั้งค่า SSL ปัจจุบันและส่งกลับเป็น http หรือ https การคลิกผ่านและการติดตามการคลิกจะใช้ http เนื่องจากมีการเปลี่ยนเส้นทางมาจากหน้าเว็บอื่น
โดเมน: เราไม่อนุญาตให้ใช้โดเมนแบบไดนามิกซึ่งสร้างผ่านมาโครการจับคู่รูปแบบหรือวิธีการแบบไดนามิกอื่นๆ และจะทำให้เกิดข้อผิดพลาด
การเข้าชมแบบสด: URL แท็กโฆษณาสำหรับวิดีโอสตรีมแบบสดต้องมี /live ในเส้นทางของ URL นั้นเพื่อให้จัดการการเข้าชมปริมาณมากได้เมื่อช่วงพักโฆษณาทั้งหมดแสดงพร้อมกัน

ตัวอย่างแท็กโฆษณา VAST

ตัวอย่าง URL แท็กโฆษณา VAST พร้อมด้วยพารามิเตอร์และค่าที่กำหนดให้จะมีลักษณะดังนี้

https://securepubads.g.doubleclick.net/gampad/ads?env=vp&gdfp_req=1&output=vast&iu=/1234/video-demo&sz=400x300&unviewed_position_start=1&ciu_szs=728x90,300x250

ข้ามไปยังพารามิเตอร์ที่เฉพาะเจาะจงในรายการ

aconp
ad_rule
ad_type
addtl_consent
afvsz
allcues
an
ciu_szs
correlator
cmsid
cust_params
description_url
dth
env
excl_cat
gdfp_req
gdpr
gdpr_consent
givn

hl
iabexcl
idtype
ipd
ipe
is_lat
iu
lip
ltd
max_ad_duration
min_ad_duration
mridx
msid
nofb
npa
omid_p
output
paln
plcmt

pmad
pmnd
pmxd
pod
pp
ppt
ppid
ppos
ppsj
ptpl
ptpln
pubf
pvid
pvid_s
pvtf
rdid
rdp
schain
scor

sdk_apis
sdmax
sid
ssss
sz
tfcd
trt
unviewed_position_start
url
vad_type
vconp
vid
vid_d
vpa
vpi
vpmute
vpos
wta

พารามิเตอร์ รายละเอียด

aconp

_{(การเล่นเสียงอย่างต่อเนื่อง)}

แนะนําตามหลักเกณฑ์การวัดผลเสียงของ MRC

พารามิเตอร์เล่นเสียงต่อเนื่องจะยอมรับค่าคงที่ซึ่งระบุว่าวิดีโอเพลเยอร์จะเล่นเนื้อหาเสียงอย่างต่อเนื่องหรือไม่

ควรปล่อยพารามิเตอร์นี้ไว้โดยไม่ตั้งค่าหากไม่ทราบ

ตัวอย่างการใช้งาน

เปิดการเล่นต่อเนื่อง:
aconp=2

ปิดการเล่นต่อเนื่อง:
aconp=1

ad_rule

_{(กฎโฆษณา)}

พารามิเตอร์กฎโฆษณาจะยอมรับค่าคงที่ซึ่งระบุว่าจะตอบกลับคำขอด้วยครีเอทีฟโฆษณา VAST หรือกฎโฆษณา

การตั้งค่าเริ่มต้นสำหรับกฎโฆษณาจะขึ้นอยู่กับการตั้งค่าเครือข่าย Ad Manager คุณลบล้างการตั้งค่าสำหรับแท็กโฆษณาที่เจาะจงโดยใช้ตัวอย่างด้านล่างนี้ได้

ตัวอย่างการใช้งาน

คำขอครีเอทีฟโฆษณา VAST:
ad_rule=0

คำขอกฎโฆษณา (VMAP)
ad_rule=1

ข้อกำหนด

ต้องระบุ ต้องใช้สำหรับกฎโฆษณาวิดีโอ

ad_type

_{(ประเภทโฆษณา)}

พารามิเตอร์ประเภทโฆษณาจะยอมรับค่าคงที่ซึ่งระบุประเภทโฆษณาที่ควรแสดงสำหรับคำขอ

พารามิเตอร์นี้จำเป็นสําหรับโฆษณาเสียงเท่านั้น

เมื่อพารามิเตอร์ ad_type ตั้งค่าเป็น audio หรือ audio_video พารามิเตอร์ vpmute จะต้องตั้งค่าเป็น 0

ตัวอย่างการใช้

อนุญาตเฉพาะโฆษณาเสียง:
ad_type=audio

อนุญาตโฆษณาวิดีโอทั้งที่ข้ามได้และข้ามไม่ได้:
ad_type=video

อนุญาตทั้งโฆษณาเสียงและโฆษณาวิดีโอ:
ad_type=audio_video
(ค่านี้ช่วยให้ทั้ง 2 รูปแบบแข่งขันกันได้ แต่จะมีโฆษณาเพียงรูปแบบเดียว)

ประเภทโฆษณา audio_video มีวัตถุประสงค์เพื่อใช้สำหรับการแสดงครีเอทีฟโฆษณาวิดีโอในเนื้อหาเสียงที่รองรับการเล่นโฆษณาวิดีโอหรือแสดงครีเอทีฟโฆษณาเสียงในวิดีโอเพลเยอร์ในสตรีมสำหรับเนื้อหาที่ "ได้ยินเสียงได้" เช่น สตรีมกีฬา วิดีโอแคสต์ ข่าว ฯลฯ อ่านเพิ่มเติมเกี่ยวกับเสียงในเนื้อหาวิดีโอ

อนุญาตเฉพาะโฆษณาวิดีโอที่ข้ามได้:
ad_type=skippablevideo

อนุญาตเฉพาะโฆษณาวิดีโอที่ข้ามไม่ได้:
ad_type=standardvideo

ความต้องการ

ต้องระบุ ต้องใช้สำหรับโฆษณาเสียง

addtl_consent

_{(ความยินยอมเพิ่มเติม)}

พารามิเตอร์ความยินยอมเพิ่มเติมยอมรับค่าตัวแปรและใช้โดยผู้เผยแพร่โฆษณาที่ต้องการผสานรวมกับ TCF เวอร์ชัน 2.0 ของ IAB และใช้ผู้ให้บริการที่ยังไม่ได้ลงทะเบียนในรายชื่อผู้ให้บริการทั่วโลกของ IAB Europe แต่อยู่ในรายชื่อผู้ให้บริการเทคโนโลยีโฆษณา (ATP) ของ Google คำขอ VAST โดยตรงจะไม่อ่านค่าดังกล่าวโดยอัตโนมัติ แต่ค่าจะได้รับการยอมรับเมื่อเพิ่มลงในแท็กโฆษณา

อ่านข้อมูลเพิ่มเติมเกี่ยวกับค่าที่ส่งต่อไปยังพารามิเตอร์นี้ได้ในข้อกำหนดทางเทคนิคของโหมดความยินยอมเพิ่มเติม

ตัวอย่างการใช้งาน

addtl_consent=1~1.35.41.101

afvsz

_{(ขนาดโฆษณาที่ไม่ใช่แบบเชิงเส้น)}

พารามิเตอร์ขนาดโฆษณาที่ไม่ใช่แบบเชิงเส้นจะยอมรับค่าคงที่ซึ่งควรเป็นรายการขนาดโฆษณาที่ไม่ใช่แบบเชิงเส้นและแสดงในช่องโฆษณาวิดีโอได้ โดยแต่ละค่าจะต้องคั่นด้วยคอมมา

ขนาดดังกล่าวต้องเป็นขนาดที่รองรับ ดังนี้

200x200
250x250
300x250
336x280
450x50
468x60
480x90
729x90

เมื่อใช้ IMA SDK ระบบจะเขียนทับช่องนี้ด้วยขนาดที่รองรับทั้งหมดตาม nonLinearAdSlotWidth และ nonLinearAdSlotHeight

คุณสามารถปล่อยพารามิเตอร์นี้เว้นว่างไว้ได้เมื่อไม่รองรับขนาดที่ไม่ใช่แบบเชิงเส้น

ตัวอย่างการใช้งาน

รองรับทุกขนาด:
afvsz=200x200,250x250,300x250,336x280, 450x50,468x60,480x90,728x90

ความกว้างสูงสุดคือ 250:
afvsz=200x200,250x250

ความสูงสูงสุดคือ 60:
afvsz=450x50,468x60

ความกว้างสูงสุดคือ 100:
//ว่างเปล่า หมายถึงไม่รองรับค่าใดเลย

ข้อกำหนด

ต้องระบุ จำเป็นสำหรับโฆษณาวิดีโอที่ไม่ใช่เชิงเส้นเมื่อไม่ได้ใช้ IMA SDK

allcues

_{(จุดเริ่มโฆษณาทั้งหมด)}

พารามิเตอร์นี้จะยอมรับค่าตัวแปรซึ่งเป็นรายการที่คั่นด้วยคอมมาของจุดเริ่มโฆษณา มีหน่วยเป็นมิลลิวินาที สำหรับแต่ละค่า Ad Manager จะแสดงช่วงพักโฆษณา

พารามิเตอร์ vid_d และ allcues ใช้เพื่อแสดงโฆษณาตอนกลางโดยไม่ต้องนำเข้าเนื้อหา คุณต้องใช้กฎโฆษณาด้วยจึงจะแสดงโฆษณาตอนกลางได้

หากมีการใช้จุดเวลาในกฎโฆษณา (เช่น "ทุก N วินาที" หรือ "ตามเวลาที่กำหนด") ระบบก็จะใช้จุดเวลาที่ตั้งค่าไว้ในกฎโฆษณาและละเว้นจุดเวลาที่ส่งเข้าไปใน allcues โฆษณาตอนกลางยังคงต้องมีระยะเวลา จึงต้องมีการส่ง vid_d อยู่

ตัวอย่างการใช้งาน

จุดเริ่มโฆษณาวินาทีที่ 10 และ 20
allcues=10000,20000

ciu_szs

_{(ขนาดโฆษณาที่แสดงร่วม)}

พารามิเตอร์ขนาดโฆษณาที่แสดงร่วมจะยอมรับค่าตัวแปรซึ่งเป็นรายการที่คั่นด้วยคอมมาของขนาดโฆษณาที่แสดงร่วม

ค่าที่คั่นด้วยอักขระไปป์ (|) แสดงถึงช่องโฆษณาหลายขนาด

ตัวอย่างการใช้งาน

ciu_szs=728x90,300x250

ขนาดที่มีช่องโฆษณาหลายขนาด:
ciu_szs=728x90,300x200|300x250

cmsid

_{(รหัสแหล่งที่มาของเนื้อหา)}

vid

_{(รหัสวิดีโอ)}

พารามิเตอร์รหัสแหล่งที่มาเนื้อหาและรหัสวิดีโอจะยอมรับค่าตัวแปร

ในการกำหนดเป้าหมายโฆษณาไปยังเนื้อหาวิดีโอ แท็กวิดีโอหลักต้องมีพารามิเตอร์ทั้งสองรายการ

cmsid เป็นหมายเลขที่ไม่ซ้ำสำหรับแหล่งที่มาของเนื้อหาแต่ละแหล่ง หากต้องการดูหมายเลขนี้ใน Ad Manager ให้คลิกวิดีโอ จากนั้น แหล่งที่มาของเนื้อหา แล้วคลิกชื่อของแหล่งที่มา

vid เป็นสตริงหรือหมายเลขที่ระบุวิดีโอที่เจาะจง รหัสนี้กำหนดโดย CMS ที่โฮสต์เนื้อหาของคุณ หากต้องการดูรหัสนี้ใน Ad Manager ให้คลิกวิดีโอ เนื้อหา จากนั้นคลิกเนื้อหาวิดีโอที่เจาะจง

ตัวอย่างการใช้งาน

cmsid=[value]&vid=[value]

หากคุณกำลังสร้างแท็กสำหรับการแทรกโฆษณาแบบไดนามิกที่มีวิดีโอตามคำขอ คุณควรใช้มาโครที่จะแทรกแหล่งที่มาของเนื้อหาและรหัสวิดีโอที่ถูกต้องในแบบไดนามิก

ตัวอย่างเช่น: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%

ข้อกำหนด

ต้องระบุ ต้องใช้สำหรับการกำหนดเป้าหมายเนื้อหาวิดีโอ

correlator

_{(สหสัมพันธ์)}

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

ถ้ามีการใช้ IMA SDK ก็จะมีการตั้งค่าสหสัมพันธ์โดยอัตโนมัติ หากโปรแกรมเล่นพยายามตั้งค่านี้ SDK จะเขียนทับค่านี้ด้วยค่าของตัวเอง

หากไม่ได้ใช้ IMA SDK ให้ตรวจสอบว่าคุณตั้งค่านี้เป็นจำนวนบวกแบบสุ่มที่แท้จริง ซึ่งไม่ถูกใช้ซ้ำโดยการดูหน้าเว็บหลายๆ ครั้ง

ตัวอย่างการใช้งาน

correlator=4345645667

ข้อกำหนด

ต้องระบุ ต้องใช้สำหรับเว็บและแอป

แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม

cust_params

_{(พารามิเตอร์คีย์-ค่าที่กำหนดเอง)}

พารามิเตอร์ที่กำหนดเองจะยอมรับค่าตัวแปรซึ่งก็คือคู่คีย์-ค่าที่ช่วยให้คุณตั้งค่าการกำหนดเป้าหมายที่เฉพาะเจาะจงได้ เช่น ข้อมูลประชากร บางตำแหน่งในหน้าเว็บ หรือหน้าเว็บบางหน้าหรือหลายหน้า

ตัวอย่างการใช้งาน

ดูตัวอย่างวิธีเพิ่มคู่คีย์-ค่า

description_url

_{(URL คำอธิบาย)}

พารามิเตอร์ URL คำอธิบายจะยอมรับค่าตัวแปร ซึ่งควรอธิบายวิดีโอที่กำลังเล่นอยู่ในหน้าเว็บ เขียนโครงร่างหน้าเว็บ 1-3 ย่อหน้าเพื่ออธิบายเนื้อหา ตัวอย่างเช่น ต่อเนื้อหาของหน้า description_url แบบไดนามิกจากบล็อกที่กำหนดไว้ล่วงหน้า ดูข้อมูลเพิ่มเติมเกี่ยวกับการระบุ URL คำอธิบายที่แตกต่างกัน

ค่า description_url ต้องเป็น URL ที่เข้ารหัสสำหรับโปรแกรมเล่นวิดีโอบนหน้าเว็บและอุปกรณ์ CTV/OTT และที่ไม่เข้ารหัสสำหรับโปรแกรมเล่นวิดีโอในแอปบนอุปกรณ์เคลื่อนที่

IMA SDK ไม่ได้ตั้งค่าพารามิเตอร์นี้โดยอัตโนมัติ คุณจึงต้องตั้งค่าด้วยตนเอง

ตัวอย่างการใช้งาน

URL ที่เข้ารหัส:
description_url= https%3A%2F%2Fwww.sample.com%2Fgolf.html

URL ที่ไม่เข้ารหัส:
description_url= https://www.sample.com/golf.html

ความต้องการ

ต้องระบุ ต้องใช้สำหรับเว็บ แอป และ Ad Exchange

แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม

dth

_{(คำแนะนำประเภทอุปกรณ์)}

พารามิเตอร์คำแนะนำประเภทอุปกรณ์จะยอมรับค่าคงที่ซึ่งช่วยลดการแยกประเภทอุปกรณ์ที่ไม่ถูกต้อง โดยเฉพาะในสภาพแวดล้อมทีวีที่เชื่อมต่ออินเทอร์เน็ตและกล่องรับสัญญาณ

การจัดประเภทอุปกรณ์ที่ไม่ถูกต้องอาจเกิดจากข้อผิดพลาดที่ไม่คาดคิดจากผู้เผยแพร่โฆษณาหรือ OEM ของทีวีที่เชื่อมต่ออินเทอร์เน็ต ระบบจะใช้พารามิเตอร์นี้ร่วมกับสัญญาณอื่นๆ เพื่อให้ Google แจ้งอินสแตนซ์โดยอัตโนมัติที่อาจมีการจัดประเภทพื้นที่โฆษณาทีวีที่เชื่อมต่ออินเทอร์เน็ตใหม่

ตัวอย่างการใช้

คำขอจาก

ฟีเจอร์โฟน: dth=1
สมาร์ทโฟน: dth=2
เดสก์ท็อป: dth=3
แท็บเล็ต: dth=4
ทีวีที่เชื่อมต่ออินเทอร์เน็ต: dth=5
คอนโซลเกม: dth=6
กล่องรับสัญญาณ: dth=7

ข้อกำหนด

แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรมบนทีวีที่เชื่อมต่ออินเทอร์เน็ต

เราขอแนะนำให้ใช้พารามิเตอร์นี้สำหรับการใช้งาน PAL และ PAI (ที่ไม่ใช่ SDK) แต่ไม่จำเป็นต้องใช้สำหรับ IMA SDK หรือ DAI SDK

env

_{(สภาพแวดล้อม)}

พารามิเตอร์สภาพแวดล้อมจะยอมรับค่าคงที่ที่ระบุคำขอในสตรีม หรือระบุว่าคำขอมาจากวิดีโอเพลเยอร์โดยเฉพาะ

ค่าที่เป็นไปได้คือ instream ซึ่งใช้สำหรับโฆษณาวิดีโอและโฆษณาเสียง หรือ vp ซึ่งใช้ได้กับโฆษณาวิดีโอเท่านั้น

ตัวอย่างการใช้งาน

วิดีโอและ/หรือเสียง:
env=instream

วิดีโอเท่านั้น:
env=vp

ข้อกำหนด

ต้องระบุ ต้องใช้สำหรับเว็บและแอป

excl_cat

_{(หมวดหมู่การยกเว้น)}

พารามิเตอร์หมวดหมู่การยกเว้นจะยอมรับค่าตัวแปร และใช้เพื่อบล็อกรายการโฆษณาทุกรายการที่ประกอบด้วยป้ายกำกับการยกเว้นเพื่อไม่ให้มีสิทธิ์สำหรับคำขอโฆษณาที่ระบุ โดยพารามิเตอร์นี้ใช้ได้กับ cust_params

ตัวอย่างการใช้งาน

&cust_params=excl_cat%3Dairline_excl_label%7C

gdfp_req

_{(ตัวระบุสคีมา Ad Manager)}

พารามิเตอร์ตัวระบุสคีมา Ad Manager จะยอมรับค่าคงที่ซึ่งจะระบุว่าผู้ใช้อยู่ในสคีมา Ad Manager

ตัวอย่างการใช้งาน

gdfp_req=1

ข้อกำหนด

ต้องระบุ ต้องใช้สำหรับเว็บและแอป

gdpr

_(GDPR)

พารามิเตอร์ GDPR จะยอมรับค่าคงที่และใช้โดยผู้เผยแพร่โฆษณาที่ต้องการผสานรวมกับ TCF เวอร์ชัน 2.0 ของ IAB คำขอ VAST โดยตรงจะไม่อ่านค่าดังกล่าวโดยอัตโนมัติ แต่ค่าจะได้รับการยอมรับเมื่อเพิ่มลงในแท็กโฆษณา

มีเพียง 0 และ 1 เท่านั้นที่เป็นค่าที่ถูกต้องสำหรับพารามิเตอร์นี้ โดยที่ 0 หมายความว่า GDPR ไม่มีผล และ 1 หมายถึง GDPR มีผล หาก GDPR มีผล คุณต้องระบุสตริง TC ที่ถูกต้องโดยใช้พารามิเตอร์ gdpr_consent ด้วย

อ่านข้อมูลเพิ่มเติมเกี่ยวกับค่าที่ส่งต่อไปยังพารามิเตอร์นี้ได้ในคำแนะนำทั่วไปในการใช้เฟรมเวิร์กนี้หรือในส่วนสตริง TC ของข้อกำหนด TCF เวอร์ชัน 2.0 ของ IAB

ตัวอย่างการใช้งาน

GDPR มีผล:
gdpr=1

GDPR ไม่มีผล:
gdpr=0

gdpr_consent

_{(ความยินยอมตาม GDPR)}

พารามิเตอร์คำยินยอมตาม GDPR จะยอมรับค่าตัวแปรและใช้โดยผู้เผยแพร่โฆษณาที่ต้องการผสานรวมกับ TCF เวอร์ชัน 2.0 ของ IAB คำขอ VAST โดยตรงจะไม่อ่านค่าดังกล่าวโดยอัตโนมัติ แต่ค่าจะได้รับการยอมรับเมื่อเพิ่มลงในแท็กโฆษณา

ตัวอย่างการใช้งาน

gdpr_consent=GDPR_CONSENT_123

givn
paln

_{(Nonce ของวิดีโอ)}

For integrations that use the Programmatic Access Library (PAL), the video nonce parameter accepts a variable string value.

The nonce is URL safe—you don't need to URL-encode it.

Note: If you previously provided a nonce using the legacy paln parameter, it is strongly recommended to migrate to the givn parameter and stop sending paln. Do not include both parameters.

Usage example

You can read more about the value passed to this parameter in the getting started guides for PAL.

hl

_{(ภาษา)}

พารามิเตอร์ภาษาจะยอมรับค่าคงที่ซึ่งใช้สำหรับการขอโฆษณาในภาษานั้นหรือใช้สำหรับภาษาในการเลือกโฆษณาและการแสดงโฆษณาวิดีโอในการจัดสรรแบบไดนามิกให้กับวิดีโอ Ad Exchange หรือ AdSense

ค่าพารามิเตอร์จะเป็นค่าใดก็ได้ที่ใช้รหัส ISO 639-1 (2 ตัวอักษร) หรือ ISO 639-2 (3 ตัวอักษร) ดูรายการรหัสที่ใช้ได้

หากไม่ใส่พารามิเตอร์นี้ ค่าเริ่มต้นจะเป็นภาษาใดก็ตามที่มีการกำหนดเป้าหมายโฆษณาตามภาษาใน Ad Exchange

ตัวอย่างการใช้งาน

hl=it

ข้อกำหนด

แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม

iabexcl

_{(URL การยกเว้น IAB)}

พารามิเตอร์ของ URL iabexcl ยอมรับรายการหมวดหมู่ที่คั่นด้วยคอมมา

ตัวอย่างการใช้งาน

iabexcl=3,14,527 ยกเว้น "รถบรรทุกเพื่อการพาณิชย์", "รถออฟโรด" และ "รักบี้"

ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดหมวดหมู่เนื้อหาของ IAB

ipd

_{(โดเมนพาร์ทเนอร์พื้นที่โฆษณา)}

พารามิเตอร์โดเมนพาร์ทเนอร์พื้นที่โฆษณาจะยอมรับค่าตัวแปร ซึ่งควรจะตั้งค่าเป็นการประกาศ inventorypartnerdomain ในไฟล์ app-ads.txt ของผู้เผยแพร่โฆษณา (หรือไฟล์ ads.txt)

พารามิเตอร์ inventorypartnerdomain เป็นข้อกำหนดจำเพาะของ IAB ที่ช่วยผู้เผยแพร่โฆษณาในการกำหนดโดเมนของพาร์ทเนอร์การแชร์พื้นที่โฆษณาเพื่อวัตถุประสงค์ในการตรวจสอบความถูกต้องของ ads.txt/app-ads.txt

การประกาศ IPD มีความสําคัญอย่างยิ่งใน Use Case ของการแชร์พื้นที่โฆษณาที่พื้นที่โฆษณาซึ่งมีการส่งคําขอนั้นอาจเป็นของพาร์ทเนอร์รายอื่น (ซึ่งก็คือพาร์ทเนอร์การแชร์พื้นที่โฆษณา)

ดูข้อมูลเพิ่มเติมเกี่ยวกับ ads.txt/app-ads.txt และพาร์ทเนอร์การแชร์พื้นที่โฆษณา

ipe

_{(เอนทิตีที่ใช้คำสั่ง ping เมื่อมีการแสดงผล)}

พารามิเตอร์ Impression Pinging Entity จะยอมรับค่าคงที่ที่ใช้เพื่อระบุคำสั่ง ping และ Conversion ของการแสดงผลที่มาจากเซิร์ฟเวอร์ ไม่ใช่จากไคลเอ็นต์

ตัวอย่างการใช้งาน

การใช้บีคอนฝั่งเซิร์ฟเวอร์ (SSB):
ipe=ssb

iu

_{(หน่วยโฆษณา)}

พารามิเตอร์หน่วยโฆษณาจะยอมรับค่าตัวแปรซึ่งควรตั้งค่าเป็นหน่วยโฆษณาปัจจุบันในรูปแบบต่อไปนี้

/network_code/.../ad_unit

ตัวอย่างการใช้งาน

iu=/6062/videodemo

ข้อกำหนด

ต้องระบุ ต้องใช้สำหรับเว็บและแอป

lip

_{(ตำแหน่งสุดท้ายในพ็อด)}

พารามิเตอร์ตำแหน่งสุดท้ายในพ็อดจะยอมรับค่าคงที่ซึ่งระบุคำขอจากตำแหน่งสุดท้ายในพ็อด

พารามิเตอร์นี้ใช้สำหรับพ็อดมาตรฐานเท่านั้น

ตัวอย่างการใช้งาน

lip=true

ltd

_{(โฆษณาแบบจำกัด)}

พารามิเตอร์โฆษณาแบบจำกัดจะยอมรับค่าคงที่ซึ่งใช้ระบุว่าจะแสดงโฆษณาในแบบจำกัดหรือไม่ ในกรณีที่ไม่ได้รับความยินยอมให้ใช้คุกกี้หรือตัวระบุอื่นๆ ในเครื่อง

การตั้งค่า ltd=1 ต่างจากพารามิเตอร์ของ URL อื่นๆ ตรงที่จะเปลี่ยนลักษณะการทํางานของ IMA SDK ให้ถือว่าคําขอไม่มีรหัสและไม่อนุญาตให้ใช้พื้นที่เก็บข้อมูล

ตัวอย่างการใช้งาน

ltd=1

min_ad_duration

_{(ระยะเวลาขั้นต่ำของโฆษณา)}

max_ad_duration

_{(ระยะเวลาสูงสุดของโฆษณา)}

พารามิเตอร์ระยะเวลาของโฆษณาจะยอมรับค่าตัวแปร ซึ่งเมื่อใช้ร่วมกันจะระบุช่วงระยะเวลาที่ต้องตรงกับโฆษณา มีหน่วยเป็นมิลลิวินาที

ใช้พารามิเตอร์นี้เพื่อจำกัดระยะเวลาของโฆษณาแต่ละรายการสําหรับโฆษณาเดี่ยวและคําขอพ็อดที่เพิ่มประสิทธิภาพ

ตัวอย่างการใช้งาน

min_ad_duration=15000&max_ad_duration=30000

mridx

_{(หมายเลขโฆษณาตอนกลาง)}

พารามิเตอร์หมายเลขโฆษณาตอนกลางจะยอมรับค่าตัวแปรซึ่งระบุเลขลำดับของโฆษณาตอนกลาง (เช่น โฆษณาตอนกลาง 1 โฆษณาตอนกลาง 2 เป็นต้น)

ตัวอย่างการใช้งาน

mridx=2

msid

_{(รหัสแอป)}

an

_{(ชื่อแอป)}

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

IMA SDK จะป้อนค่าพารามิเตอร์ทั้งคู่นี้ให้โดยอัตโนมัติ แต่คุณจะต้องระบุด้วยตนเองในสภาพแวดล้อมที่ไม่ใช่ SDK ซึ่งรวมถึงการเรียกใช้ VAST โดยตรง หรือเมื่อใช้ Programmatic Access Library (PAL) หรือ Publisher Authenticated Inventory (PAI)

ในขณะที่ชื่อแอปควรเป็นชื่อที่มนุษย์อ่านได้ แต่ใน iOS และ tvOS นั้น SDK ไม่อาจเข้าถึงรหัสแอป ในกรณีเช่นนี้ จะไม่มีการส่งพารามิเตอร์ msid และ SDK จะส่ง App Bundle ผ่านพารามิเตอร์ an

ตัวอย่างการใช้งาน

msid=com.package.publisher&an=sample%20app

ระบบจะตั้งชื่อและจัดรูปแบบรหัสแอป แตกต่างกันไปตาม App Store ต่างๆ ดูหลักเกณฑ์ของ IAB เกี่ยวกับการระบุแอป หรือตัวอย่างของตัวระบุที่ไม่ซ้ำกันทั่วไป

สําหรับแพลตฟอร์มที่ไม่มี App Store อยู่ IAB แนะนําให้ผู้เผยแพร่โฆษณาใช้รูปแบบต่อไปนี้สําหรับรหัสร้านค้า com.publisher.deviceplatform

ความต้องการ

ต้องระบุพารามิเตอร์ทั้ง 2 ตัวสำหรับแอป

แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม

nofb

_{(ปิดใช้โฆษณาสำรอง)}

พารามิเตอร์ปิดใช้โฆษณาสำรองจะยอมรับค่าคงที่เพื่อระบุว่าคำขอโฆษณาไม่ควรแสดงเพลย์ลิสต์โฆษณาวิดีโอสำรอง

ตัวอย่างการใช้งาน

ปิดใช้โฆษณาสำรอง:
nofb=1

npa

_{(โฆษณาที่ไม่ได้ปรับตามโปรไฟล์ของผู้ใช้)}

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

คุณต้องตั้งค่า npa=1 หรือมีแค่ npa (โดยไม่ตั้งค่าไว้) เพื่อติดแท็กคำขอให้เป็นแบบไม่ได้ปรับตามโปรไฟล์ของผู้ใช้ คำขอโฆษณาที่ไม่มีพารามิเตอร์นี้ หรือตั้งค่าเป็น npa=0 จะมีค่าเริ่มต้นเป็นโฆษณาที่ปรับตามโปรไฟล์ของผู้ใช้

ตัวอย่างการใช้งาน

โฆษณาที่ไม่ได้ปรับตามโปรไฟล์ของผู้ใช้:
npa=1

omid_p

_{(ชื่อพาร์ทเนอร์ OMID)}

พารามิเตอร์ชื่อพาร์ทเนอร์ OMID จะยอมรับค่าตัวแปรที่ระบุชื่อของพาร์ทเนอร์ที่รวมการวัด OMID และเวอร์ชันของพาร์ทเนอร์

พารามิเตอร์นี้ใช้ได้กับผู้เผยแพร่โฆษณาที่ต้องการการวัดมุมมองแอ็กทีฟเมื่อใช้ Open Measurement SDK (OM SDK) เท่านั้น ซึ่งไม่ควรใช้พารามิเตอร์นี้หากใช้ IMA SDK เพราะตั้งค่าไว้โดยอัตโนมัติ

หากต้องการระบุการรองรับ OMID เมื่อใช้ไลบรารีการเข้าถึงแบบเป็นโปรแกรม (PAL) คุณต้องใช้ API ของ omidPartnerName และ omidPartnerVersion เพื่อตั้งค่าชื่อและเวอร์ชันของพาร์ทเนอร์ หากไม่ได้ใช้ PAL หรือ IMA คุณต้องตั้งค่าพารามิเตอร์ omid_p และ sdk_apis (API ที่รองรับ ซึ่งอาจรวมถึง API อื่นๆ ที่คั่นด้วยคอมมาด้วย)

ตัวอย่างการใช้งาน

เมื่อใช้ PAL:
request.omidPartnerName = 'examplepartnername' request.omidPartnerVersion = '1.0.0.0'

เมื่อไม่ได้ใช้ PAL:
omid_p=examplepartnername/1.0.0.0&sdk_apis=7

output

_{(รูปแบบเอาต์พุตโฆษณา)}

พารามิเตอร์รูปแบบเอาต์พุตโฆษณาจะยอมรับค่าคงที่ซึ่งควรตั้งค่าเป็นรูปแบบเอาต์พุตของโฆษณา

ใช้ output=vast เพื่อใช้เวอร์ชัน VAST เริ่มต้นที่ตั้งค่าไว้สำหรับเครือข่ายของคุณ คุณสามารถขอเวอร์ชัน VAST หรือ VMAP ที่เจาะจงได้สำหรับแท็กโฆษณาหรือส่วนต่างๆ ของเว็บไซต์ที่ต้องการ

สำหรับ VAST หากวิดีโอเพลเยอร์ใช้ IMA SDK พารามิเตอร์เอาต์พุตสำหรับคำขอโฆษณาวิดีโอจะตั้งค่าเป็น output=xml_vast4 เสมอ ซึ่งไม่ก่อให้เกิดความเสี่ยงด้านความน่าเชื่อถือ เนื่องจาก SDK ดังกล่าวใช้งานย้อนหลังได้กับ VAST ทุกเวอร์ชันที่เซิร์ฟเวอร์โฆษณาของบุคคลที่สามอาจจะแสดง

ใช้ output=vmap เพื่อแสดงเวอร์ชัน VMAP เริ่มต้นที่คุณเปิดใช้งานสำหรับเครือข่าย (เช่น VMAP 1) หากคุณแสดง VAST ใน VMAP คุณจะใช้ xml_vmap1_vast3 หรือ xml_vmap1_vast4 เพื่อระบุเวอร์ชัน VAST ที่จะแสดงได้

ตัวอย่างการใช้งาน

การตั้งค่า VAST เริ่มต้นของเครือข่าย:
output=vast

VAST 4:
output=xml_vast4

การตั้งค่า VMAP เริ่มต้นของเครือข่าย:
output=vmap

VMAP 1:
output=xml_vmap1

VMAP 1 ที่แสดง VAST 4:
output=xml_vmap1_vast4

ข้อกำหนด

ต้องระบุ ต้องใช้สำหรับเว็บและแอป

plcmt

_{(ตำแหน่งโฆษณา)}

พารามิเตอร์ตำแหน่งโฆษณาจะยอมรับค่าคงที่ที่ใช้เพื่อระบุว่ามีการประกาศพื้นที่โฆษณาในสตรีมเป็นเนื้อหาในสตรีมหรือเนื้อหาประกอบตามคำแนะนำที่ระบุในข้อกำหนดของ IAB

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

ตัวอย่างการใช้งาน

คำขอในสตรีม:
plcmt=1

คำขอเนื้อหาประกอบ:
plcmt=2

ความต้องการ

ต้องระบุ ต้องใช้สำหรับเว็บและการสร้างรายได้แบบเป็นโปรแกรม

pmad

_{(จำนวนโฆษณาสูงสุดในพ็อด)}

พารามิเตอร์จำนวนโฆษณาสูงสุดในพ็อดจะยอมรับค่าตัวแปรซึ่งระบุจำนวนโฆษณาสูงสุดในพ็อด

พารามิเตอร์นี้ใช้เฉพาะกับพ็อดที่เพิ่มประสิทธิภาพ ซึ่งพร้อมใช้งานสำหรับผู้เผยแพร่โฆษณาที่มีแพ็กเกจวิดีโอขั้นสูง พารามิเตอร์นี้ไม่ควรใช้กับ VMAP (เมื่อ ad_rule=1)

ตัวอย่างการใช้งาน

pmad=4

pmnd

_{(ระยะเวลาขั้นต่ำของพ็อด)}

pmxd

_{(ระยะเวลาสูงสุดของพ็อด)}

พารามิเตอร์ระยะเวลาของพ็อดจะยอมรับค่าตัวแปร ซึ่งเมื่อใช้ร่วมกันจะระบุช่วงระยะเวลาที่ต้องตรงกับพ็อด มีหน่วยเป็นมิลลิวินาที

พารามิเตอร์เหล่านี้จะใช้ขอโฆษณาหลายรายการ โดยจะใช้เฉพาะกับพ็อดที่เพิ่มประสิทธิภาพ ซึ่งพร้อมใช้งานสำหรับผู้เผยแพร่โฆษณาที่มีแพ็กเกจวิดีโอขั้นสูง นอกจากนี้ยังไม่ควรใช้กับ VMAP (เมื่อ ad_rule=1)

ตัวอย่างการใช้งาน

pmnd=0&pmxd=60000

pod

_{(หมายเลขพ็อด)}

พารามิเตอร์หมายเลขพ็อดจะยอมรับค่าตัวแปรซึ่งแสดงถึงเลขลำดับของพ็อดในวิดีโอ (เช่น พ็อด 1 พ็อด 2 เป็นต้น)

ตัวอย่างการใช้งาน

pod=3

ข้อกำหนด

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

pp

_{(โปรไฟล์ครีเอทีฟโฆษณา)}

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

ตัวอย่างการใช้งาน

pp=creative_profile

ข้อกำหนด

แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม

ppt

_{(การดูแลด้านความเป็นส่วนตัวสำหรับผู้เผยแพร่โฆษณา)}

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับการดูแลด้านความเป็นส่วนตัวสำหรับผู้เผยแพร่โฆษณา

ตัวอย่างการใช้งาน

ปิดการปรับโฆษณาตามโปรไฟล์ของผู้ใช้:
ppt=1

ppid

_{(ตัวระบุที่ผู้เผยแพร่โฆษณามีให้)}

พารามิเตอร์ตัวระบุที่ผู้เผยแพร่โฆษณามีให้ (PPID) จะยอมรับค่าตัวแปรของตัวระบุเพื่อใช้ในการกำหนดความถี่สูงสุด การแบ่งกลุ่มและกำหนดเป้าหมายผู้ชม การหมุนเวียนโฆษณาตามลำดับ และการควบคุมการแสดงโฆษณาตามกลุ่มผู้ชมแบบอื่นๆ ในทุกอุปกรณ์

ตัวอย่างการใช้งาน

ppid=12JD92JD8078S8J29SDOAKC0EF230337

ppos

_{(ตำแหน่งในพ็อด)}

พารามิเตอร์ตำแหน่งในพ็อดจะยอมรับค่าตัวแปรซึ่งแสดงถึงตำแหน่งในพ็อด (เช่น ตำแหน่ง 1 ตำแหน่ง 2 เป็นต้น)

พารามิเตอร์นี้ใช้สำหรับพ็อดมาตรฐานเท่านั้นและจำเป็นต้องใช้สำหรับการเติมโฆษณาแสดงร่วมอัตโนมัติ

ตัวอย่างการใช้งาน

ppos=2

ข้อกำหนด

ppsj

_{(Publisher provided signals JSON)}

พารามิเตอร์ Publisher Provided Signals JSON (สัญญาณที่ได้จากผู้เผยแพร่โฆษณา JSON) จะยอมรับออบเจ็กต์ JSON ที่เข้ารหัสแบบ Base64 ซึ่งมีกลุ่มเป้าหมายและข้อมูลบริบทที่ผู้เผยแพร่โฆษณาระบุไว้เพื่อปรับปรุงการสร้างรายได้แบบเป็นโปรแกรม

ดูข้อมูลเพิ่มเติมเกี่ยวกับสัญญาณที่ได้จากผู้เผยแพร่โฆษณาและการจัดหมวดหมู่ที่รองรับ

ดูรายละเอียดคู่คีย์-ค่า JSON ที่ถูกต้องใน
ตัวอย่าง HTML5 IMA SDK

ตัวอย่างการใช้งาน

ออบเจ็กต์ JSON:
{ "PublisherProvidedTaxonomySignals": [{ "taxonomy": "IAB_AUDIENCE_1_1", "values": ["6", "284"] }] }

ค่าที่เข้ารหัส Base64:
eyJQdWJsaXNoZXJQcm92aWRlZFRheG9ub215U2lnbmFscyI6W3s idGF4b25vbXkiOiJJQUJfQVVESUVOQ0VfMV8xIiwidmFsdWVzIj pbIjEiLCIyODQiXX1dfQ

ptpl

_{(รหัสเทมเพลตช่วงพักโฆษณา)}

ptpln

_{(ชื่อเทมเพลตช่วงพักโฆษณา)}

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

ระบบต้องการเพียงพารามิเตอร์ตัวใดตัวหนึ่งจาก 2 ตัว (ชื่อหรือรหัส) เพื่อขอเทมเพลตช่วงพักโฆษณา

ตัวอย่างการใช้งาน

ดูรายละเอียดเพิ่มเติมเกี่ยวกับการตั้งค่าและการขอเทมเพลตช่วงพักโฆษณาได้ที่นี่

pubf

_{(ราคาขั้นต่ำแบบสาธารณะในแท็ก Ad Exchange)}

pvtf

_{(ราคาขั้นต่ำแบบส่วนตัวในแท็ก Ad Exchange)}

pubf เทียบเท่ากับ google_ad_public_floor และ pvtf เทียบเท่ากับ google_ad_private_floor พารามิเตอร์เหล่านี้ใช้เพื่อเพิ่มราคาขั้นต่ำลงในแท็ก Ad Exchange

ตัวอย่างการใช้งาน

pubf=123 pvtf=123

pvid

_{(รหัสชุดแอป)}

pvid_s

_{(ขอบเขตชุดแอป)}

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

พารามิเตอร์ pvid จะยอมรับค่าตัวแปร ซึ่งตั้งค่าเป็นรหัสชุดแอป Android และพารามิเตอร์ pvid_s จะยอมรับค่าคงที่ซึ่งแสดงถึงขอบเขตของรหัสชุดแอป (ไม่ว่าจะเป็น scope_app หรือ scope_developer)

ขณะที่ IMA/PAL SDK ส่งช่องนี้โดยอัตโนมัติ ผู้เผยแพร่โฆษณาที่ไม่ได้ใช้ SDK จะต้องเรียกใช้ SDK ของชุดแอปและส่งพารามิเตอร์เหล่านี้ไปยังคําขอโฆษณาด้วยตนเอง

ดูเอกสารประกอบของ Android เกี่ยวกับวิธีการเรียกรหัสชุดแอป

ตัวอย่างการใช้งาน

pvid=[AppSetID_value] pvid_s=scope_app

ข้อกำหนด

ต้องระบุ ต้องใช้สำหรับแอป

แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม

rdid

      idtype

      is_lat

_{(ตัวระบุอุปกรณ์ที่รีเซ็ตได้)}

ตัวระบุอุปกรณ์ที่รีเซ็ตได้จะยอมรับค่าตัวแปร

สำหรับแอปพลิเคชันในตัว (ไม่ใช่ในเว็บหรือเว็บบนอุปกรณ์เคลื่อนที่) SDK จะส่งตัวระบุอุปกรณ์ที่รีเซ็ตได้สำหรับผู้ใช้ที่กำหนดเป้าหมายในคำขอสตรีมของคุณด้วยพารามิเตอร์สำหรับ rdid, idtype และ is_lat ในสตรีม SSB คุณต้องส่งพารามิเตอร์เหล่านี้มาให้ชัดเจนเหมือนที่ส่งสำหรับคำขอโฆษณาในฝั่งไคลเอ็นต์ ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวระบุอุปกรณ์

สำหรับโฆษณาวิดีโอแบบเป็นโปรแกรมเกือบทั้งหมด จำเป็นต้องมีค่าเหล่านี้

Apple เลิกใช้งานสัญญาณ LAT แล้วใน iOS 14.5 เป็นต้นไป แต่ Google จะใช้ IDFA ที่มีอยู่ซึ่งไม่เป็นเลขศูนย์แทนเพื่อระบุว่าผู้ใช้ได้ยินยอมให้ติดตามในเวอร์ชัน iOS ที่รองรับความโปร่งใสในการติดตามแอป ดังนั้นต้องมี UserAgent ที่ระบุเวอร์ชันของระบบปฏิบัติการที่ถูกต้อง

ตัวอย่างการใช้งาน

ดูตัวอย่างโดยละเอียดของตัวระบุอุปกรณ์ที่รีเซ็ตได้

ข้อกำหนด

ต้องระบุ ต้องใช้สำหรับแอป

แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม

rdp

_{(จำกัดการประมวลผลข้อมูล)}

พารามิเตอร์จำกัดการประมวลผลข้อมูลจะยอมรับค่าคงที่เพื่อระบุว่าคำขอโฆษณาควรจำกัดการประมวลผลข้อมูลหรือไม่

คุณต้องตั้งค่า rdp=1 หรือมีแค่ rdp (โดยไม่ตั้งค่าไว้) เพื่อจำกัดการประมวลผลข้อมูล คำขอโฆษณาที่ไม่มีพารามิเตอร์นี้ หรือตั้งค่าเป็น rdp=0 จะไม่จำกัด เว้นแต่ว่าจะเปิดใช้การตั้งค่าเครือข่ายการประมวลผลข้อมูลแบบจำกัดอยู่

ตัวอย่างการใช้งาน

rdp=1

schain

_{(ซัพพลายเชน)}

พารามิเตอร์ซัพพลายเชนจะยอมรับค่าตัวแปรซึ่งควรเป็นออบเจ็กต์ SupplyChain ที่ทำให้เป็นอนุกรม เมื่อรวมพารามิเตอร์นี้ Google จะต่อท้ายโหนดไปยังออบเจ็กต์ schain ที่ได้รับก่อนที่จะส่งไปยังผู้ซื้อ

ดูเอกสารประกอบฉบับเต็มของ IAB สําหรับการสื่อสารข้อมูล SupplyChain ผ่านแท็ก (แทนที่จะเป็น OpenRTB)

ดูข้อกำหนดในการแยกวิเคราะห์ schain อย่างถูกต้อง

ต่อไปนี้เป็นการกำหนดการทำให้เป็นอนุกรมสำหรับออบเจ็กต์ SupplyChain โดยอิงตามเอกสารประกอบของ IAB

{SupplyChainObject}!{SupplyChainNode array} พร็อพเพอร์ตี้ SupplyChainObject และ SupplyChainNode มีการคั่นด้วยคอมมาเพื่อให้สามารถข้ามช่องที่ไม่บังคับและยกเว้นตัวคั่นคอมมาได้
องค์ประกอบ SupplyChainNode แต่ละรายการจะคั่นด้วย "!"
หากค่าของพร็อพเพอร์ตี้ใดมีอักขระที่ต้องเข้ารหัส URL (เช่น "," หรือ ",") ค่าดังกล่าวควรเข้ารหัส URL ก่อนการทำให้เป็นอนุกรม

ลำดับการทำให้เป็นอนุกรม

ระบบจะทำพร็อพเพอร์ตี้ SupplyChainObject ให้เป็นอนุกรมตามลำดับนี้

ver,complete

ระบบจะทำพร็อพเพอร์ตี้ SupplyChainNode ให้เป็นอนุกรมตามลำดับนี้

asi,sid,hp,rid,name,domain,ext

หมายเหตุ: เนื้อหาของ ext จะเป็นค่าเฉพาะสำหรับแต่ละพาร์ทเนอร์การจอง Google Ad Manager จะไม่แยกวิเคราะห์พร็อพเพอร์ตี้นี้

ตัวอย่างวิธีทำออบเจ็กต์ SupplyChain ให้เป็นอนุกรม

ด้านล่างนี้คือตัวอย่าง 2 วิธีในการทำออบเจ็กต์ SupplyChain ข้างต้นให้เป็นอนุกรม

ทำให้เป็นอนุกรมโดยมีคอมมาสำหรับฟิลด์ตัวเลือกที่ว่างเปล่า

1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,

ทำให้เป็นอนุกรมโดยไม่มีคอมมาสำหรับฟิลด์ตัวเลือกที่ว่างเปล่า

1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1

ดูข้อมูลเพิ่มเติมเกี่ยวกับออบเจ็กต์ SupplyChain

ตัวอย่างการใช้

schain=1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,

หากค่าของ asi คือ asi การทำให้เป็นอนุกรมด้วยอักขระหลีกจะมีลักษณะดังนี้

1.0,1!exchange%2C1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1

ข้อกำหนด

ต้องระบุสำหรับผู้เผยแพร่โฆษณาที่ใช้สื่อกลางการชำระเงินก่อนส่งคำขอไปยัง Google Ad Manager ซึ่งรวมถึงผู้เผยแพร่โฆษณาที่ใช้เทคโนโลยีเซิร์ฟเวอร์โฆษณาบุคคลที่สาม

scor

_{(สหสัมพันธ์ของสตรีม)}

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

ตัวอย่างการใช้งาน

scor=17

ข้อกำหนด

sdk_apis

_{(เฟรมเวิร์ก SDK API)}

พารามิเตอร์เฟรมเวิร์กของ SDK API ยอมรับรายการที่คั่นด้วยคอมมาของค่าจํานวนเต็มคงที่ ซึ่งระบุเฟรมเวิร์กของ API ทั้งหมดที่โปรแกรมเล่นรองรับ

ดูรายการค่าเฟรมเวิร์ก API ที่เป็นไปได้

พารามิเตอร์นี้รองรับ API ในไลบรารีการเข้าถึงแบบเป็นโปรแกรม (Programmatic Access Library หรือ PAL) สําหรับผู้เผยแพร่โฆษณาที่ไม่ได้ใช้ IMA SDK IMA SDK จะลบล้างค่าที่ตั้งไว้ด้วยค่าที่ IMA SDK รองรับ

ตัวอย่างการใช้งาน

sdk_apis=2,7,9

sdmax

_{(ระยะเวลาสูงสุดของโฆษณาที่ข้ามได้)}

พารามิเตอร์คำขอโฆษณา sdmax (ระยะเวลาโฆษณาสูงสุดของโฆษณาที่ข้ามได้) จะยอมรับค่าตัวแปรที่ช่วยให้ผู้เผยแพร่โฆษณาระบุระยะเวลาโฆษณาสูงสุดที่ต้องการสำหรับโฆษณาที่ข้ามได้

ระบบจะใช้เวลาเป็นมิลลิวินาทีที่แสดงขอบเขตสูงสุดที่ควรอนุญาตให้ใช้สำหรับระยะเวลาของครีเอทีฟโฆษณาวิดีโอ/เสียงที่ข้ามได้สำหรับคำขอโฆษณาดังกล่าว

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

ตัวอย่างการใช้งาน

ใช้การตั้งค่าต่อไปนี้

max_ad_duration = 15000 (15 วินาที)
sdmax = 45000 (45 วินาที)

สำหรับครีเอทีฟโฆษณาต่อไปนี้

ครีเอทีฟโฆษณา A: ข้ามไม่ได้ 30 วิ
ครีเอทีฟโฆษณา B: ข้ามได้ 30 วิ

จะให้ผลลัพธ์ดังนี้

ระบบจะกรองครีเอทีฟโฆษณา A เนื่องจากเป็นโฆษณาที่ข้ามไม่ได้และมีระยะเวลาเกินค่าสูงสุด (ข้ามไม่ได้)
ระบบจะไม่กรองครีเอทีฟโฆษณา B เนื่องจากแม้ว่าระยะเวลาของครีเอทีฟโฆษณาจะเกิน max_ad_duration แต่ก็เป็นแบบข้ามได้ และระยะเวลาของครีเอทีฟโฆษณาไม่เกินค่าสูงสุดสำหรับโฆษณาที่ข้ามได้

sid

_{(รหัสเซสชัน)}

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

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

ตามหลักเกณฑ์ IFA ของ IAB พารามิเตอร์นี้ต้องระบุในรูปแบบ UUID ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวระบุอุปกรณ์ที่รีเซ็ตได้เพื่อการกำหนดเป้าหมายผู้ใช้

คุณเลือกไม่ใช้การส่งรหัสเซสชันได้โดยการตั้งค่า sid=0

ตัวอย่างการใช้งาน

123e4567-e89b-12d3-a456-426614174000

ข้อกำหนด

แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม

ssss

_{(แหล่งที่มาของการต่อวิดีโอฝั่งเซิร์ฟเวอร์)}

พารามิเตอร์แหล่งที่มาของการต่อวิดีโอฝั่งเซิร์ฟเวอร์ยอมรับค่าคงที่ซึ่งควรตั้งเป็นค่าที่ Google ระบุและได้รับการยอมรับสำหรับผู้ให้บริการเทคโนโลยีการต่อวิดีโอที่คุณใช้

ผู้ให้บริการเทคโนโลยีการต่อวิดีโอที่ใช้การผสานรวมแบบเซิร์ฟเวอร์ต่อเซิร์ฟเวอร์กับ Google จะได้รับค่านี้จาก Google และให้ข้อมูลนี้กับคุณได้ โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าของ Google หากมีข้อสงสัยเกี่ยวกับค่าที่ควรตั้งเป็นพารามิเตอร์นี้

ตัวอย่างการใช้งาน

ssss=mystitcher

ข้อกำหนด

ต้องระบุ จำเป็นสําหรับการใช้งานฝั่งเซิร์ฟเวอร์

sz

_{(ขนาด)}

พารามิเตอร์ขนาดจะยอมรับค่าตัวแปร ซึ่งควรตั้งค่าเป็นขนาดของช่องโฆษณาวิดีโอหลัก

หากมีหลายขนาด ควรคั่นด้วยเครื่องหมายไปป์ (|)

อย่าใส่ "v" หลังขนาด

ตัวอย่างการใช้งาน

sz=400x300

ข้อกำหนด

ต้องระบุ ต้องใช้สำหรับเว็บและแอป

ไม่บังคับให้ใช้พารามิเตอร์นี้ถ้าขอเพียง ad_type=audio

tfcd

_{(แท็กสำหรับการมีเด็กเป็นกลุ่มเป้าหมาย)}

พารามิเตอร์มีเด็กเป็นกลุ่มเป้าหมายจะยอมรับค่าคงที่ซึ่งติดแท็กคำขอโฆษณาเป็นการดูแลให้เหมาะสมกับเด็ก

ตัวอย่างการใช้งาน

tfcd=1

trt

_{(ประเภทการเข้าชม)}

พารามิเตอร์ประเภทการเข้าชมจะยอมรับค่าคงที่ซึ่งทำหน้าที่ขอการเข้าชมที่ซื้อมาหรือการเข้าชมจากการค้นหาทั่วไป

IMA SDK จะไม่ป้อนค่าเริ่มต้นหากไม่มีพารามิเตอร์ประเภทการเข้าชมจากคำขอ ในกรณีเหล่านี้ เซิร์ฟเวอร์จะให้ค่าเริ่มต้นเป็น 0 (การเข้าชมที่ไม่ได้กำหนดค่า)

ตัวอย่างการใช้งาน

คำขอสำหรับการเข้าชมที่ซื้อมา:
trt=1

คำขอสำหรับการเข้าชมจากการค้นหาทั่วไป:
trt=2

unviewed_position_start

_{(การแสดงผลที่ล่าช้า)}

พารามิเตอร์การแสดงผลที่ล่าช้าจะยอมรับค่าคงที่เพื่อระบุการแสดงผลที่ล่าช้าของวิดีโอ

ตัวอย่างการใช้งาน

unviewed_position_start=1

ข้อกำหนด

ต้องระบุ ต้องใช้สำหรับเว็บและแอป

URL

_(URL)

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

สำหรับหน้าเว็บ นี่คือ URL ของหน้าที่แสดงโปรแกรมเล่นวิดีโอ หากคุณใช้ IMA SDK ระบบจะตั้งค่าของ URL โดยอัตโนมัติ หากโปรแกรมเล่นตั้งค่านี้ไว้ IMA SDK จะยึดตามค่าดังกล่าว

ค่านี้ควรตั้งเป็น URL ที่แสดงได้อย่างถูกต้องที่สุดถึงพื้นที่โฆษณาวิดีโอหรือเสียงที่ใช้สร้างรายได้ในแอป (อุปกรณ์เคลื่อนที่หรือ CTV) เช่น หากผู้ใช้ดูวิดีโอในแอปบนอุปกรณ์เคลื่อนที่ ซึ่งก็สามารถดูบนคอมพิวเตอร์เดสก์ท็อปได้ด้วยโดยใช้ URL ที่เทียบเท่า*

ค่าของพารามิเตอร์นี้ควรเข้ารหัสไว้

ตัวอย่างการใช้งาน

url=https%3A%2F%2Fwww.videoad.com%2Fgolf.html

* สําหรับแอป หากไม่สามารถตั้งพารามิเตอร์นี้เป็นค่า URL ตัวแปร ขอแนะนำให้ตั้งเป็นรูปแบบดังนี้
url=https%3A%2F%2F<app/bundleid>.adsenseformobileapps.com

ความต้องการ

ต้องระบุ ต้องใช้สำหรับเว็บและแอป

แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม

vad_type

_{(ประเภทโฆษณาวิดีโอ)}

พารามิเตอร์ประเภทโฆษณาวิดีโอจะยอมรับค่าคงที่ซึ่งจะระบุว่าควรแสดงโฆษณาแบบเชิงเส้นหรือโฆษณาที่ไม่ใช่แบบเชิงเส้น

ตัวอย่างการใช้งาน

แสดงโฆษณาแบบเชิงเส้น
vad_type=linear

แสดงโฆษณาที่ไม่ใช่แบบเชิงเส้น
vad_type=nonlinear

vid_d

_{(ระยะเวลาวิดีโอ)}

พารามิเตอร์นี้จะยอมรับค่าตัวแปรซึ่งระบุระยะเวลาของเนื้อหาในหน่วยมิลลิวินาที

ตัวอย่างการใช้งาน

เนื้อหาวิดีโอมีระยะเวลา 90,000 วินาที (25 ชั่วโมง)
vid_d=90000

vconp

_{(การเล่นวิดีโอแบบต่อเนื่อง)}

แนะนำตามหลักเกณฑ์การวัดผลวิดีโอของ MRC

พารามิเตอร์วิดีโอต่อเนื่องจะยอมรับค่าคงที่ซึ่งระบุว่าวิดีโอเพลเยอร์จะเล่นเนื้อหาวิดีโออย่างต่อเนื่องคล้ายกับการออกอากาศทางทีวีหรือไม่

ควรปล่อยพารามิเตอร์นี้ไว้โดยไม่ตั้งค่าหากไม่ทราบ

ตัวอย่างการใช้งาน

เปิดการเล่นต่อเนื่อง:
vconp=2

ปิดการเล่นต่อเนื่อง:
vconp=1

vpa

_{(การเล่นวิดีโออัตโนมัติ)}

แนะนำตามหลักเกณฑ์การวัดผลวิดีโอของ MRC

พารามิเตอร์เล่นวิดีโออัตโนมัติจะยอมรับค่าคงที่ ซึ่งระบุว่าเนื้อหาวิดีโอในโฆษณาจะเริ่มต้นผ่านการเล่นอัตโนมัติหรือการคลิก

หากต้องการให้หน้าเว็บรอการดำเนินการจากผู้ใช้ ให้ตั้งเป็น click หรือหากต้องการให้เริ่มเล่นโดยอัตโนมัติ ให้ตั้งเป็น auto

ควรปล่อยพารามิเตอร์นี้ไว้โดยไม่ตั้งค่าหากไม่ทราบ

ตัวอย่างการใช้งาน

เล่นอัตโนมัติ:
vpa=auto

คลิกเพื่อเล่น:
vpa=click

ข้อกำหนด

แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม

vpi

_{(เพลย์ลิสต์วิดีโอเปลี่ยนเส้นทางภายใน)}

พารามิเตอร์เพลย์ลิสต์วิดีโอเปลี่ยนเส้นทางภายในจะยอมรับค่าคงที่ซึ่งใช้ระบุว่าจะแสดง VMAP ในหน้า (แสดง VAST ใน VMAP) หรือไม่

พารามิเตอร์นี้ใช้เพื่อลดเวลาในการตอบสนอง รวมถึงรับประกันความถี่สูงสุดและการยกเว้นโฆษณาของคู่แข่งในสตรีมวิดีโอได้

ตัวอย่างการใช้งาน

แสดง VAST:
vpi=1

แสดงการเปลี่ยนเส้นทาง:
vpi=0

vpmute

_{(การเล่นวิดีโอแบบปิดเสียง)}

แนะนำตามหลักเกณฑ์การวัดผลวิดีโอของ MRC

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

ตัวอย่างการใช้งาน

ปิดเสียง
vpmute=1

เปิดเสียง
vpmute=0

ความต้องการ

ต้องระบุ ต้องใช้สำหรับเว็บและการสร้างรายได้แบบเป็นโปรแกรม

vpos

_{(ตำแหน่งวิดีโอ)}

พารามิเตอร์ตำแหน่งวิดีโอจะยอมรับค่าคงที่ซึ่งระบุว่าคำขอโฆษณานั้นส่งจากโฆษณาตอนต้น โฆษณาตอนกลาง หรือโฆษณาตอนท้าย

ตัวอย่างการใช้งาน

โฆษณาตอนต้น
vpos=preroll

โฆษณาตอนกลาง
vpos=midroll

โฆษณาตอนท้าย
vpos=postroll

ข้อกำหนด

แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม

wta

_{(ทำไมจึงแสดงโฆษณานี้)}

การตั้งค่า "ทำไมจึงแสดงโฆษณานี้" จะยอมรับค่าคงที่ซึ่งบ่งชี้ถึงการรองรับของวิดีโอเพลเยอร์สำหรับการติดป้ายระบุว่าเป็นโฆษณา หากไม่ได้ส่งพารามิเตอร์ &wta ค่าเริ่มต้นจะเป็น &wta=1

ระบบจะรองรับฟังก์ชันการติดป้ายระบุว่าเป็นโฆษณาโดยอัตโนมัติเมื่อใช้ IMA SDK หากไม่ได้ใช้ IMA SDK วิดีโอเพลเยอร์ต้องพัฒนาการรองรับ Icon และ IconClickFallbackImage ของ VAST ตามที่ระบุไว้ในมาตรฐาน VAST ของ IAB

ผู้เผยแพร่โฆษณาต้องส่ง &wta=0 หากผู้เผยแพร่โฆษณาจะไม่แสดงผลไอคอนตัวเลือกโฆษณาอื่นๆ ตามที่ระบุไว้ในการตอบกลับด้วย VAST คำขอโฆษณาที่มีพารามิเตอร์ &wta=1 หรือไม่มี &wta ได้รับการตีความว่าผู้เผยแพร่โฆษณาจะแสดงผลข้อมูลตัวเลือกโฆษณาอื่นๆ ที่ระบุ

คำขอโฆษณาเสียงอาจส่ง wta=1 หากไอคอนตัวเลือกโฆษณาอื่นๆ จะแสดงบนโฆษณาที่แสดงร่วมหรือแสดงต่อผู้ใช้ ตามที่ระบุไว้ในการตอบกลับด้วย VAST

สําหรับการเข้าชมจาก EEA คําขอที่มี &wta=0 จะไม่มีสิทธิ์แสดงครีเอทีฟโฆษณาแบบจองที่เปิดใช้การติดป้ายของ Google

โฆษณาของคุณจะต้องเป็นไปตามข้อบังคับที่เกี่ยวข้องสำหรับโฆษณาที่แสดงในเขตเศรษฐกิจยุโรป (EEA) ซึ่งรวมถึงกลไกสำหรับผู้ใช้ในการรายงานเนื้อหาผิดกฎหมาย ผู้เผยแพร่โฆษณาต้องแจ้งให้ Google ทราบเกี่ยวกับรายงานเนื้อหาผิดกฎหมายโดยใช้แบบฟอร์มที่เหมาะสม

ตัวอย่างการใช้งาน

รองรับ

wta=1 หรือไม่ใช้พารามิเตอร์ wta

ไม่รองรับ
wta=0

ข้อกำหนด

ต้องระบุ ต้องใช้สำหรับ Ad Exchange

ต้องระบุ ต้องใช้สำหรับการดูแลการแสดงโฆษณาใน EEA จากเว็บและแอป

แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม

ข้อมูลนี้มีประโยชน์ไหม

เราจะปรับปรุงได้อย่างไร