Tích hợp các sản phẩm gốc

Sản phẩm con là gì?

Một số sản phẩm có mối quan hệ gốc/con. Có một sản phẩm gốc và sau đó nhiều biến thể là sản phẩm con. Các nhà quảng cáo muốn tối ưu hóa các chiến dịch ở cấp độ sản phẩm con để đảm bảo họ đang quảng bá các sản phẩm phù hợp nhất và hoạt động tốt nhất cho khách hàng.

Các sản phẩm khác sẽ không có các mối quan hệ này và do đó sẽ không thấy thay đổi hoặc tác động nào trong nền tảng.

Khả năng giao diện người dùng

Lựa chọn sản phẩm

Khi chọn sản phẩm, sản phẩm gốc/con sẽ được nhóm lại.

Bạn có thể nhấp vào sản phẩm gốc và nó sẽ mở rộng để hiển thị các sản phẩm con. Điều này sẽ cho phép nhà quảng cáo của bạn tối ưu hóa ở cấp độ sản phẩm con cụ thể trong chiến dịch.

Báo cáo

Báo cáo trong nền tảng sẽ tự động nhóm theo sản phẩm gốc khi một sản phẩm có productCollection liên kết với nó.

Trong tệp CSV xuất từ nền tảng, đối với mã sản phẩm, có một cột "Mã gốc" mới, cột này sẽ điền vào productCollection giá trị.

Nếu lọc theo mã sản phẩm trong giao diện người dùng, các chỉ số sản phẩm gốc sẽ trống và bạn có thể nhấp vào sản phẩm gốc để hiển thị báo cáo cho bất kỳ sản phẩm con nào.

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

Cập nhật sản phẩm

Khi bạn đồng bộ hóa sản phẩm với CitrusAd, sẽ có trường productCollection mới trong yêu cầu POST cho sản phẩm của bạn.

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",
            "productCollection": "abc-123",
            "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"
            ]
        }
    ]

Khi trường này xuất hiện, các bảng báo cáo và lựa chọn sản phẩm sẽ tổng hợp ở cấp bộ sưu tập sản phẩm cho tất cả các sản phẩm có cùng productCollection.

Nếu bạn đang đồng bộ hóa theo tệp, có một cột product_collection mà bạn có thể tùy chọn điền vào mỗi sản phẩm.

Hiển thị quảng cáo

Không cần thay đổi khi hiển thị quảng cáo từ CitrusAd. Các gtin bạn nhận được trong phản hồi API sẽ là của sản phẩm "con", và bạn sẽ cần phải hiển thị nó trên trang web cho khách hàng của bạn.