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

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

แบ่งหน้าคําขอ

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

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

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ การแบ่งหน้า

ขอพารามิเตอร์

เนื้อหาของคำขอควรเป็นออบเจ็กต์ JSON ที่มีฟิลด์ต่อไปนี้:

วัตถุ	ประเภท	คำอธิบาย
รหัสลูกค้า	สตริง จำเป็น	ตัวระบุที่ไม่ซ้ำสำหรับลูกค้า ข้อมูลนี้จัดทำโดยผู้ค้าปลีกของคุณ
รหัสเซสชัน	สตริง จำเป็น	ตัวระบุเฉพาะสําหรับเซสชัน ข้อมูลนี้จำเป็นสำหรับการระบุแหล่งที่มาและจัดเตรียมโดยผู้ค้าปลีก
ตำแหน่ง	สตริง จำเป็น	บริบทที่โฆษณาแสดง (เช่น "การค้นหา")
catalogId	สตริง, จําเป็น	ตัวระบุที่ไม่ซ้ำกันสําหรับแค็ตตาล็อกผลิตภัณฑ์ที่มีการกรองผลิตภัณฑ์ คุณสามารถรับ CatalogID ได้จาก Retail Media UI ของ Epsilon หรือจากผู้ค้าปลีก
maxNumberOfAds	จำนวนเต็ม จำเป็น	จำนวนโฆษณาสูงสุดที่จะแสดง
คำค้นหา	สตริง จำเป็นสำหรับตำแหน่งการค้นหา	คำที่จะค้นหาภายในแค็ตตาล็อก
หน่วยความจำโทเค็น	สตริง จำเป็น	โทเค็นเพื่อยกเว้นโฆษณาที่แสดงก่อนหน้านี้
ตัวเลือก	ออบเจ็กต์ อุปกรณ์เสริม	ตัวเลือกเพิ่มเติม เช่น โหมดการกรอง `AndOr` หากระบุ ระบบจะใช้ทั้งเงื่อนไข "AND" และ "OR" เพื่อจํากัดผลการค้นหาให้แคบลง

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

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

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

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": "search",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "searchTerm": "chocolate",
    "memoryToken":"85ykKVv-luDHMWLZx2d6xcPq6sF7CgkJCSJDb3VudGVyIjogIjIiLAoJCQkiQWRzIjogWwoJCQkJImRpc3BsYXlfV05VV0NwQkRKMUpKNm5wdVZSVExvOU40TUxzNE1UWTBOemt5TWc9PSIsCgkJCQkiZGlzcGxheV9MME5NUHRxNmdCcVFvREJOd3J0dE9UTGJoWk0xTVRFeU9UYzRPUT09IiwKCQkJCSJkaXNwbGF5XzlCcEpmdUpaWk9VXzgyaWpFM3VCczgxd3VVczRNekkwTnpVeE5nPT0iLAoJCQkJImRpc3BsYXlfcW1VU1p4TkpMQ0lqeWQwdTFJRDk0RmxVZ0pnNE16STBOelV4Tnc9PSIsCgkJCQkiZGlzcGxheV9oeHlFZktCUnRrNWlxMThMQzE1SDJHcEN3QjgxTVRFeU9UYzVNQT09IiwKCQkJCSJkaXNwbGF5X1NkcjFEcU5aUEFtcGh0Q1FIUndoYUxFT1B0RXhNamsxT1RJNE5BPT0iLAoJCQkJImRpc3BsYXlfeVlSai1qV2Ntc2ozNzhrel9PMm0yOVlwTjhJeE5EazNPRE00TXc9PSIsCgkJCQkiZGlzcGxheV9Xbm9NZGZuLTRTVmhxcF9xQzVvLWxoT0paNm8xTkRJeE1UUTROdz09IgoJCQldLAoJCQkiVFRMIjogMTYyODk4NTYwMAoJCX0=",
    "options": {
                         "filterMode": "AndOr"
                             },
    "maxNumberOfAds": 3    
}

ตัวอย่างการตอบสนอง

การตอบกลับโฆษณาผลิตภัณฑ์ทั้งหมดเป็นไปตามรูปแบบ JSON มาตรฐาน โฆษณาผลิตภัณฑ์จะถูกส่งกลับในอาร์เรย์โฆษณา

