Filtrage avancé
Dans la section "facettage", nous mettons en évidence comment on peut obtenir les filtres disponibles pour une requête de recherche et appliquer des filtres pour affiner les résultats de recherche. Par exemple, après avoir recherché "chaussures", un acheteur peut vouloir affiner les résultats en appliquant un filtre sur l'attribut couleur et en choisissant une valeur telle que rouge. Ce faisant, seules les chaussures "rouges" apparaîtront dans les résultats. Si à ce stade, l'acheteur choisit une autre couleur, par exemple, bleu, Klevu affichera maintenant à la fois les chaussures "rouges" et les "bleues". Ainsi, il appliquera l'opération OU entre les valeurs du même attribut. Si à ce stade, l'acheteur choisit "coton" comme matériau, le système affichera à la fois les chaussures rouges et bleues, mais il s'assurera également que tous les produits ont "coton" comme matériau. En d'autres termes, il applique l'opération ET entre les différents types d'attributs sélectionnés.
Cependant, il arrive un moment où l'on peut vouloir effectuer des opérations de filtrage complexes, ou en d'autres termes, des opérations de filtrage avancées. Par exemple, vous pouvez vouloir afficher un groupe de chaussures où "la couleur est rouge", et "la marque n'est PAS Adidas". Vous pouvez également vouloir ajouter un autre groupe de chaussures à cet ensemble de résultats. Par exemple, où "la couleur est bleue ou noire", "la marque est Nike", et "la fourchette de prix est entre 100 et 400". Comme vous pouvez le voir, contrairement au comportement du "facettage", dans notre exemple ici, nous souhaitons avoir un ou plusieurs groupes de produits correspondant à différents groupes de conditions pour l'ensemble final des produits à retourner.
C'est avec cette intention de permettre des opérations de filtrage avancées sur l'ensemble des résultats que nous avons introduit une nouvelle fonctionnalité appelée "filtrage avancé" dans notre API.
Avant l'introduction du filtrage avancé, si un utilisateur avait demandé que des filtres soient retournés ou que certains soient appliqués, Klevu cherchait à trouver un ensemble de produits pertinents correspondant à la requête de l'utilisateur. Il incluait/excluait ensuite tous les produits demandés explicitement dans cet ensemble de résultats. C'est après cette étape qu'il calcule tous les filtres possibles à retourner et applique également les filtres sélectionnés pour affiner les résultats de recherche. Ainsi, si un produit ajouté explicitement ne correspondait pas au filtre appliqué, il serait exclu de l'ensemble final des résultats.
Avec l'ajout du filtrage avancé, Klevu identifie maintenant un ensemble de produits pertinents correspondant à la requête. Il applique ensuite le filtrage avancé à cela. C'est après cette étape qu'il inclut/exclut tous les produits demandés explicitement, calcule les filtres basés sur cet ensemble de résultats, et enfin applique les filtres sélectionnés pour affiner les résultats de recherche. De cette manière, s'il y a un filtrage à appliquer avant d'inclure/exclure des produits explicitement, le filtrage avancé doit être utilisé.
Veuillez noter que le filtrage avancé peut également être utilisé avec les API de marchandisage par catégorie et de recommandation.
Le groupCondition l'objet peut être utilisé pour appliquer les conditions de filtrage avancé afin que vos clients puissent affiner leurs résultats en fonction des attributs pertinents.
- groupOperatorstringDescription
- keystringDescription
- valueOperatorstringDescription
- singleSelectBooleanDescription
- excludeValuesInResultBooleanDescription
- valuesArrayDescription
{
"context":{
"apiKeys":[
"klevu-156925593843210765"
]
},
"recordQueries":[
{
"id":"productSearch",
"typeOfRequest":"SEARCH",
"settings":{
"typeOfRecords":[
"KLEVU_PRODUCT"
],
"groupCondition":{
"groupOperator":"ANY_OF",
"conditions":[
{
"key":"klevu_price",
"valueOperator":"INCLUDE",
"singleSelect":true,
"excludeValuesInResult":true,
"values":[
"20 - 25"
]
},
{
"key":"itemGroupId",
"valueOperator":"EXCLUDE",
"singleSelect":false,
"values":[
"4384028262462"
]
},
{
"key":"size",
"valueOperator":"EXCLUDE",
"singleSelect":false,
"values":[
"Small",
"Large"
]
},
{
"key":"brand",
"valueOperator":"EXISTS"
},
{
"key":"discount",
"valueOperator":"NOT_EXISTS"
}
]
},
"query":{
"term":"tee"
},
"limit":2
}
}
]
}<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://eucs15v2.ksearchnet.com/cs/v2/search',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{
"context": {
"apiKeys": [
"klevu-156925593843210765"
]
},
"recordQueries": [
{
"id": "productSearch",
"typeOfRequest": "SEARCH",
"settings": {
"typeOfRecords": [
"KLEVU_PRODUCT"
],
"groupCondition": {
"groupOperator": "ANY_OF",
"conditions": [
{
"key":"klevu_price",
"valueOperator":"INCLUDE",
"singleSelect":true,
"excludeValuesInResult":true,
"values":[
"20 - 25"
]
},
{
"key": "itemGroupId",
"valueOperator": "EXCLUDE",
"singleSelect": false,
"values": [
"4384028262462"
]
},
{
"key":"size",
"valueOperator":"EXCLUDE",
"singleSelect":false,
"values":[
"Small",
"Large"
]
},
{
"key": "brand",
"valueOperator": "EXISTS"
},
{
"key": "discount",
"valueOperator": "NOT_EXISTS"
}
]
},
"query": {
"term": "tee"
},
"limit": 2
}
}
]
}',
CURLOPT_HTTPHEADER => array(
'Content-Type: application/json'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
// WARNING: For POST requests, body is set to null by browsers.
var data = JSON.stringify({
"context": {
"apiKeys": [
"klevu-156925593843210765"
]
},
"recordQueries": [
{
"id": "productSearch",
"typeOfRequest": "SEARCH",
"settings": {
"typeOfRecords": [
"KLEVU_PRODUCT"
],
"groupCondition": {
"groupOperator": "ANY_OF",
"conditions": [
{
"key": "klevu_price",
"valueOperator": "INCLUDE",
"singleSelect": true,
"excludeValuesInResult": true,
"values": [
"20 - 25"
]
},
{
"key": "itemGroupId",
"valueOperator": "EXCLUDE",
"singleSelect": false,
"values": [
"4384028262462"
]
},
{
"key": "size",
"valueOperator": "EXCLUDE",
"singleSelect": false,
"values": [
"Small",
"Large"
]
},
{
"key": "brand",
"valueOperator": "EXISTS"
},
{
"key": "discount",
"valueOperator": "NOT_EXISTS"
}
]
},
"query": {
"term": "tee"
},
"limit": 2
}
}
]
});
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function() {
if(this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("POST", "https://eucs15v2.ksearchnet.com/cs/v2/search");
xhr.setRequestHeader("Content-Type", "application/json");
xhr.send(data);OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n \"context\": {\r\n \"apiKeys\": [\r\n \"klevu-156925593843210765\"\r\n ]\r\n },\r\n \"recordQueries\": [\r\n {\r\n \"id\": \"productSearch\",\r\n \"typeOfRequest\": \"SEARCH\",\r\n \"settings\": {\r\n \"typeOfRecords\": [\r\n \"KLEVU_PRODUCT\"\r\n ],\r\n \"groupCondition\": {\r\n \"groupOperator\": \"ANY_OF\",\r\n \"conditions\": [\r\n {\r\n \"key\":\"klevu_price\",\r\n \"valueOperator\":\"INCLUDE\",\r\n \"singleSelect\":true,\r\n \"excludeValuesInResult\":true,\r\n \"values\":[\r\n \"20 - 25\"\r\n ]\r\n },\r\n {\r\n \"key\": \"itemGroupId\",\r\n \"valueOperator\": \"EXCLUDE\",\r\n \"singleSelect\": false, \r\n \"values\": [\r\n \"4384028262462\"\r\n ]\r\n },\r\n\t\t\t\t\t\t{\r\n\t\t\t\t\t\t \"key\":\"size\",\r\n\t\t\t\t\t\t \"valueOperator\":\"EXCLUDE\",\r\n\t\t\t\t\t\t \"singleSelect\":false,\r\n\t\t\t\t\t\t \"values\":[\r\n\t\t\t\t\t\t\t\"Small\",\r\n \"Large\"\r\n\t\t\t\t\t\t ]\r\n\t\t\t\t\t },\r\n {\r\n\"key\": \"brand\",\r\n\"valueOperator\": \"EXISTS\"\r\n},\r\n{\r\n\"key\": \"discount\",\r\n\"valueOperator\": \"NOT_EXISTS\"\r\n}\r\n ]\r\n },\r\n \"query\": {\r\n \"term\": \"tee\"\r\n },\r\n \"limit\": 2\r\n }\r\n }\r\n ]\r\n}");
Request request = new Request.Builder()
.url("https://eucs15v2.ksearchnet.com/cs/v2/search")
.method("POST", body)
.addHeader("Content-Type", "application/json")
.build();
Response response = client.newCall(request).execute();var request = require('request');
var options = {
'method': 'POST',
'url': 'https://eucs15v2.ksearchnet.com/cs/v2/search',
'headers': {
'Content-Type': 'application/json'
},
body: JSON.stringify({
"context": {
"apiKeys": [
"klevu-156925593843210765"
]
},
"recordQueries": [
{
"id": "productSearch",
"typeOfRequest": "SEARCH",
"settings": {
"typeOfRecords": [
"KLEVU_PRODUCT"
],
"groupCondition": {
"groupOperator": "ANY_OF",
"conditions": [
{
"key": "klevu_price",
"valueOperator": "INCLUDE",
"singleSelect": true,
"excludeValuesInResult": true,
"values": [
"20 - 25"
]
},
{
"key": "itemGroupId",
"valueOperator": "EXCLUDE",
"singleSelect": false,
"values": [
"4384028262462"
]
},
{
"key": "size",
"valueOperator": "EXCLUDE",
"singleSelect": false,
"values": [
"Small",
"Large"
]
},
{
"key": "brand",
"valueOperator": "EXISTS"
},
{
"key": "discount",
"valueOperator": "NOT_EXISTS"
}
]
},
"query": {
"term": "tee"
},
"limit": 2
}
}
]
})
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
{
"meta": {
"qTime": 9,
"responseCode": 200
},
"queryResults": [
{
"id": "productSearch",
"meta": {
"qTime": 7,
"noOfResults": 2,
"totalResultsFound": 6,
"typeOfSearch": "WILDCARD_AND",
"offset": 0,
"debuggingInformation": {},
"notificationCode": 1,
"searchedTerm": "tee",
"apiKey": "klevu-156925593843210765",
"isPersonalised": false
},
"records": [
{
"discount": "",
"hideGroupPrices": "",
"type": "Tees",
"itemGroupId": "4384027344958",
"freeShipping": "",
"storeBaseCurrency": "GBP",
"price": "24.00",
"toPrice": "",
"imageUrl": "https://cdn.shopify.com/s/files/1/0116/9457/1582/products/ws05-yellow_main_fe09e105-6b7e-4269-9b53-edc3735127ba_medium.jpg?v=1575477895",
"currency": "GBP",
"inStock": "yes",
"id": "31366447038526",
"imageHover": "",
"sku": "WS05-XS-Yellow",
"brand": "KKE",
"basePrice": "24.0",
"startPrice": "",
"image": "https://cdn.shopify.com/s/files/1/0116/9457/1582/products/ws05-yellow_main_fe09e105-6b7e-4269-9b53-edc3735127ba_medium.jpg?v=1575477895",
"deliveryInfo": "",
"hideAddToCart": "",
"salePrice": "24.0",
"swatchesInfo": "",
"weight": "",
"klevu_category": "KLEVU_PRODUCT;Products;;Tees @ku@kuCategory@ku@",
"totalVariants": 0,
"groupPrices": "",
"url": "https://jsv2-shopify-demo.ksearchmisc.com/products/desiree-fitness-tee-yellow",
"tags": "comfort, flattering fit, micro-sleeve, summer, v-neck",
"size": "Medium",
"name": "Desiree Fitness Tee",
"shortDesc": "When you're too far to turn back, thank yourself for choosing the Desiree Fitness Tee. Its ultra-lightweight, ultra-breathable fabric wicks sweat away from your body and helps keeps you cool for the distance. • Short-Sleeves. • Performan",
"category": "Tees",
"typeOfRecord": "KLEVU_PRODUCT"
},
{
"discount": "",
"hideGroupPrices": "",
"type": "Tees",
"itemGroupId": "4384047759422",
"freeShipping": "",
"storeBaseCurrency": "GBP",
"price": "24.00",
"toPrice": "",
"imageUrl": "https://cdn.shopify.com/s/files/1/0116/9457/1582/products/ms01-yellow_main_11be227e-034a-4bb1-ae91-ef28227d26ed_medium.jpg?v=1575478213",
"currency": "GBP",
"inStock": "yes",
"id": "31366478200894",
"imageHover": "",
"sku": "MS01-XS-Yellow",
"brand": "MNH",
"basePrice": "24.0",
"startPrice": "",
"image": "https://cdn.shopify.com/s/files/1/0116/9457/1582/products/ms01-yellow_main_11be227e-034a-4bb1-ae91-ef28227d26ed_medium.jpg?v=1575478213",
"deliveryInfo": "",
"hideAddToCart": "",
"salePrice": "24.0",
"swatchesInfo": "",
"weight": "",
"klevu_category": "KLEVU_PRODUCT;Products;;Tees @ku@kuCategory@ku@",
"totalVariants": 0,
"groupPrices": "",
"url": "https://jsv2-shopify-demo.ksearchmisc.com/products/aero-daily-fitness-tee-yellow",
"tags": "Comfort, crew-neck, machine, relaxed-fit, short-sleev, Yellow",
"size": "Medium",
"name": "Aero Daily Fitness Tee",
"shortDesc": "Need an everyday action tee that helps keep you dry? The Aero Daily Fitness Tee is made of 100% polyester wicking knit that funnels moisture away from your skin. Don't be fooled by its classic style; this tee hides premium performance technology b",
"category": "Tees",
"typeOfRecord": "KLEVU_PRODUCT"
}
],
"filters": []
}
]
}