Ofertas

Um Deal representa um segmento de inventário, termos, detalhes de segmentação e outras informações para veiculação de anúncios. É possível incluir uma ou mais transações em um Proposal para negociar com os editores.

Tipos de oferta

Existem três tipos de transações que podem ser usadas em negociações:

ciclo de vida

Esta seção explica os diferentes estágios do ciclo de vida de uma oferta.

Criar propostas

Os compradores podem iniciar negociações enviando um pedido de proposta (RFP), em que o tipo de transação é especificado por preferredDealTerms ou programmaticGuaranteedTerms no corpo da solicitação. Esses tipos de transação exigem os campos flightStartTime e flightEndTime.

Para enviar uma proposta, é necessário se referir ao editor pelo PublisherProfile dele.

Negociar com editores

Nesta fase, você:

  • Atualizar a proposta e as transações correspondentes.
  • Pesquise se há atualizações do editor.
  • Decida quando aceitar os termos da proposta.

É possível corrigir uma proposta ou transação para fazer mudanças. Atualizar uma proposta incrementa proposalRevision.

Cancelar negociação

O que acontece quando você cancela a negociação de uma proposta e as transações correspondentes depende de a proposta ter um proposalRevision finalizado.

Se não houver um proposalRevision finalizado, o estado da proposta será TERMINATED e ela não estará mais disponível para negociação. Nesse caso, é necessário enviar uma nova proposta para retomar a negociação com o editor.

Caso contrário, a proposta e as transações serão revertidas para o último proposalRevision finalizado.

Não é possível cancelar propostas de transações de leilão privado com a API Marketplace. É possível arquivar transações de leilão privado na interface do Marketplace do Authorized Buyers.

Finalizar transações

Depois que as duas partes aceitam uma proposta, as transações na proposta são consideradas finalizadas. É possível usar o recurso buyers.finalizedDeals para gerenciar suas transações finalizadas.

Se uma proposta for modificada antes que as duas partes a aceitem, ambas precisarão aceitar a nova revisão antes que as transações na proposta sejam consideradas finalizadas.

Veicular transações finalizadas

Depois que uma transação é finalizada, ela aparece em solicitações de lance com base no período especificado por flightStartTime e flightEndTime. Se nenhum horário de voo for especificado (possível apenas para transações de leilão privado), a transação será veiculada indefinidamente.

As transações começam a ser veiculadas assim que possível após serem finalizadas. A veiculação geralmente começa no flightStartTime especificado.

Se você quiser desativar o comportamento de veiculação padrão e indicar manualmente quando está tudo pronto para começar a receber solicitações de lance, peça ao seu Gerente técnico de contas para permitir que você defina as transações como prontas para veiculação manualmente.

O Google recomenda que você comece manualmente a veiculação para transações programáticas garantidas se precisar preparar criativos para essas transações. Assim, é possível garantir que os criativos sejam revisados e estejam prontos para serem enviados em lances de lances em tempo real antes que as transações comecem a ser veiculadas. Depois de adicionar os criativos que quer inserir com uma transação programática garantida, recomendamos que você verifique os criativos associados à transação antes de começar a veiculação.

Nas solicitações de lance, as transações podem ser representadas por um dos seguintes campos, dependendo do protocolo:

  • Google: BidRequest.adslot[].matching_ad_data[].direct_deal[].direct_deal_id
  • OpenRTB: BidRequest.imp[].pmp.deals[].id

É possível pausar e retomar as transações preferenciais e programáticas garantidas depois que elas começarem a ser veiculadas. Pausar uma transação faz com que você deixe de receber solicitações de lance para ela até que retome a transação.

Somente o editor pode pausar transações de leilão privado.

Iniciar renegociação

Compradores e editores podem iniciar a renegociação de transações preferenciais finalizadas e transações programáticas garantidas. É possível iniciar a renegociação modificando uma proposta ou as negociações dela. Depois disso, é possível renegociar até que as duas partes aceitem as mudanças ou a renegociação seja cancelada.

Se aceitas, as transações revisadas da proposta substituem as transações finalizadas existentes e são veiculadas com base nos termos atualizados.

Se cancelada, a proposta e as transações são revertidas para o último proposalRevision final finalizado.

Durante a renegociação, as transações já finalizadas continuam sendo veiculadas. É possível continuar a conferir as transações finalizadas e a revisão da proposta mais recente.

A renegociação não é compatível com transações de leilão privado.

Encerrar veiculação

As transações finalizadas para todos os tipos de transação compatíveis têm o dealServingStatus definido como ENDED depois que a transação deixa de ser veiculada. Veja alguns exemplos de condições que podem encerrar o período de veiculação de uma transação:

  • O período definido em flightStartTime e flightEndTime passa. Isso é comum para transações preferenciais ou programáticas garantidas, porque esses campos são obrigatórios.
  • O impressionCap da transação programática garantida foi alcançado.

As transações de leilão privado que não definem um flightStartTime e um flightEndTime podem ser veiculadas indefinidamente.