您可以使用 Google Ads 指令碼,處理帳戶中的廣告活動層級指定目標設定。支援廣告時段、指定和排除的地區、指定鄰近地區和平台。本指南說明如何使用廣告活動目標。
廣告時段
廣告時段可讓您控管廣告的放送時間。
擷取
您可以使用廣告活動目標的 adSchedules
方法,擷取廣告活動的廣告時段。下列程式碼片段說明如何擷取廣告活動的所有 AdSchedule
條件清單:
const campaign = AdsApp.campaigns()
.withCondition("campaign.name = 'My campaign'")
.get()
.next();
const adSchedules = campaign.targeting().adSchedules().get();
for (const adSchedule of adSchedules) {
// Process your ad schedule.
...
}
根據預設,廣告活動會持續放送,因此如果沒有為廣告活動設定自訂廣告時段,就不會收到任何廣告時段。
更新
擷取廣告時段後,您可以直接修改其屬性;舉例來說,您可以按照下列方式更新廣告時段的出價調整係數:
adSchedule.setBidModifier(1.1);
建立
如要建立新的廣告時段,可以使用 Campaign
的 addAdSchedule
方法。以下程式碼片段會為廣告活動建立自訂廣告排程,在帳戶時區的每週六上午 7 點到 11 點放送廣告,並將出價調整係數設為 1.1。
campaign.addAdSchedule({
dayOfWeek: "SATURDAY",
startHour: 7,
startMinute: 0,
endHour: 11,
endMinute: 0,
bidModifier: 1.1
});
如要進一步瞭解每個參數允許的值,以及建立廣告時段時應注意的其他限制,請參閱我們的說明文件。
移除
您可以使用 remove
方法移除廣告時段。如要重設廣告活動的自訂廣告時段,請按照下列步驟刪除所有自訂廣告時段:
const adSchedules = campaign.adSchedules().get();
for (const adSchedule of adSchedules) {
adSchedule.remove();
}
位置
您也可以使用 Google Ads 指令碼,為廣告活動指定或排除地點。
擷取
您可以使用廣告活動 targets 的 targetedLocations
方法,擷取指定地區清單。您可以使用 excludedLocations
方法擷取排除位置。下列程式碼片段會選取上個月獲得超過 100 次曝光的所有指定位置。
const locations = AdsApp.targeting()
.targetedLocations()
.withCondition("metrics.impressions > 100")
.forDateRange("LAST_MONTH")
.orderBy("metrics.clicks DESC")
.get();
for (const location of locations) {
// Process the campaign target here.
...
}
如果廣告活動設為在所有國家/地區放送,您會看到空白的位置清單。
更新
擷取地點後,您可以直接修改地點的屬性。舉例來說,您可以按照下列方式更新地點的出價調節係數:
location.setBidModifier(1.1);
建立
您可以使用廣告活動的 addLocation
方法,在廣告活動中建立指定地區。同樣地,您可以使用 excludeLocation
方法排除地區。下列程式碼片段會以美國的廣告活動為目標,並將出價調整係數設為 1.15,同時排除紐約市。
campaign.addLocation(2840, 1.15); // United States
campaign.excludeLocation(1023191); // New York city
如需新增指定地區時可使用的 ID 清單,請參閱 Google Ads API 指定地理區域說明文件。如要追蹤地點目標的成效,請搜尋 location_view
報表資源。
移除
您可以使用 remove
方法移除位置目標。
鄰近區域
您可以使用 Google Ads 指令碼,將廣告活動指定至某個地點周圍的半徑範圍 (鄰近地區)。
擷取
您可以使用廣告活動 targets 的 targetedProximities
方法,擷取指定鄰近地區的清單。下列程式碼片段會選取上個月曝光次數超過 100 次的所有目標鄰近地區。
const proximities = AdsApp.targeting()
.targetedProximities()
.withCondition("metrics.impressions > 100")
.forDateRange("LAST_MONTH")
.orderBy("metrics.clicks DESC")
.get();
for (const proximity of proximities) {
...
}
建立
您可以使用廣告活動的 addProximity
方法,為廣告活動建立鄰近地區目標。下列程式碼片段會將廣告活動指定至座標 (37.423021, -122.083739) 周圍 20 公里的範圍。
campaign.addProximity(37.423021, -122.083739, 20, "KILOMETERS");
您也可以使用這個方法,建立具有出價調整幅和地址的相同鄰近地區目標:
campaign.addProximity(37.423021, -122.083739, 20, "KILOMETERS", {
bidModifier: 1.15,
address: {
streetAddress: "1600 Amphitheatre Parkway",
cityName: "Mountain View",
provinceName: "California",
provinceCode: "CA",
postalCode: "94043",
countryCode: "US"
}
});
請注意,系統不會驗證地址是否確實屬於指定經緯度。這個地址除了變更廣告活動管理介面中顯示的內容外,沒有其他用途。
移除
您可以使用鄰近目標的 remove
方法移除目標。
平台
您可以使用廣告活動目標的 platforms
方法,擷取廣告活動指定的平台清單。由於 Google Ads 廣告活動會指定所有平台 (電腦、行動裝置和平板電腦),因此您無法新增或移除Platform
條件。這項指定條件最常見的用途是設定廣告活動的裝置出價調整幅度:
campaign.targeting()
.platforms()
.mobile()
.get()
.next().
setBidModifier(1.2);
平台 ID 會在廣告活動之間共用,且具有預先定義的值,如Google Ads API 平台附錄中所述。剖析報表時,這些 ID 可能會派上用場。直接選取條件時,可以使用 PlatformSelector
提供的輔助方法。