Skip to content

IBX-11150: Recommendation blocks described in Dev-doc #3103

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
julitafalcondusza wants to merge 6 commits into from
+43 −0
Closed

IBX-11150: Recommendation blocks described in Dev-doc #3103

Show file tree
Hide file tree
Changes from 4 commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
edb41c4
Recommendation blocks described in dev-doc
julitafalcondusza Mar 24, 2026
df049c8
links fixes
julitafalcondusza Mar 30, 2026
0446ff3
fixes
julitafalcondusza Mar 30, 2026
7ce247b
page removed (another PR)
julitafalcondusza Mar 30, 2026
ebdf471
first-line title added
julitafalcondusza Apr 2, 2026
5116905
fixes after rev
julitafalcondusza Apr 2, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added docs/cdp/raptor_integration/img/advanced_settings.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/cdp/raptor_integration/img/recommendation_blocks.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
38 changes: 38 additions & 0 deletions docs/cdp/raptor_integration/pb_blocks.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
---
description: Recommendation blocks in Page Builder
edition: experience
---

One of the Raptor Integration elements is the introduction of recommendation blocks available in the [Page Builder](page_builder_guide.md).

Each Content, Product, or Commerce recommendation can be added to a landing page using the blocks.

Check notice on line 8 in docs/cdp/raptor_integration/pb_blocks.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/cdp/raptor_integration/pb_blocks.md#L8 

[Ibexa.Passive] Try to avoid passive tense, when possible.
Raw output 
{"message": "[Ibexa.Passive] Try to avoid passive tense, when possible.", "location": {"path": "docs/cdp/raptor_integration/pb_blocks.md", "range": {"start": {"line": 8, "column": 55}}}, "severity": "INFO"}

Check notice on line 8 in docs/cdp/raptor_integration/pb_blocks.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/cdp/raptor_integration/pb_blocks.md#L8 

[Ibexa.ByUsing] Prefer 'by using' or 'with' to plain 'using'.
Raw output 
{"message": "[Ibexa.ByUsing] Prefer 'by using' or 'with' to plain 'using'.", "location": {"path": "docs/cdp/raptor_integration/pb_blocks.md", "range": {"start": {"line": 8, "column": 77}}}, "severity": "INFO"}
Comment thread
julitafalcondusza marked this conversation as resolved.
Outdated

Editors can configure these blocks to display:

Check notice on line 11 in docs/cdp/raptor_integration/pb_blocks.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/cdp/raptor_integration/pb_blocks.md#L11 

[Ibexa.Lists] Verify list formatting: Full sentences should start with uppercase and end with a period. Sentence fragments should start with lowercase and have no period.
Raw output 
{"message": "[Ibexa.Lists] Verify list formatting: Full sentences should start with uppercase and end with a period. Sentence fragments should start with lowercase and have no period.", "location": {"path": "docs/cdp/raptor_integration/pb_blocks.md", "range": {"start": {"line": 11, "column": 1}}}, "severity": "INFO"}
- Personalized product recommendations
- Related articles or content
- Recently viewed or popular items

Check notice on line 14 in docs/cdp/raptor_integration/pb_blocks.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/cdp/raptor_integration/pb_blocks.md#L14 

[Ibexa.Lists] Verify list formatting: Full sentences should start with uppercase and end with a period. Sentence fragments should start with lowercase and have no period.
Raw output 
{"message": "[Ibexa.Lists] Verify list formatting: Full sentences should start with uppercase and end with a period. Sentence fragments should start with lowercase and have no period.", "location": {"path": "docs/cdp/raptor_integration/pb_blocks.md", "range": {"start": {"line": 14, "column": 1}}}, "severity": "INFO"}

In the toolbar, corresponding categories for recommendation blocks are available, containing sets of blocks depending on the recommendation type:

- **Recommendations: Content** - presents content recommendations:
- [Most popular content]([[= user_doc =]]/personalization/raptor_integration/raptor_recommendation_blocks/#most-popular-content-block)
- [Other customers have also seen this content]([[= user_doc =]]/personalization/raptor_integration/raptor_recommendation_blocks/#other-customers-have-also-seen-this-content-block)
- [Personalized content recommendations]([[= user_doc =]]/personalization/raptor_integration/raptor_recommendation_blocks/#personalized-content-recommendations-block)
- **Recommendations: Product** - displays product suggestions based on visitors’ browsing history:
- [Most popular products]([[= user_doc =]]/personalization/raptor_integration/raptor_recommendation_blocks/#most-popular-products-block)
- [Most popular products in category]([[= user_doc =]]/personalization/raptor_integration/raptor_recommendation_blocks/#most-popular-products-in-category-block)
- [Other customers have also seen]([[= user_doc =]]/personalization/raptor_integration/raptor_recommendation_blocks/#other-customers-have-also-seen-block)
- **Recommendations: Commerce** - shows recommendations based on visitors' purchase history (buy and basket events):
- [The Personal Shopping Assistant]([[= user_doc =]]/personalization/raptor_integration/raptor_recommendation_blocks/#the-personal-shopping-assistant-block)
- [User's item history or current basket items sorted by recent items or top items]([[= user_doc =]]/personalization/raptor_integration/raptor_recommendation_blocks/#users-item-history-or-current-basket-items-sorted-by-recent-items-or-top-items-block)

![Recommendation blocks](img/recommendation_blocks.png)

After opening the settings of a recommendation block, a link is available at the bottom of the window.
It leads to the Raptor Control Panel (opens in a separate tab), where you can configure advanced settings and fine-tune the recommendation strategy.
Comment thread
julitafalcondusza marked this conversation as resolved.
Outdated

![Advanced settings](img/advanced_settings.png)

For a complete description of Recommendation blocks see [Recommendation blocks]([[= user_doc =]]/personalization/raptor_integration/raptor_recommendation_blocks/).
For the list of all page blocks that are available in Page Builder, see [Block reference page]([[= user_doc =]]/content_management/block_reference/).
2 changes: 2 additions & 0 deletions mkdocs.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -508,6 +508,8 @@ nav:
- CDP add client-side tracking: cdp/cdp_activation/cdp_add_clientside_tracking.md
- CDP data export schedule: cdp/cdp_data_export_schedule.md
- CDP data customization: cdp/cdp_data_customization.md
- Integration with Raptor:
- Recommendations blocks: cdp/raptor_integration/pb_blocks.md
Comment thread
julitafalcondusza marked this conversation as resolved.
Outdated
- Search:
- Search: search/search.md
- Search engines:
Expand Down
Loading