id: รหัสโฆษณาที่ใช้ในรายงานการแสดงผลและการคลิก
GTIN: หมายเลขสินค้าการค้าสากลสำหรับผลิตภัณฑ์
ส่วนลด: รายละเอียดเกี่ยวกับส่วนลดใด ๆ ที่เกี่ยวข้องกับโฆษณา
- จำนวน: จำนวนส่วนลด
- minPrice: ราคาขั้นต่ำสำหรับส่วนลด
- maxPerCustomer: จำนวนสินค้าสูงสุดที่ลูกค้าสามารถซื้อพร้อมส่วนลด
หมดอายุ: วันที่และเวลาหมดอายุของโฆษณา
ตำแหน่ง: ตําแหน่งของโฆษณาในเพย์โหลดตอบกลับ อ่านและรับษาฟิลด์ตำแหน่งไว้เพื่อให้แน่ใจว่าตำแหน่งผู้เช่าคงที่ปรากฏอย่างถูกต้อง

{
    "ads": [
        {
            "id": "display_QqHaKRrKlFm1Wxr9c_DXJN4HSE3NzMzNjM2",
            "gtin": "7733636",
            "discount": {
                "amount": 0,
                "minPrice": 0,
                "maxPerCustomer": 0
            },
            "expiry": "2021-05-12T04:17:50.400902957Z",
            "position": 1
        },
        {
            "id": "display_NzsHqP0_iQedlo9VnrO2vqkwi_k3NzMzNjI4",
            "gtin": "7733628",
            "discount": {
                "amount": 0,
                "minPrice": 0,
                "maxPerCustomer": 0
            },
            "expiry": "2021-05-12T04:17:50.400908257Z",
            "position": 2
        },
        {
            "id": "display_xNeShqidaMuEqiJ0zNdt-Gzygjs3NzE0MTA3",
            "gtin": "7714107",
            "discount": {
                "amount": 0,
                "minPrice": 0,
                "maxPerCustomer": 0
            },
            "expiry": "2021-05-12T04:17:50.400912929Z",
            "position": 3
        },
        {
            "id": "display_3rGiryPskhQusmsf43nghbQwnqo3NzMzNjU3",
            "gtin": "7733657",
            "discount": {
                "amount": 0,
                "minPrice": 0,
                "maxPerCustomer": 0
            },
            "expiry": "2021-05-12T04:17:50.400917769Z",
            "position": 4
        }
    ],
    "banners": [],
    "products": [],
    "memoryToken":"85ykKVv-luDHMWLZx2d6xcPq6sF7CgkJCSJDb3VudGVyIjogIjIiLAoJCQkiQWRzIjogWwoJCQkJImRpc3BsYXlfV05VV0NwQkRKMUpKNm5wdVZSVExvOU40TUxzNE1UWTBOemt5TWc9PSIsCgkJCQkiZGlzcGxheV9MME5NUHRxNmdCcVFvREJOd3J0dE9UTGJoWk0xTVRFeU9UYzRPUT09IiwKCQkJCSJkaXNwbGF5XzlCcEpmdUpaWk9VXzgyaWpFM3VCczgxd3VVczRNekkwTnpVeE5nPT0iLAoJCQkJImRpc3BsYXlfcW1VU1p4TkpMQ0lqeWQwdTFJRDk0RmxVZ0pnNE16STBOelV4Tnc9PSIsCgkJCQkiZGlzcGxheV9oeHlFZktCUnRrNWlxMThMQzE1SDJHcEN3QjgxTVRFeU9UYzVNQT09IiwKCQkJCSJkaXNwbGF5X1NkcjFEcU5aUEFtcGh0Q1FIUndoYUxFT1B0RXhNamsxT1RJNE5BPT0iLAoJCQkJImRpc3BsYXlfeVlSai1qV2Ntc2ozNzhrel9PMm0yOVlwTjhJeE5EazNPRE00TXc9PSIsCgkJCQkiZGlzcGxheV9Xbm9NZGZuLTRTVmhxcF9xQzVvLWxoT0paNm8xTkRJeE1UUTROdz09IgoJCQldLAoJCQkiVFRMIjogMTYyODk4NTYwMAoJCX0="
}

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

ตัวอย่างที่มีรหัสผู้ขาย

