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 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 de público 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.
Solo se admite para los socios de curación contextual. Es un descriptor del sitio web. El campo site se completa 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 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.
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.
Impr.
Atributo
Tipo
Descripción
id
string
Solo se admite para los socios de curació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.
Este campo se propaga con extensiones para el objeto Imp.
Banner
Atributo
Tipo
Descripción
w
int
Solo se admite para los socios de curación contextual. Ancho en píxeles independientes del dispositivo (DIP).
h
int
Solo se admite para los socios de curación contextual. Altura en píxeles independientes del dispositivo (DIP).
pos
int
Solo se admite para los socios de curació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 los socios de curación contextual. Ancho del reproductor de video en píxeles independientes del dispositivo (DIPS).
h
int
Solo se admite para los socios de curación contextual. Altura del reproductor de video en píxeles independientes del dispositivo (DIP).
pos
int
Solo se admite para los socios de curació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 los socios de curació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 unidad de anuncios en una página. Consulta este artículo.
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.
mobile
int
Solo se admite para los socios de curación contextual. Indica si el sitio se programó para optimizar el diseño cuando se visualiza en dispositivos móviles, donde 0 = no y 1 = sí.
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 tiene un código de propiedad web de ca-pub-123 tendría su ID establecido en pub-123.
Usuario
Atributo
Tipo
Descripción
id
string
Es el ID de usuario de Google.
buyeruid
string
Son los datos de coincidencia alojados que se subieron con el Servicio de correlación de cookies. De forma predeterminada, se especifica en codificación base64 segura para la Web sin relleno. Si lo deseas, puedes comunicarte con tu administrador de cuentas para configurar este campo de modo que se complete sin codificación.
consent
string
Es una cadena de consentimiento del Marco de trabajo de transparencia y consentimiento (MTC) v2 de IAB codificada en base64 y apta para la Web que se recupera de la plataforma de administración de consentimiento de IAB (CMP) 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.
Solo se admite para los socios de selección de público. 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 de selección de público. Es el proveedor de la fuente o la tecnología responsable del conjunto de datos incluidos. Se expresa como un dominio de nivel superior.
Solo se admite para los socios de selección de público. Es un array de objetos UID de la fuente determinada.
UID
Atributo
Tipo
Descripción
id
string
Solo se admite para los socios de selección de público. 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.
Solo se admite para los socios de curación contextual. Ubicación del dispositivo del usuario.
devicetype
int
Solo se admite para los socios de curación contextual. Es el tipo general de dispositivo. Para obtener más información sobre los posibles tipos de dispositivos, consulta List: Device Types en AdCOM 1.0.
os
string
Solo se admite para los socios de curación contextual. Sistema operativo del dispositivo (p.ej., "iOS").
make
string
Solo se admite para los socios de curación contextual. Marca del dispositivo (p.ej., "Apple").
ifa
string
ID de publicidad del dispositivo sin encriptar (sin codificación hash). En el protocolo de Curación en tiempo real de Google, suele ser un UUID de 36 caracteres, en el que los IDs de Android están en minúsculas y los IDFAs en mayúsculas. En el caso de los dispositivos Samsung, estos son valores alfanuméricos de 32 caracteres.
Ubicación Geográfica
Atributo
Tipo
Descripción
country
string
Solo se admite para los socios de curación contextual. País que utiliza 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. Es el código de metro de Google que se encuentra en el archivo geo-table.csv.
city
string
Solo se admite para los socios de curación contextual. Ciudad que usa el Código de las Naciones Unidas para 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-09-23 (UTC)"],[],[]]