Error message

User warning: The following module is missing from the file system: fast_404. For information about how to fix this, see the documentation page. in _drupal_trigger_error_with_delayed_logging() (line 1143 of /mnt/www/html/ooyala/docroot/includes/bootstrap.inc).

Conjuntos de ads

Los conjuntos de ads son configuraciones de ads que controlan la experiencia con los ads de un vídeo durante la reproducción.

Las rutas de los conjuntos de ads crean, eliminan y cambian los nombres de los conjuntos de ads y asignan conjuntos de ads a los vídeos. Cualquier otro comportamiento de los ads debe estar definido en el Interfaz de usuario de Backlot.

Crear conjunto de ads

[POST] /v2/ad_sets 
{
  properties
}
   

Agregar un ad a un conjunto de ads

[POST] /v2/ad_sets/ad_set_id/ads 
{
  properties
}
   

Enumerar conjuntos de ads

[GET] /v2/ad_sets
   

Obtener conjunto de ads

[GET] /v2/ad_sets/ad_set_id
   

Modificar conjunto de ads

[PATCH] /v2/ad_sets/ad_set_id
{
  properties
}
   

Eliminar conjunto de ads

[DELETE] /v2/ad_sets/ad_set_id
   

Quitar ad del conjunto de ads

[DELETE] /v2/ad_sets/ad_set_id/ads/ad_id
   

Atributos de ruta

En la tabla siguiente se describen todos los atributos que se pueden expresar por medio de la ruta.

Atributo de ruta Descripción
ad_id El ID del ad.

Tipo: Cadena

Por defecto: Ninguno

Ejemplo: da1c1a4bd90c48c39d7ce3e8347bd758

ad_set_id

El ID del conjunto de ads. Para obtener una lista de conjuntos de ads, realice una consulta GET contra la ruta /v2/ad_sets.

Tipo: Cadena

Por defecto: Ninguno

Ejemplo: /ad_sets/IzNnllMjphu2XF3_UgPROoCi9B2BwtSg

Propiedades

En la siguiente tabla se describen todas las propiedades que se pueden asociar a un conjunto de ads.

Propiedad Descripción ¿Obligatorio?
default

En el caso ‘true’, este conjunto de ads se aplica automáticamente a los vídeos agregados a su biblioteca de contenido. Solo un conjunto de ads puede tener este campo establecido en ‘true’.

Tipo: Cadena

Valores válidos: true | false

Ejemplo: "true"

id Identificador único del conjunto de ads.

Ejemplo: "Erk3j4k98dh34kshdjf892kjvmF7Diew"

name Nombre de su conjunto de ads.

Tipo: Cadena

Ejemplo: "asset"

En la siguiente tabla se describen todas las propiedades que se pueden asociar a un ad.

Propiedad Descripción ¿Obligatorio?
ad_source

Fuente del ad.

Tipo: Cadena

Valores válidos: assets | ad_network_id. Consulte Fuentes de ads.

Por defecto: video

Ejemplo: "video"

ad_type

Tipo de ad.

Tipo: Cadena

Valores válidos: preroll | postroll | midroll | cuepoint

Por defecto: asset

Ejemplo: "preroll"

 
click_url

URL donde se redirige al usuario cuando hace clic en el ad.

Tipo: Cadena

Por defecto: Ninguno

Ejemplo: "http://www.myclickurl.com"

duration

Indica la longitud de su ad en milisegundos.

Tipo: Cadena

Por defecto: Ninguno

Condiciones: ad_source establecido en "vídeos"

Ejemplo: "My Movie"

Condicional
embed_code

Identificador de vídeo que se emplea como su ad.

Tipo: Entero

Por defecto: Ninguno

Condiciones: ad_source establecido en "vídeos"

Ejemplo: "01M2F0MTr3SWBB9dfAPT5xEsg8Gpy-jP"

Condicional
id Cadena que asocia exclusivamente un ad a un conjunto de ads.

Tipo: Cadena

Valores válidos: assets | ad_network_id

Por defecto: video

Ejemplo: "video"

name

Identificador de vídeo que se emplea como su ad.

Tipo: Entero

Por defecto: Ninguno

