生成广告系列和广告组目标报告

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

定位条件是根据搜索查询的地理位置、受众特征和其他特征来展示广告的条件。例如,广告客户可将广告系列中的广告定位为仅在纽约、波士顿和芝加哥展示。或者,广告客户可以针对特定广告受众群体成员提高搜索出价,从而提高向受众群体展示广告的可能性。

某些类型的定位条件只能应用于广告系列,而另一些类型的定位条件则只能应用于广告组。若要查看每个级别的可用目标,请参阅 campaignTargetadGroupTarget 报告的相关文档。

您可以请求显示特定类型定位条件的效果指标的报告。例如,如果广告客户将广告系列定位到特定地理位置,请在 campaignTarget 请求中包含 locationTargetName 列。检索生成的报告后,您就可以查看广告系列在每个定位到的地理位置的效果。

排除性定位条件

排除性定位条件可防止广告符合特定条件。 与定位条件类似,某些类型的排除性定位条件只能应用于广告系列,而其他类型的排除性定位条件只能应用于广告组。如需了解详情,请参阅 negativeCampaignTargetnegativeAdGroupTarget

您可以请求报告,以查看排除性定位条件用于排除广告的条件。例如,如果广告客户使用排除性定位条件来阻止广告系列在特定地理位置展示广告,请在 negativeCampaignTarget 请求中添加 locationTargetName 列。检索生成的报告后,您可以看到从广告系列中排除的地理位置列表。

示例请求

以下是针对不同类型的定位条件的请求示例:

生成广告系列中的地理位置定位目标报表

下面的异步请求示例会返回地理位置定位目标的点击次数、展示次数和其他数据(有关地理位置定位目标的报告仅适用于 Google Ads 广告系列)。Search Ads 360 支持多种类型的地理位置定位目标,例如地理位置定位目标邻近区域定位目标Google Ads 附加地址信息的半径定位条件。地理位置定位目标报表包含报告范围内应用的所有类型地理位置定位目标的数据。

示例请求

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "campaignTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "locationTargetName" },
    { "columnName": "clicks" },
    { "columnName": "impr" },
    { "columnName": "cost" },
    { "columnName": "dfaActions"}
  ],
  "timeRange" : {
    "startDate" : "2016-07-21",
    "endDate" : "2016-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
    

示例报告

下面是一个 campaignTarget 报告示例。该报告显示了指定“US”的地理位置定位条件、指定“37.4220041,-122.0862462”的邻近区域定位目标以及指定美国邮政编码 (90210) 的地理位置定位条件的效果:

account,campaign,locationTargetName,clicks,impr,cost,dfaActions
Hooper's - Google,Accessories,US,10895,12895,1255.07000000,1157
Hooper's - Google,Accessories,"100.0 miles around (37.4220041,-122.0862462)",10816,12816,1285.07000000,1145
Hooper's - Google,Accessories,90210,12790,12790,1124.06000000,1147
    

帐号中所有广告组的再营销目标

下面的异步请求示例会返回为特定 Google Ads 广告系列中的广告组定义的所有再营销目标的点击次数、展示次数和其他数据。

示例请求

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201", // Replace with your IDs
    "campaignId": "700000000058578" // Replace with your IDs
  },
  "reportType": "adGroupTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "adGroup" },
    { "columnName": "engineRemarketingList" },
    { "columnName": "clicks" },
    { "columnName": "impr" },
    { "columnName": "cost" },
    { "columnName": "dfaActions"}
  ],
  "timeRange" : {
    "startDate" : "2016-07-21",
    "endDate" : "2016-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
    

示例报告

下面是一个 adGroupTarget 报告示例。报告显示“配件”广告系列中的三个广告组定义了再营销目标。此外,还包含每个再营销目标的效果指标:

account,campaign,adGroup,engineRemarketingList,clicks,impr,cost,dfaActions
Hooper's - Google,Accessories,Summer 2016,Weekend Warriors,7707,26333,1255.07000000,3
Hooper's - Google,Accessories,$30 and Under,Email Subscribers,6992,29630,3170.18000000,8
Hooper's - Google,Accessories,Tote Bags,Repeat Buyers,4535,20504,1524.88000000,2
    

帐号中所有广告组的动态广告定位条件

动态广告定位条件可定义您想要使用动态搜索广告宣传的网站网页。(动态广告定位条件只能在 Google Ads 引擎帐号中使用,并且始终在特定广告组中创建。)Google 使用其搜索索引来确定客户的搜索何时与满足动态广告定位条件的任意网页相关。如果搜索查询与搜索查询相关,Google 会展示您在定位条件所属的广告组中定义的动态搜索广告。

下面的异步请求示例会返回为引擎帐号中的广告组定义的所有动态广告定位条件的点击次数、展示次数及其他数据。

示例请求

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "adGroupTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "adGroup" },
    { "columnName": "dynamicSearchAdsTargetConditions" },
    { "columnName": "dynamicSearchAdsTargetCoverage" },
    { "columnName": "clicks" },
    { "columnName": "impr" },
    { "columnName": "cost" },
    { "columnName": "dfaActions"}
  ],
  "timeRange" : {
    "startDate" : "2016-07-21",
    "endDate" : "2016-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
    

示例报告

下面是一个 adGroupTarget 报告示例。报告显示,“Google Stores”广告系列中的一个广告组定义了动态广告定位条件。此外,报告还包含目标的性能指标:

account,campaign,adGroup,dynamicSearchAdsTargetConditions,dynamicSearchAdsTargetCoverage,clicks,impr,cost,dfaActions
Hooper's - Google,Google Stores,Chargers,"AND(CATEGORY = ""Electronics"",CATEGORY = ""Accessories"")",4535,20504,1524.88000000,2
    

针对广告系列的排除性地理位置定位目标生成报表

以下示例异步请求会返回从引擎帐号的广告系列中排除的地理位置(有关排除性地理位置定位目标的报告仅适用于 Google Ads 广告系列)。排除性地理位置定位目标只能将地理位置定位目标用作条件(不能指定邻近区域定位目标半径范围定位条件)。 因此,针对排除性地理位置定位目标的报告仅包含从报告范围内的广告系列中排除的地理位置列表。

请注意,针对排除性目标报告的请求无需指定时间范围。负面报告始终会返回当前设置。例如,您无法请求显示上个季度正在使用的排除性目标值的报告。

示例请求

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "negativeCampaignTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "locationTargetName" }
  ],
  "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
    

示例报告

下面是一个 negativeCampaignTarget 报告示例。该报告显示,“重大开业 - 东北”广告系列排除了缅因州,而“重大开业 - 西部”广告系列排除了加利福尼亚州:

account,campaign,locationTargetName
Hooper's - Google,Grand openings - NE,US-ME
Hooper's - Google,Grand openings - West,US-CA