此页面由 Cloud Translation API 翻译。

高效管理数据

许多 Google Ads 应用的核心功能是检索帐号数据，以用于数据分析、客户查询和政策合规性检查等用例。在提取数据时，您应该优化使用情况，以免 Google 服务器过载或速率受限。如需了解详情，请参阅有关速率限制和维护最新的联系电子邮件地址的指南。

缓存数据

您应该将从 API 服务器获取的实体详情缓存在本地数据库中，而不是在每次需要数据时都调用服务器，尤其是对于频繁访问或更改不常的实体。请尽可能使用 change-event 和 change-status 来检测自上次同步结果以来哪些对象发生了更改。

优化生成报表的频率

Google Ads 围绕数据新鲜度和数据更新频率发布了相关指南。您应根据本指南确定提取报告的频率。

如果您需要定期更新帐号，建议您将此类帐号的数量限制在一小部分（例如，仅限前 20 个 Google Ads 帐号）。其余数据可以以较低的频率更新，例如每天一次或两次。

优化报告大小

您的应用应提取大批量数据，而不是生成大量小型报告。影响此选择的一个因素是帐号限制。

例如，请考虑以下代码，它可提取特定广告组的统计信息并更新统计信息数据库表：

  List<long> adGroupIds = FetchAdGroupIdsFromLocalDatabase();

  foreach (long adGroupId in adGroupIds)
  {
    string query = "SELECT ad_group.id, ad_group.name, metrics.clicks, " +
        "metrics.cost_micros, metrics.impressions, segments.date FROM " +
        "ad_group WHERE segments.date DURING LAST_7_DAYS AND " +
        "ad_group.id = ${adGroupId}";
    List<GoogleAdsRow> rows = RunGoogleAdsReport(customerId, query);
    InsertRowsIntoStatsTable(adGroupId, rows);
  }

此代码适合小型测试帐号。但是，Google Ads 支持每个广告系列最多包含 20,000 个广告组，每个帐号最多支持 10,000 个广告系列。因此，如果此代码针对大型 Google Ads 帐号运行，则可能会使 Google Ads API 服务器过载，从而导致速率限制和限制。

更好的方法是生成单个报告，并在本地进行处理。我们展示了使用内存映射的一种方法。

  Hashset<long> adGroupIds = FetchAdGroupIdsFromLocalDatabase();

  string query = "SELECT ad_group.id, ad_group.name, metrics.clicks, " +
      "metrics.cost_micros, metrics.impressions, segments.date FROM " +
      "ad_group WHERE segments.date DURING LAST_7_DAYS";
  List<GoogleAdsRow> rows = RunGoogleAdsReport(customer_id, query);

  var memoryMap = new Dictionary<long, List<GoogleAdsRow>>();
  for each (GoogleAdsRow row in rows)
  {
    var adGroupId = row.AdGroup.Id;

    if (adGroupIds.Contains(adGroupId))
    {
      CheckAndAddRowIntoMemoryMap(row, adGroupId, memoryMap);
    }
  }
  foreach (long adGroupId in memoryMap.Keys())
  {
    InsertRowsIntoStatsTable(adGroupId, rows);
  }

这会减少 Google Ads API 服务器的负载，因为要生成的报告数量会更少。

如果您发现报告太大而无法保存在内存中，还可以添加 LIMIT 子句，将查询分解为更小的组，如下所示：

SELECT
  ad_group.id,
  ad_group.name,
  metrics.clicks,
  metrics.cost_micros,
  metrics.impressions,
  segments.date
FROM ad_group
WHERE segments.date DURING LAST_7_DAYS
  AND ad_group.id IN (id1, id2, ...)
LIMIT 100000

标签是对实体进行分组并减少报告查询数量的另一种方式。请参阅标签指南了解详情。

优化抓取的内容

生成报告时，请注意查询中包含的列。请考虑以下示例，该示例安排每小时运行一次：

SELECT
  customer.id,
  customer.currency_code,
  campaign.id,
  campaign.name,
  ad_group.id,
  ad_group.name,
  ad_group_criterion.keyword.match_type,
  ad_group_criterion.keyword.text,
  ad_group_criterion.criterion_id,
  ad_group_criterion.quality_info.creative_quality_score,
  ad_group_criterion.system_serving_status,
  ad_group_criterion.negative,
  ad_group_criterion.quality_info.quality_score,
  ad_group_criterion.quality_info.search_predicted_ctr,
  ad_group_criterion.quality_info.post_click_quality_score,
  metrics.historical_landing_page_quality_score,
  metrics.search_click_share,
  metrics.historical_creative_quality_score,
  metrics.clicks,
  metrics.impressions
FROM keyword_view
WHERE segments.date DURING LAST_7_DAYS

只有 metrics.clicks 和 metrics.impressions 列可能会每小时变化。所有其他列的更新频率较低或根本不更新，因此，如果按小时提取这些列，效率会非常低下。您可以将这些值存储在本地数据库中，并运行 change-event 或 change-status 报告，以便每天下载一到两次更改。

在某些情况下，您可以通过应用适当的过滤条件来减少下载的行数。

清理未使用的账号

如果您的应用管理第三方广告主帐号，则您在开发应用时需要考虑到客户流失情况。您应该定期清理流程和数据存储区，以便为不再使用您的应用的客户移除帐号。清理未使用的 Google Ads 账号时，请牢记以下指南：

撤消客户向您的应用授予的管理其账号的授权。
停止对客户的 Google Ads 帐号进行 API 调用。这尤其适用于在无需用户干预的情况下运行的离线作业，例如 Cron 作业和数据流水线。
如果客户撤消了授权，您的应用应妥善处理这种情况，并避免向 Google 的 API 服务器发送无效的 API 调用。
如果客户已取消其 Google Ads 帐号，则您应该检测出来，并避免向 Google 的 API 服务器发送无效的 API 调用。
适当的一段时间后，从本地数据库中删除您从客户的 Google Ads 帐号下载的数据。

监控

速率限制