> 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/de/feature-integrations/location-targeting.md).

# Standort-Targeting

Standort-Targeting ermöglicht es Werbetreibenden oder Händlern, bestimmte Standorte (wie Geschäfte oder Bundesländer) in ihren Kampagnen anzusprechen. Dies kann bei breit angelegten Platzierungen genutzt werden, um eine Zielgruppe auf einen bestimmten Standort einzuschränken.

{% hint style="success" %}
Wir empfehlen diese Erweiterung für breite Display-Platzierungen

Unsere bewährte Praxis ist es, dies auf Kategorie- oder breiten Display-Platzierungen zu integrieren, da diese eher stöberbasiert sind. Wir empfehlen dies nicht für Such-Platzierungen, da Kampagnen bereits auf die Absicht ausgerichtet sind und dies die auswählbare Zielgruppe des Werbetreibenden verringern kann.
{% endhint %}

## High-Level-Übersicht

Unsere Standort-Targeting-Funktion ermöglicht es Werbetreibenden, Standorte im Kampagnen-Assistenten auszuwählen. Dies kann auf Platzierungsebene für Suche-, Kategorie- und breite Display-Platzierungen aktiviert werden. Ein Beispiel für die Benutzeroberfläche finden Sie unten:

<figure><img src="/files/ooIxixEEBW2xz9MhCfcz" alt="" width="100%"><figcaption></figcaption></figure>

Die Funktion funktioniert ähnlich wie unsere Kategorie-Targeting-Funktion und ermöglicht es Werbetreibenden, Standorte auszuwählen, die auf ihren ausgewählten Produkten synchronisiert sind. Sobald Standorte ausgewählt wurden, können sie in den Bildschirmen für die Überprüfung und den Kampagnen-Manager eingesehen werden.

<figure><img src="/files/QjeUQqpYcEphLqJtQolE" alt="" width="100%"><figcaption></figcaption></figure>

## Integrationsübersicht

Im Rahmen dieser Integration müssen Sie Folgendes tun

1. Synchronisieren Sie Filter auf Standortebene für Ihre Produkte
2. Synchronisieren Sie benutzerfreundliche Standortnamen oder verknüpfen Sie Standorte miteinander über die [filterMapping](/retail-media-interface/integration/de/citrus-filter-mapping-api/filtermapping.md) API (Bedingt durch Integration)
   1\.
   1. Dies gilt nur, wenn Sie mit Standort-IDs statt mit Namen integriert sind oder wenn Sie Standorte miteinander verknüpfen möchten (z. B. die Synchronisierung von Filialen und deren Verknüpfung mit Bundesländern).
3. Erweitern Sie Ihre Anzeigenanfrage, um Standortfilter anzufordern

### Filter auf Standortebene für Ihre Produkte synchronisieren

Um Standorte in der Benutzeroberfläche anzuzeigen, müssen die relevanten Daten (Verfügbarkeit) für jedes Produkt synchronisiert werden. Je nach Integration synchronisieren Sie diese Informationen möglicherweise bereits, um die Anzeigen-Ausfüllrate zu verbessern.

#### Synchronisierung über die API

