Atribución y facturación - Topsort Documentation

Atribución y seguimiento de conversiones

Su configuración de seguimiento de conversiones determina cómo se atribuyen las ventas a los anuncios y qué métricas están disponibles en Topsort. Para una visión general de las opciones de integración, consulte Seguimiento de conversiones.

Atribución interna de Topsort

Cuando su marketplace envía eventos de clic y compra a Topsort, Topsort puede atribuir las compras a los anuncios usando su atribución interna. Puede aplicar la misma ventana de atribución y configuración en las plataformas publicitarias compatibles, lo que permite comparaciones homogéneas de ventas y retorno de la inversión publicitaria (ROAS). Enviar eventos a Topsort no significa automáticamente que todas las plataformas publicitarias los reciban. En algunas plataformas publicitarias, incluida Google, Topsort reenvía las conversiones elegibles. Otras plataformas publicitarias requieren compartir conversiones por separado para soportar la optimización hacia conversiones. Consulte Implementar seguimiento de eventos offsite con Topsort para las instrucciones de implementación.

Atribución de la plataforma publicitaria

Cuando su marketplace envía conversiones directamente a una plataforma publicitaria, Topsort recupera los reportes resultantes y los muestra en su interfaz. Estas métricas siguen la metodología de atribución de la plataforma publicitaria. Las diferencias en ventanas de atribución y configuración pueden afectar las comparaciones entre plataformas publicitarias. La atribución interna de Topsort no es obligatoria para que la integración offsite funcione.

Modelo de facturación

La facturación offsite es controlada por el marketplace y consolidada:

Los vendors consumen capacidad de wallet por canal (por ejemplo, wallet de Google, Meta, Snapchat, TikTok o Universal Ads).
El marketplace es facturado directamente por el canal por media spend.
El marketplace factura a sus vendors según sus términos comerciales.

Modalidades de pago

Prepay: el vendor carga créditos antes de gastar.
Postpay: el marketplace define límites de capacidad de gasto y liquida luego.

Implementar seguimiento de eventos offsite con Topsort

Esta sección está dirigida a desarrolladores, como los desarrolladores frontend que implementan el seguimiento de eventos. Explica cómo enviar eventos de clic y compra del marketplace a Topsort para la atribución interna. Informe los eventos offsite a través del mismo endpoint /v2/events usado para eventos onsite, con los parámetros offsite adicionales que se muestran a continuación. El ejemplo de URL de clic y el payload de clic a continuación ilustran el seguimiento de clics de Google. No son una especificación de integración de conversiones de OpenAI ni de Universal Ads.

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
        }
      ]
    }
  ]
}

​Atribución y seguimiento de conversiones

​Atribución interna de Topsort

​Atribución de la plataforma publicitaria

​Modelo de facturación

​Modalidades de pago

​Implementar seguimiento de eventos offsite con Topsort

​ID de usuario opaco

​URL de clic

​Informe de clics

​Informe de compras