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

O Google envia uma SegmentRequest com base nas 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 você pode usar para identificar quais dos seus segmentos se aplicam ao inventário especificado na SegmentResponse. A Curadoria em tempo real é compatível com 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
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 de 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 editor.
user	Usuário	Um descritor do usuário que navegou pelo conteúdo do editor 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.

Site

Atributo	Tipo	Descrição
page	string	Disponível apenas para parceiros de curadoria contextual. URL da página que mostra a impressão.

App

Atributo	Tipo	Descrição
bundle	string	Disponível 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 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 de editor definido pelo sufixo do código de editor 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 compatível com a Web buscada na plataforma de gestão de consentimento (CMP) do IAB do editor. 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 EID	Só é compatível com parceiros de curadoria de indicadores seguros. Instâncias de ID estendido. Na Curadoria, o campo eids são dados disponibilizados pelo publisher, como indicadores seguros.

EID

Atributo	Tipo	Descrição
source	string	Só é compatível com parceiros de curadoria de indicadores seguros. Provedor de tecnologia ou fonte responsável pelo conjunto de dados incluídos. Expresso como um domínio de nível superior.
uids	Matriz UID	Só é compatível com parceiros de curadoria de indicadores seguros. Matriz de objetos UID da origem especificada.

UID

Atributo	Tipo	Descrição
id	string	Só é compatível com 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	Disponível apenas para parceiros de curadoria contextual. Localização do dispositivo do usuário.

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.

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.