Anzeigenmedien

Einige Anzeigentypen wie ImageAd und ResponsiveDisplayAd, Bilder und andere Medienelemente enthalten. In diesem Leitfaden wird beschrieben, wie Sie Medien mithilfe von Google Ads-Skripts hochladen und abfragen.

Bilder hochladen

Bilder können mit der ImageBuilder -Klasse, die einen Namen und Bilddaten benötigt. Die Daten werden als Blob-Datenaustauschobjekt bereitgestellt, das mit Diensten wie Drive oder URL-Abruf erstellt werden kann.

Mit dem folgenden Snippet wird ein Bild von einer externen URL hochgeladen:

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

Alternativ kann das Bild-Blob-Objekt aus Google Drive hochgeladen werden:

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

MediaBundles hochladen

Media-Bundles sind ZIP-Archive, die HTML5-Assets enthalten, mit denen HTML5-Anzeigen erstellt werden können. Lade Medienpakete mit der Klasse MediaBundleBuilder hoch. Sie nimmt einen Namen und Dateidaten an. Wie bei Bildern werden die Daten als Blob-Datenaustauschobjekt bereitgestellt.

Mit dem folgenden Snippet wird ein MediaBundle von einer externen URL hochgeladen:

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

Medien abfragen

In Google Ads-Skripts können Medien jeden Typs mithilfe eines MediaSelector Mit dem Prädikat withCondition() können Sie Medien nach Name, Typ oder anderen Feldern filtern. Beispiel: Der Parameter Mit dem folgenden Snippet werden alle Bilder in einem Konto gefunden:

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

Anzeigen mit Medien erstellen

Code zum Einfügen des Codes finden Sie im Hilfeartikel zu Google Ads. Beispiele für die Erstellung unterstützter Anzeigen mit angehängten Medien