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 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.

SegmentRequest

Atributo Tipo Descripción
imp Array de impresiones Solo se admite para los socios de curación contextual. Representa las oportunidades de impresión que se ofrecen.
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 compatible 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 del 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.

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.
banner Banner Solo se admite para los socios de curación contextual. Este campo se completa si la impresión se ofrece como una oportunidad de anuncio de banner.
video Video Solo se admite para los socios de curación contextual. Este campo se completa si la impresión se ofrece como una oportunidad de anuncio de video.
ext ImpExt 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.
eids Array de EID 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.
uids Es un array de UID. 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.

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.
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.

SegmentResponse

Atributo Tipo Descripción
segment Es un array de Segment. 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.