Obtén información sobre las especificaciones de la Curación en tiempo real

Google envía una SegmentRequest basada en las solicitudes de anuncios que coinciden con tu inventario segmentado a tu integración de Curación en tiempo real. El objeto SegmentRequest proporciona indicadores contextuales o seguros que puedes usar para identificar cuáles de tus segmentos se aplican al inventario determinado en SegmentResponse. La Curación en tiempo real admite objetos SegmentRequest y SegmentResponse enviados en formato JSON.

Esta guía es una referencia del protocolo de Curación en tiempo real que puede ayudarte a crear tu integración.

SegmentRequest

Atributo	Tipo	Descripción
site	Sitio	Solo se admite para los socios de curación contextual. Es un descriptor del sitio web. El campo site se completa si el contenido con anuncios es un sitio web en lugar de una aplicación que no es un navegador.
app	Aplicaciones	Solo se admite para los socios de curación contextual. Es un descriptor de la app. El campo app se completa si el contenido compatible con anuncios es una aplicación que no es un navegador, en lugar de un sitio web.
pub	Publicador	Solo se admite para los socios de curación contextual. Es un descriptor del editor.
user	Usuario	Es un descriptor del usuario que navega por el contenido del publicador y que inició la solicitud de segmento.
device	Dispositivo	Solo se admite para los socios de curación contextual. Es un descriptor del dispositivo del usuario.
segment_request_id	string	Es un identificador único que se usa para identificar la solicitud de segmento de forma independiente de todas las demás solicitudes de segmento.

Sitio

Atributo	Tipo	Descripción
page	string	Solo se admite para los socios de curación contextual. Es la URL de la página que muestra la impresión.

Aplicación

Atributo	Tipo	Descripción
bundle	string	Solo se admite para los socios de curación contextual. Es un identificador de aplicación específico de la plataforma que debe ser único para la app. En Android, el campo bundle es un nombre de paquete o de paquete. En iOS, es un ID numérico.

Editor

Atributo	Tipo	Descripción
id	string	Solo se admite para los socios de curación contextual. Es un ID de publicador definido por el sufijo del código de publicador del código de propiedad web. Por ejemplo, un publicador que tenga un código de propiedad web ca-pub-123 tendrá su ID establecido en pub-123.

Usuario

Atributo	Tipo	Descripción
consent	string	Es una cadena de consentimiento del Marco de trabajo de transparencia y consentimiento (MTC) v2 de IAB codificada en base64 apta para la Web que se recupera de la plataforma de administración de consentimiento (CMP) de IAB del publicador. El campo consent se completa si el publicador se integró con una CMP para el MTC v2 y esa CMP indica que el RGPD se aplica a la solicitud de anuncio y proporciona una cadena de consentimiento válida. Consulta la Lista de proveedores globales de IAB en vendor-list.consensu.org/v2/vendor-list.json para obtener detalles sobre los proveedores que se mencionan en la cadena de consentimiento.
eids	EID array	Solo se admite para los socios selectores de indicadores seguros. Son instancias de ID extendido. En la Curación, el campo eids son datos que el publicador pone a disposición, como los indicadores seguros.

EID

Atributo	Tipo	Descripción
source	string	Solo se admite para los socios selectores de indicadores seguros. Es el proveedor de la fuente o la tecnología responsable del conjunto de datos incluidos. Se expresa como un dominio de nivel superior.
uids	UID array	Solo se admite para los socios selectores de indicadores seguros. Es un array de objetos UID de la fuente determinada.

UID

Atributo	Tipo	Descripción
id	string	Solo se admite para los socios selectores de indicadores seguros. Es el identificador. En la curación, el campo id es un indicador seguro. Para obtener más información sobre los indicadores seguros, consulta Comparte indicadores seguros con los ofertantes y los socios selectores en Ad Manager.

Dispositivo

Atributo	Tipo	Descripción
geo	Ubicación geográfica	Solo se admite para los socios de curación contextual. Ubicación del dispositivo del usuario.

Ubicación geográfica

Atributo	Tipo	Descripción
country	string	Solo se admite para los socios de curación contextual. País que usa el estándar ISO-3166-1 Alpha-3.
region	string	Solo se admite para los socios de curación contextual. Es el código de región según la norma ISO-3166-2; es el código de estado de 2 letras si se trata de EE.UU.
metro	string	Solo se admite para los socios de curación contextual. Código de la metrópolis de Google que se encuentra en el archivo geo-table.csv.

SegmentResponse

Atributo	Tipo	Descripción
segment	Segment array	Es un descriptor para un segmento.

Segmentar

Atributo	Tipo	Descripción
segment_id	string	Es el ID del segmento. El ID debe coincidir con el curatorDataSegmentId que se encuentra en el nombre del segmento en el recurso curators.dataSegments de la API de Marketplace.