广告系列定位

借助 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"
  }
});

请注意，系统不会验证地址是否实际位于给定的纬度和经度。此地址除了更改 Campaign Management 界面中显示的内容之外，没有任何用途。

移除

您可以使用接近目标的 remove 方法移除该目标。

平台

您可以使用广告系列定位条件的 platforms 方法来检索广告系列所定位到的平台列表。由于 Google Ads 广告系列定位到所有平台（桌面设备、移动设备和平板电脑），因此您无法添加或移除 Platform 条件。此定位条件最常见的用途是设置广告系列的设备出价调整：

campaign.targeting()
    .platforms()
    .mobile()
    .get()
    .next().
    setBidModifier(1.2);

平台 ID 在广告系列之间共享，并且具有 Google Ads API 平台附录中指定的预定义值。在解析报告时，这些 ID 会很有用。直接选择条件时，您可以使用 PlatformSelector 提供的辅助方法。