Media reklamowe

Niektóre typy reklam, np. ImageAd i ResponsiveDisplayAd, zawierają obrazy i inne elementy multimedialne. Z tego przewodnika dowiesz się, jak przesyłać multimedia i wysyłać do nich zapytania za pomocą skryptów Google Ads.

Przesyłam obrazy

Obrazy można przesyłać za pomocą klasy ImageBuilder, która przyjmuje nazwę i dane obrazu. Dane są dostarczane jako obiekt wymiany danych Blob, który może być tworzony przez usługi takie jak Dysk lub Pobieranie adresu URL.

Ten fragment kodu pokazuje, jak przesłać obraz z zewnętrznego adresu URL:

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

Blob obrazu można też załadować z Dysku Google:

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

Przesyłanie pakietów kreacji multimedialnych

Pakiety multimediów to archiwa ZIP zawierające komponenty HTML5, których można używać do tworzenia reklam HTML5. Przesyłaj pakiety multimediów za pomocą klasy MediaBundleBuilder, która przyjmuje nazwę i dane pliku. Podobnie jak w przypadku obrazów, dane są dostarczane jako obiekt wymiany danych Blob.

Ten fragment kodu pokazuje, jak przesłać pakiet multimediów z zewnętrznego adresu URL:

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

Zapytanie o media

W skryptach Google Ads można wysyłać zapytania o wszystkie typy multimediów za pomocą MediaSelector. Za pomocą predykatu withCondition() możesz filtrować multimedia według nazwy, typu lub innych pól. Na przykład ten fragment zawiera wszystkie obrazy na koncie:

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

Tworzenie reklam z wykorzystaniem multimediów

W artykule na temat reklam znajdziesz przykłady kodu dotyczące tworzenia obsługiwanych reklam z dołączonymi multimediami.