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 en Ad Manager.

Crea una etiqueta de anuncio en Ad Manager

Sigue estos pasos en tu cuenta de Ad Manager:

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

  3. Cree una nueva regla de anuncios. 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. Crea una etiqueta de anuncio válida. Para ello, sigue los pasos que se indican en Cómo generar 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. El video La especificación de varias playlists de anuncios (VMAP) es el único resultado admitido. el tipo de letra.

Crea una configuración de VOD

Para crear la configuración, usa el projects.locations.vodConfigs.create . Consulta la Documentación de referencia de la configuración de VOD para los campos opcionales (como 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 un URI público o 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 para la cuenta de 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 un operación de larga duración (LRO) que puedes consultar para seguir el progreso. Copiar el valor devuelto OPERATION_ID, que es la última parte del campo name, que se usará en la siguiente sección.

Verifica el resultado

Usa la 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.
    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 no ser así, espera unos segundos y envía la solicitud nuevamente.

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