Protocolo de ofertas en tiempo real de Authorized Buyers

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

En esta guía, se describe cada campo del protocolo de la versión 258 de las Ofertas en tiempo real de Authorized Buyers, junto con información y sugerencias de implementación adicionales.

Consulta también el archivo proto de RTB de Authorized Buyers en el que se basa esta guía.

Objeto BidRequest

Este es el mensaje que Google utiliza para solicitar ofertas. Una BidRequest incluye el espacio publicitario de una sola impresión.

En esta sección, se enumera la información que conocemos del usuario.

Información sobre la página web o la aplicación para dispositivos móviles donde se origina la impresión.
Atributo Obligatorio/opcional Tipo Detalles de la implementación
id required bytes ID de solicitud único generado por Google. Tiene 16 bytes de longitud.
ip columna bytes Los primeros 3 bytes de la dirección IP en orden de bytes de red para IPv4 o los primeros 6 bytes en IPv6. Ten en cuenta que la cantidad y la posición de los bytes incluidos en las direcciones IPv6 pueden cambiar más adelante.
user_data_treatment repeated Enum Cuando se establece user_data_treatment, los datos del usuario sobre las cookies o los ID se borran de la solicitud y no se envían en el texto destacado. Los campos afectados son los siguientes:
  • id_usuario_google
  • alojado_match_data
  • ID de publicidad para dispositivos móviles encriptados.
  • mobile.encrypted_hashed_idfa
  • session_id

TAG_FOR_CHILD_DIRECTED_TREATMENT = 0: La solicitud actual se debe tratar como dirigida a niños para los fines de la Ley de Protección de la Privacidad Infantil en Internet. Consulta este artículo para obtener más información.

google_user_id columna string Es el ID de Google del usuario, como se describe en la documentación del servicio de concordancia de cookies. Este campo es la versión sin relleno rellena con base64 de la Web de un ID de cookie binario. Consulta la sección Codificación en base 64 con URL y alfabeto seguro del nombre de archivo en RFC 3548 para obtener detalles de codificación. Este campo es el mismo que el ID de Google que muestra el servicio de concordancia de cookies.
cookie_version columna int32 El número de versión de google_user_id A veces, es posible que se cambie la asignación de una cookie a google_user_id. En este caso, la versión se incrementará.
cookie_age_seconds columna int32 El tiempo en segundos desde que se creó google_user_id. Este número puede ser cuantizado.
hosted_match_data columna bytes Haz coincidir los datos almacenados para este google_user_id a través del servicio de concordancia de cookies. Si existe una coincidencia, este campo contiene los datos decodificados que se pasaron al parámetro google_hm.
session_id columna string Representa una sesión de usuario de corta duración en dispositivos CTV/OTT, con una duración máxima de sesión de 6 horas. El uso de session_id nunca se permite en la personalización de anuncios. El campo session_id solo se puede usar para la limitación de frecuencia, las exclusiones de la competencia o para fines relacionados.
user_agent columna string Es una string que identifica el navegador y el tipo de dispositivo que envió la solicitud. Algunos datos pueden estar ocultos o reemplazados.
privacy_treatments columna Tratamientos de privacidad Tratamientos de privacidad. Algunos campos de la solicitud de oferta se pueden ocultar o engrosar para proteger la privacidad del usuario. Este mensaje proporciona información sobre los tratamientos de privacidad que se aplican a una oportunidad de anuncio que se ofrece mediante esta solicitud.
user_agent_data columna Usuario-agente Información del usuario-agente
publisher_country columna string Es el país de la dirección de facturación del publicador. Este puede ser diferente del país detectado del usuario en geo_criteria_id o el país de hosting del sitio web. Para obtener una lista completa de los códigos de país, consulta la documentación de la lista de códigos de países.
host_publisher_id columna string Es el ID del publicador host. Cuando se propaga, indica que el publicador host participó en el reparto de ingresos, y se puede usar el ID para autorizar el archivo ads.txt.
geo_criteria_id columna int32 Ubicación del usuario final. Usa un subconjunto de los códigos que se usan en la API de Google Ads. Consulta la tabla geo-table.csv en la documentación técnica para obtener una lista de ID. El campo geo_criteria_id reemplaza a los campos obsoletos de país, región, ciudad y área metropolitana.
geo columna Ubicación geográfica La ubicación geográfica aproximada del usuario. Toda la información de ubicación se deriva de la ubicación geográfica de IP. Los campos de latitud y longitud pueden ser una posición de referencia (por ejemplo, centroide) para la ubicación derivada de la ubicación geográfica de IP que también transportan los otros campos (por ejemplo, una ciudad). La precisión será el radio de un círculo con el área aproximada de esa ubicación. La ubicación y su precisión se verán fugiadas según sea necesario para proteger la privacidad del usuario.
postal_code
postal_code_prefix
columna string Se detectó un código postal del tipo adecuado para el país del usuario final (por ejemplo, el código postal si el país es “US”). El campo postal_code_prefix se establece cuando la exactitud es demasiado baja para implicar un código completo; de lo contrario, se establece el campo postal_code.
encrypted_hyperlocal_set columna bytes Indicador de segmentación hiperlocal cuando está disponible, encriptado como se describe en la guía Indicadores de destino hiperlocales de desencriptación.
hyperlocal_set columna HyperlocalSet Versión de encrypted_hyperlocal_set sin encriptar. Este campo solo se establece cuando se usa una conexión SSL.
timezone_offset columna int32 El horario del usuario desde GMT en minutos. Por ejemplo, GMT+10 es timezone_offset = 600.
user_list repeated Lista de usuarios
publisher_id columna string Corresponde al ID de editor, según lo define el sufijo del código del publicador del código de propiedad web. Por ejemplo, "pub-123" es el código del publicador del código de propiedad web "ca-pub-123" (ca- es el prefijo específico del producto de la propiedad web).
seller_network_id columna int32 Es el ID de la red del vendedor. Consulta el archivo sellers-network-ids.txt en la documentación técnica para obtener una lista de los ID. Solo se establece si el sitio no es anónimo y el publicador permite la orientación del sitio.
partner_id columna fijo64 Es el ID del socio que proporciona este inventario. Solo se establece cuando también se establece seller_network_id, y también está disponible más información de socios después del seller_network_id. El valor de partner_id no es significativo más allá de proporcionar un identificador estable.
url columna string La URL de la página con los parámetros eliminados. Esto siempre comienza con un protocolo (HTTP o HTTPS).
is_semi_transparent_request columna bool Indica que la solicitud usa una marca semitransparente, lo que significa que solo se proporcionará una versión truncada de la URL de la solicitud. Esta decisión la toma el editor. Consulta //support.google.com/admanager/answer/4584891.
detected_language repeated string Idiomas de usuario detectados, según el idioma de la página web, la configuración del navegador y otros indicadores. El orden es arbitrario. Los códigos tienen entre 2 y 5 caracteres y están documentados en la tabla de códigos de idioma.
detected_vertical repeated Vertical Nota: Los valores de este campo ahora están ocultos. Lista sin ordenar de las verticales de contenido detectado. Consulta el archivo publisher-verticals.txt en la documentación técnica para obtener una lista de los ID.
detected_content_label repeated int32 Nota: Los valores de este campo ahora están ocultos. Lista de etiquetas de contenido detectadas. Consulta el archivo content-labels.txt en la documentación técnica para obtener una lista de los ID.
google_query_id columna string Esto representa un ID único para la consulta general. En el caso de que haya varias leyendas para una consulta, todas las solicitudes de texto destacado para esa consulta contendrán el mismo google_query_id.
auction_type columna Enum Es el tipo de subasta que se ejecutará para esta consulta. Predeterminado = SECOND_PRICE.

UNKNOWN_AUCTION_TYPE = 0
FIRST_PRICE = 1
SECOND_PRICE = 2
FIXED_PRICE = 3

device columna Dispositivo
key_value repeated KeyValue
mobile columna Dispositivos móviles
video columna Video
publisher_settings_list_id columna fijo64 Es el ID de la lista de configuración del publicador que se aplica a esta página. Consulta la guía de configuración del editor de RTB para obtener más información.
publisher_type columna Enum Es el tipo de publicador del inventario en el que se mostrará el anuncio. Para una solicitud determinada, el inventario del editor puede ser de propiedad y administración (O&O), representado por el editor, o de estado desconocido. Predeterminado = UNKNOWN_PUBLISHER_TYPE.

UNKNOWN_PUBLISHER_TYPE = 0
PUBLISHER_OWNED_AND_OPERATED = 1
PUBLISHER_REPRESENTED = 2

page_visibility columna Enum Es el estado de visibilidad de la página web que contiene los espacios publicitarios. Consulta www.w3.org/TR/page-visibility/.

VISIBILITY_STATE_UNKNOWN = 0
VISIBILITY_STATE_VISIBLE = 1
: La página debe verse al menos de manera parcial. Por ejemplo, en la pestaña en primer plano de una ventana no minimizada.
VISIBILITY_STATE_HIDDEN = 2; La página no está visible para los usuarios. Por ejemplo, cuando la página está en una pestaña del navegador en segundo plano o en una ventana minimizada.

adslot repeated Espacio publicitario
bid_response_feedback repeated BidResponseFeedback
response_deadline_ms columna int32 Indica cuánto tiempo esperará Google una respuesta, en milisegundos, para esta solicitud de oferta en particular. Si no se establece, los ofertantes deben suponer que se usa el plazo límite predeterminado.
is_test columna bool Si es verdadero, esta es una solicitud de prueba. Los resultados no se mostrarán a los usuarios y no se le cobrará por una respuesta, incluso si gana la subasta. Debes realizar un procesamiento regular, ya que la solicitud se puede usar a fin de evaluar las latencias o realizar otras pruebas. Durante las pruebas iniciales con el tráfico de Google, cualquier respuesta que realices se filtrará de la subasta, ya sea que esta opción tenga un valor verdadero o falso.
is_ping columna bool Si es verdadero, esta solicitud está diseñada para medir la latencia de red. Muestra una BidResponse vacía solo con que compute_time_ms esté configurado lo más rápido posible sin ejecutar ninguna lógica de oferta.
is_predicted_to_be_ignored columna bool Si es verdadero, el modelo de texto destacado predijo que no ofertará en esta solicitud. Enviamos un porcentaje de muestreo de estas solicitudes para que podamos actualizar automáticamente el modelo cuando cambien los patrones de la oferta.
supply_chain columna Cadena de suministros

Objeto UserAgent

Información del usuario-agente Esto se propagará con información sobre el usuario-agente, que se extraerá del encabezado de usuario-agente o de los encabezados Seg-CH-UA.

Atributo Obligatorio/opcional Tipo Detalles de la implementación
browser columna Versión de marca Identifica el navegador.
platform columna Versión de marca Identifica la plataforma.
mobile columna bool Verdadero si el agente prefiere contenido "optimizado para dispositivos móviles". Consulta el campo BidRequest.device para obtener información específica acerca del dispositivo, que puede o no ser coherente con este campo (por ejemplo, el navegador de un teléfono celular puede solicitar "sitio de escritorio").
architecture columna string Arquitectura del dispositivo, por ejemplo, "x86" o "arm"
bitness columna string Valor de bits del dispositivo, por ejemplo, "64" para la arquitectura de 64 bits.
model columna string Modelo del dispositivo.

Objeto PrivacyTreatments

Tratamientos de privacidad. Algunos campos de la solicitud de oferta se pueden ocultar o engrosar para proteger la privacidad del usuario. Este mensaje proporciona información sobre tratamientos de privacidad que se aplican a una oportunidad de anuncio que se ofrece a través de esta solicitud.

Superior
Atributo Obligatorio/opcional Tipo Detalles de la implementación
non_personalized_ads_reason columna Enum de NonPersonalizedAdsReason

Especifica los motivos por los que no se deben personalizar los anuncios que se muestran en respuesta a esta solicitud.

UNKNOWN = 0; motivo desconocido.

PUBLISHER_DECLARED_NPA = 1; el publicador declaró que esta solicitud debería publicar anuncios no personalizados, independientemente de otros indicadores.

