เอกสารนี้ให้คำแนะนำที่ครอบคลุมเกี่ยวกับวิธีการสร้างแบนเนอร์โฆษณา X สำหรับประเภทการจัดวางที่แตกต่างกัน โฆษณาแบนเนอร์ X ถูกสร้างขึ้นบนเอ็นพอยต์ /bannerx คำขอแบนเนอร์ X ทั้งหมดต้องใช้ contentStandardId และ bannerSlotIds ที่คุณต้องการขอโฆษณาให้ คำขอ API แต่ละรายการต้องมีรายละเอียดเกี่ยวกับบริบทเช่น:
- ตำแหน่ง
- ID แคตตาล็อก
- customerId
- sessionId
- คำค้นหา
- จำนวนโฆษณาสูงสุดที่จะแสดง
ตำแหน่งการค้นหา
ข้อกําหนดเบื้องต้น
คุณต้องทำตามขั้นตอนต่อไปนี้ก่อนที่จะเริ่มขอโฆษณาผลิตภัณฑ์สำหรับตำแหน่งการค้นหา
1. เพิ่มแคตตาล็อกผลิตภัณฑ์
Ensure that your products have been added to your catalogs and synced with the Epsilon Retail Media Platform. For more information, see Introduction to Catalogs and Products.
2. สร้างแคมเปญและกำหนดค่าคำค้นหา
Ensure that you have created a campaign and configured search terms. For more details, refer to Step 4b: Configure search terms. Define the search terms that you want to target (include and exclude) for your product ads. You can specify exact match, phrase match, and negative search terms for your ads.
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 | จํานวนเต็ม จําเป็น | Maximum number of ads to display. When requesting banner x ads, you're able to specify the maximum number of banners you would like to receive per banner slot. You can control this with the maxNumberOfAds parameter. |
| คำค้นหา | สตริง จำเป็นสำหรับตำแหน่งการค้นหา | คําที่จะค้นหาภายในแค็ตตาล็อก |
| ตัวเลือก | วัตถุ ไม่บังคับ | Additional options such as filtering modes AndOr. If specified, the system will use both "AND" and "OR" conditions to narrow down the search results. |
ตัวอย่างคำขอ
ตำแหน่งการค้นหามักจะง่ายที่สุดในการขอ โดยต้องระบุ 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
}
]
}
]
}ช่อง 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 assists retailers in meeting their European Union (EU) Digital Services Act (DSA) obligations. The DSA establishes a unified set of rules across the EU, targeting the regulation of online content, transparent advertising, and disinformation. For more information, see Digital Services Act.
ตัวอย่างคำขอโฆษณา
{
"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"
}
}
}
]
}
]
}