廣告類型

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();

檢查

您可以立即從 Ad 取得與所有廣告類型相關的部分資訊，例如廣告 ID 和核准狀態。此外，任何廣告都可以暫停、啟用或移除。

如要存取特定廣告類型的欄位 (例如延展型文字廣告的說明)，請使用 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.expanded_text_ad.headline_part1) 之外，ad_group_ad 檢視畫面也可以用來查詢特定類型的廣告欄位。下列程式碼片段說明如何擷取所有擴充文字廣告的統計資料，這些廣告的標題 1 中含有「Discount Sales」：

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

如要進一步瞭解如何在指令碼中製作報表，請參閱報表指南。