Supports publicitaires

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

Importation des images

Les images peuvent être importées à l'aide de l' ImageBuilder , qui accepte un nom et des données d'image. Les données sont fournies sous forme objet d'échange de données Blob pouvant être créés 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 kits média avec MediaBundleBuilder , qui accepte un nom et des données de fichier. Comme pour les images, les données sont fournies un 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();

Interroger des médias

Les médias de tous types peuvent être interrogés dans les scripts Google Ads à l'aide d'un MediaSelector Utilisez les withCondition() prédicat pour filtrer les contenus multimédias par nom, type ou d'autres champs. Par exemple, L'extrait de code 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 médias

Consultez notre article sur les annonces pour obtenir du code. Exemples de création d'annonces compatibles avec des éléments multimédias associés