RESTRICT_DATA_PROCESSING= 2; el publicador solicitó el procesamiento de datos restringido para esta solicitud.

USER_OPT_OUT = 3; el usuario inhabilitó la personalización de anuncios.

allow_user_data_collection columna bool Verdadero si el publicador otorga el permiso para permitir que el ofertante use la información de visita del usuario del sitio del editor a fin de crear categorías de intereses que se puedan usar para publicar anuncios basados en esas categorías. Para usar estos datos a fin de crear categorías de intereses, el ofertante también debe ganar una impresión determinada. Consulta Acerca de los controles de recopilación de datos (Beta).

Objeto BrandVersion

Superior

Es una tupla de (marca, versión) para el navegador o la plataforma.

Atributo Obligatorio/opcional Tipo Detalles de la implementación
brand columna string Identificador de marca, por ejemplo, "Chrome" o "Windows"
version repeated string Versión, dividida en componentes si es necesario, por ejemplo, {"85", "1"} = v85.1.

Objeto de ubicación geográfica

La ubicación geográfica aproximada del usuario. Toda la información de ubicación se deriva de la ubicación geográfica de IP. Los campos de latitud y longitud pueden ser una posición de referencia (por ejemplo, centroide) para la ubicación derivada de la ubicación geográfica de IP que también llevan los otros campos (por ejemplo, una ciudad), y la precisión será el radio de un círculo con el área aproximada de esa ubicación. La ubicación y su precisión se difuminarán según sea necesario para proteger la privacidad del usuario.

Atributo Obligatorio/opcional Tipo Detalles de la implementación
lat columna double
lon columna double Longitud desde -180.0 hasta +180.0, donde el negativo es oeste.
country columna string País que utiliza ISO-3166-1 alfa-3.
region columna string Código de región con ISO-3166-2; código de estado de 2 letras si es EE.UU.
metro columna string Código de área metropolitana de Google, similar a los DMA de Nielsen, pero no exactamente.
city columna string Ciudad con el Código de las Naciones Unidas para las Ubicaciones Comerciales y de Transporte. Haz clic en un país de la lista de países para ver los códigos de ciudad.
zip columna string Código postal.
accuracy columna int32 Precisión de la ubicación estimada en metros.
utcoffset columna int32 Hora local como el número +/- de minutos de UTC.

Objeto HyperlocalSet

Atributo Obligatorio/opcional Tipo Detalles de la implementación
hyperlocal repeated Hiperlocal Actualmente, este campo contiene como máximo un polígono hiperlocal.
center_point columna Hiperlocal.Point El centro geométrico aproximado del área de geovallado. Se calcula exclusivamente según la forma geométrica del área de la geovalla y de ninguna manera indica la ubicación real del dispositivo móvil dentro de ella. Si se especifican varios polígonos hiperlocales arriba, center_point es el centro geométrico de todos los polígonos hiperlocales.

Objeto hiperlocal

Superior

Una ubicación de orientación hiperlocal cuando esté disponible.

Atributo Obligatorio/opcional Tipo Detalles de la implementación
corners repeated Punto El dispositivo móvil puede estar en cualquier punto del polígono de geovalla definido por una lista de esquinas. Actualmente, el polígono es siempre un paralelogramo con 4 esquinas.
Objeto de punto
Superior

Ubicación en la superficie de la Tierra.

Atributo Obligatorio/opcional Tipo Detalles de la implementación
latitude columna float Latitud de la ubicación.
longitude columna float Longitud de la ubicación.

Objeto UserList

Este campo no se propaga de forma predeterminada. En su lugar, recomendamos que los ofertantes almacenen y busquen los ID de las listas mediante google_user_id o hosted_match_data como claves.

Atributo Obligatorio/opcional Tipo Detalles de la implementación
id columna int64 El ID de la lista de usuarios.
age_seconds columna int32 Indica el tiempo en segundos desde que se agregó al usuario a la lista.

Objeto vertical

Una o más verticales detectadas para la página según lo determinado por Google.

Atributo Obligatorio/opcional Tipo Detalles de la implementación
id required int32 El ID vertical. Consulta el archivo publisher-verticals.txt en la documentación técnica para obtener una lista de los ID.
weight required float Peso para esta vertical, en el rango (0.0, 1.0). Las verticales más relevantes tienen pesos más altos.

Objeto del dispositivo

Información sobre el dispositivo.

Atributo Obligatorio/opcional Tipo Detalles de la implementación
device_type columna Enum Indica el tipo de dispositivo en el que se mostrará el anuncio. Predeterminado = UNKNOWN_DEVICE.

UNKNOWN_DEVICE = 0
HIGHEND_PHONE = 1
TABLET = 2
PERSONAL_COMPUTER = 3
: computadoras de escritorio o laptops
CONNECTED_TV = 4 - TV conectadas (smart TVs) y dispositivos conectados (como Roku y Apple TV).
GAME_CONSOLE = 5

platform columna string La plataforma del dispositivo. Ejemplos: Android, iPhone, Palm.
brand columna string La marca del dispositivo, por ejemplo, Nokia o Samsung
model columna string El modelo del dispositivo, por ejemplo, N70, Galaxy
os_version columna OsVersion La versión del SO (por ejemplo, 2 para Android 2.1 o 3.3 para iOS 3.3.1).
carrier_id columna int64 Identificador único del proveedor de telefonía celular si el dispositivo está conectado a Internet mediante un proveedor (en lugar de una conexión Wi-Fi). Para buscar el nombre y el país del operador de telefonía celular, consulta esta tabla de operadores de telefonía celular.
screen_width columna int32 Ancho en píxeles del ancho de la pantalla del dispositivo.
screen_height columna int32 La altura en píxeles de la pantalla del dispositivo.
screen_pixel_ratio_millis columna int32 Se usa para dispositivos de alta densidad (por ejemplo, pantallas iOS retina). Un valor no predeterminado indica que el tamaño nominal de la pantalla (con píxeles como la unidad) no describe la cantidad real de píxeles en la pantalla. Por ejemplo, el ancho y el alto nominales pueden ser de 320 x 640 para una pantalla que en realidad tiene 640 x 1280 píxeles, en cuyo caso screen_width=320, screen_height=640 y screen_pixel_ratio_millis=2000, ya que cada eje tiene el doble de píxeles que los que indicarían sus dimensiones.

Predeterminado = 0.

screen_orientation columna Enum Es la orientación de la pantalla del dispositivo cuando se envía la solicitud de anuncio. Predeterminado = UNKNOWN_ORIENTATION.

UNKNOWN_ORIENTATION = 0
PORTRAIT = 1
LANDSCAPE = 2

hardware_version columna string Modelo de un dispositivo Apple iOS, por ejemplo, "iphone 5s", "iphone 6+", "ipad 4"
limit_ad_tracking columna bool Indica si el usuario inhabilitó la publicidad basada en intereses o la personalización de anuncios, según lo determina una configuración a nivel del SO en iOS o Android.
app_tracking_authorization_status columna Enum Este campo solo se propaga en los dispositivos iOS. Indica el estado de autorización de seguimiento de apps. Este valor se obtiene de ATTrackingManager y se proporciona tal como está. Para obtener más información sobre el estado de autorización de seguimiento de apps de iOS, consulta este artículo.

NOT_DETERMINED = 0
RESTRICTED = 1
DENIED = 2
AUTHORIZED = 3

Objeto OsVersion

Superior

Contiene la versión del SO de la plataforma. Por ejemplo, en Android 2, mayor=2, minor=0. Para iPhone 3.3.1, main=3 y minor=3.

Atributo Obligatorio/opcional Tipo
major
minor
micro
columna int32

Objeto KeyValue

Atributos clave-valor adicionales. Actualmente inactivo.

Atributo Obligatorio/opcional Tipo
key
value
columna string

Objeto para dispositivos móviles

Información para consultas de anuncios que provienen de dispositivos móviles. Un dispositivo móvil puede ser un teléfono inteligente o una tablet. Esto está presente para las consultas de anuncios tanto en dispositivos móviles que navegan por la Web como en apps para dispositivos móviles.

Atributo Obligatorio/opcional Tipo Detalles de la implementación
is_app columna bool Si es verdadero, esta solicitud es de una aplicación para dispositivos móviles. Siempre será así cuando se configure app_id.
app_id columna string Es el identificador de la aplicación para dispositivos móviles cuando esta consulta de anuncios proviene de una aplicación para dispositivos móviles. Si la aplicación se descargó de la tienda de aplicaciones de iTunes de Apple, este es el ID de la tienda de aplicaciones; por ejemplo, 343200656. En dispositivos Android, es el nombre completo del paquete, por ejemplo, com.rovio.angrybirds. Para los dispositivos con Windows, es el ID de la app; por ejemplo, f15abcde-f6gh-47i0-j3k8-37l93817mn3o.
is_interstitial_request columna bool Si es verdadero, se trata de una solicitud de anuncio de pantalla completa para dispositivos móviles.
app_category_ids repeated int32 Nota: Los valores de este campo ahora están ocultos. Este campo contiene los ID de las categorías a las que pertenece la app para dispositivos móviles actual. Este campo estará vacío si is_app es falso. La asignación entre las apps para dispositivos móviles y las categorías se define en Google Play Store para las apps de Android o en iTunes Store de Apple para las apps de iOS. Para buscar el nombre de la categoría desde el ID de categoría, consulta la tabla de categorías de apps para dispositivos móviles.
is_mobile_web_optimized columna bool En el caso de una solicitud web móvil, este campo indica si la página está optimizada para navegadores móviles en teléfonos celulares de alta gama. Predeterminado = falso.
encrypted_advertising_id columna bytes Este campo se usa para los identificadores de publicidad de lo siguiente:
  1. Dispositivos iOS (esto se denomina identificador de publicidad o IDFA, como se describe en este artículo del Centro de ayuda)
  2. Dispositivos Android.
  3. dispositivos Roku.
  4. Dispositivos Microsoft Xbox.
  5. Dispositivos Amazon.

Cuando encrypted_advertising_id es un IDFA, el texto simple después de desencriptar el cifrado es el IDFA (UUID de 16 bytes) que muestra el [ASIdentifierManager advertisingIdentifier] de iOS. Para encrypted_hashed_idfa, el texto simple es el hash MD5 de 16 bytes del IDFA. Solo uno de los dos campos estará disponible, según la versión del SDK que realice la solicitud. Los SDK posteriores proporcionan valores sin hash.

encrypted_hashed_idfa columna bytes Consulta también la descripción de encrypted_advertising_id.
advertising_id columna bytes Versión de encrypted_advertising_id sin encriptar. Este campo solo se establece cuando se usa una conexión SSL. Este campo es un UUID de 16 bytes.
hashed_idfa columna bytes Versión de encrypted_hashed_idfa sin encriptar. Este campo solo se configura cuando se usa una conexión SSL. Este campo es un MD5 de 16 bytes.
app_name columna string Los nombres de las aplicaciones de Android son de Google Play Store. App Annie proporciona los nombres de las apps para iOS.
app_rating columna float Calificación promedio de los usuarios para la app. El rango de las calificaciones de los usuarios se encuentra entre 1.0 y 5.0. Actualmente, solo está disponible para apps en Google Play Store.
installed_sdk columna InstalledSdk Información e información sobre un SDK instalado en la app del publicador al que tiene acceso el ofertante, a menudo porque es el SDK del ofertante
skadn columna SKAdNetworkRequest. Información de SKAdNetwork del publicador para admitir la atribución de instalación de apps en iOS 14 y versiones posteriores La API de SKAdNetwork de Apple ayuda a los anunciantes a medir la instalación de apps basadas en anuncios mediante el envío de una notificación a la red de publicidad después de una instalación exitosa. Los editores deberán configurar redes de publicidad compatibles en la lista de propiedades de su app (Info.plist) para permitir que una instalación se atribuya a la impresión de anuncios. Para obtener más información, consulta este artículo.

InstalledSdk Objeto

Superior

Identificación e información sobre un SDK instalado en la app del publicador al que tiene acceso el ofertante, a menudo porque es el SDK del ofertante

