Analisar o SegmentRequest

Na curadoria em tempo real, o Google envia um JSON SegmentRequest ao seu endpoint de curadoria para fornecer indicadores que descrevem uma ou mais impressões, permitindo que você determine os 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 de público-alvo

Ao criar um endpoint de curadoria em tempo real, você precisa escolher se quer receber indicadores contextuais ou indicadores de público-alvo. Os indicadores selecionados afetam a forma como as solicitações de segmento enviadas ao endpoint são preenchidas, a quantidade de inventário que produz solicitações de segmento enviadas ao endpoint e a lógica de curadoria usada na 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 de aplicativo específico da plataforma. 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 com precisão no nível da metrópole.

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

Usar indicadores de público-alvo

Os indicadores de público-alvo incluem identificadores de usuário ou dispositivo, além de 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 Curadoria em tempo real na forma ofuscada em SegmentRequest.user.eids.uids.id.

Se o endpoint estiver configurado para usar indicadores de público-alvo, 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 total de impressões qualificadas para serem enviadas aos endpoints de indicadores de público-alvo em comparação com os endpoints de indicadores contextuais.

A lógica de curadoria do seu endpoint precisa interpretar os indicadores de público-alvo e determinar os segmentos de dados aplicáveis para retornar no SegmentResponse.

Exemplos de SegmentRequest

Endpoint de curadoria 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 seleção em tempo real do indicador de público-alvo

{
  "device":{
    "ifa":"OMITTED_IFA"
  },
  "user": {
    "eids" : [ {
      "source": "pubcid.org",
      "uids":[
        { "id" :"OMITTED_SECURE_SIGNAL" }
      ]
    }],
    "buyeruid": "OMITTED_BUYERUID",
    "id": "OMITTED_ID"
  }
}

Próximas etapas