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

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.

SegmentRequest

Atributo Tipo Descrição
imp Matriz de impressões Disponível apenas para parceiros de curadoria contextual. Representa as oportunidades de impressão oferecidas.
site Site 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.
app App 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.
pub Editor Disponível apenas para parceiros de curadoria contextual. Um descritor do publisher.
user Usuário Um descritor do usuário que navegou pelo conteúdo do publisher e iniciou a solicitação de segmento.
device Dispositivo 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.
banner Banner 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.
video Vídeo 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.
ext ImpExt 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.
eids Matriz de EID 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.
uids Matriz de UID Disponível apenas para parceiros de curadoria de público-alvo. Matriz de objetos UID da origem especificada.

UID

Atributo Tipo Descrição
id string Disponível apenas para parceiros de curadoria de público-alvo. 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 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.

SegmentResponse

Atributo Tipo Descrição
segment Matriz de segmentos Um descritor para 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.