From 687d9f1795a62c4edcd29f92306d6d5aa322e03d Mon Sep 17 00:00:00 2001 From: julitafalcondusza Date: Wed, 6 May 2026 12:03:00 +0200 Subject: [PATCH 1/6] category parameter described --- .../events/category_parameter.html.twig | 11 +++++++ .../raptor_integration/tracking_php_api.md | 29 +++++++++++++++++-- 2 files changed, 38 insertions(+), 2 deletions(-) create mode 100644 code_samples/recommendations/events/category_parameter.html.twig diff --git a/code_samples/recommendations/events/category_parameter.html.twig b/code_samples/recommendations/events/category_parameter.html.twig new file mode 100644 index 0000000000..16d67a06f1 --- /dev/null +++ b/code_samples/recommendations/events/category_parameter.html.twig @@ -0,0 +1,11 @@ +{% block content %} +
+

{{ product.name }}

+ {# ... product content ... #} +
+ + {# Track with category identifier - automatic loading and formatting #} + {{ ibexa_tracking_track_event('visit', product, { + 'categoryIdentifier': 'electronics' + }) }} +{% endblock %} diff --git a/docs/recommendations/raptor_integration/tracking_php_api.md b/docs/recommendations/raptor_integration/tracking_php_api.md index 6bc71c778a..0d996e7b72 100644 --- a/docs/recommendations/raptor_integration/tracking_php_api.md +++ b/docs/recommendations/raptor_integration/tracking_php_api.md @@ -9,7 +9,7 @@ You can interact directly with the [Raptor connector](raptor_connector.md)'s ser ## Advanced usage – direct interaction with the service -The [`ServerSideTrackingDispatcherInterface::dispatch()`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-ConnectorRaptor-Tracking-ServerSideTrackingDispatcherInterface.html#method_dispatch) method allows to send tracking data from the server side. +The [`ServerSideTrackingDispatcherInterface::dispatch()`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-ConnectorRaptor-Tracking-ServerSideTrackingDispatcherInterface.html#method_dispatch) method allows sending tracking data from the server side. It can be used in controllers, event subscribers, or any other part of the application. This method receives an [`EventDataInterface`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-ConnectorRaptor-Tracking-Event-EventDataInterface.html). For more information, see the available events in the [tracking event namespace](/api/php_api/php_api_reference/namespaces/ibexa-contracts-connectorraptor-tracking-event.html). @@ -37,9 +37,34 @@ Check the following example: [[= include_file('code_samples/recommendations/EventMapper.php', 20, 27, remove_indent=True) =]] ``` +### Category parameter for product events + +In [[= product_name =]], products can be assigned to multiple categories. +However, Raptor accepts only a single category value in tracking events. + +By default, the connector uses the first category from the list of categories assigned to the product. +You can override this behavior and define which category is sent in tracking events. + +To do this: + +1. Open the product page in the back office. +2. Check the categories assigned to the product and select the one you want to use. +3. Copy the identifier. +4. Pass this identifier as the category parameter in the tracking event. + +!!! note + + This option applies only to product-related tracking events. + +Example: + +``` twig+html +[[= include_file('code_samples/recommendations/events/category_parameter.html.twig') =]] +``` + ### Manual `EventData` creation -Manual creation of EventData allows precise control over the events sent to the service. +Manual creation of `EventData` allows precise control over the events sent to the service. It enables you to define custom event parameters, track specific user interactions, and tailor data collection to advanced use cases. Check the following example: From 89021692086f2805fd3ff2cfbf4b685af2e8e377 Mon Sep 17 00:00:00 2001 From: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> Date: Tue, 2 Jun 2026 10:11:02 +0200 Subject: [PATCH 2/6] Add release note --- docs/release_notes/ibexa_dxp_v5.0.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/release_notes/ibexa_dxp_v5.0.md b/docs/release_notes/ibexa_dxp_v5.0.md index f37346e224..61942c5d05 100644 --- a/docs/release_notes/ibexa_dxp_v5.0.md +++ b/docs/release_notes/ibexa_dxp_v5.0.md @@ -56,6 +56,12 @@ A new `cookie_id_lifetime_days` configuration option controls the lifetime in da For more information, see [connector installation and configuration](https://doc.ibexa.co/en/5.0/recommendations/raptor_integration/connector_installation_configuration/). +#### Category parameter for product events + +You can define which product category is sent in tracking events. + +For more information, see [Category parameter for product events](https://doc.ibexa.co/en/5.0/recommendations/raptor_integration/tracking_php_api/#category-parameter-for-product-events). + ### Anonymous user segmentation in [[= product_name_cdp =]] [[% include 'snippets/experience_badge.md' %]] [[% include 'snippets/commerce_badge.md' %]] [[= product_name_cdp =]] can now build audiences for anonymous visitors. From 0429da238949ec03dfe6bb68bbda42d2bfce993f Mon Sep 17 00:00:00 2001 From: julitafalcondusza Date: Tue, 2 Jun 2026 10:15:15 +0200 Subject: [PATCH 3/6] RN added --- docs/release_notes/ibexa_dxp_v5.0.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/release_notes/ibexa_dxp_v5.0.md b/docs/release_notes/ibexa_dxp_v5.0.md index 61942c5d05..4560577dcb 100644 --- a/docs/release_notes/ibexa_dxp_v5.0.md +++ b/docs/release_notes/ibexa_dxp_v5.0.md @@ -50,6 +50,15 @@ Four new recommendation blocks are available in Page Builder: For more information, see [recommendation blocks](https://doc.ibexa.co/en/5.0/recommendations/raptor_integration/recommendation_blocks/). +#### Category parameter for product events + +You can now configure which product category is sent in tracking events. + +By default, the connector uses the first category assigned to a product. +Since Raptor accepts only a single category value, you can override this behavior and select a different category to be included in tracking events. + +To learn more, see [category parameter for product events](https://doc.ibexa.co/en/5.0/recommendations/raptor_integration/tracking_php_api/#category-parameter-for-product-events). + #### Cookie lifetime configuration A new `cookie_id_lifetime_days` configuration option controls the lifetime in days of the server-side tracking identifier cookie. From d7c1a80b6ac25da290f843f764333d3e58034ea4 Mon Sep 17 00:00:00 2001 From: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> Date: Tue, 2 Jun 2026 10:17:35 +0200 Subject: [PATCH 4/6] Revert "Add release note" This reverts commit 89021692086f2805fd3ff2cfbf4b685af2e8e377. --- docs/release_notes/ibexa_dxp_v5.0.md | 6 ------ 1 file changed, 6 deletions(-) diff --git a/docs/release_notes/ibexa_dxp_v5.0.md b/docs/release_notes/ibexa_dxp_v5.0.md index 4560577dcb..01853334b9 100644 --- a/docs/release_notes/ibexa_dxp_v5.0.md +++ b/docs/release_notes/ibexa_dxp_v5.0.md @@ -65,12 +65,6 @@ A new `cookie_id_lifetime_days` configuration option controls the lifetime in da For more information, see [connector installation and configuration](https://doc.ibexa.co/en/5.0/recommendations/raptor_integration/connector_installation_configuration/). -#### Category parameter for product events - -You can define which product category is sent in tracking events. - -For more information, see [Category parameter for product events](https://doc.ibexa.co/en/5.0/recommendations/raptor_integration/tracking_php_api/#category-parameter-for-product-events). - ### Anonymous user segmentation in [[= product_name_cdp =]] [[% include 'snippets/experience_badge.md' %]] [[% include 'snippets/commerce_badge.md' %]] [[= product_name_cdp =]] can now build audiences for anonymous visitors. From b5a5535cf5bd485850db01bdf817cfbfa3820b4f Mon Sep 17 00:00:00 2001 From: julitafalcondusza Date: Tue, 2 Jun 2026 10:35:23 +0200 Subject: [PATCH 5/6] fix --- docs/release_notes/ibexa_dxp_v5.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/release_notes/ibexa_dxp_v5.0.md b/docs/release_notes/ibexa_dxp_v5.0.md index 01853334b9..76a600b9ce 100644 --- a/docs/release_notes/ibexa_dxp_v5.0.md +++ b/docs/release_notes/ibexa_dxp_v5.0.md @@ -55,7 +55,7 @@ For more information, see [recommendation blocks](https://doc.ibexa.co/en/5.0/re You can now configure which product category is sent in tracking events. By default, the connector uses the first category assigned to a product. -Since Raptor accepts only a single category value, you can override this behavior and select a different category to be included in tracking events. +Raptor accepts only a single category value, but you can override this behavior and select a different category to be included in tracking events. To learn more, see [category parameter for product events](https://doc.ibexa.co/en/5.0/recommendations/raptor_integration/tracking_php_api/#category-parameter-for-product-events). From 446b2dcd0eeb0ced90a6aba1a742f844b48b96d1 Mon Sep 17 00:00:00 2001 From: julitafalcondusza Date: Tue, 2 Jun 2026 10:39:34 +0200 Subject: [PATCH 6/6] fix --- docs/release_notes/ibexa_dxp_v5.0.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/release_notes/ibexa_dxp_v5.0.md b/docs/release_notes/ibexa_dxp_v5.0.md index 76a600b9ce..02469e686b 100644 --- a/docs/release_notes/ibexa_dxp_v5.0.md +++ b/docs/release_notes/ibexa_dxp_v5.0.md @@ -54,8 +54,8 @@ For more information, see [recommendation blocks](https://doc.ibexa.co/en/5.0/re You can now configure which product category is sent in tracking events. -By default, the connector uses the first category assigned to a product. -Raptor accepts only a single category value, but you can override this behavior and select a different category to be included in tracking events. +Raptor accepts only a single category value. +By default, the connector uses the first category assigned to a product, but you can override this behavior and select a different category to be included in tracking events. To learn more, see [category parameter for product events](https://doc.ibexa.co/en/5.0/recommendations/raptor_integration/tracking_php_api/#category-parameter-for-product-events).