Atributo Obligatorio/opcional Tipo Detalles de la implementación
id columna string Es el identificador del SDK instalado.
sdk_version columna Versión Es la versión del SDK instalado.
adapter_version columna Versión Es la versión del adaptador que se comunica con el SDK instalado.
Objeto de la versión
Superior

Es la versión semántica del SDK instalado y el adaptador que se comunica entre el SDK instalado y el SDK de Google.

Atributo Obligatorio/opcional Tipo Detalles de la implementación
major columna int32 Predeterminado = -1
minor columna int32 Predeterminado = -1
micro columna int32 Predeterminado = -1

Objeto SKAdNetworkRequest

Superior

Información de SKAdNetwork del publicador a fin de admitir la atribución de instalación de apps para iOS 14 y versiones posteriores La API de SKAdNetwork de Apple ayuda a los anunciantes a medir la instalación de apps impulsadas por anuncios. Para ello, envían una devolución a la red de publicidad después de una instalación exitosa. Los editores deberán configurar las redes de publicidad admitidas en la lista de propiedades de su app (Info.plist) para permitir que una instalación se atribuya a la impresión de anuncios. Para obtener más información, consulta este artículo.

Atributo Obligatorio/opcional Tipo Detalles de la implementación
version columna string Ya no está disponible. Se quitará en noviembre de 2022. En su lugar, usa BidRequest.mobile.skadn.versions.

Se admite la versión de SKAdNetwork. Depende de la versión del SO y de la versión del SDK.

versions repeated string Lista de todas las versiones de SKAdNetwork que admite la solicitud, según la versión del SO y la versión del SDK.
sourceapp columna string ID de la aplicación del publicador en la App Store de Apple.
skadnetids repeated string Entradas SKAdNetworkIdentifier en el archivo Info.plist de la app del publicador
supported_fidelity_types repeated Enum Lista de tipos de fidelidad admitidos, según la versión de la API de SKAdNetwork que admite el sistema operativo y el SDK, así como las propiedades del espacio publicitario.

VIEW_THROUGH_ADS = 0; atribución para instalaciones de aplicaciones dentro de las 24 horas posteriores a la visualización de un anuncio durante, al menos, 3 segundos. Compatible con la versión 2.2 de SKAdnetwork y versiones posteriores. Para obtener más información, consulta este artículo.
STOREKIT_RENDERED_ADS = 1; Atribución para las instalaciones de aplicaciones iniciadas desde la página de productos de la App Store procesada por StoreKit, impulsada por los clics en el anuncio. Compatible con todas las versiones de SKAdNetwork. Para obtener más información, consulta este artículo.

Objeto de video

Información sobre el video si se trata de una solicitud de anuncio en video.

Atributo Obligatorio/opcional Tipo Detalles de la implementación
placement columna Enum Describe dónde se reproducirá el anuncio de video. Predeterminado = UNKNOWN_PLACEMENT.

UNKNOWN_PLACEMENT = 0.
INSTREAM = 1 - In-stream significa que el anuncio se reproduce antes o después de otro contenido de video, o durante este. Es similar a un comercial de TV tradicional. El contenido de video que el usuario está mirando no se reproduce mientras se reproduce el anuncio.
INTERSTITIAL = 2: Intersticial significa que el anuncio de video se reproduce frente a contenido que no es de video (por ejemplo, un artículo de noticias o un videojuego). El anuncio cubre la totalidad o la mayor parte del espacio de la pantalla que ocupa el contenido, y el usuario no puede continuar con el contenido hasta que se haya omitido o finalizado el anuncio.
IN_FEED = 3: El formato de video in-feed es una creatividad de video que se muestra dentro de un feed de contenido, por lo general, en un feed de app social, una lista de elementos de contenido editorial, etc., a medida que el usuario se desplaza por el contenido. Se renderiza centrada y no al lado.
AUDIO = 4 - Audio es una solicitud de anuncio que es una transmisión de audio. Es diferente a INSTREAM anterior, ya que es exclusivo de las solicitudes de video.
IN_ARTICLE = 5: El formato de video in-article es una creatividad de video que se carga y se reproduce entre párrafos de contenido editorial como un reproductor de video independiente.

description_url columna string Es la URL de la página que el editor le proporciona a Google para describir el contenido del video, sin los parámetros eliminados.
is_embedded_offsite columna bool Si es verdadero, el video está incorporado en una página fuera del dominio del editor. Cuando se establece, description_url apunta a una descripción del video (como siempre lo hace) y el campo url en BidRequest es la página en la que está incorporado el video. Por ejemplo, una solicitud para un anuncio in-stream en un video de Vimeo compartido en Facebook tiene is_embedded_offsite configurado. El campo url corresponde a una página de Facebook y description_url apunta al video en Vimeo.
playback_method columna Enum Describe cómo se reproducirá el anuncio de video. Se determina que el método de reproducción es de reproducción automática, de reproducción por clic o de desplazamiento del mouse sobre el contenido en función de la mejor medición disponible. Esto incluye, por ejemplo, la última vez que el usuario interactuó con una página web. En el caso de la reproducción automática, los anuncios pueden comenzar a reproducirse con el sonido activado o desactivado. Algunos anuncios (por ejemplo, los anuncios in-feed) se silencian hasta que el usuario interactúa con el anuncio.

Como alternativa, si un anuncio normalmente se reproduce con el sonido activado, pero el dispositivo está silenciado, el valor se desactivará. En el caso de los dispositivos en los que no es posible determinar si el dispositivo está silenciado (por ejemplo, en las computadoras de escritorio), suponemos que el sonido está activado. Predeterminado = METHOD_UNKNOWN.

METHOD_UNKNOWN = 0
AUTO_PLAY_SOUND_ON = 1
AUTO_PLAY_SOUND_OFF = 2
CLICK_TO_PLAY = 3
MOUSE_OVER = 4
INITIATE_ON_ENTERING_VIEWPORT_SOUND_ON = 5
INITIATE_ON_ENTERING_VIEWPORT_SOUND_OFF = 6

is_clickable columna bool Indica si el inventario permite hacer clic en el anuncio de video para llevar al usuario al sitio de un anunciante. Algunas plataformas, especialmente las TVs conectadas, no admiten los clics en los anuncios de video. En este caso, el valor de este campo es falso.
videoad_start_delay columna int32 El tiempo en milisegundos desde el inicio del video en el que se mostrará el anuncio. 0 significa anuncio previo al video, -1 (o cualquier número entero negativo de 32 bits) significa anuncio final del video y 1 (o un número entero positivo de 32 bits) significa anuncio durante el video. El valor es válido solo si se establece este parámetro. Si no se establece, se desconoce la posición de la pantalla.
max_ad_duration columna int32 Es la duración máxima en milisegundos del anuncio que se debe mostrar. Si no se establece o tiene el valor <= 0, se permite cualquier duración.
min_ad_duration columna int32 Es la duración mínima en milisegundos del anuncio que se debe mostrar. Si no se configuró o tiene el valor <= 0, no hay una duración mínima.
max_ads_in_pod columna int32 Indica la cantidad máxima de anuncios en un grupo de anuncios de video. Un valor distinto de cero indica que el espacio publicitario actual es un grupo de anuncios de video que puede mostrar varios anuncios de video. La cantidad real de anuncios de video que se muestran puede ser inferior o igual a este valor, pero no puede superarlo.
video_ad_skippable columna Enum ¿El publicador permite, exige o bloquea anuncios de video que se pueden omitir? Predeterminado = ALLOW_SKIPPABLE.

ALLOW_SKIPPABLE = 0
REQUIRE_SKIPPABLE = 1
BLOCK_SKIPPABLE = 2

skippable_max_ad_duration columna int32 Es la duración máxima en milisegundos del anuncio que se debe mostrar, si este es un anuncio que se puede omitir (suele ser diferente de la duración máxima permitida para los anuncios que no se pueden omitir). Si no se establece o tiene el valor <= 0, se permite cualquier duración.
protocols repeated Enum Conjunto de protocolos de respuesta de oferta de video admitidos. Protocolos de video compatibles.

VAST_1_0 = 1
VAST_2_0 = 2
VAST_3_0 = 3
VAST_1_0_WRAPPER = 4
VAST_2_0_WRAPPER = 5
VAST_3_0_WRAPPER = 6
VAST_4_0 = 7
VAST_4_0_WRAPPER = 8
DAAST_1_0 = 9
DAAST_1_0_WRAPPER = 10

allowed_video_formats repeated Enum Los formatos de archivo de video que se permiten para esta solicitud. La respuesta debe admitir al menos una de ellas.

VIDEO_FLV = 0: se aceptan archivos de video Flash (FLV).
VIDEO_MP4 = 1
YT_HOSTED = 2
: anuncios de VAST válidos con, al menos, un archivo multimedia alojado en youtube.com.
VPAID_FLASH = 3;: VPAID Flash (SWF).
VPAID_JS = 4; - VPAID de JavaScript

companion_slot repeated Ranura complementaria Información sobre los espacios publicitarios complementarios que se pueden mostrar con el video Si bien este es un campo repetido, solo habrá un valor en la mayoría de los casos. Si no hay anuncios complementarios disponibles, este campo no se configurará.
end_cap_support columna Enum Compatibilidad con la tapa final Cuando está habilitado, el anuncio complementario se puede elegir para que se procese como un final (tarjeta de información) en el espacio de video una vez que termine de reproducirse el anuncio de video. Si se muestran varios anuncios complementarios, el SDK de IMA elige el que mejor coincida con el tamaño de la pantalla del dispositivo. Solo se admite el límite final en el inventario intersticial de video para dispositivos móviles. Desde agosto de 2015, no se admiten END_CAP_FORBIDDEN ni END_CAP_REQUIRED.

END_CAP_NOT_ENABLED = 0;: El anuncio complementario no se dibujará como un límite final.
END_CAP_OPTIONAL = 1; Se mostrará un límite final si la respuesta contiene un banner complementario apto, pero no es obligatorio.
END_CAP_FORBIDDEN = 2;: se filtra la respuesta con un anuncio complementario.
END_CAP_REQUIRED = 3;: Se filtra la respuesta sin anuncio complementario.

content_attributes columna ContentAttributes Atributos del video que está viendo el usuario, no el anuncio de video Estos campos se basan en la disponibilidad de los metadatos del video del publicador del video y es posible que no siempre se propaguen.
DEPRECATED_inventory_type columna Enum Es el tipo de inventario desde el que se envía la solicitud. Este campo es obsoleto, pero se completará hasta enero de 2017. Usa el campo de posición para determinar si el inventario es intersticial o in-stream. Usa Device.device_type para determinar si la solicitud proviene de un dispositivo móvil y Mobile.is_app para determinar si proviene de una app. WEB_VIDEO corresponde a INSTREAM ubicaciones de navegadores web. GAMES consta de posiciones INTERSTITIAL de apps y navegadores web. MOBILE_INTERSTITIAL es INTERSTITIAL de posiciones solo de apps. Este inventario también permite anuncios gráficos. Puedes saber si un espacio publicitario permite anuncios gráficos si adslot.excluded_attributes no contiene 21 (CreativeType: Html)

MOBILE_APP_VIDEO es la posición INSTREAM solo de las apps.

WEB_VIDEO = 0
GAMES = 1
MOBILE_INTERSTITIAL = 2
MOBILE_APP_VIDEO = 3

is_livestream columna bool Identifica si la solicitud de anuncio se publica desde una transmisión de video en vivo (0 = no está en vivo, 1 = es en vivo). Predeterminado = falso.

Objeto CompanionSlot

Superior

Información sobre los espacios publicitarios complementarios que se pueden mostrar con el video Si bien este es un campo repetido, solo habrá un valor en la mayoría de los casos. Si no hay anuncios complementarios disponibles, este campo no se configurará. No se muestra si el usuario omite el video. Consulta la guía de anuncios de video para obtener más información.

Atributo Obligatorio/opcional Tipo Detalles de la implementación
height repeated int32 Estos campos representan las alturas y los anchos disponibles en esta ranura. Siempre habrá los mismos campos de altura y ancho.
width repeated int32 Estos campos representan las alturas y los anchos disponibles en este espacio. Siempre habrá los mismos campos de altura y ancho.
creative_format repeated Enum Estos son los formatos de las creatividades que se permiten en este espacio publicitario complementario.

