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

# Ciblage géographique

Le ciblage géographique permet aux annonceurs ou aux distributeurs de cibler des lieux spécifiques (tels que des magasins ou des États) dans leurs campagnes. Cela peut être utilisé sur des emplacements plus larges pour restreindre une audience à une zone géographique particulière.

{% hint style="success" %}
Nous recommandons cette amélioration sur les emplacements de display larges

Notre bonne pratique consiste à l'intégrer sur des emplacements de catégorie ou de display larges, car ceux-ci sont davantage basés sur la navigation. Nous ne le recommandons pas sur les emplacements de recherche, car les campagnes sont déjà ciblées selon l'intention et cela peut réduire l'audience sélectionnable par l'annonceur.
{% endhint %}

## Présentation générale

Notre fonctionnalité de ciblage géographique permet aux annonceurs de sélectionner des lieux dans l'assistant de campagne. Cela peut être activé au niveau de chaque emplacement pour les emplacements de recherche, de catégorie et de display large. Un exemple de l'interface est présenté ci-dessous :

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

La fonctionnalité fonctionne de manière similaire à notre fonctionnalité de ciblage par catégorie, permettant aux annonceurs de sélectionner des lieux qui sont synchronisés sur leurs produits sélectionnés. Une fois les lieux sélectionnés, ils peuvent être visualisés dans les écrans de vérification et du gestionnaire de campagnes.

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

## Présentation de l'intégration

Dans le cadre de cette intégration, vous devrez effectuer les étapes ci-dessous

1. Synchroniser les filtres au niveau du lieu sur vos produits
2. Synchroniser des noms de lieux lisibles pour l'interface utilisateur ou cartographier les lieux ensemble via l' [filterMapping](/retail-media-interface/integration/fr/citrus-filter-mapping-api/filtermapping.md) API (Sous condition d'intégration)
   1\.
   1. Cela s'applique uniquement si vous êtes intégré avec des identifiants de lieu au lieu de noms, ou si vous souhaitez associer des lieux entre eux (comme synchroniser des magasins et vouloir les associer à des États).
3. Enrichir votre demande de pub pour solliciter des filtres de lieu

### Synchroniser les filtres au niveau du lieu sur vos produits

Pour faire apparaître les lieux dans l'interface utilisateur, les données pertinentes (disponibilité) doivent être synchronisées sur chaque produit. Selon votre intégration, vous synchronisez peut-être déjà ces informations pour améliorer le taux de remplissage publicitaire.

#### Synchronisation via API

Si vous utilisez [Synchronisation des produits via l'API](/retail-media-interface/integration/fr/data-api/catalog-products-2/syncing-products-via-api.md), vous devrez mettre à jour chaque produit avec les lieux correspondants dans l' `filters` objet. Un exemple est détaillé dans la [Synchronisation des informations d'emplacement](/retail-media-interface/integration/fr/data-api/catalog-products-2/syncing-products-via-api.md#syncing-location-information) section de la page Synchronisation des produits via l'API.

#### Synchronisation via un fichier

Si vous utilisez [Synchronisation du catalogue et des produits par fichier](/retail-media-interface/integration/fr/data-api/catalog-products-2/syncing-catalog-products-via-file.md), il vous suffit vraisemblablement d'ajouter une colonne supplémentaire à votre fichier spécifiant le ou les lieux pertinents dans lesquels chaque produit est stocké. Il s'agira simplement d'une autre colonne nommée `location`.

{% hint style="info" %}
Format des filtres de lieu

Nous recommandons fortement que le format de vos filtres de lieu soit `location:<value>`. Ce format apparaîtra correctement dans l'API de reporting. C'est le même format que la demande de pub devra utiliser pour diffuser des publicités.

Si vous effectuez la synchronisation via un fichier, votre ingénieur d'intégration client peut configurer ce mappage correctement pour vous.
{% endhint %}

### Synchronisation des noms de lieux via l'API filterMapping

L'API de mappage de filtres peut être utilisée pour associer vos identifiants de lieu à des valeurs lisibles par l'homme. Cela est requis si vous synchronisez des identifiants de lieu, car l'interface utilisateur affiche les valeurs à vos utilisateurs. Si vous synchronisez des filtres à niveau unique (comme l'État), l'interface utilisateur affichera chaque sélection comme ci-dessous :

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

Si vous associez des magasins à des États, ou à un agrégat similaire, chaque sélection affichera le nombre de filtres de lieu qu'elle représente :

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

<br>

{% hint style="info" %}
Si vous synchronisez des États lisibles par l'homme en tant que lieux dans votre catalogue de produits avec Epsilon Retail Media, cette étape ne sera pas requise.
{% endhint %}

#### Enrichir votre demande de pub

Selon votre intégration, vous synchronisez peut-être déjà ces informations pour améliorer le taux de remplissage publicitaire. Cela implique d'enrichir votre demande pour spécifier la localisation de l'utilisateur dans l' `productFilters` objet.

Le format de votre demande doit correspondre à la demande de pub comme indiqué ci-dessous :

* [Annonce produit - filtrage par emplacement](/retail-media-interface/integration/fr/generating-ads/product-ads/requesting-product-ads-1.md#filtering-by-location)
* [Annonce bannière - filtrage par emplacement](/retail-media-interface/integration/fr/generating-ads/banner-ads-static/requesting-banner-ads.md#filtering-by-location)
* [Bannière X - filtrage par emplacement](/retail-media-interface/integration/fr/generating-ads/banner-x-responsive/requesting-banner-x-ads.md#filtering-by-location)

{% hint style="warning" %}
Ajouter le ciblage géographique uniquement à un emplacement sélectionné ?

Vous souhaiterez peut-être mettre en œuvre cette amélioration sur l'ensemble de vos emplacements. Cela standardisera votre mise en œuvre sur tous les emplacements, même si vous n'activez le ciblage que sur des emplacements sélectionnés.
{% endhint %}

## Limitations connues de la fonctionnalité

Avant de commencer le développement, nous vous recommandons de prendre connaissance des limitations ci-dessous concernant cette fonctionnalité

* Cette fonctionnalité exploite des filtres synchronisés sur les produits, nous vous recommandons de vous assurer qu'en synchronisant la disponibilité produit-lieu, vous restez dans le cadre de l'SLA pris en charge [Accord sur le niveau de service (SLA)](https://citrusad.service-now.com/csm/en/service-support-agreement-service-offerings?id=kb_article_view\&sys_kb_id=c508eee097438d100c0fb18fe153af42)
* Cette fonctionnalité n'est pas compatible avec les emplacements de vente croisée par catégorie ou de vente croisée de produits historiques.
* Il n'y a pas de reporting intégré dans l'interface utilisateur par lieu(x) sélectionné(s) dans une campagne
  * Ces informations sont visibles dans les ensembles de données de reporting au niveau des faits pour les distributeurs qui utilisent l'API de reporting. Le reporting au niveau du lieu est disponible pour les distributeurs afin de consolider le reporting si nécessaire dans des systèmes externes.
* Les réservations en Emplacement fixe vous permettent de sélectionner des lieux sur une campagne, mais les réservations ne peuvent pas être effectuées au niveau de chaque campagne
  * Les réservations sont effectuées au niveau d'une catégorie, d'un terme de recherche ou d'un emplacement (pour les emplacements de Display sur site larges)


---

# 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/fr/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.