Condiciones: Obligatorio para vídeos.

Ejemplo: "10000"

Condicional
plays_before

El ad se visualiza después de las primeras x reproducciones.

Tipo: Entero

Por defecto: Ninguno

Ejemplo: "3"

plays_between

El ad se visualiza cada x reproducciones.

Tipo: Fecha y hora

Por defecto: Ninguno

Ejemplo: "3"

No
position

Indica cuándo se reproducirá el ad durante el vídeo.

Tipo: Cadena

Por defecto: Ninguno

Condiciones: ad_source establecido en "midroll"

Ejemplo: "3000"

Condicional
position_type

Indica si la posición se mide en milisegundos o con un porcentaje de la duración del vídeo.

Tipo: Cadena

Valores válidos: milliseconds | percent

Por defecto: Ninguno

Condiciones: ad_source establecido en "midroll"

Ejemplo:

Condicional
tag_url

URL del archivo XML que contiene la etiqueta del ad.

Tipo: Cadena

Por defecto: Ninguno

Condiciones: se aplica a ads de terceros.

Ejemplo: "http://cdn.mycdn.com/mytag2.xml"

Condicional
tracking_pixel_url

Cada vez que se reproduce el ad, se hace ping a esta URL.

Tipo: Cadena

Por defecto: Ninguno

Ejemplo: "http://www.mytrackingpixel.com"

No

Ejemplos

Este ejemplo crea un conjunto de ads:

[POST] /v2/ad_sets
{
  "name": "My new Ad Set",
  "default": true
}
    

Backlot devuelve una respuesta similar a la siguiente:

{
    "default": "true",
     "id": "ed4a4c6abdfc4ab8aa3e7b8a05f31ec6",
     "ads": [  ],
     "name": "My new Ad Set"
} 	   
    

Ordenando Pruébelo

En este ejemplo se agrega un ad a un conjunto de ads:

[POST] /v2/ad_sets/ed4a4c6abdfc4ab8aa3e7b8a05f31ec6/ads
    {
      "ad_source": "assets",
      "ad_type": "preroll",
      "embed_code": "01M2F0MTr3SWBB9dfAPT5xEsg8Gpy-jP",
      "plays_before": 0,
      "plays_between": 1,
      "click_url": "http://www.myclickurl.com",
      "tracking_pixel_urls": ["http://www.mytrackingpixel.com"]
    }
    

Backlot devuelve una respuesta similar a la siguiente:

{
 "click_url": "http://www.myclickurl.com",
 "ad_type": "preroll",
 "id": "da1c1a4bd90c48c39d7ce3e8347bd758",
 "tracking_pixel_urls": [   "http://www.mytrackingpixel.com"  ],
 "ad_source": "assets",
 "embed_code": "xkdG43NjrlM92YJ1HzaqiWQ3SZpO5da7",
 "name": "bleebleblobble 2.mov",
 "duration": "5038"
}
    

Ordenando Pruébelo

Fuentes de ads

AdTech
AdTech Overlay
Adap.tv
Adify In-Stream
Adify Overlay
Atlas
BrightRoll Overlay
Brightroll In-Stream
CBS Interactive
Dart Enterprise (VAST)
Dart Enterprise Overlay (VAST)
Dev Ad Display
Dev Ad Display Overlay
Dev Ad Manager
DoubleClick
DoubleClick Overlay
EyeWonder
Freewheel
Freewheel Commercial Breaks
Freewheel OPF Module
Freewheel Overlay
Google Adsense Endcap
Google Adsense Overlay
Google Adsense Video
HIRO-Media
LightningCast
LiveRail
LiveRail (VAST) In-Stream
LiveRail (VAST) Overlay
Ooyala In-Stream
Open AdStream
Open AdStream Overlay
OpenX In-Stream
OpenX Overlay
ScanScout
ScanScout (Mobile)
SpotXchange
TV2N
The Video Network
The Video Platform
Tremor Media - Acudeo
Tremor Media - Acudeo Lite
VAST Compliant In-Stream
VAST Compliant Overlay
Videoplaza
Yahoo
YuMe Overlay
YuMe Video
vídeos