IMAGE_CREATIVE = 0
FLASH_CREATIVE = 1
HTML_CREATIVE = 2

Objeto ContentAttributes

Superior

Atributos del video que está viendo el usuario, no el anuncio de video

Estos campos se basan en la disponibilidad de los metadatos del video del publicador del video y es posible que no siempre se propaguen.

Atributo Obligatorio/opcional Tipo Detalles de la implementación
duration_seconds columna int32 Duración del video en segundos.

Objeto AdSlot

Información sobre los espacios publicitarios de la página.

Atributo Obligatorio/opcional Tipo Detalles de la implementación
id required int32 Un ID de ranura asignado de forma arbitraria que es único en una página determinada y que, por lo general, comienza a contar desde 1. Se usa para identificar qué espacio se debe ofertar en BidResponse.
ad_block_key columna uint64 Es un identificador estable para la combinación del publicador, el espacio publicitario y la página.
targetable_channel repeated string Conjunto de canales de los que forma parte este espacio publicitario. Un canal es un conjunto de espacios publicitarios de un sitio. Puedes orientarte a un canal (como "la sección de deportes" o "todos los banners principales") para tener un control más preciso sobre el lugar en el que se muestra tu anuncio. El editor proporciona los nombres de los canales.
width
height
repeated int32 En el caso de los anuncios intersticiales para dispositivos móviles (incluidos aquellos en los que los anuncios de video son aptos), el primer par de ancho y alto es el tamaño de la pantalla (este también es el tamaño del reproductor de video para los anuncios de video de VAST). Los pares posteriores representan tamaños de anuncios intersticiales recomendados que satisfacen las restricciones de tamaño del anuncio intersticial. Por ejemplo, no pueden ser más grandes que el tamaño de la pantalla, no más pequeños que el 50% del ancho y el 40% de la altura.
flexible_adslot_settings columna FlexibleAdSlotSettings (Configuración de espacios publicitarios flexibles) Si el espacio publicitario es flexible, contiene la configuración del tamaño del espacio.
excluded_attribute repeated int32 Los ID de atributo no permitidos para los anuncios que se pueden mostrar en este espacio publicitario. Consulta el archivo publisher-excludable-creative-attributes.txt en la documentación técnica para obtener una lista de los ID.
allowed_vendor_type repeated int32 Los tipos de proveedores permitidos. Consulta el archivo vendors.txt en la documentación técnica para obtener una lista de los ID. Este campo no se aplica a los acuerdos con anulaciones de bloqueos (consulta este artículo del Centro de ayuda).
consented_providers_settings columna Configuración deConsentedProviders Información sobre los proveedores para los que el publicador informó a Google que sus usuarios del EEE dieron su consentimiento para el uso de sus datos personales en la personalización de anuncios. Este campo solo se propagará cuando regs_gdpr sea verdadero.
regs_gdpr columna bool Authorized Buyers completa este campo solo según si la impresión se publicará para un usuario del EEE, según la información disponible para Google. No constituye orientación legal sobre el GDPR.
regs_lgpd columna bool Este campo se establecerá como verdadero cuando, según la información disponible para Google, esta impresión se publique para un usuario en Brasil. Consulta https://storage.googleapis.com/adx-rtb-dictionaries/lgpd-providers.csv para ver la lista de proveedores de tecnología publicitaria que pueden publicar solicitudes exigidas por la LGPD.

Consulta este artículo para obtener más información sobre la LGPD.

excluded_sensitive_category repeated int32 Las categorías de anuncios sensibles no permitidas. Consulta el archivo ad-sensitive-categories.txt en la documentación técnica para obtener una lista de los ID. Debes aplicar estas exclusiones si tienes la capacidad de clasificar los anuncios en las categorías que se enumeran. Este campo no se aplica a los acuerdos con anulaciones de bloqueo (este artículo del Centro de ayuda tiene más información).
allowed_restricted_category repeated int32 Las categorías de anuncios restringidas permitidas para las subastas privadas y abiertas Consulta el archivo ad-restricted-categories.txt en la documentación técnica para obtener una lista de los ID. Solo se aplican a las ofertas de subasta privada y abierta. Consulta el campo allowed_restricted_category_for_deals para ver los acuerdos preferidos o las garantías programáticas.
allowed_restricted_category_for_deals repeated int32 Se permiten las categorías de anuncios restringidas permitidas para acuerdos preferidos o garantías programáticas. El archivo ad-restricted-categories.txt en la documentación técnica tiene una lista de ID. Solo se aplican a acuerdos preferidos o garantías programáticas. Consulta el campo allowed_restricted_category para ver las subastas privadas y abiertas. En algunos casos, las categorías restringidas solo se permiten en acuerdos preferidos o en las garantías programáticas, por lo que en este campo se enumeran todas las categorías en allowed_restricted_category y, además, las categorías restringidas que solo se permiten para acuerdos preferidos o garantías programáticas.
allowed_languages repeated string Lista de los idiomas de creatividades que permite el publicador. El orden es arbitrario. Los códigos tienen 2 o 5 caracteres y están documentados en la tabla de códigos de idioma. Si no la estableces, se permitirán todos los idiomas.
excluded_product_category repeated int32 Las categorías de productos de anuncios no permitidas. Consulta el archivo ad-product-categories.txt en la documentación técnica para obtener una lista de los ID. Debes aplicar estas exclusiones si tienes la capacidad de clasificar anuncios en las categorías indicadas. Este campo no se aplica a los acuerdos con anulaciones de bloques (como en este artículo del Centro de ayuda).
excluded_creatives repeated ExcluidoCreatividad Creatividades que no están permitidas para la impresión Si envía una oferta con una de las creatividades de esta lista, se filtrará antes de la subasta. Comunícate con tu administrador de cuentas si deseas habilitar esta función.
only_deal_bids_accepted columna bool Indica si el espacio publicitario solo es apto para las ofertas de acuerdos. Se filtrarán las ofertas para la subasta abierta cuando este campo se configure como verdadero. Los ofertantes pueden ofertar en la subasta abierta o en los acuerdos cuando este campo se establece como falso.
matching_ad_data repeated MatchingAdData; Información sobre las opciones de configuración de la segmentación previa que coincidieron.
exchange_bidding columna Exchange Bidding Parámetros relacionados con las ofertas de Ad Exchange (intercambios de terceros que realizan ofertas en tiempo real en Google Ad Manager). Esto nunca se propaga en las llamadas a los ofertantes en tiempo real de Authorized Buyers.
open_bidding columna Open Bidding Parámetros enviados en todas las solicitudes de Open Bidding.
dfp_ad_unit_code columna string Es el código del bloque de anuncios de Ad Manager. Por el momento, esta opción solo está configurada para las solicitudes de Open Bidding.
slot_visibility columna Enum Información de visibilidad del horario disponible. Predeterminado = NO_DETECTION.

NO_DETECTION = 0
ABOVE_THE_FOLD = 1
BELOW_THE_FOLD = 2

viewability columna int32 Porcentaje de visibilidad del espacio publicitario Esta es una estimación de la probabilidad de que el usuario final pueda ver esta ranura en función de los datos históricos y del entorno. Se expresa como un porcentaje en el rango de [0, 100]. El valor predeterminado -1 indica que no se pudo estimar la visibilidad.
click_through_rate columna float La tasa de clics histórica de los anuncios que se publican en el espacio publicitario Esto se expresa como una fracción en el rango [0.0, 1.0]. El valor predeterminado de -1.0 indica que los datos del historial de la tasa de clics no están disponibles. Esta cifra no incluye datos agregados de Google Ads.
video_completion_rate columna float Es el porcentaje de respuesta histórico de los anuncios de video publicados en el espacio publicitario. Esto se expresa como una fracción en el rango [0.0, 1.0]. El valor predeterminado de -1.0 indica que los datos del historial de tasa de finalización no están disponibles. Este campo solo se aplica al inventario de video y no incluye datos agregados de Google Ads.
iframing_state columna Enum Estado del encuadre del espacio publicitario en la página web donde está presente. Predeterminado = UNKNOWN_IFRAME_STATE.

UNKNOWN_IFRAME_STATE = 0
NO_IFRAME = 1
SAME_DOMAIN_IFRAME = 2
CROSS_DOMAIN_IFRAME = 3

iframing_depth columna Enum Es la profundidad del marco flotante del espacio publicitario en la página web donde está presente. Actualmente, solo está establecido para las solicitudes de anuncios de video. Predeterminado = UNKNOWN_IFRAME_DEPTH.

UNKNOWN_IFRAME_DEPTH = 0
NOT_IN_IFRAME = 1
ONE_IFRAME = 2
MULTIPLE_IFRAME = 3

native_ad_template repeated NativeAdTemplate. Un anuncio nativo consta de partes que dibuja el publicador. Un editor puede admitir varias plantillas de anuncios nativos distintos. Si la solicitud también permite banners o videos, puedes responder con otros tipos de anuncios si configuras html_snippet o video_url. Si solo existen plantillas nativas, debes configurar el campo native_ad en cualquier respuesta que envíes.
native_placement_type columna Enum Describe la posición del espacio publicitario nativo con respecto al contexto circundante.

PLACEMENT_UNKNOWN = 0
PLACEMENT_IN_FEED = 1
: En el feed de contenido, por ejemplo, como un elemento dentro del feed orgánico, cuadrícula/ficha/carrusel.
PLACEMENT_ATOMIC_UNIT = 2: Por ejemplo, en la unidad atómica del contenido, en la página del artículo o en la página de una sola imagen.
PLACEMENT_OUTSIDE = 3: Fuera del contenido principal, por ejemplo, en la sección de anuncios en el riel derecho, como una posición tipo banner cerca del contenido, etc.
PLACEMENT_RECOMMENDATION = 4: Widget de recomendaciones, que suele presentarse debajo del contenido del artículo.

mediation_status columna Enum Indica si se determinó que la solicitud de anuncio proviene directamente del publicador. Predeterminado = UNKNOWN.

UNKNOWN = 0
DIRECT_REQUEST = 1

auto_refresh columna Actualización automática
sticky_settings columna Configuración permanente
non_browser_slot_source columna Enum Declaración del publicador que indica que este espacio publicitario puede publicarse en inventario que no sea del navegador, como en aplicaciones para computadoras de escritorio Predeterminado = UNDECLARED_SOURCE.

UNDECLARED_SOURCE = 0
DESKTOP_APP = 1

renderer columna Enum Define quién controla el entorno que realizó la solicitud de anuncio y que renderizará el anuncio. En las plataformas en las que el código escrito por Google controlará el anuncio, este campo se establece en GOOGLE. Cuando este campo es PUBLISHER, el publicador colocó su propio código en el dispositivo para controlar la reproducción del anuncio. No hay diferencias técnicas en la forma en que se manejan estas solicitudes. Puedes usar este campo para diferenciar los diferentes entornos por motivos no técnicos. Este campo solo se establece en las solicitudes que permiten anuncios de video de VAST.

UNKNOWN_RENDERER = 0
GOOGLE = 1
PUBLISHER = 2

amp_ad_request_type columna Enum Indica si esta solicitud es para una Accelerated Mobile Page (AMP). Las páginas HTML de AMP se cargan más rápido mediante la restricción de partes de HTML, CSS y JavaScript. Para obtener más información sobre cómo se renderizan los anuncios de AMP, consulta el archivo README de anuncios de AMP. Predeterminado = NON_AMP_PAGE.

UNKNOWN_AMP = 0 - Estado de AMP desconocido. La solicitud puede o no provenir de una página de AMP.
NON_AMP_PAGE = 1: No es una página de AMP. Podría ser HTML normal, video de VAST, etc.
AMP_PAGE_LATE_REQUEST = 2 - Solicitud tardía desde una página HTML de AMP. El anuncio se procesará con una pequeña demora, por lo que no tendrá un impacto negativo en el rendimiento de la página.

is_amp_page columna Enum Independientemente de si se trata de una página de AMP o no.

