Conheça a especificação de curadoria em tempo real
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O Google envia um SegmentRequest com base nas solicitações de anúncios que correspondem ao seu inventário segmentado e à integração da Curadoria em tempo real. O objeto SegmentRequest fornece indicadores contextuais ou de público-alvo que podem ser usados para identificar quais dos seus segmentos se aplicam ao inventário especificado no SegmentResponse.
A Curadoria em tempo real é compatível com objetos SegmentRequest e SegmentResponse enviados no formato JSON.
Este guia é uma referência ao protocolo de curadoria em tempo real que pode ajudar você a
criar sua integração.
Disponível apenas para parceiros de curadoria contextual. Um descritor do site. O campo site é preenchido se o conteúdo com suporte a anúncios for um site em vez de um aplicativo que não seja um navegador.
Disponível apenas para parceiros de curadoria contextual. Um descritor do app. O campo app é preenchido se o conteúdo com suporte a anúncios for um aplicativo que não é um navegador, em vez de um site.
Disponível apenas para parceiros de curadoria contextual. Um descritor do dispositivo do usuário.
segment_request_id
string
Um identificador exclusivo usado para identificar a solicitação de segmento independente de todas as outras solicitações de segmento.
Imp
Atributo
Tipo
Descrição
id
string
Disponível apenas para parceiros de curadoria contextual. Um identificador exclusivo para essa impressão no contexto da solicitação de segmento. O valor começa em 1 e aumenta até n para n impressões.
Disponível apenas para parceiros de curadoria contextual. Esse campo é preenchido se a impressão for oferecida como uma oportunidade de anúncio de banner.
Disponível apenas para parceiros de curadoria contextual. Esse campo é preenchido se a impressão for oferecida como uma oportunidade de anúncio em vídeo.
Esse campo é preenchido com extensões para o objeto Imp.
Banner
Atributo
Tipo
Descrição
w
int
Disponível apenas para parceiros de curadoria contextual. Largura em pixels independentes de dispositivo (DIPS).
h
int
Disponível apenas para parceiros de curadoria contextual. Altura em pixels independentes de dispositivo (DIPs).
pos
int
Disponível apenas para parceiros de curadoria contextual. Posição do anúncio na tela. Para saber mais sobre as posições de posicionamento possíveis, consulte Lista: posições de posicionamento no AdCOM 1.0.
Vídeo
Atributo
Tipo
Descrição
w
int
Disponível apenas para parceiros de curadoria contextual. Largura do player de vídeo em pixels independentes de dispositivo (DIPS).
h
int
Disponível apenas para parceiros de curadoria contextual. Altura do player de vídeo em pixels independentes de dispositivo (DIPs).
pos
int
Disponível apenas para parceiros de curadoria contextual. Posição do anúncio na tela. Para saber mais sobre as posições de posicionamento possíveis, consulte Lista: posições de posicionamento no AdCOM 1.0.
ImpExt
Atributo
Tipo
Descrição
gpid
string
Disponível apenas para parceiros de curadoria contextual. Descreve o ID do canal global. Um ID distinto e persistente, especificado pelo publisher, que é consistente em todos os caminhos de fornecimento para cada bloco de anúncios em uma página. Consulte este artigo.
Site
Atributo
Tipo
Descrição
page
string
Disponível apenas para parceiros de curadoria contextual. URL da página que mostra a impressão.
mobile
int
Disponível apenas para parceiros de curadoria contextual. Indica se o site foi programado para otimizar o layout quando visualizado em dispositivos móveis, em que 0 = não e 1 = sim.
App
Atributo
Tipo
Descrição
bundle
string
Disponível apenas para parceiros de curadoria contextual. Um identificador de aplicativo específico da plataforma que deve ser exclusivo do app. No Android, o campo bundle é um nome de pacote ou pacote. No iOS, é um ID numérico.
Editor
Atributo
Tipo
Descrição
id
string
Disponível apenas para parceiros de curadoria contextual. Um ID do publisher definido pelo sufixo do código de publisher do código de propriedade da Web. Por exemplo, um editor com um código de propriedade da Web ca-pub-123 teria o ID definido como pub-123.
Usuário
Atributo
Tipo
Descrição
id
string
O ID do usuário do Google.
buyeruid
string
Dados de correspondência hospedados enviados com o serviço de correspondência de cookies. Por padrão, isso é especificado em codificação base64 segura para a Web sem padding. Se quiser, entre em contato com seu gerente de contas para configurar esse campo sem codificação.
consent
string
Uma string de consentimento da Estrutura de Transparência e Consentimento (TCF) v2 do IAB codificada em base64 compatível com a Web buscada na plataforma de gestão de consentimento do IAB (CMP) do publisher. O campo consent é preenchido se o publisher fez a integração com uma CMP para a TCF v2 e essa CMP indica que o GDPR se aplica à solicitação de anúncio e fornece uma string de consentimento válida. Consulte a lista de fornecedores globais do IAB em vendor-list.consensu.org/v2/vendor-list.json para mais detalhes sobre os fornecedores listados na string de consentimento.
Disponível apenas para parceiros de curadoria de público-alvo. Instâncias de ID estendido. Na Curadoria, o campo eids são dados que o publisher disponibiliza, como indicadores seguros.
EID
Atributo
Tipo
Descrição
source
string
Disponível apenas para parceiros de curadoria de público-alvo. Fonte ou provedor de tecnologia responsável pelo conjunto de dados incluídos. Expresso como um domínio de nível superior.
Disponível apenas para parceiros de curadoria contextual. Localização do dispositivo do usuário.
devicetype
int
Disponível apenas para parceiros de curadoria contextual. O tipo geral de dispositivo. Para saber mais sobre os tipos de dispositivos possíveis, consulte Lista: tipos de dispositivos no AdCOM 1.0.
os
string
Disponível apenas para parceiros de curadoria contextual. Sistema operacional do dispositivo (por exemplo, "iOS").
make
string
Disponível apenas para parceiros de curadoria contextual. Marca do dispositivo (por exemplo, "Apple").
ifa
string
ID de publicidade do dispositivo não criptografado (sem hash). No protocolo de seleção em tempo real do Google, esse é normalmente um UUID de 36 caracteres, em que os IDs do Android estão em letras minúsculas e os IDFAs em maiúsculas. Para dispositivos Samsung, esses são valores alfanuméricos de 32 caracteres.
Geo
Atributo
Tipo
Descrição
country
string
Disponível apenas para parceiros de curadoria contextual. País usando o padrão ISO-3166-1 Alpha-3.
region
string
Disponível apenas para parceiros de curadoria contextual. Código da região usando o padrão ISO-3166-2; código de estado de duas letras se for nos EUA.
metro
string
Disponível apenas para parceiros de curadoria contextual. Código da região metropolitana do Google encontrado no arquivo geo-table.csv.
city
string
Disponível apenas para parceiros de curadoria contextual. Cidade que usa o Código das Nações Unidas para locais de comércio e transporte.
O ID do segmento. O ID precisa corresponder ao curatorDataSegmentId encontrado no nome do segmento no recurso curators.dataSegments da API Marketplace.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2026-09-23 UTC."],[],[]]