生成 Google Ads 附加链接报表

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

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

  • 细分的 adGroupcampaign 报表,显示广告组或广告系列中每个附加链接的点击次数、展示次数和其他数据。

  • conversionvisit 报告,显示有关每次访问和转化的原始数据,包括获得点击并归因于相应访问/转化的所有附加链接的 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
}
    

示例报告

下面是一个 CSV 格式的 campaign 报告示例,按 sitelinkDisplayText 细分:

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