生成 Google Ads 附加链接报表

新版 Search Ads 360 Reporting API 现已发布。这一新 API 提供可以更灵活地生成自定义报告，并将数据整合到您的报告应用程序中和进程。详细了解如何迁移到和使用新版 Search Ads 360 报告 API。

您可以请求获取包含 Google Ads 附加链接指标的不同类型的报告：

细分后的 adGroup 或显示以下内容的“campaign”报告：广告组或广告系列中每个附加链接的点击次数、展示次数和其他数据。
conversion 或显示原始数据的visit报告有关单次访问和转化的数据，包括获得点击的所有附加链接的 ID 并归因于相应访问/转化
feedItem 报告显示符合以下条件的所有广告系列和广告组中每个附加链接的指标和配置详情：以及应用此限制条件

请求细分广告组或广告系列报告

查看广告组中每个附加链接的点击次数、展示次数和其他数据，或广告系列，请求获取 adGroup 或 campaign 报告然后添加其中一个附加链接细分列，例如sitelinkDisplayText。

示例请求

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "campaign",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "sitelinkDisplayText" },
    { "columnName": "feedItemId" },
    { "columnName": "clicks" },
    { "columnName": "clicksWithFeedItemShowing" },
    { "columnName": "adWordsConversions" }
  ],
  "timeRange" : {
    "startDate" : "2014-07-21",
    "endDate" : "2014-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}

示例报告

以下是按 sitelinkDisplayText 细分的 CSV 格式的 campaign 报告示例：

account,campaign,sitelinkDisplayText,feedItemId,clicks,clicksWithFeedItemShowing,adWordsConversions
Hooper's - Google,Accessories,Summer 2014,33700000014504870,10895,12895,1157
Hooper's - Google,Accessories,$30 and Under,33700000014504871,10816,12816,1145
Hooper's - Google,Accessories,Tote Bags,33700000014504872,12790,12790,1147

请求获取包含附加链接数据的转化或访问报告

查看有关单次访问和转化的原始数据，包括任何附加链接的 ID 获得点击并归因于相应访问/转化的数据， conversion 或 visit 报告，并添加 feedItemId 列。

示例请求

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "conversion",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "floodlightActivity" },
    { "columnName": "feedType" },
    { "columnName": "feedItemId" }
  ],
  "timeRange" : {
    "startDate" : "2014-07-21",
    "endDate" : "2014-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}

示例报告

以下是 CSV 格式的 conversion 报告示例，其中包含一些 Feed 项列：

account,campaign,floodlightActivity,feedType,feedItemId
Hooper's - Google,Bedroom,Thank you page,Sitelink,33700000014504870
Hooper's - Google,Bedroom,Thank you page,Sitelink,33700000014504871
Hooper's - Google,Bedroom,Thank you page,Sitelink,33700000014504872

如需详细了解转化中的附加链接，请请求 FeedItem 报告。然后使用 feedItemId 查找转化或访问报告中引用的数据。

请求 feedItem 报告

查看所有广告系列和广告中每个站内链接的指标和配置详情请求 feedItem 报告。

示例请求

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "feedItem",
  "columns": [
     { "columnName": "feedItemId" },
     { "columnName": "sitelinkDisplayText" },
     { "columnName": "sitelinkDescription1" },
     { "columnName": "sitelinkDescription2" },
     { "columnName": "sitelinkLandingPageUrl" },
     { "columnName": "clicks" },
     { "columnName": "clicksWithFeedItemShowing" },
     { "columnName": "dfaRevenue" }
  ],
  "timeRange" : {
    "startDate" : "2014-07-21",
    "endDate" : "2014-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}

示例报告

以下是 CSV 格式的 feedItem 报告示例：

feedItemId,sitelinkDisplayText,sitelinkDescription1,sitelinkDescription2,sitelinkLandingPageUrl,clicks,clicksWithFeedItemShowing,dfaRevenue
33700000014504870,Summer 2014,,,http://www.hoopers.com/summer2012,10895,12895,141653.25421900
33700000014504871,$30 and Under,,,http://www.hoopers.com/sortby/lowprice,10816,12816,143600.27534400
33700000014504872,Tote Bags,,,http://www.hoopers.com/tote,12790,12790,140178.19750400