광고 미디어

ImageAd 및 ResponsiveDisplayAd와 같은 일부 광고 유형에는 이미지 및 기타 미디어 요소가 포함됩니다. 이 가이드에서는 Google Ads 스크립트를 사용하여 미디어를 업로드하고 쿼리하는 방법을 설명합니다.

이미지 업로드

이름과 이미지 데이터를 사용하는 ImageBuilder 클래스를 사용하여 이미지를 업로드할 수 있습니다. 데이터는 Drive 또는 URL 가져오기와 같은 서비스에서 만들 수 있는 Blob 데이터 교환 객체로 제공됩니다.

다음 스니펫은 외부 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();

또는 Google Drive에서 이미지 blob을 로드할 수 있습니다.

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

미디어 번들 업로드

미디어 번들은 HTML5 애셋이 포함된 ZIP 보관 파일로, HTML5 광고를 만드는 데 사용할 수 있습니다. 이름과 파일 데이터를 사용하는 MediaBundleBuilder 클래스로 미디어 번들을 업로드합니다. 이미지와 마찬가지로 데이터는 Blob 데이터 교환 객체로 제공됩니다.

다음 스니펫은 외부 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();

미디어 쿼리

모든 유형의 미디어는 MediaSelector를 사용하여 Google Ads 스크립트에서 쿼리할 수 있습니다. withCondition(condition) 술어를 사용하여 이름, 유형 또는 기타 필드로 미디어를 필터링합니다. 예를 들어 다음 스니펫은 계정의 모든 이미지를 찾습니다.

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

미디어를 사용하여 광고 만들기

첨부된 미디어가 있는 지원되는 광고를 만드는 코드 예시는 광고 도움말을 참고하세요.