廣告群組成效指標和設定屬性。
這份報表只能由非同步要求 (也就是透過 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 |
依網站連結區隔報表；每個資料列及其匯總指標都會分成多個資料列，每個資料列一列。此欄會傳回各資料列的網站連結 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，此欄會顯示應用程式 ID。 | 區隔 | String |
是 |
appStore |
依應用程式額外資訊區隔報表；每個資料列及其匯總指標都會分成多列，每列各代表一個應用程式額外資訊。此欄會傳回應用程式商店類型 (Apple App Store、Google Play Store) (如有)。 | 區隔 | App store |
是 |
feedItemId |
依動態饋給項目區隔報表。每個資料列及其匯總指標都會分成多個資料列，每個動態饋給項目各一列。此欄會傳回每列的 DS 動態饋給項目列 ID。 | 區隔 | ID |
是 |
feedId |
依動態饋給項目區隔報表。每個資料列及其匯總指標都會分成多個資料列，每個動態饋給項目各一列。此欄會回傳每一列的 DS 資訊提供表格 ID。 | 區隔 | ID |
是 |
feedType |
依動態饋給項目區隔報表。每個資料列及其匯總指標都會分成多個資料列，每個動態饋給項目各一列。此欄會傳回各列的動態饋給項目類型。 | 區隔 | Feed type |
是 |