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

# Auctions API

> Integra con nuestra Auctions API

export const IntegrationsCard1AEs = () => {
  return <>
      <style>{`
        .integrations-card-1a-es {
          display: flex;
          flex-direction: column;
          background-color: #f0f2f4;
          border: 1px solid rgba(0, 0, 0, 0.08);
          border-radius: 12px;
          padding: 1.25rem 1.5rem;
          gap: 0.25rem;
          color: #25253b;
          box-shadow: 0 1px 3px rgba(0, 0, 0, 0.02);
          transition: box-shadow 0.2s ease, border-color 0.2s ease, transform 0.2s ease;
          margin-top: 2rem;
        }

        .integrations-card-1a-es:hover {
          box-shadow: 0 4px 12px rgba(0, 0, 0, 0.06);
          border-color: rgba(0, 0, 0, 0.12);
        }

        .dark .integrations-card-1a-es {
          background-color: #25253b;
          color: #f6f8fa;
          border-color: rgba(255, 255, 255, 0.08);
          box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1);
        }

        .dark .integrations-card-1a-es:hover {
          box-shadow: 0 4px 12px rgba(0, 0, 0, 0.2);
          border-color: rgba(255, 255, 255, 0.12);
        }

        .integrations-card-1a-es-avatar-row {
          display: flex;
          margin-left: 14px;
          flex-wrap: wrap;
        }

        .integrations-card-1a-es-avatar {
          width: 44px;
          height: 44px;
          border-radius: 50%;
          border: 2px solid #f0f2f4;
          margin-left: -14px;
          object-fit: cover;
          box-shadow: 0 2px 6px rgba(0, 0, 0, 0.08);
          pointer-events: none;
          cursor: default;
        }

        .dark .integrations-card-1a-es-avatar {
          border-color: #25253b;
          box-shadow: 0 2px 8px rgba(0, 0, 0, 0.2);
        }

        .integrations-card-1a-es h2 {
          margin: 0;
          line-height: 1.25;
          font-size: clamp(1.25rem, calc(0.875rem + 1.25vw), 1.75rem);
          font-weight: 700;
          letter-spacing: -0.025em;
          color: #111827;
        }

        .dark .integrations-card-1a-es h2 {
          color: #f9fafb;
        }

        .integrations-card-1a-es-subtitle {
          font-size: 0.9375rem;
          font-weight: 500;
          line-height: 1.5;
          color: #4b5563;
          margin: 0;
        }

        .dark .integrations-card-1a-es-subtitle {
          color: #d1d5db;
        }

        .integrations-card-1a-es p {
          margin: 0;
          line-height: 1.5;
          font-size: 0.875rem;
          color: #374151;
        }

        .dark .integrations-card-1a-es p {
          color: #d1d5db;
        }

        .integrations-card-1a-es a {
          color: #0500ff;
          text-decoration: none;
          font-weight: 500;
          transition: color 0.15s ease;
        }

        .integrations-card-1a-es a:hover {
          color: #0400cc;
        }

        .dark .integrations-card-1a-es a {
          color: #8280ff;
        }

        .dark .integrations-card-1a-es a:hover {
          color: #a19fff;
        }

        @media (max-width: 640px) {
          .integrations-card-1a-es-avatar {
            width: 38px;
            height: 38px;
            margin-left: -12px;
          }

          .integrations-card-1a-es-avatar-row {
            margin-left: 12px;
          }
        }

        @media (min-width: 1280px) {
          .integrations-card-1a-es p {
            font-size: 0.6875rem;
            line-height: 1.4;
            letter-spacing: -0.01em;
          }

          .integrations-card-1a-es h2 {
            font-size: clamp(1rem, calc(0.75rem + 1vw), 1.25rem);
          }

          .integrations-card-1a-es-subtitle {
            font-size: 0.75rem;
          }
        }
      `}</style>
      <div className="integrations-card-1a-es">
        <div className="integrations-card-1a-es-avatar-row">
          <img src="/images/integration-team/agustin.webp" alt="" loading="lazy" className="integrations-card-1a-es-avatar" />
          <img src="/images/integration-team/amelia.webp" alt="" loading="lazy" className="integrations-card-1a-es-avatar" />
          <img src="/images/integration-team/bernardita.webp" alt="" loading="lazy" className="integrations-card-1a-es-avatar" />
          <img src="/images/integration-team/borumy.webp" alt="" loading="lazy" className="integrations-card-1a-es-avatar" />
          <img src="/images/integration-team/felipe.webp" alt="" loading="lazy" className="integrations-card-1a-es-avatar" />
          <img src="/images/integration-team/gui.webp" alt="" loading="lazy" className="integrations-card-1a-es-avatar" />
          <img src="/images/integration-team/javiera.webp" alt="" loading="lazy" className="integrations-card-1a-es-avatar" />
          <img src="/images/integration-team/linn.webp" alt="" loading="lazy" className="integrations-card-1a-es-avatar" />
          <img src="/images/integration-team/marcio.webp" alt="" loading="lazy" className="integrations-card-1a-es-avatar" />
          <img src="/images/integration-team/mateus.webp" alt="" loading="lazy" className="integrations-card-1a-es-avatar" />
          <img src="/images/integration-team/max.webp" alt="" loading="lazy" className="integrations-card-1a-es-avatar" />
          <img src="/images/integration-team/rodrigo.webp" alt="" loading="lazy" className="integrations-card-1a-es-avatar" />
        </div>

        <h2>¿Necesitas ayuda con tu integración de Topsort?</h2>

        <p className="integrations-card-1a-es-subtitle">
          Habla con nosotros, el equipo de ingeniería de integraciones.
        </p>

        <p>
          Contáctanos a través de <strong>tu canal de mensajería dedicado</strong> o en{" "}
          <a href="mailto:support@topsort.com">support@topsort.com</a>.
        </p>

        <p>
          Si aún no eres cliente,{" "}
          <a href="https://www.topsort.com/book-a-demo">agenda una demo</a> con nuestro
          equipo de ventas.
        </p>
      </div>
    </>;
};

