VAST es la tecnología preferida hoy en día para la monetización de inventario de video. E-Planning SSP puede ser implementado mediante tags VAST, tanto para tráfico web como para aplicaciones móviles.
Contenido
Obtención de los tags
Los tags VAST consisten en unas URLs que deben ser implementadas de forma directa en su reproductor de video o ad server. Los mismos pueden ser extraidos de la plataforma ingresando a la pestaña Implementación.
En la misma encontrará diferentes versiones del código según donde se implementará:
VAST URL para sitios web: Utilice este código si va a implementar el tag VAST en un sitio web
VAST URL para apps: Utilice este código si va a implementar el tag VAST
VAST URL para CTV: Utilice este código si va a implementar el tag VAST en aplicaciones de CTV
Recuerde que además de implementar los tags, debe implementar correctamente las líneas en el archivo ads.txt. Encuentre mas información sobre ads.txt haciendo click aquí.
Implementación
Copie el tag y péguelo en su reproductor de video o ad server, según las instrucciones proporcionadas por los mismos para la implementación de tags VAST.
Macros
Los tags que pueden extraerse de la plataforma contienen una serie de macros, las cuales son reemplazadas de forma automática por su reproductor de video o ad server al momento de realizar el llamado a E-Planning SSP. En caso de que su reproductor de video o ad server no sean compatibles con macros VAST, por favor reemplacelas manualmente
VAST URL para sitios web
[PLAYERSIZE]: debe ser reemplazado por el alto y ancho del reproductor de video, los mismos deben estar separados por el carácter “,” (coma). Por ejemplo: 640,480
[PAGEURL]: debe ser reemplazado por la URL de la página actual encodeada
[PLACEMENTTYPE]: debe ser reemplazada por 1 si el reproductor es in-stream o 2 si el reproductor es out-stream
Ejemplo:
https://ads.us.e-planning.net/vssp/1/18f66?sz=640,480&ur=https%3A%2F%2Fwww.test.com&vv=3&vctx=1
VAST URL para aplicaciones móviles
[PLAYERSIZE]: debe ser reemplazado por el alto y ancho del reproductor de video, los mismos deben estar separados por el carácter “,” (coma). Por ejemplo: 640,480
[APPBUNDLE]: debe ser reemplazado por el bundle de la aplicación, por ejemplo com.android.myapp
[PLACEMENTTYPE]: debe ser reemplazada por 1 si el reproductor es in-stream o 2 si el reproductor es out-stream
[IFA]: debe ser reemplazado por el Identifier for Advertisers (IFA) del usuario. En caso de no estar disponible o ser desconocido, se debe dejar en blanco
Ejemplo:
https://ads.us.e-planning.net/vssp/1/18f66?sz=640,480&b=com.android.myapp&vv=3&vctx=1&ifa=AA000DFE74168477C70D291f574D344790E0BB11
Parámetros extra
Algunos parámetros son opcionales y no se encuentran incluidos por defecto en las URLs VAST. Sin embargo, es recomendable añadirlos cuando estén disponibles, ya que le ayudarán a monetizar mejor su contenido.
Puede añadir cualquiera de ellos como parámetro a su URL VAST. Por ejemplo, si desea añadir información sobre la edad:
https://ads.us.e-planning.net/vssp/1/18f66?sz=640,480&b=com.android.myapp&vv=3&vctx=1&ifa=AA000DFE74168477C70D291f574D344790E0BB11&age=35
Todos los parámetros deben encodearse en URL cuando sea necesario.
Parámetros de usuario y dispositivo
Parámetro | Descripción |
---|---|
ip | Dirección IPv4 del usuario |
ua | User agent |
dtype | Tipo de dispositivo (device.devicetype): |
ifv | Identifier For Vendors (aka IDFV) |
lat | Latitud (expresado como flotante) |
lon | Longitud (expresado como flotante) |
lltype | Forma de recolección de latitud y longitud: |
age | Edad del usuario (ejemplo: 51, 24) |
gender | Genero del usuario |
us_privacy | US privacy string, necesario en algunas jurisdicciones: |
consent | TCF2 consent string |
gpp | GPP string, necesario en algunas jurisdicciones |
gpp_sid | GPP section id, separado por coma para varias secciones |
coppa | Indicar si la transacción esta sujeta a COPPA |
Parámetros de inventario
Parámetro | Descripción |
---|---|
minduration | Duración mínima requerida del anuncio |
maxduration | Duración máxima requerida del anuncio |
protocols | Protocolos soportados, separados por coma: |
apis | APIs soportadas, separadas por coma: |
pm | Método de reproducción. Si no se especifica, se asume que cualquiera puede ser utilizado |
sd | Indica la demora en segundos para pre-roll, mid-roll, o post-roll: |
plcmt | Tipo de ubicación para el anuncio: |
instl | Indica si el anuncio es un interstitial: |
pos | Posición del anuncio en la pantalla: |
schain | Supply Chain en formato serializado. Solo requerido en caso de que la relación con E-Planning no sea directa. |
ssai | Indica si se insertará el anuncio server-side: |
ipd | Inventory partner domain. Dominio de terceros autorizado para validar ads.txt y app-ads.txt |
mnbr | Mínimo bit rate en Kbps |
mxbr | Máximo bit rate en Kbps |
sturl | URL de la aplicación en la tienda |
Parámetros de contenido de video
Estos parámetros describen el contenido en el que aparecerá el anuncio. Los parámetros de contenido son altamente recomendables en el inventario de CTV y deben añadirse siempre que sea posible.
Field | Description |
---|---|
title | Titulo del contenido (ejemplo: Search Committee) |
series | Nombre de la serie (ejemplo: The Office) |
genre | Genero que mejor describa el contenido |
season | Temporada (ejemplo: “Temporada 3”) |
episode | Numero de episodio |
language | Idioma del contenido utilizando ISO-639-1-alpha-2 (por ejemplo, EN) |
len | Duración del contenido en segundos |
ctx | Tipo de contenido: |
livestream | Indica si el contenido es en vivo: |
Bid floor
Por defecto la subasta se realizará utilizando el bid floor configurado en la plataforma. Sin embargo, es posible definir bid floors dinámicamente en el tag mediante el parámetro p=.
Para definirlos, agregue al tag (en cualquier de sus versiones) un nuevo parámetro p= con el bid floor deseado. Por ejemplo:
https://ads.us.e-planning.net/vssp/1/18f66?sz=640,480&b=com.android.myapp&vv=3&vctx=1&p=1.23
De esta forma, al realizarse la subasta, la misma tendrá un precio mínimo de USD 1.23
Pricing
Soportamos el uso de la etiqueta <Pricing> en la respuesta VAST, donde informamos del precio de la subasta expresado como CPM. Si su servidor de anuncios o reproductor de vídeo lo soporta, puede utilizar este campo para decidir si reproducir el anuncio o no en función de otras ofertas que pueda tener para la misma impresión.
Este es un ejemplo de un documento VAST que utiliza la etiqueta <Pricing>:
<VAST version="3.0" xmlns:xs="http://www.w3.org/2001/XMLSchema"> <Ad id="45-1678755"> <InLine> <AdSystem>e-planning</AdSystem> <AdTitle>Demo Ad</AdTitle> <Pricing model="cpm" currency="USD"> <![CDATA[ 5.00 ]]> </Pricing>
Puede encontrar más información en la definición de IAB VAST 3.0 bajo la sección 2.2.4.2.
Sincronización de usuarios
Para la implementación en web, es importante que realice correctamente la sincronización de usuarios dado que la misma puede aumentar considerablemente la monetización.
Para realizarla, inserte en sus paginas el siguiente código HTML:
<iframe src="https://ads.us.e-planning.net/uspd/1/" width="0" height="0" style="display: none;"></iframe>