Anzeigenmedien

Einige Anzeigentypen wie ImageAd und ResponsiveDisplayAd enthalten Bilder und andere Media-Elemente. 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, die einen Namen und Bilddaten akzeptiert. 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, die HTML5-Assets enthalten, mit denen HTML5-Anzeigen erstellt werden können. Laden Sie Media-Bundles mit der Klasse MediaBundleBuilder hoch, die einen Namen und Dateidaten akzeptiert. 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

Media aller Art können in Google Ads-Scripts mit einem MediaSelector abgefragt werden. Verwenden Sie das withCondition(condition)-Prädikat, um Medien nach Name, Typ oder anderen Feldern zu filtern. Mit dem folgenden Snippet werden beispielsweise 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

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