本頁面由 Cloud Translation API 翻譯而成。

廣告活動指定

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 指令碼來指定或排除廣告活動的地區。

擷取

您可以使用廣告活動目標的 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 指令碼，將廣告活動指定為某個地點周圍的半徑 (鄰近範圍)。

擷取

您可以使用廣告活動的指定目標，透過 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 提供的輔助方法。