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 et interroger des médias à l'aide de scripts Google Ads.

Importation des images

Vous pouvez importer des images à l'aide de la classe ImageBuilder, qui accepte 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 pouvant être créé par des services tels que Drive ou URL Fetch.

L'extrait de code 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();

Le blob d'image peut également être chargé à partir de 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 éléments HTML5 qui peuvent servir à créer des annonces HTML5. Importez des kits média avec la classe MediaBundleBuilder, qui accepte un nom et des données de fichier. Comme pour les images, les données sont fournies en tant qu'objet d'échange de données Blob.

L'extrait de code suivant montre comment importer un kit mé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();

Interrogation d'éléments multimédias

Les médias de tous types peuvent être interrogés dans des scripts Google Ads à l'aide d'un MediaSelector. Utilisez le prédicat withCondition() pour filtrer les mé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 du contenu multimédia

Consultez notre article sur les annonces pour obtenir des exemples de code de création d'annonces compatibles avec un support multimédia.