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. L'API Video Stitcher enregistre cette configuration dans 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, accédez à 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 à la balise (par exemple, ajoutez &vid_d=1800 à la fin pour un élément VOD de 30 minutes).
    • Modifiez le paramètre output=vast pour qu'il soit 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: votre Google Cloud numéro de projet, qui se trouve dans le champ Project number (Numéro de projet) sur la page IAM Settings (Paramètres IAM)
  • LOCATION: emplacement dans lequel créer votre configuration VOD. Utilisez l'une des régions disponibles.
    Afficher les emplacements
    • 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 des annonces récupérées à partir des serveurs d'annonces. Pour l'intégration d'Ad Manager, il doit s'agir d'un tag d'annonce vidéo Ad Manager valide. Pour obtenir un tag d'emplacement publicitaire valide, suivez les étapes de 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 les Paramètres généraux du compte é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 une opération de longue durée (LRO) que vous pouvez interroger pour suivre la progression. Copiez le OPERATION_ID renvoyé, qui est la dernière partie du champ name, pour l'utiliser dans la section suivante.

Vérifier le résultat

Utilisez la méthode projects.locations.operations.get pour vérifier si la configuration VOD 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: votre Google Cloud numéro de projet, qui se trouve dans le champ Project number (Numéro de projet) sur la page IAM Settings (Paramètres IAM)
  • LOCATION: emplacement des données. Utilisez l'une des régions disponibles.
    Afficher les emplacements
    • 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, patientez quelques secondes, puis renvoyez la requête.

Pour en savoir plus sur les configurations VOD, consultez Créer et gérer une configuration VOD.

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