Analisar o SegmentRequest

Na seleção em tempo real, o Google envia um SegmentRequest JSON ao seu endpoint de seleção para fornecer indicadores que descrevem uma ou mais impressões, permitindo que você determine segmentos de dados aplicáveis a cada uma delas. Este guia aborda o desenvolvimento de uma lógica de curadoria que processa o SegmentRequest.

Usar codificação gzip

O Google usa a codificação gzip ao enviar um SegmentRequest para seu endpoint. Seu endpoint precisa ser capaz de receber e responder com codificação gzip.

Curadoria com endpoints de indicadores contextuais ou seguros

Ao criar um endpoint de curadoria em tempo real, é necessário selecionar se você quer receber indicadores contextuais ou seguros. Os indicadores selecionados afetam como as solicitações de segmento enviadas ao seu endpoint são preenchidas, quanto inventário produz solicitações de segmento enviadas ao seu endpoint e a lógica de curadoria usada na sua integração.

Usar indicadores de contexto

Os indicadores contextuais incluem informações sobre o editor, o dispositivo e o usuário que descrevem a origem da impressão. A lista a seguir descreve os indicadores disponíveis:

  • SegmentRequest.site: descreve o site que renderiza a impressão, como o URL do site. Apenas um de SegmentRequest.site e SegmentRequest.app pode ser preenchido em um SegmentRequest.
  • SegmentRequest.app: descreve o app que renderiza a impressão, como o identificador específico da plataforma do aplicativo. Apenas um de SegmentRequest.site e SegmentRequest.app pode ser preenchido em um SegmentRequest.
  • SegmentRequest.pub: Descreve o publisher da mídia que renderiza a impressão, por exemplo, o ID do publisher.
  • SegmentRequest.user: Descreve as escolhas do usuário sobre como os dados pessoais dele podem ser tratados, por exemplo, com a string de consentimento da TCF.
  • SegmentRequest.device: Descreve informações sobre o dispositivo, como a localização geográfica dele com precisão no nível da região metropolitana.

É possível usar sinais contextuais para implementar uma lógica de curadoria que determine os segmentos de dados aplicáveis a serem retornados no SegmentResponse.

Usar indicadores seguros

Os indicadores seguros são dados criados pelo publisher que ele escolheu compartilhar com um ou mais parceiros. Eles são ofuscados antes de serem compartilhados com o Google na solicitação de anúncio e aparecem na forma ofuscada em SegmentRequest.user.eids.uids.id na Curadoria em tempo real.

Se o endpoint estiver configurado para usar indicadores seguros, ele só vai receber solicitações de segmento para o inventário de publishers que optaram por compartilhar indicadores seguros com sua conta de curadoria. Como resultado, há menos impressões totais qualificadas para serem enviadas a endpoints de sinal seguro em comparação com endpoints de sinal contextual.

A lógica de curadoria do seu endpoint precisa interpretar o indicador seguro e usá-lo para determinar os segmentos de dados aplicáveis a serem retornados no SegmentResponse.

Exemplos de SegmentRequest

Endpoint de seleção em tempo real de indicadores contextuais

{
  "site":{
    "page":"https://dfpgpt.appspot.com/smd/"
  },
  "pub":{
    "id":"pub-1234567890987654"
  },
  "device":{
    "geo":{
      "country":"US",
        "metro":"501"
      }
    }
  }
}

Endpoint de curadoria em tempo real de indicadores seguros

{
  "user": {
    "eids" : [ {
      "source": "pubcid.org",
      "uids":[
        { "id" :"OMITTED_SECURE_SIGNAL" }
      ]
    }]
  }
}

Próximas etapas