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

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

定位条件是系统根据地理位置、受众特征和受众特征展示广告的条件搜索查询的其他特征。例如，广告客户可以将某个广告系列的广告仅在纽约、波士顿和芝加哥展示。或者，广告客户可以提高来自特定广告受众群体成员的搜索，从而增加广告将向受众群体展示

某些类型的定位条件只能应用于广告系列而其他规则只能应用于广告组。要查看每个级别的可用定位条件，请参阅 campaignTarget 和adGroupTarget 报告。

您可以请求显示特定类型定位条件的效果指标的报告。对于例如，如果广告客户将广告系列定位到地理位置，请在 locationTargetName列 campaignTarget 请求。检索生成的报告时，您可以查看广告系列在。

排除性定位条件

排除性定位条件可阻止广告在符合特定条件时展示。与定位条件类似，某些类型的排除性定位条件只能应用于广告系列而其他规则只能应用于广告组。请参阅 negativeCampaignTarget 和negativeAdGroupTarget 了解详情。

您可以请求报告，以查看排除性定位条件用于排除广告的条件。对于例如，如果广告客户使用排除性定位阻止广告系列在以下国家/地区展示广告：具体的地理位置，请将locationTargetName列添加到 negativeCampaignTarget 请求。检索生成的报告时，您会看到已从广告系列中排除。

示例请求

以下是针对不同类型的目标的请求示例：

广告系列中的地理位置定位目标
为同一账号中的所有广告组设置再营销目标
一个账号中所有广告组的动态广告定位条件
针对某个账号中所有广告系列的排除性地理位置定位目标

针对广告系列中的地理位置定位条件生成报表

以下示例异步请求返回地理位置定位目标的点击次数、展示次数和其他数据（地理位置定位目标仅适用于 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”的地理位置定位范围、指定 “100.0 miles about (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 商店”中的广告组广告系列定义了动态广告定位条件。效果指标目标也包括在内：

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