The below outlines the properties possible in a standard request as outlined in Requesting banner ads for your request, and the response if you receive an ad.
มีการขอโฆษณาแบนเนอร์ที่เอ็นพอยต์
/generateเดียวกันกับโฆษณาผลิตภัณฑ์ สามารถใช้คำขอเดียวเพื่อเรียกดูโฆษณาทั้งสองประเภท
รายการที่ร้องขอ
| สตริง | คำอธิบาย | จำเป็นต้องใช้/ไม่บังคับ |
|---|---|---|
bannerSlots | อาร์เรย์ของช่องแบนเนอร์ที่คุณต้องการรับโฆษณาแบนเนอร์ให้ เมื่อระบุ maxNumberOfAds สำหรับช่องแบนเนอร์ คุณสามารถเรียกดูมากกว่าหนึ่งแบนเนอร์สำหรับช่อง กรณีการใช้งานดังกล่าวจะใช้สำหรับตำแหน่งแบบหมุน | ต้องระบุ |
bannerSlotIds | อาร์เรย์ของช่องแบนเนอร์ที่คุณต้องการรับโฆษณาแบนเนอร์ให้ | จําเป็น แทนที่ด้วย bannerSlots |
catalogId | ตัวระบุแคตตาล็อกผลิตภัณฑ์สำหรับเว็บไซต์ของคุณ | ต้องระบุ |
contentStandardId | ตัวระบุมาตรฐานเนื้อหาสำหรับเว็บไซต์ของคุณ | ต้องระบุ |
customerId | ตัวระบุที่ไม่ซ้ำสำหรับลูกค้าเห็นโฆษณา | ไม่บังคับ |
filterMode | Optional way of defining the structure of your request. See Ad generation filtering for more information. | ไม่บังคับ, ที่ต้องการ |
maxNumberOfAds | จำนวนโฆษณาผลิตภัณฑ์สูงสุดที่คุณต้องการส่งคืนสูงสุด 15 รายการ | จำเป็น เปิดใช้งานโฆษณาผลิตภัณฑ์ในคำขอเดียวกัน หากไม่ต้องการโฆษณาผลิตภัณฑ์ ให้ตั้งค่าเป็น 0 |
options | Optional way of defining the structure of your request. See Ad generation filtering for more information. This is also the object where you can request advertiser information in order to comply with local advertising legislation like Europe’s Digital Services Act . | ไม่บังคับ, ที่ต้องการ |
placement | ตําแหน่งการจัดวางที่ไม่ซ้ํากันที่คุณขอโฆษณา | ต้องระบุ |
productFilters | ตัวกรองผลิตภัณฑ์ใดๆ ที่เกี่ยวข้องกับคำขอของคุณ เช่น หมวดหมู่ สถานที่ หรือขนาด | ต้องระบุ |
sessionId | The unique identifier of the customer's session. Used for attribution in standard integrations. Review Integration workflow options for more information. | จำเป็นสำหรับการผสานการทำงานแบบมาตรฐาน |
dtmCookieId | คุกกี้ที่สร้างและจัดเก็บโดยเว็บไซต์ใช้เพื่อติดตามพฤติกรรมของผู้ใช้บนโดเมนเดียวกัน | ไม่บังคับ |
audience | Specifies specific audience segments that the shopper belongs to. Only relevant is using Audience Targeting Option 3 | ไม่บังคับ |
รายการที่ส่งคืน
| สตริง | คำอธิบาย | ค่าตัวอย่าง |
|---|---|---|
banners.altText | ข้อความแสดงแทนสำหรับภาพฮีโร่ในกรณีที่แทบไม่เกิดขึ้นที่ข้อความไม่แสดง | Advertisement for <BRAND>. Art of the Burger. Create your delicious masterpiece. Shop Now. |
banners.contentStandardId | ตัวระบุมาตรฐานเนื้อหาสำหรับเว็บไซต์ของคุณ | `4ffb80ba-b9a9-4567-8069-79b2eca93473 |
banners.expiry | การหมดอายุของโฆษณา นี่คือจุดล่าสุดที่สามารถรายงานการคลิกไปยัง Epsilon Retail Media ได้ | 2021-06-01T23:48:16.573967987Z |
banners.id | รหัสที่ไม่ซ้ํากันของโฆษณา นี่เป็นข้อมูลเฉพาะสำหรับแต่ละคำขอที่ส่งไปยัง Epsilon Retail Media และไม่สามารถแคชได้ | banner_j2vfi9pN2BiQZk4X9sC55PgNu5k3ODIzOTlfMDAwODc2ODQwMDEwNzM= |
banners.imageUrl | ลิงก์ภาพของแบนเนอร์ | [<https://cdn.[server].io/s/9b93e7f9-d747-4c8b-bcba-2357b280a3b3>](https://cdn.[server].io/s/9b93e7f9-d747-4c8b-bcba-2357b280a3b3`) |
banners.gtins | อาร์เรย์รหัสผลิตภัณฑ์สูงสุด 20 รหัสที่เลือกจากผลิตภัณฑ์ที่โฆษณาของแคมเปญ | [ "7714107", "7163379", "7733636", "7733657", "7733628" ], |
banners.linkUrl | URL ที่ส่งต่อจากแบนเนอร์เมื่อลูกค้าคลิกแบนเนอร์ | <https://www.retailer.com/groceries/en-GB/search?query=double-fudge> |
banners.slotId | รหัสของช่องเฉพาะสำหรับแบนเนอร์ที่คุณร้องขอ | Category_Top |
banners.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>" } |
banners.text | ใช้ในการผสานการทำงานที่ระบุเป็นฟิลด์ข้อความเพิ่มเติม | |
banners.position | ตำแหน่งของโฆษณาในคำตอบของ Epsilon Retail Media คุณควรรักษาตำแหน่งนี้ไว้ในกรณีที่มีการใช้แคมเปญผู้เช่าคงที่ | 1 |
banners.sellerId | รหัสเฉพาะของผู้ขาย จะเติมก็ต่อเมื่อมีการตั้งค่ารหัสผู้ขายในทีม มักใช้รหัสผู้ขายเมื่อแนะนำการใช้งานผู้ขายในตลาด | 73nns-32sxr-32ss กําหนดเองต่อการผสานการทํางาน |
banners.metadata | Object containing the advertiser info required to help advertisers comply with local advertising legislation such as the Digital Services Act in Europe.
| "metadata": { "advertiserInfo": { "advertiser": "Bob's advertising agency", "onBehalfOf": "Brand company inc" } ... |
metadata.warnings | ออบเจ็กต์ที่มีข้อมูลคำเตือนเกี่ยวกับคำขอโฆษณา ในขณะนี้จะเตือนเฉพาะเมื่อจำนวนเซ็กเมนต์สูงสุดเกิน | "metadata": { "warnings": [ "Audience Segment IDs exceeded the limit of 100 and were truncated" ] } |