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:
- Transações de leilão privado (iniciadas pelo editor)
- Transações preferenciais
- Transações programáticas garantidas
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
eflightEndTime
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.