API đối tác

sellerId cho sàn thương mại

Sàn thương mại là gì?

Sàn thương mại là cơ hội duy nhất để các nhà bán lẻ mở rộng sự hiện diện trực tuyến cũng như thu hút người mua mới hoặc người mua không thường xuyên một cách dễ dàng. Sàn thương mại cho phép các doanh nghiệp nhỏ hơn tiếp cận nhiều đối tượng khách hàng, sản phẩm thường do người bán trên sàn thương mại vận chuyển trực tiếp đến khách hàng.

Sàn thương mại cho phép người bán bán sản phẩm của họ trên trang web của nhà bán lẻ, tăng khả năng hiển thị sản phẩm của họ tới nhiều đối tượng hơn. Đồng thời, các nhà bán lẻ có được các dịch vụ sản phẩm bổ sung để bán cho nhiều đối tượng khách hàng hơn.

Ngoài việc kiếm tiền từ trang web của bạn qua các chức năng trên sàn thương mại; các nhà bán lẻ cũng có thể tận dụng không gian kệ hàng trực tuyến cao cấp này và tạo cơ hội cho các nhà cung cấp trên sàn thương mại đấu thầu các vị trí hàng đầu thông qua CitrusAd bằng tài liệu được liệt kê bên dưới.

Thiết lập tài khoản cho nhà quảng cáo trên sàn thương mại

Sau khi các cải tiến tích hợp của bạn hoàn tất (thông tin bên dưới), bạn có thể đặt ID Người bán cho từng nhóm. Điều này chỉ có thể được thực hiện khi tạo một nhóm từ nhóm nhà bán lẻ, điều này không thể được thực hiện khi chỉnh sửa một nhóm hoặc không thể được thực hiện bởi một nhà cung cấp.

Có phần "Các trường tùy chọn" khi tạo nhóm mới, nơi có thể chọn ID Người bán. ID Người bán có thể chọn được lấy trực tiếp từ danh mục sản phẩm của bạn. Bạn không thể nhập giá trị không có trong danh mục sản phẩm.

Yêu cầu về tích hợp

Tổng quan cấp cao

Ngoài tích hợp tiêu chuẩn với CitrusAd, tích hợp của bạn sẽ cần được tăng cường với những thay đổi dưới đây:

  • Triển khai một sellerId cho mỗi sản phẩm trong tệp danh mục sản phẩm hoặc API
  • Phân tích cú pháp phản hồi quảng cáo và hiển thị đúng đề nghị của người bán khi có liên quan
  • Báo cáo một sellerId cho mỗi sản phẩm duy nhất khi báo cáo đơn đặt hàng tới CitrusAd

🚧

Hiện tại, tính năng của CitrusAd không đáp ứng được đầy đủ trong trường hợp người bán sản phẩm không có ID người bán và sản phẩm có nhiều ID người bán khác nhau.Giải pháp thay thế được xác định cho việc này là đồng bộ hóa ID người bán lẻ trên mọi sản phẩm bên ngoài sàn thương mại và mỗi nhà cung cấp không phải là người bán trên sàn thương mại phải thêm ID người bán này.Vui lòng liên hệ với người quản lý tài khoản kỹ thuật của bạn để tìm hiểu thêm.

Tăng cường danh mục sản phẩm.

Trong danh mục sản phẩm của bạn được đồng bộ hóa với Citrus, bạn sẽ cần cung cấp sellerId cho mỗi mã sản phẩm duy nhất cho CitrusAd.

Đồng bộ hóa danh mục qua tệp

Bạn sẽ cần thêm một cột/phần bổ sung vào tệp danh mục của mình cho seller_id. Mỗi tổ hợp seller_id và product_code phải là một hàng duy nhất. Đối với các sản phẩm bên ngoài sàn thương mại, có thể để trống seller_id .

🚧

Các sản phẩm có cả người bán có thương hiệu (trong đó sản phẩm không có sellerId) và người bán trên thị trường (trong đó cùng một sản phẩm có các biến thể sellerId) hiện không tương thích. Nếu bạn có sản phẩm thuộc danh mục này, bạn chỉ nên bổ sung thêm người bán trên thị trường cho những sản phẩm này ở thời điểm hiện tại.

