API Marketplace

Visão geral

A API Authorized Buyers Marketplace é um conjunto de recursos que os compradores podem usar para gerenciar programaticamente o seguinte:

  • Negociações com editores
  • Pacotes de leilão
  • Acesso de cliente à interface do Marketplace do Authorized Buyers

Neste guia, apresentamos a API Marketplace e explicamos como os recursos dela são mapeados para os recursos do Marketplace na interface do Authorized Buyers.

Bidders e compradores

A API Marketplace é consistente com a estrutura da API de lances em tempo real. As duas APIs usam bidders e buyers como recursos no nível raiz para operações do bidder e do comprador. É possível usar os mesmos nomes de bidder e comprador em caminhos de recursos para as APIs de lances em tempo real e Marketplace.

Clientes e usuários clientes

É possível usar a API Marketplace para criar e gerenciar clientes e usuários clientes, além de conceder de maneira programática a agências ou anunciantes acesso à guia Marketplace na interface do Authorized Buyers.

Uma Client representa um cliente, uma agência ou um anunciante associado à sua conta do Authorized Buyers.

Um ClientUser representa um indivíduo específico que tem acesso à interface em uma Client. Os usuários clientes não podem acessar a API Marketplace. Os usuários clientes têm acesso limitado à guia Marketplace da sua conta. As permissões do usuário do cliente são determinadas pelo role especificado no Client pai.

Outros recursos na API Marketplace se referem aos clientes pelo nome especificado no recurso Clients.

Para saber mais sobre clientes e usuários clientes na interface do Marketplace do Authorized Buyers, consulte os seguintes artigos da Central de Ajuda:

Planejadores de mídia

Um planejador de mídia é uma agência ou outra entidade que negocia de modo independente negócios com editores e permite que um ou mais proponentes façam lances em nome das transações finalizadas. Essas transações podem ser de leilão privado ou preferidas, e não será possível visualizá-las nem interagir com elas até que sejam finalizadas. Depois disso, elas aparecerão na resposta bidders.finalizedDeals.list.

Para determinar se uma determinada transação finalizada foi negociada por um planejador de mídia, verifique se o campo mediaPlanner da transação foi preenchido. Os planejadores de mídia definem uma lista de IDs de licenças específicos da DSP qualificadas para fazer transações na transação. Ela pode ser visualizada com o campo eligibleSeatIds. Nas solicitações de lance em tempo real, esses IDs de licença podem aparecer em listas de permissões ou de bloqueio definidas pelo editor, o que vai determinar se os lances serão filtrados do leilão. Eles podem aparecer nos seguintes campos BidRequest:

  • Protocolo OpenRTB
    • BidRequest.wseat
    • BidRequest.bseat
    • BidRequest.imp.pmp.deals.wseat
  • Protocolo RTB do Google
    • BidRequest.adslot.allowed_seat_ids
    • BidRequest.adslot.blocked_seat_ids
    • BidRequest.adslot.matching_ad_data.direct_deal.allowed_seat_ids

Pacotes de leilão

É possível usar a API Marketplace para inscrever e cancelar a inscrição de compradores e clientes em pacotes de leilão, além de visualizar os pacotes de leilão em que você se inscreveu.

Uma AuctionPackage é semelhante a um pacote de segmentação para inventário do Marketplace. Por exemplo, um pacote de leilão pode segmentar um conjunto de URLs e IDs de apps para dispositivos móveis que são relevantes para os interesses comerciais de um comprador.

Não é possível criar novos pacotes de leilão com a API Marketplace. Use a interface do Marketplace do Authorized Buyers para criar pacotes de leilão. A API Marketplace não inclui informações de segmentação específicas associadas a pacotes de leilão.

É possível compartilhar pacotes de leilão com outros compradores e clientes, além de criar pacotes de leilão criados pelo Google ou por outros compradores.

Consulte Pacotes de leilão para mais informações.

Perfis do editor

É possível usar a API Marketplace para visualizar perfis de editores com quem você pode negociar.

Um PublisherProfile representa um editor na API Marketplace. Outros recursos na API Marketplace se referem aos editores com o nome especificado no PublisherProfile.

Os perfis do editor têm informações semelhantes às Editores na guia Descoberta da IU do Marketplace do Authorized Buyers.

Consulte Como descobrir editores para mais informações.

Propostas e transações

Você pode usar a API Marketplace para negociar transações com editores. Confira algumas maneiras de usar a API Marketplace para gerenciar transações:

As propostas representam o status de negociação mais recente de uma ou mais transações entre um comprador ou cliente e um editor e são semelhantes à guia Negociações da interface do Marketplace do Authorized Buyers.

As transações representam os termos mais recentes de uma transação negociada em uma determinada proposta e são comparáveis à lista de transações da interface do Marketplace do Authorized Buyers rotuladas como NEGOCIAÇÃO ATUAL para uma determinada proposta.

As transações finalizadas representam transações que concluíram a fase de negociação e estão prontas para serem veiculadas. Isso inclui transações que já estão sendo veiculadas. As transações finalizadas são semelhantes à guia Transações da interface do Marketplace do Authorized Buyers.

Dependendo do tipo de transação que você está negociando, o comportamento pode ser diferente entre os recursos da API Marketplace. Por exemplo, os compradores não podem iniciar negociações para todos os tipos de transação. Para saber mais sobre a implementação da API Marketplace para negociações, consulte os seguintes recursos:

Para saber mais sobre negociações na interface do Marketplace do Authorized Buyers, consulte este link: