Préparer votre application cliente à utiliser Google Ad Manager

Sélectionnez la plate-forme cible

Sélectionnez la plate-forme cible de l'utilisateur final parmi les options suivantes:

HTML5 et Android iOS/tvOS et Roku

Collecter les informations requises pour vos applications clientes

Vous devez disposer des informations suivantes, qui sont nécessaires pour que Google Ad Manager puisse créer une session sur un élément de vidéo à la demande:

Champ	Description
projectNumber	Numéro de projet Google Cloud (PROJECT_NUMBER) utilisé pour créer des sessions pour lesquelles Ad Manager est activé. Vous pouvez également utiliser l'ID du projet.
region	Emplacement (LOCATION) que vous souhaitez que le SDK IMA utilise pour créer la session de vidéo à la demande.
vodConfigId	ID de configuration VOD utilisé pour enregistrer le flux de vidéo à la demande avec l'API Video Stitcher. Le code suivant indique le format du nom complet de la ressource de configuration: projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID L'ID de configuration VOD correspond à la dernière partie du nom complet (VOD_CONFIG_ID). N'oubliez pas que l'emplacement de la configuration doit se trouver au même emplacement que celui dans lequel vous créez la session de vidéo à la demande.
networkCode	Identifiant numérique (NETWORK_CODE) de votre réseau Ad Manager.
oAuthToken	Jeton OAuth de courte durée pour le compte de service avec le rôle Utilisateur d'assembleur vidéo. Consultez Générer des jetons OAuth de courte durée.

Table 1. Informations requises pour les sessions d'éléments VOD compatibles avec Ad Manager

Générer des jetons OAuth de courte durée à des fins de test

Pour générer un jeton OAuth de courte durée associé au compte de service avec le rôle Utilisateur d'assembleur vidéo, procédez comme suit:

1. Remplacez PATH_TO_YOUR_SERVICE_KEY par le chemin d'accès au fichier JSON que vous avez téléchargé sur votre ordinateur local.

   gcloud auth activate-service-account --key-file PATH_TO_YOUR_SERVICE_KEY
   

2. Récupérez le jeton de support OAuth 2.0 à partir du compte de service :

   gcloud auth print-access-token
   

Comme il s'agit d'un jeton de courte durée, vous devez le générer à nouveau régulièrement avec la commande gcloud auth print-access-token et envoyer les nouveaux jetons à vos applications clientes. Consultez la section suivante pour en savoir plus sur la création d'un service de production permettant de fournir des jetons de courte durée.

Important :Générer à nouveau un jeton OAuth prend du temps. Essayez de réutiliser autant que possible un jeton OAuth lorsque vous créez des sessions. Vous pouvez prolonger la durée de vie d'un jeton à l'aide de l'option --lifetime.

Créer un service pour fournir des informations à vos applications clientes

Créez un service pouvant fournir les informations requises à transmettre au client. Lorsque l'application demande à votre service des informations sur la lecture d'un élément de vidéo à la demande, le service doit renvoyer les informations décrites dans le Tableau 1.

En particulier, le service doit pouvoir fournir des jetons OAuth aux applications clientes de manière sécurisée. Configurez ce service à l'aide de deux comptes de service, l'un empruntant l'identité de l'autre. Un compte de service dispose du rôle Créateur de jetons de service et crée un jeton OAuth pour le compte de service doté du rôle Utilisateur d'assembleur vidéo. Exemple :

• Compte de service 1: il s'agit du compte de service de l'appelant. Ce compte dispose de l'autorisation Créateur de jetons de service sur le compte de service 2 et emprunte l'identité du compte de service 2 aux applications clientes.
• Compte de service 2: il s'agit du compte de service disposant de droits, qui dispose du rôle Utilisateur d'assembleur vidéo pour créer des sessions.

Pour savoir comment fournir un jeton OAuth à partir de votre service, y compris des exemples de code de bibliothèque cliente, consultez la section Créer un jeton d'accès de courte durée.