보고서 유형: 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 |
제외 캠페인 타겟에 대해 생성된 ID DS입니다. |
속성 |
ID |
예 |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 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 |"]]