广告系列定位

您可以使用 AdWords 脚本在帐户中进行广告系列级别的定位设置,支持的定位条件包括广告投放时间、指定和排除的地理位置、指定邻近区域和平台等。本指南总结了如何设置广告系列定位条件。

广告投放时间

广告投放时间让您可以自定义要投放广告的时间。

检索和更新广告投放时间

您可以使用广告系列定位条件adSchedules 方法来检索广告系列的投放时间。 以下代码段展示了如何检索某个广告系列的所有 AdSchedule 条件:

var campaign = AdWordsApp.campaigns()
    .withCondition("CampaignName = 'My campaign'")
    .get()
    .next();

var adSchedules = campaign.targeting().adSchedules().get();
while (adSchedules.hasNext()) {
  var adSchedule = adSchedules.next();

  // Process your ad schedule.
  …
}

默认情况下,广告系列会在所有时候都投放,因此如果您没有为广告系列设置过自定义的广告投放时间,系统就不会返回任何广告投放时间。

在检索广告投放时间之后,您可以直接修改其属性;例如,您可以按如下所示更新广告投放时间的出价系数:

adSchedule.setBidModifier(1.1);

安排广告投放时间

要安排新的广告投放时间,您可以使用广告系列addAdSchedule 方法。以下代码段为广告系列安排了一个自定义的广告投放时间,即帐户所在时区的每周六上午 7 点至 11 点,出价系数为 1.1。

campaign.addAdSchedule({
   dayOfWeek: "SATURDAY",
   startHour: 7,
   startMinute: 0,
   endHour: 11,
   endMinute: 0,
   bidModifier: 1.1
 });

请参阅我们的文档,详细了解每个参数允许哪些值,以及在安排广告投放时间时需要注意的其他限制。

删除广告投放时间

您可以使用 remove 方法删除广告投放时间。要重置广告系列的自定义广告投放时间,您可以删除它所有的自定义广告投放时间,如下所示:

var adSchedules = campaign.adSchedules().get();
while (adSchedules.hasNext()) {
  var adSchedule = adSchedules.next();
  adSchedule.remove();
}

地理位置

您可以使用 AdWords 脚本为广告系列指定或排除地理位置

检索和更新指定地理位置

您可以使用广告系列定位条件targetedLocations 方法来检索指定地理位置的列表。 还可以使用 excludedLocations 方法来检索排除的地理位置。以下代码段选择了所有在上个月获得 100 次以上展示的指定地理位置。

var locationSelector = AdWordsApp.targeting()
    .locations()
    .withCondition("Impressions > 100")
    .forDateRange("LAST_MONTH")
    .orderBy("Clicks DESC");

 var locationIterator = locationSelector.get();
 while (locationIterator.hasNext()) {
   var location = locationIterator.next();

   // Process the campaign target here.
   ...
 }

如果您已将广告系列设置为在所有国家和地区投放,则系统将返回一个空的地理位置列表。

在检索了地理位置后,您可以直接修改其属性。例如,您可以更新地理位置的出价系数,如下所示:

location.setBidModifier(1.1);

您可以使用 remove 方法删除地理位置定位。

创建地理位置定位

您可以使用广告系列的 addLocation 方法为其创建地理位置定位。同样,您还可以使用 excludeLocation 方法来排除某个地理位置。以下代码段将广告系列定位到美国,出价系数为 1.15,同时排除了纽约市。

campaign.addLocation(2840, 1.15);     // United States
campaign.excludeLocation(1023191);    // New York city

您可以参考“AdWords API 地理位置定位”文档,查看在添加地理位置定位时要使用的 ID 列表。要跟踪地理位置定位的效果,可以运行广告系列地理位置定位报告

邻近区域

您可以使用 AdWords 脚本将广告系列定位到某个地理位置周围的半径区域(邻近区域)。

检索和更新邻近区域

您可以使用广告系列定位条件targetedProximities 方法来检索指定邻近区域的列表。以下代码段会选择所有在上个月获得 100 次以上展示的指定邻近区域。

var proximitySelector = AdWordsApp.targeting()
    .targetedProximities()
    .withCondition("Impressions > 100")
    .forDateRange("LAST_MONTH")
    .orderBy("Clicks DESC");

var proximityIterator = proximitySelector.get();
while (proximityIterator.hasNext()) {
  var proximity = proximityIterator.next();
  …
}

您可以使用邻近区域定位的 remove 方法将其删除。

创建邻近区域定位

您可以使用广告系列的 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"
  }
});

请注意,系统不会验证地址是否确实属于给定的经纬度。除了更改显示在“广告系列管理”界面中的相关信息外,地址没有其他用途。

平台

您可以使用广告系列定位条件platforms 方法来检索广告系列所定位到的平台列表。由于 AdWords 广告系列定位于所有平台(桌面设备、移动设备和平板设备),因此您不能添加或删除平台条件。此定位条件最常见的用途是设置广告系列的设备出价调整,如下所示:

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

平台 ID 在广告系列之间共享,有预先定义的值,详见 AdWords API 平台的附录。这些 ID 在解析报告时可能会派上用场。直接选择定位条件时,可使用 PlatformSelector 提供的辅助方法。

发送以下问题的反馈:

此网页
AdWords Scripts
AdWords Scripts
需要帮助?请访问我们的支持页面