Campagnes vidéo

Les scripts Google Ads vous permettent de gérer vos campagnes vidéo basées sur YouTube et de générer des rapports à leur sujet. Vous pouvez utiliser des scripts pour gérer des campagnes vidéo existantes, créer et gérer des groupes d'annonces et des annonces, configurer le ciblage des campagnes et générer des rapports. Toutefois, vous ne pouvez pas utiliser de scripts pour créer des campagnes vidéo.

Récupérer des campagnes vidéo et des groupes d'annonces

Les campagnes vidéo sont disponibles via la videoCampaigns collection d'un AdsApp objet. Vous pouvez les récupérer comme vous le feriez normalement pour des campagnes dans des scripts :

const campaignName = "My first video campaign";

const campaignIterator = AdsApp.videoCampaigns()
    .withCondition(`campaign.name = "${campaignName}"`)
    .get();

for (const campaign of campaignIterator) {
  ...
}

Une fois que vous avez récupéré une campagne, vous pouvez obtenir ses groupes d'annonces de la même manière :

const adGroupIterator = campaign.videoAdGroups()
    .withCondition(`ad_group.name = "${adGroupName}"`)
    .get();

for (const adGroup of adGroupIterator) {
  ...
}

Vous pouvez également utiliser la méthode AdsApp.videoAdGroups() :

