索引
AccessibleBiddingStrategy
(訊息)AccessibleBiddingStrategy.MaximizeConversionValue
(訊息)AccessibleBiddingStrategy.MaximizeConversions
(訊息)AccessibleBiddingStrategy.TargetCpa
(訊息)AccessibleBiddingStrategy.TargetImpressionShare
(訊息)AccessibleBiddingStrategy.TargetRoas
(訊息)AccessibleBiddingStrategy.TargetSpend
(訊息)Ad
(訊息)AdGroup
(訊息)AdGroupAd
(訊息)AdGroupAdLabel
(訊息)AdGroupAsset
(訊息)AdGroupAssetSet
(訊息)AdGroupAudienceView
(訊息)AdGroupBidModifier
(訊息)AdGroupCriterion
(訊息)AdGroupCriterion.PositionEstimates
(訊息)AdGroupCriterion.QualityInfo
(訊息)AdGroupCriterionLabel
(訊息)AdGroupLabel
(訊息)AgeRangeView
(訊息)Asset
(訊息)AssetGroup
(訊息)AssetGroupAsset
(訊息)AssetGroupAssetCombinationData
(訊息)AssetGroupListingGroupFilter
(訊息)AssetGroupSignal
(訊息)AssetGroupTopCombinationView
(訊息)AssetSet
(訊息)AssetSetAsset
(訊息)Audience
(訊息)BiddingStrategy
(訊息)Campaign
(訊息)Campaign.DynamicSearchAdsSetting
(訊息)Campaign.GeoTargetTypeSetting
(訊息)Campaign.NetworkSettings
(訊息)Campaign.OptimizationGoalSetting
(訊息)Campaign.SelectiveOptimization
(訊息)Campaign.ShoppingSetting
(訊息)Campaign.TrackingSetting
(訊息)CampaignAsset
(訊息)CampaignAssetSet
(訊息)CampaignAudienceView
(訊息)CampaignBudget
(訊息)CampaignCriterion
(訊息)CampaignLabel
(訊息)CartDataSalesView
(訊息)Conversion
(訊息)ConversionAction
(訊息)ConversionAction.AttributionModelSettings
(訊息)ConversionAction.FloodlightSettings
(訊息)ConversionAction.ValueSettings
(訊息)ConversionCustomVariable
(訊息)ConversionCustomVariable.FloodlightConversionCustomVariableInfo
(訊息)ConversionTrackingSetting
(訊息)CustomColumn
(訊息)Customer
(訊息)CustomerAsset
(訊息)CustomerAssetSet
(訊息)CustomerClient
(訊息)CustomerManagerLink
(訊息)DoubleClickCampaignManagerSetting
(訊息)DynamicSearchAdsSearchTermView
(訊息)GenderView
(訊息)GeoTargetConstant
(訊息)KeywordView
(訊息)Label
(訊息)LanguageConstant
(訊息)ListingGroupFilterDimension
(訊息)ListingGroupFilterDimension.ProductBiddingCategory
(訊息)ListingGroupFilterDimension.ProductBrand
(訊息)ListingGroupFilterDimension.ProductChannel
(訊息)ListingGroupFilterDimension.ProductCondition
(訊息)ListingGroupFilterDimension.ProductCustomAttribute
(訊息)ListingGroupFilterDimension.ProductItemId
(訊息)ListingGroupFilterDimension.ProductType
(訊息)ListingGroupFilterDimensionPath
(訊息)LocationView
(訊息)ProductBiddingCategoryConstant
(訊息)ProductGroupView
(訊息)SearchAds360Field
(訊息)ShoppingPerformanceView
(訊息)UserList
(訊息)Visit
(訊息)WebpageView
(訊息)
AccessibleBiddingStrategy
代表客戶擁有並與其共用的出價策略檢視畫面。
相較於出價策略,這項資源包括客戶管理員所擁有的策略,以及與客戶的共用策略,以及客戶擁有的策略。這項資源不提供指標,且隻公開一部分的出價策略屬性。
欄位 | |
---|---|
resource_name |
可存取出價策略的資源名稱。AccessibleBiddingStrategy 資源名稱的格式如下:
|
id |
出價策略的 ID。 |
name |
出價策略的名稱。 |
type |
出價策略的類型。 |
owner_customer_id |
出價策略擁有者的客戶 ID。 |
owner_descriptive_name |
出價策略擁有者的描述性_name。 |
聯集欄位 只能設定其中一項。 |
|
maximize_conversion_value |
自動出價策略會以您的預算為廣告活動爭取最大轉換價值, |
maximize_conversions |
一種自動出價策略,用您的預算為廣告活動爭取最多轉換。 |
target_cpa |
這項出價策略會按照您指定的目標單次轉換出價盡量爭取轉換。 |
target_impression_share |
會自動最佳化指定百分比曝光的出價策略。 |
target_roas |
這個出價策略會在平均分配特定目標廣告投資報酬率,協助您爭取最高收益。 |
target_spend |
這項出價策略會設定出價,在預算範圍內盡量爭取點擊。 |
MaximizeConversionValue
自動出價策略會以您的預算為廣告活動爭取最大轉換價值,
欄位 | |
---|---|
target_roas |
目標廣告投資報酬率選項。如果設定這項參數,出價策略會盡可能提高收益,同時平均地設定目標廣告投資報酬率。如果目標廣告投資報酬率偏高,出價策略可能無法用完整筆預算。如未設定目標廣告投資報酬率,出價策略會在預算範圍內盡可能達成最高廣告投資報酬率。 |
MaximizeConversions
一種自動出價策略,用您的預算為廣告活動爭取最多轉換。
欄位 | |
---|---|
target_cpa |
目標單次轉換出價選項。這是指您願意為每次轉換支付的平均金額。 |
target_cpa_micros |
目標單次轉換出價選項。這是指您願意為每次轉換支付的平均金額。 |
TargetCpa
「目標單次轉換出價」是一種自動出價策略,可按照您指定的目標單次轉換出價盡量爭取轉換。
欄位 | |
---|---|
target_cpa_micros |
平均單次轉換出價目標。這個指定目標必須大於或等於最低計費單位 (以帳戶幣別為準)。 |
TargetRoas
這是一種自動出價策略,可協助您提高收益,同時平均分配特定的目標廣告投資報酬率。
欄位 | |
---|---|
target_roas |
每單位支出的所選收益 (根據轉換資料)。 |
TargetSpend
「自動出價策略」會自動設定出價,在預算範圍內盡量爭取點擊。
欄位 | |
---|---|
target_spend_micros |
盡量爭取點擊的支出目標。目標支出出價工具會嘗試支出這個值中較小的值或自然調節支出金額。如果未指定,則會使用預算做為支出目標。這個欄位已淘汰,不應再使用。詳情請參閱 https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html。 |
cpc_bid_ceiling_micros |
出價策略可設定的出價上限。這項限制會套用至策略管理的所有關鍵字。 |
廣告
廣告。
欄位 | |
---|---|
resource_name |
廣告的資源名稱。廣告資源名稱的格式如下:
|
final_urls[] |
廣告跨網域重新導向的所有可能最終到達網址清單。 |
type |
廣告類型。 |
id |
廣告編號。 |
display_url |
某些廣告格式的廣告說明中顯示的網址。 |
name |
廣告名稱。只能用於辨識廣告。這個名稱可以重複,也不會影響放送的廣告。「名稱」欄位目前僅支援 DisplayUploadAd、ImageAd、ShoppingComparisonListingAd 和 VideoAd。 |
聯集欄位 ad_data 。廣告類型的詳細資料。只能設定一個值。ad_data 只能是下列其中一項: |
|
text_ad |
文字廣告的相關詳細資料。 |
expanded_text_ad |
延展型文字廣告的相關詳細資料。 |
responsive_search_ad |
回應式搜尋廣告的詳細資料。 |
product_ad |
產品廣告的相關詳細資料。 |
expanded_dynamic_search_ad |
延展型動態搜尋廣告的詳細資料。 |
AdGroup
廣告群組。
欄位 | |
---|---|
resource_name |
廣告群組的資源名稱。廣告群組資源名稱的格式如下:
|
status |
廣告群組的狀態。 |
type |
廣告群組的類型。 |
ad_rotation_mode |
廣告群組的廣告輪播模式。 |
creation_time |
建立此 ad_group 的時間戳記。時間戳記以客戶的時區為準,並以「yyyy-MM-dd HH:mm:ss」的格式顯示。 |
targeting_setting |
指定目標相關功能的設定。 |
labels[] |
與這個廣告群組附加的標籤資源名稱。 |
engine_id |
外部引擎帳戶中的廣告群組 ID。這個欄位僅適用於非 Google Ads 帳戶,例如 Yahoo Japan、Microsoft、百度等。如果是 Google Ads 實體,請改用「ad_group.id」。 |
start_date |
此廣告群組開始放送廣告的日期。根據預設,廣告群組立即開始或廣告群組的開始日期 (以較晚者為準)。如果設定了這個欄位,廣告群組會從客戶所在時區的指定日期開始執行。這個欄位僅適用於 Microsoft Advertising 和 Facebook 閘道帳戶。 格式:YYYY-MM-DD,範例:2019-03-14 |
end_date |
廣告群組結束放送廣告的日期。根據預設,廣告群組會在廣告群組的結束日期結束時結束。如果設定了這個欄位,廣告群組會在指定日期的結束時間 (以客戶時區為準)。這個欄位僅適用於 Microsoft Advertising 和 Facebook 閘道帳戶。 格式:YYYY-MM-DD,範例:2019-03-14 |
language_code |
廣告群組中廣告及關鍵字的語言。這個欄位僅適用於 Microsoft Advertising 帳戶。詳情請見:https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage |
last_modified_time |
上次修改此廣告群組的日期。日期時間以客戶的時區為準,並以「yyyy-MM-dd HH:mm:ss.sssss」格式表示。 |
id |
廣告群組的 ID。 |
name |
廣告群組的名稱。 這是必填欄位,建立新廣告群組時不得空白。 長度必須少於 255 個 UTF-8 全形字元。 這個值不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。 |
cpc_bid_micros |
最高單次點擊出價。 |
engine_status |
廣告群組的引擎狀態。 |
AdGroupAd
廣告群組廣告。
欄位 | |
---|---|
resource_name |
廣告的資源名稱。廣告群組廣告資源名稱的格式如下:
|
status |
廣告狀態。 |
ad |
廣告。 |
creation_time |
建立此 ad_group_ad 的時間戳記。日期時間以客戶的時區為準,並以「yyyy-MM-dd HH:mm:ss.sssss」格式表示。 |
labels[] |
此廣告群組廣告附加的標籤資源名稱。 |
engine_id |
外部引擎帳戶中的廣告 ID。這個欄位僅適用於 Search Ads 360 帳戶,例如 Yahoo Japan、Microsoft、百度等。如果是非 Search Ads 360 實體,請改用「ad_group_ad.ad.id」。 |
engine_status |
外部引擎帳戶中的廣告其他狀態。視外部帳戶類型而定,可能的狀態包括有效、符合資格、待審核等。 |
last_modified_time |
此廣告群組上次修改的日期。日期時間以客戶的時區為準,並以「yyyy-MM-dd HH:mm:ss.sssss」格式表示。 |
AdGroupAdLabel
廣告群組廣告與標籤之間的關係。
欄位 | |
---|---|
resource_name |
廣告群組廣告標籤的資源名稱。廣告群組廣告標籤資源名稱的格式如下: |
ad_group_ad |
附加標籤的廣告群組廣告。 |
label |
指派給廣告群組廣告的標籤。 |
AdGroupAsset
廣告群組和素材資源之間的連結。
欄位 | |
---|---|
resource_name |
廣告群組素材資源的資源名稱。廣告群組資產名稱的格式如下:
|
ad_group |
必要欄位。素材資源連結的廣告群組。 |
asset |
必要欄位。與廣告群組連結的素材資源。 |
status |
廣告群組素材資源的狀態。 |
AdGroupAssetSet
adAssetSet 是廣告群組和素材資源組合之間的連結。建立 廣告群組 AssetSet 時,系統會將素材資源組合與廣告群組連結。
欄位 | |
---|---|
resource_name |
廣告群組素材資源組合的資源名稱。廣告群組素材資源集資源名稱的格式如下:
|
ad_group |
與這個素材資源組合連結的廣告群組。 |
asset_set |
與廣告群組連結的素材資源組合。 |
status |
廣告群組素材資源組合的狀態。唯讀。 |
AdGroupAudienceView
廣告群組目標對象資料檢視。包括多媒體廣告聯播網和 YouTube 聯播網廣告的興趣和再行銷名單,以及在目標對象層級匯總的搜尋廣告再行銷名單。
欄位 | |
---|---|
resource_name |
廣告群組目標對象檢視畫面的資源名稱。廣告群組目標對象資料檢視資源名稱的格式如下:
|
AdGroupBidModifier
代表廣告群組出價調節係數。
欄位 | |
---|---|
resource_name |
廣告群組出價調節係數的資源名稱。廣告群組出價調節係數資源名稱的格式如下:
|
bid_modifier |
符合條件時的出價修飾符。修飾符的範圍必須介於 0.1 至 10.0 之間。PreferredContent 的範圍介於 1.0 至 6.0 之間。如要停用裝置類型,請輸入 0。 |
聯集欄位 從第 5 版開始建立作業時需要。 |
|
device |
裝置條件。 |
AdGroupCriterion
廣告群組條件。ad_group_criterion 報表只會傳回明確加入廣告群組的條件。
欄位 | |
---|---|
resource_name |
廣告群組條件的資源名稱。廣告群組條件資源名稱的格式如下:
|
creation_time |
這個廣告群組條件建立時的時間戳記。時間戳記以客戶的時區為準,並以「yyyy-MM-dd HH:mm:ss」的格式顯示。 |
status |
條件狀態。 這是指廣告群組條件實體的狀態,由客戶設定。注意:使用者介面報表可能會納入其他資訊,影響條件是否符合執行資格。在某些情況下,API 中「已移除」的條件仍可能在使用者介面中顯示為已啟用。舉例來說,根據預設,廣告活動會向所有年齡層的使用者顯示,除非排除排除範圍。使用者介面會將各個年齡層顯示為「已啟用」,因為它們有資格看到廣告;但是,由於未加入任何正面條件,因此 廣告群組條件.status 會顯示「已移除」。 |
quality_info |
條件品質相關資訊。 |
type |
條件的類型。 |
labels[] |
附加至這個廣告群組條件的標籤資源名稱。 |
position_estimates |
不同位置的標準出價估算值。 |
final_urls[] |
廣告跨網域重新導向的所有可能最終到達網址清單。 |
engine_id |
外部引擎帳戶中的廣告群組條件編號。這個欄位僅適用於非 Google Ads 帳戶,例如 Yahoo Japan、Microsoft、百度等。如果是 Google Ads 實體,請改用「ad_group_criterion.criterion_id」。 |
last_modified_time |
此廣告群組條件上次修改的日期。日期時間以客戶的時區為準,並以「yyyy-MM-dd HH:mm:ss.sssss」格式表示。 |
criterion_id |
條件的 ID。 |
ad_group |
條件所屬的廣告群組。 |
negative |
要指定 ( 這個欄位無法變更。如要將條件從正面改成排除,請先移除再重新加入該條件。 |
bid_modifier |
符合條件時的出價修飾符。修飾符的範圍必須介於 0.1 至 10.0 之間。大多數可指定的條件類型都支援修飾符。 |
cpc_bid_micros |
單次點擊出價。 |
effective_cpc_bid_micros |
有效單次點擊出價。 |
engine_status |
廣告群組條件的引擎狀態。 |
final_url_suffix |
網址範本:將參數附加至最終到達網址。 |
tracking_url_template |
用來建構追蹤網址的網址範本。 |
聯集欄位 只能設定一個值。 |
|
keyword |
關鍵字。 |
listing_group |
商家資訊群組。 |
age_range |
年齡層。 |
gender |
性別。 |
user_list |
使用者名單。 |
webpage |
網頁 |
location |
。 |
PositionEstimates
不同位置的標準出價估算值。
欄位 | |
---|---|
top_of_page_cpc_micros |
要讓廣告顯示在搜尋結果第一頁的頂端所需的預估單次點擊出價。 |
QualityInfo
廣告群組條件品質資訊的容器。
欄位 | |
---|---|
quality_score |
品質分數。 如果 Google 的資訊不足,無法判斷值,系統可能不會填入這個欄位。 |
AdGroupCriterionLabel
廣告群組條件與標籤之間的關係。
欄位 | |
---|---|
resource_name |
廣告群組條件標籤的資源名稱。廣告群組條件標籤資源名稱的格式如下: |
ad_group_criterion |
附加標籤的廣告群組條件。 |
label |
指派給廣告群組條件的標籤。 |
AdGroupLabel
廣告群組和標籤之間的關係。
欄位 | |
---|---|
resource_name |
廣告群組標籤的資源名稱。廣告群組標籤資源名稱的格式如下: |
ad_group |
附加標籤的廣告群組。 |
label |
指派給廣告群組的標籤。 |
AgeRangeView
年齡層檢視。
欄位 | |
---|---|
resource_name |
年齡層檢視畫面的資源名稱。年齡層檢視畫面資源名稱的格式如下:
|
資產
素材資源是可由多則廣告共用的廣告的一部分。素材資源可以是圖片 (ImageAsset)、影片 (YouTubeVideoAsset) 等。素材資源無法變更,也無法移除。如要停止放送素材資源,請從使用該素材資源的實體中移除該素材資源。
欄位 | |
---|---|
resource_name |
資產的資源名稱。資產資源名稱的格式如下:
|
type |
資產的類型。 |
final_urls[] |
在所有跨網域重新導向後方的可能最終到達網址清單。 |
status |
素材資源的狀態。 |
creation_time |
建立這項資產時的時間戳記。時間戳記以客戶的時區為準,並以「yyyy-MM-dd HH:mm:ss」的格式顯示。 |
last_modified_time |
上次修改這個資產的日期。日期時間以客戶的時區為準,並以「yyyy-MM-dd HH:mm:ss.sssss」格式表示。 |
id |
資產 ID。 |
name |
素材資源名稱 (選填)。 |
tracking_url_template |
建立追蹤網址的網址範本。 |
engine_status |
資產的引擎狀態。 |
聯集欄位 asset_data 。資產的特定類型。asset_data 只能是下列其中一項: |
|
youtube_video_asset |
YouTube 影片素材資源。 |
image_asset |
圖片素材資源。 |
text_asset |
文字素材資源。 |
callout_asset |
統一摘要素材資源。 |
sitelink_asset |
統合的網站連結素材資源。 |
page_feed_asset |
統一的網頁動態饋給素材資源。 |
mobile_app_asset |
行動應用程式素材資源。 |
call_asset |
統合的電話素材資源。 |
call_to_action_asset |
行動號召素材資源。 |
location_asset |
統一的地點素材資源。 |
AssetGroup
素材資源群組。AssetGroupAsset 可將素材資源連結至素材資源群組。AssetGroupSignal 的用途是將信號與素材資源群組建立關聯。
欄位 | |
---|---|
resource_name |
素材資源群組的資源名稱。素材資源群組資源名稱的格式如下:
|
id |
素材資源群組的 ID。 |
campaign |
與這個素材資源群組相關聯的廣告活動。與素材資源群組連結的素材資源。 |
name |
必要欄位。素材資源群組的名稱。必要欄位。長度必須介於 1 至 128 個字元。廣告活動中的 ID 不得重複。 |
final_urls[] |
在所有跨網域重新導向後方的最終到達網址清單。在最高成效廣告活動中,根據預設,網址可以擴充 (除非選擇不採用) |
final_mobile_urls[] |
在所有跨網域重新導向後方的最終行動版網址清單。在最高成效廣告活動中,根據預設,網址可以擴充 (除非選擇不採用) |
status |
素材資源群組的狀態。 |
path1 |
系統可能會在廣告所顯示網址內附加的文字部分。 |
path2 |
系統可能會與廣告中顯示的網址附加的第二部分文字。只有在已設定 path1 的情況下,才能設定這個欄位。 |
ad_strength |
這個素材資源群組的整體廣告優異度。 |
AssetGroupAsset
「AssetGroupAsset」是資產和素材資源群組之間的連結。新增 AssetGroupAsset 可將資產與素材資源群組建立連結。
欄位 | |
---|---|
resource_name |
素材資源群組素材資源的資源名稱。素材資源群組素材資源資源名稱的格式如下:
|
asset_group |
與這個素材資源群組素材資源連結的素材資源群組。 |
asset |
這個素材資源群組素材資源連結的素材資源。 |
field_type |
素材資源在素材資源群組中的刊登位置說明。例如:HEADLINE、YOUTUBE_VIDEO 等 |
status |
素材資源和素材資源群組之間的連結狀態。 |
AssetGroupAssetCombinationData
素材資源群組素材資源組合資料
欄位 | |
---|---|
asset_combination_served_assets[] |
放送的素材資源。 |
AssetGroupListingGroupFilter
AssetGroupListingGroupFilter 代表素材資源群組中的商家資訊群組篩選器樹狀結構節點。
欄位 | |
---|---|
resource_name |
素材資源群組商家資訊群組篩選器的資源名稱。素材資源群組商家資訊群組篩選器資源名稱的格式如下:
|
asset_group |
這個素材資源群組商家資訊群組篩選器所屬的素材資源群組。 |
id |
ListingGroupFilter 的 ID。 |
type |
商家資訊群組篩選器節點的類型。 |
vertical |
目前節點樹狀結構代表的垂直程度。同一個樹狀結構中的所有節點都必須屬於同一產業。 |
case_value |
這個商家資訊群組所屬的維度值。未為根群組定義。 |
parent_listing_group_filter |
母商家資訊群組子群組的資源名稱。根清單群組篩選器節點的空值。 |
path |
用來定義這個商家資訊群組篩選器的維度路徑。 |
AssetGroupSignal
AssetGroupSignal 代表素材資源群組中的信號。如果有信號存在,就能向最高成效廣告活動顯示最有可能完成轉換的最高成效廣告活動。最高成效廣告活動會根據信號尋找意願相近或更強烈的新使用者,爭取在搜尋聯播網、多媒體廣告聯播網和影片聯播網上的轉換。
欄位 | |
---|---|
resource_name |
素材資源群組信號的資源名稱。素材資源群組信號資源名稱的格式如下:
|
asset_group |
這個素材資源群組信號所屬的素材資源群組。 |
聯集欄位 signal 。素材資源群組的信號。signal 只能是下列其中一項: |
|
audience |
最高成效廣告活動要使用的目標對象信號。 |
AssetGroupTopCombinationView
廣告群組廣告素材資源組合的使用情況。
欄位 | |
---|---|
resource_name |
素材資源群組頂端組合檢視畫面的資源名稱。AssetGroup 頂層組合檢視資源名稱的格式為:「customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}」 |
asset_group_top_combinations[] |
共同放送的最佳素材資源組合。 |
AssetSet
代表資產集合的素材資源集。使用 AssetSetAsset 將資產連結至素材資源集。
欄位 | |
---|---|
id |
素材資源集的 ID。 |
resource_name |
資產集的資源名稱。資產集資源名稱的格式如下:
|
AssetSetAsset
AssetSetAsset 是資產和資產集之間的連結。新增 AssetSetAsset 可連結資產與資產集。
欄位 | |
---|---|
resource_name |
資產集資產的資源名稱。資產集資產名稱的格式如下:
|
asset_set |
此素材資源集素材資源連結的資產組合。 |
asset |
這個素材資源集素材資源連結的資產。 |
status |
素材資源組合素材資源的狀態。唯讀。 |
觀眾
目標對像是有效的指定目標選項,可讓您針對不同的區隔屬性 (例如詳細客層和興趣相似目標對象),建立代表目標區隔部分的目標對象。
欄位 | |
---|---|
resource_name |
目標對象的資源名稱。目標對象名稱的格式如下:
|
id |
目標對象的 ID。 |
name |
必要欄位。目標對象的名稱。所有目標對象均不得重複。長度下限為 1,長度上限是 255。 |
description |
此目標對象的說明。 |
BiddingStrategy
出價策略。
欄位 | |
---|---|
resource_name |
出價策略的資源名稱。出價策略資源名稱的格式如下:
|
status |
出價策略的狀態。 這是唯讀欄位。 |
type |
出價策略的類型。設定出價配置建立出價策略。 這是唯讀欄位。 |
currency_code |
出價策略使用的貨幣 (ISO 4217 三字母代碼)。 如果是管理員客戶的出價策略,可在建立時設定此幣別,並預設為管理員客戶的貨幣。如果是服務客戶,就無法設定這個欄位;因為放送客戶的所有策略都會默示使用放送客戶的貨幣。在所有情況下,Effective_currency_code 欄位會傳回策略使用的貨幣。 |
id |
出價策略的 ID。 |
name |
出價策略的名稱。帳戶中的所有出價策略名稱不得重複。 此字串長度必須介於 1 到 255 之間 (含首尾),以 UTF-8 位元組為單位 (已剪輯)。 |
effective_currency_code |
出價策略使用的貨幣 (ISO 4217 三字母代碼)。 對於管理員客戶的出價策略,這是指廣告客戶在建立策略時設定的貨幣。如果是服務客戶,這是指客戶的 currency_code。 出價策略指標報表會以這個幣別記錄。 這是唯讀欄位。 |
campaign_count |
附加至這項出價策略的廣告活動數量。 這是唯讀欄位。 |
non_removed_campaign_count |
附加至這項出價策略的未移除廣告活動數量。 這是唯讀欄位。 |
聯集欄位 只能設定其中一項。 |
|
enhanced_cpc |
出價策略會針對較有可能促成轉換的點擊提高出價,並針對較不可能點擊的點擊調高出價。 |
maximize_conversion_value |
自動出價策略會以您的預算為廣告活動爭取最大轉換價值, |
maximize_conversions |
一種自動出價策略,用您的預算為廣告活動爭取最多轉換。 |
target_cpa |
這項出價策略會按照您指定的目標單次轉換出價盡量爭取轉換。 |
target_impression_share |
會自動最佳化指定百分比曝光的出價策略。 |
target_outrank_share |
這種出價策略會根據目標競價目標比例設定出價,而廣告客戶應以高於特定競爭對手的排名做為出價。這個欄位已不適用;如果使用這個欄位建立新的出價策略,或將包含這個欄位的出價策略附加至廣告活動,則無法建立新的出價策略。可對已填入這項配置的策略進行變更。 |
target_roas |
這個出價策略會在平均分配特定目標廣告投資報酬率,協助您爭取最高收益。 |
target_spend |
這項出價策略會設定出價,在預算範圍內盡量爭取點擊。 |
廣告活動
廣告活動。
欄位 | |
---|---|
resource_name |
廣告活動的資源名稱。廣告活動資源名稱的格式如下:
|
status |
廣告活動狀態。 加入新的廣告活動後,狀態會預設為「已啟用」。 |
serving_status |
廣告活動的廣告放送狀態。 |
bidding_strategy_system_status |
廣告活動出價策略的系統狀態。 |
ad_serving_optimization_status |
廣告活動的廣告放送最佳化狀態。 |
advertising_channel_type |
廣告活動中廣告的主要放送目標。您可以在 此為必填欄位,建立新廣告活動時不得空白。 只能在建立廣告活動時設定。廣告活動建立後即無法變更欄位。 |
advertising_channel_sub_type |
可選用的 只能在建立廣告活動時設定。廣告活動建立後即無法變更欄位。 |
url_custom_parameters[] |
這份清單會列出用來取代 |
real_time_bidding_setting |
即時出價設定;只有指定 Ad Exchange 聯播網的廣告活動才能使用這項功能。 |
network_settings |
廣告活動的聯播網設定。 |
dynamic_search_ads_setting |
控管動態搜尋廣告的設定。 |
shopping_setting |
控管購物廣告活動的設定。 |
geo_target_type_setting |
廣告的指定地理區域設定。 |
labels[] |
廣告活動所附加標籤的資源名稱。 |
bidding_strategy_type |
出價策略類型。 設定出價策略時,您可以選擇使用出價配置來建立標準出價策略,或設定「 這是唯讀欄位。 |
accessible_bidding_strategy |
AccessibleBiddingStrategy 的資源名稱為唯讀檢視畫面,顯示在附加的組合出價策略中,由「bidding_strategy」識別的未受限制屬性。如果廣告活動未使用組合策略,則為空白。所有能共用策略並讀取 AccessibleBiddingStrategy 資源的客戶,都能使用未受限制的策略屬性。反之,受限制的屬性則只有策略擁有者及其管理員可使用。受限制的屬性只能從出價策略資源中讀取。 |
frequency_caps[] |
此清單用來限制每位使用者看到這個廣告活動的廣告的頻率。 |
selective_optimization |
這個廣告活動的選擇性最佳化設定,包括一組要為這個廣告活動最佳化的轉換動作。這項功能僅適用於將 MULTI_CHANNEL 做為 AdvertisingChannelType 以及 APP_CAMPAIGN_FOR_ENGAGEMENT 做為 AdvertisingChannelSubType 的應用程式廣告活動。 |
optimization_goal_setting |
這個廣告活動的最佳化目標設定,包括一組最佳化目標類型。 |
tracking_setting |
廣告活動層級的追蹤資訊設定。 |
engine_id |
外部引擎帳戶中的廣告活動 ID。這個欄位僅適用於非 Google Ads 帳戶,例如 Yahoo Japan、Microsoft、百度等。如果是 Google Ads 實體,請改用「campaign.id」。 |
excluded_parent_asset_field_types[] |
應從這個廣告活動中排除的素材資源欄位類型。這個廣告活動不會沿用頂層包含這些欄位類型的素材資源連結。 |
create_time |
建立這個廣告活動的時間戳記。時間戳記以客戶的時區為準,且格式為「yyyy-MM-dd HH:mm:ss」。create_time 將在 v1 中淘汰。請改用 create_time。 |
creation_time |
建立這個廣告活動的時間戳記。時間戳記以客戶的時區為準,並以「yyyy-MM-dd HH:mm:ss」的格式顯示。 |
last_modified_time |
廣告活動上次修改的日期。日期時間以客戶的時區為準,並以「yyyy-MM-dd HH:mm:ss.sssss」格式表示。 |
id |
廣告活動的 ID。 |
name |
廣告活動名稱。 此為必填欄位,建立新廣告活動時不得空白。 這個值不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。 |
tracking_url_template |
用來建構追蹤網址的網址範本。 |
campaign_budget |
廣告活動的預算。 |
start_date |
廣告活動開始放送的日期,以 YYYY-MM-DD 格式表示。 |
end_date |
廣告活動的最後一天,以客戶的時區為 YYYY-MM-DD。建立後,預設值為 2037-12-30,表示廣告活動會無限期放送。如要將現有廣告活動設為無限期放送,請將這個欄位設為 2037-12-30。 |
final_url_suffix |
這個字尾用來將查詢參數附加至採用並行追蹤功能的到達網頁。 |
url_expansion_opt_out |
代表選擇不為更多目標網址啟用網址擴展功能。如果選擇停用 (true),則系統只會指定素材資源群組中的最終到達網址,或是指定廣告主 Google Merchant Center 或業務資料動態饋給中指定的網址。如果選擇加入 (false),就會指定整個網域。只有最高成效廣告活動可設定這個欄位,預設值為 False。 |
聯集欄位 必須為廣告活動組合 (透過出價策略服務建立) 或標準組合。 |
|
bidding_strategy |
廣告活動使用的組合出價策略。 |
manual_cpa |
標準手動單次轉換出價策略。手動出價策略,可讓廣告客戶依廣告客戶指定的動作設定出價。僅適用於在地生活服務廣告活動。 |
manual_cpc |
標準手動單次點擊出價策略。手動單次點擊出價,表示使用者必須按每次點擊付費。 |
manual_cpm |
標準手動千次曝光出價策略。手動採用以曝光為基礎的出價,使用者按每千次曝光付費。 |
maximize_conversions |
標準「盡量爭取轉換」出價策略,會自動使用你的預算盡量爭取轉換。 |
maximize_conversion_value |
標準「盡量提高轉換價值」出價策略會自動設定出價,並利用您的預算盡量提高收益。 |
target_cpa |
「標準目標單次轉換出價」策略會自動設定出價,以根據您指定的目標單次轉換出價盡量爭取轉換。 |
target_impression_share |
目標曝光比重出價策略。這項自動出價策略會設定出價,以達到指定百分比的曝光量。 |
target_roas |
標準「目標廣告投資報酬率」出價策略會自動爭取最高收益,同時平均分配特定目標廣告投資報酬率。 |
target_spend |
「標準目標支出」出價策略會自動設定出價,在您的預算範圍內儘可能爭取點擊。 |
percent_cpc |
標準單次點擊出價策略,也就是出價只花了一些商品或服務的廣告價格。 |
target_cpm |
可自動調整每千次曝光費用的出價策略。 |
DynamicSearchAdsSetting
控管動態搜尋廣告的設定。
欄位 | |
---|---|
domain_name |
必要欄位。這項設定代表的網際網路網域名稱,例如「google.com」或「www.google.com」。 |
language_code |
必要欄位。指定網域語言的語言代碼,例如「en」。 |
use_supplied_urls_only |
廣告活動是否只使用廣告主提供的網址。 |
GeoTargetTypeSetting
代表一組與指定地理區域廣告相關的設定。
欄位 | |
---|---|
positive_geo_target_type |
此特定廣告活動中用來指定正面地理區域的設定。 |
negative_geo_target_type |
此特定廣告活動中用來排除指定地理區域的設定。 |
NetworkSettings
廣告活動的聯播網設定。
欄位 | |
---|---|
target_google_search |
廣告是否會與 google.com 搜尋結果一起顯示。 |
target_search_network |
廣告是否會在 Google 搜尋聯播網的夥伴網站上放送 (要求 |
target_content_network |
廣告是否會在 Google 多媒體廣告聯播網的指定刊登位置上放送。刊登位置是使用刊登位置條件來指定。 |
target_partner_search_network |
廣告是否會在 Google 合作夥伴聯播網上放送。這項功能僅適用於部分 Google 合作夥伴帳戶。 |
OptimizationGoalSetting
這個廣告活動的最佳化目標設定,包括一組最佳化目標類型。
欄位 | |
---|---|
optimization_goal_types[] |
最佳化目標類型清單。 |
SelectiveOptimization
這個廣告活動的選擇性最佳化設定,包括一組要為這個廣告活動最佳化的轉換動作。這項功能僅適用於將 MULTI_CHANNEL 做為 AdvertisingChannelType 以及 APP_CAMPAIGN_FOR_ENGAGEMENT 做為 AdvertisingChannelSubType 的應用程式廣告活動。
欄位 | |
---|---|
conversion_actions[] |
選取一組用來最佳化這個廣告活動的轉換動作。 |
ShoppingSetting
購物廣告活動的設定。定義廣告活動可宣傳的產品涵蓋範圍,以及這個廣告活動如何與其他購物廣告活動互動。
欄位 | |
---|---|
feed_label |
要加進廣告活動的產品動態饋給標籤。只能設定 feed_label 或 sales_country 其中一個。如果使用而不是 sales_country 值,則 feed_label 欄位可接受相同格式的國家/地區代碼,例如「XX」。否則,可以是 Google Merchant Center 中用於動態饋給標籤的任何字串。 |
use_vehicle_inventory |
是否指定車輛房源資訊清單。 |
merchant_id |
Merchant Center 帳戶的 ID。這是建立作業時的必填欄位。在購物廣告活動中無法變更這個欄位。 |
sales_country |
要納入廣告活動的產品銷售國家/地區。 |
campaign_priority |
廣告活動的優先順序。優先順序較高的廣告活動,其優先順序將高於優先順序較低的廣告活動。購物廣告活動中的此欄位為必要欄位,值介於 0 到 2 (含) 之間。此為智慧購物廣告活動的選填欄位,但如有設定,則必須等於 3。 |
enable_local |
是否要加入店面產品。 |
TrackingSetting
廣告活動層級的追蹤資訊設定。
欄位 | |
---|---|
tracking_url |
用於動態追蹤的網址。 |
CampaignAsset
廣告活動和素材資源之間的連結。
欄位 | |
---|---|
resource_name |
廣告活動資產的資源名稱。CampaignAsset 資源名稱的格式如下:
|
status |
廣告活動素材資源的狀態。 |
campaign |
素材資源連結的廣告活動。 |
asset |
連結至廣告活動的素材資源。 |
CampaignAssetSet
CampaignAssetSet 是廣告活動和素材資源組合之間的連結。新增 CampaignAssetSet 可連結與廣告活動的素材資源組合。
欄位 | |
---|---|
resource_name |
廣告活動素材資源組合的資源名稱。資產集資產名稱的格式如下:
|
campaign |
與這個素材資源組合連結的廣告活動。 |
asset_set |
與廣告活動連結的素材資源組合。 |
status |
廣告活動素材資源組合素材資源的狀態。唯讀。 |
CampaignAudienceView
廣告活動目標對象檢視畫面。包含多媒體廣告聯播網和 YouTube 聯播網廣告的興趣和再行銷名單,以及依廣告活動和目標對象條件匯總的搜尋廣告再行銷名單 (RLSA)。這個檢視畫面只包含廣告活動層級附加的目標對象。
欄位 | |
---|---|
resource_name |
廣告活動目標對象檢視畫面的資源名稱。廣告活動目標對象資料檢視資源名稱的格式如下:
|
CampaignBudget
廣告活動預算。
欄位 | |
---|---|
resource_name |
廣告活動預算的資源名稱。廣告活動預算資源名稱的格式如下:
|
delivery_method |
這個放送方式會決定廣告活動預算支出速度。 如果建立作業中未指定,則預設值為 STANDARD。 |
period |
預算的使用期間。若未指定,則預設為 DAILY。 |
amount_micros |
預算金額,以帳戶當地幣別表示。金額是以微量指定,100 萬相當於一個貨幣單位。每月支出上限為這個金額的 30.4 倍。 |
CampaignCriterion
廣告活動條件。
欄位 | |
---|---|
resource_name |
廣告活動條件的資源名稱。廣告活動條件資源名稱的格式如下:
|
display_name |
條件的顯示名稱。 若是變更,系統會忽略此欄位。 |
type |
條件的類型。 |
status |
條件狀態。 |
last_modified_time |
上次修改廣告活動條件的日期。日期時間以客戶的時區為準,並以「yyyy-MM-dd HH:mm:ss.sssss」格式表示。 |
criterion_id |
條件的 ID。 在變更期間,系統會忽略此欄位。 |
bid_modifier |
符合條件時的出價修飾符。修飾符的範圍必須介於 0.1 至 10.0 之間。大多數可指定的條件類型都支援修飾符。如要停用裝置類型,請輸入 0。 |
negative |
要指定 ( |
聯集欄位 只能設定一個值。 |
|
keyword |
關鍵字。 |
location |
。 |
device |
Device. |
age_range |
年齡層。 |
gender |
性別。 |
user_list |
使用者名單。 |
language |
語言。 |
webpage |
網頁。 |
location_group |
地區群組 |
CampaignLabel
代表廣告活動和標籤之間的關係。
欄位 | |
---|---|
resource_name |
資源名稱。廣告活動標籤資源名稱的格式如下: |
campaign |
附加標籤的廣告活動。 |
label |
指派給廣告活動的標籤。 |
CartDataSalesView
購物車資料銷售檢視。
欄位 | |
---|---|
resource_name |
購物車資料銷售檢視的資源名稱。購物車資料銷售檢視資源名稱的格式如下: |
轉換
轉換。
欄位 | |
---|---|
resource_name |
轉換的資源名稱。轉換資源名稱的格式如下:
|
id |
轉換的 ID |
criterion_id |
Search Ads 360 條件 ID。如果值為 0,則表示該條件未歸因。 |
merchant_id |
獲得點擊的產品所屬 Search Ads 360 商品目錄帳戶 ID。您在 Search Ads 360 中連結商品目錄帳戶時,Search Ads 360 會產生這組 ID。 |
ad_id |
廣告 ID。如果值為 0,則表示廣告未歸因。 |
click_id |
系統會根據轉換所歸屬造訪的不重複字串,將這組字串以點擊 ID 網址參數的形式傳送至到達網頁。 |
visit_id |
轉換歸因的 Search Ads 360 造訪 ID。 |
advertiser_conversion_id |
針對離線轉換,這是廣告主提供的 ID。如果廣告客戶沒有指定這類 ID,Search Ads 360 就會產生這個 ID。如果是線上轉換,則視廣告客戶的 Floodlight 指示而定,這個值應等於「id」欄或「在 Floodlight 中」欄。 |
product_id |
獲得點擊的產品 ID。 |
product_channel |
獲得點擊的產品銷售通路:線上或本地。 |
product_language_code |
為內含產品相關資料的 Merchant Center 動態饋給設定的語言 (ISO-639-1)。 |
product_store_id |
點擊後,店面商品目錄廣告中的商店。這組 ID 必須與店面產品動態饋給中使用的商店 ID 相符。 |
product_country_code |
在商品目錄動態饋給中註冊的國家/地區 (ISO-3166 格式)。 |
attribution_type |
轉換歸屬原因:造訪或關鍵字 + 廣告。 |
conversion_date_time |
轉換事件的時間戳記。 |
conversion_last_modified_date_time |
上次修改轉換的時間戳記。 |
conversion_visit_date_time |
轉換所歸因造訪的時間戳記。 |
conversion_quantity |
轉換記錄的項目數量 (由 qty 網址參數判定)。廣告客戶必須負責以動態方式填入參數 (例如轉換中售出的商品數量),否則會預設為 1。 |
conversion_revenue_micros |
轉換事件的調整後收益 (以百萬分之一表示)。而且一律會使用放送帳戶的貨幣。 |
floodlight_original_revenue |
與 Floodlight 事件相關的原始未變更收益 (採用目前報表的貨幣),在 Floodlight 貨幣指示進行修改之前。 |
floodlight_order_id |
廣告客戶提供的轉換 Floodlight 訂單 ID。 |
status |
轉換的狀態:已啟用或「已移除」。 |
asset_id |
在轉換事件期間進行互動的素材資源 ID。 |
asset_field_type |
轉換事件的素材資源欄位類型。 |
ConversionAction
轉換動作。
欄位 | |
---|---|
resource_name |
轉換動作的資源名稱。轉換動作資源名稱的格式如下:
|
creation_time |
Floodlight 活動的建立時間戳記,格式為 ISO 8601。 |
status |
這個轉換動作在轉換事件累積的狀態。 |
type |
這個轉換動作的類型。 |
category |
這個轉換動作記錄的轉換類別。 |
value_settings |
與此轉換動作相關轉換事件價值相關的設定。 |
attribution_model_settings |
與這個轉換動作歸因模式相關的設定。 |
floodlight_settings |
Floodlight 轉換類型的 Floodlight 設定。 |
id |
轉換動作的 ID。 |
name |
轉換動作的名稱。 此為必填欄位,不可空白。 |
primary_for_goal |
如果轉換動作的 primary_for_goal 位元為 false,則無論客戶轉換目標或廣告活動目標為何,轉換動作將無法對所有廣告活動出價。不過,自訂轉換目標不會遵循 primary_for_goal,因此如果廣告活動的自訂轉換目標設定了 primary_for_goal = false,則該轉換動作仍可出價。如果沒有設定,primary_for_goal 會預設為 true。在 V9 中,您只能透過「update」作業建立 primary_for_goal,因為這項動作並未宣告為選用, |
owner_customer |
轉換動作擁有者客戶的資源名稱。如果這是系統定義的轉換動作,則為空值。 |
include_in_client_account_conversions_metric |
這個轉換動作是否應納入「client_account_conversions」指標中。 |
include_in_conversions_metric |
這個轉換動作是否應納入「轉換」指標中。 |
click_through_lookback_window_days |
從一次互動 (例如點擊) 到轉換事件之間,可能經過的天數上限。 |
app_id |
應用程式轉換動作的應用程式 ID。 |
AttributionModelSettings
與這個轉換動作歸因模式相關的設定。
欄位 | |
---|---|
attribution_model |
這個轉換動作的歸因模式類型。 |
data_driven_model_status |
轉換動作的以數據為準歸因模式狀態。 |
FloodlightSettings
Floodlight 轉換動作的相關設定。
欄位 | |
---|---|
activity_group_tag |
這類字串是在回報轉換時用來識別 Floodlight 活動群組的字串。 |
activity_tag |
這類字串是在回報轉換時用來識別 Floodlight 活動的字串。 |
activity_id |
DoubleClick Campaign Manager (DCM) 中的 Floodlight 活動 ID。 |
ValueSettings
與此轉換動作相關轉換事件價值相關的設定。
欄位 | |
---|---|
default_value |
這個轉換動作的轉換事件傳送的價值無效、不允許或遺漏,或這項轉換動作已設為一律使用預設值時,要使用的價值。 |
default_currency_code |
傳送此轉換動作轉換事件時,或包含無效或缺少貨幣代碼,或是這個轉換動作設為一律使用預設值時,要使用的貨幣代碼。 |
always_use_default_value |
控制是否要使用預設價值和預設貨幣代碼,取代這項轉換動作的轉換事件指定的價值和貨幣代碼。 |
ConversionCustomVariable
轉換自訂變數。請參閱「https://support.google.com/sa360/answer/13567857」一文中的「關於新版 Search Ads 360 中的 Floodlight 自訂指標和維度」
欄位 | |
---|---|
resource_name |
轉換自訂變數的資源名稱。轉換自訂變數資源名稱的格式如下:
|
id |
轉換自訂變數的 ID。 |
name |
必要欄位。轉換自訂變數的名稱。名稱不得重複。名稱的長度上限為 100 個字元。前後沒有任何多餘的空格。 |
tag |
必要欄位。轉換自訂變數的代碼。標記不得重複,且由「u」字元和後面緊接著小於或等於 100 的數字。例如「u4」。 |
status |
轉換事件累積的轉換自訂變數狀態。 |
owner_customer |
擁有轉換自訂變數的客戶資源名稱。 |
family |
轉換自訂變數系列。 |
cardinality |
轉換自訂變數的基數。 |
floodlight_conversion_custom_variable_info |
Search Ads 360 Floodlight 轉換自訂變數的欄位。 |
custom_column_ids[] |
使用這個轉換自訂變數的自訂欄 ID。 |
FloodlightConversionCustomVariableInfo
Search Ads 360 Floodlight 轉換自訂變數的相關資訊。
欄位 | |
---|---|
floodlight_variable_type |
Search Ads 360 中定義的 Floodlight 變數類型。 |
floodlight_variable_data_type |
Search Ads 360 中定義的 Floodlight 變數資料類型。 |
ConversionTrackingSetting
一系列與 Search Ads 360 轉換追蹤相關的顧客整體設定。
欄位 | |
---|---|
accepted_customer_data_terms |
客戶是否已接受顧客數位資料條款。如果使用跨帳戶轉換追蹤,這個值會沿用管理員帳戶。這是唯讀欄位。詳情請參閱 https://support.google.com/adspolicy/answer/7475709。 |
conversion_tracking_status |
轉換追蹤狀態。它會指出客戶是否使用轉換追蹤,以及這位客戶的轉換追蹤擁有者。如果這位客戶採用跨帳戶轉換追蹤功能,傳回的值會因要求的 |
enhanced_conversions_for_leads_enabled |
客戶是否選擇採用待開發客戶強化轉換。如果使用跨帳戶轉換追蹤,這個值會沿用管理員帳戶。這是唯讀欄位。 |
google_ads_conversion_customer |
建立及管理轉換的客戶資源名稱。這是唯讀欄位。 |
conversion_tracking_id |
這個帳戶使用的轉換追蹤 ID。這個 ID 不會指出客戶是否使用轉換追蹤 (conversion_tracking_status)。這是唯讀欄位。 |
google_ads_cross_account_conversion_tracking_id |
客戶經理的轉換追蹤 ID。這個設定會在客戶選擇採用轉換追蹤時設定,且會覆寫 conversion_tracking_id。這個欄位只能透過 Google Ads 使用者介面管理。這是唯讀欄位。 |
cross_account_conversion_tracking_id |
客戶經理的轉換追蹤 ID。這個設定會在客戶採用跨帳戶轉換追蹤時設定,且會覆寫 conversion_tracking_id。 |
CustomColumn
自訂欄。請前往 https://support.google.com/sa360/answer/9633916 查看 Search Ads 360 自訂欄
欄位 | |
---|---|
resource_name |
自訂欄的資源名稱。自訂欄資源名稱的格式如下:
|
id |
自訂欄 ID。 |
name |
使用者定義的自訂欄名稱。 |
description |
使用者定義的自訂欄說明。 |
value_type |
自訂欄結果值的類型。 |
references_attributes |
如果自訂欄參照一或多個屬性,則為 True。 |
references_metrics |
如果自訂欄參照一或多個指標,則為 True。 |
queryable |
如果自訂欄可用於 SearchAds360Service.Search 和 SearchAds360Service.SearchStream 的查詢,則為 True。 |
referenced_system_columns[] |
此自訂欄所參照系統欄的清單。舉例來說,「曝光和點擊總和」自訂欄參照了「{"metrics.clicks", "metrics.impressions"}」的系統欄, |
顧客
客戶。
欄位 | |
---|---|
resource_name |
客戶的資源名稱。客戶資源名稱的格式如下:
|
conversion_tracking_setting |
客戶的轉換追蹤設定。 |
account_type |
引擎帳戶類型 (例如 Google Ads、Microsoft Advertising、Yahoo Japan、百度、Facebook、引擎追蹤等) |
double_click_campaign_manager_setting |
DoubleClick Campaign Manager (DCM) 設定。 |
account_status |
帳戶狀態,例如「已啟用」、「已暫停」、「已移除」等 |
last_modified_time |
此客戶上次修改的日期。日期時間以客戶的時區為準,並以「yyyy-MM-dd HH:mm:ss.sssss」格式表示。 |
engine_id |
外部引擎帳戶中的帳戶 ID。 |
status |
客戶的狀態。 |
creation_time |
建立這位客戶時的時間戳記。時間戳記以客戶的時區為準,並以「yyyy-MM-dd HH:mm:ss」的格式顯示。 |
id |
客戶的 ID。 |
descriptive_name |
選填的不重複客戶描述性名稱。 |
currency_code |
帳戶運作方式的貨幣。系統支援部分 ISO 4217 標準的貨幣代碼。 |
time_zone |
客戶的當地時區 ID。 |
tracking_url_template |
使用參數建立追蹤網址的網址範本。 |
final_url_suffix |
用於將參數附加至最終到達網址的網址範本。 |
auto_tagging_enabled |
是否為客戶啟用自動標記功能。 |
manager |
客戶是否為經理。 |
CustomerAsset
客戶和資產之間的連結。
欄位 | |
---|---|
resource_name |
客戶資產的資源名稱。CustomerAsset 資源名稱的格式如下:
|
asset |
必要欄位。與消費者連結的資產。 |
status |
客戶素材資源的狀態。 |
CustomerAssetSet
CustomerAssetSet 是客戶與素材資源組合之間的連結。新增 CustomerAssetSet 可連結資產組合與客戶。
欄位 | |
---|---|
resource_name |
客戶素材資源集的資源名稱。資產集資產名稱的格式如下:
|
asset_set |
與客戶連結的素材資源組合。 |
customer |
與這項素材資源組合相連結的客戶。 |
status |
客戶素材資源組合素材資源的狀態。唯讀。 |
CustomerClient
指定客戶與客戶客戶之間的連結。只有管理員客戶能找到 CustomerClient。包含所有直接和間接客戶,以及管理員本身。
欄位 | |
---|---|
resource_name |
客戶用戶端的資源名稱。CustomerClient 資源名稱的格式如下: |
applied_labels[] |
提出要求的客戶所擁有的標籤資源名稱,該標籤將套用至客戶客戶。標籤資源名稱的格式如下:
|
status |
客戶客戶的狀態。唯讀。 |
client_customer |
與客戶連結的客戶資源名稱。唯讀。 |
level |
指定客戶和客戶之間的距離。如為自我連結,層級值會是 0。唯讀。 |
time_zone |
用戶端時區的常見語言代碼資料存放區 (CLDR) 字串,例如 America/Los_Angeles。唯讀。 |
test_account |
識別客戶是否為測試帳戶。唯讀。 |
manager |
指出客戶是否為管理員。唯讀。 |
descriptive_name |
客戶的描述性名稱。唯讀。 |
currency_code |
客戶的幣別代碼,例如「USD」、「EUR」。唯讀。 |
id |
客戶的 ID。唯讀。 |
CustomerManagerLink
代表客戶與管理員的連結關係。
欄位 | |
---|---|
resource_name |
資源名稱。CustomerManagerLink 資源名稱的格式如下: |
status |
客戶與管理員之間連結的狀態。 |
manager_customer |
與客戶相連結的管理員客戶。 |
manager_link_id |
客戶管理員連結的 ID。這是唯讀欄位。 |
DoubleClickCampaignManagerSetting
DoubleClick Campaign Manager (DCM) 設定。
欄位 | |
---|---|
advertiser_id |
與此客戶相關聯的 Campaign Manager 廣告主 ID。 |
network_id |
與此客戶相關聯的 Campaign Manager 聯播網 ID。 |
time_zone |
與這位客戶相關聯的 Campaign Manager 聯播網時區,以 IANA 時區資料庫格式表示,例如 America/New_York。 |
DynamicSearchAdsSearchTermView
動態搜尋廣告搜尋字詞檢視畫面。
欄位 | |
---|---|
resource_name |
動態搜尋廣告搜尋字詞檢視畫面的資源名稱。動態搜尋廣告搜尋字詞檢視資源名稱的格式如下:
|
landing_page |
曝光時動態選取的到達網頁網址。 這是唯讀欄位。 |
GenderView
性別檢視。gender_view 資源反映的是有效放送狀態,而非新增的條件。在預設情況下,未設有性別條件的廣告群組會向所有性別顯示,因此所有性別都會顯示在 gender_view 中所列的性別。
欄位 | |
---|---|
resource_name |
性別檢視的資源名稱。性別檢視資源名稱的格式如下:
|
GeoTargetConstant
指定地理區域常數。
欄位 | |
---|---|
resource_name |
指定地理區域常數的資源名稱。指定地理區域常數資源名稱的格式如下:
|
status |
指定地理區域常數狀態。 |
id |
指定地理區域常數的 ID。 |
name |
指定地理區域常數英文名稱。 |
country_code |
與目標相關聯的 ISO-3166-1 alpha-2 國家/地區代碼。 |
target_type |
指定地理區域常數目標類型。 |
canonical_name |
完整的英文名稱,包含目標的名稱及其母名和國家/地區。 |
parent_geo_target |
父項指定地理區域常數的資源名稱。指定地理區域常數資源名稱的格式如下:
|
KeywordView
關鍵字檢視。
欄位 | |
---|---|
resource_name |
關鍵字檢視畫面的資源名稱。關鍵字檢視資源名稱的格式如下:
|
標籤
標籤。
欄位 | |
---|---|
resource_name |
資源名稱。標籤資源名稱的格式如下: |
status |
標籤的狀態。唯讀。 |
text_label |
一種標籤類型,以彩色背景顯示文字。 |
id |
標籤的 ID。唯讀。 |
name |
標籤名稱。 這是必填欄位,不能空白。 此字串長度必須介於 1 到 80 (含) 個字元之間。 |
LanguageConstant
語言。
欄位 | |
---|---|
resource_name |
語言常數的資源名稱。語言常數資源名稱的格式如下:
|
id |
語言常數 ID。 |
code |
語言代碼,例如「en_US」、「en_AU」、「es」、「fr」等等。 |
name |
英文的完整語言名稱,例如「英文 (US)、西班牙文」等。 |
targetable |
是否可指定該語言。 |
ListingGroupFilterDimension
素材資源群組商家資訊群組篩選器的商家資訊維度。
欄位 | |
---|---|
聯集欄位 dimension 。下方任一類型的維度一律會顯示。dimension 只能是下列其中一項: |
|
product_bidding_category |
產品的出價類別。 |
product_brand |
產品優惠的品牌。 |
product_channel |
產品優惠的地區。 |
product_condition |
產品的狀況, |
product_custom_attribute |
產品的自訂屬性。 |
product_item_id |
產品的商品 ID。 |
product_type |
產品優惠的類型。 |
ProductBiddingCategory
某層級出價類別的一個元素。頂層類別位於第 1 層級,其子項為第 2 層級,依此類推。系統目前最多支援 5 個等級。使用者必須指定維度類型,指出類別層級。同一個子產品群組的所有情況都必須具有相同的維度類型 (類別層級)。
欄位 | |
---|---|
level |
指出分類中的類別層級。 |
id |
產品類別的 ID。 這個 ID 等同於 google_product_category [Google 產品類別] ID,詳情請參閱:https://support.google.com/merchants/answer/6324436 |
ProductBrand
產品的品牌。
欄位 | |
---|---|
value |
產品品牌的字串值。 |
ProductChannel
產品優惠的地區。
欄位 | |
---|---|
channel |
縣市的值。 |
ProductCondition
產品的狀況,
欄位 | |
---|---|
condition |
條件的值。 |
ProductCustomAttribute
產品的自訂屬性。
欄位 | |
---|---|
index |
表示自訂屬性的索引。 |
value |
產品自訂屬性的字串值。 |
ProductItemId
產品的商品 ID。
欄位 | |
---|---|
value |
ID 的值。 |
ProductType
產品優惠的類型。
欄位 | |
---|---|
level |
類型層級。 |
value |
類型的值。 |
ListingGroupFilterDimensionPath
用來定義維度定義商家資訊群組篩選器的路徑。
欄位 | |
---|---|
dimensions[] |
商家資訊群組篩選器階層 (根節點除外) 至這個商家資訊群組篩選器的完整維度路徑。 |
LocationView
地區檢視會按地區條件顯示廣告活動的成效摘要。
欄位 | |
---|---|
resource_name |
位置檢視的資源名稱。位置檢視畫面資源名稱的格式如下:
|
ProductBiddingCategoryConstant
產品類別。
欄位 | |
---|---|
resource_name |
產品出價類別的資源名稱。產品類別資源名稱的格式如下:
|
level |
產品類別層級。 |
status |
產品出價類別的狀態。 |
id |
產品類別的 ID。 這個 ID 等同於 google_product_category [Google 產品類別] ID,詳情請參閱 https://support.google.com/merchants/answer/6324436。 |
country_code |
產品出價類別的雙字母國家/地區代碼。 |
product_bidding_category_constant_parent |
父項產品出價類別的資源名稱。 |
language_code |
產品出價類別的語言代碼。 |
localized_name |
根據 language_code 本地化的產品類別顯示值。 |
ProductGroupView
產品群組檢視。
欄位 | |
---|---|
resource_name |
產品群組檢視畫面的資源名稱。產品群組檢視資源名稱的格式如下:
|
SearchAds360Field
SearchAds360Service 使用的欄位或資源 (成果)。
欄位 | |
---|---|
resource_name |
構件的資源名稱。成果資源名稱的格式如下:
|
category |
構件的類別。 |
selectable_with[] |
可使用上述構件選取的所有資源、區段和指標名稱。 |
attribute_resources[] |
可使用上述構件選取的所有資源名稱。在搜尋查詢中,這些資源的欄位不會區隔指標。 這個欄位僅適用於類別為「RESOURCE」的構件。 |
metrics[] |
這個欄位會列出在 FROM 子句中使用上述成果時,可使用上述成果選取的所有指標名稱。只有類別為「RESOURCE」的構件才會設定此屬性。 |
segments[] |
這個欄位會列出所有成果的名稱,無論是片段或其他資源、在搜尋查詢中包含的區隔指標,以及在 FROM 子句中使用所描述的構件時,該指標都會進行區隔。只有類別為「RESOURCE」的構件才會設定此屬性。 |
enum_values[] |
構件可以假設是否為 ENUM 類型的欄位。 這個欄位僅適用於 SEGMENT 或 ATTRIBUTE 類別的構件。 |
data_type |
這個欄位會決定可與 WHERE 子句中構件搭配使用的運算子。 |
name |
構件的名稱。 |
selectable |
指定構件是否可以在搜尋查詢的 SELECT 子句中使用。 |
filterable |
指定構件是否可以在搜尋查詢的 WHERE 子句中使用。 |
sortable |
指定成果是否可在搜尋查詢的 ORDER BY 子句中使用。 |
type_url |
說明構件資料類型的 proto 網址。 |
is_repeated |
欄位構件是否重複。 |
ShoppingPerformanceView
Shopping 成效資料檢視。提供購物廣告活動統計資料,這些統計資料按數個產品維度層級匯總。Merchant Center 中的產品維度值 (例如品牌、類別、自訂屬性、產品狀況和產品類型),都會反映對應事件記錄日期和時間時,各個維度的狀態。
欄位 | |
---|---|
resource_name |
購物成效檢視畫面的資源名稱。購物效能檢視畫面資源名稱的格式如下: |
UserList
使用者名單。這是客戶可能指定的使用者名單。
欄位 | |
---|---|
resource_name |
使用者名單的資源名稱。使用者名單資源名稱的形式如下:
|
type |
此清單的類型。 這是唯讀欄位。 |
id |
使用者名單的編號。 |
name |
此使用者名單的名稱。視 access_reason 而定,使用者名單的名稱可能不得重複 (例如,若 access_reason=SHARED) |
前往
一次造訪。
欄位 | |
---|---|
resource_name |
造訪的資源名稱。造訪資源名稱的格式如下:
|
id |
造訪的 ID。 |
criterion_id |
Search Ads 360 關鍵字 ID。如果值為 0,表示該關鍵字未歸因。 |
merchant_id |
獲得點擊的產品所屬 Search Ads 360 商品目錄帳戶 ID。您在 Search Ads 360 中連結商品目錄帳戶時,Search Ads 360 會產生這組 ID。 |
ad_id |
廣告 ID。如果值為 0,則表示廣告未歸因。 |
click_id |
每次造訪以點擊 ID 網址參數傳送給到達網頁的不重複字串。 |
visit_date_time |
造訪事件的時間戳記。時間戳記以客戶的時區為準,並以「yyyy-MM-dd HH:mm:ss」的格式顯示。 |
product_id |
獲得點擊的產品 ID。 |
product_channel |
獲得點擊的產品銷售通路:線上或本地。 |
product_language_code |
為內含產品相關資料的 Merchant Center 動態饋給設定的語言 (ISO-639-1)。 |
product_store_id |
點擊後,店面商品目錄廣告中的商店。這組 ID 必須與店面產品動態饋給中使用的商店 ID 相符。 |
product_country_code |
為含有點選的產品的商品目錄動態饋給註冊的國家/地區 (ISO-3166 格式)。 |
asset_id |
在造訪事件期間互動的資產 ID。 |
asset_field_type |
造訪事件的素材資源欄位類型。 |
WebpageView
網頁瀏覽。
欄位 | |
---|---|
resource_name |
網頁檢視的資源名稱。網頁檢視資源名稱的格式如下:
|