广告系列定位

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

创建

如需创建新的广告投放时间,您可以使用 CampaignaddAdSchedule 方法。下面这段代码为广告系列创建自定义的广告投放时间,即帐号所在时区每周六上午 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

您可以参阅 Google Ads API 地理位置定位文档,查看在添加地理位置定位时使用的 ID 列表。如需跟踪地理位置定位目标的效果,您可以搜索 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 提供的辅助方法。