Saltar al contenido principal
Las subastas de Sponsored Brands funcionan enviando solicitudes de subasta con ubicación. detalles y factores desencadenantes, para luego recibir respuestas estructuradas que contienen Campañas ganadoras con todos los recursos creativos y metadatos necesarios.

​
Plantillas disponibles

Las campañas de Sponsored Brands se crean utilizando una de las tres plantillas predefinidas:
  • Colección de productos: Múltiples productos mostrados en una sola página de destino para una búsqueda de productos integral.
  • Producto destacado: Un solo producto y una propuesta creativa
  • Tienda Destacada: Dirige tráfico directamente a la página de la tienda del vendedor para dar a conocer la marca.

​
Solicitud de subasta

Las solicitudes de subasta para Marcas Patrocinadas siguen el formato de subasta estándar con Desencadenantes específicos para la segmentación:
{
  "auctions": [
    {
      "winners": 2,
      "placementId": "some-placement",
      "triggers": {
        "products": {
          "ids": ["pmk_1", "pmk_8"]
        },
        "category": {
          "id": "electronics"
        },
        "searchQuery": "cool electronics"
      },
      "geoTargeting": "santiago",
      "opaqueUserId": "user-123"
    }
  ]
}

​
Parámetros de solicitud

  • Ganadores: Número de campañas de marcas patrocinadas que regresarán
  • placementId: Identificador del espacio publicitario de las marcas patrocinadas
  • Desencadenantes: Criterios de segmentación utilizando uno de los siguientes:
  • products.ids: Matriz de identificadores de productos específicos a segmentar
  • category.id: Categoría de producto para una segmentación más amplia
  • searchQuery: Términos de búsqueda para la segmentación basada en palabras clave
  • geoSegmentación: Ubicación geográfica para campañas basadas en la ubicación.
  • opaqueUserId: Identificador de usuario anónimo para personalización

​
Respuesta a la subasta

La respuesta a la subasta devuelve las campañas ganadoras de marcas patrocinadas con información completa. activos creativos y metadatos:
{
  "results": [
    {
      "winners": [
        {
          "rank": 1,
          "resolvedBidId": "ChAGc-G66Wt7LKQEOcW8VBdIEhABjz_zDXx7db-ZYpxiwJ3DGhABjr4Lt_J0_a7Xv_uIfyOXIgUKATEQATDrrg8",
          "productId": "pmk_1",
          "type": "url",
          "id": "www.topsort.com",
          "vendorId": "vendor_id",
          "content": {
            "headline": "Campaign Headline",
            "logo": "https://some.url.com/logo.jpeg"
          },
          "campaignId": "018f3ff3-0d7c-7b75-bf99-629c62c09dc3",
          "productIds": ["pmk_1", "pmk_4", "pmk_8"]
        }
      ],
      "error": false
    }
  ]
}

​
Campos de respuesta

​
Objeto ganador

  • clasificación: Posición en el ranking de la campaña ganadora
  • resolvedBidId: Identificador único para el seguimiento y la atribución de ofertas.
  • productId: Identificador principal del producto para la campaña
  • tipo: Tipo de campaña (siempre “producto” para marcas patrocinadas)
  • id: Identificador de campaña
  • título: Título de la campaña para fines de visualización
  • campaignId: UUID de la campaña de marcas patrocinadas
  • productIds: Matriz de todos los productos incluidos en la campaña (de 1 a 5 productos)

​
Matriz de activos

Recursos creativos para la representación del anuncio de las marcas patrocinadas:
  • URL: CDN URL para el recurso
  • rol: Tipo de activo (“imagen” para banners creativos, “logotipo” para el logotipo de la marca)
  • contentType: Tipo MIME del recurso
  • longitud del contenido: Tamaño del archivo en bytes
  • ancho/alto: Dimensiones del recurso en píxeles

​
Objeto de contenido

Contenido de la campaña para renderizar:
  • Titular: Texto del titular de la campaña
  • brandName: Nombre de la marca o del proveedor
  • creative1: Recurso creativo adicional URL (vídeos, imágenes secundarias)

​
Notas de implementación

​
Flexibilidad de renderizado

Los recursos creativos, el titular y los ID de producto se devuelven por separado en el respuesta a la subasta, lo que le permite representar estos elementos según sus preferencias Requisitos de diseño frontend. El array de assets contiene todos los elementos creativos necesarios. Componentes con una clara identificación de funciones.

​
Soporte para múltiples productos

Las campañas de marcas patrocinadas pueden promocionar de 1 a 5 productos simultáneamente. El array productIds contiene todos los productos incluidos en la campaña, mientras que productId representa el producto principal a efectos de seguimiento.

​
Integración de plantillas

Si bien las campañas se crean utilizando plantillas disponibles (Colección de productos, La respuesta a la subasta proporciona todo lo necesario (Producto destacado, Tienda destacada), Los recursos y el contenido necesarios, independientemente de la plantilla utilizada, garantizan Integración coherente en todos los tipos de campañas.

​
Especificaciones de contenido

Todos los recursos creativos (imágenes y vídeos) subidos para Marcas Patrocinadas Las campañas deben cumplir estos requisitos:
  • Formatos compatibles: JPEG, PNG, WEBP, GIF, MP4
  • Tamaño máximo de archivo: 5 MB por creatividad/vídeo
Last updated: