광고 유형

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;
  ...
}

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