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