> 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/es/feature-integrations/location-targeting.md).
# Segmentación por ubicación
La segmentación por ubicación permite a los anunciantes o minoristas segmentar ubicaciones específicas (como tiendas o estados) en sus campañas. Esto se puede utilizar en ubicaciones más amplias para reducir la audiencia a una ubicación determinada.
{% hint style="success" %}
Recomendamos esta mejora en ubicaciones de display amplias
Nuestra buena práctica es integrar esto en ubicaciones de categoría o de display amplias, ya que están más basadas en la navegación. No lo recomendamos en ubicaciones de búsqueda, ya que las campañas ya están segmentadas por intención y esto puede reducir la audiencia seleccionable del anunciante.
{% endhint %}
## Resumen de alto nivel
Nuestra capacidad de segmentación por ubicación permite a los anunciantes seleccionar ubicaciones en el asistente de campañas. Esto se puede habilitar a nivel de ubicación individual para ubicaciones de búsqueda, categoría y display amplio. A continuación se muestra un ejemplo de la interfaz:
La funcionalidad opera de forma similar a nuestra capacidad de segmentación por categoría, permitiendo a los anunciantes seleccionar ubicaciones que están sincronizadas en sus productos seleccionados. Una vez que se han seleccionado las ubicaciones, se pueden ver en las pantallas de revisión y del administrador de campañas.
## Resumen de la integración
Como parte de esta integración, deberá hacer lo siguiente
1. Sincronizar filtros a nivel de ubicación en sus productos
2. Sincronizar nombres de ubicación adaptados a la IU o mapear ubicaciones entre sí a través de la [filterMapping](/retail-media-interface/integration/es/citrus-filter-mapping-api/filtermapping.md) API (condicional a la integración)
1\.
1. Esto solo se aplica si está integrado con ID de ubicación en lugar de nombres, o si desea mapear ubicaciones entre sí (como sincronizar tiendas y querer mapearlas con estados).
3. Mejorar su solicitud de anuncio para solicitar filtros de ubicación
### Sincronización de filtros a nivel de ubicación en sus productos
Para mostrar las ubicaciones en la IU, los datos relevantes (disponibilidad) deben sincronizarse en cada producto. Según su integración, es posible que ya esté sincronizando esta información para mejorar la tasa de relleno de anuncios.
#### Sincronización a través de la API
Si está [Sincronización de productos mediante API](/retail-media-interface/integration/es/data-api/catalog-products-2/syncing-products-via-api.md), deberá actualizar cada producto con las ubicaciones relevantes en el `filters` objeto. Se detalla un ejemplo en la [Sincronización de información de ubicación](/retail-media-interface/integration/es/data-api/catalog-products-2/syncing-products-via-api.md#syncing-location-information) sección de la página Sincronización de productos a través de la API.
#### Sincronización a través de archivo
Si está [Sincronización de catálogo y productos mediante archivo](/retail-media-interface/integration/es/data-api/catalog-products-2/syncing-catalog-products-via-file.md), es probable que simplemente necesite agregar una columna adicional a su archivo que especifique las ubicaciones relevantes en las que se almacena cada producto. Esta será simplemente otra columna llamada `location`.
{% hint style="info" %}
Formato del filtro de ubicación
Recomendamos encarecidamente que el formato de sus filtros de ubicación sea `location:`. Este formato aparecerá correctamente en la API de informes. Este es el mismo formato que la solicitud de anuncio deberá utilizar para servir anuncios.
Si realiza la sincronización a través de un archivo, su Client Integration Engineer puede mapearlo correctamente por usted.
{% endhint %}
### Sincronización de nombres de ubicación a través de la API filterMapping
La API filterMapping se puede utilizar para mapear sus ID de ubicación a valores legibles por humanos. Esto es obligatorio si sincroniza ID de ubicación, ya que la IU muestra los valores a sus usuarios. Si está sincronizando filtros de un solo nivel (como el estado), la IU mostrará cada selección como se muestra a continuación:
Si está mapeando tiendas con estados, o un agregado similar, cada selección mostrará el número de filtros de ubicación que representa:
{% hint style="info" %}
Si sincroniza estados legibles por humanos como ubicaciones en su catálogo de productos con Epsilon Retail Media, este paso no será necesario.
{% endhint %}
#### Mejora de su solicitud de anuncio
Según su integración, es posible que ya esté sincronizando esta información para mejorar la tasa de relleno de anuncios. Esto implica mejorar su solicitud para especificar la ubicación del usuario en el `productFilters` objeto.
El formato de su solicitud debe coincidir con la solicitud de anuncio que se detalla a continuación:
* [Anuncio de producto - filtrado por ubicación](/retail-media-interface/integration/es/generating-ads/product-ads/requesting-product-ads-1.md#filtering-by-location)
* [Anuncio de banner - filtrado por ubicación](/retail-media-interface/integration/es/generating-ads/banner-ads-static/requesting-banner-ads.md#filtering-by-location)
* [Banner X - filtrado por ubicación](/retail-media-interface/integration/es/generating-ads/banner-x-responsive/requesting-banner-x-ads.md#filtering-by-location)
{% hint style="warning" %}
¿Desea agregar la segmentación por ubicación solo a una ubicación seleccionada?
Es posible que desee implementar esta mejora en todas sus ubicaciones. Esto estandarizará su implementación en todas las ubicaciones, incluso si habilita la segmentación en ubicaciones seleccionadas.
{% endhint %}
## Limitaciones conocidas de la capacidad
Antes de comenzar el desarrollo, le recomendamos que comprenda las siguientes limitaciones de esta funcionalidad
* Esta capacidad aprovecha los filtros sincronizados en los productos; recomendamos asegurarse de que, al sincronizar la disponibilidad de productos por ubicación, se mantenga dentro del SLA compatible [Acuerdo de Nivel de Servicio](https://citrusad.service-now.com/csm/en/service-support-agreement-service-offerings?id=kb_article_view\&sys_kb_id=c508eee097438d100c0fb18fe153af42)
* Esta capacidad no es compatible con venta cruzada de categorías ni con ubicaciones de venta cruzada de productos heredadas.
* No hay informes en la IU por ubicación(es) seleccionada(s) en una campaña
* Esta información se muestra en los conjuntos de datos de informes a nivel de hechos para los minoristas que utilizan la API de informes. Los informes a nivel de ubicación están disponibles para que los minoristas consoliden los informes si es necesario en sistemas externos.
* Las reservas de Ubicación fija le permiten seleccionar ubicaciones en una campaña, pero las reservas no se pueden realizar a nivel de campaña individual
* Las reservas se realizan a nivel de categoría, término de búsqueda o ubicación (para ubicaciones de display amplias)
---
# 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/es/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.