Crea una configuración para una sesión de VOD

Para la integración de Ad Manager, debes crear una etiqueta de anuncio para la sesión de VOD. También debes crear una configuración de VOD. La API de Video Stitcher registra esta configuración con Ad Manager.

Crea una etiqueta de anuncio en Ad Manager

Realiza los siguientes pasos en tu cuenta de Ad Manager:

  1. Agrega una unidad de anuncios nueva.
  2. Activa las reglas de anuncios.

  3. Crea una regla de anuncios nueva. Como parte de este paso, busca la sección Segmentación > Inventario en Ad Manager. Selecciona la nueva unidad de anuncios del paso anterior.

  4. Para crear una etiqueta de anuncio válida, sigue los pasos que se indican en Genera etiquetas de anuncios de audio y video con las siguientes modificaciones:

    • En el tipo de SDK del reproductor, selecciona SDK de IMA de Google.
    • Agrega el parámetro ad_rule=1 a la etiqueta (por ejemplo, agrega &ad_rule=1 al final).
    • Agrega el parámetro vid_d=vod-asset-duration-in-secs a la etiqueta (por ejemplo, agrega &vid_d=1800 al final para un activo de VOD de 30 minutos).
    • Modifica el parámetro output=vast para que sea output=xml_vmap1. La especificación de la playlist de varios anuncios de video (VMAP) es el único tipo de salida compatible.

Crea una configuración de VOD

Para crear la configuración, usa el método projects.locations.vodConfigs.create. Consulta la documentación de referencia de configuración de VOD para ver los campos opcionales (como los encabezados personalizados).

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_NUMBER: Es el número de tu proyecto de Google Cloud, que se encuentra en el campo Número de proyecto de la página Configuración de IAM.
  • LOCATION: Es la ubicación en la que se creará la configuración de VOD. Usa una de las regiones compatibles.
    Cómo mostrar ubicaciones
    • us-central1
    • us-east1
    • us-west1
    • asia-east1
    • asia-south1
    • asia-southeast1
    • europe-west1
    • southamerica-east1
  • VOD_CONFIG_ID: Es un identificador definido por el usuario para la configuración de VOD. Este ID solo puede contener letras minúsculas, números y guiones. El primer carácter debe ser una letra, el último debe ser una letra o un número, y el ID completo tiene un máximo de 63 caracteres.
  • VOD_URI: Es el URI del contenido multimedia que se unirá. Este URI debe hacer referencia a un archivo de manifiesto MPEG-DASH (MPD) o a un archivo de manifiesto HLS (M3U8). Usa un URI público o un URI sin firmar para el que registraste una clave de CDN. 
  • AD_TAG_URI
     es la URL de los metadatos de anuncios recuperados de los servidores de anuncios. Para la integración de Ad Manager, esta debe ser una etiqueta de anuncio de video válida de Ad Manager. Para obtener una etiqueta de anuncio válida, sigue los pasos que se indican en la sección anterior Cómo crear una etiqueta de anuncio en Ad Manager.
  • NETWORK_CODE: Es el identificador numérico de tu red de Ad Manager. Puedes encontrarlo en la Configuración global de la cuenta del publicador.

Cuerpo JSON de la solicitud:

{
  "sourceUri": "VOD_URI",
  "adTagUri": "AD_TAG_URI",
  "gamVodConfig": {
    "networkCode": "NETWORK_CODE"
  }
}

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.common.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID",
    "verb": "create",
    "cancelRequested": false,
    "apiVersion": "v1"
  },
  "done": false
}

Este comando crea una operación de larga duración (LRO) que puedes consultar para hacer un seguimiento del progreso. Copia el OPERATION_ID que se muestra, que es la última parte del campo name, para usarlo en la siguiente sección.

Verifica el resultado

Usa el método projects.locations.operations.get para verificar si se creó la configuración de VOD. Si la respuesta contiene "done: false", repite el comando hasta que la respuesta contenga "done: true".

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_NUMBER: Es el número de tu proyecto de Google Cloud, que se encuentra en el campo Número de proyecto de la página Configuración de IAM.
  • LOCATION: Es la ubicación de los datos. Usa una de las regiones compatibles.
    Cómo mostrar ubicaciones
    • us-central1
    • us-east1
    • us-west1
    • asia-east1
    • asia-south1
    • asia-southeast1
    • europe-west1
    • southamerica-east1
  • OPERATION_ID: Es el identificador de la operación.

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.common.OperationMetadata",
    "createTime": CREATE_TIME,
    "endTime": END_TIME,
    "target": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID",
    "verb": "create"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.video.stitcher.v1.VodConfig",
    "name": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID",
    "sourceUri": "VOD_URI",
    "adTagUri": "AD_TAG_URI",
    "gamVodConfig": {
      "networkCode": "NETWORK_CODE"
    },
    "state": "READY"
  }
}

Verifica que el estado esté configurado como READY. De lo contrario, espera unos segundos y vuelve a enviar la solicitud.

Para obtener más información sobre las configuraciones de VOD, consulta Cómo crear y administrar una configuración de VOD.

Anterior
Descripción general
Siguiente
Prepárate para que tu aplicación cliente funcione con Google Ad Manager