하위 제품이란 무엇인가요?

일부 제품에는 부모/하위 관계가 존재합니다. 상위 제품이 있고 여러 변형이 하위 제품입니다. 광고주는 하위 제품 레벨에서 캠페인을 최적화하여 가장 관련성이 높고 성과가 좋은 제품을 고객에게 홍보하게 됩니다.

다른 제품은 이러한 관계가 없으므로 플랫폼에서 변경이 발생하거나 영향을 받지 않습니다.

UI 기능

제품 선택

제품 선택 시 상위/하위 제품이 그룹화됩니다.

상위 제품을 클릭하면 확장되어 하위 제품이 표시됩니다. 이를 통해 광고주는 캠페인에서 고유한 하위 제품 레벨에 맞춰 최적화할 수 있습니다.

보고

플랫폼 내 보고는 제품에 연결된 productCollection 이 있을 때 상위 제품별로 자동 그룹화됩니다.

플랫폼의 CSV 내보내기에서 제품 코드에 대해 "상위 코드" 열이 새로 추가되어 productCollection 값을 채웁니다.

UI에서 제품 코드로 필터링하는 경우 상위 제품 메트릭이 비어 있으며 상위 제품을 클릭하여 하위 제품에 대한 보고를 표시할 수 있습니다.

통합 요구 사항

제품 업데이트

제품을 CitrusAd와 동기화 시 제품에 대한 POST 요청에 새로운 productCollection 필드가 있습니다.

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

이 필드가 있는 경우 제품 선택 및 보고 테이블은 동일한 다음을 가진 모든 제품에 대해 제품 수집 레벨에서 집계됩니다. productCollection.

파일별로 동기화하는 경우 제품별 선택적으로 채울 수 있는 product_collection 열이 있습니다.

광고 렌더링

CitrusAd에서 광고를 렌더링할 시에는 변경할 필요가 없습니다 . 귀하가 API 응답에서 받는 gtin 는 "하위" 제품에 대한 것이며 이를 귀하의 웹사이트에서 고객에게 렌더링해야 합니다.