ด้านล่างนี้แสดงคุณสมบัติที่เป็นไปได้ในคำขอมาตรฐาน และการตอบสนองหากคุณได้รับโฆษณา
รายการที่ร้องขอ
| สตริง | คำอธิบาย | จำเป็นต้องใช้/ไม่บังคับ |
|---|---|---|
catalogId | ตัวระบุแคตตาล็อกผลิตภัณฑ์สำหรับเว็บไซต์ของคุณ | ต้องระบุ |
customerId | ตัวระบุที่ไม่ซ้ำสำหรับลูกค้าเห็นโฆษณา | ไม่บังคับ |
filterMode | Optional way of defining the structure of your request. See Ad generation filtering for more information. | ไม่บังคับ, ที่ต้องการ |
maxNumberOfAds | จำนวนโฆษณาสูงสุดที่คุณต้องการให้ส่งคืนสูงสุด 10 รายการ | ต้องระบุ |
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. | จำเป็นสำหรับการผสานการทำงานแบบมาตรฐาน |
memoryToken | Used for pagination. Use a token provided in a previous ad request to ensure Epsilon Retail Media only serves new ads to your customers. If provided, Epsilon Retail Media will exclude previously served ads in the ad response. Review Pagination to learn more. | ไม่บังคับ |
dtmCookieId | คุกกี้ที่สร้างและจัดเก็บโดยเว็บไซต์ใช้เพื่อติดตามพฤติกรรมของผู้ใช้บนโดเมนเดียวกัน | ไม่บังคับ |
audience | Specifies specific audience segments that the shopper belongs to. Only relevant is using Audience Targeting Option 3 | ไม่บังคับ |
รายการที่ส่งคืน
| สตริง | คำอธิบาย | ค่าตัวอย่าง |
|---|---|---|
ads.customPayload | เพย์โหลดแบบกำหนดเองนี้ควรถูกเธรดจากไฟล์แค็ตตาล็อกไปยังการสร้างโฆษณา ฟิลด์ควรมีอ็อบเจ็กต์ JSON ที่ถูกต้องที่ถูกทำให้เป็นอนุกรมในอาร์เรย์ไบต์และเข้ารหัส Base64 อ็อบเจ็กต์ JSON ควรเป็นไปตามสคีมา | กําหนดเองต่อการผสานการทํางาน |
ads.sellerId | รหัสเฉพาะของผู้ขาย จะเติมก็ต่อเมื่อมีการตั้งค่ารหัสผู้ขายในทีม มักใช้รหัสผู้ขายเมื่อแนะนำการใช้งานผู้ขายในตลาด | 73nns-32sxr-32ss กําหนดเองต่อการผสานการทํางาน |
ads.id | รหัสที่ไม่ซ้ํากันของโฆษณา นี่เป็นข้อมูลเฉพาะสำหรับแต่ละคำขอที่ส่งไปยัง Epsilon Retail Media และไม่สามารถแคชได้ | display_yCaCIy_kKaJnRnzrenBkVSytwr8yNTgxMzM4 |
ads.gtin | รหัสสินค้าของโฆษณา นี่จะเป็นรหัสผลิตภัณฑ์ที่ซิงโครไนซ์ในแค็ตตาล็อกผลิตภัณฑ์ของคุณ | 25813383 |
ads.discount | มรดกสามารถละเว้นได้ | { "amount": 0, "minPrice": 0, "maxPerCustomer": 0 } |
ads.position | ตำแหน่งของโฆษณาในคำตอบของ Epsilon Retail Media คุณควรรักษาตำแหน่งนี้ไว้ในกรณีที่มีการใช้แคมเปญผู้เช่าคงที่ | 1 |
ads.memoryToken | ใช้สำหรับให้เลขหน้าและเชื่อมโยงคำขอโฆษณา If provided in your next ad request for the same context, Epsilon Retail Media will exclude previously served ads in the ad response. Review Pagination to learn more. | |
ads.metadata | Object containing the advertiser info required to help advertisers comply with local advertising legislation such as the Digital Services Actin Europe.
| "metadata": { "advertiserInfo": { "advertiser": "Bob's advertising agency", "onBehalfOf": "Brand company inc" } ... |
banners | Comprises of banner objects. View the Banner ad (static) reference to learn more. | "banners": [], |
metadata.warnings | ออบเจ็กต์ที่มีข้อมูลคำเตือนเกี่ยวกับคำขอโฆษณา ในขณะนี้จะเตือนเฉพาะเมื่อจำนวนเซ็กเมนต์สูงสุดเกิน | "metadata": { "warnings": [ "Audience Segment IDs exceeded the limit of 100 and were truncated" ] |