報表類型：adGroup

廣告群組的成效指標和設定屬性。

這份報表只能透過非同步要求 (也就是透過 Reports.request() 方法) 傳回。

要求摘錄

傳送一般 Reports.request() 要求主體，但指定 "reportType": "adGroup"。

{
...
  "reportType": "adGroup",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

針對報表中要傳回或篩選的每個資料欄，指定下表所列的 columnName。您也可以視需要指定 headerText、startDate 和 endDate。請注意，部分欄無法篩選；請參閱下表中的「可篩選」欄。

columnName說明行為類型是否可篩選
status adGroupStatus 屬性的別名。 屬性 Status 是
engineStatus 外部引擎帳戶中廣告群組的其他狀態。可能的狀態 (視外部帳戶類型而定) 包括 eligible、campaign ended 等。 屬性 String 是
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 是
adRotation 廣告群組使用的廣告放送輪播：Optimize 或 Rotate indefinitely。 屬性 String 否
adGroup 廣告群組名稱： 屬性 String 是
adGroupId DS 廣告群組 ID。 屬性 ID 是
adGroupStatus 廣告群組狀態：Active、Paused 或 Removed。請注意，廣告活動、廣告群組、關鍵字、廣告和指定目標各自有其狀態。請參閱「狀態」。 屬性 Status 是
adGroupEngineId 外部引擎帳戶中的廣告群組 ID。 屬性 ID 是
adGroupStartDate 廣告群組的開始日期。 屬性 Date 是
adGroupEndDate 廣告群組的結束日期。 屬性 Date 是
adGroupSearchMaxCpc 這個廣告群組中搜尋關鍵字的預設出價。 屬性 Money 是
adGroupBroadMaxCpc 這個廣告群組中廣泛比對搜尋關鍵字的預設出價 (僅限 Bing Ads)。 屬性 Money 是
adGroupExactMaxCpc 這個廣告群組中完全比對關鍵字的預設出價 (僅限 Bing Ads)。 屬性 Money 是
adGroupPhraseMaxCpc 這個廣告群組中詞組比對搜尋關鍵字的預設出價 (僅限 Bing Ads)。 屬性 Money 是
adGroupContentMaxCpc 這個廣告群組中內容關鍵字的預設出價。 屬性 Money 是
adGroupMobileBidAdjustment 行動出價的調整幅度百分比。舉例來說，0.2 代表增加 20%，因此行動出價是預設出價的 1.2 倍。有效值的範圍會因外部引擎而異。 屬性 Number 是
adGroupTabletBidAdjustment 平板電腦出價的調整幅度百分比。舉例來說，0.2 代表增加 20%，因此平板電腦出價是預設出價的 1.2 倍。有效值的範圍會因外部引擎而異。 屬性 Number 是
adGroupDesktopBidAdjustment 調整電腦版出價的百分比。舉例來說，0.2 代表增加 20%，因此電腦版出價是預設出價的 1.2 倍。有效值的範圍會因外部引擎而異。 屬性 Number 是
adGroupType (僅適用於 Google Ads) 表示廣告群組類型：Standard、Dynamic 或 Showcase。 屬性 Ad group type 是
bingAdsLanguage Bing Ads 廣告群組中的廣告和關鍵字語言。 屬性 Microsoft language code 是
bingAdsAdDistributions Bing Ads 廣告群組使用的廣告放送管道，即 Search 和 Content 的組合。 屬性 String 否
adGroupLabels 直接指派給這個廣告群組的標籤名稱，不含繼承的標籤。 屬性 String list 是
effectiveBidStrategyId 指派給此實體或由此實體繼承的出價策略的 DS ID。 屬性 ID 是
effectiveBidStrategy 指派給此實體或由此實體繼承的出價策略名稱。 屬性 String 是
bidStrategyInherited 表示這個實體的出價策略是否為沿用。 屬性 Boolean 是
deviceTargets 廣告群組層級的裝置指定目標，即 Desktop、Mobile、Tablet 或 Other 的組合。 屬性 String 否
effectiveDeviceTargets 廣告群組層級或繼承自廣告活動的裝置指定目標，為 Desktop、Mobile、Tablet 或 Other 的組合。 屬性 String 否
countryTargets 廣告群組中包含的國家/地區目標。下載上傳範本和地理/語言代碼。 屬性 String 否
provinceTargets 廣告群組中包含的省份目標。下載上傳範本和地理/語言代碼。 屬性 String 否
metroTargets 廣告群組中包含的都會區目標。下載上傳範本和地理/語言代碼。 屬性 String 否
cityTargets 廣告群組中包含的城市指定目標。下載上傳範本和地理/語言代碼。 屬性 String 否
effectiveCountryTargets 廣告群組內的國家/地區指定目標，或從廣告活動繼承的指定目標。下載上傳範本和地理/語言代碼。 屬性 String 否
effectiveProvinceTargets 廣告群組中包含的省份指定目標，或從廣告活動繼承的指定目標。下載上傳範本和地理/語言代碼。 屬性 String 否
effectiveMetroTargets 廣告群組中納入的都會區指定目標，或從廣告活動繼承的指定目標。下載上傳範本和地理/語言代碼。 屬性 String 否
effectiveCityTargets 廣告群組中納入的城市指定目標，或從廣告活動繼承的指定目標。下載上傳範本和地理/語言代碼。 屬性 String 否
effectiveLabels 繼承或直接指派給這個廣告群組的所有標籤名稱。 屬性 String list 是
engineRemarketingListTargetAll 指出廣告群組是否只使用再行銷指定目標來調整出價。

可能的類型包括：

  • 是：廣告群組會使用再行銷指定目標調整出價。
  • 否：廣告群組只會向再行銷指定目標的成員放送廣告，並可使用再行銷指定目標調整出價。
 屬性 Boolean 是
clicksWithFeedItemShowing 在動態饋給項目顯示時，點選廣告中的任何連結。這個欄只會在動態饋給項目報表或以動態饋給項目欄區隔的報表中傳回值。 指標 Integer 是
costWithFeedItemShowing 動態饋給項目顯示時，所有廣告的費用。這個欄只會在動態饋給項目報表或以動態饋給項目欄區隔的報表中傳回值。 指標 Money 是
dfaActions Campaign Manager 動作的總數。 指標 Integer 是
dfaRevenue Campaign Manager 交易產生的總收益。 指標 Money 是
dfaTransactions Campaign Manager 交易的總數。 指標 Integer 是
dfaWeightedActions Campaign Manager 動作的加權總和。 指標 Number 是
dfaActionsCrossEnv 跨環境 Campaign Manager 動作總數。 指標 Number 是
dfaRevenueCrossEnv 跨環境 Campaign Manager 交易產生的總收益。 指標 Money 是
dfaTransactionsCrossEnv 跨環境 Campaign Manager 交易的總數。 指標 Number 是
dfaWeightedActionsCrossEnv 跨環境 Campaign Manager 動作的加權總和。 指標 Number 是
avgCpc 平均單次點擊出價。 指標 Money 是
avgCpm 平均每千次曝光費用 指標 Money 是
avgPos 平均排序。 指標 Number 是
clicks 匯總點擊。 指標 Integer 是
cost 付給引擎帳戶的總費用。 指標 Money 是
ctr 平均點閱率。 指標 Number 是
impr 曝光總數。 指標 Integer 是
adWordsConversions 廣告客戶設定在 Google Ads「轉換」欄中回報的資料。建立 Google Ads 轉換動作時，廣告主可以選擇是否要將這些轉換計入「轉換」報表欄。 指標 Number 是
adWordsConversionValue Google Ads 轉換的總價值。 指標 Number 是
adWordsViewThroughConversions Google Ads 瀏覽後轉換的總數。 指標 Integer 是
visits DS 造訪總數。 指標 Integer 是
searchImpressionShare 僅適用於 Google Ads 和 Bing Ads。將您在搜尋聯播網上獲得的曝光次數，除以預估可獲得的曝光次數後所得出的百分比。傳回的值介於 0.1 到 1 之間，如果分享比例小於 0.1，則會傳回字串 < 10%。 指標 Impression share 是
searchRankLostImpressionShare 僅適用於 Google Ads 和 Bing Ads。廣告因為廣告評級偏低而無法在搜尋聯播網上顯示的次數百分比。傳回值為 0 到 0.9 之間的數字，如果比重大於 0.9，則傳回值為字串 > 90%。 指標 Impression share 是
displayImpressionShare 僅限 Google Ads。將您在多媒體廣告聯播網上獲得的曝光次數，除以預估可獲得的曝光次數後所得出的百分比。傳回的值介於 0.1 到 1 之間，如果分享比例小於 0.1，則會傳回字串 < 10%。 指標 Impression share 是
displayRankLostImpressionShare 僅限 Google Ads。廣告因為廣告評級偏低而無法在多媒體廣告聯播網中顯示的次數百分比。傳回值為 0 到 0.9 之間的數字，如果比重大於 0.9，則傳回值為字串 > 90%。 指標 Impression share 是
qualityScoreAvg 僅適用於 Google Ads 和 Bing Ads。在報表範圍內，所有天數和關鍵字的引擎品質分數 (QS) 經曝光次數加權後的平均值。 指標 Number 是
topOfPageBidAvg 僅限 Google Ads。預估報表時間範圍內，讓廣告經常顯示在搜尋結果頂端所需的平均單次點擊出價。 指標 Money 是
absoluteTopImpressionPercentage 廣告曝光顯示於自然搜尋結果上方第一則廣告的百分比。 指標 Impression share 是
searchAbsoluteTopImpressionShare 廣告在絕對頂端位置 (自然搜尋結果上方的第一則廣告) 獲得的曝光次數，除以您有資格在頂端位置獲得的預估曝光次數後得出的百分比。 指標 Impression share 是
topImpressionPercentage 廣告曝光顯示於自然搜尋結果上方任一處的百分比。 指標 Impression share 是
searchTopImpressionShare 廣告在頂端位置 (自然搜尋結果上方的任一位置) 獲得的曝光次數，相較於您有資格在頂端位置獲得的預估曝光次數。 指標 Impression share 是
searchRankLostAbsoluteTopImpressionShare 估算廣告因為廣告評級不佳，而無法在自然搜尋結果上方顯示為第一則廣告的頻率。 指標 Impression share 是
searchRankLostTopImpressionShare 估算廣告因為廣告評級不佳，而無法顯示於自然搜尋結果上方任一位置的頻率。 指標 Impression share 是
date 依據日期區隔報表，每個資料列及其匯總指標會分割成多個資料列，每個資料列代表一天。這個欄會傳回每個資料列的日期。 區隔 Date 是
monthStart 依月份區隔報表，每個資料列及其匯總指標會分割成多個資料列，每個月一個。這個資料欄會傳回每個資料列當月的第一天。 區隔 Date 是
monthEnd 依月份區隔報表，每個資料列及其匯總指標會分割成多個資料列，每個月一個。這個欄會傳回每個資料列的當月最後一天。 區隔 Date 是
quarterStart 依季度區隔報表，每個資料列及其匯總指標會分割成多個資料列，每個季度一個。這個欄會傳回每列季度的首日。 區隔 Date 是
quarterEnd 依季度區隔報表，每個資料列及其匯總指標會分割成多個資料列，每個季度一個。這個資料欄會傳回每個資料列的季度最後一天。 區隔 Date 是
weekStart 按週 (週日至週六) 區隔報表；每個資料列及其匯總指標會分割成多個資料列，每週一個。這個欄會傳回每個資料列的第一天 (星期日)。 區隔 Date 是
weekEnd 按週 (週日至週六) 區隔報表；每個資料列及其匯總指標會分割成多個資料列，每週一個。這個資料欄會傳回每個資料列的最後一天 (星期六)。 區隔 Date 是
yearStart 依年份劃分報表，每個資料列及其匯總指標會分割成多個資料列，每個資料列代表一年。這個欄會傳回每個資料列當年的第一天。 區隔 Date 是
yearEnd 依年份劃分報表，每個資料列及其匯總指標會分割成多個資料列，每個資料列代表一年。這個欄會傳回每個資料列當年最後一天的日期。 區隔 Date 是
deviceSegment 依裝置區隔報表，每個資料列及其匯總指標會分割成多個資料列，每個裝置區隔最多可有一個。這個欄會傳回每個資料列的裝置區段。 區隔 Device segment 是
floodlightGroup 依 Floodlight 群組區隔報表，每個資料列及其匯總指標會拆分為多個資料列，每個 Floodlight 群組最多可有一個。這個欄會傳回每個資料列的 Floodlight 群組名稱。請注意，部分指標沒有 Floodlight 區隔值，例如點擊和造訪。 區隔 String 是
floodlightGroupId 依 Floodlight 群組區隔報表，每個資料列及其匯總指標會拆分為多個資料列，每個 Floodlight 群組最多可有一個。這個欄會傳回每列的 DS Floodlight 群組 ID。請注意，部分指標沒有 Floodlight 區隔值，例如點擊和造訪。 區隔 ID 是
floodlightGroupTag 依 Floodlight 群組區隔報表，每個資料列及其匯總指標會拆分為多個資料列，每個 Floodlight 群組最多可有一個。這個欄會傳回每個資料列的 Floodlight 群組代碼。請注意，部分指標沒有 Floodlight 區隔值，例如點擊和造訪。 區隔 String 是
floodlightActivity 依 Floodlight 活動區隔報表，每個資料列及其匯總指標會拆分為多個資料列，每個 Floodlight 活動最多會有一個。這個資料欄會傳回每列的 Floodlight 活動名稱。請注意，部分指標沒有 Floodlight 區隔值，例如點擊和造訪。 區隔 String 是
floodlightActivityId 依 Floodlight 活動區隔報表，每個資料列及其匯總指標會拆分為多個資料列，每個 Floodlight 活動最多會有一個。這個資料欄會傳回每個資料列的 DS Floodlight 活動 ID。請注意，部分指標沒有 Floodlight 區隔值，例如點擊和造訪。 區隔 ID 是
floodlightActivityTag 依 Floodlight 活動區隔報表，每個資料列及其匯總指標會拆分為多個資料列，每個 Floodlight 活動最多會有一個。這個欄會傳回每個資料列的 Floodlight 活動代碼。請注意，部分指標沒有 Floodlight 區隔值，例如點擊和造訪。 區隔 String 是
sitelinkDisplayText 依據網站連結區隔報表，每個資料列及其匯總指標會劃分為多個資料列，每個網站連結對應一個資料列。這個資料欄會傳回每個資料列的網站連結顯示文字。 區隔 String 是
sitelinkDescription1 依據網站連結區隔報表，每個資料列及其匯總指標會劃分為多個資料列，每個網站連結對應一個資料列。這個欄會傳回每個資料列的網站連結說明 1。 區隔 String 是
sitelinkDescription2 依據網站連結區隔報表，每個資料列及其匯總指標會劃分為多個資料列，每個網站連結對應一個資料列。這個資料欄會傳回每個資料列的網站連結說明 2。 區隔 String 是
sitelinkLandingPageUrl 依據網站連結區隔報表，每個資料列及其匯總指標會劃分為多個資料列，每個網站連結對應一個資料列。這個欄會傳回每個資料列的網站連結到達網頁網址。 區隔 String 是
sitelinkClickserverUrl 依據網站連結區隔報表，每個資料列及其匯總指標會劃分為多個資料列，每個網站連結對應一個資料列。這個欄會傳回每個資料列的 sitelink 的 Clickserver 網址。 區隔 String 是
locationBusinessName 依據已升級的地點額外資訊 (已連結至商家檔案帳戶) 區隔報表；每個資料列及其匯總指標會拆分為多個資料列，每個資料列代表一個有指標可供查看的地點。這個資料欄會傳回每個資料列的地點商家名稱。 區隔 String 是
locationCategory 依據已升級的地點額外資訊 (已連結至商家檔案帳戶) 區隔報表；每個資料列及其匯總指標會拆分為多個資料列，每個資料列代表一個可用指標的地點。這個欄會傳回每個資料列的地點類別。 區隔 String 是
locationDetails 依據已升級的地點額外資訊 (已連結至商家檔案帳戶) 區隔報表；每個資料列及其匯總指標會拆分為多個資料列，每個資料列代表一個有指標可供查看的地點。這個欄會傳回每個資料列的位置詳細資料。 區隔 String 是
locationFilter 依據已升級的地點額外資訊 (已連結至商家檔案帳戶) 區隔報表；每個資料列及其匯總指標會拆分為多個資料列，每個資料列代表一個可用指標的地點。這個欄會傳回每個資料列的位置篩選器。 區隔 String 否
callPhoneNumber 依據來電額外資訊區隔報表，每個列及其匯總指標會分割為多個列，每個來電額外資訊一個。這個資料欄會傳回通話額外資訊的電話號碼。 區隔 String 是
callCountryCode 依據來電額外資訊區隔報表，每個列及其匯總指標會分割成多個列，每個來電額外資訊一個。這個欄會傳回每個資料列的通話擴充功能國家/地區代碼。 區隔 String 是
callIsTracked 依據來電額外資訊區隔報表，每個列及其匯總指標會分割成多個列，每個來電額外資訊一個。如果要追蹤通話擴充功能的通話，這個欄會傳回 true，否則傳回 false。 區隔 Boolean 是
callCallOnly 依據來電額外資訊區隔報表，每個列及其匯總指標會分割為多個列，每個來電額外資訊一個。如果來電額外資訊只顯示電話號碼，這一欄會傳回 true；如果額外資訊同時顯示電話號碼和連結，則傳回 false。 區隔 Boolean 是
callConversionTracker 依據來電額外資訊區隔報表，每個列及其匯總指標會拆分為多個列，每個來電額外資訊一個。這個欄會傳回與動態饋給項目相關聯的轉換追蹤器名稱 (如果有的話)。 區隔 String 是
callConversionTrackerId 依據來電額外資訊區隔報表，每個列及其匯總指標會分割成多個列，每個來電額外資訊一個。這個欄會傳回與電話號碼額外資訊相關聯的轉換追蹤器 ID (如有)。 區隔 ID 是
appId 依據應用程式擴充功能區隔報表，每個列及其匯總指標會分割成多個列，每個應用程式擴充功能一個。這個欄會傳回應用程式 ID (如果有的話)。 區隔 String 是
appStore 依應用程式擴充功能區隔報表，每個列及其匯總指標會分割成多個列，每個應用程式擴充功能一個。這個欄會傳回應用程式商店類型 (Apple App Store、Google Play 商店)，如果有則會傳回。 區隔 App store 是
feedItemId 依動態饋給項目區隔報表，每個列及其匯總指標會拆分成多個列，每個動態饋給項目一個。這個欄位會傳回每個資料列的 DS 動態饋給項目資料列 ID。 區隔 ID 是
feedId 依動態饋給項目區隔報表，每個列及其匯總指標會拆分成多個列，每個動態饋給項目一個。這個欄會傳回每個資料列的 DS 動態饋給表格 ID。 區隔 ID 是
feedType 依動態饋給項目區隔報表，每個列及其匯總指標會拆分成多個列，每個動態饋給項目對應一個列。這個欄會傳回每個資料列的動態饋給項目類型。 區隔 Feed type 是