> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/integration/feature-integrations/category-cross-sell/difference-between-category-and-category-cross-sell-placements.md).

# Difference Between Category and Category Cross-sell Placements

## Category placements

category placement is a organic category placement. Products will only appear in categories they can should go in. You’re able to pick multiple products over multiple categories, and the right products will serve in the right categories.

| Categories targeted         | Product | Organic category | Serves in |
| --------------------------- | ------- | ---------------- | --------- |
| <p>Chocolate<br>Laundry</p> | 123ABC  | Chocolate        | Chocolate |
| <p>Chocolate<br>Laundry</p> | 245DEF  | Laundry          | Laundry   |

For organic category placements, advertisers will only see the relevant categories to select for their campaign, based on the products they have selected.

{% hint style="info" %}
Do you see category IDs when using this stage?

If you're seeing category numbers or UUIDs in this stage, you will need to use the [filterMapping](/retail-media-interface/integration/citrus-filter-mapping-api/filtermapping.md) endpoint to map your category IDs to human readable names/
{% endhint %}

## Category cross-sell placements when a category cross-sell mapping is provided

A category cross-sell placement is a non-organic category placement. Products will only appear in categories they should go in according to the retailer’s mappings. Users are able to pick multiple products over multiple categories, and the right products will serve in the right categories.

| Categories targeted                      | Product | Organic category | Cross-sell category mapping | Serves in       |
| ---------------------------------------- | ------- | ---------------- | --------------------------- | --------------- |
| <p>Milk<br>Fabric Softener<br>Laptop</p> | 000AAA  | Chocolate        | Milk                        | Milk            |
| <p>Milk<br>Fabric Softener<br>Laptop</p> | 123ABC  | Washing Powder   | Fabric Softener             | Fabric Softener |

In the UI, advertisers will only see categories mapped by you, the retailer as allowed combinations (such as chocolate -> milk).

Details on how to synchronise category cross-sell mappings is available here: [Integration requirements](/retail-media-interface/integration/feature-integrations/category-cross-sell/integration-requirements.md).

## Category cross-sell placements when a category cross-sell mapping is not provided

Without a feed provided, advertisers are able to target any categories on the retailer’s site.

| Categories targeted                      | Product | Organic category | Serves in                                |
| ---------------------------------------- | ------- | ---------------- | ---------------------------------------- |
| <p>Milk<br>Fabric Softener<br>Laptop</p> | 000AAA  | Chocolate        | <p>Milk<br>Fabric Softener<br>Laptop</p> |
| <p>Milk<br>Fabric Softener<br>Laptop</p> | 123ABC  | Washing Powder   | <p>Milk<br>Fabric Softener<br>Laptop</p> |

{% hint style="danger" %}
️ Review workload

Whilst it is easiest to enable a category cross-sell placement without a mapping, it will increase your team's workload of managing and reviewing campaigns.
{% endhint %}

In the UI, advertisers will see any category in the catalog(s) they have selected.

When reviewing campaigns, you then need to ensure you are satisfied with the campaign and its targeted categories.

Example scenario:

* A campaign has a milk product and a chocolate cookie. The advertiser has selected a milk and chocolate cookies category. When an ad request comes in for the category for milk, both products are served.

Impacts:

* This type of placement is great for retailers that want advertisers to target any category they choose to, subject to retailer approval.
* Brands must create campaigns in relevant category groupings to ensure relevancy
* If a brand creates a campaign and selects a kettle, tv, and headphones, then targets those relevant categories, the TV can serve in kettle.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.citrusad.com/retail-media-interface/integration/feature-integrations/category-cross-sell/difference-between-category-and-category-cross-sell-placements.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.