Saltar para o conteúdo 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.

​
O que é GAM Demand Mediation?

Gere receita incremental com impressões de banner que ficariam sem preenchimento, sem mudar sua configuração atual do Topsort.
Quando não há demanda do Topsort para um banner slot, retornamos automaticamente um anúncio do Google Ad Manager (GAM). Você só precisa renderizar.
Diagrama do fluxo de GAM fallback mostrando o leilão retornando uma tag GAM quando não há demanda do Topsort

​
Benefícios

  • Monetizar inventário não vendido: Marketplaces podem gerar receita com espaços de banners mesmo quando não há demanda do Topsort
  • Fontes de demanda flexíveis: Topsort pode configurar placements GAM para open auction ou direct deals

​
Para quem é?

Qualquer marketplace Topsort no mundo com slots de banner.

​
Processo de onboarding

Se seu marketplace estiver interessado em GAM demand mediation, entre em contato com a equipe da sua conta Topsort.
Uma integração típica leva apenas algumas horas do tempo de um engenheiro do marketplace e pode ser feita ao vivo em uma única chamada com um engenheiro de integração da Topsort.
1

Alinhar escopo do piloto

Selecione 2-3 slots de banners e alinhe políticas de moderação de conteúdo.
2

Configurar conexão GAM MCM

Vincule contas Topsort e varejista, e atualize ads.txt e sellers.json.
3

Implementar passback flow

Adicione um snippet pequeno em cada ad slot para renderizar anúncio Topsort ou anúncio GAM.
4

Testes

Topsort valida a integração.

​
Exemplo de resposta

Quando não há demanda do Topsort para um banner slot habilitado para GAM demand mediation, o endpoint de leilões retorna um snippet GAM no campo asset do vencedor.
{
  "results": [
    {
      "resultType": "banners",
      "winners": [
        {
          "asset": [
            {
              "content": "{\"type\": \"gam_snippet\", \"content\": \"<div id=\\\"gam-ad\\\"><script>googletag.cmd.push(function() { googletag.display(\\\"div-gpt-ad-12345\\\"); });</script></div>\"}"
            }
          ],
          "type": "url",
          "id": "https://www.example.com",
          "rank": 1
        }
      ],
      "error": false
    }
  ]
}

​
Passback flow

O único desenvolvimento necessário pelo marketplace é adicionar um snippet pequeno em cada ad slot habilitado para demanda GAM.
// response is response from Topsort auction endpoint
const { results } = await response.json();
const passback = results?.[0]?.winners?.[0]?.metadata?.passbacktag;

if (passback) {
  const iframe = document.createElement("iframe");
  document.getElementById("banner-slot-3")?.appendChild(iframe);
  iframe.contentDocument.write(passback);
  iframe.contentDocument.close();
} else {
  // render normal Topsort ad
}