Conheça a especificação de curadoria em tempo real

O Google envia um SegmentRequest com base em solicitações de anúncios que correspondem ao seu inventário segmentado para a integração de curadoria em tempo real. O objeto SegmentRequest fornece indicadores contextuais ou seguros que podem ser usados para identificar quais dos seus segmentos se aplicam ao inventário especificado no SegmentResponse. A curadoria em tempo real oferece suporte a objetos SegmentRequest e SegmentResponse enviados no formato JSON.

Este guia é uma referência para o protocolo de curadoria em tempo real que pode ajudar você a criar sua integração.

SegmentRequest

Atributo Tipo Descrição
imp Matriz de impressões Oferecido apenas para parceiros de curadoria contextual. Representa as oportunidades de impressão oferecidas.
site Site Oferecido apenas para parceiros de curadoria contextual. Um descritor do site. O campo site é preenchido se o conteúdo com anúncios for um site, e não um aplicativo fora do navegador.
app App Oferecido apenas para parceiros de curadoria contextual. Um descritor do app. O campo app é preenchido se o conteúdo com anúncios for um aplicativo fora do navegador, e não um site.
pub Editor Oferecido apenas para parceiros de curadoria contextual. Um descritor do editor.
user Usuário Um descritor do usuário que está navegando no conteúdo do editor e iniciou a solicitação de segmento.
device Dispositivo Oferecido 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 de forma independente de todas as outras.

Imp

Atributo Tipo Descrição
id string Oferecido 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.
banner Banner Oferecido apenas para parceiros de curadoria contextual. Esse campo é preenchido se a impressão for oferecida como uma oportunidade de anúncio em banner.
video Vídeo Oferecido apenas para parceiros de curadoria contextual. Esse campo é preenchido se a impressão for oferecida como uma oportunidade de anúncio em vídeo.
ext ImpExt Esse campo é preenchido com extensões para o objeto Imp.

Banner

Atributo Tipo Descrição
w int Oferecido apenas para parceiros de curadoria contextual. Largura em pixels independentes de dispositivo (DIPs).
h int Oferecido apenas para parceiros de curadoria contextual. Altura em pixels independentes de dispositivo (DIPs).
pos int Oferecido 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 Oferecido apenas para parceiros de curadoria contextual. Largura do player de vídeo em pixels independentes de dispositivo (DIPs).
h int Oferecido apenas para parceiros de curadoria contextual. Altura do player de vídeo em pixels independentes de dispositivo (DIPs).
pos int Oferecido 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 Oferecido apenas para parceiros de curadoria contextual. Descreve o ID de posicionamento global. Um ID distinto e persistente, especificado pelo editor, 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 Oferecido apenas para parceiros de curadoria contextual. URL da página que mostra a impressão.
mobile int Oferecido 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 Oferecido apenas para parceiros de curadoria contextual. Um identificador de aplicativo específico da plataforma destinado a ser exclusivo do app. No Android, o campo bundle é um nome de pacote. No iOS, é um ID numérico.

Editor

Atributo Tipo Descrição
id string Oferecido apenas para parceiros de curadoria contextual. Um ID do publisher definido pelo sufixo 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
consent string Uma string de consentimento da Estrutura de Transparência e Consentimento (TCF) v2 do IAB codificada em base64 segura para a Web buscada na plataforma de gestão de consentimento (CMP) do IAB do editor. O campo consent é preenchido se o editor tiver feito a integração com uma CMP para TCF v2 e essa CMP indicar que o GDPR se aplica à solicitação de anúncio e fornecer 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.
eids Matriz de EID Oferecido apenas para parceiros de curadoria de indicadores seguros. Instâncias de ID estendidas. Na curadoria, o campo eids são dados disponibilizados pelo editor, como indicadores seguros.

EID

Atributo Tipo Descrição
source string Oferecido apenas para parceiros de curadoria de indicadores seguros. Fonte ou provedor de tecnologia responsável pelo conjunto de dados incluídos. Expresso como um domínio de nível superior.
uids UID de UID Oferecido apenas para parceiros de curadoria de indicadores seguros. Matriz de objetos UID da origem especificada.

UID

Atributo Tipo Descrição
id string Oferecido apenas para parceiros de curadoria de indicadores seguros. O identificador. Na curadoria, o campo id é um indicador seguro. Para saber mais sobre indicadores seguros, consulte Compartilhar indicadores seguros com bidders e parceiros de curadoria do Ad Manager.

Dispositivo

Atributo Tipo Descrição
geo Área geográfica Oferecido apenas para parceiros de curadoria contextual. Localização do dispositivo do usuário.
devicetype int Oferecido 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 Oferecido apenas para parceiros de curadoria contextual. Sistema operacional do dispositivo (por exemplo, "iOS").
make string Oferecido apenas para parceiros de curadoria contextual. Marca do dispositivo (por exemplo, "Apple").

Área geográfica

Atributo Tipo Descrição
country string Oferecido apenas para parceiros de curadoria contextual. País usando o padrão ISO-3166-1 Alpha-3.
region string Oferecido apenas para parceiros de curadoria contextual. Código regional usando o padrão ISO-3166-2; código de estado de duas letras se for nos EUA.
metro string Oferecido apenas para parceiros de curadoria contextual. Código de região metropolitana do Google encontrado no arquivo geo-table.csv.
city string Oferecido apenas para parceiros de curadoria contextual. Cidade usando o código das Nações Unidas para locais de comércio e transporte.

SegmentResponse

Atributo Tipo Descrição
segment Matriz de segmentos Um descritor de um segmento.

Segmento

Atributo Tipo Descrição
segment_id string O ID do segmento. O ID precisa corresponder ao curatorDataSegmentId encontrado no nome do segmento no recurso curators.dataSegments da API Marketplace.