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 中含有「折扣銷售額」的所有延展型文字廣告擷取統計資料:
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;
...
}
如要進一步瞭解指令碼中的報表,請參閱報表指南。