UNKNOWN_AMP_PAGE = 0: Se desconoce el estado de la página de AMP.
DIALECT_HTML = 1: Esta no es una página de AMP.
DIALECT_HTML_AMP = 2: Esta es una página de AMP.

amp_ad_requirement_type columna Enum Tipos de requisitos posibles para los anuncios de AMP

UNKNOWN_AMP_AD_REQUIREMENT_TYPE = 0: Se desconocen los requisitos de los anuncios de AMP.
AMP_AD_NOT_ALLOWED = 1 - No se permiten los anuncios de AMP.
AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED = 2: Se permiten los anuncios de AMP o los que no son de AMP. Los anuncios de AMP no se renderizan con anticipación.
AMP_AD_ALLOWED_AND_EARLY_RENDERED = 3 - Se permiten los anuncios de AMP o los que no son de AMP. Los anuncios de AMP se renderizan con anticipación.
AMP_AD_REQUIRED = 4 - Se requieren anuncios de AMP. Es posible que el publicador rechace los anuncios que no son de AMP.

is_rewarded columna bool Indica si el usuario recibió una recompensa por ver el anuncio. En el caso de los anuncios de video, las implementaciones típicas permiten que los usuarios lean un artículo de noticias adicional de forma gratuita, reciban una vida adicional en un juego o obtengan una sesión patrocinada de música sin anuncios. Por lo general, la recompensa se distribuye después de que se completa el anuncio de video.
allowed_ad_types repeated Enum Los posibles tipos de anuncio permitidos en la respuesta a la oferta. allowed_ad_types siempre contiene uno o más valores. Los espacios para anuncios intersticiales también pueden admitir anuncios de banner. Es posible que un espacio publicitario con ALLOWED_AD_TYPE_NATIVE admita o no videos nativos, independientemente de si se configuró ALLOWED_AD_TYPE_VIDEO. Del mismo modo, un espacio publicitario sin ALLOWED_AD_TYPE_NATIVE no admite videos nativos, independientemente de si se configuró ALLOWED_AD_TYPE_VIDEO.

ALLOWED_AD_TYPE_BANNER = 0
ALLOWED_AD_TYPE_NATIVE = 1
ALLOWED_AD_TYPE_VIDEO = 2

session_depth columna int32 Cantidad total de impresiones publicadas para este usuario (dentro de esta aplicación o sitio específico) en esta sesión de navegación, más 1. Una sesión finaliza después de 30 minutos de inactividad. El valor predeterminado de -1 indica que no se puede estimar la profundidad de la sesión.
publisher_settings_list_id repeated fijo64 Los ID de lista de configuración del publicador que se aplican a este espacio. Consulta la guía de configuración del editor de RTB para obtener más información.
secure_signals repeated Señalsegura Indicadores seguros que pasó el publicador
api repeated Enum Lista de marcos de trabajo de API admitidos para esta impresión. Si no se muestra una API de forma explícita, se supone que no es compatible. Puede ser uno de los siguientes:

UNKNOWN_FRAMEWORK = 0
MRAID_1 = 3
Definiciones de la interfaz de anuncios rich media para dispositivos móviles versión 1.0.
MRAID_2 = 5 Definiciones de la interfaz de anuncios rich media para dispositivos móviles versión 2.0.
MRAID_3 = 6 Definiciones de la interfaz de anuncios rich media para dispositivos móviles versión 3.0.
OMID_1 = 7Abrir la definición de la interfaz de medición versión 1.0

billable_event_rate_adjustment columna double En el caso de los anuncios dibujados solo con un SDK personalizado, el multiplicador se aplica a la oferta en la subasta. El ajuste refleja la probabilidad de que su oferta genere un evento facturable (por ejemplo, el anuncio se renderiza correctamente) si gana la subasta, en relación con la probabilidad de que otras ofertas generen un evento facturable si ganan la subasta. Este ajuste puede ser mayor o menor que 1. Esto afecta la clasificación final solo en la subasta; en particular, este multiplicador no afecta el pago. Predeterminado = 1.0.
omidpn columna string Es el identificador de la integración del SDK de OM. A fin de obtener más información, consulta el aviso de OpenRTB sobre el SDK de Open Measurement.
omidpv columna string Versión de la integración del SDK de OM. A fin de obtener más información, consulta el aviso de OpenRTB sobre el SDK de Open Measurement.
impression_expiration_seconds columna int32 Es el período esperado en el que una impresión puede producirse en segundos después de una oferta ganadora. Es posible que la impresión sea facturable solo si se publica dentro de este plazo. Para obtener más información sobre el vencimiento de las impresiones, consulta la siguiente guía: https://developers.google.com/authorized-buyers/rtb/billing-event-guide
frequency_capping_scope required Enum de FrequencyCappingScope

Función experimental; puede estar sujeta a cambios. Si desea obtener más información, consulte el artículo Cómo establecer limitaciones de frecuencia alojadas en Google para las ofertas de RTB. Describe el alcance de la aplicación de la limitación de frecuencia disponible para esta solicitud. Las limitaciones de frecuencia que se aplicarán a una oferta se pueden especificar en el campo BidResponse.ad.adslot.frequency_cap.

FREQUENCY_CAPPING_SCOPE_UNKNOWN = 0: Es el valor predeterminado que no se debe usar o que puede indicar que el alcance de la limitación de frecuencia no se pudo determinar de manera confiable.

FREQUENCY_CAPPING_SCOPE_NONE = 1; la limitación de frecuencia según las especificaciones de respuesta de la oferta no está disponible para esta solicitud. Antes de la subasta, se filtrará una oferta limitada de frecuencia para una solicitud de oferta sin disponibilidad de limitación de frecuencia.

FREQUENCY_CAPPING_SCOPE_BROWSER = 2; la aplicación de la limitación de frecuencia está disponible en varios sitios del mismo navegador.

FREQUENCY_CAPPING_SCOPE_DEVICE = 3; la limitación de la frecuencia se encuentra disponible en varios sitios del dispositivo y se excluyen los navegadores.

FREQUENCY_CAPPING_SCOPE_APP = 4; la aplicación de la limitación de frecuencia está disponible en una sola app.

FREQUENCY_CAPPING_SCOPE_SITE = 5; la aplicación de la limitación de frecuencia está disponible en un solo sitio.

Objeto FlexibleAdSlotSettings

Superior

La configuración sobre cómo se puede cambiar el tamaño del espacio.

Atributo Obligatorio/opcional Tipo
max_width columna int32
max_height columna int32
min_width columna int32
min_height columna int32

Objeto ConsentedProvidersSettings

Superior

Información sobre los proveedores para los que el publicador le informó a Google que sus usuarios del EEE dieron su consentimiento para el uso de sus datos personales en la personalización de anuncios Este campo solo se propagará cuando regs_gdpr sea verdadero.

Atributo Obligatorio/opcional Tipo Detalles de la implementación
consented_providers repeated int64 Es el conjunto de ID correspondientes a los proveedores de tecnología publicitaria (ATP) para los que el publicador especificó a Google que sus usuarios del EEE dieron su consentimiento legalmente válido: 1) el uso de cookies y otro almacenamiento local cuando la ley lo requiera; y 2) la recopilación, el uso compartido y el uso de datos personales para la personalización de anuncios por parte de un ATP de acuerdo con la Política de Consentimiento de Usuarios de la UE.

Si un publicador usa el Marco de trabajo de transparencia y consentimiento (MTC) v2 de IAB para administrar el consentimiento de los usuarios, se trata del conjunto de ATP que se dio su consentimiento mediante la string de consentimiento adicional (consulte este artículo para obtener detalles sobre el modo de consentimiento adicional de Google). Los ATP que se otorgaron mediante la string de consentimiento del MTC v2 se representan en el campo ConsentedProvidersSettings.tcf_consent_string.

Se publica una asignación del ID de ATP al nombre de ATP en providers.csv.

tcf_consent_string columna string La string de consentimiento de la versión 2 del Marco de trabajo de transparencia y consentimiento (MTC) con codificación IAB basada en la web6 que se recupera de la Plataforma de administración de consentimiento (CMP) del publicador. El MTC v2 de IAB define la estructura de la string. Este campo se propagará si el publicador se integró con una CMP para el MTC v2 y si la CMP indica que el GDPR se aplica a esta solicitud de anuncio y proporciona una string de consentimiento válida. Consulta este artículo para obtener información adicional sobre la integración de la versión 2 del MTC de Google.

Consulta la lista de proveedores globales de IAB en vendor-list.consensu.org/v2/vendor-list.json para obtener detalles sobre los proveedores que aparecen en la string de consentimiento.

Objeto CreativeCreative

Superior

Una creatividad que no está permitida para ofertar en esta impresión debido a las políticas de Google o el rechazo de creatividades, atributos de creatividades excluidos, categorías de productos o sensibles excluidas, tipos de proveedores permitidos, categorías restringidas o idiomas aplicables a la solicitud de oferta

Atributo Obligatorio/opcional Tipo Detalles de la implementación
buyer_creative_id columna string Es el ID de la creatividad del comprador de la creatividad no permitida.

Objeto MatchingAdData

Superior

Los ID de facturación correspondientes a las configuraciones de segmentación previa que coincidieron.

Atributo Obligatorio/opcional Tipo Detalles de la implementación
billing_id repeated int64 Los ID de facturación correspondientes a las configuraciones de segmentación previa que coincidieron.
minimum_cpm_micros columna int64 El valor de CPM mínimo que puede ofertar para que no se filtre antes de la subasta. Puede ser un mínimo global o un publicador establecido. El valor se expresa en micros de la moneda de tu cuenta.
direct_deal repeated Oferta directa
Objeto DirectDeal
Superior

Es la información sobre los acuerdos que coincidieron con este inventario.

Atributo Obligatorio/opcional Tipo Detalles de la implementación
direct_deal_id columna int64 Un ID que identifica el acuerdo.
fixed_cpm_micros columna int64 Debe ofertar, al menos, fixed_cpm_micros (en micros de la moneda de su cuenta) para participar en el acuerdo. Si ganas, se te cobrará fixed_cpm_micros. No se aplica cuando deal_type=PRIVATE_AUCTION. Para las subastas privadas, debe realizar una oferta de fixed_cpm_micros como mínimo. Realizar ofertas de CPM más altas que el fixed_cpm_micros aumentará sus probabilidades de ganar cuando deal_type=PRIVATE_AUCTION, pero no aumentará sus probabilidades de ganar en otros tipos de acuerdos.
deal_type columna Enum Es el tipo de acuerdo. Predeterminado = UNKNOWN_DEAL_TYPE.

UNKNOWN_DEAL_TYPE = 0
PREFERRED_DEAL = 1
PRIVATE_AUCTION = 2
PROGRAMMATIC_GUARANTEED = 3
: Para obtener más información, consulta el artículo Diferencias de RTB para los acuerdos de Programática garantizada.
AUCTION_PACKAGE = 4: Consulta el artículo del Centro de ayuda sobre paquetes de subasta para obtener más información.

publisher_blocks_overridden columna bool Indica si el publicador eximió este acuerdo de los bloqueos configurados. Esta configuración no anula las políticas de Authorized Buyers ni las decisiones del Centro de revisión de anuncios.
creative_source columna Enum Campo experimental, sujeto a cambios Una enumeración que declara el host de la creatividad, que solo se propagará para los acuerdos de Programática garantizada. Actualmente, este campo solo debe establecerse en CREATIVE_SOURCE_ADVERTISER (predeterminado).

CREATIVE_SOURCE_UNKNOWN = 0
CREATIVE_SOURCE_ADVERTISER = 1
: La creatividad se aloja en el anunciante, lo que significa que se requiere que el ofertante proporcione una creatividad en la respuesta a la oferta.
CREATIVE_SOURCE_PUBLISHER = 2: El publicador aloja la creatividad, lo que significa que el ofertante no necesita incluir una en la respuesta a la oferta. Para obtener más información sobre las creatividades alojadas por el publicador, consulte https://support.google.com/admanager/answer/9243220. Por el momento, esta función no es compatible con los ofertantes de RTB.

