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

Atributos comunes y parámetros de cadena de consulta

Estos atributos y parámetros de cadena de consulta son utilizados por las rutas de Estadísticas.

Atributos de ruta

La tabla siguiente describe todos los atributos de la ruta.

Atributo de ruta Descripción
asset_id Especifica el ID del vídeo.

Tipo: Cadena

Por defecto: Ninguno

Ejemplos:

/v2/analytics/reports/asset/fjkl3s23fdsf2/engagement

city

Devuelve información sobre las ciudades.

Tipo: Cadena

Por defecto: Devuelve las diez mejores ciudades.

Ejemplos:

[GET] /v2/analytics/reports/account/performance/cities/2011-08-01...2011-08-08 (todas las ciudades)

[GET] /v2/analytics/reports/account/performance/countries/us/regions/california/cities/2011-08-01...2011-08-08 (todas las ciudades de California)

[GET] /v2/analytics/reports/account/performance/countries/us/regions/california/cities/san+francisco/2011-08-01...2011-08-08 (solo San Francisco)

[GET] /v2/analytics/reports/asset/asset_id/performance/cities/2011-08-01...2011-08-08 (vídeo especificado, todas las ciudades)

[GET] /v2/analytics/reports/asset/asset_id/performance/countries/us/regions/california/cities/2011-08-01...2011-08-08 (vídeo especificado, todas las ciudades de California)

[GET] /v2/analytics/reports/asset/asset_id/performance/countries/us/regions/california/cities/san+francisco/2011-08-01...2011-08-08 (vídeo especificado, solo San Francisco)

country

Devuelve información sobre los países (no se diferencia entre mayúsculas y minúsculas).

Tipo: Cadena

Por defecto: Devuelve los diez mejores países.

Valores válidos: Para obtener una lista de códigos de países válidos, consulte los códigos de dos letras para países ISO 3166-1. Para los países desconocidos, Backlot utilice u0.

Ejemplos:

[GET] /v2/analytics/reports/account/performance/countries/2011-08-01...2011-08-08 (todos los países)

[GET] /v2/analytics/reports/account/performance/countries/us/2011-08-01...2011-08-08 (solo EE.UU.)

[GET] /v2/analytics/reports/asset/asset_id/performance/countries/2011-08-01...2011-08-08 (vídeo especificado en todos los países)

[GET] /v2/analytics/reports/asset/asset_id/performance/countries/us/2011-08-01...2011-08-08 (vídeo especificado solo en EE.UU.)

date_range

Especifica el rango de fechas.

Tipo: Cadena

Por defecto: Ninguno

Ejemplos:

[GET] /v2/analytics/reports/account/performance/regions/2012-01-01 (un día)

[GET] /v2/analytics/reports/account/performance/regions/2012-01-01...2012-01-02 (un día)

[GET] /v2/analytics/reports/account/performance/regions/2012-01-01...2012-01-08 (semanal)

[GET] /v2/analytics/reports/account/performance/regions/2012-01-01...2012-02-01 (mensual)

[GET] /v2/analytics/reports/account/performance/regions/2012-01-01...2012-04-01 (trimestral)

Note: La última fecha del rango no está incluida en los resultados.
devicetype

Devuelve información sobre los tipos de dispositivos.

Tipo: Cadena

Valores válidos: mobile | tablet | desktop | settop | unknown.devicetype

Por defecto: Ninguno

Ejemplo: /analytics/reports/account/performance/device_types/tablet/2011-08-01...2011-08-08

dma

Devuelve información sobre áreas de mercado designadas (DMA).

Por defecto: Devuelve las diez mejores DMA.

Ejemplos:

[GET] /v2/analytics/reports/account/performance/dmas/2011-08-01...2011-08-08 (todas las DMA)

[GET] /v2/analytics/reports/account/performance/dmas/new+york/2011-08-01...2011-08-08 (DMA de Nueva York)

[GET] /v2/analytics/reports/asset/asset_id/performance/dmas/2011-08-01...2011-08-08 (vídeo especificado, todas las DMA)

[GET] /v2/analytics/reports/asset/asset_id/performance/dmas/new+york/2011-08-01...2011-08-08 (vídeo especificado, DMA de Nueva York)

domain

Devuelve información sobre los dominios.

Tipo: Cadena

Por defecto: Devuelve los diez mejores dominios.

Ejemplos:

[GET] /v2/analytics/reports/account/performance/domains/2011-08-01...2011-08-08 (todos los dominios)

[GET] /v2/analytics/reports/account/performance/domains/ooyala.com/2011-08-01...2011-08-08 (dominio ooyala.com)

[GET] /v2/analytics/reports/asset/asset_id/performance/domains/2011-08-01...2011-08-08 (vídeo especificado, todos los dominios)

