> For the complete documentation index, see [llms.txt](https://docs.codegiganten.de/plugin-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/conversion-booster.md).

# Conversion Booster

The Conversion Booster shows visitors from Google Shopping or ads the advertised product in a window, with matching alternatives behind it.

{% hint style="info" %}
Available from plan Advanced.
{% endhint %}

The Conversion Booster is meant for visitors who land directly on a product page from Google Shopping or an ad. Instead of the normal product page, they see the advertised product in a window with everything that matters for the purchase. If they close the window, they find a page with matching alternatives behind it. This way you do not lose a visitor just because the advertised product is not quite right.

The booster only appears when the address contains a specific parameter. Without this parameter the product page stays unchanged.

## What the visitor sees

1. The visitor opens a product page with the parameter `cogiReCb=1`, for example from a Google Shopping ad.
2. The normal product page is hidden. In its place, a page with a grid of alternative products from your recommendation template appears.
3. On top of it, a window with the advertised product opens: manufacturer logo, name, price, ratings, variant selection and the buy area of the product page (quantity and "Add to cart"). It also shows the product number, stock and delivery time and, depending on the settings, payment methods, PayPal Express and the product description.
4. When the visitor adds the product to the cart, the window closes.
5. When the visitor closes the window (with the X or the second close button), the grid with the alternatives is shown. The address changes to `cogiReCb=2`.
6. When the visitor selects a different variant in the window, the window is rebuilt with that variant.

In the grid of alternatives, badges are always shown. The number of columns depends on the screen width: four on large screens, then three, two and one on very small screens.

If the template delivers no products, the booster page shows the text "No recommendations available.". This is the only place where Cross Selling Pro shows an empty state. All other elements simply disappear.

## The parameter in the address

| Value                                     | Effect                                                         |
| ----------------------------------------- | -------------------------------------------------------------- |
| `cogiReCb=1` (also `true`, `yes` or `on`) | booster page with the product window open                      |
| `cogiReCb=2` (also `list`)                | booster page with only the grid of alternatives, window closed |
| missing or any other value                | normal product page, the booster stays invisible               |

Add the parameter to the product addresses you use in Google Shopping or in your ads, for example `https://www.your-shop.com/product-xy?cogiReCb=1`. Visitors who reach the product page via categories, the search or links in your shop still see the normal product page.

## Setting it up

{% stepper %}
{% step %}

### Create a template for the alternatives

Create a [recommendation template](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/recommendation-templates.md) that delivers alternatives to the current product, for example with the type "Similar products (alternatives)". The advertised product is the source product.
{% endstep %}

{% step %}

### Add the element to the product page layout

1. Open **Content → Shopping Experiences** and there the layout your product pages use (type product page).
2. From the block category "AI CrossSelling", drag the block **"Cogi Conversion Booster Overlay"** into the layout.
3. Under "Recommendation template", select the template from step 1.
4. Save the layout. If it is not yet assigned to any product, assign it to the products you want or as the default layout.
   {% endstep %}

{% step %}

### Use addresses with the parameter

In Google Shopping or in your ads, add `cogiReCb=1` to the product addresses. To check, open a product page with the parameter yourself.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Since the booster is invisible without the parameter, you can safely place the element in the default layout of your product pages. Nothing changes for all other visitors.
{% endhint %}

{% hint style="warning" %}
The booster belongs in the layout of a **product page**. The advertised product is always the product of that page. You do not need a separate category page or landing page.
{% endhint %}

## Settings in the element

Click the element in the Shopping Experience editor to open its settings.

### Window content

| Setting                    | Effect                                                                                         | Default |
| -------------------------- | ---------------------------------------------------------------------------------------------- | ------- |
| "Recommendation template"  | provides the products for the grid of alternatives                                             | none    |
| "Show product description" | shows the product description in the window                                                    | off     |
| "Show ratings"             | shows the product ratings                                                                      | on      |
| "Show delivery time"       | shows the delivery time of the product                                                         | on      |
| "Show PayPal Express"      | shows the "Buy now with" PayPal button. Only works if the Shopware PayPal plugin is installed. | on      |

### Payment methods

| Setting                      | Effect                                                   | Default |
| ---------------------------- | -------------------------------------------------------- | ------- |
| "Show payment methods"       | shows the payment methods available in the sales channel | on      |
| "Payment method display"     | payment methods as icons or as text                      | icons   |
| "Show payment icon border"   | subtle border around the icons                           | off     |
| "Max. payment methods shown" | at most this many payment methods (1 to 12)              | 6       |

### Styling

| Setting                                                      | Default |
| ------------------------------------------------------------ | ------- |
| "Card background color"                                      | #ffffff |
| "Card border color"                                          | #d9e2ef |
| "Card text color"                                            | #334155 |
| "Card border radius" (CSS value with unit, for example 14px) | 14px    |

### Closing and navigation

| Setting                       | Effect                                                                                                                               | Default                                                         |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------- |
| "Show secondary close button" | shows a second button in the window, in addition to the X, that closes the window                                                    | on                                                              |
| "Close button label"          | text of this button. If the field is empty, it reads "Continue browsing".                                                            | "Weiter shoppen" (preset value, change it for non-German shops) |
| "Enable back navigation"      | The visitor can use the browser's back button to switch between the grid of alternatives and the window with the advertised product. | on                                                              |
| "Stabilize direct entry"      | prevents layout shifts when visitors land directly on the page (for example from Google Shopping)                                    | on                                                              |

## Fallback when the template delivers little

The booster uses the fallback settings of the template ("Fallback threshold (≤)" and "Fallback type"). Unlike in the cart, the fallback "Other template" also works here. Details on the page [Images, prices, fallbacks and visibility](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/images-prices-and-fallbacks.md).

## Measurement and statistics

Cross Selling Pro measures how often the booster appears, how often the advertised product is seen and how often visitors close the window. Purchases after the booster are attributed to it. This attribution only applies to the product on which the booster appeared and lasts one hour.

The browser only stores the identifier for this permanently if the visitor has given consent. Otherwise it is kept only as long as the page is open. More on the page [Tracking and data protection](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/tracking-and-data-protection.md).

The booster is shown separately in the statistics, so you can see its effect apart from the other recommendations. See [Statistics](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/statistics.md).

{% hint style="info" %}
Do not mix them up: the Conversion Booster is this element for visitors from ads. The switch "Prefer products in stock" in the template is also called a booster but has nothing to do with it. It affects the order of the recommendations (see [Weighting, diversity and boosters](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/weighting-and-boosters.md)).
{% endhint %}

## Good to know

* **Plan:** Without the Advanced plan, the booster does not appear in the shop, not even with the parameter. In the editor the element then shows "Not displayed · Available from …".
* **Other visitors:** Without the parameter the element stays invisible. Search engines and regular visitors see the usual product page.
* **Checking:** After setting it up, open a product page once with `?cogiReCb=1` and once with `?cogiReCb=2`. This shows you both views.

## Read more

{% content-ref url="/pages/NpS6UuPrr6DqxFgdMPmA" %}
[Shopping experience elements](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/shopping-experience-elements.md)
{% endcontent-ref %}

{% content-ref url="/pages/hSRY2MxmbdY5dCCa9KY4" %}
[Creating recommendation templates](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/recommendation-templates.md)
{% endcontent-ref %}

{% content-ref url="/pages/H7hG7KNHBotOdMhNijf5" %}
[Requirements and plans](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/requirements-and-plans.md)
{% endcontent-ref %}

{% content-ref url="/pages/I6Hh3YL63avRayt05N4A" %}
[Statistics](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/statistics.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/conversion-booster.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
