ประเภทรายงาน: negativeAdGroupTarget
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
แอตทริบิวต์การกำหนดค่าสำหรับเป้าหมายเชิงลบในระดับกลุ่มโฆษณา ซึ่งประกอบด้วยพื้นที่เป้าหมาย เป้าหมายโฆษณาแบบไดนามิก เป้าหมายรายการรีมาร์เก็ตติ้ง และเป้าหมายอายุ/เพศ เป้าหมายบางรายการใช้ได้เฉพาะในบัญชีเครื่องมือค้นหาบางประเภทเท่านั้น
รายงานนี้สามารถส่งคืนได้โดยคำขอแบบอะซิงโครนัสเท่านั้น (นั่นคือผ่านทาง
Reports.request())
ขอข้อความที่ตัดตอนมา
ส่ง
Reports.request()
เนื้อหาของคำขอ แต่ระบุ "reportType": "negativeAdGroupTarget"
{
...
"reportType": "negativeAdGroupTarget",
"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 |
ใช่ |
adGroup |
ชื่อกลุ่มโฆษณา |
แอตทริบิวต์ |
String |
ใช่ |
adGroupId |
รหัสกลุ่มโฆษณา DS |
แอตทริบิวต์ |
ID |
ใช่ |
adGroupStatus |
สถานะของกลุ่มโฆษณาที่มีรายการนี้ |
แอตทริบิวต์ |
Status |
ใช่ |
engineRemarketingList |
ชื่อรายการรีมาร์เก็ตติ้งที่เชื่อมโยงกับเป้าหมาย |
แอตทริบิวต์ |
String |
ใช่ |
dynamicSearchAdsTargetConditions |
เกณฑ์ที่เป้าหมายโฆษณาแบบไดนามิกใช้เพื่อยกเว้นหน้าเว็บที่อยู่ภายใต้โดเมนเว็บไซต์ |
แอตทริบิวต์ |
String |
ไม่ได้ |
locationTargetName |
ชื่อของพื้นที่เป้าหมาย |
แอตทริบิวต์ |
String |
ใช่ |
ageTargetAgeRange |
ช่วงอายุของเป้าหมายอายุ |
แอตทริบิวต์ |
Age range |
ใช่ |
genderTargetGenderType |
ประเภทเพศของเป้าหมายเพศ: ชาย หญิง ไม่ทราบ |
แอตทริบิวต์ |
Gender type |
ใช่ |
negativeAdGroupTargetId |
รหัส DS ที่สร้างขึ้นสำหรับเป้าหมายกลุ่มโฆษณาเชิงลบ |
แอตทริบิวต์ |
ID |
ใช่ |
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-08-29 UTC
[null,null,["อัปเดตล่าสุด 2025-08-29 UTC"],[[["\u003cp\u003eThe Negative Ad Group Target report provides insights into configuration attributes for negative targets at the ad group level, including location, dynamic ad, remarketing list, and age/gender targets.\u003c/p\u003e\n"],["\u003cp\u003eThis report is accessible through an asynchronous request using the \u003ccode\u003eReports.request()\u003c/code\u003e method with \u003ccode\u003e"reportType": "negativeAdGroupTarget"\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe report includes various filterable columns such as status, timestamps, agency/advertiser details, account information, campaign/ad group data, and target specifics like remarketing lists and location names.\u003c/p\u003e\n"],["\u003cp\u003eCertain targets may only be available in specific engine accounts and some columns, like \u003ccode\u003edynamicSearchAdsTargetConditions\u003c/code\u003e, are not filterable.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ecolumnName\u003c/code\u003e parameter is used within the request to specify the desired data points for inclusion in the report output.\u003c/p\u003e\n"]]],["The content describes the \"negativeAdGroupTarget\" report, which details negative targets at the ad group level, such as location, dynamic ad, remarketing list, and age/gender targets. To retrieve this report, a `Reports.request()` method with `\"reportType\": \"negativeAdGroupTarget\"` must be sent. The request specifies `columnName`, `headerText`, `startDate`, and `endDate`. Various attributes can be returned or filtered, including target status, timestamps, agency/account details, campaign/ad group information, and target-specific details. The content also provides the definition of each column with details for filtering.\n"],null,["# Report Type: negativeAdGroupTarget\n\nConfiguration attributes for negative targets at the ad group level, which include location targets, 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\": \"negativeAdGroupTarget\"`.\n\n```text\n{\n...\n \"reportType\": \"negativeAdGroupTarget\",\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 ad group target: `Active`, `Paused`, or `Removed`. | attribute | `Status` | Yes |\n| `creationTimestamp` | Timestamp of the negative ad group target's creation, formatted in ISO 8601. | attribute | `Timestamp` | Yes |\n| `lastModifiedTimestamp` | Timestamp of the negative ad group 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| `adGroup` | Ad group name. | attribute | `String` | Yes |\n| `adGroupId` | DS ad group ID. | attribute | `ID` | Yes |\n| `adGroupStatus` | The status of the ad group 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| `negativeAdGroupTargetId` | The ID DS generated for a negative ad-group target. | attribute | `ID` | Yes |"]]