must_bid columna bool Este campo solo se aplica a los acuerdos de Programática garantizada. El comprador puede omitir la oferta en la impresión si este campo es falso. Cuando es verdadero, el comprador debe ofertar en este acuerdo para esta oportunidad de impresión.

Objeto ExchangeBidding

Superior

Parámetros relacionados con los intercambios que participan en Open Bidding (intercambios de terceros que realizan ofertas en tiempo real en Ad Manager). Esto nunca se propaga en las llamadas a los ofertantes en tiempo real de Authorized Buyers.

Atributo Obligatorio/opcional Tipo Detalles de la implementación
publisher_parameter repeated string Strings UTF8 que el publicador proporciona de forma opcional como parte de sus configuraciones de grupos de rendimiento coincidentes en la IU de Ad Manager. El formato es arbitrario y debe acordarlo el publicador y el ofertante del intercambio.
key_value repeated KeyValue Pares clave-valor repetidos que se enviarán del publicador al intercambio.

Objeto de OpenBidding

Superior

Parámetros enviados en todas las solicitudes de Open Bidding.

Atributo Obligatorio/opcional Tipo Detalles de la implementación
is_open_bidding columna bool Este campo se establece como verdadero si el publicador configuró un grupo de rendimiento o de mediación que se orienta a este espacio publicitario y a este ofertante. Visite nuestro Centro de ayuda para obtener información sobre Open Bidding y sus efectos en el proceso de oferta.

Objeto NativeAdTemplate

Superior

Un anuncio nativo consta de partes que dibuja el publicador. Un editor puede admitir varias plantillas de anuncios nativos distintos. Si la solicitud también permite banners o videos, puedes responder con otros tipos de anuncios si configuras html_snippet, video_url o video_vast_xml. Si solo existen plantillas nativas, debes configurar el campo native_ad en cualquier respuesta que envíes.

Atributo Obligatorio/opcional Tipo Detalles de la implementación
required_fields columna int64 Campo de bits que describe los campos que requiere el publicador. Se rechazarán las respuestas de oferta sin valor para estos campos. Las URL de seguimiento de clics y vistas siempre son implícitamente obligatorias.

enum Fields: Define los bits usados en required_fields y recommended_fields. Hay un bit para cada uno de los campos en BidResponse.Ad.NativeAd.

HEADLINE = 0x1
BODY = 0x2
CALL_TO_ACTION = 0x4
ADVERTISER = 0x8
IMAGE = 0x10
LOGO = 0x20
APP_ICON = 0x40
STAR_RATING = 0x80
PRICE = 0x100
STORE = 0x200
VIDEO = 0x400

recommended_fields columna int64 Campo de bits que describe los campos que recomienda el publicador. Se admiten todos los campos recomendados, pero no todos los campos recomendados son obligatorios.

enum Fields: Define los bits usados en required_fields y recommended_fields. Hay un bit para cada uno de los campos en BidResponse.Ad.NativeAd.

HEADLINE = 0x1
BODY = 0x2
CALL_TO_ACTION = 0x4
ADVERTISER = 0x8
IMAGE = 0x10
LOGO = 0x20
APP_ICON = 0x40
STAR_RATING = 0x80
PRICE = 0x100
STORE = 0x200
VIDEO = 0x400

headline_max_safe_length
body_max_safe_length
call_to_action_max_safe_length
advertiser_max_safe_length
price_max_safe_length
columna int32 max_safe_length indica la cantidad máxima de caracteres Unicode que se garantiza que se mostrarán sin truncamiento. El editor truncará las strings más largas durante el procesamiento.
image_width
image_height
logo_width
logo_height
app_icon_width
app_icon_height
columna int32 Ancho y altura para calcular la relación de aspecto requerida Puedes proporcionar una imagen más grande en la respuesta. Las imágenes que tienen relaciones de aspecto considerablemente diferentes a las implícitas por la altura y el ancho pueden filtrarse.
style_id columna int32 ID distintiva globalmente para el estilo, el HTML y el CSS específicos con los que se renderiza el anuncio nativo.
style_layout_type columna Enum Tipo de diseño de estilo para cada plantilla de anuncio nativo. Predeterminado = PIXEL.

PIXEL = 0
FLUID = 1

style_height
style_width
columna int32 Si el style_layout_type es PIXEL, el ancho y el alto de todo el anuncio nativo después de la renderización. Si style_layout_type es FLUID, es posible que style_height y style_width no se propaguen.

Actualizar automáticamente el objeto

Superior

Configuración de actualización automática.

Atributo Obligatorio/opcional Tipo Detalles de la implementación
refresh_settings repeated Configuración de actualización automática La configuración de actualización automática que el publicador tiene en este inventario. Esto se repite porque los editores pueden realizar varios tipos de actualizaciones automáticas en un solo inventario.
refresh_count columna int32 Indica la cantidad de veces que se actualizó este espacio publicitario desde la última carga de la página.
Objeto AutoRefreshSettings
Superior
Atributo Obligatorio/opcional Tipo Detalles de la implementación
refresh_type columna Enum Es el tipo de la actualización automática declarada. Predeterminado = UNKNOWN_AUTO_REFRESH_TYPE.

UNKNOWN_AUTO_REFRESH_TYPE = 0
USER_ACTION = 1
: Actualización activada por una acción iniciada por el usuario, como el desplazamiento.
EVENT = 2: Cambio de contenido basado en eventos. Por ejemplo, los anuncios se actualizan cuando la puntuación del partido de fútbol cambia en la página.
TIME = 3 - Actualización basada en el tiempo. Los anuncios se actualizan en un intervalo predefinido, incluso sin actividad del usuario.

min_refresh_interval_seconds columna int32 El intervalo de actualización mínimo. Esto se aplica a todos los tipos de actualización.

Objeto de StickySettings

Superior

Configuración del tipo de participación que declara el publicador

Atributo Obligatorio/opcional Tipo Detalles de la implementación
vertical_stickiness columna Enum Indica si el espacio publicitario es una barra lateral que se mantiene en la pantalla cuando el usuario se desplaza por ella. Predeterminado = UNKNOWN_STICKINESS.

UNKNOWN_STICKINESS = 0
IS_STICKY = 1

top_horizontal_stickiness columna Enum Indica si el espacio publicitario es horizontal y se fija en la parte superior de la pantalla cuando el usuario se desplaza. Predeterminado = UNKNOWN_STICKINESS.

UNKNOWN_STICKINESS = 0
IS_STICKY = 1

bottom_horizontal_stickiness columna Enum Indica si el espacio publicitario es horizontal y se fija en la parte inferior de la pantalla cuando el usuario se desplaza. Predeterminado = UNKNOWN_STICKINESS.

UNKNOWN_STICKINESS = 0
IS_STICKY = 1

Objeto SecureSignal

Superior

Indicadores seguros que pasó el publicador

Atributo Obligatorio/opcional Tipo Detalles de implementación
data columna string El indicador seguro.
source_js columna SourceJ Ya no está disponible. Se quitará en febrero de 2023. En su lugar, usa BidRequest.adslot.secure_signals.source.
source columna string La fuente de la señal. Es el identificador de la biblioteca o el SDK que generó estos datos.
Objeto SourceJs
Superior

Ya no está disponible. Se quitará en febrero de 2023. En su lugar, usa BidRequest.adslot.secure_signals.source.

Atributo Obligatorio/opcional Tipo Detalles de implementación
id columna string Es el identificador de la biblioteca de JavaScript que generó estos datos.

Objeto BidResponseFeedback

Comentarios sobre las ofertas enviadas en respuestas anteriores. Esto solo se establece si los comentarios en tiempo real están habilitados para tu ofertante. Comunícate con tu administrador de cuentas si deseas habilitar los comentarios en tiempo real.

Atributo Obligatorio/opcional Tipo Detalles de la implementación
request_id columna bytes El ID único de BidRequest.id
creative_index columna int32 El índice de BidResponse_Ad, en caso de que haya más de uno El índice comienza en cero para la primera creatividad.
creative_status_code columna int32 Es el código de estado del anuncio. Consulta creative-status-codes.txt en la documentación técnica para obtener una lista de los ID.
cpm_micros columna int64 Si la oferta ganó la subasta, este es el precio que se pagó en la moneda de tu cuenta. Si la oferta participó en la subasta, pero superó la oferta, este es el CPM que se debería haber superado para ganar. Esto no se establece si la oferta se filtró antes de la subasta, si el publicador o el ofertante ganador rechazó los comentarios sobre los precios o si su cuenta inhabilitó el uso compartido de los precios ganadores con otros ofertantes. En las subastas de primer precio, también se propaga BidRequest.bid_response_feedback[].minimum_bid_to_win.
minimum_bid_to_win columna int64 Es el valor mínimo de oferta necesario para haber ganado la subasta, en micros de su moneda. Si su oferta ganó la subasta, esta es la segunda oferta más alta que no se filtró (incluido el precio mínimo). Si su oferta no ganó la subasta, esta es la oferta del candidato ganador. Este campo solo se propagará si su oferta participó en una subasta de primer precio y no se propagará si su oferta se filtró antes de la subasta.
sampled_mediation_cpm_ahead_of_auction_winner columna int64 Cuando un publicador usa una subasta de RTB y una mediación de SDK basada en cascada en la misma consulta, el ganador de la subasta en tiempo real también debe competir en una cascada de mediación (que se ordena por precio) para ganar la impresión. Si la oferta participó en la subasta y no hubo cascada, el valor de este campo es 0. Si la oferta participó en la subasta y había una cascada, el valor de este campo es un precio que representa una oferta de muestra de las redes de mediación aptas que fueron superiores al ganador de la subasta, ponderado por la tasa de relleno esperada. Este campo se puede usar junto con minimum_bid_to_win para entrenar modelos de ofertas. El CPM se expresa en micros de la moneda de tu cuenta.
event_notification_token columna bytes Es el token de notificación de evento que se incluyó en la respuesta a la oferta.
buyer_creative_id columna string Es el ID de la creatividad del comprador que se incluyó en la respuesta a la oferta.

Objeto SupplyChain

SupplyChain. Para obtener más información, consulta este artículo.

Atributo Obligatorio/opcional Tipo Detalles de la implementación
complete columna bool Opción que indica si la cadena contiene todos los nodos involucrados en la transacción que conduce al propietario del sitio, la aplicación o algún otro medio del inventario.
nodes repeated SupplyChainNode Matriz de objetos SupplyChainNode en el orden de la cadena En una cadena de suministro completa, el primer nodo representa el sistema de publicidad inicial y el ID del vendedor involucrado en la transacción, por ejemplo, el propietario del sitio, la app o algún otro medio. En una cadena de suministro incompleta, representa el primer nodo conocido. El último nodo representa la entidad que envía esta solicitud de oferta.
version columna string Es la versión de la especificación de la cadena de suministro en uso, en el formato “major.minor”. Por ejemplo, para la versión 1.0 de la especificación, usa la string “1.0”.

Objeto SupplyChainNode

Superior
Atributo Obligatorio/opcional Tipo Detalles de la implementación
advertising_system_identifier columna string El nombre de dominio canónico del sistema SSP, Exchange, Wrapper de encabezado, etc. al que se conectan los ofertantes. Este puede ser el dominio operativo del sistema, si es diferente del dominio corporativo principal, para facilitar WHOIS y las búsquedas de IP inversas a fin de establecer la propiedad del sistema delegado. Debe ser el mismo que se usa para identificar a los vendedores en un archivo ads.txt, si existe uno.
seller_identifier columna string Es el identificador asociado con la cuenta del vendedor o distribuidor dentro del sistema de publicidad. Debe contener el mismo valor que se usa en las transacciones, por ejemplo, "publisher_id" en el protocolo de Google. Debe tener un máximo de 64 caracteres.
handles_payment columna bool Indica si este nodo participará en el flujo de pago del inventario. Cuando se configura en verdadero, el sistema de publicidad en el campo Advertising_system_identifier le paga al vendedor en el campo sellers_identifier, quien es responsable de pagar el nodo anterior en la cadena. Cuando se configura como falso, este nodo no está involucrado en el flujo de pago del inventario.

Objeto BidResponse

