Créer une configuration pour une session de vidéo à la demande

Pour l'intégration d'Ad Manager, vous devez créer un tag d'annonce pour la session VOD. Vous devez également créer une configuration VOD. API Video Stitcher enregistre cette configuration auprès d'Ad Manager.

Créer un tag d'emplacement publicitaire dans Ad Manager

Suivez les étapes ci-dessous dans votre compte Ad Manager :

  1. Ajoutez un bloc d'annonces.
  2. Activez les règles relatives aux annonces.

  3. Créez une règle relative aux annonces. Dans cette étape, recherchez la section Ciblage > Inventaire dans Ad Manager. Sélectionnez le nouveau bloc d'annonces de l'étape précédente.

  4. Créez un tag publicitaire valide en suivant la procédure décrite dans la section Générer des tags publicitaires vidéo et audio, en apportant les modifications suivantes :

    • Pour le type de SDK du lecteur, sélectionnez SDK IMA de Google.
    • Ajoutez le paramètre ad_rule=1 à la balise (par exemple, ajoutez &ad_rule=1 à la fin).
    • Ajoutez le paramètre vid_d=vod-asset-duration-in-secs. au tag. Par exemple, ajoutez &vid_d=1800 à la fin pendant 30 minutes élément VOD).
    • Remplacez le paramètre output=vast par output=xml_vmap1. La spécification VMAP (Video Multiple Ad Playlist) est le seul type de sortie accepté.

Créer une configuration VOD

Pour créer la configuration, utilisez la méthode projects.locations.vodConfigs.create . Consultez la documentation de référence sur la configuration VOD pour connaître les champs facultatifs (comme les en-têtes personnalisés).

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • PROJECT_NUMBER : numéro de votre projet Google Cloud, qui se trouve dans le champ Project number (Numéro de projet) sur la page IAM Settings (Paramètres IAM).
  • LOCATION: emplacement de création de votre configuration de vidéo à la demande. utilisez l'une des régions disponibles.
    Afficher les lieux
    • us-central1
    • us-east1
    • us-west1
    • asia-east1
    • asia-south1
    • asia-southeast1
    • europe-west1
    • southamerica-east1
  • VOD_CONFIG_ID : identifiant défini par l'utilisateur pour la configuration VOD. Cet identifiant ne peut contenir que des lettres minuscules, des chiffres et des traits d'union. Le premier caractère doit être une lettre, le dernier doit être une lettre ou un chiffre, et l'ID complet ne doit pas dépasser 63 caractères.
  • VOD_URI: URI du contenu multimédia à assembler. Cet URI doit faire référence à un fichier manifeste MPEG-DASH (MPD) ou à un fichier manifeste HLS (M3U8). Utilisez un URI public ou un URI non signé pour lequel vous avez enregistré une clé CDN. 
  • AD_TAG_URI
     : URL des métadonnées de l'annonce. récupérées à partir des serveurs de publicité ; pour l'intégration d'Ad Manager, il doit s'agir d'un tag publicitaire vidéo Ad Manager. Pour obtenir un tag d'emplacement publicitaire valide, suivez la procédure décrite dans la section précédente Créer un tag d'emplacement publicitaire dans Ad Manager.
  • NETWORK_CODE: identifiant numérique de votre réseau Ad Manager, vous le trouverez dans le Paramètres généraux pour le compte d'éditeur

Corps JSON de la requête : 

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

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

{
  "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
}

Cette commande crée un Opération de longue durée (LRO) que vous pouvez interroger pour suivre la progression. Copiez l'élément renvoyé. OPERATION_ID, qui est la dernière partie du champ name, que nous utiliserons dans la section suivante.

Vérifier le résultat

Utilisez le projects.locations.operations.get pour vérifier si la configuration de vidéo à la demande a été créée. Si la réponse contient "done: false", répétez la commande jusqu'à ce qu'elle contienne "done: true".

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • PROJECT_NUMBER: numéro de votre projet Google Cloud celui-ci se trouve dans le champ Numéro du projet des paramètres IAM page
  • LOCATION: emplacement des données utilisez l'une des régions disponibles.
    Afficher les lieux
    • us-central1
    • us-east1
    • us-west1
    • asia-east1
    • asia-south1
    • asia-southeast1
    • europe-west1
    • southamerica-east1
  • OPERATION_ID: identifiant de l'opération.

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

{
  "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"
  }
}

Assurez-vous que l'état est défini sur READY. Si ce n'est pas le cas, attendez quelques secondes à nouveau la demande.

Pour en savoir plus sur les configurations de vidéo à la demande, consultez Créer et gérer une configuration de vidéo à la demande

Précédent
Aperçu
Suivant
Préparer votre application cliente à utiliser Google Ad Manager