Receber notificações de impressão

Você pode receber notificações de impressão sempre que o Google detectar que seus segmentos de dados foram usados em um lance vencedor no leilão de lances em tempo real e resultaram em uma impressão. O Google recomenda que você faça a integração com notificações de impressão para saber mais sobre como seus segmentos de dados estão sendo usados. Entre em contato com seu gerente de contas para ativar as notificações de impressão.

Configurar o endpoint de notificação de impressão

Você precisa criar um endpoint HTTP e compartilhar o URL dele com o Google para receber notificações de impressão. É possível definir o URL para onde as notificações de impressão são enviadas com uma das seguintes opções:

  1. Defina o URL do endpoint de notificação de impressão para cada destaque de curadoria em tempo real.
    • É possível definir dinamicamente o URL usado para notificações de impressão em cada destaque de curadoria em tempo real que você recebe preenchendo o campo SegmentResponse.burl.
    • Para uma determinada chamada de destaque de curadoria em tempo real, defina o campo SegmentResponse.burl para receber uma notificação de impressão para essa chamada. Se o campo SegmentResponse.burl não for preenchido, nenhuma notificação será enviada para essa frase de destaque, mesmo que o campo SegmentResponse.burl tenha sido definido em frases anteriores.
  2. Defina um URL de endpoint de notificação de impressão no nível da conta.
    • Para definir um URL de endpoint de notificação de impressão no nível da conta, entre em contato com seu gerente de contas. Isso é ideal se o URL do endpoint mudar com pouca frequência.
    • Todas as frases de destaque da curadoria em tempo real vão usar o URL de notificação de impressão no nível da conta que você configurar, a menos que você substitua o URL no nível da conta definindo o campo SegmentResponse.burl para uma frase de destaque individual da curadoria em tempo real.

Analisar uma notificação de impressão

As informações enviadas em uma notificação de impressão dependem da configuração do URL do endpoint de notificação de impressão. O URL do endpoint pode incluir parâmetros de consulta e usar macros para incluir mais contexto sobre como os segmentos de dados foram usados pelo lance vencedor que resultou em uma impressão.

Entenda como as macros são expandidas

Se você configurar o URL do endpoint para conter um ou mais parâmetros de consulta definidos como uma macro, as notificações de impressão enviadas ao endpoint vão expandir essas macros, substituindo-as pelos valores correspondentes.

Por exemplo, é possível configurar um URL de endpoint de notificação de impressão para ser semelhante a este:

https://testendpoint.com/impressions?segmentReqId=${SR_ID}&segmentIds=${SEGMENT_IDS}

Ao receber uma notificação de impressão, as macros seriam substituídas, fazendo com que o URL ficasse assim:

https://testendpoint.com/impressions?segmentReqId=8Mbl39sMOX5yg1NZgS35ET&segmentIds=test-ds-1|test-ds-2

Saiba mais sobre as macros compatíveis

Confira abaixo as macros que podem ser incluídas nos parâmetros de consulta do URL do endpoint de notificação de impressão. Essas macros são substituídas por valores relacionados ao lance vencedor que um ou mais segmentos de dados ajudaram a gerar.

Macro Descrição
${SR_ID} Um ID de string exclusivo equivalente ao campo SegmentRequest.segment_request_id do destaque de curadoria em tempo real correspondente. Isso se refere à solicitação de segmento que você respondeu com um ou mais IDs de segmento de dados que contribuíram para o lance vencedor.
${SEGMENT_IDS} Uma lista de IDs de segmento de dados de string que contribuíram para o lance vencedor. Cada item da lista é separado pelo caractere "|". Por exemplo, isso pode ser expandido para uma lista de valores como: "segmentId1|segmentId2|segmentId3" Cada ID de segmento de dados que preenche a lista se refere ao ID do recurso do recurso curators.dataSegments correspondente na API Marketplace.
${AUCTION_PRICE} Uma string que representa o preço vencedor do leilão. O preço é o custo de uma única impressão (CPI) expresso em microdólares. Por exemplo, um lance de US $5 de CPM em lances em tempo real resultaria na expansão da macro ${AUCTION_PRICE} para 5.000 micros de CPI em USD na notificação de impressão da curadoria em tempo real.
${DEAL_ID} ID da transação ou do pacote que venceu o leilão. É uma oferta ou um pacote que segmenta um ou mais IDs de segmento de dados, que podem ser identificados com a macro ${SEGMENT_IDS}.
${BUYER_SEAT_ID} O ID da licença do comprador que ganhou a impressão, conforme especificado pelo bidder no lance vencedor. Por exemplo, as posições de comprador podem ser agências ou anunciantes.

Próximas etapas