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.
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í.
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.
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
[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 |
[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 |
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ámetro | Descripción |
|---|---|
ip | Dirección IPv4 del usuario |
ua | User agent |
dtype | Tipo de dispositivo (device.devicetype): |
ifa | Identifier for Advertisers (IFA) del dispositivo del usuario |
ifv | Identifier For Vendors (también conocido como 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á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 |
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 |
|---|---|
content_id | ID que identifique univocamente el contenido |
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) |
rating | Content rating (e.g., MPAA) |
len | Duración del contenido en segundos |
ctx | Tipo de contenido: |
content_categories | Listado de categorías de IAB separadas por comas |
content_keywords | Listado de palabras clave separadas por comas |
livestream | Indica si el contenido es en vivo: |
channel | Nombre del canal (por ejemplo “MTV”) |
content_producer_name | Nombre del productor del contenido (por ejemplo “Warner Bros”) |
network_name | Red de contenido donde se emite el contenido (por ejemplo “ABC”) |
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
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.
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> |