La [Auctions API](/en/api-reference/auctions) de Topsort determina qué ofertas de campañas activas deben ser promovidas. Como administrador de marketplace, puedes definir dónde, cuándo y cómo deben crearse las subastas. Tenemos tres tipos de subastas disponibles:

* **Productos Patrocinados**: permiten promover productos específicos en resultados de búsqueda, listados de categorías, PDPs y carruseles de productos.
* **Anuncios de Banner y Video**: anuncios para mostrarse en búsqueda, categoría o páginas de inicio.
* **Marcas Patrocinadas**: permiten promover marcas en búsqueda, categoría o páginas de inicio.

Debe crearse una subasta para cada vista de página. Si los resultados de la subasta se almacenan en caché, los mismos resultados podrían mostrarse a múltiples usuarios o al mismo usuario múltiples veces. Esto impactará el seguimiento del rendimiento de la campaña.

## Creación de Subasta

Usa la API apropiada para crear una subasta y recuperar ganadores. Los parámetros clave necesarios para cualquier subasta son:

* **Tipo**: listings, banners, videos o brands
* **Ganadores máximos**: número máximo de ganadores a devolver. Si el motor de subastas encuentra menos ganadores que el número máximo solicitado, se devolverán todos los ganadores.
* **Disparadores**: los disparadores son elementos de segmentación usados para filtrar qué campañas son elegibles en la subasta.
  * **IDs de Producto - Disparador Automático**: Apunta a ofertas para productos específicos. Este disparador puede usarse para promover productos que fueron devueltos por tu motor de búsqueda y tienen ofertas de campañas activas.
  * **IDs de Categoría**: Apunta a ofertas para categorías específicas. Este disparador puede usarse para devolver ganadores relacionados con una o más categorías.
  * **Consulta de Búsqueda**: Apunta a ofertas que coincidan con palabras clave.
  * **Geolocalización**: Apunta a ofertas que coincidan con geolocalización.

## Resolución de Subasta

Topsort empareja los criterios de subasta con campañas activas y filtra ofertas que son elegibles para participar, considerando los parámetros definidos en la solicitud de subasta, y están por encima del precio de reserva. El precio de reserva es el precio de oferta mínimo permitido por el marketplace.

Las ofertas ganadoras se definen y clasifican, considerando dos objetivos principales:

* Optimizar el ROAS del anunciante, considerando los mejores productos según sus métricas (CTR, CVR, puntaje de calidad).
* Maximizar los ingresos del retailer, considerando el monto de oferta de cada producto.

## Mostrar Ganadores y Rastrear Eventos

Las ofertas ganadoras son devueltas por la API de Topsort con un **Resolved Bid ID** único. Este parámetro identifica cada elemento promovido que participó en una subasta. Se usa para garantizar reportes y atribución precisos. Este parámetro debe enviarse con las impresiones, clics y compras que se reportan con la Events API.

<IntegrationsCard1AEs />
