報表類型:adGroupTarget

廣告群組層級指定目標的成效指標,包括指定地區、動態廣告目標、再行銷名單指定目標、年齡/性別指定目標和未分類指定目標。部分指定目標僅適用於特定類型的引擎帳戶。

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

要求摘錄

傳送一般 Reports.request() 要求主體,但指定 "reportType": "adGroupTarget"

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

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

columnName說明行為類型是否可篩選
status 廣告群組目標的狀態:ActivePausedRemoved 屬性 Status
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 AdWordsBing AdsYahoo Japan Listing AdsYahoo Search MarketingYahoo GeminiBaiduComparison Shopping 屬性 Engine type
campaign 廣告活動名稱: 屬性 String
campaignId DS 廣告活動 ID。 屬性 ID
campaignStatus 包含這項商品的廣告活動狀態。 屬性 Status
adGroup 廣告群組名稱: 屬性 String
adGroupId DS 廣告群組 ID。 屬性 ID
adGroupStatus 包含這項商品的廣告群組狀態。 屬性 Status
engineRemarketingList 與指定目標相關聯的再行銷名單名稱。 屬性 String
engineRemarketingListBidModifier 與指定目標相關聯的出價調整幅度。 屬性 Number
dynamicSearchAdsTargetConditions 動態廣告目標用來篩選網站網域中網頁的條件。 屬性 String
dynamicSearchAdsTargetCpcBid 動態廣告目標的最高單次點擊出價設定。 屬性 Money
dynamicSearchAdsTargetLandingPageUrl 動態廣告目標的網址範本。 屬性 String
dynamicSearchAdsTargetCoverage 廣告主網站中符合動態廣告目標的網頁百分比。 屬性 Number
locationTargetName 地區目標的名稱。 屬性 String
locationTargetBidModifier 與指定地區相關聯的出價調整幅度。 屬性 Number
ageTargetAgeRange 指定年齡的目標年齡層。 屬性 Age range
ageTargetBidModifier 與年齡指定目標相關聯的出價調整幅度。 屬性 Number
genderTargetGenderType 性別指定的性別類型:男性、女性、不明。 屬性 Gender type
genderTargetBidModifier 與性別指定目標相關聯的出價調整幅度。 屬性 Number
unclassifiedTargetName 未分類指定目標的名稱。 屬性 String
unclassifiedTargetType 未分類指定目標的類型:Dynamic search 屬性 Unclassified target type
adGroupTargetId 系統為廣告群組目標產生的 ID DS。 屬性 ID
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
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