เอกสารนี้ให้คำแนะนำที่ครอบคลุมเกี่ยวกับวิธีการสร้างโฆษณาผลิตภัณฑ์ตามหมวดหมู่ที่ระบุ คำขอ API แต่ละรายการจะต้องมีรายละเอียดเกี่ยวกับบริบทเช่น:

• customerId
• sessionId
• ตำแหน่ง
• ID แคตตาล็อก
• productFilters
• จำนวนโฆษณาสูงสุดที่จะแสดง

ข้อกําหนดเบื้องต้น

คุณต้องทำตามขั้นตอนต่อไปนี้ก่อนที่จะเริ่มขอโฆษณาผลิตภัณฑ์สำหรับตำแหน่งการค้นหา

เพิ่มแค็ตตาล็อกสินค้า

ตรวจสอบให้แน่ใจว่าได้เพิ่มผลิตภัณฑ์ของคุณลงในแค็ตตาล็อกและซิงค์กับ Epsilon Retail Media Platform แล้ว

สร้างแคมเปญและกำหนดหมวดหมู่

ตรวจสอบให้แน่ใจว่าคุณได้สร้างแคมเปญและกำหนดหมวดหมู่แล้ว สำหรับรายละเอียดเพิ่มเติม โปรดดูขั้นตอนที่ 4: กำหนดค่าเกณฑ์เป้าหมาย

ดึงคีย์ API และ URL ฐาน

1. คุณต้องมีคีย์ API ที่ถูกต้อง หากต้องการดึงข้อมูลคีย์ API ให้ทำดังต่อไปนี้:

   1. ลงชื่อเข้าใช้บัญชีทีม Retail Media ของ Epsilon

   2. ไปที่มุมขวาบนของหน้าแล้วคลิกเมนูแบบเลื่อนลง

   3. เลือก การตั้งค่าการรวม จากเมนูแบบเลื่อนลง

      

   4. คลิกที่แท็บคีย์ API รหัส API ลับของคุณถูกซ่อนไว้ในตอนแรก หากต้องการดู ให้คลิกที่ปุ่มแสดง เมื่อมองเห็นได้ ให้คัดลอกคีย์ API ลับของคุณ ใช้คีย์นี้เพื่อเรียก API

2. คุณต้องมี 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 ที่มีฟิลด์ต่อไปนี้: หากต้องการระบุตำแหน่งหมวดหมู่ ให้ทำดังนี้ productFilters จะต้องรวมอยู่ในเนื้อหาคำขอ

ตัวอย่างคำขอ

คำขอ JSON ใช้เพื่อระบุตำแหน่งหมวดหมู่สำหรับโฆษณาที่เกี่ยวข้องกับหมวดหมู่ "ตู้/ขนม" โดยประกอบด้วยรหัสลูกค้า รหัสเซสชัน รหัสแคตตาล็อก ตัวเลือกการกรอง และกำหนดจำนวนโฆษณาสูงสุดเป็น 3 รายการ

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",
    "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE",
    "placement": "category",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "productFilters": [
     	 ["category:Cupboard/Snacks"]
    ],
    "options": {
   							 "filterMode": "AndOr"
 							 },
    "maxNumberOfAds": 3
}

สร้างโฆษณาสำหรับตำแหน่งในหมวดหมู่ การขายต่อเนื่อง

ตำแหน่งหมวดหมู่การขายสิ่งที่เกี่ยวข้อง (Cross-sell) นั้นคล้ายคลึงกับตำแหน่งหมวดหมู่ปกติ แต่ใช้เพื่อกำหนดเป้าหมายโฆษณาสำหรับผลิตภัณฑ์เกี่ยวข้องที่จะขายโดยเฉพาะ ในสถานการณ์การซื้อสิ่งที่เกี่ยวข้อง คุณตั้งเป้าที่จะแนะนำผลิตภัณฑ์เสริมตามหมวดหมู่ปัจจุบันที่ผู้ใช้กำลังเรียกดู

คุณควรระบุหมวดหมู่ที่แน่นอนเพื่อสิ่งที่คุณต้องการสร้างโฆษณา โดยทั่วไปหมวดหมู่นี้จะเป็นหมวดหมู่ที่แสดงบนหน้าปัจจุบันที่ผู้ใช้กำลังเรียกดู

ตัวอย่างคำขอ

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",
    "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "productFilters": [
     	 ["category:Cupboard/Snacks"]
    ],
    "options": {
   							 "filterMode": "AndOr"
 							 },
    "maxNumberOfAds": 3
}

รวมการกำหนดเป้าหมายตามหมวดหมู่ทั่วไปและการขายต่อเนื่อง

