Campagnes vidéo

Les scripts Google Ads vous permettent de gérer vos campagnes vidéo YouTube et de générer des rapports les concernant de vos campagnes. 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 le videoCampaigns d'une objet AdsApp. Toi 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 en procédant comme suit:

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 grâce aux videoAds() méthode de VideoAdGroup Vous pouvez créer des annonces vidéo à l'aide du newVideoAd() de VideoAdGroup.

Formats d'annonces vidéo

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

Certaines campagnes vidéo utilisent des sous-types qui limitent les types d'annonces prises en charge dans cette campagne. Plus précisément, VIDEO_ACTION campagnes uniquement sont compatibles 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 de gérer des types de campagnes spécifiques est d'utiliser 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 InStream peuvent être diffusées avant, pendant ou après d'autres vidéos, permet aux utilisateurs d'ignorer l'annonce au bout d'un certain délai. Les annonces Video Discovery sont diffusées sur le Réseau Display et différentes pages YouTube. Elle ne sera lue que si un utilisateur clique d'abord activement sur la miniature de l'annonce. Les annonces bumper durent jusqu'à six secondes Elles peuvent être diffusées sur des vidéos YouTube, ou sur des sites et applications partenaires sur le Réseau Display. Pour des informations complètes sur chacun de ces types d'annonces, consultez À propos de formats d'annonces vidéo.

Créer le groupe d'annonces

Pour créer un groupe d'annonces vidéo, newVideoAdGroupBuilder() d'une campagne vidéo. Vous devez spécifier un type de groupe d'annonces et une annonce le nom du groupe d'annonces lors de sa création. Le type de groupe d'annonces doit être l'un des suivantes et ne peuvent pas être modifiées 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 faire référence à un élément vidéo. Cela permet de déterminer quelle vidéo qui sera lu pour l'annonce. Vous ne pouvez pas mettre en ligne une 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, vous devez créer 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 l'outil de création correspondant au type de groupe d'annonces (en chaîne 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. La 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(). Ce ne peuvent pas être modifiés par le biais de scripts, mais peuvent être affichés.

L'autre type de ciblage vous permet de spécifier des critères pour les campagnes vidéo et vidéo individuellement. Vous pouvez y accéder à l'aide de la videoTargeting() sur la campagne ou le groupe d'annonces, et permet d'accéder sélecteurs et constructeurs de critères positifs et négatifs pour tous les types applicables à ce niveau de ciblage. La AdsApp.videoTargeting() permet également d'afficher les critères au niveau du compte. un ensemble de critères différent de AdsApp.videoCampaignTargeting(). J'aime 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 critères d'autres types de critères. Lorsqu'un groupe d'annonces est créé, les critères les valeurs d'âge et de genre sont créées automatiquement, et ce groupe d'annonces les cible toutes. Vous pouvez exclure une catégorie démographique en récupérant les données et appeler la méthode exclude() sur celle-ci, et vous pouvez réinclure une d'une catégorie démographique exclue en recherchant le ciblage et en appelant include()

Voici un exemple permettant d'exclure un critère de 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();
}