Media reklamowe

Niektóre typy reklam, np. ImageAd i ResponsiveDisplayAd, zawierają obrazy i inne elementy multimedialne. Z tego przewodnika dowiesz się, jak przesyłać i wykonywać zapytania dotyczące multimediów 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();

Możesz też załadować obiekt blob obrazu 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żywać do tworzenia reklam HTML5. Prześlij pakiety multimedialne 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 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();

Wykonywanie zapytań o multimedia

O media każdego typu można wysyłać zapytania w skryptach Google Ads za pomocą MediaSelector. Użyj predykatu withCondition(condition) do filtrowania multimediów według nazwy, typu lub innych pól. Na przykład ten fragment kodu znajduje wszystkie obrazy na koncie:

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

Tworzenie reklam z multimediami

W naszym artykule o reklamach znajdziesz przykłady kodu tworzenia obsługiwanych reklam z załączonymi multimediami.