Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 16 Next »

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í.

s_es.png

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):
1 = Mobile/Tablet - General
2 = Personal Computer
3 = Connected TV
4 = Phone
5 = Tablet
6 = Connected Device
7 = Set Top Box
8 = OOH Device

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:
1 = GPS/Location Services
2 = IP Address
3 = Provista por el usuario

age

Edad del usuario (ejemplo: 51, 24)

gender

Genero del usuario
M = Masculino
F = Femenino
O = Otros

us_privacy

US privacy string, necesario en algunas jurisdicciones:
https://github.com/InteractiveAdvertisingBureau/USPrivacy/blob/master/CCPA/US%20Privacy%20String.md

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
0 = No
1 = Si

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:
1 = VAST 1.0
2 = VAST 2.0
3 = VAST 3.0
4 = VAST 1.0 Wrapper
5 = VAST 2.0 Wrapper
6 = VAST 3.0 Wrapper
7 = VAST 4.0
8 = VAST 4.0 Wrapper
9 = DAAST 1.0
10 = DAAST 1.0 Wrapper

apis

APIs soportadas, separadas por coma:
1 = VPAID 1.0
2 = VPAID 2.0
3 = MRAID-1
4 = ORMMA
5 = MRAID-2
6 = MRAID-3
7 = OMID-1

pm

Método de reproducción. Si no se especifica, se asume que cualquiera puede ser utilizado
1 = Inicia en carga de pagina con sonido encendido
2 = Inicia en carga de pagina con sonido apagado
3 = Inicia con click con sonido encendido
4 = Inicia al mover el mouse encima, con sonido encendido
5 = Inicia al quedar en un área visible, con sonido encendido
6 = Inicia al quedar en un área visible, con sonido apagado

sd

Indica la demora en segundos para pre-roll, mid-roll, o post-roll:
Valor > 0 = Mid-Roll (el valor indica la demora para comenzar)
0 = Pre-Roll
-1 = Generic Mid-Roll
-2 = Generic Post-Roll

plcmt

Tipo de ubicación para el anuncio:
1 = Instream
2 = Accompanying Content
3 = In-Article
4 = No Content/Standalone

instl

Indica si el anuncio es un interstitial:
0 = No
1 = Si

pos

Posición del anuncio en la pantalla:
0 = Desconocido
1 = Antes del scroll
3 = Debajo del scroll
7 = Pantalla completa

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:
0 = Desconocido
1 = Client-side
2 = Anuncio server-side, pero URLs de conteo se ejecutan client-side
3 = 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:
1 = Video
2 = Videojuego
3 = Musica
4 = Aplicación
5 = Texto
6 = Otra
7 = Desconocido

livestream

Indica si el contenido es en vivo:
0 = No
1 = Si

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>
  • No labels