> 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/it/feature-integrations/location-targeting.md).
# Targeting per posizione
Il targeting geografico consente agli inserzionisti o ai retailer di targettizzare posizioni specifiche (come negozi o stati) nelle loro campagne. Può essere utilizzato su posizionamenti più ampi per restringere un pubblico a una determinata posizione.
{% hint style="success" %}
Consigliamo questo miglioramento su posizionamenti display ampi
La nostra best practice consiste nell'integrare questa funzione su posizionamenti di categoria o display ampi, poiché sono maggiormente basati sulla navigazione. Non la consigliamo sui posizionamenti di ricerca, in quanto le campagne sono già targettizzate in base all'intento e ciò potrebbe ridurre il pubblico selezionabile dall'inserzionista.
{% endhint %}
## Panoramica di alto livello
La nostra funzionalità di targeting geografico consente agli inserzionisti di selezionare le posizioni nella procedura guidata della campagna. Può essere abilitata a livello di singolo posizionamento per i posizionamenti di ricerca, di categoria e display ampi. Di seguito è riportato un esempio dell'interfaccia:
La funzionalità opera in modo simile alla nostra funzionalità di targeting per categoria, consentendo agli inserzionisti di selezionare le posizioni sincronizzate sui prodotti selezionati. Una volta selezionate le posizioni, queste possono essere visualizzate nelle schermate di riepilogo e nel gestore delle campagne.
## Panoramica dell'integrazione
Come parte di questa integrazione, dovrai eseguire i passaggi seguenti
1. Sincronizza i filtri a livello di posizione sui tuoi prodotti
2. Sincronizza i nomi delle posizioni idonei per l'interfaccia utente o mappa le posizioni tra loro tramite l' [filterMapping](/retail-media-interface/integration/it/citrus-filter-mapping-api/filtermapping.md) API (Condizionale all'integrazione)
1\.
1. Questo si applica solo se si è integrati con ID posizione invece che con i nomi, o se si desidera mappare le posizioni tra loro (ad esempio sincronizzando i negozi e desiderando mepparli sugli stati).
3. Migliora la tua richiesta di annunci per richiedere i filtri di posizione
### Sincronizzazione dei filtri a livello di posizione sui tuoi prodotti
Per mostrare le posizioni nell'interfaccia utente, i dati pertinenti (disponibilità) devono essere sincronizzati su ciascun prodotto. A seconda della tua integrazione, potresti già sincronizzare queste informazioni per migliorare il tasso di riempimento degli annunci.
#### Sincronizzazione tramite API
Se stai [Sincronizzazione dei prodotti tramite API](/retail-media-interface/integration/it/data-api/catalog-products-2/syncing-products-via-api.md), dovrai aggiornare ciascun prodotto con le posizioni pertinenti nell'oggetto `filters` . Un esempio è dettagliato nella [Sincronizzazione delle informazioni sulla posizione](/retail-media-interface/integration/it/data-api/catalog-products-2/syncing-products-via-api.md#syncing-location-information) sezione della pagina Sincronizzazione dei prodotti tramite API.
#### Sincronizzazione tramite file
Se stai [Sincronizzazione di catalogo e prodotti tramite file](/retail-media-interface/integration/it/data-api/catalog-products-2/syncing-catalog-products-via-file.md), è probabile che tu debba semplicemente aggiungere una colonna aggiuntiva al tuo file che specifichi la posizione pertinente (o le posizioni) in cui ciascun prodotto è disponibile. Si tratterà semplicemente di un'altra colonna denominata `location`.
{% hint style="info" %}
Formato del filtro di posizione
Raccomandiamo vivamente che il formato dei filtri di posizione sia `location:`. Questo formato apparirà correttamente nell'API di reporting. È lo stesso formato che la richiesta di annunci dovrà utilizzare per erogare gli annunci.
Se stai sincronizzando tramite file, il tuo Client Integration Engineer potrà mapparlo correttamente per te.
{% endhint %}
### Sincronizzazione dei nomi delle posizioni tramite l'API filterMapping
L'API filter mapping può essere utilizzata per mappare i tuoi ID posizione in valori leggibili. Questo è necessario se sincronizzi gli ID posizione poiché l'UI mostra i valori ai tuoi utenti. Se stai sincronizzando filtri a livello singolo (come lo stato), l'UI mostrerà ogni selezione come segue:
Se stai mappando negozi su stati, o un'aggregazione simile, ogni selezione mostrerà il numero di filtri di posizione che rappresenta:
{% hint style="info" %}
Se sincronizzi gli stati leggibili come posizioni nel tuo catalogo prodotti con Epsilon Retail Media, questo passaggio non sarà richiesto.
{% endhint %}
#### Miglioramento della richiesta di annunci
A seconda della tua integrazione, potresti già sincronizzare queste informazioni per migliorare il tasso di riempimento degli annunci. Ciò comporta il miglioramento della tua richiesta per specificare la posizione dell'utente nell'oggetto `productFilters` .
Il formato della tua richiesta dovrebbe corrispondere alla richiesta di annunci come elencato di seguito:
* [Annuncio prodotto - filtraggio per posizione](/retail-media-interface/integration/it/generating-ads/product-ads/requesting-product-ads-1.md#filtering-by-location)
* [Annuncio banner - filtraggio per posizione](/retail-media-interface/integration/it/generating-ads/banner-ads-static/requesting-banner-ads.md#filtering-by-location)
* [Banner X - filtraggio per posizione](/retail-media-interface/integration/it/generating-ads/banner-x-responsive/requesting-banner-x-ads.md#filtering-by-location)
{% hint style="warning" %}
Aggiungere il targeting geografico solo a un posizionamento selezionato?
Potresti voler implementare questo miglioramento in tutti i tuoi posizionamenti. Questo standardizzerà la tua implementazione su tutti i posizionamenti, anche se abiliti il targeting su posizionamenti selezionati.
{% endhint %}
## Limitazioni note della funzionalità
Prima di iniziare lo sviluppo, ti consigliamo di comprendere le seguenti limitazioni di questa funzionalità
* Questa funzionalità sfrutta i filtri sincronizzati sui prodotti; raccomandiamo di assicurarsi che, sincronizzando la disponibilità prodotto-posizione, si rimanga all'interno dello SLA supportato [Accordo sul livello del servizio](https://citrusad.service-now.com/csm/en/service-support-agreement-service-offerings?id=kb_article_view\&sys_kb_id=c508eee097438d100c0fb18fe153af42)
* Questa funzionalità non è compatibile con i posizionamenti di cross-sell di categoria o di cross-sell di prodotti legacy.
* Non è disponibile alcun reporting nell'UI in base alla posizione (o alle posizioni) selezionata/e in una campagna
* Queste informazioni vengono mostrate nei dataset di reporting a livello di fact per i retailer che utilizzano l'API di reporting. Il reporting a livello di posizione è disponibile affinché i retailer possano aggregare i report, se necessario, in sistemi esterni.
* Le prenotazioni a Canone fisso consentono di selezionare le posizioni in una campagna, ma le prenotazioni non possono essere effettuate a livello di singola campagna
* Le prenotazioni vengono effettuate a livello di categoria, di termine di ricerca o di posizionamento (per posizionamenti Display offsite ampi)
---
# 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/it/feature-integrations/location-targeting.md?ask=&goal=
```
`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.