Personalized promotions
Use of the personalized promotion feature is in the works. Some things can already be done from the Personalized promotions chapter and some via services. Here we will cover the services part of this equation. Creating and managing personalized promotion product lists and tagging those to the desired users is what we'll cover on this page. Once things are fully frontend developed, you'll no longer need to use the services mentioned here, unless you savvy a more geeky route of getting things done.
Adding products to the promotion list
Using the following service you can add products to a consumers promotion product list or to create one if it's the first product in that list. Note here that creating a personalized promotion is a prerequisite. Again, docs on this can be found here. The reset has to do with specifying which user this personalized promotion targets, and which product(s) will the user be able to choose from.
Here is a sample to show how this is done:
{
"PersonalizedPromotionID":1,
"UserID":49,
"ProductIDs":73
}
{}
Removing products from promotion list
Using the following service you can remove products from a consumers existing personalized promotion product list.
Here is a sample to show how this is done:
{
"UserID":49,
"PersonalizedPromotionID":1,
"ProductIDs":74
}
{}
Get products from promotion list
Using the following service you can see the product(s) included in a consumers personalized promotion product list.
Here is a sample to show how this is done:
{
"UserID":49,
"PersonalizedPromotionID":1
}
{
"PersonalizedPromotionID": 1,
"Name": "Personalized promo 1",
"Description": "This is my first pp",
"ApplicableProducts": [
{
"product_id": 73,
"display_value": "New Black Beanie",
"custom_id": "012-1-978020137055",
"backend_id": "012-1-978020137055",
"long_description": "Comfortable, warm and stylish; this beanie is a real feel-good basic for the colder days.",
"product_type": 1,
"product_status": 0,
"barcodes": [
"978020137055"
],
"publication": [
"public"
],
"product_media": {
"media": [
{
"blob": "a33e03d0-a898-4022-ae73-fac1b619330e",
"name": "crap-its-cold-beanie1.png",
"type": "image/png",
"id": "a33e03d0-a898-4022-ae73-fac1b619330e"
},
{
"blob": "46acf5e2-da38-43dd-9c61-6721bec62d48",
"name": "wuda2pB7Y0ClSMX2Wpjk5A==",
"type": "image/png",
"id": "wuda2pB7Y0ClSMX2Wpjk5A==",
"url": "https://assets.ka59raq2.on-eva.io/blob/46acf5e2-da38-43dd-9c61-6721bec62d48"
},
{
"blob": "3f3f9b9c-354d-44f1-8bcb-5e6ed5430ae3",
"name": "Z5KYdF5TKjRtgK7u/oJmfw==",
"type": "image/png",
"id": "Z5KYdF5TKjRtgK7u/oJmfw==",
"url": "https://assets.ka59raq2.on-eva.io/blob/3f3f9b9c-354d-44f1-8bcb-5e6ed5430ae3"
}
],
"gallery": [
"a33e03d0-a898-4022-ae73-fac1b619330e",
"46acf5e2-da38-43dd-9c61-6721bec62d48",
"3f3f9b9c-354d-44f1-8bcb-5e6ed5430ae3"
],
"image_count": 3,
"primary_image": {
"blob": "a33e03d0-a898-4022-ae73-fac1b619330e",
"name": "crap-its-cold-beanie1.png",
"type": "image/png"
}
},
"primary_image": {
"blob": "a33e03d0-a898-4022-ae73-fac1b619330e",
"name": "crap-its-cold-beanie1.png",
"type": "image/png"
},
"display_price": 12.99,
"recommended_retail_price": null,
"potential_discounted_price": null,
"original_price": null,
"price_label": null,
"potential_discounted_price_label": null,
"eco_tax": null,
"currency_id": "EUR",
"product_types": [
1
],
"has_product_requirements": false,
"has_product_requirements_so": false,
"language_id": "en",
"composed_on": "2023-04-28T13:11:07.0740599Z",
"backend_status": 1,
"sellable_since": "2022-05-20T14:25:29.68Z",
"composed_by": 45,
"slug": "new-black-beanie",
"primitive_name": "New Black Beanie",
"assortment_id": 1,
"tax_code_id": 6,
"category_headwear": true,
"has_product_requirements_po": false,
"is_new": false,
"application_id": 1,
"is_sellable": true,
"product_statuses": [],
"country_id": "NL",
"types": [
{
"type_id": "has_product_requirements",
"category_id": "default",
"hidden": false,
"filterable": true,
"search_type": 1,
"data_type": 3,
"array": false
},
{
"type_id": "has_product_requirements_so",
"category_id": "default",
"hidden": false,
"filterable": true,
"search_type": 1,
"data_type": 3,
"array": false
},
{
"type_id": "tax_code_id",
"category_id": "default",
"hidden": false,
"filterable": true,
"search_type": 1,
"data_type": 1,
"array": false
},
{
"type_id": "category_headwear",
"category_id": "default",
"hidden": false,
"filterable": true,
"search_type": 1,
"data_type": 3,
"array": false
},
{
"type_id": "has_product_requirements_po",
"category_id": "default",
"hidden": false,
"filterable": true,
"search_type": 1,
"data_type": 3,
"array": false
}
],
"categories": [
{
"category_id": "default"
}
]
}
],
"MaximumDistinctProducts": 1,
"IsLocked": false
}
Listing personalized promotions for user
Using the following service you can see the personalized promotion(s) tagged to a specific consumer.
Here is a sample to show how this is done:
{
"UserID":49,
}
{
"PersonalizedPromotions": [
{
"ID": 1,
"Name": "Personalized promo 1",
"Description": "This is my first pp",
"MaximumDistinctProducts": 1,
"LockAfterFirstApply": true,
"IsLocked": false
}
]
}