เอกสารนี้ให้คำแนะนำที่ครอบคลุมเกี่ยวกับวิธีสร้างโฆษณาแบนเนอร์ X สำหรับประเภทตำแหน่งที่แตกต่างกัน โฆษณาแบนเนอร์ X ถูกสร้างขึ้นบน /bannerx เอนพอยต์ คำขอแบนเนอร์ x ทั้งหมดต้องมี contentStandardId และการ bannerSlotIds ที่คุณกำลังขอโฆษณาให้ คำขอ API แต่ละรายการต้องมีรายละเอียดเกี่ยวกับบริบทเช่น:
- ตำแหน่ง
- ID แคตตาล็อก
- customerId
- sessionId
- คำค้นหา
- จำนวนโฆษณาสูงสุดที่จะแสดง
ตำแหน่งการค้นหา
ข้อกําหนดเบื้องต้น
คุณต้องทำตามขั้นตอนต่อไปนี้ก่อนที่จะเริ่มขอโฆษณาผลิตภัณฑ์สำหรับตำแหน่งการค้นหา
1. เพิ่มแคตตาล็อกผลิตภัณฑ์
ตรวจสอบให้แน่ใจว่าได้เพิ่มผลิตภัณฑ์ของคุณลงในแค็ตตาล็อกและซิงค์กับ Epsilon Retail Media Platform แล้ว สำหรับข้อมูลเพิ่มเติม โปรดดูที่ ข้อมูลเบื้องต้นเกี่ยวกับแค็ตตาล็อกและผลิตภัณฑ์
2. สร้างแคมเปญและกำหนดค่าคำค้นหา
ตรวจสอบให้แน่ใจว่าคุณได้สร้างแคมเปญและกำหนดคำค้นหาแล้ว สำหรับรายละเอียดเพิ่มเติม โปรดดู ขั้นตอนที่ 4b: กำหนดค่าคำค้นหา กำหนดคำค้นหาที่คุณต้องการกำหนดเป้าหมาย (รวมและยกเว้น) สำหรับโฆษณาผลิตภัณฑ์ของคุณ คุณสามารถระบุการค้นหาแบบตรงกันทุกคำ แบบตรงวลีที่ค้นหา และแบบคำค้นหาเชิงลบสำหรับโฆษณาของคุณ
3. ดึงคีย์ API และ URL ฐาน
-
คุณต้องมีคีย์ API ที่ถูกต้อง หากต้องการดึงข้อมูลคีย์ API ให้ทำดังต่อไปนี้:
-
ลงชื่อเข้าใช้บัญชีทีม Retail Media ของ Epsilon
-
ไปที่มุมขวาบนของหน้าแล้วคลิกเมนูแบบเลื่อนลง
-
เลือก การตั้งค่าการรวม จากเมนูแบบเลื่อนลง
-
คลิกที่แท็บคีย์ API รหัส API ลับของคุณถูกซ่อนไว้ในตอนแรก หากต้องการดู ให้คลิกที่ปุ่มแสดง เมื่อมองเห็นได้ ให้คัดลอกคีย์ API ลับของคุณ ใช้คีย์นี้เพื่อเรียก API
-
-
คุณต้องมี URL ฐานสำหรับเอนพอยต์ API ตัวอย่างเช่น https://staging-test.citrusad.com/v1/ads/generate HTTP/1.1 ตรวจสอบ URL ฐานกับผู้จัดการบัญชีทางเทคนิคของคุณ
สร้างโฆษณา
ทำตามขั้นตอนต่อไปนี้เพื่อสร้างโฆษณาผลิตภัณฑ์
คำขอ HTTP
เอนพอยต์: /v1/ads/generate
วิธีการ: POST
ส่วนหัว:
- ยอมรับ: application/json
- ประเภทเนื้อหา: application/json
- การอนุญาต: พื้นฐาน <API_KEY>
ขอพารามิเตอร์
เนื้อหาของคำขอควรเป็นออบเจ็กต์ JSON ที่มีฟิลด์ต่อไปนี้:
| วัตถุ | ประเภท | คำอธิบาย |
|---|---|---|
| customerId | สตริง, จำเป็น | ตัวระบุที่ไม่ซ้ำกันสำหรับลูกค้า ข้อมูลนี้จัดทำโดยผู้ค้าปลีกของคุณ |
| sessionId | สตริง, จำเป็น | ตัวระบุเฉพาะสําหรับเซสชัน ข้อมูลนี้จำเป็นสำหรับการระบุแหล่งที่มาและจัดเตรียมโดยผู้ค้าปลีก |
| ID มาตรฐานเนื้อหา | สตริง, จำเป็น | รหัสมาตรฐานเนื้อหาสำหรับแบนเนอร์ X ของคุณ |
| bannerSlotIds | สตริง, จำเป็น | รหัสช่องของแบนเนอร์ X ของท่าน |
| ตำแหน่ง | สตริง, จำเป็น | บริบทที่โฆษณาแสดง (เช่น "การค้นหา") |
| ID แคตตาล็อก | สตริง, จำเป็น | ตัวระบุที่ไม่ซ้ำกันสำหรับแค็ตตาล็อกผลิตภัณฑ์ที่มีการกรองผลิตภัณฑ์ คุณสามารถรับ CatalogID ได้จาก Retail Media UI ของ Epsilon หรือจากผู้ค้าปลีก |
| maxNumberOfAds | จํานวนเต็ม จําเป็น | จำนวนโฆษณาสูงสุดที่จะแสดง เมื่อขอโฆษณาแบนเนอร์ x คุณสามารถระบุจำนวนแบนเนอร์สูงสุดที่คุณต้องการได้รับต่อช่องแบนเนอร์ คุณสามารถควบคุมสิ่งนี้ได้ด้วย maxNumberOfAds พารามิเตอร์ |
| คำค้นหา | สตริง จำเป็นสำหรับตำแหน่งการค้นหา | คําที่จะค้นหาภายในแค็ตตาล็อก |
| ตัวเลือก | วัตถุ ไม่บังคับ | ตัวเลือกเพิ่มเติม เช่น โหมดการกรอง AndOrหากระบุ ระบบจะใช้ทั้งเงื่อนไข "AND" และ "OR" เพื่อจำกัดผลการค้นหาให้แคบลง |
ตัวอย่างคำขอ
ตำแหน่งการค้นหามักจะง่ายที่สุดที่จะขอ พวกเขาต้องการ searchTerm ระบุไว้ในคำขอ ดังตัวอย่างด้านล่าง:
POST $BASE_URL/v1/ads/bannerx HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
"customerId": "wertg5432a",
"sessionId": "ec9-4e07-881d-3e9",
"placement": "search",
"catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
"searchTerm": "chocolate",
"options": {
"filterMode": "AndOr"
},
"contentStandardId": "c61941e2-1435-460b-9d2b-5d838e3dba9c",
"bannerSlotIds": [
{
"slotId": "<SLOT_ID>",
"maxNumberOfAds": 1
},
{
"slotId": "<SLOT_ID>",
"maxNumberOfAds": 2
}
]
}
ตำแหน่งหมวดหมู่
ต้องระบุตําแหน่งประเภท productFilters ระบุไว้ในคำขอ ตัวอย่างด้านล่างแสดงตำแหน่งที่คุณจะส่งตัวกรองหมวดหมู่:
POST $BASE_URL/v1/ads/bannerx HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
"customerId": "wertg5432a",
"sessionId": "ec9-4e07-881d-3e9",
"placement": "category",
"catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
"productFilters": [
["category:Cupboard/Snacks"]
],
"options": {
"filterMode": "AndOr"
},
"contentStandardId": "fec2ab89-7a29-42b5-b58a-5675688b52d9",
"bannerSlotIds": [
{
"slotId": "<SLOT_ID>",
"maxNumberOfAds": 1
},
{
"slotId": "<SLOT_ID>",
"maxNumberOfAds": 2
}
}
เนื่องจากมีการอ่านหมวดหมู่เพิ่มเติม คุณควรอัปเดตการเรียก API ของคุณตามลำดับ
ตําแหน่งหมวดหมู่การขายพ่วง
ตำแหน่งหมวดหมู่ขายพ่วงมีคำขอที่คล้ายกันมากกับตำแหน่งหมวดหมู่ คุณจะต้องระบุหมวดหมู่ที่แน่นอนที่คุณต้องการขอโฆษณา โดยทั่วไปจะเป็นหน้าที่คุณกำลังดูอยู่ ระบุหมวดหมู่ใน productFilters ของคำขอ ตัวอย่างด้านล่างแสดงตำแหน่งที่คุณจะส่งตัวกรองหมวดหมู่:
POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
"customerId": "wertg5432a",
"sessionId": "ec9-4e07-881d-3e9",
"placement": "category-cross-sell",
"catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
"productFilters": [
["category:Cupboard/Snacks"]
],
"options": {
"filterMode": "AndOr"
},
"contentStandardId": "fec2ab89-7a29-42b5-b58a-5675688b52d9",
"bannerSlots": [
{
"slotId": "<SLOT_ID>",
"maxNumberOfAds": 1
},
{
"slotId": "<SLOT_ID>",
"maxNumberOfAds": 2
}
],
"maxNumberOfAds": 3
}
เนื่องจากมีการอ่านหมวดหมู่เพิ่มเติม คุณต้องอัปเดตการเรียก API ของคุณตามลำดับ
การรวมการกำหนดเป้าหมายตามหมวดหมู่ทั่วไปและการขายต่อเนื่องเข้าด้วยกันใช่หรือไม่
หากคุณต้องการรวมคำขอโฆษณาหมวดหมู่ทั่วไปและแบบขายพ่วงไว้ในตำแหน่งเดียว คุณจะต้องใช้ตรรกะการรวมและการจัดส่งกับลูกค้าของคุณ นี่เป็นความรับผิดชอบของผู้ผสานรวมระบบ แม้ว่า Epsilon Retail Media ยินดีที่จะให้คำปรึกษา
โดยทั่วไป เราขอแนะนำให้คุณแสดงโฆษณาหมวดหมู่ทั่วไป และโฆษณาขายพ่วงตำแหน่งและหมวดหมู่หลังจากตำแหน่งทั่วไป
ตําแหน่งการทํางานแบบกว้าง
ตำแหน่งกว้างๆ เช่น หน้าแรกหรือหน้าชำระเงิน ไม่จำเป็นต้องมี productFilters ระบุไว้ในคำขอ ตัวกรองใดๆ ที่ผู้ค้าปลีกต้องการระบุ (ตามข้อเสนอ ใหม่ ฯลฯ) สามารถระบุได้ใน productFilters เพื่อให้แน่ใจว่า Epsilon Retail Media แสดงเฉพาะโฆษณาภายในข้อกำหนด เช่นตัวอย่างด้านล่าง:
POST $BASE_URL/v1/ads/bannerx HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
"customerId": "wertg5432a",
"sessionId": "ec9-4e07-881d-3e9",
"placement": "home",
"catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
"productFilters": [
[]
],
"options": {
"filterMode": "AndOr"
},
"contentStandardId": "fec2ab89-7a29-42b5-b58a-5675688b52d9",
"bannerSlotIds": [
{
"slotId": "<SLOT_ID>",
"maxNumberOfAds": 1
},
{
"slotId": "<SLOT_ID>",
"maxNumberOfAds": 2
}
}
ขอการปรับปรุง
เราขอแนะนำให้คุณพิจารณาการปรับปรุงด้านล่างเพื่อปรับปรุงประสบการณ์ผู้ใช้ของคุณ
การค้นหาที่กรองแล้ว
หากลูกค้าของคุณกรองการค้นหา คุณสามารถขยายบริบทของคุณเพื่อระบุ productFiltersด้านล่างคือตัวอย่างที่ลูกค้ากรองตามหมวดหมู่ "ตู้" และข้อจำกัดด้านอาหาร "ปราศจากกลูเตน" หลักการเดียวกันนี้สามารถนำไปใช้กับหมวดหมู่หรือตำแหน่งการทำงานแบบกว้างใดก็ได้
POST $BASE_URL/v1/ads/bannerx HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
"customerId": "wertg5432a",
"sessionId": "ec9-4e07-881d-3e9",
"placement": "search",
"catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
"searchTerm": "chocolate",
"productFilters": [
["category:Cupboard"],["dietary:Gluten-free"]
],
"options": {
"filterMode": "AndOr"
},
"contentStandardId": "fec2ab89-7a29-42b5-b58a-5675688b52d9",
"bannerSlotIds": [
{
"slotId": "<SLOT_ID>",
"maxNumberOfAds": 1
},
{
"slotId": "<SLOT_ID>",
"maxNumberOfAds": 2
}
}
การกรองตามตําแหน่งที่ตั้ง
หากคุณกำลังซิงค์ตัวกรองตำแหน่งที่ตั้งในแค็ตตาล็อกของคุณ คุณสามารถขยายบริบทของคุณเพื่อระบุตำแหน่งที่ตั้งร้านค้าของลูกค้าใน productFiltersเช่นตัวอย่างด้านล่าง:
POST $BASE_URL/v1/ads/bannerx HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
"customerId": "wertg5432a",
"sessionId": "ec9-4e07-881d-3e9",
"placement": "search",
"catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
"searchTerm": "chocolate",
"productFilters": [
["category:Cupboard"],["dietary:Gluten-free"],["location:Westenbury"]
],
"options": {
"filterMode": "AndOr"
},
"contentStandardId": "fec2ab89-7a29-42b5-b58a-5675688b52d9",
"bannerSlotIds": [
{
"slotId": "<SLOT_ID>",
"maxNumberOfAds": 1
},
{
"slotId": "<SLOT_ID>",
"maxNumberOfAds": 2
}
}
การตอบสนองแบนเนอร์ X
คำตอบทั้งหมดเป็นไปตามรูปแบบ JSON เดียวกัน เนื้อหาทั้งหมดที่จำเป็นในการแสดงแบนเนอร์มีให้ในการตอบกลับ หากแบนเนอร์ไม่มีการกำหนดค่าองค์ประกอบ (เช่น ไม่มีภาพฮีโร่รอง) Epsilon Retail Media จะไม่ให้บริการคุณสมบัติ
{
"ads": [
{
"contentStandardId": "c619d1e2-1435-460b-9d2b-5d838e3dba9c",
"slotId": "<SLOT_ID>",
"banners": [
{
"citrusAdId": "shotgun__vW5pOojxDfN7T9VwaXWQLF2wKw3NzE0MTA3",
"citrusCampaignName": "CitrusAd-Example-Category-Banner-X-Ad-52793b405f1347b22e72a38c5a08699b",
"citrusContentStandardId": "c619d1e2-1435-460b-9d2b-5d838e3dba9c",
"citrusSlotId": "<SLOT_ID>",
"citrusExpiry": "2021-05-17T02:47:52.849995214Z",
"headingText": "Banner Advertisement for Magnum Double Ice Cream with a product image and shop now button",
"bannerText": "<strong>Magnum Double Ice Cream</strong>",
"bannerTextColour": "6e6c6c",
"ctaFlag": true,
"ctaText": "Shop now",
"ctaTextAccessibility": "for Magnum products",
"ctaLink": "https://www.tesco.com/groceries/en-GB/search?query=magnums",
"backgroundColour": "e1d6ac",
"heroImage": "https://cdn.flavedo.io/s/9b93e7f9-d747-4c8b-bcba-2357b280a3b3",
"heroImageAltText": "Magnums",
"tags": {},
"gtins": [
"7714107",
"7733636",
"7733657",
"7163379",
"7733628"
],
"position": 1
}
]
},
{
"contentStandardId": "c619d1e2-1435-460b-9d2b-5d838e3dba9c",
"slotId": "<SLOT_ID>",
"banners": [
{
"citrusAdId": "shotgun_kZp9yTCMm71vTo7iyQaK9I_YB09FUFYzNzBTQ0FO",
"citrusCampaignName": "milo-campaign-lakjsdf09kj",
"citrusContentStandardId": "21r372ba-dce6-46f2-bd16-1b923b9189f9",
"citrusSlotId": "<SLOT_ID>",
"citrusExpiry": "2021-05-17T02:47:52.849995214Z",
"headingText": "A banner for Milo with a product image and a shop now button",
"bannerText": "<strong>Try Milo Cereal</strong>",
"bannerTextColour": "48a94c",
"heroImage": "https://assets.imageurl.io/s/85d2d333-eed5-44d7-b131-8851d59f0574",
"heroImageAltText": "Milo product image",
"ctaFlag": true,
"ctaText": "Shop now",
"ctaTextAccessibility": "for Milo products",
"ctaLink": "retailer.com/everything/search/heritage%20mill?pageNumber=1",
"secondaryHeroImage": "https://assets.imageurl.io/s/85d2d333-eed5-44d7-b131-8m435c34r",
"secondaryHeroImageAltText": "Milo Logo",
"secondaryHeroMode": "landscape",
"backgroundColour": "895b5b",
"backgroundImage": "https://assets.flavedo.io/s/9c6fa248-c5ff-4341-9833-7e2b08464ada",
"backgroundImagePosition": "FILL",
"secondaryBackgroundImage": "https://assets.flavedo.io/s/9c6fa248-c5ff-4341-9833-7e2b08464ada",
"tags": {},
"gtins": [
"16309011",
"57312011",
"65250011"
],
"position": 1
}
]
}
]
}
AD_ID id ฟิลด์ id คือ ID โฆษณาของคุณที่ใช้ในรายงานการแสดงผลและการคลิก โปรดดูข้อมูลอ้างอิงสำหรับข้อมูลเพิ่มเติมเกี่ยวกับแต่ละสตริง
แท็กติดตามของบุคคลที่สาม
สำหรับโฆษณาแบนเนอร์ X, Epsilon Retail Media รองรับการส่งต่อแท็กติดตามของบุคคลที่สามไปยังผู้ค้าปลีก ผู้โฆษณาใช้แท็กเหล่านี้เพื่อยืนยันประสิทธิภาพโดยบุคคลที่สามที่เชื่อถือได้
Epsilon Retail Media รองรับแท็กติดตามด้านล่าง:
- DoubleVerify (จาวาสคริปต์และรูปภาพ)
- DCM Click
- DCM Impression
- IAS
- การสร้างผล Adform
- คลิก Adform
หากแคมเปญมีการกำหนดค่าแท็กติดตาม แท็กจะแสดงเป็นฟิลด์ที่เกี่ยวข้องใน trackingTags วัตถุด้านล่าง โปรดทราบว่าหากแคมเปญไม่มีการกำหนดค่าแท็ก tagsและ trackingTags วัตถุจะยังคงว่างเปล่า
{
"ads": [
{
"contentStandardId": "c619d1e2-1435-460b-9d2b-5d838e3dba9c",
"slotId": "<SLOT_ID>",
"banners": [
{
"citrusAdId": "shotgun__vW5pOojxDfN7T9VwaXWQLF2wKw3NzE0MTA3",
"citrusCampaignName": "CitrusAd-Example-Category-Banner-X-Ad-52793b405f1347b22e72a38c5a08699b",
"citrusContentStandardId": "c619d1e2-1435-460b-9d2b-5d838e3dba9c",
"citrusSlotId": "<SLOT_ID>",
"citrusExpiry": "2021-05-17T02:47:52.849995214Z",
"headingText": "Banner Advertisement for Magnum Double Ice Cream with a product image and shop now button",
"bannerText": "<strong>Magnum Double Ice Cream</strong>",
"bannerTextColour": "6e6c6c",
"ctaFlag": true,
"ctaText": "Shop now",
"ctaTextAccessibility": "for Magnum products",
"ctaLink": "https://www.tesco.com/groceries/en-GB/search?query=magnums",
"backgroundColour": "e1d6ac",
"heroImage": "https://cdn.flavedo.io/s/9b93e7f9-d747-4c8b-bcba-2357b280a3b3",
"heroImageAltText": "Magnums",
"tags": {},
"trackingTags": {
"ADFORM_CLICK": "https://track.adform.net...",
"ADFORM_IMPRESSION": "<img src=\"https://track.adform.net...",
"DCM_CLICK": "https://ad.doubleclick.net/ddm/trackclk/...",
"DCM_IMPRESSION": "<IMG SRC=\"https://ad.doubleclick.net/ddm/trackimp/...",
"DV": "<script src=\"https://cdn.doubleverify.com/dvtp_src.js?ctx=...",
"DV_IMAGE": "<img src=\"https://tps.doubleverify.com/visit.jpg?ctx=..."
},
"gtins": [
"7714107",
"7733636",
"7733657",
"7163379",
"7733628"
],
"position": 1
}
]
}
]
}
เนื่องจาก Epsilon Retail Media เป็นการผสานรวมแบบ Server-to-Server แท็กการติดตามจากบุคคลที่สามจึงต้องมีการพัฒนาเพิ่มเติมโดยผู้ค้าปลีก กรุณาติดต่อผู้จัดการโปรแกรมการผสานรวมระบบ (IPM) ของคุณ หากคุณต้องการใช้ฟีเจอร์นี้
tagsวัตถุสำหรับแท็ก DoubleVerify (Javascript) และ DCM คุณอาจเห็น
tagsวัตถุที่ถูกสร้างเช่นกัน แนวทางปฏิบัติที่ดีที่สุดคือการใช้trackingTagsการตอบกลับ
โฆษณาวิดีโอ
หากแคมเปญมีการกำหนดค่าโฆษณาวิดีโอ การตอบสนองจะรวมถึง admออบเจกต์สามารถดูได้ด้านล่าง:
{
"ads": [
{
"contentStandardId": "c47c9ca2-ad3b-48cc-880b-e899c1661726",
"slotId": "Top_Banner",
"banners": [
{
"citrusAdId": "shotgun_8SvgA7OvvuwtZkkOKR0vr8AXMvQKFgoURmluZ2VybGltZTI2LWZkeHZxMjcSABoMCO30r70GEKPplJQCIgIIAQ==",
"citrusCampaignName": "Ads:74-330-96832622ed499dafb3da8de8b76340a2",
"citrusContentStandardId": "c47c9ca2-ad3b-48cc-880b-e899c1661726",
"citrusSlotId": "Top_Banner",
"citrusExpiry": "2025-02-12T01:33:33.579155107Z",
"headingText": "recusandae 3205",
"bannerText": "placeat 2825",
"bannerTextColour": "ffffff",
"ctaFlag": true,
"ctaText": "CTA text",
"ctaTextAccessibility": "call to action accessibility text",
"ctaLink": http://citrusad.com ,
"backgroundColour": "000000",
"backgroundImage": https://dev3.flavedo.io./citrus/8de07ed9-60b4-4611-8bd5-3f1f0c0b6be4,
"secondaryBackgroundImage": https://dev3.flavedo.io./citrus/b7a70785-1366-42c6-8134-c7fe47a30c34,
"secondaryBackgroundImagePosition": "rightaligned",
"heroImage": https://dev3.flavedo.io./citrus/26798ca9-1022-422d-9100-1a3687c88372,
"heroImageAltText": "hero image alt text",
"secondaryHeroImage": https://dev3.flavedo.io./citrus/c4ee18b4-bf51-44d7-9eb6-eeb1dc4c422f,
"secondaryHeroImageAltText": "secondary hero image alt text",
"secondaryHeroMode": "landscape",
"tags": {},
"additionalFields": [
{
"id": "text-1",
"value": "sed 5731"
}
],
"gtins": [
"Fingerlime26-fdxvq27",
"Oranges5-qgxeb6",
"Cherries9-adkoj11",
"Incaberries20-ppscn21",
"Banana14-simfk15"
],
"sellerId": "seller_id_772_659",
"position": 1,
"metadata": {
"advertiserInfo": {
"advertiser": "Bob's advertising agency",
"onBehalfOf": "Brand company inc"
}
},
"adm": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<VAST version=\"4.0\">\n <Ad id=\"1\">\n <InLine>\n <AdSystem>CitrusAd</AdSystem>\n <Impression><![CDATA[https://integration.BASE-URL.citrusad.com/v1/resource/first-i/shotgun_2DbJUbTdlM3HFvLuF75YoA2FgpwKBQoDMTIzEgAaCwjHsuG_BhD7sqZzIgIIAQ==]]></Impression>\n <ViewableImpression>\n <Viewable><![CDATA[https://integration.BASE-URL.citrusad.com/v1/resource/first-i/shotgun_2DbJUbTdlM3HFvLuF75YoA2FgpwKBQoDMTIzEgAaCwjHsuG_BhD7sqZzIgIIAQ==]]></Viewable>\n <NotViewable></NotViewable>\n <ViewUndetermined></ViewUndetermined>\n </ViewableImpression>\n <AdTitle>VAST-4.0-Short-Intro.mp4</AdTitle>\n <Creatives>\n <Creative>\n <UniversalAdId idRegistry=\"http://citrusad.com \" idValue=\"VAST-4.0-Short-Intro.mp4\">VAST-4.0-Short-Intro.mp4</UniversalAdId>\n <Linear>\n <Duration></Duration>\n <MediaFiles>\n <MediaFile delivery=\"progressive\" type=\"video/mp4\" width=\"0\" height=\"0\" bitrate=\"0\" codec=\"\"><![CDATA[https://cdn.flavedo.io./citrus/VAST-4.0-Short-Intro.mp4]]></MediaFile>\n <Mezzanine><![CDATA[https://cdn.flavedo.io./citrus/VAST-4.0-Short-Intro.mp4]]></Mezzanine>\n </MediaFiles>\n <VideoClicks>\n <ClickTracking><![CDATA[https://integration.BASE-URL.citrusad.com/v1/resource/second-c/shotgun_2DbJUbTdlM3HFvLuF75YoA2FgpwKBQoDMTIzEgAaCwjHsuG_BhD7sqZzIgIIAQ==]]></ClickTracking>\n <ClickThrough><![CDATA[a/a-national/everything/browse]]></ClickThrough>\n </VideoClicks>\n </Linear>\n </Creative>\n </Creatives>\n </InLine>\n </Ad>\n</VAST>"
}
]
}
]
}
ผลิตภัณฑ์เสริม
หากแคมเปญมีการกำหนดค่าผลิตภัณฑ์เสริม การตอบสนองจะรวมถึง companionProductsอาร์เรย์ของออบเจกต์ดังที่เห็นด้านล่างนี้:
{
"ads": [
{
"contentStandardId": "c47c9ca2-ad3b-48cc-880b-e899c1661726",
"slotId": "Top_Banner",
"banners": [
{
"citrusAdId": "shotgun_8SvgA7OvvuwtZkkOKR0vr8AXMvQKFgoURmluZ2VybGltZTI2LWZkeHZxMjcSABoMCO30r70GEKPplJQCIgIIAQ==",
"citrusCampaignName": "Ads:74-330-96832622ed499dafb3da8de8b76340a2",
"citrusContentStandardId": "c47c9ca2-ad3b-48cc-880b-e899c1661726",
"citrusSlotId": "Top_Banner",
"citrusExpiry": "2025-02-12T01:33:33.579155107Z",
"headingText": "recusandae 3205",
"bannerText": "placeat 2825",
"bannerTextColour": "ffffff",
"ctaFlag": true,
"ctaText": "CTA text",
"ctaTextAccessibility": "call to action accessibility text",
"ctaLink": http://citrusad.com,
"backgroundColour": "000000",
"backgroundImage": https://dev3.flavedo.io./citrus/8de07ed9-60b4-4611-8bd5-3f1f0c0b6be4,
"secondaryBackgroundImage": https://dev3.flavedo.io./citrus/b7a70785-1366-42c6-8134-c7fe47a30c34,
"secondaryBackgroundImagePosition": "rightaligned",
"heroImage": https://dev3.flavedo.io./citrus/26798ca9-1022-422d-9100-1a3687c88372,
"heroImageAltText": "hero image alt text",
"secondaryHeroImage": https://dev3.flavedo.io./citrus/c4ee18b4-bf51-44d7-9eb6-eeb1dc4c422f,
"secondaryHeroImageAltText": "secondary hero image alt text",
"secondaryHeroMode": "landscape",
"tags": {},
"additionalFields": [
{
"id": "text-1",
"value": "sed 5731"
}
],
"gtins": [
"Fingerlime26-fdxvq27",
"Oranges5-qgxeb6",
"Cherries9-adkoj11",
"Incaberries20-ppscn21",
"Banana14-simfk15"
],
"sellerId": "seller_id_772_659",
"position": 1,
"metadata": {
"advertiserInfo": {
"advertiser": "Bob's advertising agency",
"onBehalfOf": "Brand company inc"
}
},
“companionProducts”: [
"Banana14-simfk15"
"Oranges5-qgxeb6",
"Incaberries20-ppscn21",
]
}
]
}
]
}
รหัสผู้ขายในตลาด
หากเป็นผู้ขายในตลาด คุณอาจเห็นเพิ่มเติม sellerId ต่อโฆษณาในการตอบกลับ ซึ่งจะปรากฏขึ้นก็ต่อเมื่อทีมที่เป็นเจ้าของแคมเปญที่กำลังให้บริการมีรหัสผู้ขายที่กำหนดค่าไว้ใน UI ตัวอย่างด้านล่างแสดงโฆษณาหนึ่งรายการที่มี sellerId อีกรายการไม่มี
{
"ads": [
{
"contentStandardId": "c619d1e2-1435-460b-9d2b-5d838e3dba9c",
"slotId": "<SLOT_ID>",
"banners": [
{
"citrusAdId": "shotgun__vW5pOojxDfN7T9VwaXWQLF2wKw3NzE0MTA3",
"citrusCampaignName": "CitrusAd-Example-Category-Banner-X-Ad-52793b405f1347b22e72a38c5a08699b",
"citrusContentStandardId": "c619d1e2-1435-460b-9d2b-5d838e3dba9c",
"citrusSlotId": "<SLOT_ID>",
"citrusExpiry": "2021-05-17T02:47:52.849995214Z",
"headingText": "Banner Advertisement for Magnum Double Ice Cream with a product image and shop now button",
"bannerText": "<strong>Magnum Double Ice Cream</strong>",
"bannerTextColour": "6e6c6c",
"ctaFlag": true,
"ctaText": "Shop now",
"ctaTextAccessibility": "for Magnum products",
"ctaLink": "https://www.retailer.com/groceries/en-GB/search?query=magnums",
"backgroundColour": "e1d6ac",
"heroImage": "https://cdn.flavedo.io/s/9b93e7f9-d747-4c8b-bcba-2357b280a3b3",
"heroImageAltText": "Magnums",
"tags": {},
"gtins": [
"7714107",
"7733636",
"7733657",
"7163379",
"7733628"
],
"position": 1,
"sellerId": "1ben32-ss3d43-amea"
}
]
},
{
"contentStandardId": "c619d1e2-1435-460b-9d2b-5d838e3dba9c",
"slotId": "<SLOT_ID>",
"banners": [
{
"citrusAdId": "shotgun_kZp9yTCMm71vTo7iyQaK9I_YB09FUFYzNzBTQ0FO",
"citrusCampaignName": "milo-campaign-lakjsdf09kj",
"citrusContentStandardId": "21r372ba-dce6-46f2-bd16-1b923b9189f9",
"citrusSlotId": "<SLOT_ID>",
"citrusExpiry": "2021-05-17T02:47:52.849995214Z",
"headingText": "A banner for Milo with a product image and a shop now button",
"bannerText": "<strong>Try Milo Cereal</strong>",
"bannerTextColour": "48a94c",
"heroImage": "https://assets.imageurl.io/s/85d2d333-eed5-44d7-b131-8851d59f0574",
"heroImageAltText": "Milo product image",
"ctaFlag": true,
"ctaText": "Shop now",
"ctaTextAccessibility": "for Milo products",
"ctaLink": "retailer.com/everything/search/heritage%20mill?pageNumber=1",
"secondaryHeroImage": "https://assets.imageurl.io/s/85d2d333-eed5-44d7-b131-8m435c34r",
"secondaryHeroImageAltText": "Milo Logo",
"secondaryHeroMode": "landscape",
"backgroundColour": "895b5b",
"backgroundImage": "https://assets.flavedo.io/s/9c6fa248-c5ff-4341-9833-7e2b08464ada",
"backgroundImagePosition": "FILL",
"secondaryBackgroundImage": "https://assets.flavedo.io/s/9c6fa248-c5ff-4341-9833-7e2b08464ada",
"tags": {},
"gtins": [
"16309011",
"57312011",
"65250011"
],
"position": 1
}
]
}
]
}
แท็กติดตามของบุคคลที่สาม
Epsilon Retail Media รองรับการส่งต่อแท็กติดตามของบุคคลที่สามไปยังผู้ค้าปลีก ผู้โฆษณาใช้แท็กเหล่านี้เพื่อยืนยันประสิทธิภาพโดยบุคคลที่สามที่เชื่อถือได้
Epsilon Retail Media รองรับแท็กติดตามด้านล่าง:
- DoubleVerify
- DCM Click
- DCM Impression
- IAS
หากแคมเปญมีการกำหนดค่าแท็กติดตาม แท็กจะแสดงเป็นฟิลด์ที่เกี่ยวข้องใน tags วัตถุด้านล่าง โปรดทราบว่าหากแคมเปญไม่มีการกำหนดค่าแท็ก tags วัตถุจะยังคงว่างเปล่า
{
"ads": [],
"banners": [
{
"id": "banner_XeemTeq59HapGSp4vccOYfBq_yvc3zMzNjM2",
"contentStandardId": "fec2ab89-7a29-42b5-b58a-5675688b52d9",
"slotId": "<SLOT_ID>",
"imageUrl": "https://cdn.flavedo.io/s/-oW-C3cEViSSO2krWkwOBUXOhvUdhHOySx-YQLGZ1lA=",
"linkUrl": "https://www.retailer.com/link",
"altText": "Your local ice cream",
"text": "",
"gtins": [
"7733628",
"7714107",
"7163379",
"7733636",
"7733657"
],
"expiry": "2021-05-17T01:49:17.75503253Z",
"tags": {
"dv": "<script src=\"https://cdn.doubleverify.com/dvtp_src.js?ctx=919421&cmp=1074060503&sid=1073907024&plc=1075810393&adsrv=115&btreg=&btadsrv=&crt=&tagtype=&dvtagver=6.1.src\" type=\"text/javascript\"></script>",
"dcmClick": "<script ..../>",
"dcmImpression": "<script.... />",
"ias": "<script.... />" }
}
],
"products": [],
"memoryToken":"85ykKVv-luDHMWLZx2d6xcPq6sF7CgkJCSJDb3VudGVyIjogIjIiLAoJCQkiQWRzIjogWwoJCQkJImRpc3BsYXlfV05VV0NwQkRKMUpKNm5wdVZSVExvOU40TUxzNE1UWTBOemt5TWc9PSIsCgkJCQkiZGlzcGxheV9MME5NUHRxNmdCcVFvREJOd3J0dE9UTGJoWk0xTVRFeU9UYzRPUT09IiwKCQkJCSJkaXNwbGF5XzlCcEpmdUpaWk9VXzgyaWpFM3VCczgxd3VVczRNekkwTnpVeE5nPT0iLAoJCQkJImRpc3BsYXlfcW1VU1p4TkpMQ0lqeWQwdTFJRDk0RmxVZ0pnNE16STBOelV4Tnc9PSIsCgkJCQkiZGlzcGxheV9oeHlFZktCUnRrNWlxMThMQzE1SDJHcEN3QjgxTVRFeU9UYzVNQT09IiwKCQkJCSJkaXNwbGF5X1NkcjFEcU5aUEFtcGh0Q1FIUndoYUxFT1B0RXhNamsxT1RJNE5BPT0iLAoJCQkJImRpc3BsYXlfeVlSai1qV2Ntc2ozNzhrel9PMm0yOVlwTjhJeE5EazNPRE00TXc9PSIsCgkJCQkiZGlzcGxheV9Xbm9NZGZuLTRTVmhxcF9xQzVvLWxoT0paNm8xTkRJeE1UUTROdz09IgoJCQldLAoJCQkiVFRMIjogMTYyODk4NTYwMAoJCX0="
}
เนื่องจาก Epsilon Retail Media เป็นการผสานรวมแบบ Server-to-Server แท็กการติดตามของบุคคลที่สามจึงต้องมีการพัฒนาเพิ่มเติมโดยผู้ค้าปลีก
พระราชบัญญัติว่าด้วยบริการดิจิทัล
Epsilon Retail Media ช่วยผู้ค้าปลีกในการปฏิบัติตามข้อกำหนดของ พระราชบัญญัติบริการดิจิทัล (DSA) ของสหภาพยุโรป (EU) DSA กำหนดกฎเกณฑ์ที่เป็นหนึ่งเดียวทั่วทั้งสหภาพยุโรป โดยมุ่งเป้าไปที่การควบคุมเนื้อหาออนไลน์ การโฆษณาที่โปร่งใส และข้อมูลเท็จ สำหรับข้อมูลเพิ่มเติม โปรดดู พระราชบัญญัติบริการดิจิทัล
ตัวอย่างคำขอโฆษณา
{
"catalogId": "57a5318b-5349-46fd-80ed-fd2e0be15819",
"contentStandardId": "c47c9ca2-ad3b-48cc-880b-e899c1661726",
"bannerSlotIds": [
{
"slotId": "Top_Banner",
"maxNumberOfAds": 1
}
],
"customerId": "velit3193",
"placement": "broad-display-60e9699d-984f-4a80-9383-2e6dc7a68d03",
"options": {
"includeAdvertiserInfo": true
}
}
ตัวอย่างการตอบสนองของโฆษณา
{
"ads": [
{
"contentStandardId": "c47c9ca2-ad3b-48cc-880b-e899c1661726",
"slotId": "Top_Banner",
"banners": [
{
"citrusAdId": "shotgun_8SvgA7OvvuwtZkkOKR0vr8AXMvQKFgoURmluZ2VybGltZTI2LWZkeHZxMjcSABoMCO30r70GEKPplJQCIgIIAQ==",
"citrusCampaignName": "Ads:74-330-96832622ed499dafb3da8de8b76340a2",
"citrusContentStandardId": "c47c9ca2-ad3b-48cc-880b-e899c1661726",
"citrusSlotId": "Top_Banner",
"citrusExpiry": "2025-02-12T01:33:33.579155107Z",
"headingText": "recusandae 3205",
"bannerText": "placeat 2825",
"bannerTextColour": "ffffff",
"ctaFlag": true,
"ctaText": "CTA text",
"ctaTextAccessibility": "call to action accessibility text",
"ctaLink": "http://citrusad.com",
"backgroundColour": "000000",
"backgroundImage": "https://dev3.flavedo.io./citrus/8de07ed9-60b4-4611-8bd5-3f1f0c0b6be4",
"secondaryBackgroundImage": "https://dev3.flavedo.io./citrus/b7a70785-1366-42c6-8134-c7fe47a30c34",
"secondaryBackgroundImagePosition": "rightaligned",
"heroImage": "https://dev3.flavedo.io./citrus/26798ca9-1022-422d-9100-1a3687c88372",
"heroImageAltText": "hero image alt text",
"secondaryHeroImage": "https://dev3.flavedo.io./citrus/c4ee18b4-bf51-44d7-9eb6-eeb1dc4c422f",
"secondaryHeroImageAltText": "secondary hero image alt text",
"secondaryHeroMode": "landscape",
"tags": {},
"additionalFields": [
{
"id": "text-1",
"value": "sed 5731"
}
],
"gtins": [
"Fingerlime26-fdxvq27",
"Oranges5-qgxeb6",
"Cherries9-adkoj11",
"Incaberries20-ppscn21",
"Banana14-simfk15"
],
"sellerId": "seller_id_772_659",
"position": 1,
"metadata": {
"advertiserInfo": {
"advertiser": "Bob's advertising agency",
"onBehalfOf": "Brand company inc"
}
}
}
]
}
]
}