광고 유형

Google Ads는 텍스트, 이미지, 모바일 광고 등 다양한 광고 유형을 지원합니다. 이 가이드에서는 Google Ads 스크립트를 사용하여 광고를 만들고, 검색하고, 보고하는 방법을 설명합니다. Google Ads에서 지원하는 모든 광고 유형의 개요는 API 가이드를 참고하세요.

참고: 반응형 디스플레이 광고가 하나의 광고에서 여러 텍스트, 이미지, 동영상 애셋을 지원합니다. 기존 반응형 디스플레이 광고는 이러한 새로운 기능을 지원하지 않습니다. 신규 광고와 기존 광고는 평소와 같이 계속 게재되지만 반응형 디스플레이 광고를 가져오고 조작하는 API가 변경되었습니다. 기존 반응형 디스플레이 광고 처리를 참고하세요.

생성

스크립트는 AdGroup 인스턴스에서 newAd() 메서드를 사용하여 광고를 만들 수 있습니다. 이렇게 하면 지원되는 광고 유형의 빌더를 만드는 AdBuilderSpace가 반환됩니다.

다음 스니펫은 확장 텍스트 광고를 만드는 방법을 보여줍니다.

let adOperation = adGroup.newAd().expandedTextAdBuilder()
    .withHeadlinePart1("First headline part")
    .withHeadlinePart2("Second headline part")
    .withDescription("Ad description")
    .withFinalUrl("http://www.example.com")
    .withPath1("path1") // optional
    .withPath2("path2") // optional
    .build();

검사

모든 광고 유형과 연결된 일부 정보는 광고 ID 및 승인 상태와 같이 Ad에서 즉시 확인할 수 있습니다. 또한 모든 광고를 일시중지하거나 사용 설정하거나 삭제할 수 있습니다.

확장 텍스트 광고의 설명과 같은 광고 유형에 특정한 필드에 액세스하려면 asType() 메서드를 사용하여 AdViewSpace를 만듭니다. 이를 통해 유형별 메서드를 노출하는 확장 버전의 Ad에 액세스할 수 있습니다.

다음 스니펫은 모든 확장 텍스트 광고의 설명을 가져옵니다.

const iterator = AdsApp.ads().withCondition("Type = EXPANDED_TEXT_AD").get();
while (iterator.hasNext()) {
  let ad = iterator.next();
  let expandedTextAd = ad.asType().expandedTextAd();
  let description = expandedTextAd.getDescription();
}

Type = EXPANDED_TEXT_AD 조건은 반복자의 모든 광고가 확장 텍스트 광고임을 보장합니다. 잘못된 유형의 광고를 보려고 하면 스크립트 실행이 중지되는 오류가 발생하므로 광고 유형을 알 때만 유형별 필드를 보는 것이 중요합니다.

다음 스니펫은 Ad.isType() 메서드를 사용하여 광고가 올바른 유형인지 확인하는 방법을 보여줍니다.

if (ad.isType().expandedTextAd()) {
  let expandedTextAd = ad.asType().expandedTextAd();
  let headlinePart1 = expandedTextAd.getHeadlinePart1();
  let headlinePart2 = expandedTextAd.getHeadlinePart2();
}

보고

ad_group_ad 보기를 사용하여 ad_group_ad.expanded_text_ad.headline_part1과 같은 일반 통계 외에 유형별 광고 필드를 쿼리할 수도 있습니다. 다음 스니펫은 광고 제목 1에 '할인 판매'가 포함된 모든 확장 텍스트 광고의 통계를 가져오는 방법을 보여줍니다.

const results = AdsApp.search(
  "SELECT ad_group_ad.ad_group.id, " +
          "ad_group_ad.id, " +
          "ad_group_ad.expanded_text_ad.headline_part1, " +
          "ad_group_ad.expanded_text_ad.headline_part2, " +
          "metrics.clicks, " +
          "metrics.impressions, " +
          "metrics.cost" +
  "FROM ad_group_ad " +
  "WHERE ad_group_ad.expanded_text_ad.headline_part1 = 'Discount Sales' " +
    "AND segments.date DURING LAST_7_DAYS");

while (results.hasNext()) {
  let row = results.next();
  let headlinePart1 = row.adGroupAd.expandedTextAd.headlinePart1;
  let headlinePart2 = row.adGroupAd.expandedTextAd.headlinePart2;
  ...
}

스크립트의 보고에 관한 자세한 내용은 보고서 가이드를 참고하세요.