ข้อมูลอ้างอิงโฆษณาแบนเนอร์ (คงที่)

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

📘
มีการร้องขอโฆษณาแบนเนอร์บน /generate เอนพอยต์เป็นโฆษณาผลิตภัณฑ์ สามารถใช้คำขอเดียวเพื่อเรียกดูโฆษณาทั้งสองประเภท

รายการที่ร้องขอ

สตริง	คำอธิบาย	จำเป็นต้องใช้/ไม่บังคับ
`bannerSlots`	อาร์เรย์ของช่องแบนเนอร์ที่คุณต้องการรับโฆษณาแบนเนอร์ให้ เมื่อระบุ maxNumberOfAds สำหรับช่องแบนเนอร์ คุณสามารถเรียกดูมากกว่าหนึ่งแบนเนอร์สำหรับช่อง กรณีการใช้งานดังกล่าวจะใช้สำหรับตำแหน่งแบบหมุน	ต้องระบุ
`bannerSlotIds`	อาร์เรย์ของช่องแบนเนอร์ที่คุณต้องการรับโฆษณาแบนเนอร์ให้	จําเป็น แทนที่ด้วย bannerSlots
`catalogId`	ตัวระบุแคตตาล็อกผลิตภัณฑ์สำหรับเว็บไซต์ของคุณ	ต้องระบุ
`contentStandardId`	ตัวระบุมาตรฐานเนื้อหาสำหรับเว็บไซต์ของคุณ	ต้องระบุ
`customerId`	ตัวระบุที่ไม่ซ้ำสำหรับลูกค้าเห็นโฆษณา	ไม่บังคับ
`filterMode`	ทางเลือกในการกำหนดโครงสร้างคำขอของคุณ ดูข้อมูลเพิ่มเติมที่การกรองการสร้างโฆษณา	ไม่บังคับ, ที่ต้องการ
`maxNumberOfAds`	จำนวนโฆษณาผลิตภัณฑ์สูงสุดที่คุณต้องการส่งคืนสูงสุด 15 รายการ	จำเป็น เปิดใช้งานโฆษณาผลิตภัณฑ์ในคำขอเดียวกัน หากไม่ต้องการโฆษณาผลิตภัณฑ์ ให้ตั้งค่าเป็น `0`
`options`	ทางเลือกในการกำหนดโครงสร้างคำขอของคุณ ดูข้อมูลเพิ่มเติมที่การกรองการสร้างโฆษณา	ไม่บังคับ, ที่ต้องการ
`placement`	ตําแหน่งการจัดวางที่ไม่ซ้ํากันที่คุณขอโฆษณา	ต้องระบุ
`productFilters`	ตัวกรองผลิตภัณฑ์ใดๆ ที่เกี่ยวข้องกับคำขอของคุณ เช่น หมวดหมู่ สถานที่ หรือขนาด	ต้องระบุ
`sessionId`	ตัวระบุที่ไม่ซ้ำของเซสชันของลูกค้า ใช้สำหรับการระบุแหล่งที่มาในการผสานการทำงานมาตรฐาน ตรวจสอบ ตัวเลือกเวิร์กโฟลว์การรวม สำหรับข้อมูลเพิ่มเติม	จำเป็นสำหรับการผสานการทำงานแบบมาตรฐาน
`dtmCookieId`	คุกกี้ที่สร้างและจัดเก็บโดยเว็บไซต์ใช้เพื่อติดตามพฤติกรรมของผู้ใช้บนโดเมนเดียวกัน	ไม่บังคับ

รายการที่ส่งคืน

สตริง	คำอธิบาย	ค่าตัวอย่าง
`altText`	ข้อความแสดงแทนสำหรับภาพฮีโร่ในกรณีที่แทบไม่เกิดขึ้นที่ข้อความไม่แสดง	`Advertisement for <BRAND>. Art of the Burger. Create your delicious masterpiece. Shop Now.`
`contentStandardId`	ตัวระบุมาตรฐานเนื้อหาสำหรับเว็บไซต์ของคุณ	`4ffb80ba-b9a9-4567-8069-79b2eca93473
`expiry`	การหมดอายุของโฆษณา นี่คือจุดล่าสุดที่สามารถรายงานการคลิกไปยัง CitrusAd	`2021-06-01T23:48:16.573967987Z`
`id`	รหัสที่ไม่ซ้ํากันของโฆษณา เป็นรหัสที่ไม่ซ้ำกันสำหรับคำขอแต่ละรายการที่ทำกับ CitrusAd และไม่สามารถแคชได้	`banner_j2vfi9pN2BiQZk4X9sC55PgNu5k3ODIzOTlfMDAwODc2ODQwMDEwNzM=`
`imageUrl`	ลิงก์ภาพของแบนเนอร์	`[<https://cdn.[server].io/s/9b93e7f9-d747-4c8b-bcba-2357b280a3b3`>](https://cdn.[server].io/s/9b93e7f9-d747-4c8b-bcba-2357b280a3b3`)
`gtins`	อาร์เรย์รหัสผลิตภัณฑ์สูงสุด 20 รหัสที่เลือกจากผลิตภัณฑ์ที่โฆษณาของแคมเปญ	`[ "7714107", "7163379", "7733636", "7733657", "7733628" ],`
`linkUrl`	URL ที่ส่งต่อจากแบนเนอร์เมื่อลูกค้าคลิกแบนเนอร์	`<https://www.retailer.com/groceries/en-GB/search?query=double-fudge`>
`slotId`	รหัสของช่องเฉพาะสำหรับแบนเนอร์ที่คุณร้องขอ	`Category_Top`
`tags`	ฟิลด์นี้ส่งคืนแท็กของบุคคลที่สามที่ป้อนโดยผู้โฆษณาในแคมเปญของตน	`{ "dv": "<script src=\"<https://cdn.doubleverify.com/dvtp_src.js?ctx=111111&cmp=11111111&sid=111111&plc=111111&adsrv=111&btreg=&btadsrv=&crt=&tagtype=&dvtagver=6.1.src\>" type=\"text/javascript\"></script>" }`
`text`	ใช้ในการผสานการทำงานที่ระบุเป็นฟิลด์ข้อความเพิ่มเติม
`position`	ตำแหน่งของโฆษณาในการตอบกลับ CitrusAd คุณควรรักษาตำแหน่งนี้ไว้ในกรณีที่มีการใช้แคมเปญผู้เช่าคงที่	1
`sellerId`	รหัสเฉพาะของผู้ขาย จะเติมก็ต่อเมื่อมีการตั้งค่ารหัสผู้ขายในทีม มักใช้รหัสผู้ขายเมื่อแนะนำการใช้งานผู้ขายในตลาด	`73nns-32sxr-32ss` กําหนดเองต่อการผสานการทํางาน