Media reklamowe

Niektóre typy reklam, np. ImageAd i ResponsiveDisplayAd, zawierają obrazy i inne elementy multimedialne. Z tego przewodnika dowiesz się, jak przesyłać zapytań o media za pomocą skryptów Google Ads.

Przesyłam obrazy

Obrazy można przesyłać za pomocą ImageBuilder class, która przyjmuje nazwę i dane obrazu. Dane są udostępniane w formie Blob obiekt wymiany danych, którego można użyć utworzone przez usługi takie jak Dysk lub 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ż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 multimedialnych

Pakiety kreacji multimedialnych to archiwa ZIP zawierające zasoby HTML5, których można używać do: tworzyć reklamy HTML5. Prześlij pakiety kreacji multimedialnych ze znakiem MediaBundleBuilder class, 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();

Zapytania o multimedia

Skrypty Google Ads mogą wysyłać zapytania o media każdego typu za pomocą funkcji MediaSelector Użyj predykatu withCondition(), aby filtrować treści 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 wykorzystaniem multimediów

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