การกรองการสร้างโฆษณา

เมื่อขอโฆษณา คุณควรตั้งเป้าที่จะสนับสนุนการกรองของลูกค้าตามแบรนด์ หมวดหมู่ ข้อจำกัดด้านอาหาร และอื่นๆ หากเว็บไซต์อีคอมเมิร์ซของคุณรองรับการกรองที่ใช้และ/หรือฟังก์ชัน 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 สำหรับฟังก์ชันนี้ เนื่องจากเป็นลักษณะการทำงานเริ่มต้น