製作廣告活動和廣告群組指定目標報表

新版 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」的地理位置指定目標；指定「US」這個鄰近目標「100.0 英里左右 (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