出价效果概况

利用出价效果概况,您可以估算广告组、条件和广告系列在不同出价情形下的效果。然后便可依据这些信息调整和优化出价策略。

此 API 的出价效果概况服务能够预测以不同方式更改出价会对费用、展示次数和点击次数有何影响。这与 AdWords 界面中的出价模拟器类似。

适用情况

假设您有一个已投放数周的广告,其费用远超您的预期。

您想要测试一下,如果稍微降低出价可能会发生什么。您的广告获得的查看次数和点击次数会减少多少?广告能少花多少钱?反之,如果您的广告没有获得预期的展示次数和点击次数,您一定希望了解应该如何设置出价以解决该问题。

出价效果概况可帮助您研究这些情况。如果您获取出价效果概况,则可以了解您的广告在当初展示的那一时间段内,预计能获得多少观看次数、点击次数以及产生多少费用。

利用出价效果概况,您可以查看在当前出价水平下过去一周的效果统计信息,以及使用不同出价金额时在同一时间段内的模拟效果。

通过分析广告在过去原本可能取得怎样不同的效果,您可以就未来如何调整出价和广告系列级出价系数做出更加明智的决策。

要求

要使用出价效果概况,广告系列必须符合以下要求:

  • 您必须具有既定的条件、广告组或广告系列,才能为系统提供生成预测所依据的基准信息。
  • 必须已启用转化跟踪
  • 帐号不得是测试帐号。出价效果概况以过去的效果为依据;由于测试帐号不实际投放广告,因此它们没有效果历史记录。

此外,只会返回与广告系列的搜索网络部分相关的信息;出价效果概况无法处理展示广告网络数据。

发出请求

获取出价效果概况数据时,API 服务会返回一个 BidLandscape 对象,此对象中包含这些数据所对应的时间范围、广告系列、广告组或条件的相关信息。时间范围一定属于过去,因为出价效果概况预测的是:在同样的时间段和条件下,广告使用不同出价或广告系列级出价系数所能取得的效果。

BidLandscape 还包含了一系列效果概况点,这些点构成一个直方图,反映了在该时间范围内采用不同的出价或广告系列级移动设备出价系数时预计会达到的效果。

您可以通过 DataService 请求三种类型的出价和移动设备出价系数效果概况。您选择的效果概况取决于您要在哪一级别调整出价,是条件、广告组还是广告系列。get()query() 方法据此进行命名:

获取条件和广告组的出价效果概况

在下面的示例中,假设我们在条件级别设置出价;用于为广告组获取出价效果概况的过程与此类似。

获取出价效果概况的方式与进行任何其他查询的方式类似:选择所需的字段,设置谓词以将查询范围限定为仅查询您感兴趣的广告组或条件,然后进行 get()query() 调用以获取数据。

BidLandscapeLandscapePoint 参考文档列出了所有可过滤和可选择的有效字段。

无论您感兴趣的字段是在 BidLandscape 中还是在 LandscapePoint 中,都必须将该字段添加到相同的选择器或谓词中。请注意,BidModifierTotalLocalClicksTotalLocalCostTotalLocalImpressionsRequiredBudget 字段仅支持广告系列的移动设备出价系数效果概况请求。当返回数据时,这些字段会被自动置入 SOAP 和客户端库实现中的相应位置。对于每个在 BidLandscape 中返回的 LandscapePoint,都会填充 LandscapePoints 上的字段。

DataServiceInterface dataService =
    adWordsServices.get(session, DataServiceInterface.class);
Selector selector = new SelectorBuilder()
    .fields(
        "AdGroupId",
        "CriterionId",
        "StartDate",
        "EndDate",
        "Bid",
        "LocalClicks",
        "LocalCost",
        "LocalImpressions") // Include whichever fields interest you
    .equals("AdGroupId", adGroupId.toString())
    .build();
CriterionBidLandscapePage page =
    dataService.getCriterionBidLandscape(selector);

获取广告系列的移动设备出价系数效果概况

