API ของคู่ค้า
ข้อมูลอ้างอิง API

แคตตาล็อก & ผลิตภัณฑ์

หากต้องการผสานรวมกับ CitrusAd คุณจะต้องมีแคตตาล็อกผลิตภัณฑ์อย่างน้อยหนึ่งรายการ

แค็ตตาล็อกคืออะไร

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

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

คุณสามารถสร้างแค็ตตาล็อกหลายรายการเพื่อแบ่งกลุ่มความพร้อมจําหน่ายสินค้าในร้านค้าปลีกหรือประเทศต่างๆ เพื่อวัตถุประสงค์ในการกําหนดเป้าหมายแคมเปญ

📘

หากคุณต้องการสร้างแค็ตตาล็อกหลายรายการ โปรดติดต่อผู้จัดการบัญชีด้านเทคนิคของคุณเพื่อหารือเกี่ยวกับแนวทางปฏิบัติที่ดีที่สุด เนื่องจากอาจมีวิธีการสนับสนุนที่ดีกว่าในการใช้การกําหนดเป้าหมาย

🚧

หากคุณกำลังรวมเข้ากับเนมสเปซเครือข่าย คุณควรสร้างแค็ตตาล็อกเดียว

ผลิตภัณฑ์คืออะไร

ผลิตภัณฑ์คือ GTIN แต่ละรายการในเว็บไซต์ของผู้ผสานรวม ผลิตภัณฑ์ที่ซิงค์กับ CitrusAd จะซิงค์กับค่าที่ระบุและแอตทริบิวต์แต่ละรายการ ผลิตภัณฑ์ควรแสดงถึง GTIN/SKU แต่ละรายการในแคตตาล็อกผลิตภัณฑ์ปัจจุบันของคุณ

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

อธิบายตัวกรองผลิตภัณฑ์

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

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

ตัวอย่างบริบทที่มี 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": "search",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "searchTerm": "chocolate",
    "productFilters": [
         ["category:Cupboard"],["dietary:Gluten-free"]
    ],
    "options": {
                             "filterMode": "AndOr"
                             },
    "maxNumberOfAds": 3
}

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

📘

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

การให้ภาพและชื่อผลิตภัณฑ์

CitrusAd ต้องการข้อมูลเกี่ยวกับรูปภาพและชื่อผลิตภัณฑ์เพื่อให้สามารถค้นหาได้เมื่อสร้างแคมเปญในพอร์ทัล CitrusAd สามารถส่งค่าเหล่านี้ไปยัง CitrusAd ภายในแท็กที่มีรูปแบบดังตัวอย่างต่อไปนี้:

POST $BASE_URL/v1/catalog-products?teamId=<YOUR_TEAM_ID> HTTP/1.1 
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "catalogProducts": [
        {
            "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
            "gtin": "23556578965543",
            "inventory": 50,
            "price": "19.99",
            "tags": [
                 ""imageurl:https://your.image.host.com/image.jpg","name:Covergirl Clean 120 Creamy Natural Liquid Foundation30mL"
            ],
            "filters": [
                 "category:Health&Beauty","category:Grocery","Brand:Covergirl","Special_Flag:0"
            ]
        }
    ]
}

โดยจะเห็นได้ในส่วนต่างๆ ของพอร์ทัล CitrusAd รวมถึงการเลือกผลิตภัณฑ์ ดังตัวอย่างด้านล่าง:

1581

ภาพอ้างอิง