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:
- Obter uma API key para autenticação.
- 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:
Declarações de assets gerados por IA
content.aiGeneratedAssets é um array opcional com as URLs dos assets de imagem que o anunciante declarou que foram gerados ou modificados com IA. Compare essas URLs com os assets que você renderiza para determinar quais criativos carregam uma declaração do anunciante.
Somente os assets declarados positivamente são incluídos.
Resposta Sem Vencedores
Exemplo de resposta quando nenhum vencedor é encontrado:
Leitura Adicional
Para exemplos adicionais e casos de uso: