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.

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.