Anzeigenmedien

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

Bilder hochladen

Bilder können mit der Klasse ImageBuilder hochgeladen werden. Dafür sind ein Name und Bilddaten erforderlich. Die Daten werden als Blob-Datenaustauschobjekt bereitgestellt, das von 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

Mediasets sind ZIP-Archive mit HTML5-Assets, mit denen HTML5-Anzeigen erstellt werden können. Laden Sie Mediasets mit der Klasse MediaBundleBuilder hoch, für die ein Name und Dateidaten erforderlich sind. Wie bei Bildern werden 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 mit einem MediaSelector Medien jedes Typs abgefragt werden. Verwenden Sie das Prädikat withCondition(), um Medien nach Name, Typ oder anderen Feldern zu filtern. Mit dem folgenden Snippet werden beispielsweise alle Bilder in einem Konto gesucht:

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

Anzeigen mit Medien erstellen

In unserem Artikel zu Anzeigen finden Sie einige Codebeispiele zum Erstellen unterstützter Anzeigen mit angehängten Medien.