Saltar para o conteúdo principal

​
Listagens Patrocinadas

Listagens patrocinadas integram produtos promovidos nos resultados de busca ou páginas de categoria. Esses leilões permitem que os vendedores promovam produtos específicos dentro de contextos relevantes. O endpoint /auctions é usado para executar esses leilões.
Existem três tipos principais de listagens patrocinadas:
  1. Listagens patrocinadas de um conjunto de produtos: Isso permite leilões para um conjunto predefinido de IDs de produtos. Apenas lances direcionados a esses produtos específicos participarão. Você também pode incluir pontuações de qualidade personalizadas para cada produto na requisição, que são números entre 0 e 1 indicando relevância.
  2. Listagens patrocinadas em páginas de categoria: Esses leilões são para produtos pertencentes a categorias específicas. Apenas lances que visam produtos dentro das categorias especificadas serão considerados. As categorias podem ser especificadas usando um único ID, múltiplos IDs (todas as categorias) ou disjunções (pelo menos uma das categorias).
  3. Listagens patrocinadas em resultados de busca: Esses leilões são para produtos relevantes às consultas de busca. Você pode usar o parâmetro searchQuery, ou combiná-lo com um conjunto predefinido de produtos para expandir a lista de lances.

​
Banners Patrocinados

Banners patrocinados permitem a criação de leilões para anúncios em banner em várias páginas, como páginas iniciais ou landing pages. Eles podem ser usados para sliders de página inicial, marcas em destaque e carrosséis. O endpoint /auctions é usado para leilões de banner, com o campo type definido como "banners".
Leilões de banner podem ser segmentados com base em:
  1. Landing Pages: Crie slots para páginas iniciais de alto tráfego ou landing pages personalizadas com SlotIDs únicos, nomes, URLs e dimensões de imagem.
  2. Categoria e Busca: Permita que os vendedores segmentem categorias ou palavras-chave específicas usando os campos categoryId ou searchQuery na requisição do leilão.
  3. Carrosséis e Swimlanes: Múltiplos vencedores de banner podem ser solicitados para carrosséis ou swimlanes especificando o número desejado de slots na requisição do leilão.

​
Anúncios em Vídeo

Anúncios em vídeo são projetados para aprimorar a experiência de marca e produto mostrando produtos em ação, aumentando a visibilidade e engajando os clientes. A criação de campanhas para anúncios em vídeo segue o mesmo processo dos anúncios em banner, permitindo upload de vídeo e configuração de campanha. Os formatos de vídeo suportados incluem MP4 e MOV, com duração de 6 a 20 segundos e tamanho máximo de 200MB. Os marketplaces enviam um ID de slot e detalhes opcionais na requisição do leilão e recebem uma URL de vídeo na resposta.

​
Marcas Patrocinadas

Leilões de marcas patrocinadas permitem a promoção de marcas usando assets, texto e um produto associado. O endpoint dedicado para esses leilões é /auctions/sponsored-brand. Os campos principais na requisição incluem winners (número máximo de vencedores), placementId (ID do posicionamento do anúncio) e triggers.products.ids (array de IDs de produtos associados).

​
Listagens de Viagem

Listagens de viagem envolvem um novo endpoint de leilão e modelo de campanha projetado especificamente para o caso de uso de viagens, como hotéis e voos. Este tipo de leilão considera parâmetros únicos como travel_window (período da viagem), day_of_check_in e types_of_travelers (família, casal, solo, grupo). Esses parâmetros podem influenciar os valores dos lances através de valores multiplicadores. A requisição de leilão para listagens de viagem inclui detalhes como type (hotéis ou voos), winners, products (com IDs e pontuações de qualidade/preços opcionais) e um objeto travelContext com informações relevantes específicas de viagem.
Consulte a seção API de Leilões no Guia de Integração para mais informações e exemplos sobre como criar Leilões.
Última atualização: