광고 미디어

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 광고를 만드는 데 사용할 수 있는 HTML5 애셋이 포함된 ZIP 보관 파일입니다. 이름과 파일 데이터를 사용하는 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();

미디어 쿼리

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

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

미디어로 광고 만들기

미디어를 첨부하여 지원되는 광고를 만드는 코드 예제는 광고 도움말을 참조하세요.