Supports publicitaires

Certains types d'annonces, tels que ImageAd et ResponsiveDisplayAd, contiennent des images et d'autres éléments multimédias. Ce guide explique comment importer des contenus multimédias et les interroger à l'aide de scripts Google Ads.

Importation des images

Les images peuvent être importées à l'aide de la classe ImageBuilder, qui prend un nom et des données d'image. Les données sont fournies sous la forme d'un objet d'échange de données Blob qui peut être créé par des services tels que Drive ou URL Fetch.

L'extrait suivant montre comment importer une image à partir d'une URL externe :

let imageUrl = "http://www.example.com/example.png";
let imageBlob = UrlFetchApp.fetch(imageUrl).getBlob();
let mediaOperation = AdsApp.adMedia().newImageBuilder()
    .withName("IMAGE_NAME")
    .withData(imageBlob)
    .build();

Vous pouvez également charger le blob d'image depuis Google Drive :

let imageFileId = "IMAGE_FILE_ID";
let imageBlob = DriveApp.getFileById(imageFileId).getBlob();
let mediaOperation = AdsApp.adMedia().newImageBuilder()
    .withName("IMAGE_NAME")
    .withData(imageBlob)
    .build();

Importer des kits média

Les kits média sont des archives ZIP contenant des composants HTML5, qui peuvent être utilisés pour créer des annonces HTML5. Importez des bundles de composants multimédias avec la classe MediaBundleBuilder, qui prend un nom et des données de fichier. Comme pour les images, les données sont fournies sous la forme d'un objet d'échange de données Blob.

L'extrait suivant montre comment importer un bundle multimédia à partir d'une URL externe :

let mediaBundleUrl = "http://www.example.com/example.zip";
let mediaBundleBlob = UrlFetchApp.fetch(mediaBundleUrl).getBlob();
let mediaOperation = AdsApp.adMedia().newMediaBundleBuilder()
    .withName("bundle name")
    .withData(mediaBundleBlob)
    .build();

Interroger les médias

Tous les types de supports peuvent être interrogés dans les scripts Google Ads à l'aide d'un MediaSelector. Utilisez le prédicat withCondition(condition) pour filtrer les contenus multimédias par nom, type ou d'autres champs. Par exemple, l'extrait suivant trouve toutes les images d'un compte :

let mediaIterator = AdsApp.adMedia().media()
    .withCondition("Type = IMAGE")
    .get();
while (mediaIterator.hasNext()) {
  let image = mediaIterator.next();
}

Créer des annonces avec des éléments multimédias

Consultez notre article sur les annonces pour obtenir des exemples de code permettant de créer des annonces compatibles avec des éléments multimédias associés.