Wenn Sie [Produkt-Synchronisierung über API](/retail-media-interface/integration/de/data-api/catalog-products-2/syncing-products-via-api.md), müssen Sie jedes Produkt mit den relevanten Standorten im `filters` Objekt aktualisieren. Ein Beispiel ist im Abschnitt [Synchronisieren von Standortinformationen](/retail-media-interface/integration/de/data-api/catalog-products-2/syncing-products-via-api.md#syncing-location-information) auf der Seite "Produkte über die API synchronisieren" ausführlich beschrieben.

#### Synchronisierung über Datei

Wenn Sie [Synchronisieren von Katalog & Produkten über Datei](/retail-media-interface/integration/de/data-api/catalog-products-2/syncing-catalog-products-via-file.md), müssen Sie wahrscheinlich lediglich eine zusätzliche Spalte zu Ihrer Datei hinzufügen, die die relevanten Standorte angibt, in denen jedes Produkt vorrätig ist. Dies ist einfach eine weitere Spalte namens `location`.

{% hint style="info" %}
Format des Standortfilters

Wir empfehlen dringend, dass das Format Ihrer Standortfilter `location:<value>`ist. Dieses Format wird in der Reporting-API korrekt angezeigt. Dies ist dasselbe Format, das die Anzeigenanfrage verwenden muss, um Anzeigen auszuliefern.

Wenn Sie über eine Datei synchronisieren, kann Ihr Client Integration Engineer dies korrekt für Sie zuordnen.
{% endhint %}

### Synchronisierung von Standortnamen über die filterMapping-API

Die Filter-Mapping-API kann verwendet werden, um Ihre Standort-IDs lesbaren Werten zuzuordnen. Dies ist erforderlich, wenn Sie Standort-IDs synchronisieren, da die Benutzeroberfläche die Werte Ihren Benutzern anzeigt. Wenn Sie einstufige Filter (z. B. Bundesland) synchronisieren, zeigt die Benutzeroberfläche jede Auswahl wie unten dargestellt an:

<figure><img src="/files/ooIxixEEBW2xz9MhCfcz" alt="" width="100%"><figcaption></figcaption></figure>

Wenn Sie Geschäfte Bundesländern oder einem ähnlichen Aggregat zuordnen, wird bei jeder Auswahl die Anzahl der Standortfilter angezeigt, die sie repräsentiert:

<figure><img src="/files/1FzE8cIL0bLyF1Is9wvD" alt="" width="100%"><figcaption></figcaption></figure>

<br>

{% hint style="info" %}
Wenn Sie lesbare Bundesländer als Standorte in Ihrem Produktkatalog mit Epsilon Retail Mediasynchronisieren, ist dieser Schritt nicht erforderlich.
{% endhint %}

#### Erweiterung Ihrer Anzeigenanfrage

Je nach Integration synchronisieren Sie diese Informationen möglicherweise bereits, um die Anzeigen-Ausfüllrate zu verbessern. Dies beinhaltet die Erweiterung Ihrer Anfrage zur Angabe des Standorts des Benutzers im `productFilters` Objekt.

Das Format Ihrer Anfrage sollte der unten aufgeführten Anzeigenanfrage entsprechen:

* [Produktanzeige – Filtern nach Standort](/retail-media-interface/integration/de/generating-ads/product-ads/requesting-product-ads-1.md#filtering-by-location)
* [Banner-Anzeige – Filtern nach Standort](/retail-media-interface/integration/de/generating-ads/banner-ads-static/requesting-banner-ads.md#filtering-by-location)
* [Banner X – Filtern nach Standort](/retail-media-interface/integration/de/generating-ads/banner-x-responsive/requesting-banner-x-ads.md#filtering-by-location)

{% hint style="warning" %}
Standort-Targeting nur zu einer ausgewählten Platzierung hinzufügen?

Sie möchten diese Erweiterung möglicherweise für alle Ihre Platzierungen implementieren. Dies standardisiert Ihre Implementierung über alle Platzierungen hinweg, selbst wenn Sie das Targeting nur für ausgewählte Platzierungen aktivieren.
{% endhint %}

## Bekannte Einschränkungen der Funktion

Bevor Sie mit der Entwicklung beginnen, empfehlen wir Ihnen, die folgenden Einschränkungen dieser Funktionalität zu verstehen

* Diese Funktion nutzt Filter, die auf Produkten synchronisiert sind. Wir empfehlen sicherzustellen, dass Sie durch die Synchronisierung der Produkt-Standort-Verfügbarkeit innerhalb der unterstützten SLA bleiben [Service-Level-Agreement](https://citrusad.service-now.com/csm/en/service-support-agreement-service-offerings?id=kb_article_view\&sys_kb_id=c508eee097438d100c0fb18fe153af42)
* Diese Funktion ist nicht kompatibel mit Kategorie-Cross-Selling- oder Legacy-Produkt-Cross-Selling-Platzierungen.
* Es gibt kein In-UI-Reporting nach den in einer Kampagne ausgewählten Standorten
  * Diese Informationen werden in den Datensätzen für das Reporting auf Faktenebene für Händler angezeigt, die die Reporting-API nutzen. Berichte auf Standortebene stehen Händlern zur Verfügung, um Berichte bei Bedarf in externen Systemen zu konsolidieren.
* Buchungen für Feste Platzierung ermöglichen Ihnen die Auswahl von Standorten für eine Kampagne, aber Buchungen können nicht auf Kampagnenebene vorgenommen werden
  * Buchungen erfolgen auf Kategorie-, Suchbegriff- oder Platzierungsebene (für breite Display-Platzierungen)


---

# 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/de/feature-integrations/location-targeting.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.
