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 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.