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 les 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 collection videoCampaigns d'un objet AdsApp. Vous pouvez les récupérer comme vous le feriez normalement pour les campagnes dans les 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 méthode videoAds() de VideoAdGroup. Vous pouvez créer des annonces vidéo à l'aide de la méthode newVideoAd() de VideoAdGroup.

Formats d'annonces vidéo

Les formats d'annonces vidéo compatibles varient selon le 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 avec la 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 est d'utiliser une clause withCondition dans votre sélecteur. Vous pouvez mettre à jour 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. Les utilisateurs peuvent les ignorer après un certain temps. Les annonces vidéo 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. Elles peuvent être diffusées dans des vidéos YouTube, ou sur des sites et applications partenaires du Réseau Display. Pour en savoir plus 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 méthode newVideoAdGroupBuilder() d'une campagne vidéo. Lorsque vous créez un groupe d'annonces, vous devez spécifier son type et son nom. 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 élément vidéo. Cela détermine la vidéo qui sera lue 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 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éez 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 pertinent pour les campagnes vidéo. VideoCampaignTargeting représente tout ciblage effectué au niveau du compte pour les campagnes vidéo en général. Il est accessible à l'aide de AdsApp.videoCampaignTargeting(). Ce paramètre ne peut pas être modifié à l'aide de scripts, mais il 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 avec la méthode videoTargeting() sur la campagne ou le groupe d'annonces. Elle permet d'accéder aux sélecteurs et aux créateurs de critères positifs et négatifs pour tous les types applicables à ce niveau de ciblage. La méthode AdsApp.videoTargeting() permet également d'afficher les critères au niveau du compte. Elle inclut un ensemble de critères différent de AdsApp.videoCampaignTargeting(). Comme pour VideoCampaignTargeting, vous ne pouvez pas gérer ces critères avec des 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, genre) fonctionnent un peu différemment des autres types de critères. Lorsqu'un groupe d'annonces est créé, des critères sont automatiquement créés pour chaque valeur d'âge et de genre possible. 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() sur celui-ci. 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 genre 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();
}