> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topsort.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Segmentação geográfica

export const LastUpdatedPt = ({date}) => {
  const label = "Última atualização:";
  return <>
      <style>{`
        .last-updated-component {
          display: inline-flex;
          align-items: center;
          gap: 8px;
          padding: 10px 16px;
          border-radius: 8px;
          margin-top: 12px;
          margin-bottom: 16px;
          font-size: 14px;
          background-color: rgba(0, 0, 0, 0.05);
          border: 1px solid rgba(0, 0, 0, 0.12);
          color: rgba(0, 0, 0, 0.75);
          line-height: 1;
        }

        .last-updated-component svg {
          flex-shrink: 0;
          vertical-align: middle;
        }

        .last-updated-component span {
          display: inline-flex !important;
          align-items: center !important;
          line-height: 1 !important;
        }

        [data-theme="dark"] .last-updated-component {
          background-color: #3a3a3a;
          border: 2px solid #888888;
          color: #ffffff;
        }

        [data-theme="dark"] .last-updated-component svg {
          stroke: #ffffff;
        }
      `}</style>
      <div className="last-updated-component">
        <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
          <circle cx="12" cy="12" r="10" />
          <polyline points="12 6 12 12 16 14" />
        </svg>
        <span>
          <strong style={{
    fontWeight: 600
  }}>{label}</strong> 
          <time dateTime={date}>{date}</time>
        </span>
      </div>
    </>;
};

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  A segmentação geográfica permite aos anunciantes direcionar suas campanhas a usuários em
  localizações geográficas específicas, como estados, sub-regiões ou cidades.
</div>

## Como Funciona

<Steps>
  <Step title="Pré-configuração">
    <div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
      O cliente fornece um arquivo JSON com o mapeamento de suas geolocalizações, incluindo um ID e um nome para cada localização. Estes dados de geolocalização são carregados pelo Topsort no início do processo de integração, ficando disponíveis para realizar testes com as primeiras campanhas.
    </div>
  </Step>

  <Step title="Configuração de campanha">
    <div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
      Os anunciantes podem selecionar várias regiões no painel de administração/fornecedor ao criar suas campanhas.
    </div>
  </Step>

  <Step title="Processo de leilão">
    <div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
      Durante um leilão, a geolocalização pode ser fornecida no corpo da solicitação, utilizando o campo `geoTargeting.location`. A seguinte solicitação de leilão pode ser utilizada para recuperar os vencedores para clientes em uma localização específica:
    </div>

    ```json theme={null}
    {
      "auctions": [
        {
          "type": "listings",
          "slots": 2,
          "category": {
            "id": "category"
          },
          "geoTargeting": {
            "location": "new-york"
          }
        }
      ]
    }
    ```
  </Step>
</Steps>

## Considerações importantes

1. As campanhas podem ser segmentadas em várias localizações geográficas. Se uma campanha está associada com `location1` e `location2`, seus produtos poderão participar em leilões onde o campo `geoTargeting.location` seja `location1` ou `location2`.
2. Uma solicitação de leilão aceita apenas uma localização no campo `geoTargeting.location`.
3. Se uma campanha não tem localizações definidas, participa em todos os leilões (independentemente da informação de localização na solicitação de leilão).
4. Se uma campanha tem localizações definidas, participa apenas em leilões onde o campo `geoTargeting.location` coincide com uma de suas localizações especificadas.

***

<LastUpdatedPt date="2025-11-18" />