Este es el mensaje que muestra en respuesta a una BidRequest. Puedes especificar cero o más anuncios. Para cada anuncio, debes proporcionar un espacio publicitario en el que se pueda publicar el anuncio. El AdSlot.id identifica un espacio publicitario en la BidRequest. Si no quieres ofertar, envía una respuesta sin anuncios y con solo processing_time_ms establecido.

Atributo Obligatorio/opcional Tipo Detalles de la implementación
ad repeated Anuncio
debug_string columna string Si is_test se estableció en BidRequest, puedes mostrar la información de depuración como texto sin formato en este campo. No establezcas este campo en condiciones normales ni lo establezcas en valores superiores a 100 caracteres. Solo debes usar este campo cuando se te solicite, como parte de la solución de problemas específicos.
processing_time_ms columna int32 Configura esto en el tiempo de procesamiento en milisegundos desde que recibiste la solicitud hasta que se mostró la respuesta.
no_bid_reason columna int32 Es un motivo opcional especificado por el ofertante para no enviar una oferta. Este campo es equivalente a BidResponse.nbr en el protocolo OpenRTB y usa el mismo espacio de nombres de los códigos de motivo sin oferta. Consulta developers.google.com/authorized-buyers/rtb/downloads/no-bid-reasons.txt para ver el conjunto completo de códigos del motivo por el cual no hay oferta.

Objeto de anuncio

Atributo Obligatorio/opcional Tipo Detalles de la implementación
event_notification_token columna bytes Los ofertantes envían el token de notificación de evento a Authorized Buyers para solucionar los problemas. Authorized Buyers incluirá el token en los comentarios en tiempo real sobre la oferta. El contenido del token no se registrará en Authorized Buyers. Authorized Buyers ignorará cualquier token de más de 64 bytes.
buyer_creative_id columna string Es un identificador único que usted elige para la creatividad en esta respuesta. Siempre debe configurarse, debe tener un máximo de 64 bytes y debe ser una string UTF8 válida. Cada buyer_creative_id que uses siempre debe estar asociado a la misma creatividad. Este campo se usa para comunicar los estados de aprobación cuando se encuentran problemas. No especifiques el mismo ID para diferentes creatividades, o se rechazarán todas las creatividades si se encuentra un problema con una sola. No especifiques diferentes ID para la misma creatividad en diferentes respuestas o no se publicarán creatividades, ya que el estado de aprobación se asigna por ID.
html_snippet columna string El fragmento HTML que se colocará en la página web para mostrar el anuncio Usa BidResponse.Ad.AdSlot.billing_id para indicar a qué ID de facturación se atribuye este fragmento.
video_url columna string URL para recuperar un anuncio de video. La URL debe mostrar una respuesta XML que cumpla con el estándar VAST 2.0 o 3.0. Usa BidResponse.Ad.AdSlot.billing_id para indicar a qué ID de facturación se debe atribuir este anuncio. Solo se debe establecer uno de los siguientes valores: html_snippet, video_url, native_ad, sdk_rendered_ad, amp_ad_url o video_vast_xml. Establece este campo solo si la solicitud de oferta es para un anuncio en video (BidRequest.video está presente).
video_vast_xml columna string Es el documento VAST que se mostrará. Este documento debe cumplir con el estándar VAST 2.0 o 3.0. Use BidResponse.Ad.AdSlot.billing_id para indicar a qué ID de facturación se debe atribuir este anuncio. Solo establece este campo si BidRequest es para un anuncio en video y la respuesta es XML de VAST. Solo se debe establecer una de html_snippet, video_url, native_ad, sdk_rendered_ad, amp_ad_url o video_vast_xml.
amp_ad_url columna string Es la URL para obtener un anuncio HTML de AMP. Solo se debe establecer una de las siguientes opciones: html_snippet, video_url, native_ad, sdk_rendered_ad, amp_ad_url o video_vast_xml.
native_ad columna NativeAd Es el contenido de un anuncio nativo. Los anuncios nativos están compuestos por varias piezas fundamentales, que el editor renderiza.
click_through_url repeated string Es el conjunto de URL de destino del fragmento. Esto incluye las URL a las que se dirigirá el usuario si hace clic en el anuncio que se muestra y las que estén visibles en el anuncio procesado. No incluyas llamadas intermedias al servidor de anuncios que no estén relacionadas con la página de destino final. Estos datos se usan para filtrar con posterioridad las URL bloqueadas por el editor, entre otros aspectos. Una BidResponse que muestra un fragmento o un anuncio de video, pero declara que no se descartará click_through_url. En el caso de los anuncios nativos, solo se usa el primer valor como URL de clic, aunque todos los valores están sujetos a categorización y revisión. Solo configura este campo si html_snippet, video_url o native_ad están configurados. En el caso de los anuncios nativos, si no estableces NativeAd.click_link_url, se utilizará el primer valor de click_through_url para dirigir al usuario a la página de destino. En el caso de los anuncios nativos, recomendamos usar click_link_url como campo para establecer el destino al que irá el usuario. Este campo es obligatorio en el caso de las páginas de destino dinámicas.
vendor_type repeated int32 Todos los tipos de proveedores para los anuncios que se pueden mostrar de este fragmento Solo debes declarar los ID de los proveedores enumerados en el archivo sellers.txt en la documentación técnica. Verificaremos que los proveedores que declares estén en la lista allowed_vendor_type que se envió en BidRequest.
attribute repeated int32 Todos los atributos de los anuncios que se pueden mostrar en este fragmento Consulta buyer-declarable-creative-attributes.txt en la documentación técnica para obtener una lista de los ID. Verificaremos que ninguno de estos atributos esté en la lista excluded_attribute de BidRequest.
category repeated int32 Todas las categorías sensibles de los anuncios que se pueden mostrar en este fragmento Consulta ad-sensitive-categories.txt en la documentación técnica para obtener una lista de los ID. Verificaremos que ninguna de estas categorías esté en la lista excluded_sensitive_category de BidRequest.
restricted_category repeated int32 Todas las categorías restringidas de los anuncios que se pueden mostrar en este fragmento Consulta ad-restricted-categories.txt en la documentación técnica para obtener una lista de los ID. Verificaremos que estas categorías se incluyan en la lista allowed_restricted_category de BidRequest.
advertiser_name repeated string Todos los nombres de los anunciantes del anuncio.
bidder_name columna string Para los ofertantes de intercambio (intercambios de terceros que realizan ofertas en tiempo real en Ad Manager), el nombre del ofertante al que el intercambio llamó para proporcionar el anuncio. Este es un texto UTF8 arbitrario, pero debería ser suficiente para identificar al ofertante y debe establecerse de manera coherente en el mismo valor para el mismo ofertante.
width
height
columna int32 Es el ancho y la altura en píxeles del anuncio. Esta opción es opcional. Sin embargo, deben configurarse si bid BidRequest.AdSlot tiene más de un ancho y una altura, o si BidRequest.Mobile.is_interstitial_request es verdadero.
agency_id columna int64 La agencia asociada con este anuncio. Consulta el archivo agencies.txt en la documentación técnica para obtener una lista de los ID. Si este anuncio no tiene una agencia asociada, se debe usar el valor NONE (agency_id: 1) en lugar de dejar este campo sin configurar.
adslot repeated Espacio publicitario
impression_tracking_url repeated string Las URL a las que se debe llamar cuando se renderiza la impresión. Es compatible con todos los tipos de inventario y formatos, excepto los videos de VAST.
click_tracking_url repeated string Son las URL a las que se debe llamar cuando el usuario hace clic en el anuncio. Actualmente, solo se admiten para anuncios nativos y acuerdos de Programática garantizada con creatividades administradas por el publicador. En el caso administrado por el publicador, estas herramientas de seguimiento de clics se enviarán al servidor del ofertante al servidor. En todos los demás casos, estos se enviarán desde el dispositivo del usuario. Para obtener más información sobre las creatividades administradas por el publicador, consulte Creatividades administradas por el publicador.
ad_choices_destination_url columna string Vínculo a la página de preferencias de anuncios. Solo se admite para anuncios nativos. Si está presente, se agrega un ícono de AdChoices estándar a la creatividad nativa y se vincula a esta URL.
impression_tracking_resource repeated ImpressionTrackingResource. Recursos para invocar cuando se renderiza la impresión Solo se admite en formatos nativos y de banner, y solo secuencias de comandos de la lista blanca de manera explícita.
sdk_rendered_ad columna AnuncioDskRendered Un anuncio que dibujará un SDK conocido por el comprador. Esto solo se puede usar cuando BidRequest incluye un submensaje mobile.installed_sdk.
skadn columna SKAdNetworkResponse Información de SKAdNetwork del anunciante a fin de admitir la atribución de instalación de apps para iOS 14 y versiones posteriores La API de SKAdNetwork de Apple ayuda a los anunciantes a medir la instalación de apps basadas en anuncios mediante el envío de una notificación a la red de publicidad después de una instalación exitosa. Las redes publicitarias deberán enviar su ID de red y la información del anunciante firmado para permitir que se instale una instalación a la impresión de anuncios. Para obtener más información, consulta este artículo.
advertised_app_id columna string Es el ID de la aplicación promocionada para los anuncios de instalación de aplicación. En Android, debería ser un paquete o nombre de paquete, como com.foo.mygame. En iOS, es un ID numérico. Si se proporciona este campo, los usuarios verán la ficha de Play Store como una superposición después de hacer clic en el anuncio, sin salir de la app del publicador. Actualmente, esta opción solo está habilitada en anuncios intersticiales y recompensados de video.

Objeto NativeAd

Superior

Es el contenido de un anuncio nativo. Los anuncios nativos están compuestos por varias piezas fundamentales, que el editor renderiza. Solo se debe establecer una de las siguientes opciones: html_snippet, video_url, video_vast_xml o native_ad. Solo establece este campo si BidRequest es para un anuncio nativo (BidRequest.adslot.native está presente).

Atributo Obligatorio/opcional Tipo Detalles de la implementación
headline columna string Un título corto para el anuncio.
body columna string Una descripción larga del anuncio.
call_to_action columna string Una etiqueta para el botón en el que se debe hacer clic el usuario.
advertiser columna string Corresponde al nombre del anunciante o del patrocinador que se mostrará en la creatividad del anuncio.
image columna Image Una imagen grande
logo columna Image Una imagen más pequeña para el logotipo del anunciante.
app_icon columna Image Ícono de la aplicación para los anuncios de descarga de aplicaciones
video_url columna string URL para recuperar un anuncio de video. La URL debe mostrar una respuesta XML que cumpla con el estándar VAST 2.0. Solo establece este campo si BidRequest es para anuncios nativos y se solicita el campo de video.
star_rating columna double La calificación de la app en la tienda de aplicaciones. Debe encontrarse en el intervalo [0-5].
columna string La URL que cargará el navegador o SDK cuando el usuario haga clic en el anuncio. Puede ser la página de destino directamente o el primer paso de una cadena de redireccionamiento que conduce a ella. Para lograr la retrocompatibilidad, si no se configura, se usa el primer Ad.click_through_url. Para los anuncios nativos, recomendamos usar click_link_url en lugar de click_through_url.
click_tracking_url columna string Ya no está disponible. La URL que se utilizará para el seguimiento de clics. El ping del SDK hace clic en la URL de seguimiento en un subproceso en segundo plano. Cuando se resuelve la URL, se siguen los redireccionamientos HTTP 30x. El SDK ignora el contenido de la respuesta; esta URL no tiene efecto en la página de destino del usuario.
price columna string El precio de la aplicación promocionada, incluida la información sobre la moneda.
Objeto de imagen
Superior
Atributo Obligatorio/opcional Tipo Detalles de la implementación
url columna string
width
height
columna int32 El ancho y la altura de la imagen se especifican en píxeles. Puedes proporcionar una imagen más grande de la solicitada, siempre que se conserve la relación de aspecto.

Objeto AdSlot

