Neste artigo, descrevemos como as plataformas de demanda (DSPs) podem integrar a plataforma das agências, oferecendo relatórios completos e fluxos de trabalho eficientes para agências e publishers.
As agências podem negociar e fechar transações programáticas não garantidas diretamente com os publishers. As transações no nível da agência são negociadas entre a conta da agência e do publisher e podem ser negociadas em todas as DSPs configuradas na conta da agência. Quando uma transação com a agência é criada, um ID de transação universal é gerado e usado por todas as DSPs participantes. Isso reduz a duplicação de IDs de transação (um por licença da DSP) para a mesma campanha.
Requisitos de integração para transações com uma licença da agência
As agências enviam ao Google uma lista com os IDs de licença para cada DSP no namespace correspondente, que o Google vai mapear à licença da agência. As DSPs precisam retornar o ID de licença na resposta do lance para a associação correta do gasto à agência.
- Especificação do OpenRTB (JSON ou Protobuf): preencha o campo
seatemseatbid. Para parceiros que já preenchem esse campo, não é necessário fazer nada no momento. - Protocolo Protobuf de RTB do Google: preencha o
BidResponse.ad.ad_slot.seat.
Para os bidders integrados à nossa API Marketplace, o Google vai retornar as transações que as agências fizeram no recurso de transações finalizadas no escopo do bidder. Como essas transações não pertencem ao bidder, as transações da agência retornadas neste recurso serão somente leitura e não terão uma proposta correspondente.
Fluxo de transações e requisitos da API para oferecer suporte a transações não garantidas
As transações são negociadas entre agências e publishers diretamente nas interfaces do Google.
- Um publisher pode criar uma proposta na interface do Google Ad Manager para a agência A.
- A agência A vai fazer login na interface da conta dela para aceitar a proposta ou negociar mudanças.
- Quando uma transação é finalizada e ativada, ela fica visível para as DSPs selecionadas da agência. Ao contrário das transações tradicionais, essas transações da agência são somente leitura para a DSP. No entanto, elas não são imutáveis: as agências podem renegociar os termos nas interfaces do Google.
Para acessar as transações finalizadas da agência, as DSPs precisam ser integradas à API Marketplace do Authorized Buyers. As DSPs podem receber uma lista de transações finalizadas pela API Finalized Deals no nível do bidder. Como as transações da agência pertencem à licença da agência e não a uma conta gerenciada pela DSP, buyers.finalizedDeals e buyers.proposals não vão retornar essas transações. O objeto da API Deals vai incluir mais informações relacionadas às contas da agência. As mudanças na documentação pública estão em negrito.
Representação JSON de uma transação
{
// ...
// ... Quando o campo media_planner
// estiver preenchido, este campo fica em branco e o comprador que vai receber a cobrança
// é determinado com base na resposta do lance.
// Formato: `buyers/{buyerAccountId}`
"billedBuyer" : string
// O campo de união negotiating_buyer só pode receber um destes valores:
"buyer": string,
"client": string,
// Este campo representa um planejador de mídia (por exemplo, agência ou
// anunciante grande).
"mediaPlanner" : {
object (MediaPlanner)
}
// Fim da lista de tipos possíveis para o campo negotiating_buyer.
// Se for definido, este campo tem a lista de IDs de licenças da DSP
// qualificados para participar da transação.
"eligibleSeatId": [
string
],
// ...
}
Observação: veja abaixo as mudanças importantes.
- O novo campo
mediaPlannerpode ser usado para identificar transações específicas da agência. - O campo
billedBuyervai ficar vazio para transações específicas da agência. - O novo campo
eligibleSeatIdsinclui o conjunto de licenças no namespace da DSP que estão qualificadas para dar lances na transação. As respostas de lance para a transação sem um ID de licença especificado ou com um não incluído na lista serão filtradas pelo Google.