Transações programáticas garantidas

Em acordos programáticos garantidos, você negocia com os vendedores o número de impressões que comprará a um preço fixo. Ao aceitar uma proposta para uma transação programática garantida, você se compromete a comprar o estoque do vendedor com base nos termos negociados. Para saber mais sobre seus compromissos e ferramentas para monitorar sua conformidade, consulte o artigo da Central de Ajuda que descreve oEstrutura de SLA programática garantida.

Criar

Os Acordos Programáticos Garantidos são criados quando as negociações começam com uma solicitação de proposta (RFP). Você pode iniciar negociações enviando uma solicitação de proposta (RFP) a um fornecedor combuyers.proposals.sendRfp. O RFP deve conter programmaticGuaranteedTerms para que a proposta resultante seja para uma transação programática garantida. Os vendedores também podem enviar uma RFP (Solicitação de Proposta), que aparecerá como uma proposta na API Marketplace. Uma vez criada, você poderá encontrar a proposta de negócio combuyers.proposals.list E então a negociação entre você e o vendedor pode começar.

Negociar

Após a criação de uma proposta para uma transação programática garantida, você pode negociar com o vendedor, ajustando a proposta e a transação correspondente até que ambas as partes estejam satisfeitas ou a proposta seja cancelada. Em uma negociação bem-sucedida, você pode realizar qualquer uma das seguintes ações:

  • Verificar alterações na proposta ou no acordo: Sempre que uma alteração for feita em uma proposta ou em seu acordo correspondente, o proposalRevision ​​será incrementado. Você pode usar isso para detectar quando o vendedor aceitou sua proposta ou respondeu com uma contraproposta.
  • Corrigir a proposta ou negócio: Modifique sua proposta ou envie uma contraproposta ao vendedor. Isso incrementará o proposalRevision.
  • Comunique com o vendedor: As propostas contêm notas que são visíveis para compradores e vendedores. Por exemplo, você pode adicionar uma nota para fornecer contexto sobre uma alteração que você fez em uma proposta ou em seu acordo.

Finalize e prepare para servir.

Quando você estiver satisfeito com uma proposta e o state dela for BUYER_ACCEPTANCE_REQUESTED, aceite a proposta. Isso finaliza o acordo, que começa a ser servido no flightStartTime.

Para garantir que a oferta comece a ser veiculada somente quando você tiver os criativos prontos, recomendamos que entre em contato com seu Gerente de Contas Técnicas para desativar esse comportamento padrão das suas Ofertas Programáticas Garantidas e, em vez disso, sinalize manualmente quando elas estiverem prontas para serem veiculadas. Aqui está um exemplo de fluxo de trabalho onde você sinaliza manualmente quando suas Ofertas Programáticas Garantidas estão prontas para serem veiculadas:

  • Negocie a proposta com o vendedor
  • Use a API de lances em tempo real para enviar criativos para revisão: os criativos que você pretende veicular precisam ser revisados e aprovados para uso em transações.
  • Aceitar a proposta: Uma vez que uma proposta é aceita, os negócios aceitos são refletidos em negócios finalizados.
  • Use a API Real-time Bidding para recuperar os criativos enviados anteriormente e confirmar se eles estão aprovados para uso em lances de transações programáticas em lances em tempo real. Consulte dealsPolicyCompliance para verificar se os criativos estão aprovados e podem ser colocados em resposta a solicitações de lance de transação programática recebidas.
    • Se a criação não foi aprovada, revise os tópicos para determinar o motivo da reprovação. Ajuste o criativo conforme necessário e patch para iniciar a revisão novamente até que todos os problemas sejam resolvidos.
  • Use a API de lances em tempo real para adicionar a oferta a todos os criativos que serão usados ​​na oferta: Adicionar uma oferta a um criativo permite que o editor associado à oferta revise esse criativo antes do início da veiculação.
    • Se um editor exigir a revisão manual de criativos, os lances com criativos que não foram aprovados por ele serão filtrados do leilão. O Google recomenda adicionar a oferta a todos os anúncios que você pretende usar na promoção antes que ela comece.
  • Sinalize manualmente que o negócio está pronto para servir: Assim que o negócio estiver pronto para servir, você começará a receber solicitações de lances para o negócio no flightStartTime configurado, que continuarão até que seu flightEndTime ou impressionCap seja atingido.

Renegociar

Após a finalização do negócio, você ou o vendedor podem iniciar o processo.renegociação modificando a proposta ou seus termos. Durante a renegociação, o recurso finalizedDeals reflete o contrato anterior e continua veiculando com base nele, se possível. O recurso deals reflete o estado atual da renegociação, que vai prosseguir de maneira semelhante à negociação inicial.

Se você e o vendedor aceitarem o acordo renegociado, ele substituirá o acordo original finalizado e passará a valer com base no novo contrato. Caso contrário, se for cancelado, o acordo voltará ao estado anterior ao início da renegociação.

Dê lances em impressões para ofertas programáticas garantidas.

Quando uma transação programática garantida começa a veicular, sua integração de lances em tempo real recebe solicitações de lances para essa transação e precisa dar lances com base nos termos dela, por exemplo, a um preço específico para um número definido de impressões em um período.

Uma determinada solicitação de lance pode incluir mais de uma transação de PG. Quando isso acontecer, espera-se que você responda para cada ID da transação enviado na solicitação. Os campos diretamente relevantes para Acordos Programáticos Garantidos incluem os seguintes:

Protocolo do Google Protocolo OpenRTB Descrição
BidRequest.adslot.matching_ad_data.direct_deal.direct_deal_id BidRequest.imp.pmp.deals.id Identificador exclusivo do negócio. Isso será equivalente ao ID do recurso da transação, conforme retornado pela API Marketplace.
BidRequest.adslot.matching_ad_data.direct_deal.deal_type BidRequest.imp.pmp.deals.ext.deal_type O tipo de leilão, que será definido como PROGRAMMATIC_GUARANTEED, ou "3" para OpenRTB JSON.
BidRequest.adslot.matching_ad_data.direct_deal.fixed_cpm_micros BidRequest.imp.pmp.deals.bidfloor Será equivalente ao CPM da transação acordada entre o comprador e o vendedor. Isso vai aparecer como fixedPrice na API Marketplace. Para transações programáticas garantidas, isso substituirá qualquer valor especificado na resposta à solicitação de lance.
BidRequest.adslot.matching_ad_data.direct_deal.publisher_blocks_overridden BidRequest.imp.pmp.deals.ext.publisher_blocks_overridden Sempre true para Ofertas Programáticas Garantidas, o que significa que categorias excluídas são permitidas.
BidRequest.adslot.matching_ad_data.direct_deal.must_bid BidRequest.imp.pmp.deals.ext.must_bid Indica se os compradores são obrigados a apresentar uma proposta para o negócio. Por exemplo, se o negócio estiver adiantado em relação ao cronograma, essa opção seria definida como False e o lance seria opcional. Caso contrário, é necessário dar um lance. Se isso não acontecer, a exibição da transação e a disponibilidade do inventário podem ser afetadas negativamente.

Pausar e retomar a veiculação

Use o método buyers.finalizedDeals.pause para pausar uma transação de programática garantida finalizada se você não puder fazer lances temporariamente. Por exemplo, você pode fazer isso se sua criação foi inicialmente aprovada, mas foi reprovada e, consequentemente, precisa ser reenviada. Note que, embora isso impeça você de receber solicitações de propostas para o negócio, você ainda precisará cumprir todas as obrigações que foram negociadas como termos do acordo.

Para retomar a veiculação da transação finalizada, use buyers.finalizedDeals.resume.