ตลาดคืออะไร

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

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

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

การตั้งค่าผู้ลงโฆษณาในตลาด

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

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

ข้อกําหนดการผสานการทํางาน

ภาพรวมระดับสูง

นอกเหนือจากการรวมมาตรฐานกับ CitrusAd แล้ว การรวมของคุณจะต้องได้รับการปรับปรุงด้วยการเปลี่ยนแปลงด้านล่าง:

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

🚧

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

การปรับปรุงแค็ตตาล็อกผลิตภัณฑ์

ในแค็ตตาล็อกผลิตภัณฑ์ของคุณที่ซิงค์กับ Citrus คุณจะต้องระบุรหัสผู้ขายต่อรหัสผลิตภัณฑ์ที่ไม่ซ้ำกับ CitrusAd

การซิงค์แคตตาล็อกผ่านไฟล์

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

🚧

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

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

สำหรับตัวอย่าง โปรดไปที่ การซิงค์แคตตาล็อกและผลิตภัณฑ์ผ่านไฟล์

การซิงค์แค็ตตาล็อกผ่าน API

เมื่อซิงค์ผลิตภัณฑ์ผ่าน API คุณจะต้องซิงค์ sellerId ต่อ sellerId และ gtin ชุดค่าผสม

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",
            "sellerId": "327272-sade2-3ja",
            "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"
            ],
            "profit": "1.50"
        },
        {
            "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
            "gtin": "23556578965543",
            "sellerId": "09sa-d32s--faasw",
            "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"
            ],
            "profit": "1.50"
        },
        {
            "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
            "gtin": "23556578965738",
            "inventory": 26,
            "price": "8.50",
            "tags": [
                "imageurl:https://your.image.host.com/image.jpg",
                "name:Kelloggs Froot Loops Breakfast Cereal 500g"
            ],
            "filters": [
                "Brand:Kelloggs",
                "category:Pantry",
                "category:BreakfastFoods",
                "category:Cereals",
                "Special_Flag:0"
            ],
            "profit": "0.50"
        }
    ]
}

การปรับปรุงการตอบสนองต่อโฆษณา

เมื่อ CitrusAd แสดงโฆษณา sellerId จะให้บริการหาก gtin มีหนึ่งรายการที่เกี่ยวข้อง สิ่งนี้มีผลกับโฆษณาทุกประเภท แต่เกี่ยวข้องกับการแสดงโฆษณาจากโฆษณาผลิตภัณฑ์เท่านั้น ตัวอย่างการตอบกลับโฆษณาผลิตภัณฑ์อยู่ด้านล่าง:

{
    "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="
}

เพื่อให้แน่ใจว่ามีการแสดงข้อเสนอของผู้ขายที่ถูกต้อง คุณควรอ่าน sellerId ให้บริการโดย CitrusAd และแสดงข้อเสนอของผู้ขายที่ถูกต้องให้กับลูกค้า

การปรับปรุงการรายงานคำสั่งซื้อ

เมื่อรายงานคำสั่งซื้อไปยัง CitrusAd คุณจะต้องระบุ sellerId ต่อ gtin เมื่อคุณรายงานคำสั่งซื้อไปยัง CitrusAd

🚧

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

การซิงค์คําสั่งซื้อผ่านไฟล์

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

สำหรับตัวอย่าง โปรดไปที่ การซิงค์ข้อมูลคำสั่งซื้อผ่านไฟล์

การซิงค์คำสั่งซื้อผ่าน API

เมื่อซิงค์คำสั่งซื้อผ่าน API คุณจะต้องซิงค์ sellerId ตามความเหมาะสมเมื่อรายงานคําสั่งซื้อ ในกรณีที่ผลิตภัณฑ์ที่ซื้อไม่มี sellerIdซึ่งสามารถละไว้ได้

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

POST $BASE_URL/v1/orders HTTP/1.1 
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "orders": [
       {
       "customerId": "npc-s243-ir",
        "sessionId": "5cat7-9964-4f",
        "orderDate": "2021-12-02T15:00:00Z",
        "id": "abcti84ew-c158-4d78-a0af-b48bbwfrcss4",
        "orderItems": [
            {
                  "gtin": "9891998566P",
                  "quantity": 3,
                  "regularUnitPrice": "1.00",
                  "totalOrderItemPriceAfterDiscounts": "3.00",
                  "sellerId": "10sa-3s33-j8e3"
                }
              ]
            },
          {
                  "gtin": "351998532P",
                  "quantity": 1,
                  "regularUnitPrice": "2.50",
                  "totalOrderItemPriceAfterDiscounts": "2.50"            
                }
              ]
            }
    ]
}

การย้ายทีมที่มีอยู่

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

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

1. แจ้งให้ผู้จัดการบัญชีด้านเทคนิคของ CitrusAd ทราบถึงความตั้งใจของคุณที่จะเปิดใช้งานคุณสมบัติรหัสผู้ขายในตลาดกลาง
2. ผู้จัดการบัญชีด้านเทคนิคของคุณควรมั่นใจได้ว่าการระบุแหล่งที่มาภายในของเราได้รับการกำหนดค่าให้จัดการกับการย้ายทีม
3. ปรับปรุงแค็ตตาล็อกผลิตภัณฑ์ด้วยผลิตภัณฑ์ ID ผู้ขาย
4. ปรับปรุงการรายงานคำสั่งซื้อเพื่อรายงาน ID ผู้ขาย
5. หากต้องการย้ายทีมที่มีอยู่ ให้แก้ไขทีมที่มีอยู่เพื่อระบุรหัสผู้ขาย
6. เมื่อแก้ไขทีมแล้ว จะต้องแก้ไขแคมเปญของแต่ละทีมเพื่อเลือกผลิตภัณฑ์อีกครั้ง เนื่องจากเราต้องการผลิตภัณฑ์ใหม่ที่มี ID ผู้ขายที่เลือกไว้ในแคมเปญ ในขณะที่แคมเปญที่สร้างขึ้นก่อนที่ทีมจะมีรหัสผู้ขายจะไม่มีรูปแบบที่ถูกต้องของผลิตภัณฑ์ที่เลือก