const adGroupIterator = AdsApp.videoAdGroups()
    .withCondition(`campaign.name = "${campaignName}" AND ad_group.name = "${adGroupName}")
    .get();

for (const adGroup of adGroupIterator) {
  ...
}

Créer des annonces vidéo

Les scripts Google Ads vous permettent de récupérer vos annonces vidéo à l'aide de la videoAds() méthode de VideoAdGroup. Vous pouvez créer des annonces vidéo à l'aide de la newVideoAd() méthode de VideoAdGroup.

Formats d'annonces vidéo

Les formats d'annonces vidéo compatibles varient en fonction du type de campagne vidéo. Pour vous assurer de sélectionner le bon type de campagne vidéo, ajoutez un appel withCondition sur AdvertisingChannelSubType.

Certaines campagnes vidéo comportent des sous-types qui limitent les types d'annonces compatibles dans cette campagne. Plus précisément, les campagnes VIDEO_ACTION ne sont compatibles qu'avec le type d'annonce VIDEO_RESPONSIVE, et les campagnes VIDEO_NON_SKIPPABLE ne sont compatibles qu'avec le type d'annonce NON_SKIPPABLE_INSTREAM_VIDEO_AD.

La meilleure façon d'opérer sur des types de campagnes spécifiques consiste à utiliser une clause withCondition dans votre sélecteur. Vous pouvez modifier le AdvertisingChannelSubType pour le type de campagne qui vous intéresse :

const campaignIterator = AdsApp.videoCampaigns()
  .withCondition("AdvertisingChannelSubType = VIDEO_ACTION")
  .get();

Les campagnes vidéo sans sous-type sont compatibles avec les formats d'annonces vidéo suivants :

  • TrueView InStream
  • Video Discovery TrueView
  • Bumper

Vous pouvez sélectionner ces campagnes à l'aide d'un withCondition :

const campaignIterator = AdsApp.videoCampaigns()
  .withCondition("AdvertisingChannelSubType = null")
  .get();

Les annonces vidéo InStream peuvent être diffusées avant, pendant ou après d'autres vidéos, ce qui permet aux utilisateurs de les ignorer après un délai spécifié. Les annonces Video Discovery s'affichent sur le Réseau Display et sur différentes pages YouTube. Elles ne sont diffusées que si un utilisateur clique activement sur la miniature de l'annonce. Les annonces bumper durent six secondes ou moins et peuvent être diffusées dans des vidéos YouTube, ou sur des sites et applications partenaires du Réseau Display. Pour obtenir des informations complètes sur chacun de ces types d'annonces, consultez À propos des formats d'annonces vidéo.

Créer le groupe d'annonces

Vous créez un groupe d'annonces vidéo à l'aide de la newVideoAdGroupBuilder() méthode d'une campagne vidéo. Vous devez spécifier un type et un nom de groupe d'annonces lorsque vous le créez. Le type de groupe d'annonces doit être l'un des suivants et ne peut pas être modifié une fois le groupe d'annonces créé :

  • VIDEO_BUMPER
  • VIDEO_EFFICIENT_REACH
  • VIDEO_NON_SKIPPABLE_IN_STREAM (pour les campagnes VIDEO_NON_SKIPPABLE uniquement)
  • VIDEO_RESPONSIVE (pour les campagnes VIDEO_ACTION uniquement)
  • VIDEO_TRUE_VIEW_IN_DISPLAY
  • VIDEO_TRUE_VIEW_IN_STREAM
  • YOUTUBE_AUDIO

Exemple :

const videoAdGroup =
    videoCampaign.newVideoAdGroupBuilder()
    .withAdGroupType("VIDEO_TRUE_VIEW_IN_STREAM")
    .withName("Video Ad Group")
    .build()
    .getResult();

Créer le composant vidéo

Les annonces vidéo doivent généralement faire référence à un composant vidéo. Cela détermine la vidéo qui sera diffusée pour l'annonce. Vous ne pouvez pas importer de vidéo à l'aide de scripts, mais vous pouvez associer une vidéo YouTube existante que vous avez déjà importée pour l'utiliser dans vos annonces. Pour ce faire, créez un Asset avec le YouTubeVideoAssetBuilder.

const assetOperation = AdsApp.adAsset().newYouTubeVideoAssetBuilder()
   .withName("name")
   // This is the ID in the URL for the YouTube video.
   .withYouTubeVideoId(youTubeVideoId)
   .build();
const videoAsset = assetOperation.getResult();

Créer l'annonce

Pour créer une annonce, utilisez la méthode de création correspondant au type de groupe d'annonces (enchaînée après newVideoAd()) :

Exemple :

const videoAd = videoAdGroup.newVideoAd()
    .inStreamAdBuilder()
    .withAdName("Video Ad")
    .withFinalUrl("http://www.example.com/video-ad")
    // Specify the video asset created in the last step.
    .withVideo(video)
    .build()
    .getResult();

Ciblage vidéo

Il existe deux types de ciblage pertinents pour les campagnes vidéo. Le VideoCampaignTargeting représente tout ciblage effectué au niveau du compte pour les campagnes vidéo en général, et est accessible à l'aide de AdsApp.videoCampaignTargeting(). Il ne peut pas être modifié à l'aide de scripts, mais peut être consulté.

L'autre type de ciblage vous permet de spécifier des critères pour les campagnes vidéo et les groupes d'annonces vidéo individuellement. Vous pouvez y accéder à l'aide de la méthode videoTargeting() sur la campagne ou le groupe d'annonces. Vous avez ainsi accès aux sélecteurs et aux créateurs pour les critères positifs et négatifs de tous les types applicables à ce niveau de ciblage. La méthode AdsApp.videoTargeting() permet également d'afficher les critères au niveau du compte et inclut un ensemble de critères différent de AdsApp.videoCampaignTargeting(). Comme pour VideoCampaignTargeting, vous ne pouvez pas gérer ces critères à l'aide de scripts.

Voici un exemple d'exclusion d'un emplacement spécifique dans une campagne :

videoCampaign.videoTargeting().newPlacementBuilder()
    .withUrl("http://www.example.com")
    .exclude();

Les critères démographiques (âge, sexe) fonctionnent un peu différemment des autres types de critères. Lorsqu'un groupe d'annonces est créé, les critères pour chaque valeur d'âge et de sexe possible sont créés automatiquement, et ce groupe d'annonces les cible tous. Vous pouvez exclure une catégorie démographique en récupérant le ciblage existant et en appelant la méthode exclude(). Vous pouvez réinclure une catégorie démographique exclue en recherchant le ciblage d'exclusion existant et en appelant include().

Voici un exemple d'exclusion d'un sexe spécifique d'un groupe d'annonces :

const videoGenderIterator = videoAdGroup.videoTargeting()
    .genders()
    .withCondition('GenderType = "GENDER_MALE"')
    .get();
if (videoGenderIterator.hasNext()) {
  const videoGender = videoGenderIterator.next();
  videoGender.exclude();
}