광고 유형

Google Ads에서는 텍스트, 이미지, 모바일 광고 등 다양한 광고 유형을 지원합니다. 이 가이드에서는 Google Ads 스크립트를 사용하여 광고를 만들고, 가져오고, 보고하는 방법을 설명합니다. Google Ads에서 지원하는 모든 광고 유형에 관한 개요는 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;
  ...
}

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