{
    "ads": [
        {
            "id": "display_QqHaKRrKlFm1Wxr9c_DXJN4HSE3NzMzNjM2",
            "gtin": "7733636",
            "discount": {
                "amount": 0,
                "minPrice": 0,
                "maxPerCustomer": 0
            },
            "expiry": "2021-05-12T04:17:50.400902957Z",
            "position": 1
        },
        {
            "id": "display_NzsHqP0_iQedlo9VnrO2vqkwi_k3NzMzNjI4",
            "gtin": "7733628",
            "sellerId": "2834-ascre-2wcr4",
            "discount": {
                "amount": 0,
                "minPrice": 0,
                "maxPerCustomer": 0
            },
            "expiry": "2021-05-12T04:17:50.400908257Z",
            "position": 2
        }
    ],
    "banners": [],
    "products": [],
    "memoryToken":"85ykKVv-luDHMWLZx2d6xcPq6sF7CgkJCSJDb3VudGVyIjogIjIiLAoJCQkiQWRzIjogWwoJCQkJImRpc3BsYXlfV05VV0NwQkRKMUpKNm5wdVZSVExvOU40TUxzNE1UWTBOemt5TWc9PSIsCgkJCQkiZGlzcGxheV9MME5NUHRxNmdCcVFvREJOd3J0dE9UTGJoWk0xTVRFeU9UYzRPUT09IiwKCQkJCSJkaXNwbGF5XzlCcEpmdUpaWk9VXzgyaWpFM3VCczgxd3VVczRNekkwTnpVeE5nPT0iLAoJCQkJImRpc3BsYXlfcW1VU1p4TkpMQ0lqeWQwdTFJRDk0RmxVZ0pnNE16STBOelV4Tnc9PSIsCgkJCQkiZGlzcGxheV9oeHlFZktCUnRrNWlxMThMQzE1SDJHcEN3QjgxTVRFeU9UYzVNQT09IiwKCQkJCSJkaXNwbGF5X1NkcjFEcU5aUEFtcGh0Q1FIUndoYUxFT1B0RXhNamsxT1RJNE5BPT0iLAoJCQkJImRpc3BsYXlfeVlSai1qV2Ntc2ozNzhrel9PMm0yOVlwTjhJeE5EazNPRE00TXc9PSIsCgkJCQkiZGlzcGxheV9Xbm9NZGZuLTRTVmhxcF9xQzVvLWxoT0paNm8xTkRJeE1UUTROdz09IgoJCQldLAoJCQkiVFRMIjogMTYyODk4NTYwMAoJCX0="
}

การค้นหาที่กรองแล้ว

เมื่อลูกค้าใช้ตัวกรองในการค้นหา คุณสามารถปรับปรุงบริบทการสืบค้นของพวกเขาโดยใช้ productFilters วิธีนี้ช่วยให้คุณกําหนดเป้าหมายโฆษณาได้แม่นยํายิ่งขึ้นตามหมวดหมู่หรือแอตทริบิวต์ที่เฉพาะเจาะจง ด้านล่างนี้ เราแสดงตัวอย่างวิธีการกรองตามหมวดหมู่ "ตู้" และข้อจํากัดด้านอาหาร "ปราศจากกลูเตน" วิธีการนี้สามารถปรับให้เข้ากับหมวดหมู่ใดก็ได้หรือตําแหน่งการจับคู่แบบกว้าง

ขอพารามิเตอร์

เนื้อหาของคำขอควรเป็นออบเจ็กต์ JSON ที่มีฟิลด์ต่อไปนี้:

วัตถุ	ประเภท	คำอธิบาย
รหัสลูกค้า	สตริง จำเป็น	ตัวระบุที่ไม่ซ้ำสำหรับลูกค้า ข้อมูลนี้จัดทำโดยผู้ค้าปลีกของคุณ
รหัสเซสชัน	สตริง จำเป็น	ตัวระบุเฉพาะสําหรับเซสชัน ข้อมูลนี้จำเป็นสำหรับการระบุแหล่งที่มาและจัดเตรียมโดยผู้ค้าปลีก
ตำแหน่ง	สตริง จำเป็น	บริบทที่โฆษณาแสดง (เช่น "การค้นหา")
catalogId	สตริง, จําเป็น	ตัวระบุที่ไม่ซ้ำกันสําหรับแค็ตตาล็อกผลิตภัณฑ์ที่มีการกรองผลิตภัณฑ์ คุณสามารถรับ CatalogID ได้จาก Retail Media UI ของ Epsilon หรือจากผู้ค้าปลีก
maxNumberOfAds	จำนวนเต็ม จำเป็น	จำนวนโฆษณาสูงสุดที่จะแสดง
คำค้นหา	สตริง จำเป็นสำหรับตำแหน่งการค้นหา	คำที่จะค้นหาภายในแค็ตตาล็อก
ตัวกรองสินค้า	อาร์เรย์ จำเป็น	อาร์เรย์ที่มีตัวกรองหมวดหมู่
ตัวเลือก	ออบเจ็กต์ อุปกรณ์เสริม	ตัวเลือกเพิ่มเติม เช่น โหมดการกรอง `AndOr` หากระบุ ระบบจะใช้ทั้งเงื่อนไข "AND" และ "OR" เพื่อจํากัดผลการค้นหาให้แคบลง

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

