Atributos de vídeo de destino a través de parámetros de cadena de consulta
Si usa una solución de etiquetas para vídeo en streaming, la segmentación eficaz de la demanda requiere conocimientos y una implementación cuidadosa del intervalo de posibles parámetros de etiqueta.
Microsoft Advertising proporciona a los clientes una etiqueta fácil de usar para la demanda de vídeo de origen desde un entorno de cliente o servidor. Las solicitudes se cumplen a través de VAST XML estándar del sector, donde VAST puede contener VAST (solo archivos multimedia), VPAID1 (Flash) o VPAID2 (Flash o JavaScript). Las ptv etiquetas y vmap se pueden usar en el lado cliente y las ssptv etiquetas y ssvmap se pueden usar en el lado servidor. Estas etiquetas se usan en varios casos de uso, la demanda de suministro a diferentes contextos de dispositivo, como web de escritorio, web móvil, aplicación móvil (iOS y Android), OTT, IPTV, consolas de juegos, etc.
Cuando se usa para vídeo web de escritorio, se pueden usar cookies; Para las aplicaciones móviles, se pueden usar identificadores de dispositivo como IDFA y AAID. En el caso de OTT o IPTV IP, se pueden usar otros identificadores para la identificación de usuarios y dispositivos. Las ptv etiquetas y ssptv se pueden usar con protocolos OpenRTB (2.2 y posteriores).
En esta página se describen los parámetros de cadena de consulta disponibles y el destino. Cada atributo se puede agregar a una/ptv etiqueta o/ssptv mediante un parámetro de cadena de consulta. Estos atributos son distintos de los atributos creativos. Este es un ejemplo de un parámetro de cadena de consulta:
https://ib.adnxs.com/ptv?id=5523324&vmaxduration=30&vskippable=0&vplaybackmethod=5&vwidth=480&vcontext=1&vframeworks=1,2&schain=<blahblah>
Los siguientes atributos targetables de la colocación y el reproductor de vídeo son compatibles con las especificaciones de OpenRTB 2.2 y OpenRTB 2.3. (Para obtener más información, consulte Solicitudes de puja entrantes de SSP) La llamada al anuncio acepta los parámetros de cadena de consulta que se muestran a continuación. En la columna Controladores compatibles se indica qué tipos de etiqueta funcionan con cada parámetro.
Los parámetros siguientes son especialmente importantes para el éxito:
- Para el inventario web y web móvil, incluya siempre el parámetro en la
referrersolicitud de vídeo. Por ejemplo, incluya"referrer=abcd.com&"dóndeabcd.comes la dirección URL adecuada para el inventario. - La aplicación móvil y el inventario de CTV requieren el
appidparámetro en lugar dereferrer. Por ejemplo, incluya"appid=com.xandr"dóndecom.xandres el identificador de la aplicación para el inventario. - Para recibir la demanda de intercambio, debes pasar el
referrerparámetro oappiden todas las solicitudes de anuncios para el inventario de vídeo. Si no lo hace, limitará significativamente la demanda de su inventario e impedirá que se monetice de forma eficaz.
Nota:
Los campos id. de dispositivo no distinguen mayúsculas de minúsculas.
Atributos de destino básicos
| Parámetro | Tipo | ¿Necesario? | Controladores compatibles | Descripción |
|---|---|---|---|---|
gdpr |
booleano | Sí, en todas las llamadas GET de la UE |
ptv, ssptv, vmap, ssvmap |
Valor booleano que muestra el estado del RGPD de la llamada. - 0 = no = EL RGPD no se aplica- 1 = sí = se aplica el RGPD |
gdpr_consent |
string | Sí, en todas las llamadas GET de la UE |
ptv, ssptv, vmap, ssvmap |
Cadena que contiene datos de consentimiento del RGPD. Este campo es comparable al getConsentData descrito en IAB Europe's Consent String and Vendor List Format: Transparency & Consent Framework , así como advertisingconsent.eu. |
vmax_slot_duration |
Entero | Necesario para monetizar el inventario de CTV en solicitudes con varias ranuras en un pod. |
ptv, ssptv, vmap, ssvmap |
Duración máxima de vídeo por ranura en un pod de anuncio en segundos. Cualquier creatividad con una duración mayor que este valor se excluirá del pod. Nota: Este valor solo invalida la duración máxima de la ranura definida en la configuración de vídeo de selección de ubicación si la colocación y la solicitud (es decir, vmaxduration) no tienen un valor de duración máxima de pod especificado. |
vmax_num_ads |
Entero | No |
ptv, ssptv, vmap, ssvmap |
Número máximo de anuncios por pod de anuncios. Este es el número de solicitudes que se enviarán para un pod determinado. |
vmaxduration |
Entero | Necesario para monetizar el inventario de CTV. |
ptv, ssptv, vmap, ssvmap |
En el caso de las solicitudes únicas, esta es la duración máxima de la selección de ubicación de vídeo en segundos. Cualquier creatividad con una duración mayor que este valor se excluirá de la subasta. Para el inventario podded, esta es la longitud del pod completo. |
vskippable |
Entero | No |
ptv, ssptv |
Indica si se puede omitir la selección de ubicación. Posibles valores: - 1 : se puede omitir la ranura del anuncio.- 0 - la ranura del anuncio no se puede omitir |
vplaybackmethod |
Entero | No |
ptv, ssptv |
Designa el método de reproducción de la ubicación: - 1 - Reproducción automática, sonido activado- 2 - Reproducción automática, apagado del sonido- 3 - Hacer clic y reproducir- 4 - Pasar el mouse sobre- 5 - Reproducción automática, sonido desconocido |
vwidth |
Entero | Necesario para monetizar el inventario |
ptv, ssptv, vmap, ssvmap |
Ancho del reproductor (en píxeles). Aunque no es necesario, se recomienda este parámetro para garantizar que los licitadores de vídeo reciban ancho y alto en las solicitudes de puja. |
vheight |
Entero | Necesario para monetizar el inventario |
ptv, ssptv, vmap, ssvmap |
Altura del reproductor (en píxeles). Aunque no es necesario, se recomienda este parámetro para garantizar que los licitadores de vídeo reciban ancho y alto en las solicitudes de puja. |
vcontext |
Entero | Necesario para monetizar el inventario |
ptv, ssptv |
Posición de la ubicación del vídeo. Valores posibles: - 1 - Pre-roll lineal- 2 - Rollo medio lineal- 3 - Post-roll lineal- 4 - Outstream |
vframeworks |
Entero | Necesario para monetizar el inventario |
ptv, ssptv, vmap, ssvmap |
Marcos compatibles con el reproductor. Posibles valores: - 1 - VPAID 1.0- 2 - VPAID 2.0- 3 - MRAID-1- 4 - MRAID-2- 5 - ORMMA- 6 - OMID-1Nota: vframeworks admite valores enteros únicos, así como una lista de valores enteros separados por comas. Por ejemplo,vframeworks=1,2,3Otra posibilidad: vframeworks=1. |
referrer |
string | Sí, para el tráfico web |
ptv, ssptv, vmap, ssvmap |
Dirección URL donde se representará el anuncio. |
appid |
Entero | Sí, para el tráfico de CTV o aplicación móvil |
ptv, ssptv, vmap, ssvmap |
El identificador de agrupación de la aplicación móvil/CTV. Identificador de aplicación específico de la plataforma diseñado para ser único para la aplicación e independiente del intercambio. Esta cadena se usa para identificar una aplicación que se ejecuta en dispositivos móviles iOS de Android o Apple, así como en dispositivos de TV conectados, como Android TV, Apple TV, Roku, etc. Para obtener más detalles o ejemplos, consulta IAB Tech Lab OTT/CTV Store Assigned App Identification Guidelines (Directrices de identificación de aplicaciones asignadas por IAB Tech Lab OTT/CTV Store). - En Android (móvil & CTV), este es el nombre del paquete alfanumérico de la aplicación definido por el desarrollador en Google Play Store. Tiene el formato siguiente: com.example.helloworld, donde este identificador de lote aparece al final de la dirección URL de la página de detalles de la tienda de aplicaciones.- En iOS (móvil) y tvOS (CTV), este es el identificador numérico de la tienda iOS de la aplicación, generado automáticamente por el App Store de Apple. Tiene el formato siguiente: 123456789, donde este identificador de lote aparece al final de la dirección URL de la página de detalles de la tienda de aplicaciones.- En Roku (CTV), este es el identificador numérico generado automáticamente por Roku. Tiene el formato siguiente: 123456, donde este identificador de lote está disponible en las metaetiquetas HTML en el origen de la página de la Tienda de canales de Roku siguiendo las instrucciones de IABTL app-ads.txt.Muchos compradores establecen la segmentación y los informes de la campaña en función de appid. Si no se proporciona un appid correcto, el inventario no será atractivo para estos compradores. Por lo tanto, se recomienda encarecidamente pasar este campo cuando supply_type se establece en mobile_app. Tenga en cuenta que esto es lo que hacen nuestros SDK móviles cuando solicitan un anuncio. Para buscar el identificador de aplicación de una aplicación determinada, inspeccione la página de detalles de la aplicación, que puede encontrar mediante una búsqueda web. Por ejemplo, estas son las páginas de detalles de la aplicación "Tubi" (con paquetes appid disponibles según las descripciones anteriores): - Google Play (Android): https://play.google.com/store/apps/details?id=com.tubitv - Apple (iOS /tvOS): https://apps.apple.com/us/app/tubi-watch-movies-tv-shows/id886445756 - Roku: https://channelstore.roku.com/details/7c34d32446def64db7eb2cc359749fe5/tubi-free-movies-and-tv |
vv |
Entero | Necesario para monetizar el inventario de CTV. |
ptv, ssptv, vmap, ssvmap |
La versión de VAST compatible con el reproductor: - 2 - VAST 2.0- 3 - VAST 3.0- 4 - VAST 4.0- 5 - VAST 4.1- 6 - VAST 4.2. |
schain |
string | Necesario para las solicitudes en el inventario de reventa |
ptv, ssptv |
Los sistemas de publicidad deben admitir un parámetro en sus etiquetas de anuncio o direcciones URL VAST para aceptar una cadena de supplyChain serializada. Se recomienda que este parámetro sea schain. Para obtener más información sobre schain los parámetros de cadena y sus objetos JSON correspondientes, consulte: SupplyChain for Non-OpenRTB Requests1.0,1!exchange1.com,1234,1,bid-request-1,publisher,publisher.com!exchange2.com,abcd,1,bid-request2,intermediary,intermediary.com |
eids |
string | No |
ptv, ssptv, vmap, ssvmap |
Un publicador pasa un identificador extendido (eid) cuando se inicia una subasta. Cada eid tiene 3 campos separados por comas, donde el origen y el identificador son los campos obligatorios. - source: origen de la solución de identidad, que representa el origen del identificador. Por ejemplo, puede especificar liveramp.com o una cadena personalizada para las soluciones de identificador proporcionadas por el publicador. - id: el identificador de usuario proporcionado por la solución de identidad. - rti_partner: nombre de la solución de identidad de terceros. En el ejemplo siguiente se muestran dos identificadores extendidos, cada uno con sus respectivos campos. Para pasar varios identificadores, separe los identificadores con un carácter de canalización: - Id. extendido1: source=adserver.org,id=987654,rti_partner=TDID- Id. extendido2: source=criteo.com,id=1234567,rti_partner=(none)A continuación, los dos identificadores extendidos se pasan a un punto de conexión, de la siguiente manera: ...&eids=adserver.org,987654,TDID|criteo.com,1234567&... |
intro_bumper_min_duration |
Entero | No |
ptv, ssptv, vmap, ssvmap |
Duración mínima del anuncio, en segundos, si tiene previsto permitir Intro bumpers. Invalidaciones intro_bumper_min_durationvmin_ad_duration de la intro bumper ranura. Si intro_bumper_min_duration se pasan e invalidan vmin_ad_duration , intro_bumper_min_duration solo se aplicarán a intro bumper y vmin_ad_duration se seguirán aplicando al resto del pod.Nota: Si se pasa en intro min la solicitud, se activa intro bumpers en la solicitud de anuncio, incluso si la ubicación no se ha habilitado para intro bumpers. Consulte el paso 14c en Configuración de una ubicación para In-Stream vídeo. |
intro_bumper_max_duration |
Entero | No |
ptv, ssptv, vmap, ssvmap |
Duración máxima del anuncio, en segundos, si tiene previsto permitir Intro bumpers. Nota: Si se pasa en intro max la solicitud, se activa intro bumpers en la solicitud de anuncio, incluso si la ubicación no se ha habilitado para intro bumpers. Consulte el paso 14c en Configuración de una ubicación para In-Stream vídeo. |
outro_bumper_min_duration |
Entero | No |
ptv, ssptv, vmap, ssvmap |
Duración mínima del anuncio, en segundos, si tiene previsto permitir Outro bumpers. Invalidaciones outro_bumper_min_durationvmin_ad_duration de la outro bumper ranura. Si outro_bumper_min_duration se pasan e invalidan vmin_ad_duration , outro_bumper_min_duration el solo se aplicará a outro bumper y vmin_ad_duration se aplicará al resto del pod.Nota: Si se pasa en outro min la solicitud, se activa outro bumpers en la solicitud de anuncio, incluso si la ubicación no se ha habilitado para outro bumpers. Consulte el paso 14c en Configuración de una ubicación para In-Stream vídeo. |
outro_bumper_max_duration |
Entero | No |
ptv, ssptv, vmap, ssvmap |
Duración máxima del anuncio, en segundos, si tiene previsto permitir outro bumpers. Nota: Si se pasa en outro max la solicitud, se activa outro bumpers en la solicitud de anuncio, incluso si la ubicación no se ha habilitado para outro bumpers. Consulte el paso 14c en Configuración de una ubicación para In-Stream vídeo. |
Otras configuraciones
| Parámetro | Tipo | ¿Necesario? | Controladores compatibles | Descripción |
|---|---|---|---|---|
id |
Entero | Yes |
ptv, ssptv, vmap, ssvmap |
Identificador único de la ubicación en la que se mostrará el anuncio. Si prefiere no pasar el identificador de ubicación sin procesar, puede pasar una combinación de member parámetros y inv_code . Para obtener más información, consulte la documentación de esos parámetros. |
member |
Entero | No |
ptv, ssptv, vmap, ssvmap |
(Opcional) El identificador de miembro del miembro en el que se colocará el anuncio. En lugar de pasar el identificador de ubicación, puede pasar una combinación de este campo e inv_code identificar de forma única una ubicación específica. |
carrier |
string | No |
ptv, ssptv, vmap, ssvmap |
Nombre del operador de telefonía móvil. Esto es opcional porque nuestro sistema normalmente puede deducir el operador de la dirección IP del dispositivo. Por ejemplo: AT&T - US. Para obtener más información sobre los valores permitidos para este campo, vea Servicio de operador. |
connection_type |
string | No |
ptv, ssptv, vmap, ssvmap |
Tipo de red que usa el dispositivo. Los valores permitidos son "wifi" o "wan". |
content_len |
Entero | Se recomienda monetizar el inventario de CTV. |
ptv, ssptv, vmap, ssvmap |
Duración del contenido en segundos. |
content_livestream |
Entero | Se recomienda monetizar el inventario de CTV. |
ptv, ssptv, vmap, ssvmap |
Si el contenido está en directo o en vídeo a petición (VOD). 0: VOD, 1: Live. |
content_genre |
string | Se recomienda monetizar el inventario de CTV. |
ptv, ssptv, vmap, ssvmap |
El género que mejor describe el contenido. |
content_program_type |
string | No |
ptv, ssptv, vmap, ssvmap |
Tipo de programa (por ejemplo: película, evento, episodio, etc.). |
content_contentrating |
string | Se recomienda monetizar el inventario de CTV. |
ptv, ssptv, vmap, ssvmap |
Clasificación de contenido (por ejemplo: PG-13). |
content_album |
string | No |
ptv, ssptv, vmap, ssvmap |
Álbum al que pertenece el contenido; normalmente para el audio. |
content_artist |
string | No |
ptv, ssptv, vmap, ssvmap |
Artista acreditado con el contenido. |
content_cat |
matriz de cadena | Se recomienda monetizar el inventario de CTV. |
ptv, ssptv, vmap, ssvmap |
Matriz de categorías de contenido de IAB que describen el productor de contenido. Consulte la lista 5.1. |
content_context |
Entero | Se recomienda monetizar el inventario de CTV. |
ptv, ssptv, vmap, ssvmap |
Tipo de contenido (juego, vídeo, texto, etc.). |
content_data_id |
string | No |
ptv, ssptv, vmap, ssvmap |
Identificador específico de Exchange para el proveedor de datos. |
content_data_name |
string | No |
ptv, ssptv, vmap, ssvmap |
Nombre específico de Exchange para el proveedor de datos. |
content_data_segment |
matriz de objetos | No |
ptv, ssptv, vmap, ssvmap |
Matriz de objetos Segment que contienen los valores de datos reales. |
content_embeddable |
Entero | No |
ptv, ssptv, vmap, ssvmap |
Indicador de si el contenido se puede insertar o no (ejemplo: un reproductor de vídeo insertable), donde 0 = no, 1 = sí. |
content_episode |
Entero | Se recomienda monetizar el inventario de CTV. |
ptv, ssptv, vmap, ssvmap |
Número de episodio. |
content_isrc |
string | No |
ptv, ssptv, vmap, ssvmap |
Código de grabación estándar internacional conforme a la norma ISO-3901. |
content_keywords |
string | No |
ptv, ssptv, vmap, ssvmap |
Lista separada por comas de palabras clave que describen el contenido. |
content_prodq |
Entero | Se recomienda monetizar el inventario de CTV. |
ptv, ssptv, vmap, ssvmap |
Calidad de producción. |
content_producer_id |
string | No |
ptv, ssptv, vmap, ssvmap |
Identificador de productor o originador de contenido. Útil si el contenido está sindicado y se puede publicar en un sitio mediante etiquetas de inserción. |
content_producer_cat |
matriz de cadena | No |
ptv, ssptv, vmap, ssvmap |
Matriz de categorías de contenido de IAB que describen el productor de contenido. Consulte la lista 5.1. |
content_producer_name |
string | No |
ptv, ssptv, vmap, ssvmap |
Nombre de productor o originador de contenido (por ejemplo, "Warner Bros"). |
content_producer_domain |
string | No |
ptv, ssptv, vmap, ssvmap |
Dominio de nivel superior del productor de contenido (ejemplo: "producer.com"). |
content_qagmediarating |
Entero | No |
ptv, ssptv, vmap, ssvmap |
Clasificación multimedia según las directrices de IQG. Consulte la lista 5.19. |
content_season |
string | Se recomienda monetizar el inventario de CTV. |
ptv, ssptv, vmap, ssvmap |
Temporada de contenido (ejemplo: "Temporada 3"). |
content_series |
string | Se recomienda monetizar el inventario de CTV. |
ptv, ssptv, vmap, ssvmap |
Serie de contenido. Ejemplos de vídeo: "The Office" (televisión), "Star Wars" (película) o "Arby 'N' The Chief" (hecho para web). Ejemplo que no es de vídeo: "Ecocéntrico" (blog de Time Magazine). |
content_sourcerelationship |
Entero | No |
ptv, ssptv, vmap, ssvmap |
0 = indirecto, 1 = directo. |
content_title |
string | Se recomienda monetizar el inventario de CTV. |
ptv, ssptv, vmap, ssvmap |
Título del contenido. Ejemplos de vídeo: "Search Committee" (televisión), "A New Hope" (película) o "Endgame" (hecho para web). Ejemplo que no es de vídeo: "Por qué un glaciar antártico se está derritiendo tan rápidamente" (artículo de la revista Time). |
content_url |
string | No |
ptv, ssptv, vmap, ssvmap |
Dirección URL del contenido, para contextualización o revisión en el lado de compra. |
content_userrating |
string | No |
ptv, ssptv, vmap, ssvmap |
Clasificación del contenido por parte del usuario (ejemplo: Número de estrellas, me gusta, etc.). |
content_network |
string | Se recomienda monetizar el inventario de CTV. |
ptv, ssptv, vmap, ssvmap |
La empresa primaria de nivel superior o, si procede, una submarca que posee varios canales similares a tv, marcas de contenido d2c o propiedades digitales en las que se está viendo el contenido. |
content_language |
string | No |
ptv, ssptv, vmap, ssvmap |
Idioma del contenido del vídeo. Especifique el idioma mediante el código ISO-639-1-alpha-2 de dos letras. |
channel_name |
string | Se recomienda monetizar el inventario de CTV. |
ptv, ssptv |
Nombre del canal en el que se emite el contenido. |
airtime |
string | No |
ptv, ssptv |
La hora del aire original. Solo se aplica al contenido con desplazamiento de tiempo. |
content_id |
string | No |
ptv, ssptv, vmap, ssvmap |
Identificador de contenido alfanumérico único. |
devmake |
string | No |
ptv, ssptv, vmap, ssvmap |
El fabricante del dispositivo que solicita el anuncio. Normalmente, este valor se analiza a partir del parámetro de cadena ua (para implementaciones del lado servidor) o se incluye automáticamente en los encabezados de solicitud (para las integraciones del lado cliente). De lo contrario, puede usar este parámetro para pasar la información de la cadena de consulta directamente. Por ejemplo: da-4G Systems. Para obtener más información sobre los valores permitidos para este campo, vea los valores de nombre del servicio Device Make y prefijarlos con "da-". |
devtype |
string | No |
ptv, ssptv, vmap, ssvmap |
Tipo del dispositivo que solicita el anuncio. Normalmente, este valor se analiza a partir del parámetro de cadena ua (para implementaciones del lado servidor) o se incluye automáticamente en los encabezados de solicitud (para las integraciones del lado cliente). De lo contrario, puede usar este parámetro para pasar la información de la cadena de consulta directamente. Los valores permitidos son , , , , , da-Media Playerda-Set Top Box. da-TVda-Game Consoleda-Mobile Phoneda-Tablet Para obtener más información sobre cómo se asignan los valores de este campo a la creación de informes o de destino, consulte la sección Destinos de tipo de dispositivo del servicio de perfil. |
devmodel |
string | No |
ptv, ssptv, vmap, ssvmap |
Nombre o número específico del dispositivo que solicita el anuncio. Normalmente, este valor se analiza a partir del parámetro de cadena ua (para implementaciones del lado servidor) o se incluye automáticamente en los encabezados de solicitud (para las integraciones del lado cliente). De lo contrario, puede usar este parámetro para pasar la información de la cadena de consulta directamente. Por ejemplo: da-3499464. Para obtener más información sobre los valores permitidos para este campo, vea los valores de código con “da-” prefijo del servicio device model. |
dnt |
booleano | No |
ptv, ssptv, vmap, ssvmap |
Este campo está en desuso y puede quitarse en el futuro. Use la LimitAdTrackingEnabled marca en su lugar.Si truees , el usuario ha establecido la preferencia de nivel de sistema para no recibir anuncios dirigidos al comportamiento. Valores permitidos: true, false, 1o 0. |
devtime |
Entero | No |
ptv, ssptv, vmap, ssvmap |
Tiempo en el dispositivo, medido en segundos desde la época o tiempo unix. |
devtz |
string | No |
ptv, ssptv, vmap, ssvmap |
Zona horaria del dispositivo. |
external_uid |
string | No |
ptv, ssptv, vmap, ssvmap |
Cadena que corresponde a un identificador de usuario externo para este usuario. |
ifa |
string | Necesario para monetizar el inventario |
ptv, ssptv, vmap, ssvmap |
Identificador de dispositivo único que usa el estándar UUID (8-4-4-4-12) |
ifa_type |
string | Necesario para monetizar el inventario |
ptv, ssptv, vmap, ssvmap |
Los valores posibles son aaid (Android), idfa (AppleTV), afai (Amazon Fire), msai (Microsoft), rida (Roku), ppid, a tif(Tizen (Samsung)), vida (Vizio) lgudid y (LG).Nota: Si no puede pasar dinámicamente identificadores de dispositivo o plataforma, debe usar: - ifa_type=openudid para solicitudes de anuncios de CTV si tiene datos de autenticación y puede pasar identificadores persistentes- &ifa_type=sessionid si no tiene datos de autenticación con identificadores persistentes |
LimitAdTrackingEnabled |
booleano | No |
ptv, ssptv, vmap, ssvmap |
Si truees , el usuario ha establecido la preferencia de nivel de sistema para no recibir anuncios dirigidos al comportamiento. Valores permitidos: true, false, 1o 0.Para obtener más información sobre las preferencias de anuncios de nivel de sistema en iOS, consulta Opt out of interest-based ads from iAd (No participar en anuncios basados en intereses de iAd). Para obtener más información sobre las preferencias de anuncios de nivel de sistema en Android, consulta Id. de publicidad. |
md5udid |
string | No |
ptv, ssptv, vmap, ssvmap |
Hash MD5 de .ANDROID_ID Esto solo debe enviarse para dispositivos Android. Debe estar codificado en url. |
sha1udid |
string | No |
ptv, ssptv, vmap, ssvmap |
Hash SHA1 de ANDROID_ID. Esto solo debe enviarse para dispositivos Android. Debe ser una dirección URL codificada. |
rida |
string | No |
ptv, ssptv, vmap, ssvmap |
Identificador de dispositivo de un dispositivo Roku. Nota: Este parámetro no es necesario si ifa y ifa_type se pasan. |
idfa |
string | No |
ptv, ssptv, vmap, ssvmap |
Identificador de publicidad de Apple para dispositivos iOS que ejecutan iOS 6+. Nota: Este parámetro no es necesario si ifa y ifa_type se pasan. |
aaid |
string | No |
ptv, ssptv, vmap, ssvmap |
El identificador de publicidad de Google para dispositivos Android recuperado de los servicios de Google Play. |
adid |
string | No |
ptv, ssptv, vmap, ssvmap |
Identificador de publicidad de Windows para dispositivos Windows. Nota: Este parámetro no es necesario si ifa y ifa_type se pasan. |
ip |
string | Necesario para monetizar el inventario de CTV. |
ptv, ssptv, vmap, ssvmap |
Dirección IP del dispositivo que realiza la solicitud de anuncio, por ejemplo, 207.237.150.246.- Si no se especifica ninguna ip para /ptv las llamadas y /ssptv , el sistema usará la dirección IP que se pasa a través del encabezado HTTP "X-Forwarded-For" para la detección geográfica. |
language |
string | No |
ptv, ssptv, vmap, ssvmap |
El idioma del dispositivo, especificado con un código de idioma ISO. |
loc |
string | No |
ptv, ssptv, vmap, ssvmap |
La ubicación del usuario expresada en latitud y longitud, en el formato : snnn.ddddddddddddd,snnn.ddddddddddddd. Se permiten hasta 13 posiciones decimales de precisión. |
loc_age |
Entero | No |
ptv, ssptv, vmap, ssvmap |
Antigüedad de los datos de ubicación en milisegundos. |
loc_prec |
Entero | No |
ptv, ssptv, vmap, ssvmap |
Precisión de los datos de ubicación en metros. |
mcc |
Entero | No |
ptv, ssptv, vmap, ssvmap |
Código de país móvil especificado por la UIT. |
mnc |
Entero | No |
ptv, ssptv, vmap, ssvmap |
Código de red móvil especificado por la UIT. |
openudid |
string | No |
ptv, ssptv, vmap, ssvmap |
OpenUDID del dispositivo. Esto solo debe enviarse para las versiones 5 y posteriores de iOS. |
orientation |
string | No |
ptv, ssptv, vmap, ssvmap |
Orientación de la pantalla del dispositivo durante la solicitud de anuncio. Los valores permitidos son "v" o "h". |
os |
string | No |
ptv, ssptv, vmap, ssvmap |
El sistema operativo y el número de versión del dispositivo que solicita el anuncio. Normalmente, este valor se analiza a partir del parámetro de cadena ua (para implementaciones del lado servidor) o se incluye automáticamente en los encabezados de solicitud (para las integraciones del lado cliente). De lo contrario, puede usar este parámetro para pasar la información de la cadena de consulta directamente. Por ejemplo: iPhone - iOS (other versions). Para obtener más información sobre los valores permitidos para este campo, vea Servicio de sistema operativo. |
pcode |
string | No |
ptv, ssptv, vmap, ssvmap |
Código postal del usuario que solicita un anuncio. Si no se especifica, el código postal se determinará a partir de la dirección IP. |
redirenc |
string | No |
ptv, ssptv, vmap, ssvmap |
Dirección URL de redireccionamiento que se debe usar en el caso de que no haya ninguna creatividad válida para servir. La dirección URL debe codificarse. |
reserve |
Entero | No |
ptv, ssptv, vmap, ssvmap |
Precio de reserva para este inventario, que es la cantidad neta mínima que aceptará la colocación para colocar una creatividad. Este parámetro invalidará un precio preestablecido y establecerá el piso duro (y el piso blando cuando corresponda) si no se está usando Yield Management o si el precio de reserva es mayor en valor que el piso de YM en el que la regla de suelo tiene activada la opción de invalidación. |
sha1mac |
string | No |
ptv, ssptv, vmap, ssvmap |
Hash SHA1 del ODIN. Esto solo debe enviarse para las versiones 5 y posteriores de iOS. Debe estar codificado como dirección URL. |
st |
string | No |
ptv, ssptv, vmap, ssvmap |
Tipo de suministro del inventario, que indica el entorno en el que se mostrará un anuncio. Valores permitidos: "mobile_app", "mobile_web"o "web". Valores predeterminados de "mobile_app". |
size |
string | No |
ptv, ssptv, vmap, ssvmap |
En desuso. Use vwidth y vheight en su lugar. El tamaño de banner solicitado, por ejemplo, "320x50"o el tamaño de pantalla de los anuncios intersticiales. |
tmpl_id |
Entero | No |
ptv, ssptv, vmap, ssvmap |
Identificador de plantilla de suministro. |
traffic_source_code |
string | No |
ptv, ssptv, vmap, ssvmap |
Un código fuente de tráfico proporciona la capacidad de comprobar el origen de tráfico de terceros de una impresión determinada. Si el código fuente del tráfico está registrado previamente con Microsoft Advertising y se pasa a través de la cadena de consulta mediante la trafficSourceCode propiedad , se le permitirá conocer los orígenes del tráfico de terceros que se produjo para una impresión.Esto traffic_source_code se incluye en la fuente estándar y se puede usar para pasar información de clave-valor del publicador a la fuente. |
ua |
string | Necesario para monetizar el inventario de CTV. |
ptv, ssptv, vmap, ssvmap |
Cadena del agente de usuario asociada al dispositivo que solicita un anuncio. Si se especifica, este valor se usará en lugar del agente de usuario estándar enviado a través del encabezado HTTP. Debe estar codificado como dirección URL. El agente de usuario identifica información como el sistema operativo del dispositivo, así como la creación y el modelo del dispositivo, junto con la información sobre la aplicación y el proveedor de software que actúa en nombre del usuario. Muchos compradores se dirigen a sus audiencias en función de estos parámetros y no incluirlos restringirá la demanda. |
us_privacy |
string | No |
ptv, ssptv |
La cadena de privacidad de EE. UU. de IAB Tech Lab comunica señales relacionadas con la privacidad y la elección del consumidor según la normativa de privacidad de EE. UU.
Parte de las directivas de servicio Para obtener más información, consulte: Parte de las directivas de servicio. |
placement_set |
string | No |
vmap, ssvmap |
El conjunto de selección de ubicación que se va a asociar a la etiqueta. Para obtener más información, consulte Servicio de conjunto de selección de ubicación. |
vmin_ad_duration* |
Entero | Necesario para monetizar el inventario de CTV. |
ptv, ssptv, vmap, ssvmap |
Duración mínima del anuncio, en segundos. |
mimes* |
string | Se recomienda monetizar el inventario de CTV. |
ptv, ssptv, vmap, ssvmap |
Mimes de vídeo aceptados, expresados como una lista separada por comas de identificadores. Puede encontrar los identificadores en la documentación del servicio de selección de ubicación en "Tipos mime admitidos". |
minbitrate* |
Entero | Se recomienda monetizar el inventario de CTV. |
ptv, ssptv, vmap, ssvmap |
Velocidad de bits mínima aceptada. |
mf_min_height* |
Entero | No |
ptv, ssptv, vmap, ssvmap |
Alto mínimo del archivo multimedia, en píxeles |
mf_min_width* |
Entero | No |
ptv, ssptv, vmap, ssvmap |
Ancho mínimo del archivo multimedia, en píxeles |
mf_aspect_ratio* |
Entero | No |
ptv, ssptv, vmap, ssvmap |
Relación de aspecto del archivo multimedia |
an_user_id |
Entero | No | ssptv |
El identificador de usuario de Microsoft Advertising |
gpp |
string | Sí, en todas las llamadas GET en los estados de EE. UU. aplicables |
ptv, ssptv, vmap, ssvmap |
Indica la cadena de consentimiento de GPP de IAB real. Implica qué proveedores pueden procesar datos personales y en qué condiciones. Este campo se describe como parte de la Plataforma de privacidad global (GPP) de IAB Tech Lab. |
gpp_sid |
matriz de cadena | Sí, en todas las llamadas GET en los estados de EE. UU. aplicables |
ptv, ssptv, vmap, ssvmap |
Valor booleano que muestra qué secciones del GPP se aplican a la llamada. |
ext_inv_code |
Valor predefinido que se pasa a la cadena de consulta que se puede usar en la generación de informes. El valor debe escribirse en el sistema antes de registrarlo. Para obtener más información, vea Servicio de código de inventario externo. Ejemplo: ext_inv_code=10039 |