Niektóre typy reklam, np. ImageAd i ResponsiveDisplayAd, zawierają obrazy i inne elementy multimedialne. Z tego przewodnika dowiesz się, jak przesyłać multimedia i wykonywać zapytania za pomocą skryptów Google Ads.
Przesyłam obrazy
Obrazy można przesyłać za pomocą klasy ImageBuilder
, która pobiera nazwę i dane obrazu. Dane są udostępniane w postaci obiektu wymiany danych Blob
, który może być utworzony przez usługi takie jak Dysk czy pobranie 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();
Obraz blob może też zostać wczytany 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 kreacji multimedialnych to archiwa ZIP zawierające zasoby HTML5, których można użyć do tworzenia reklam HTML5.
Prześlij pakiety kreacji multimedialnych za pomocą klasy MediaBundleBuilder
, która przyjmuje nazwę i dane pliku. Tak jak w przypadku obrazów, dane są dostarczane jako obiekt wymiany danych Blob
.
Ten fragment kodu pokazuje, jak przesłać pakiet kreacji multimedialnych 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();
Wysyłanie zapytań o multimedia
Zapytania o media każdego typu można wysyłać w skryptach Google Ads za pomocą MediaSelector
.
Aby filtrować multimedia według nazwy, typu lub innych pól, użyj predykatu withCondition()
. Ten fragment kodu znajduje na przykład wszystkie obrazy na koncie:
let mediaIterator = AdsApp.adMedia().media()
.withCondition("Type = IMAGE")
.get();
while (mediaIterator.hasNext()) {
let image = mediaIterator.next();
}
Tworzenie reklam multimedialnych
Przykłady kodu tworzenia obsługiwanych reklam z dołączonymi multimediami znajdziesz w artykule o reklamach.