API đối tác

Lọc tạo quảng cáo

Khi yêu cầu quảng cáo, bạn cần đặt mục tiêu hỗ trợ việc lọc khách hàng theo thương hiệu, danh mục, hạn chế chế độ ăn uống và hơn thế nữa. Nếu trang thương mại điện tử của bạn hỗ trợ kiểu lọc có sử dụng chức năng và/hoặc, CitrusAd có thể hỗ trợ tính năng này với thông số filterMode bổ sung trong yêu cầu của bạn.

Có hai kiểu lọc, như mô tả bên dưới.

andOr kiểu lọc (nên dùng)

andOr kiểu lọc hữu dụng với các ngữ cảnh mà người dùng đã lọc sâu khi tìm kiếm. Nó cho phép định dạng ngữ cảnh đơn giản hơn mà vẫn hỗ trợ lọc sâu. Phương pháp này tuân theo cấu trúc dưới đây:

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

Một yêu cầu mẫu có dạng như sau:

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
}

Phương pháp tiếp cận này thường dễ dàng hơn để các nhà bán lẻ xâu chuỗi các yêu cầu theo loại khi khách hàng lọc sâu tìm kiếm của họ.

🚧

Bạn phải xác định filterMode trong andOr thì chức năng này mới hoạt động chính xác được.

orAnd kiểu lọc (chế độ mặc định)

Phương pháp lọc bộ lọc sản phẩm mặc định tuân theo cấu trúc sau đây:

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

Ví dụ tương tự được trình bày ở trên sẽ được gửi dưới dạng một yêu cầu như sau:

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
}

📘

Bạn không cần xác định filterMode trong orAnd cho chức năng này, vì đó là hành vi mặc định.