Atribuição e faturamento - Topsort Documentation

Atribuição e acompanhamento de conversões

A sua configuração de rastreamento de conversões determina como as vendas são atribuídas aos anúncios e quais métricas ficam disponíveis no Topsort. Para uma visão geral das opções de integração, consulte Rastreamento de conversões.

Atribuição interna da Topsort

Quando seu marketplace envia eventos de clique e compra para o Topsort, o Topsort pode atribuir as compras aos anúncios usando sua atribuição interna. Você pode aplicar a mesma janela de atribuição e configuração nas plataformas de anúncios compatíveis, o que permite comparações equivalentes de vendas e retorno sobre o investimento em anúncios (ROAS). Enviar eventos para o Topsort não significa automaticamente que todas as plataformas de anúncios os recebam. Em algumas plataformas de anúncios, incluindo o Google, o Topsort encaminha as conversões elegíveis. Outras plataformas de anúncios exigem compartilhamento de conversões separado para suportar a otimização para conversões. Consulte Implementar rastreamento de eventos offsite com Topsort para as instruções de implementação.

Atribuição da plataforma de anúncios

Quando seu marketplace envia conversões diretamente para uma plataforma de anúncios, o Topsort recupera os relatórios resultantes e os exibe na sua interface. Essas métricas seguem a metodologia de atribuição da plataforma de anúncios. Diferenças nas janelas de atribuição e nas configurações podem afetar as comparações entre plataformas de anúncios. A atribuição interna da Topsort não é obrigatória para que a integração offsite funcione.

Modelo de faturamento

O faturamento offsite é controlado pelo marketplace e consolidado:

Vendors consomem capacidade de wallet por canal (por exemplo, wallet do Google, Meta, Snapchat, TikTok ou Universal Ads).
O marketplace é cobrado diretamente pelo canal pelo media spend.
O marketplace cobra seus vendors de acordo com seus termos comerciais.

Modalidades de pagamento

Prepay: o vendor adiciona créditos antes de gastar.
Postpay: o marketplace define limites de capacidade de gasto e faz a liquidação depois.

Implementar rastreamento de eventos offsite com Topsort

Esta seção é destinada a desenvolvedores, como desenvolvedores frontend que implementam o rastreamento de eventos. Ela explica como enviar eventos de clique e compra do marketplace para o Topsort para a atribuição interna. Reporte os eventos offsite pelo mesmo endpoint /v2/events usado para eventos onsite, com os parâmetros offsite adicionais mostrados abaixo. O exemplo de URL de clique e o payload de clique abaixo ilustram o rastreamento de cliques do Google. Eles não são uma especificação de integração de conversões da OpenAI ou do Universal Ads.

ID de usuário opaco

O mesmo opaqueUserId usado para eventos onsite também deve ser reutilizado para atribuição offsite. Não é necessário um identificador offsite separado. O Topsort precisa de um identificador de usuário persistente e seguro para privacidade para conectar cliques e compras entre canais. Os mesmos requisitos onsite se aplicam ao uso offsite:

Persistência: Deve permanecer estável durante a janela de atribuição (normalmente 7–30 dias).
Consistência: O mesmo usuário deve receber o mesmo ID em visitas e canais quando possível.
Seguro para privacidade: Não deve conter PII como email, número de telefone ou nome.

URL de clique

A URL que o usuário tem ao chegar ao seu site a partir de um clique de anúncio offsite terá parâmetros de consulta importantes anexados. Exemplo de URL de clique:

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 clique anexado pelo Google
externalCampaignId e externalVendorId — parâmetros de consulta contendo o ID da campanha e o ID do vendedor do Topsort, anexados pelo Topsort. Devem persistir junto com o estado de atribuição do usuário por pelo menos a duração da janela de atribuição (configurável 7–30 dias). Devem sobreviver à navegação e visitas repetidas para que eventos de compra subsequentes possam ser corretamente vinculados ao clique de anúncio offsite originador.

Reportar cliques

Envie o evento abaixo quando um usuário chegar ao seu site a partir de um clique de anúncio offsite. Todos os campos são obrigatórios.

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

Reportar compras

Todos os campos são obrigatórios.

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

​Atribuição e acompanhamento de conversões

​Atribuição interna da Topsort

​Atribuição da plataforma de anúncios

​Modelo de faturamento

​Modalidades de pagamento

​Implementar rastreamento de eventos offsite com Topsort

​ID de usuário opaco

​URL de clique

​Reportar cliques

​Reportar compras