> 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/pt-br/feature-integrations/location-targeting.md).
# Segmentação por localização
O direcionamento por localização permite que anunciantes ou varejistas direcionem locais específicos (como lojas ou estados) em suas campanhas. Isso pode ser usado em posicionamentos mais amplos para afunilar um público-alvo para uma determinada localização.
{% hint style="success" %}
Recomendamos esta melhoria em posicionamentos amplos de display
Nossa boa prática é integrar isso em posicionamentos de categoria ou de display amplo, pois eles são mais baseados em navegação. Não recomendamos isso em posicionamentos de busca, pois as campanhas já têm direcionamento por intenção e isso pode reduzir o público selecionável do anunciante.
{% endhint %}
## Visão geral de alto nível
Nossa funcionalidade de direcionamento por localização permite que os anunciantes selecionem locais no assistente de campanha. Isso pode ser ativado em nível de posicionamento para posicionamentos de busca, categoria e display amplo. Um exemplo da interface está abaixo:
A funcionalidade opera de forma semelhante à nossa funcionalidade de direcionamento por categoria, permitindo que os anunciantes selecionem locais que estão sincronizados em seus produtos selecionados. Assim que os locais forem selecionados, eles poderão ser vistos nas telas de revisão e do gerenciador de campanhas.
## Visão geral da integração
Como parte desta integração, você precisará fazer o seguinte
1. Sincronizar filtros em nível de localização em seus produtos
2. Sincronizar nomes de localização amigáveis para a interface do usuário ou mapear localizações juntas por meio do [filterMapping](/retail-media-interface/integration/pt-br/citrus-filter-mapping-api/filtermapping.md) API (Condicional à integração)
1\.
1. Isso só se aplica se você estiver integrado com IDs de localização em vez de nomes, ou se quiser mapear localizações juntas (como sincronizar lojas e querer mapeá-las para estados).
3. Aprimorar sua solicitação de anúncio para solicitar filtros de localização
### Sincronização de filtros em nível de localização em seus produtos
Para exibir localizações na interface do usuário, os dados relevantes (disponibilidade) precisam ser sincronizados em cada produto. Dependendo da sua integração, você já pode estar sincronizando essas informações para melhorar a taxa de preenchimento do anúncio.
#### Sincronização via API
Se você estiver [Sincronizando produtos via API](/retail-media-interface/integration/pt-br/data-api/catalog-products-2/syncing-products-via-api.md), você precisará atualizar cada produto com as localizações relevantes no `filters` object. Um exemplo é detalhado na seção [Sincronização de informações de localização](/retail-media-interface/integration/pt-br/data-api/catalog-products-2/syncing-products-via-api.md#syncing-location-information) da página Sincronizando produtos via API.
#### Sincronização via arquivo
Se você estiver [Sincronizando catálogo e produtos via arquivo](/retail-media-interface/integration/pt-br/data-api/catalog-products-2/syncing-catalog-products-via-file.md), é provável que você só precise adicionar uma coluna adicional ao seu arquivo que especifique a(s) localização(ões) relevante(s) em que cada produto está estocado. Esta será simplesmente outra coluna chamada `location`.
{% hint style="info" %}
Formato do filtro de localização
Recomendamos fortemente que o formato dos seus filtros de localização seja `location:`. Esse formato aparecerá corretamente na API de relatórios. Este é o mesmo formato que a solicitação de anúncio precisará utilizar para veicular anúncios.
Se você estiver sincronizando via arquivo, seu Engenheiro de Integração de Clientes poderá mapear isso corretamente para você.
{% endhint %}
### Sincronização de nomes de localização via API filterMapping
A API de mapeamento de filtros pode ser usada para mapear seus IDs de localização para valores legíveis por humanos. Isso é necessário se você sincronizar IDs de localização, pois a interface do usuário mostra os valores aos seus usuários. Se você estiver sincronizando filtros de nível único (como estado), a interface do usuário mostrará cada seleção como abaixo:
Se você estiver mapeando lojas para estados, ou um agrupamento semelhante, cada seleção mostrará o número de filtros de localização que ela representa:
{% hint style="info" %}
Se você sincronizar estados legíveis por humanos como localizações em seu catálogo de produtos com Epsilon Retail Media, esta etapa não será necessária.
{% endhint %}
#### Aprimorando sua solicitação de anúncio
Dependendo da sua integração, você já pode estar sincronizando essas informações para melhorar a taxa de preenchimento do anúncio. Isso envolve aprimorar sua solicitação para especificar a localização do usuário no `productFilters` object.
O formato da sua solicitação deve corresponder à solicitação de anúncio conforme listado abaixo:
* [Anúncio de produto - filtragem por localização](/retail-media-interface/integration/pt-br/generating-ads/product-ads/requesting-product-ads-1.md#filtering-by-location)
* [Anúncio de banner - filtragem por localização](/retail-media-interface/integration/pt-br/generating-ads/banner-ads-static/requesting-banner-ads.md#filtering-by-location)
* [Banner X - filtragem por localização](/retail-media-interface/integration/pt-br/generating-ads/banner-x-responsive/requesting-banner-x-ads.md#filtering-by-location)
{% hint style="warning" %}
Adicionando direcionamento por localização a apenas um posicionamento selecionado?
Você pode desejar implementar essa melhoria em todos os seus posicionamentos. Isso padronizará sua implementação em todos os posicionamentos, mesmo se você ativar o direcionamento em posicionamentos selecionados.
{% endhint %}
## Limitações conhecidas da funcionalidade
Antes de iniciar o desenvolvimento, recomendamos que você entenda as limitações abaixo com esta funcionalidade
* Esta funcionalidade aproveita filtros sincronizados nos produtos; recomendamos garantir que, ao sincronizar a disponibilidade do produto por localização, você permaneça dentro do SLA suportado [Acordo de Nível de Serviço](https://citrusad.service-now.com/csm/en/service-support-agreement-service-offerings?id=kb_article_view\&sys_kb_id=c508eee097438d100c0fb18fe153af42)
* Esta funcionalidade não é compatível com posicionamentos de cross-sell de categoria ou cross-sell de produtos legados.
* Não há relatórios na interface do usuário por localização(ões) selecionada(s) em uma campanha
* Essas informações são exibidas nos conjuntos de dados de relatórios em nível de fato para varejistas que utilizam a API de relatórios. Os relatórios em nível de localização estão disponíveis para os varejistas consolidarem os relatórios, se necessário, em sistemas externos.
* Reservas de Posicionamento fixo permitem selecionar localizações em uma campanha, mas as reservas não podem ser feitas em nível individual por campanha
* As reservas são feitas em nível de categoria, termo de busca ou posicionamento (para posicionamentos de display amplo)
---
# 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/pt-br/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.