คำขอตัวอย่างใช้วิธี HTTP POST เพื่อส่งออบเจ็กต์ JSON ไปยังปลายทางที่ระบุ อาร์เรย์ productFilters ระบุว่าการค้นหาควรกรองตามหมวดหมู่ "ตู้" และข้อจำกัดด้านอาหาร "ปราศจากกลูเตน" ออบเจ็กต์ตัวเลือกจะตั้งค่า filterMode เป็น AndOr เพื่อให้สามารถผสมผสานตัวกรองได้อย่างยืดหยุ่น ฟิลด์ maxNumberOfAds จำกัดจำนวนโฆษณาที่แสดงไม่เกินสามรายการ

เมื่อทําตามโครงสร้างนี้ คุณจะสามารถสร้างแคมเปญโฆษณาที่ตรงเป้าหมายโดยเกี่ยวข้องกับเกณฑ์การค้นหาของลูกค้ามากขึ้น ด้วยเหตุนี้จึงช่วยปรับปรุงประสบการณ์โดยรวมของผู้ใช้

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": "search",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "searchTerm": "chocolate",
    "productFilters": [
     	 ["category:Cupboard"],["dietary:Gluten-free"]
    ],
    "options": {
   							 "filterMode": "AndOr"
 							 },
    "maxNumberOfAds": 3
}

การกรองตามสถานที่

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

ขอพารามิเตอร์

เนื้อหาของคำขอควรเป็นออบเจ็กต์ JSON ที่มีฟิลด์ต่อไปนี้:

วัตถุ	ประเภท	คำอธิบาย
รหัสลูกค้า	สตริง จำเป็น	ตัวระบุที่ไม่ซ้ำสำหรับลูกค้า ข้อมูลนี้จัดทำโดยผู้ค้าปลีกของคุณ
รหัสเซสชัน	สตริง จำเป็น	ตัวระบุเฉพาะสําหรับเซสชัน ข้อมูลนี้จำเป็นสำหรับการระบุแหล่งที่มาและจัดเตรียมโดยผู้ค้าปลีก
ตำแหน่ง	สตริง จำเป็น	บริบทที่โฆษณาแสดง (เช่น "การค้นหา")
catalogId	สตริง, จําเป็น	ตัวระบุที่ไม่ซ้ำกันสําหรับแค็ตตาล็อกผลิตภัณฑ์ที่มีการกรองผลิตภัณฑ์ คุณสามารถรับ CatalogID ได้จาก Retail Media UI ของ Epsilon หรือจากผู้ค้าปลีก
maxNumberOfAds	จำนวนเต็ม จำเป็น	จำนวนโฆษณาสูงสุดที่จะแสดง
คำค้นหา	สตริง จำเป็นสำหรับตำแหน่งการค้นหา	คำที่จะค้นหาภายในแค็ตตาล็อก
ตัวกรองสินค้า	อาร์เรย์ จำเป็น	อาร์เรย์ที่มีตัวกรองหมวดหมู่
ตัวเลือก	ออบเจ็กต์ อุปกรณ์เสริม	ตัวเลือกเพิ่มเติม เช่น โหมดการกรอง `AndOr` หากระบุ ระบบจะใช้ทั้งเงื่อนไข "AND" และ "OR" เพื่อจํากัดผลการค้นหาให้แคบลง

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

คำขอตัวอย่างใช้วิธี HTTP POST เพื่อส่งออบเจ็กต์ JSON ไปยังปลายทางที่ระบุ

อาร์เรย์ productFilters ระบุว่าควรกรองการค้นหาตาม:
- หมวดหมู่: "ตู้"
- ข้อจำกัดด้านอาหาร: "ปราศจากกลูเตน"
- ที่ตั้ง: "เวสเทนเบอรี"
ออบเจ็กต์ตัวเลือกจะตั้งค่า filterMode เป็น AndOr เพื่อให้สามารถผสมผสานตัวกรองได้อย่างยืดหยุ่น
ฟิลด์ maxNumberOfAds จำกัดจำนวนโฆษณาที่แสดงไม่เกินสามรายการ

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": "search",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "searchTerm": "chocolate",
    "productFilters": [
     	 ["category:Cupboard"],["dietary:Gluten-free"],["location:Westenbury"]
    ],
    "options": {
   							 "filterMode": "AndOr"
 							 },
    "maxNumberOfAds": 3
}