광고 유형

Google Ads에서는 텍스트, 이미지, 모바일 광고 등 다양한 광고 유형을 지원합니다. 이 가이드에서는 Google Ads를 사용하여 광고를 만들고, 가져오고, 보고하는 방법을 설명합니다. 사용할 수 있습니다 Google Ads에서 지원하는 모든 광고 유형에 대한 개요는 다음을 참고하세요. API 가이드

생성

스크립트는 newAd() 메서드 사용 AdGroup 인스턴스 지원되는 광고 유형의 빌더를 만드는 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;
  ...
}

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