Parámetros de etiqueta necesarios para el inventario de CTV
Puede usar una sola etiqueta combinada para CTV o crear etiquetas independientes para cada tipo de dispositivo. Al identificar el dispositivo, se recomienda usar ifa
y ifa_type
: si no puede usar estos parámetros, puede usar openudid
.
Nota:
Necesitará parámetros adicionales, como el ancho y el alto, para monetizar el inventario, a menos que estos valores se hayan establecido en la ubicación.
En los ejemplos siguientes se muestra cómo implementar una etiqueta del lado servidor con ifa
/ifa_type
o , si ifa
y ifa_type
no se puede usar, con openudid
.
https://secure.adnxs.com/ssptv?id=<PLACEMENT_ID>&appid=<INSERT_MACRO>&ifa=<INSERT_MACRO>&ifa_type=<INSERT_MACRO>
https://secure.adnxs.com/ssptv?id=<PLACEMENT_ID>&appid=<INSERT_MACRO>&openudid=<INSERT_MACRO>
Parámetro | Tipo | ¿Necesario? | Controladores compatibles | Description |
---|---|---|---|---|
appid (CTV) |
string | Sí | ptv , ssptv , vmap , ssvmap |
Esta cadena se usa para identificar una aplicación que se ejecuta en un dispositivo ConnectedTV, como Apple TV, Fire TV, Android TV o Roku. - En Android, este es el nombre del paquete de la aplicación. Tiene el formato siguiente: com.example.helloworld .- En iOS, este es el identificador numérico de la tienda iOS de la aplicación, generado automáticamente por el App Store. Tiene el formato siguiente: 123456789 . Muchos compradores establecen la segmentación y los informes de la campaña en función de appid . Si no se proporciona una corrección, appid 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 .Para buscar el identificador de la aplicación para una aplicación de Android o IOS determinada, busque la página de detalles de la aplicación, que puede encontrar mediante una búsqueda web. La dirección URL de la página de detalles de la tienda de aplicaciones mostrará el identificador de la aplicación. Por ejemplo, estas son las páginas de detalles de la aplicación "Fussball": - Google Play: https://play.google.com/store/apps/details?id=de.telekom.FUSSBALL.DE -Itunes: https://itunes.apple.com/de/app/fussball.de/id422052549 |
channel_name |
string | Se recomienda monetizar el inventario. | ptv , ssptv |
Nombre del canal en el que se emite el contenido. |
content_cat |
matriz de cadena | Se recomienda monetizar el inventario. | 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. | ptv , ssptv , vmap , ssvmap |
Tipo de contenido (juego, vídeo, texto, etc.). |
content_contentrating |
string | Se recomienda monetizar el inventario. | ptv , ssptv , vmap , ssvmap |
Clasificación de contenido (por ejemplo: PG-13). |
content_episode |
Entero | Se recomienda monetizar el inventario. | ptv , ssptv , vmap , ssvmap |
Número de episodio. |
content_genre |
string | Se recomienda monetizar el inventario. | ptv , ssptv , vmap , ssvmap |
El género que mejor describe el contenido. |
content_len |
Entero | Se recomienda monetizar el inventario. | ptv , ssptv , vmap , ssvmap |
Duración del contenido en segundos. |
content_livestream |
Entero | Se recomienda monetizar el inventario. | ptv , ssptv , vmap , ssvmap |
Si el contenido está en directo o en vídeo a petición (VOD). 0: VOD, 1: Live. |
content_network |
string | Se recomienda monetizar el inventario. | 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_prodq |
Entero | Se recomienda monetizar el inventario. | ptv , ssptv , vmap , ssvmap |
Calidad de producción. |
content_season |
string | Se recomienda monetizar el inventario. | ptv , ssptv , vmap , ssvmap |
Temporada de contenido (ejemplo: "Temporada 3"). Este campo es importante para monetizar el inventario de CTV (Tv conectado). |
content_series |
string | Se recomienda monetizar el inventario. | 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_title |
string | Se recomienda monetizar el inventario. | 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). |
id |
string | Sí | 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, vea "Atributos de vídeo de destino a través de parámetros de consulta". |
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 , tifa ( Tizen (Samsung)), vida (Vizio) y lgudid (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 |
ip |
string | Necesario para monetizar el inventario. | 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. |
mimes* |
string | Se recomienda monetizar el inventario. | 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. | ptv , ssptv , vmap , ssvmap |
Velocidad de bits mínima aceptada. |
ua |
string | Necesario para monetizar el inventario. | 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. |
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 - Linear Mid-roll - 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-1 Nota: vframeworks admite valores enteros únicos, así como una lista de valores enteros separados por comas. Por ejemplo,vframeworks=1,2,3 Otra posibilidad: vframeworks=1 . |
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. |
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. |
vmaxduration |
Entero | Necesario para monetizar el inventario. | 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. |
vmin_ad_duration* |
Entero | Necesario para monetizar el inventario. | ptv , ssptv , vmap , ssvmap |
Duración mínima del anuncio, en segundos. |
vv |
Entero | Necesario para monetizar el inventario. | 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. |
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. |