Campagnes vidéo

Les scripts Google Ads vous permettent de gérer et de créer des rapports sur vos campagnes vidéo sur YouTube. 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 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 habituellement 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 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.

Le meilleur moyen d'utiliser des types de campagnes spécifiques est d'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. Les utilisateurs ont alors la possibilité de les passer au bout d'un certain temps. Les annonces Video Discovery s'affichent sur le Réseau Display et sur diverses pages YouTube. Elles ne sont diffusées que si un utilisateur clique activement sur la miniature de l'annonce en premier. Les annonces bumper durent 6 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 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. Vous devez spécifier un type de groupe d'annonces et un nom de groupe d'annonces lorsque vous créez un groupe d'annonces. 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 les campagnes VIDEO_ACTION uniquement)
  • NON_SKIPPABLE_INSTREAM_VIDEO_AD (pour les campagnes VIDEO_NON_SKIPPABLE uniquement)

Exemple :

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

Créer l'élément vidéo

Les annonces vidéo doivent généralement faire référence à un élément vidéo. Ce paramètre détermine la vidéo qui sera diffusée 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 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 l'outil 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(). Vous ne pouvez pas modifier ce paramètre via des scripts, mais vous pouvez le consulter.

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. Elle vous permet d'accéder aux sélecteurs et aux outils de création 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 des critères au niveau du compte et comprend 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, 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é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();
}