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 les concernant. Vous pouvez utiliser des scripts pour gérer vos 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 et des groupes d'annonces vidéo

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 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) {
  ...
}

Après avoir 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 diffèrent 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 acceptés dans chaque campagne. Plus précisément, les campagnes VIDEO_ACTION n'acceptent que le type d'annonce VIDEO_RESPONSIVE et les campagnes VIDEO_NON_SKIPPABLE n'acceptent que le type d'annonce NON_SKIPPABLE_INSTREAM_VIDEO_AD.

Le meilleur moyen d'effectuer des opérations sur des types de campagnes spécifiques est d'utiliser une clause withCondition dans votre sélecteur. Vous pouvez mettre à jour l'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
  • Annonces 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 au bout d'un certain temps. Les annonces Video Discovery sont diffusées sur le Réseau Display et sur différentes pages YouTube. Elles ne sont lues que si l'utilisateur clique d'abord sur la miniature de l'annonce. Les annonces bumper durent jusqu'à six secondes. 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 pouvez créer un groupe d'annonces vidéo via la méthode newVideoAdGroupBuilder() d'une campagne vidéo. Vous devez spécifier un type et un nom de groupe d'annonces lors de sa création. 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éé:

  • TRUE_VIEW_IN_STREAM
  • TRUE_VIEW_IN_DISPLAY
  • BUMPER
  • VIDEO_RESPONSIVE (pour VIDEO_ACTION campagnes uniquement)
  • NON_SKIPPABLE_INSTREAM_VIDEO_AD (pour VIDEO_NON_SKIPPABLE campagnes uniquement)

Exemple :

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

Créer l'asset vidéo

Les annonces vidéo doivent généralement référencer un asset vidéo. Celui-ci détermine la vidéo qui sera lue pour l'annonce. Vous ne pouvez pas mettre en ligne de vidéo à l'aide de scripts, mais vous pouvez associer une vidéo YouTube existante que vous avez déjà mise en ligne 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 compilateur correspondant au type de groupe d'annonces (enchaîné 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. L'élément VideoCampaignTargeting représente tout ciblage effectué au niveau du compte pour les campagnes vidéo en général et est accessible via AdsApp.videoCampaignTargeting(). Vous ne pouvez pas le modifier à l'aide de scripts, mais vous pouvez l'afficher.

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() au niveau de la campagne ou du groupe d'annonces. Elle permet d'accéder aux sélecteurs et aux outils de création pour les 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 et 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 pour chaque valeur possible d'âge et de genre 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 également réintégrer 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();
}