Obtén información sobre las especificaciones de la Curación en tiempo real
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Google envía un
SegmentRequest
basado en las solicitudes de anuncios que coinciden con tu inventario segmentado a tu integración de selecció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 el
SegmentResponse.
La selección en tiempo real admite objetos SegmentRequest y SegmentResponse enviados en formato JSON.
Esta guía es una referencia para el protocolo de selección en tiempo real que puede ayudarte a compilar tu integración.
Solo se admite para socios de selección contextual. Es un descriptor del sitio web. El campo site se propaga si el contenido compatible con anuncios es un sitio web en lugar de una aplicación que no es un navegador.
Solo se admite para socios de selección contextual. Es un descriptor de la app. El campo app se propaga si el contenido compatible con anuncios es una aplicación que no es un navegador en lugar de un sitio web.
Solo se admite para socios de selecció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.
Impr.
Atributo
Tipo
Descripción
id
string
Solo se admite para socios de selección contextual. Es un identificador único para esta impresión en el contexto de la solicitud de segmento. El valor comienza en 1 y aumenta hasta n para n impresiones.
Solo se admite para socios de selección contextual. Es el ancho en píxeles independientes del dispositivo (DIPS).
h
int
Solo se admite para socios de selección contextual. Es la altura en píxeles independientes del dispositivo (DIPS).
pos
int
Solo se admite para socios de selección contextual. Es la posición del anuncio en la pantalla. Para obtener más información sobre las posibles posiciones de la posición, consulta Lista: Posiciones de la posición en AdCOM 1.0.
Video
Atributo
Tipo
Descripción
w
int
Solo se admite para socios de selección contextual. Es el ancho del reproductor de video en píxeles independientes del dispositivo (DIPS).
h
int
Solo se admite para socios de selección contextual. Es la altura del reproductor de video en píxeles independientes del dispositivo (DIPS).
pos
int
Solo se admite para socios de selección contextual. Es la posición del anuncio en la pantalla. Para obtener más información sobre las posibles posiciones de la posición, consulta Lista: Posiciones de la posición en AdCOM 1.0.
ImpExt
Atributo
Tipo
Descripción
gpid
string
Solo se admite para socios de selección contextual. Describe el ID de posición global. Es un ID persistente y distinto, especificado por el publicador, que es coherente en todas las rutas de suministro para cada bloque de anuncios de una página. Consulta este artículo.
Sitio
Atributo
Tipo
Descripción
page
string
Solo se admite para socios de selección contextual. Es la URL de la página que muestra la impresión.
mobile
int
Solo se admite para socios de selección contextual. Indica si el sitio se programó para optimizar el diseño cuando se ve en dispositivos móviles, donde 0 = no y 1 = sí.
Aplicaciones
Atributo
Tipo
Descripción
bundle
string
Solo se admite para socios de selecció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 paquete. En iOS, es un ID numérico.
Publicador
Atributo
Tipo
Descripción
id
string
Solo se admite para socios de selecció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 tiene un código de propiedad web de ca-pub-123 tendría 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 (TCF) v2 de IAB codificada en base64 segura para la Web que se recupera de la plataforma de administración de consentimiento de IAB (CMP) del publicador. El campo consent se propaga si el publicador se integró con una CMP para el TCF v2 y esa CMP indica que el GDPR se aplica a la solicitud de anuncio y proporciona una cadena de consentimiento válida. Consulta la Lista global de proveedores de IAB en vendor-list.consensu.org/v2/vendor-list.json para obtener detalles sobre los proveedores que aparecen en la cadena de consentimiento.
Solo se admite para socios de selección de indicadores seguros. Son instancias de ID extendidas. En la selección, el campo eids son datos que el publicador pone a disposición, como indicadores seguros.
EID
Atributo
Tipo
Descripción
source
string
Solo se admite para socios de selección de indicadores seguros. Es la fuente o el proveedor de tecnología responsable del conjunto de datos incluidos. Se expresa como un dominio de nivel superior.
Solo se admite para socios de selección contextual. Es la ubicación del dispositivo del usuario.
devicetype
int
Solo se admite para socios de selección contextual. Es el tipo general de dispositivo. Para obtener más información sobre los posibles tipos de dispositivos, consulta Lista: Tipos de dispositivos en AdCOM 1.0.
os
string
Solo se admite para socios de selección contextual. Es el sistema operativo del dispositivo (p.ej., "iOS").
make
string
Solo se admite para socios de selección contextual. Es la marca del dispositivo (p.ej., "Apple").
Ubicación geográfica
Atributo
Tipo
Descripción
country
string
Solo se admite para socios de selección contextual. Es el país que usa la norma ISO-3166-1 alfa-3.
region
string
Solo se admite para socios de selección contextual. Es el código de región que usa la norma ISO-3166-2; código de estado de 2 letras si es EE.UU.
metro
string
Solo se admite para socios de selección contextual. Es el código de área metropolitana de Google que se encuentra en el archivo geo-table.csv.
city
string
Solo se admite para socios de selección contextual. Es la ciudad que usa el Código de las Naciones Unidas para las ubicaciones de comercio y transporte.
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.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2026-03-31 (UTC)"],[],[]]
