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

Draft
julitafalcondusza wants to merge 1 commit into
base: 5.0
Choose a base branch
from
Draft

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

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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/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/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.
37 changes: 37 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,37 @@
---
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]([[= user_doc =]]/content_management/pages/page_builder_guide/).

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"}

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:
- [Other customers have also seen this content]([[= user_doc =]]/content_management/block_reference.md#other-customers-have-also-seen-this-content-block)
- [Most popular content]([[= user_doc =]]/content_management/block_reference.md#most-popular-content-block)
- [Personalized content recommendations]([[= user_doc =]]/content_management/block_reference.md#personalized-content-recommendations-block)
- **Recommendations: Product** - displays product suggestions based on visitors’ browsing history:
- [Most popular products in category]([[= user_doc =]]/content_management/block_reference.md#most-popular-products-in-category-block)
- [Most popular products]([[= user_doc =]]/content_management/block_reference.md#most-popular-products-block)
- [Other customers have also seen]([[= user_doc =]]/content_management/block_reference.md#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 =]]/content_management/block_reference.md#the-personal-shopping-assistant-block)
- [User's item history or current basket items sorted by recent items or top items]([[= user_doc =]]/content_management/block_reference.md#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.

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

For a complete description of Recommendation blocks and list of all page blocks that are available in [[= product_name =]], see [Page block reference]([[= 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
- Search:
- Search: search/search.md
- Search engines:
Expand Down
Loading