Предыдущий Search Ads 360 Reporting API выведен из эксплуатации. Теперь вы можете создавать свои отчеты с помощью нового Search Ads 360 Reporting API .
Обратите внимание, что методы get и getByCustomerId в Search Ads 360 Conversion API устарели в третьем квартале 2025 года. Чтобы продолжить доступ к данным о конверсиях, необходимо создать отчет с использованием ресурса конверсии с помощью нового Search Ads 360 Reporting API. Подробнее см. здесь.
Остальные функции API конверсий Search Ads 360 будут по-прежнему поддерживаться.
Тип отчета: отрицательныйCampaignTarget
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Атрибуты конфигурации для исключенных целей на уровне кампании, которые включают целевые местоположения (географическое местоположение, близость и расширение местоположения), цели динамической рекламы, целевые значения списков ремаркетинга и целевые значения возраста и пола. Некоторые цели доступны только в определенных типах учетных записей системы.
Этот отчет может быть возвращен только асинхронным запросом (то есть через метод 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 | Да |
advertiser | Имя рекламодателя. | атрибут | String | Да |
advertiserId | Идентификатор рекламодателя DS. | атрибут | ID | Да |
account | Имя учетной записи системы. | атрибут | String | Да |
accountId | Идентификатор учетной записи ядра DS. | атрибут | ID | Да |
accountEngineId | Идентификатор учетной записи во внешней учетной записи системы. | атрибут | 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 | Да |
campaignStatus | Статус кампании, содержащей этот элемент. | атрибут | Status | Да |
engineRemarketingList | Название списка ремаркетинга, связанного с целью. | атрибут | String | Да |
dynamicSearchAdsTargetConditions | Критерии, которые цель динамической рекламы использует для исключения страниц в домене сайта. | атрибут | String | Нет |
locationTargetName | Имя целевого местоположения. | атрибут | String | Да |
ageTargetAgeRange | Целевой возрастной диапазон. | атрибут | Age range | Да |
genderTargetGenderType | Половой тип гендерной цели: Мужской, Женский, Неизвестно. | атрибут | Gender type | Да |
negativeCampaignTargetId | ID DS, созданный для минус-цели кампании. | атрибут | ID | Да |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-29 UTC.
[null,null,["Последнее обновление: 2025-08-29 UTC."],[[["\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 |"]]