Nếu trang web thương mại điện tử của bạn được thiết lập để cung cấp sản phẩm cho trường hợp sử dụng cụ thể này thì chúng tôi yêu cầu bạn đặt vấn đề này với đầu mối liên hệ CitrusAd của bạn vì chúng tôi đang cân nhắc việc thiết lập lại nhằm đảm bảo sự tương thích cho trường hợp sử dụng đó.

Để biết ví dụ, vui lòng truy cập Đồng bộ hóa danh mục và sản phẩm bằng tệp

Đồng bộ hóa danh mục thông qua API

Khi đồng bộ hóa các sản phẩm qua API, bạn sẽ phải đồng bộ hóa một sellerId cho mỗi tổ hợp sellerId và gtin không trùng lặp. 

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"
        }
    ]
}

Tăng cường phản hồi quảng cáo

Khi CitrusAd phân phát quảng cáo, sellerId sẽ được phân phát nếu gtin có một ID liên quan đến nó. Điều này áp dụng cho tất cả các loại quảng cáo, nhưng chỉ có liên quan để hiển thị quảng cáo từ quảng cáo sản phẩm. Dưới đây là một phản hồi quảng cáo sản phẩm mẫu:

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

Để đảm bảo lời đề nghị chính xác của người bán được hiển thị, bạn nên đọc sellerId do CitrusAd cung cấp và hiển thị đúng lời đề nghị của người bán cho khách hàng.

Tăng cường báo cáo đơn hàng

Khi báo cáo đơn đặt hàng cho CitrusAd, bạn cũng sẽ cần chỉ định sellerId cho mỗi tổ hợp gtin thời gian bạn báo cáo đơn đặt hàng cho CitrusAd.

🚧

Bước này là bắt buộc và không thể bỏ qua, nếu không quảng cáo sẽ không phân bổ cho đơn hàng.

Đồng bộ hóa đơn hàng qua tệp

Bạn sẽ cần thêm một cột/phần bổ sung vào tệp đơn hàng của mình về seller_id. Mỗi tổ hợp seller_id và product_code phải là một hàng duy nhất. Đối với các sản phẩm được mua ngoài sàn thương mại, seller_id .

Ví dụ: vui lòng truy cập Đồng bộ dữ liệu đơn bằng tệp

Đồng bộ hóa đơn đặt hàng qua API

Khi đồng bộ hóa các đơn hàng qua API, bạn sẽ cần phải đồng bộ hóa sellerId khi thích hợp vào thời điểm báo cáo đơn hàng. Trong trường hợp sản phẩm đã mua không có sellerIdthì bỏ qua cũng được.

Dưới đây là ví dụ về đơn hàng mà một sản phẩm đến từ người bán trên sàn thương mại và một sản phẩm khác không phải là sản phẩm của sàn thương mại:

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"            
                }
              ]
            }
    ]
}

Di chuyển các nhóm hiện có

Nếu bạn đang tăng cường khả năng tích hợp của mình để hỗ trợ người bán trên thị trường, bạn hoặc nhà quảng cáo của bạn cần thực hiện một số bước. Điều quan trọng là phải biết cách các sản phẩm hoạt động trong hệ thống CitrusAd.

Một sản phẩm không có ID người bán và một sản phẩm có ID người bán là hai thực thể duy nhất trong hệ thống CitrusAd. Do đó, các chiến dịch cần được di chuyển để chọn đúng biến thể sản phẩm mới cho tất cả các chiến dịch hiện tại cần được cập nhật.

  1. Thông báo cho người quản lý tài khoản kỹ thuật CitrusAd của bạn về ý định kích hoạt tính năng ID người bán trên thị trường
  2. Người quản lý tài khoản kỹ thuật của bạn sẽ có thể đảm bảo phân bổ nội bộ của chúng tôi được định cấu hình để xử lý các nhóm di chuyển
  3. Tăng cường danh mục sản phẩm với các sản phẩm có ID người bán
  4. Tăng cường báo cáo đơn đặt hàng để báo cáo ID người bán
  5. Nếu di chuyển các nhóm hiện có, hãy chỉnh sửa các nhóm hiện có để chỉ định ID người bán
  6. Nếu bạn chỉnh sửa một nhóm thì phải chỉnh sửa cả chiến dịch của từng nhóm để chọn lại sản phẩm. Lý do là vì chúng tôi cần sản phẩm mới có ID người bán được chọn trong chiến dịch, trong khi các chiến dịch được tạo trước khi nhóm có ID người bán sẽ không có mẫu mã chính xác của sản phẩm được chọn.