获取广告系列级移动设备出价系数效果概况,与在广告组/条件级别获取出价非常类似。对于每个在 BidLandscape 中返回的 LandscapePoint,都会填充 LandscapePoints 上的字段。有关哪些字段可选择和可过滤,请参阅 BidLandscapeLandscapePoint 的参考文档。无论字段是在 BidLandscape 中还是在 LandscapePoint 中,您都应该将它包含在同样的选择器或谓词中。

以下示例展示了如何获取广告系列级别的移动设备出价系数效果概况:

DataServiceInterface dataService =
    adWordsServices.get(session, DataServiceInterface.class);
Selector selector = new SelectorBuilder()
    .fields(
        "BidModifier",
        "CampaignId",
        "CriterionId",
        "StartDate",
        "EndDate",
        "LocalClicks",
        "LocalCost",
        "LocalImpressions",
        "TotalLocalImpressions",
        "RequiredBudget") // Include whichever fields interest you
    .equals("CampaignId", campaignId.toString())
    .build();
CriterionBidLandscapePage page =
    dataService.getCampaignCriterionBidLandscape(selector);

将结果分页

CriterionBidLandscapePage(由 [get|query]CriterionBidLandscape[get|query]CampaignCriterionBidLandscape 返回)和 AdGroupBidLandscapePage(由 [get|query]AdGroupBidLandscape 返回)的行为与其他页面类型不同。对于出价效果概况请求,您不应递增 paging.startIndex 并发出请求直到 paging.startIndex >= page.totalNumEntries,而应该:

  • 以每个响应中的内部效果概况点数量为增量来递增 paging.startIndex
  • 继续发出请求,直到最后一个响应中的内部效果概况点数量低于您在选择器中指定的 paging.numberResults(页面大小)。

以下示例演示了如何使用 Java 实现这一点。

selector.getPaging().setNumberResults(PAGE_SIZE); // Set to your desired
                                                  // page size.
int landscapePointsInLastResponse = 0;
int offset = 0;
do {
  // Offset by the number of landscape points, NOT the number
  // of entries (bid landscapes) in the last response.
  offset += landscapePointsInLastResponse;
  selector.getPaging().setStartIndex(offset);
  landscapePointsInLastResponse = 0;
  CriterionBidLandscapePage page = dataService
    .getCriterionBidLandscape(selector);
  if (page.getEntries() != null) {
    for (CriterionBidLandscape bidLandscape : page.getEntries()) {
      for (BidLandscapeLandscapePoint landscapePoint : bidLandscape
        .getLandscapePoints()) {
        // Process results...
        landscapePointsInLastResponse++;
      }
    }
  }
} while (landscapePointsInLastResponse >= PAGE_SIZE);

您可以在每个客户端库中查看完整示例。

了解结果

在结果中给出了相应级别的各种出价及预估效果。以下是您在发出上述某个请求时可能收到的 XML 响应示例。

<landscapePoints>
  <bid>
    <ComparableValue.Type>Money</ComparableValue.Type>
    <microAmount>990000</microAmount>
  </bid>
  <clicks>278000</clicks>
  <cost>
    <ComparableValue.Type>Money</ComparableValue.Type>
    <microAmount>14500000000</microAmount>
  </cost>
  <impressions>648000</impressions>
  <promotedImpressions>0</promotedImpressions>
</landscapePoints>

以上代表了可以从 LandscapePoints 返回的所有可能元素。promotedImpressions 值表示广告在展示时位于搜索页的“推荐”位置(顶部)的次数。

上面的 XML 代码段只显示一个 LandscapePoint,但每个 BidLandscape 都会有一系列这样的点,每个点都有不同的出价金额或移动设备出价系数,并提供根据出价或出价系数变化进行调整的相应统计信息。如何解读这些结果由您自己决定,但我们所提供的这些数据应该能为您提供有用的信息,让您了解调整出价和移动设备出价系数将会如何影响广告的效果。

资源

发送以下问题的反馈:

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