Saltar al contenido principal

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.

​
Descripción general

Para lanzar anuncios offsite en una plataforma determinada, el marketplace concede a Topsort acceso a las cuentas publicitarias requeridas, implementa el seguimiento de eventos offsite y Topsort se encarga del resto de la integración (por ejemplo, sincronización de catálogo y eventos offline con el marketplace, validación). Topsort ejecuta un cronograma de implementación de 2 semanas para cada plataforma offsite (por ejemplo, Google o Meta) para garantizar un lanzamiento POC exitoso, con recursos cross-funcionales dedicados del cliente:
  • Ingeniería: ~1 día de esfuerzo de un ingeniero del marketplace (integración y validación). El desarrollo probablemente puede completarse en una sola llamada de 90 minutos con ingenieros de Topsort.
  • Ad Operations: ~1 día de soporte de ad ops del marketplace para configuración de campañas, QA y lanzamiento.

​
Arquitectura de cuentas

El aprovisionamiento automatizado de cuentas escala a miles de vendedores con separación clara de presupuesto y configuración manual mínima. A continuación se muestra la estructura de cuentas recomendada.

​
Google

  • El marketplace proporciona: Acceso a MCC (cuenta administradora) + MCA (cuenta multicliente de Merchant Center)
  • Topsort crea: Cuentas de Google Ads por vendedor con el enlace requerido a Merchant Center

​
Meta

  • El marketplace proporciona: Acceso al Business Manager principal
  • Topsort crea: Business Manager hijo y cuenta publicitaria por vendedor

​
TikTok

  • El marketplace proporciona: Acceso a TikTok Business Center / Business Manager, con permiso para gestionar cuentas publicitarias y assets
  • Topsort crea: Una cuenta publicitaria de TikTok dedicada para la integración offsite de Topsort, normalmente una cuenta publicitaria para el marketplace/retailer, no una por vendedor

​
Snap

  • El marketplace proporciona: Acceso a Snap Business Manager / Organization, con permiso para gestionar cuentas publicitarias y billing/assets
  • Topsort crea: Una cuenta publicitaria de Snap dedicada para la integración offsite de Topsort, normalmente una cuenta publicitaria para el marketplace/retailer, no una por vendedor

​
Pasos de configuración

​
Configuración de cuentas

​
Acceso a cuentas (marketplace)

El marketplace concede a Topsort acceso de administrador a las cuentas de plataforma publicitaria de nivel superior requeridas para los canales que se incorporan. Consulte Arquitectura de cuentas arriba para las cuentas específicas a las que conceder acceso en cada plataforma.

​
Creación de cuentas (Topsort)

Topsort aprovisiona la estructura de cuentas a nivel de vendedor bajo esos contenedores del marketplace, incluidas cuentas publicitarias hijas, business managers o cuentas de Merchant Center necesarias para la integración. Consulte Arquitectura de cuentas arriba para lo que Topsort crea en cada plataforma. El marketplace puede proporcionar a Topsort una lista de vendedores a habilitar para offsite.

​
Sincronización de catálogo (Topsort)

Cuando los formatos offsite basados en catálogo están en alcance, Topsort sincroniza el catálogo del marketplace con la plataforma offsite, mapeando los productos de cada vendedor en la estructura de cuenta de plataforma correspondiente para ese vendedor.

​
Configuración de seguimiento de eventos (marketplace)

La única área en la que el marketplace necesitará desarrollo es el seguimiento de eventos. Para informar eventos offsite, use el mismo endpoint /v2/events que para eventos onsite, pasando parámetros adicionales en el cuerpo de la solicitud.

​
ID de usuario opaco

El mismo opaqueUserId usado para eventos onsite también debe reutilizarse para la atribución offsite. No se requiere un identificador offsite separado. Topsort necesita un identificador de usuario persistente y seguro para la privacidad para conectar clics y compras entre canales. Los mismos requisitos onsite se aplican al uso offsite:
  • Persistencia: Debe permanecer estable durante la ventana de atribución (normalmente 7–30 días).
  • Consistencia: El mismo usuario debe recibir el mismo ID en visitas y canales cuando sea posible.
  • Seguro para la privacidad: No debe contener PII como email, número de teléfono o nombre.

​
URL de clic

La URL que tiene el usuario cuando llega a su sitio desde un clic de anuncio offsite tendrá parámetros de consulta importantes adjuntos. Ejemplo de URL de clic: 
https://www.retailer.com/search?q=shampoo&
externalCampaignId=9d2d7d7d-5d4f-4d8e-a8d0-2d7a6f9c1234&
externalVendorId=vendor_abc123&
gclid=CjwKCAj_example123&
utm_source=google&
utm_medium=c
Parámetros de consulta:
  • gclid — ID de clic adjunto por Google
  • externalCampaignId y externalVendorId — parámetros de consulta que contienen el ID de campaña y el ID de vendedor de Topsort, adjuntos por Topsort. Deben persistir junto con el estado de atribución del usuario durante al menos la duración de la ventana de atribución (configurable 7–30 días). Deben sobrevivir la navegación y las visitas repetidas para que los eventos de compra posteriores puedan vincularse correctamente al clic de anuncio offsite originador.

​
Informe de clics

Envíe el siguiente evento cuando un usuario llegue a su sitio desde un clic de anuncio offsite. Todos los campos son obligatorios. 
POST /v2/events

{
  "clicks": [
    {
      "occurredAt": "2023-11-07T05:31:56Z",
      "opaqueUserId": "<string>",
      "id": "<string>",
      "entity": {
        "id": "product1",
        "type": "product"
      },
      "externalCampaignId": "<Topsort UUID>",
      "externalVendorId": "<Topsort externalVendorId>",
      "dsp_metadata": {
        "gclid": "<Google click ID>"
      },
      "channel": "offsite"
    }
  ]
}

​
Informe de compras

Todos los campos son obligatorios. 
POST /v2/events

{
  "purchases": [
    {
      "occurredAt": "2023-11-07T05:31:56Z",
      "opaqueUserId": "<string>",
      "id": "<string>",
      "items": [
        {
          "productId": "product1",
          "vendorId": "<externalVendorId>",
          "unitPrice": 75.0,
          "quantity": 1
        },
        {
          "productId": "product2",
          "vendorId": "<externalVendorId>",
          "unitPrice": 25.0,
          "quantity": 1
        }
      ]
    }
  ]
}

​
Compartir eventos con plataformas offsite

El cliente no necesita informar por separado eventos de conversión a la plataforma offsite. Topsort envía automáticamente eventos de compra elegibles vinculados al ID de clic correspondiente (por ejemplo, Google Click ID o GCLID) a través de la API de conversiones offline de la plataforma.

​
Cronograma de incorporación

​
Semana 1 – Acceso y configuración de seguimiento de eventos

  • Conceder acceso a las cuentas requeridas
  • Iniciar la implementación del seguimiento de eventos
  • Sincronizar catálogo si es necesario con la plataforma offsite
  • Comenzar la configuración inicial del sistema

​
Semana 2 – Integración y configuración de datos

  • Finalizar la integración y comenzar las pruebas
  • Validar el seguimiento de eventos y la estructura/calidad del catálogo
  • Una vez todo configurado, validar con una campaña en vivo y monitorear el rendimiento