파트너 API
API 참조

광고 생성 필터링

광고 요청 시 브랜드, 카테고리, 식단 제한 등 고객의 필터링을 지원하는 것을 목표로 해야 합니다. 귀하의 전자 상거래 사이트가 '및/또는' 기능을 사용하는 필터링을 지원하는 경우 CitrusAd는 귀하의 요청에서 추가 filterMode 매개 변수를 통해 이를 지원할 수 있습니다.

아래에 나타난 것처럼 두 가지 유형의 필터링이 있습니다.

andOr 필터링(권장)

andOr 필터링은 사용자가 검색에서 심층 필터링한 컨텍스트에 유용합니다. 이는 심층 필터링을 지원하면서 보다 간단한 컨텍스트 서식 지정을 허용합니다. 이 방법은 아래에 요약된 구조를 따릅니다.

"productFilters": [
     [ "" OR "" ] AND [ "" OR "" ] AND [ "" OR "" ] 
    ],
    "options": {
     "filterMode": "AndOr"
    },

예시 요청은 다음과 같습니다.

POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "customerId": "wertg5432a",
    "sessionId": "ec9-4e07-881d-3e9", 
    "placement": "category",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "productFilters": [
     	 ["category:bread"],
    	 ["brand:brandA","brand:brandB"],
    	 ["price:below $10"],
    	 ["nutrition:organic","nutrition:vegan"]
    ],
    "options": {
   							 "filterMode": "AndOr"
 							 },
    "maxNumberOfAds": 3
}

이러한 방식을 사용하면 일반적으로 고객이 심층 필터링을 활용하여 검색할 때 소매업체가 유형별로 요청을 더 쉽게 연결할 수 있습니다.

🚧

이 기능이 올바르게 작동하려면 filterMode 를 andOr 에 대해 지정해야 합니다.

orAnd 필터링(기본 모드)

제품 필터를 필터링하는 기본 방법은 아래에 기술된 구조를 따릅니다.

"productFilters": [
     [ "" AND "" ], OR [ "" AND "" ], OR [ "" AND "" ] 
    ],
    "options": {
     "filterMode": "OrAnd"
    },

위에 나타난 것과 동일한 예는 아래와 같은 요청으로 전송됩니다.

POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "customerId": "wertg5432a",
    "sessionId": "ec9-4e07-881d-3e9", 
    "placement": "category",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "productFilters": [
     	 ["category:bread","brand:brandA","price:below $10","nutrition:organic"],
     	 ["category:bread","brand:brandB","price:below $10","nutrition:organic"],
     	 ["category:bread","brand:brandA","price:below $10","nutrition:vegan"],
     	 ["category:bread","brand:brandB","price:below $10","nutrition:vegan"],       
    ],
    "options": {
   							 "filterMode": "OrAnd"
 							 },
    "maxNumberOfAds": 3
}

📘

이 기능은 기본적으로 제공되므로 filterMode 를 orAnd 지정할 필요가 없습니다.