[GET] /v2/analytics/reports/asset/asset_id/performance/domains/ooyala.com/2011-08-01...2011-08-08 (vídeo especificado, dominio ooyala.com)

level

Especifica si el informe se ejecuta en el ámbito de la cuenta o del vídeo. Si especifica el vídeo, debe proporcionar un ID de vídeo.

Tipo: Cadena

Por defecto: Ninguno

Valores válidos: account | asset/asset_id

Ejemplos:

[GET] /v2/analytics/reports/account/performance/total/2011-08-01...2011-08-08

[GET] /v2/analytics/reports/asset/fjkl3s23fdsf2/performance/total/2011-08-01...2011-08-08

platform

Devuelve información sobre las plataformas (tipos de dispositivos, sistemas operativos y navegadores).

Tipo: Cadena

Por defecto: Ninguno

Ejemplo:

[GET] /v2/analytics/reports/account/performance/platforms/2011-08-01...2011-08-08 (todas las plataformas)

[GET] /v2/analytics/reports/account/performance/platforms/desktop:mac-chrome/2011-08-01...2011-08-08 (Macs con el navegador Chrome)

[GET] /v2/analytics/reports/asset/asset_id/performance/platforms/2011-08-01...2011-08-08 (vídeo especificado, todas las plataformas)

[GET] /v2/analytics/reports/asset/asset_id/performance/platforms/tablet:android-unknown.browser/2011-08-01...2011-08-08 (vídeo especificado, tabletas con iOS)

[GET] /v2/analytics/reports/account/performance/device_types/desktop/platforms/2011-08-01...2011-08-08 (todas las plataformas de PCs de sobremesa)

region

Devuelve información sobre las regiones (por ejemplo, estados de los Estados Unidos).

Tipo: Cadena

Por defecto: Devuelve las diez mejores regiones.

Ejemplos:

[GET] /v2/analytics/reports/account/performance/regions/2011-08-01...2011-08-08 (todas las regiones)

[GET] /v2/analytics/reports/account/performance/countries/us/regions/2011-08-01...2011-08-08 (todas las regiones de EE.UU.)

[GET] /v2/analytics/reports/account/performance/countries/us/regions/california/2011-08-01...2011-08-08 (solo California)

[GET] /v2/analytics/reports/asset/asset_id/performance/regions/2011-08-01...2011-08-08 (vídeo especificado, todas las regiones)

[GET] /v2/analytics/reports/asset/asset_id/performance/countries/us/regions/2011-08-01...2011-08-08 (vídeo especificado, todas las regiones de EE.UU.)

[GET] /v2/analytics/reports/asset/asset_id/performance/countries/us/regions/california/2011-08-01...2011-08-08 (vídeo especificado, solo California)

tag_id

El ID de la etiqueta.

Tipo: Cadena

Por defecto: Ninguno

Ejemplo: /analytics/tags/extreme_couch_potato

videos

Devuelve los mejores vídeos.

Tipo: Cadena

Por defecto: 10

Ejemplo:

[GET] /v2/analytics/reports/account/performance/videos/2011-08-01...2011-08-08&limit=20

Parámetros de la cadena de consulta

En la siguiente tabla se describen los parámetros de la cadena de consulta de las rutas.

Note: Para mayor claridad, los ejemplos mostrados no están codificados con URL; sin embargo, en la práctica real, todos los parámetros de la cadena de consulta y los valores deben estar codificados con URL.
Parámetro Descripción ¿Obligatorio?
breakdown_by

Devuelve los resultados por día, semana y/o mes en lugar de devolver los criterios como un valor único. Este parámetro solo se admite cuando la dimensión es total y no hay obtención de detalles.

Tipo: Cadena

Valores válidos: day | week | month

Por defecto: day

Ejemplo: breakdown_by=month

No
limit

El número máximo de resultados que devolver. Si recibe más resultados que el valor que especifique, puede obtener la siguiente página de resultados con el token de paginación.

Tipo: Entero

Por defecto: 10

Valores válidos: 1-500

Ejemplo: limit=20

No
order_by

El campo por el que ordenar, en orden descendente. Cualquier consulta ordenada por reproducciones, por presentaciones o por tiempo visualizado devolverá hasta 1000 resultados.

Tipo: Cadena

Por defecto: reproducciones

Valores válidos: plays | displays | time_watched | ninguno

Ejemplo: order_by=displays

No
paging_token

o

page_token
URL a la siguiente página de resultados.
Note: Si el número de resultados para una página determinada es divisible por el valor de limit, el servicio devuelve una respuesta 404.

Tipo: Cadena

Por defecto: Ninguno

Ejemplo: [GET] /v2/analytics/reports/account/performance/videos/2012-01-01...2012-01-24?page_token=W1siY29sdW1uIiwiMzRTYUun1yJdLFsiaW5kZXgiLDEwXSxbInZhbHVlIiwxXV0=

No