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

• คุณสามารถสร้างแค็ตตาล็อกเดียวหรือหลายแค็ตตาล็อกในคำขอเดียว หากคุณกำลังสร้างแค็ตตาล็อกหลายรายการ คุณสามารถจัดลำดับได้สูงสุด 100 รายการต่อคำขอ
• เมื่อสร้างแค็ตตาล็อกแล้ว จะส่งกลับ catalogId catalogId นี้จำเป็นเมื่อเพิ่มรายละเอียดผลิตภัณฑ์ของคุณลงในแค็ตตาล็อกของคุณ ซึ่งทำหน้าที่เป็นตัวระบุที่ไม่ซ้ำกันสำหรับแค็ตตาล็อก
• หากคุณไม่สามารถสร้างแค็ตตาล็อกโดยใช้ API ที่ระบุในเอกสารนี้ได้ โปรดติดต่อวิศวกรบูรณาการลูกค้า (CIE) ของคุณ ซึ่งสามารถสร้างแค็ตตาล็อกในนามคุณได้
• เมื่อสร้างแค็ตตาล็อกแล้ว แค็ตตาล็อกจะถูกซ่อนไว้ตามค่าเริ่มต้น ดังนั้นคุณต้องติดต่อ CIE เพื่อทำให้แค็ตตาล็อกมองเห็นได้ในเนมสเปซของคุณ

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

คุณต้องมีคีย์ 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 ฐาน

สร้างแค็ตตาล็อกเดียว

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

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

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

POST $BASE_URL/v1/catalogs HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "catalogs": [
        {
            "name": "Retailer A"
        }
    ]
}

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

การตอบสนองเป็นไปตามรูปแบบ JSON มาตรฐานและส่งคืนรายละเอียดต่อไปนี้ในอาร์เรย์

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

{
    "catalogs": [
        {
            "teamId": "9f48572c-0a5b-4997-9a0e-ed74f4d32dc6",
            "name": "Retailer A",
            "id": "216af452-d219-4807-b8ca-578bba446541"
        }
    ]
}

📘

เมื่อส่งคืนอ็อบเจ็กต์สำเร็จแล้ว คุณจะได้รับ ID สำหรับแค็ตตาล็อกใหม่ของคุณ หากคุณส่งคำขอเดิมอีกครั้ง คุณจะได้รับ ID ใหม่ ซึ่งจะสร้างแค็ตตาล็อกสองรายการ

การสร้างหลายแค็ตตาล็อก

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

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

POST $BASE_URL/v1/catalogs HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "catalogs": [
        {
            "name": "Retailer A"
        },
        {
            "name": "Retailer B"
        }
    ]
}

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

การตอบสนองเป็นไปตามรูปแบบ JSON มาตรฐานและส่งคืนรายละเอียดต่อไปนี้ในอาร์เรย์ แต่ละแคตตาล็อกจะมี teamid, name และ id เป็นของตัวเอง:

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

{
    "catalogs": [
        {
            "teamId": "9f48572c-0a5b-4997-9a0e-ed74f4d32dc6",
            "name": "Retailer A",
            "id": "216af452-d219-4807-b8ca-578bba446541"
        },
        {
            "teamId": "9f48572c-0a5b-4997-9a0e-ed74f4d32dc6",
            "name": "Retailer B",
            "id": "75047339-65f5-41b8-8f2c-e76b04716cd4"
        }
    ]
}

สร้างหลายแค็ตตาล็อกต่อผู้ค้าปลีก

วิธีจัดการหลายแค็ตตาล็อก

• สร้างทีมผู้ค้าปลีก 'ย่อย' แยกกันสำหรับแต่ละแค็ตตาล็อก และทีมผู้ค้าปลีก 'หลัก' ทีมเดียว
• ตั้งค่าความสัมพันธ์แม่/ลูกระหว่างทีมแม่กับทีมลูกแต่ละทีม โดยตรวจดูให้แน่ใจว่าทีมแม่เชื่อมโยงกับทีมลูกทั้งหมดอย่างถูกต้อง
• หลังจากตั้งค่าทีมแม่แล้ว ให้อัปเดตมาตรฐานเนื้อหาสำหรับทีมลูกทั้งหมดเพื่อเชื่อมโยงกับทีมแม่ ติดต่อวิศวกรบูรณาการลูกค้า (CIE) ของคุณเพื่อดำเนินการนี้

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

• ความสัมพันธ์แบบตัวต่อตัว: การตั้งค่าที่ปลอดภัยที่สุดคือการมีความสัมพันธ์แบบตัวต่อตัวระหว่างแค็ตตาล็อกและทีมผู้ค้าปลีก แม้ว่าจะไม่จำเป็นอย่างเข้มงวด แต่ก็ช่วยหลีกเลี่ยงปัญหาสับสนได้

• โครงสร้างตัวอย่าง: ในแผนภาพต่อไปนี้ ทีมแม่จะซ้อนอยู่ภายในเนมสเปซของผู้ค้าปลีก แต่ละทีมลูก (A, B, C) มีแค็ตตาล็อกที่เกี่ยวข้องของตัวเอง (A, B, C) โครงสร้างนี้ช่วยให้แน่ใจว่าการซื้อได้รับการระบุแหล่งที่มาอย่างถูกต้องไปยังแค็ตตาล็อกที่เกี่ยวข้องตามคีย์ API ของทีมที่ใช้ในการยืนยันการสั่งซื้อ

  

• Multiple Catalogs Under One Team: You can create multiple catalogs under the same retailer team. However, ensure that SKUs and SessionIDs are not shared across these catalogs to maintain correct attribution. Including the catalogId in the order API call helps in distinguishing the catalogs and prevents attribution errors. For more information, see Syncing order data via API.

• Attribution Issues: Sharing SKUs and session IDs across catalogs can cause attribution problems. For example, if you have a website in two languages (e.g., ES and FR) with one retailer team associated with two catalogs (one for each language) and shared SKUs, a user identified by the same sessionID in both versions could result in a purchase on the ES site being attributed to the FR site, and vice versa. Including the catalogId in the order API call remedies this issue by ensuring that the attribution is correctly assigned to the respective catalog. For more information, see Syncing order data via API.