Superior
Atributo Obligatorio/opcional Tipo Detalles de la implementación
id required int32 Es el ID de espacio publicitario de BidRequest en el que puede aparecer el anuncio.
max_cpm_micros required int64 El CPM máximo que desea que se le cobre si gana la subasta para este espacio publicitario, expresado en micros de la moneda especificada de currency o predeterminada. Por ejemplo, para ofertar un CPM de USD 1.29, establece max_cpm_micros = 1290000. Las ofertas ganadoras se redondean a unidades facturables. Por ejemplo, en USD, las ofertas se redondean al siguiente múltiplo de 10,000 micros (un centavo).
min_cpm_micros columna int64 El CPM mínimo que desea que se le cobre si gana la subasta para este espacio publicitario, expresado en micros de la moneda especificada de currency o predeterminada. Esto puede representar un segundo precio si eliges max_cpm_micros como la más alta de varias ofertas, o alguna forma de precio de reserva si deseas anular el precio de reserva establecido por el editor. La oferta debe ser igual o inferior a max_cpm_micros. De lo contrario, se ignorará. Este campo es opcional y no es necesario configurarlo. Este campo no se aplica a las solicitudes de oferta con el tipo de subasta configurado en FIRST_PRICE.
billing_id columna int64 ID de facturación a la que se debe atribuir esta impresión. El valor debe estar en el conjunto de ID de facturación para esta ranura que se enviaron en BidRequest.AdSlot.matching_ad_data.billing_id. Esto se debe configurar siempre si BidRequest tiene más de una BidRequest.AdSlot.matching_ad_data.billing_id.
deal_id columna int64 Es el ID del acuerdo en el que desea que participe esta oferta. No establezcas o establezcas “1” si un acuerdo está disponible, pero deseas ignorarlo y participar en la subasta abierta.
exchange_deal_id columna string Para los ofertantes de intercambio (intercambios de terceros que realizan ofertas en tiempo real en Ad Manager), el ID del acuerdo del espacio de nombres del intercambio que se asocia con esta oferta y se informa a los publicadores. No se establece si no hay un acuerdo asociado. Este es texto UTF8 arbitrario y debe tener un máximo de 64 bytes.
exchange_deal_type columna Enum Cuando se establece exchange_deal_id, el tipo de acuerdo. Esto se informa a los publicadores y afecta la manera en que se trata el acuerdo en la subasta.

OPEN_AUCTION = 0
PRIVATE_AUCTION = 1
PREFERRED_DEAL = 2
EXCHANGE_AUCTION_PACKAGE = 3

buyer_reporting_id columna string El comprador declaró un ID que se usará para desglosar las métricas de inversión y de tráfico no válido en los informes de transparencia del tráfico no válido en la Herramienta de consultas. Ten en cuenta que los ID con menos de 1,000 impresiones no se usarán para desglosar las métricas. Se ignorarán los ID de más de 64 bytes.
third_party_buyer_token columna string Es el token que se usa para identificar la información del comprador final si un intercambio como ofertante abierto es un intermediario. Se obtiene del comprador externo y se debe pasar a Google sin modificar en la respuesta a la oferta.
frequency_cap repeated Limitación de frecuencia Función experimental; puede estar sujeta a cambios. Consulta github.com/google/ads-privacy/tree/master/experiments/frequency-capping para obtener más información sobre el experimento en la limitación de frecuencia aplicada de manera forzosa.

Para habilitar la limitación de frecuencia, comuníquese con su administrador de cuentas.

Especifica la limitación de frecuencia que se aplicará a la oferta. Las impresiones para cada usuario se limitan al nivel especificado en la frecuencia. Una oferta no participará en la subasta si una impresión adicional para el usuario infringe cualquiera de los límites especificados. Se pueden especificar varias limitaciones de frecuencia para el mismo frequency_cap_id.

Se filtra una oferta antes de la subasta si la limitación de frecuencia presenta errores de formato. Las instancias en las que el límite tiene un formato incorrecto son los siguientes:

  • frecuencia_cap_id está vacía o es muy larga
  • max_mpressions o time_range no son positivos
  • Hay una gran cantidad de limitaciones de frecuencia para una sola oferta
  • No se especificó el atributo time_unit

    Ten en cuenta que, si una oferta posterior con el mismo frecuencia_límite_frecuencia utiliza una duración distinta (representada por intervalos de tiempo y unidad de tiempo), las impresiones registradas en la limitación de frecuencia anterior no se registrarán en el nuevo valor y viceversa.

  • currency columna string

    La moneda que utilizan los atributos max_cpm_micros y min_cpm_micros mediante los códigos alfa ISO-4217. Si se propaga este campo, se usará la moneda especificada para interpretar la oferta. De lo contrario, se usará la moneda de la oferta predeterminada, que se determina con la siguiente prioridad:

    1. La moneda a nivel del ofertante, si se establece en la configuración de la cuenta de RTB.
    2. Moneda en el nivel del comprador El comprador se determinará según el ID de facturación especificado en el campo billing_id de la respuesta a la oferta, si se propaga; de lo contrario, se basará en el único ID de facturación enviado en la solicitud de oferta.

    La moneda de una cuenta de comprador se configura en la creación de la cuenta y se puede verificar con un administrador técnico de cuentas.

    Objeto FrequencyCap
    Superior
    Atributo Obligatorio/opcional Tipo Detalles de la implementación
    frequency_cap_id columna string Es un ID que puede representar el caso práctico de un ofertante para la limitación de frecuencia. Por ejemplo, puede representar su campaña, anuncio, línea de pedido, etc. No debe contener información ni identificadores específicos del usuario.
    time_unit columna Enum Las unidades de tiempo para las que se pueden aplicar limitaciones de frecuencia.

    UNKNOWN_TIME_UNIT = 0
    MINUTE = 1
    DAY = 2
    WEEK = 3
    MONTH = 4
    INDEFINITE = 5
    : Cuando se usa INDEFINITE, se ignora el time_range. INDEFINITO significa que la limitación de frecuencia se aplicará durante un período prolongado (más de un mes), pero no necesariamente para siempre.

    time_range columna int32 Es la duración del período, en unidades especificadas por unidad de tiempo, para la que se aplica la limitación de frecuencia. Por ejemplo, si time_unit=WEEK y time_range=3, la limitación se aplica por un período de tres semanas. Si el time_unit=INDEFINITE, se ignorará.
    max_impressions columna int32 Es la cantidad máxima de impresiones que se pueden mostrar a un usuario para la frecuencia_cap_id proporcionada dentro del período de tiempo descrito por time_unit y time_range.

    Objeto ImpressionTrackingResource

    Superior
    Atributo Obligatorio/opcional Tipo Detalles de la implementación
    script_url columna string La URL de un recurso de JavaScript. Las URL no deben contener etiquetas de secuencias de comandos. Por ejemplo: "https://mycdn.com/tracker.js".
    context repeated Enum Se proporciona contexto adicional para la renderización.

    UNKNOWN_CONTEXT = 0
    OMID = 1

    verification_parameters columna string Los parámetros asociados con el recurso que se pasará al recurso cuando se cargue. El formato de los parámetros depende del proveedor de secuencias de comandos.
    vendor_key columna string Se usa para identificar de forma exclusiva al proveedor de la secuencia de comandos de verificación.

    Objeto SdkRenderedAd

    Superior
    Atributo Obligatorio/opcional Tipo Detalles de la implementación
    id columna string Es el identificador del SDK que renderizará el anuncio. Debe coincidir con un mobile.installed_sdk.id enviado en la solicitud de oferta correspondiente.
    rendering_data columna string Datos para pasar al SDK a fin de renderizar el anuncio Estos datos son opacos para el publicador y Google.
    declared_ad columna Objeto DelcaredAd Se declararon elementos del anuncio para admitir el análisis, la clasificación y la aplicación de creatividades de políticas de anuncios y bloqueos de publicadores para los anuncios que se renderizan con un SDK personalizado. Establece solo uno de los siguientes: html_snippet, video_url, video_vast_xml o native_ad.
    Objeto DeclaredAd

    Se declararon elementos del anuncio para admitir el análisis, la clasificación y la aplicación de creatividades de políticas de anuncios y bloqueos de publicadores para los anuncios que se renderizan con un SDK personalizado. Establece solo uno de los siguientes: html_snippet, video_url, video_vast_xml o native_ad.

    Superior

    Atributo Obligatorio/opcional Tipo Detalles de la implementación
    html_snippet columna string Es el fragmento de HTML que representa el anuncio procesado por el SDK.
    video_url columna string Es la URL del recurso de VAST que se usó en el anuncio procesado por el SDK.
    video_vast_xml columna string Es el documento de VAST que se usa para dibujar anuncios personalizados dibujados con SDK. Este documento debe cumplir con el estándar VAST 2.0 o 3.0.
    native_ad columna NativeAd Es el contenido de un anuncio nativo. Los anuncios nativos están compuestos por varias piezas fundamentales, que se generan a través del SDK del comprador.
    click_through_url columna string Son las páginas de destino finales del anuncio procesado por el SDK.

    Objeto SKAdNetworkResponse

    Superior
    Atributo Obligatorio/opcional Tipo Detalles de la implementación
    version columna string Es la versión de SKAdNetwork que admite el anunciante. También se usa para especificar cómo el anunciante generó la firma. Debe coincidir con la versión de BidRequest.mobile.skad.version.
    network columna string Es el identificador de la red de publicidad usado en la firma. Debe coincidir con uno de los elementos en BidRequest.mobile.skad.skadnetids.
    campaign columna int64 ID de campaña compatible con las especificaciones de Apple.
    itunesitem columna string ID de la aplicación del anunciante en la tienda de aplicaciones de Apple.
    fidelities repeated Fidelidad La API de SKAdNetwork a partir de la versión 2.2 admite varias opciones de presentación de anuncios especificadas por el parámetro fidelity-type de la firma de SKAdNetwork. Contiene los parámetros que se usan a fin de generar la firma que sería diferente para cada tipo de fidelidad compatible. Para obtener más información, consulta este artículo.
    nonce columna string Un UUID único con todas las letras en minúscula que genera el anunciante para usar en la generación de la firma. Nota: Este campo dejará de estar disponible y se reemplazará por el campo BidResponse.ad.skadn.fidelities.nonce para admitir varios tipos de fidelidad.
    sourceapp columna string ID de la aplicación del publicador en la tienda de aplicaciones de Apple. Debe coincidir con el ID de BidRequest.mobile.skad.sourceapp.
    timestamp columna int64 Tiempo Unix en milisegundos que se usó en el momento de la generación de la firma. Nota: Este campo dejará de estar disponible y se reemplazará por el campo BidResponse.ad.skadn.fidelities.timestamp para admitir varios tipos de fidelidad.
    signature columna string Firma de SKAdNetwork especificada por Apple. Nota: Este campo dejará de estar disponible y se reemplazará por el campo BidResponse.ad.skadn.fidelities.signature para admitir varios tipos de fidelidad.
    Objeto de fidelidad
    Superior

    La API de SKAdNetwork a partir de la versión 2.2 admite varias opciones de presentación de anuncios especificadas por el parámetro fidelity-type de la firma de SKAdNetwork. Contiene los parámetros utilizados a fin de generar la firma que sería diferente para cada tipo de fidelidad compatible. Para obtener más información, consulta este artículo.

    Atributo Obligatorio/opcional Tipo Detalles de la implementación
    fidelity_type columna Enum El tipo de fidelidad de la atribución a la que se debe hacer seguimiento. Predeterminado = STOREKIT_RENDERED_ADS.

    VIEW_THROUGH_ADS = 0; atribución para instalaciones de aplicaciones dentro de las 24 horas posteriores a la visualización de un anuncio durante, al menos, 3 segundos. Compatible con la versión 2.2 de SKAdnetwork y versiones posteriores. Para obtener más información, consulta este artículo.
    STOREKIT_RENDERED_ADS = 1; Atribución para las instalaciones de aplicaciones iniciadas desde la página de productos de la App Store procesada por StoreKit, impulsada por los clics en el anuncio. Compatible con todas las versiones de SKAdNetwork. Para obtener más información, consulta este artículo.

    nonce columna string Un UUID único con todas las letras en minúscula que genera el anunciante para usar en la generación de la firma.
    timestamp columna int64 Tiempo Unix en milisegundos que se usó en el momento de la generación de la firma.
    signature columna string Firma de SKAdNetwork especificada por Apple.