หากคุณตั้งเป้าที่จะรวมโฆษณาแบบออร์แกนิค (โฆษณาที่เกี่ยวข้องกับหมวดหมู่ที่ผู้ใช้กำลังดู) กับโฆษณาการขายสิ่งที่เกี่ยวข้อง (โฆษณาสำหรับหมวดหมู่หรือผลิตภัณฑ์ที่เกี่ยวข้อง) ไว้ในตำแหน่งโฆษณาเดียว คุณจะต้องจัดการการผสานรวมโฆษณาเหล่านี้ด้วยตนเอง การดำเนินการนี้เกี่ยวข้องกับการเขียนตรรกะเพื่อรวมและแสดงโฆษณาทั้งสองประเภทเข้าด้วยกัน

แนวทางปฏิบัติที่ดีที่สุด:

• โฆษณาออร์แกนิกก่อน: แสดงโฆษณาที่เกี่ยวข้องกับหมวดหมู่ปัจจุบัน (โฆษณาออร์แกนิก) ก่อน
• โฆษณาขายสิ่งที่เกี่ยวข้องอันที่สอง: จากนั้นแสดงโฆษณาสำหรับหมวดหมู่หรือผลิตภัณฑ์ที่เกี่ยวข้อง (โฆษณาขายสิ่งที่เกี่ยวข้อง) หลังจากโฆษณาแบบออร์แกนิก

แนวทางปฏิบัติที่ดีที่สุดสำหรับการกำหนดเป้าหมายโฆษณาตามหมวดหมู่

เมื่อผู้ใช้ไปยังหมวดหมู่ต่างๆ จำเป็นอย่างยิ่งที่จะต้องอัปเดตการเรียก API ของคุณให้เป็นไปตามหมวดหมู่ปัจจุบันที่กำลังดูอยู่ เพื่อให้แน่ใจว่าโฆษณาที่แสดงยังคงเกี่ยวข้องกับบริบทการเรียกดูของผู้ใช้

ขอแนะนำให้ส่งหมวดหมู่ที่เฉพาะเจาะจงที่สุด (ระดับต่ำสุด) ในคำขอโฆษณาของคุณไปยังแพลตฟอร์ม Epsilon Retail Media การกำหนดเป้าหมายระดับหมวดหมู่ที่ลึกที่สุดจะทำให้แสดงโฆษณาที่เกี่ยวข้องและกำหนดเป้าหมายที่แม่นยำยิ่งขึ้นสำหรับผู้ใช้

ตัวอย่างสถานการณ์สมมติ

ผู้ใช้เริ่มเรียกดูหมวดหมู่ทั่วไป จากนั้นไปที่หมวดหมู่ย่อยที่เฉพาะเจาะจงมากขึ้น

การเรียก API เริ่มต้น

เมื่อผู้ใช้เรียกดูหมวดหมู่ "หน้าแรก":

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",
    "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE",
    "placement": "category",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "productFilters": [
     	 ["category:Home"]
    ],
    "options": {
   							 "filterMode": "AndOr"
 							 },
    "maxNumberOfAds": 3
}

อัปเดตการเรียก API

เมื่อผู้ใช้นำทางไปยังหมวดหมู่ย่อย " หน้าแรก > เฟอร์นิเจอร์":

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",
    "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE",
    "placement": "category",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "productFilters": [
     	 ["category:Home/Furniture"]
    ],
    "options": {
   							 "filterMode": "AndOr"
 							 },
    "maxNumberOfAds": 3
}

การเรียก API ขั้นสุดท้าย

เมื่อผู้ใช้ไปยังหมวดหมู่ย่อย "บ้าน > เฟอร์นิเจอร์ > เก้าอี้" เพิ่มเติม:

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",
    "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE",
    "placement": "category",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "productFilters": [
     	 ["category:Home/Furniture/Chairs"]
    ],
    "options": {
   							 "filterMode": "AndOr"
 							 },
    "maxNumberOfAds": 3
}

การอัปเดตการเรียก API ให้เป็นไปตามถหมวดหมู่ที่เฉพาะเจาะจงที่สุดตามที่ผู้ใช้กำลังดู จะช่วยให้มั่นใจได้ว่าโฆษณาที่แสดงมีความเกี่ยวข้องสูง ขอแนะนำให้ระบุระดับหมวดหมู่ที่ลึกที่สุด (L3) แทนที่จะระบุคำขอแบบลูกโซ่ในหลายระดับหมวดหมู่ (L1 + L2 + L3)

ขั้นตอนถัดไป

• สร้างโฆษณาผลิตภัณฑ์โดยใช้ตำแหน่งการค้นหา
• เพิ่มประสิทธิภาพการกำหนดเป้าหมายโฆษณา