Saltar para o conteúdo principal
A API de Leilões de Marcas Patrocinadas permite executar leilões para promover marcas usando assets, texto e produtos associados.

Antes de Começar

Para usar a API de Leilões de Marcas Patrocinadas, certifique-se de ter concluído o seguinte:
  1. Obter uma API key para autenticação.
  2. Criar várias campanhas, para ter lances disponíveis para os leilões.

Solicitação

O endpoint /auctions/sponsored-brand permite executar leilões para posicionamentos de marcas patrocinadas. Para a especificação completa deste endpoint, consulte a documentação da API.

Exemplo de Solicitação

Campos Principais:

  • auctions: Um array contendo objetos de leilão.
  • winners: O número máximo de vencedores para o leilão.
  • placementId: O ID do posicionamento onde o anúncio aparecerá.
  • triggers.products.ids: Um array de IDs de produtos associados ao leilão.

Resposta

Não armazene em cache esta resposta ou seus resultados. Os leilões devem permanecer únicos por visualização de página para garantir o funcionamento adequado.O armazenamento em cache pode resultar em resultados repetidos para vários usuários ou sessões.
Se não ocorrerem erros de solicitação, o endpoint retorna os resultados do leilão.

Resposta Com Vencedores

Exemplo de resposta quando vencedores são encontrados:

Resposta Sem Vencedores

Exemplo de resposta quando nenhum vencedor é encontrado:

Leitura Adicional

Para exemplos adicionais e casos de uso: