Supports publicitaires

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

Importation des images

Vous pouvez importer des images à l'aide de la classe ImageBuilder, qui prend un nom et des données d'image. Les données sont fournies en tant qu'objet d'échange de données Blob pouvant être créé par des services tels que Drive ou Récupération d'URL.

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();

Vous pouvez également charger le blob de l'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 éléments HTML5, qui peuvent être utilisés pour créer des annonces HTML5. Importez des bundles 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 en tant qu'objet d'échange de données Blob.

L'extrait de code suivant montre comment importer un lot 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 des contenus multimédias

Vous pouvez interroger tous les types de contenus multimédias dans les scripts Google Ads à l'aide d'un MediaSelector. Utilisez le prédicat withCondition() pour filtrer les contenus multimédias par nom, type ou autres champs. Par exemple, l'extrait de code suivant recherche 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 contenus multimédias

Consultez notre article sur les annonces pour obtenir des exemples de code de création d'annonces compatibles avec des éléments multimédias joints.