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

# Ubicaciones e contexto

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 Topsort permite a creação de campanhas dirigidas a ubicaciones específicas e contextos. Dependiendo das ubicaciones e os contextos seleccionados, cada campanha
  participa en as subastas correctas.
</div>

## Como Funciona

<Steps>
  <Step title="Configuração de campanha">
    <div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
      Al criar una campanha, hae disponibles tres tipos de ubicaciones/contextos:
    </div>
  </Step>

  <Step title="Automático">
    <div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
      Esta configuração mostrará os ganadores quando a solicitud do seubasta incluya o ID de produto específico, o que permitirá que a campanha participe onde o mercado lo considere relevante. Por defecto, todas as categorías de produtos também se incluin como contextos relevantes.
    </div>

    <div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
      **Ejemplo**: una campanha que tem o produto Zapatilas (id sneakers-123) con
      A segmentação automática tendrá una puja que se activará através de subastas que tengan
      sneakers-123 na solicitud. También participará en una subasta com o categoría zapatillas
    </div>
  </Step>

  <Step title="Palabras clave">
    <div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
      Muestra os produtos según as palabras clave da campanha ou do produto. Si a consulta de búsqueda enviada na solicitud do seubasta coincide com alguna das palabras clave seleccionadas, os artícuos participarán.
    </div>

    <div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
      **Ejemplo**: una campanha com a palabra clave "zapatos" tendrá una puja que
      Participar en subastas com a búsqueda "zapatos". Esto se aplica a todos os anúncios.
      formatos.
    </div>
  </Step>

  <Step title="Categorías">
    <div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
      Os artícuos que participan na subasta se basan en as categorías preseleccionadas para a campanha.
    </div>

    <div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
      **Ejemplo**: una campanha cuyo público objetivo são as zapatilas para correr (categoría: zapatilas deportivas).
      tendrá una puja que se activará através de subastas que tengan a categoría
      Zapatilas para correr na solicitud. Esto se aplica a todos os formatos de anúncio.
    </div>
  </Step>

  <Step title="Proceso do seubasta">
    <div style={{textAlign: 'justify', marginBottom: '1.5rem'}}>
      Durante una subasta, a ubicação/contexto se pode fornecer no cuerpo da solicitud. A siguiente solicitud do seubasta se pode utilizar para recuperar os ganadores com esos tres contextos/ubicaciones:
    </div>

    <div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
      Ejemplo de solicitud do seubasta para \[patrocinado]
      listados]\(/pt/api-reference/examples/sponsored-listings/set-of-products):
    </div>

    ```json theme={null}
    {
      "auctions": [
        {
          "type": "listings",
          "slots": 1,
          "products": {
            "ids": [
              "sneakers-123"
            ]
          }
        },
        {
          "type": "listings",
          "slots": 1,
          "searchQuery": "shoes"
        },
        {
          "type": "listings",
          "slots": 1,
          "category": {
            "id": "running-sneakers"
          }
        }
      ]
    }
    ```

    <div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
      Ejemplo de solicitud do seubasta para \[banner]
      anúncios]\(/pt/api-reference/examples/sponsored-banners/banners):
    </div>

    ```json theme={null}
    {
      "auctions": [
        {
          "type": "banners",
          "slots": 3,
          "slotId": "backtoschool-carousel"
        }
      ]
    }
    ```

    <div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
      Ejemplo de solicitud do seubasta para \[patrocinado]
      marcas]\(/pt/api-reference/examples/sponsored-brands):
    </div>

    ```json theme={null}
    {
        "auctions": [
            {
                "winners": 2,
                "placementId": "some-placement",
                "triggers": {
                    "products": {
                        "ids": [
                            "1", "8"
                        ]
                    }
                }
            }
        ]
    }
    ```
  </Step>
</Steps>

***

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