Third Party Demand

​

Visão Geral

• Demand Mediation – Para listagens patrocinadas, fontes de demanda externas (p. ex., Criteo) podem enviar lances ao leilão do Topsort, onde competem diretamente contra a demanda do Topsort. O lance mais alto vence, independentemente da fonte.
• Demand Fallback – Para espaços de banners, o Topsort pode retornar uma tag do Google Ad Manager (GAM) quando não há demanda do Topsort disponível, gerando receita incremental para o marketplace por meio de anúncios programáticos.

​

Demand Mediation

​

O que é Demand Mediation?

​

Como Funciona a Cobrança

• O varejista é o proprietário da conta/instância do Criteo, não o Topsort
• Os anunciantes pagam diretamente ao Criteo
• O Criteo cobra os anunciantes, retém sua taxa de plataforma e paga ao varejista sua parcela de receita
• O Topsort cobra o varejista separadamente (estrutura de cobrança a definir)

​

Benefícios

• Preencher lacunas: Quando não há demanda do Topsort para solicitações de anúncios, a demanda do Criteo pode estar disponível
• Aumentar a competição: Quando há demanda do Topsort, a demanda do Criteo pode dar lances maiores, aumentando a receita geral

​

Para quem é?

• Grandes marketplaces nos EUA: Muitas grandes marcas americanas dão lances em anúncios de mídia de varejo por meio de ferramentas como Pacvue e Skai, que por sua vez dão lances no inventário do Criteo. Essa configuração permite que grandes marcas evitem integração direta com cada varejista em que desejam anunciar.
• Grandes marketplaces na LATAM: O Criteo tem presença significativa na América Latina, tornando essa integração valiosa para grandes marketplaces da LATAM também.

​

Processo de Onboarding

​

Implementação da API

​

Alterações na Requisição

• demandSources: Array de objetos demandSource
  • source: Enum que identifica a fonte de demanda externa (ex.: "criteo")
  • bids: Array de objetos Bid, um para cada lance externo

• chargeType: Enum (apenas "CPC" é suportado na primeira versão)
• entity: Objeto com os campos type e id que identificam o produto patrocinado
• bidAmount: Valor do lance na moeda do marketplace
• metadata: Campo livre para qualquer metadado necessário na resposta do vencedor (ex.: URLs de beacon de lance)

​

Alterações na Resposta

• demandSource: String que identifica a fonte do lance vencedor (ex.: "topsort" ou "criteo"). Aparece apenas quando lances externos são incluídos na requisição.
• metadata: Para vencedores de lances externos, repassa os metadados de entrada do lance externo. Omitido para lances internos/Topsort.

​

Casos de Erro

• Demanda externa não está autorizada para o marketplace
• Lances externos inválidos (entidades que não são produtos, tipo de cobrança incorreto ou valor de lance negativo)
• Lances externos em excesso (mais de 100)
• Demanda externa com tipo de anúncio diferente de listagens
• Fonte de demanda externa inválida (apenas Criteo é suportado atualmente)

​

Exemplo de Requisição

{
  "auctions": [
    {
      "type": "listings",
      "slots": 2,
      "category": {
        "id": "paper"
      },
      "opaqueUserId": "user123",
      "demandSources": [
        {
          "source": "criteo",
          "bids": [
            {
              "chargeType": "CPC",
              "entity": {
                "type": "product",
                "id": "product123"
              },
              "bidAmount": 0.75,
              "metadata": {
                "beaconUrls": ["https://example.com/beacon"],
                "clickUrls": ["https://example.com/click"]
              }
            }
          ]
        }
      ]
    }
  ]
}

​

Exemplo de Resposta

{
  "results": [
    {
      "resultType": "listings",
      "winners": [
        {
          "demandSource": "criteo",
          "type": "product",
          "id": "product123",
          "resolvedBidId": "UkoVYQoQBpaVc2jmdMO0BA4QS9VdHRIQAZgtj1MxeFGT5HL2fhBhKRoQBlhiMAUTfKyPJHhKpsqrQCIKCgZzdWJ3YXkQATCmFUDTBEgBUMXa8pu8Mw",
          "rank": 1,
          "metadata": {
            "beaconUrls": ["https://example.com/beacon"],
            "clickUrls": ["https://example.com/click"]
          }
        },
        {
          "demandSource": "topsort",
          "campaignId": "01982d6e-8655-70e2-94e3-3e5e764b4753",
          "type": "product",
          "id": "product456",
          "resolvedBidId": "zOzJwgoQBpaVfNrgdmeSBLgWZwYYmhIQAZgtboZVcOKU4z5edktHUxoQBlhiMAUTfKyPJHhKpsqrQCIQCgxwYW5lcmEtYnJlYWQQATCmFUDTBEgBUKH3-5u8Mw",
          "rank": 2
        }
      ],
      "error": false
    }
  ]
}

​

Demand Fallback

​

O que é a integração GAM Fallback?

​

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: O Topsort pode configurar os posicionamentos do GAM para obter demanda tanto de open auction (anunciantes não endêmicos com links para outros sites) quanto de acordos diretos

​

Para quem é?

​

Processo de Onboarding

​

Exemplo de Requisição

{
  "auctions": [
    {
      "type": "banners",
      "slots": 1,
      "slotId": "fake-slot-2",
      "products": {
        "ids": ["prod-a1b2c3d4"]
      }
    }
  ]
}

​

Exemplo de Resposta

{
  "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",
          "resolvedBidId": "PHRSCwoQBpvFL1sveOSZBCyVii_LCRIQAAAAAAAAAAAAAAAAAAAAABoQAAAAAAAAAAAAAAAAAAAAACIbChdodHRwczovL3d3dy5leGFtcGxlLmNvbRAFUIDQzO7O7_H__wFyEAAAAAAAAAAAAAAAAAAAAAA",
          "rank": 1
        }
      ],
      "error": false
    }
  ]
}