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

新版 Search Ads 360 Reporting API 現已開放使用。這個新 API 提供更靈活彈性的功能,協助您建立自訂報表,並將這些資料整合至報表應用程式和程序。進一步瞭解如何使用及遷移至新版 Search Ads 360 Reporting API

「指定目標」是指根據搜尋查詢位置、客層和其他特徵,顯示廣告的條件。舉例來說,廣告客戶可指定廣告活動中的廣告只在紐約、波士頓和芝加哥放送。或者,廣告客戶也可以針對特定廣告目標對像中的搜尋提高出價,提高廣告向該目標對象顯示的機率。

某些類型的指定目標只能套用到廣告活動,有些則只能套用到廣告群組。如要查看各個層級可用的目標,請參閱 campaignTargetadGroupTarget 報表的說明文件。

您可以要求取得報表,以便顯示特定指定目標類型的成效指標。舉例來說,假設廣告客戶要將廣告活動指定至地理位置,請在 campaignTarget 要求中加入 locationTargetName 欄。擷取產生的報表時,您可以查看廣告活動在每個目標地區的成效。

排除目標

設定排除目標後,搜尋字詞符合特定條件時廣告就不會顯示。 與指定目標類似,有些類型的排除目標只能套用到廣告活動, 有些則只能套用到廣告群組。詳情請參閱 negativeCampaignTargetnegativeAdGroupTarget

您可以要求報表,瞭解排除指定目標使用哪些條件來排除廣告。舉例來說,假設廣告客戶利用排除目標防止廣告活動在特定地理位置顯示廣告,請在 negativeCampaignTarget 要求中加入 locationTargetName 欄。擷取產生的報表時,系統會顯示從廣告活動中排除的地區清單。

要求範例

以下是針對不同指定目標類型的要求範例:

針對廣告活動中的指定地區製作報表

以下的非同步要求範例會傳回指定地區的點擊次數、曝光次數和其他資料 (報表僅適用於 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」的地理位置目標成效,指定鄰近目標為「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 報表的範例。報表顯示「大開幕 - NE」廣告活動排除了緬因州,而「大開幕 - 西部」廣告活動排除加州:

account,campaign,locationTargetName
Hooper's - Google,Grand openings - NE,US-ME
Hooper's - Google,Grand openings - West,US-CA