报告类型: negativeCampaignTarget
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
广告系列级排除性定位条件的配置属性,其中包括地理位置定位目标(地理位置定位、邻近区域和附加地址信息)、动态广告定位条件、再营销名单定位条件以及年龄/性别定位条件。某些定位条件仅适用于特定类型的引擎账号。
只有异步请求(即通过
Reports.request() 方法)。
请求摘录
发送普通
Reports.request()
请求正文,但请指定 "reportType": "negativeCampaignTarget"
。
{
...
"reportType": "negativeCampaignTarget",
"columns": [
{
"columnName": string,
"headerText": string,
"startDate": string,
"endDate": string
}
],
"filters": [
{
"column": {
"columnName": string,
},
...
},
...
],
...
}
对于您想在报告中返回或过滤的每一列,
指定下表中列出的 columnName
。
您还可以视需要指定
headerText、
startDate,
和 endDate。
请注意,有些列无法过滤;指“可过滤”。
columnName | 说明 | 行为 | 类型 | 可过滤 |
status |
广告系列定位条件的状态:Active 、Paused 或 Removed 。 |
属性 |
Status |
是 |
creationTimestamp |
创建排除性广告系列目标的时间戳,采用 ISO 8601 格式。 |
属性 |
Timestamp |
是 |
lastModifiedTimestamp |
排除性广告系列定位条件的最近修改时间戳,采用 ISO 8601 格式。 |
属性 |
Timestamp |
是 |
agency |
代理机构名称。 |
属性 |
String |
是 |
agencyId |
DS 代理机构 ID。 |
属性 |
ID |
是 |
advertiser |
广告客户名称。 |
属性 |
String |
是 |
advertiserId |
DS 广告客户 ID。 |
属性 |
ID |
是 |
account |
引擎账号名称。 |
属性 |
String |
是 |
accountId |
DS 引擎账号 ID。 |
属性 |
ID |
是 |
accountEngineId |
外部引擎账号中账号的 ID。 |
属性 |
String |
是 |
accountType |
引擎账号类型:Google AdWords 、Bing Ads 、Yahoo Japan Listing Ads 、Yahoo Search Marketing 、Yahoo Gemini 、Baidu 或 Comparison Shopping 。 |
属性 |
Engine type |
是 |
campaign |
广告系列名称。 |
属性 |
String |
是 |
campaignId |
DS 广告系列 ID。 |
属性 |
ID |
是 |
campaignStatus |
包含此商品的广告系列的状态。 |
属性 |
Status |
是 |
engineRemarketingList |
与定位条件相关联的再营销名单的名称。 |
属性 |
String |
是 |
dynamicSearchAdsTargetConditions |
动态广告定位条件用于排除网站网域下的网页的条件。 |
属性 |
String |
否 |
locationTargetName |
地理位置定位目标的名称。 |
属性 |
String |
是 |
ageTargetAgeRange |
目标年龄段的年龄段。 |
属性 |
Age range |
是 |
genderTargetGenderType |
性别定位条件的性别类型:男性、女性、未知。 |
属性 |
Gender type |
是 |
negativeCampaignTargetId |
DS 为排除性广告系列定位条件生成的 ID。 |
属性 |
ID |
是 |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-29。
[null,null,["最后更新时间 (UTC):2025-08-29。"],[[["\u003cp\u003eThis report details negative campaign target configuration attributes, including location, dynamic ad, remarketing list, and age/gender targets.\u003c/p\u003e\n"],["\u003cp\u003eThe report is accessible via an asynchronous Reports.request() method with "reportType" specified as "negativeCampaignTarget".\u003c/p\u003e\n"],["\u003cp\u003eIt provides insights into target status, timestamps, associated accounts and campaigns, and specific target criteria.\u003c/p\u003e\n"],["\u003cp\u003eCertain targets may only be available in specific engine accounts, and the report allows filtering by various attributes.\u003c/p\u003e\n"],["\u003cp\u003eColumn details like \u003ccode\u003ecolumnName\u003c/code\u003e, description, behavior, type, and filterability are provided for comprehensive understanding and utilization of the report.\u003c/p\u003e\n"]]],["This document outlines the configuration and retrieval of negative campaign targets via the `Reports.request()` method using `\"reportType\": \"negativeCampaignTarget\"`. The report includes details on location, dynamic ad, remarketing list, and age/gender targets. Key actions involve specifying `columnName` for data fields within the request body, including attributes such as status, timestamps, agency/account details, campaign information, target names, and IDs. Filters can be applied to most columns, excluding `dynamicSearchAdsTargetConditions`.\n"],null,["# Report Type: negativeCampaignTarget\n\nConfiguration attributes for negative targets at the campaign level, which include location targets (geo-location, proximity, and location extension), dynamic ad targets, remarketing list targets and age/gender targets. Some targets are available only in specific types of engine accounts.\n\n\nThis report can only be returned by an asynchronous request (that is, via the\n[Reports.request()](/search-ads/v2/reference/reports/request) method).\n\n### Request excerpt\n\n\nSend a regular\n[Reports.request()](/search-ads/v2/reference/reports/request)\nrequest body, but specify `\"reportType\": \"negativeCampaignTarget\"`.\n\n```text\n{\n...\n \"reportType\": \"negativeCampaignTarget\",\n \"columns\": [\n {\n \"columnName\": string,\n \"headerText\": string,\n \"startDate\": string,\n \"endDate\": string\n }\n ],\n \"filters\": [\n {\n \"column\": {\n \"columnName\": string,\n },\n ...\n },\n ...\n ],\n...\n}\n```\n\n\nFor each column that you want returned or filtered in the report,\nspecify the `columnName` listed in the table below.\nYou can also optionally specify\n[headerText](/search-ads/v2/reference/reports#request.columns.headerText),\n[startDate](/search-ads/v2/reference/reports#request.columns.startDate),\nand [endDate](/search-ads/v2/reference/reports#request.columns.endDate).\nNote that some columns cannot be filtered; refer to \"Filterable\" in the table below.\n\n| `columnName` | Description | Behavior | Type | Filterable |\n|------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------|---------------|------------|\n| `status` | The status of the campaign target: `Active`, `Paused`, or `Removed`. | attribute | `Status` | Yes |\n| `creationTimestamp` | Timestamp of the negative campaign target's creation, formatted in ISO 8601. | attribute | `Timestamp` | Yes |\n| `lastModifiedTimestamp` | Timestamp of the negative campaign target's most recent modification, formatted in ISO 8601. | attribute | `Timestamp` | Yes |\n| `agency` | Agency name. | attribute | `String` | Yes |\n| `agencyId` | DS agency ID. | attribute | `ID` | Yes |\n| `advertiser` | Advertiser name. | attribute | `String` | Yes |\n| `advertiserId` | DS advertiser ID. | attribute | `ID` | Yes |\n| `account` | Engine account name. | attribute | `String` | Yes |\n| `accountId` | DS engine account ID. | attribute | `ID` | Yes |\n| `accountEngineId` | ID of the account in the external engine account. | attribute | `String` | Yes |\n| `accountType` | Engine account type: `Google AdWords`, `Bing Ads`, `Yahoo Japan Listing Ads`, `Yahoo Search Marketing`, `Yahoo Gemini`, `Baidu`, or `Comparison Shopping`. | attribute | `Engine type` | Yes |\n| `campaign` | Campaign name. | attribute | `String` | Yes |\n| `campaignId` | DS campaign ID. | attribute | `ID` | Yes |\n| `campaignStatus` | The status of the campaign that contains this item. | attribute | `Status` | Yes |\n| `engineRemarketingList` | The name of the remarketing list associated with the target. | attribute | `String` | Yes |\n| `dynamicSearchAdsTargetConditions` | The criteria the dynamic ad target uses to exclude pages under the site domain. | attribute | `String` | No |\n| `locationTargetName` | The name of the location target. | attribute | `String` | Yes |\n| `ageTargetAgeRange` | The age range of age target. | attribute | `Age range` | Yes |\n| `genderTargetGenderType` | The gender type of gender target: Male, Female, Unknown. | attribute | `Gender type` | Yes |\n| `negativeCampaignTargetId` | The ID DS generated for a negative campaign target. | attribute | `ID` | Yes |"]]