Package google.ads.searchads360.v0.common

索引

• AdScheduleInfo (訊息)
• AgeRangeInfo (訊息)
• AssetInteractionTarget (訊息)
• AssetUsage (訊息)
• AudienceInfo (訊息)
• BusinessProfileLocation (訊息)
• CallToActionAsset (訊息)
• CustomParameter (訊息)
• DeviceInfo (訊息)
• EnhancedCpc (訊息)
• FrequencyCapEntry (訊息)
• GenderInfo (訊息)
• ImageAsset (訊息)
• ImageDimension (訊息)
• Keyword (訊息)
• KeywordInfo (訊息)
• LanguageInfo (訊息)
• ListingGroupInfo (訊息)
• LocationGroupInfo (訊息)
• LocationInfo (訊息)
• ManualCpa (訊息)
• ManualCpc (訊息)
• ManualCpm (訊息)
• MaximizeConversionValue (訊息)
• MaximizeConversions (訊息)
• Metrics (訊息)
• MobileAppAsset (訊息)
• PercentCpc (訊息)
• RealTimeBiddingSetting (訊息)
• SearchAds360ExpandedDynamicSearchAdInfo (訊息)
• SearchAds360ExpandedTextAdInfo (訊息)
• SearchAds360ProductAdInfo (訊息)
• SearchAds360ResponsiveSearchAdInfo (訊息)
• SearchAds360TextAdInfo (訊息)
• Segments (訊息)
• TargetCpa (訊息)
• TargetCpm (訊息)
• TargetImpressionShare (訊息)
• TargetOutrankShare (訊息)
• TargetRestriction (訊息)
• TargetRoas (訊息)
• TargetSpend (訊息)
• TargetingSetting (訊息)
• TextAsset (訊息)
• TextLabel (訊息)
• UnifiedCallAsset (訊息)
• UnifiedCalloutAsset (訊息)
• UnifiedLocationAsset (訊息)
• UnifiedPageFeedAsset (訊息)
• UnifiedSitelinkAsset (訊息)
• UserListInfo (訊息)
• Value (訊息)
• WebpageConditionInfo (訊息)
• WebpageInfo (訊息)
• YoutubeVideoAsset (訊息)

AdScheduleInfo

代表 AdSchedule 條件。

AdSchedule 指定在星期幾和廣告放送的時段。

同一天最多只能新增 6 個 AdSchedule。

欄位
start_minute	MinuteOfHour 此排程開始小時後的分鐘。 這是 CREATE 作業的必填欄位，不得用於 UPDATE 作業。
end_minute	MinuteOfHour 此排程結束時間後的幾分鐘。不含結束分鐘的時間表。 這是 CREATE 作業的必填欄位，不得用於 UPDATE 作業。
day_of_week	DayOfWeek 要套用時間表的星期幾。 這是 CREATE 作業的必填欄位，不得用於 UPDATE 作業。
start_hour	int32 以 24 小時製表示的開始小時。此欄位的值必須介於 0 到 23 (含) 之間。 這是 CREATE 作業的必填欄位，不得用於 UPDATE 作業。
end_hour	int32 結束小時 (24 小時制)；24 表示一天的結束時間。此欄位必須介於 0 到 24 (含) 之間。 這是 CREATE 作業的必填欄位，不得用於 UPDATE 作業。

AgeRangeInfo

年齡層條件。

欄位
type	AgeRangeType 年齡層類型。

AssetInteractionTarget

AssetInteractionTarget 區隔。

欄位
asset	string 資產資源名稱。
interaction_on_this_asset	bool 只搭配 CustomerAsset、CampaignAsset 和 adAsset 指標使用。指出互動指標是發生在素材資源本身，還是其他素材資源/廣告單元上。

AssetUsage

內含資產的使用資訊。

欄位
asset	string 資產的資源名稱。
served_asset_field_type	ServedAssetFieldType 素材資源的放送欄位類型。

AudienceInfo

目標對象條件。

欄位
audience	string 目標對象資源名稱。

BusinessProfileLocation

從已連結的商家檔案帳戶同步處理的商家檔案位置資料。

欄位
labels[]	string 廣告主為商家檔案帳戶中的地點指定的標籤。這項資訊會從商家檔案帳戶同步。
store_code	string 這個營業地點的商家檔案商店代碼。這項資訊會從商家檔案帳戶同步。
listing_id	int64 這個商家檔案地點的商家資訊 ID。系統會從已連結的商家檔案帳戶同步處理這項資訊。

CallToActionAsset

行動號召素材資源。

欄位
call_to_action	CallToActionType 行動號召。

CustomParameter

可由 tracking_url_template、final_urls 或 mobile_final_urls 中的自訂參數標記使用的對應。

欄位
key	string 符合參數代碼名稱的鍵。
value	string 要替換的值。

DeviceInfo

裝置條件。

欄位
type	Device 裝置的類型。

EnhancedCpc

這個類型沒有任何欄位。

自動出價策略會針對較有可能促成轉換的點擊調高出價，並降低點擊機率。

這項出價策略已淘汰，無法再建立。使用 ManualCpc，並將 Enhanced_cpc_enabled 設為 true，藉此取得同等功能。

FrequencyCapEntry

這個類型沒有任何欄位。

一個規則，用來指定某則廣告 (或某組廣告) 在特定時間範圍內可向使用者顯示的次數上限。

GenderInfo

性別條件。

欄位
type	GenderType 性別類型。

ImageAsset

圖片素材資源。

欄位
mime_type	MimeType 圖片素材資源的 MIME 類型。
full_size	ImageDimension 這張圖片原始大小的中繼資料。
file_size	int64 圖片素材資源的檔案大小，以位元組為單位。

ImageDimension

特定大小的圖片中繼資料 (不論原始大小或大小經過調整)。

欄位
height_pixels	int64 圖片的高度。
width_pixels	int64 圖片的寬度。
url	string 傳回網址包含此高度和寬度的圖片。

關鍵字

關鍵字條件區隔。

欄位
info	KeywordInfo 關鍵字資訊。
ad_group_criterion	string 廣告群組條件資源名稱。

KeywordInfo

關鍵字條件。

欄位
match_type	KeywordMatchType 關鍵字的比對類型。
text	string 關鍵字文字 (最多 80 個半形字元和 10 個字詞)。

LanguageInfo

語言條件。

欄位
language_constant	string 語言常數資源名稱。

ListingGroupInfo

商家資訊群組條件。

欄位
type	ListingGroupType 產品資訊群組的類型。

LocationGroupInfo

透過動態饋給指定地點清單周圍的半徑。

欄位
geo_target_constants[]	string 指定地理區域常數會限制動態饋給內的地理區域範圍。目前只能使用一個指定地理區域常數。
radius_units	LocationGroupRadiusUnits 半徑單位。地理目標常數支援英里和公尺。動態饋給項目集支援以毫米和公尺為單位。這是必要項目，必須在 CREATE 作業中設定。
feed_item_sets[]	string 已指定 FeedItems 的 FeedItemSets。如果指定多個 ID，系統會指定出現在至少一個組合中的所有項目。這個欄位無法與 Geo_target_constants 搭配使用。此為選用項目，只能在 CREATE 作業中設定。
radius	int64 指定地區周圍半徑單位的距離。這是必要項目，必須在 CREATE 作業中設定。

LocationInfo

位置條件。

欄位
geo_target_constant	string 指定地理區域常數資源名稱。

ManualCpa

這個類型沒有任何欄位。

手動出價策略，可讓廣告客戶依廣告客戶指定的動作設定出價。

ManualCpc

手動單次點擊出價，表示使用者必須按每次點擊付費。

欄位
enhanced_cpc_enabled	bool 是否根據「轉換最佳化工具」資料調整出價。

ManualCpm

這個類型沒有任何欄位。

手動採用以曝光為基礎的出價，使用者按每千次曝光付費。

MaximizeConversionValue

自動出價策略會以您的預算為廣告活動爭取最大轉換價值，

欄位
cpc_bid_ceiling_micros	int64 出價策略可設定的出價上限。這項限制會套用至策略管理的所有關鍵字。僅適用於組合出價策略。
cpc_bid_floor_micros	int64 出價策略可設定的出價下限。這項限制會套用至策略管理的所有關鍵字。僅適用於組合出價策略。
target_roas	double 目標廣告投資報酬率選項。如果設定這項參數，出價策略會盡可能提高收益，同時平均地設定目標廣告投資報酬率。如果目標廣告投資報酬率偏高，出價策略可能無法用完整筆預算。如未設定目標廣告投資報酬率，出價策略會在預算範圍內盡可能達成最高廣告投資報酬率。

MaximizeConversions

一種自動出價策略，用您的預算為廣告活動爭取最多轉換。

欄位
cpc_bid_ceiling_micros	int64 出價策略可設定的出價上限。這項限制會套用至策略管理的所有關鍵字。僅適用於組合出價策略。
cpc_bid_floor_micros	int64 出價策略可設定的出價下限。這項限制會套用至策略管理的所有關鍵字。僅適用於組合出價策略。
target_cpa_micros	int64 目標單次操作出價選項。這是指您願意為單次轉換動作支付的平均金額 (以出價策略貨幣的微單位為單位)。設定這項出價策略後，出價策略就會以指定或更低的單次動作出價，盡可能爭取最多轉換。如未設定目標單次轉換出價，出價策略會在指定預算範圍內盡可能達成最低單次轉換出價目標。

指標

指標資料。

欄位
all_conversions_value_by_conversion_date	double 所有轉換的價值。如果選取這個資料欄和日期，日期欄中的值代表轉換日期。如需 by_conversion_date 欄的詳細資料，請參閱 https://support.google.com/sa360/answer/9250611。
all_conversions_by_conversion_date	double 轉換總次數。無論 include_in_conversions_metric 的價值為何，系統都會計入所有轉換。如果選取這個資料欄和日期，日期欄中的值代表轉換日期。如需 by_conversion_date 欄的詳細資料，請參閱 https://support.google.com/sa360/answer/9250611。
conversion_custom_metrics[]	Value 轉換自訂指標。
conversions_value_by_conversion_date	double 按轉換日期劃分的可出價轉換價值總和。如果選取這個資料欄和日期，日期欄中的值代表轉換日期。
conversions_by_conversion_date	double 可出價轉換類型按轉換日期劃分的轉換總和。受到歸因模式的影響，結果仍可能獲得分數。如果選取這個資料欄和日期，日期欄中的值代表轉換日期。
historical_creative_quality_score	QualityScoreBucket 廣告素材歷來品質分數。
historical_landing_page_quality_score	QualityScoreBucket 歷來到達網頁體驗的品質。
historical_search_predicted_ctr	QualityScoreBucket 歷來搜尋預測點閱率 (CTR)。
interaction_event_types[]	InteractionEventType 應付費和免費互動類型。
raw_event_conversion_metrics[]	Value 原始事件轉換指標。
absolute_top_impression_percentage	double 「搜尋絕對頂端曝光比重」是指有多少百分比的搜尋廣告曝光位於最顯眼的搜尋廣告刊登位置。
all_conversions_from_interactions_rate	double 互動帶來的所有轉換 (意即瀏覽後轉換) 除以廣告互動次數。
all_conversions_value	double 所有轉換的價值。
all_conversions	double 轉換總次數。無論 include_in_conversions_metric 的價值為何，系統都會計入所有轉換。
all_conversions_value_per_cost	double 計算方式是將所有轉換的價值除以廣告互動費用 (例如點擊文字廣告或觀看影片廣告)。
all_conversions_from_click_to_call	double 使用者按下廣告當下或之後，點擊「致電」按鈕致電商家的次數。計算這項數據時，電話接通與否或通話持續時間等因素不會被納入。 這項指標僅適用於動態饋給項目。
all_conversions_from_directions	double 使用者按下廣告後，點選「取得路線」按鈕前往商家的次數。 這項指標僅適用於動態饋給項目。
all_conversions_from_interactions_value_per_interaction	double 將互動帶來的所有轉換值除以互動總數。
all_conversions_from_menu	double 使用者點擊廣告後，點擊連結查看商家選單的次數。 這項指標僅適用於動態饋給項目。
all_conversions_from_order	double 使用者按下廣告後下單的次數。 這項指標僅適用於動態饋給項目。
all_conversions_from_other_engagement	double 使用者按下廣告後，發生其他轉換的次數 (例如張貼評論或儲存商家地點)。 這項指標僅適用於動態饋給項目。
all_conversions_from_store_visit	double 使用者點擊廣告後親臨門市的預估次數。 這項指標僅適用於動態饋給項目。
visits	double Search Ads 360 成功記錄並轉送至廣告客戶到達網頁的點擊。
all_conversions_from_store_website	double 使用者點擊廣告後，前往商店網址的次數。 這項指標僅適用於動態饋給項目。
average_cost	double 您為每次互動支付的平均金額。計算方式是將廣告總費用除以互動總次數。
average_cpc	double 所有點擊的總費用除以獲得的點擊總數。這項指標預設為貨幣價值，且預設為以客戶幣別傳回。請查看 metric_currency 參數：https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
average_cpm	double 平均千次曝光出價這項指標預設為貨幣價值，且預設為以客戶幣別傳回。請查看 metric_currency 參數：https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clicks	int64 點擊次數。
content_budget_lost_impression_share	double 廣告因為預算過低而無法在多媒體廣告聯播網上顯示的預估次數百分比。注意：內容預算錯失的曝光比重會以 0 到 0.9 的範圍表示。系統會將超過 0.9 的值回報為 0.9001。
content_impression_share	double 將您在多媒體廣告聯播網上獲得的曝光次數除以預估可獲得的曝光次數後，所得到的百分比。注意：系統回報的內容曝光比重介於 0.1 到 1 之間。系統會將低於 0.1 的值回報為 0.0999。
content_rank_lost_impression_share	double 廣告因為廣告評級不佳，而無法在多媒體廣告聯播網上獲得的曝光次數預估百分比。注意：系統記錄的「多媒體廣告聯播網：錯失的曝光比重」會以 0 到 0.9 的範圍內。系統會將超過 0.9 的值回報為 0.9001。
conversions_from_interactions_rate	double 單次轉換有效互動的平均可出價轉換 (來自互動)。顯示廣告互動促成可出價轉換的平均頻率，
client_account_conversions_value	double 客戶帳戶轉換價值。僅納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用轉換型出價，出價策略會調整設定來爭取這些轉換。
conversions_value_per_cost	double 可出價轉換的價值除以有效轉換互動的總成本。
conversions_from_interactions_value_per_interaction	double 互動轉換價值除以廣告互動次數。僅納入 include_in_conversions_metric 屬性設為 true 的轉換動作。如果您使用轉換型出價，出價策略會調整設定來爭取這些轉換。
client_account_conversions	double 客戶帳戶轉換次數。僅納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用轉換型出價，出價策略會調整設定來爭取這些轉換。
cost_micros	int64 在這段期間內，您的單次點擊出價和千次曝光出價總和。這項指標預設為貨幣價值，且預設為以客戶幣別傳回。請查看 metric_currency 參數：https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
cost_per_all_conversions	double 廣告互動費用除以所有轉換。
cost_per_conversion	double 平均轉換符合資格的單次可出價轉換費用。
cost_per_current_model_attributed_conversion	double 廣告互動費用除以目前的模式歸因轉換次數。僅納入 include_in_conversions_metric 屬性設為 true 的轉換動作。如果您使用轉換型出價，出價策略會調整設定來爭取這些轉換。
cross_device_conversions	double 客戶在一個裝置上點擊廣告，然後使用其他裝置或瀏覽器完成轉換。跨裝置轉換已納入 all_conversions 中。
cross_device_conversions_value	double 跨裝置轉換的價值總和。
ctr	double 廣告獲得的點擊次數 (點擊次數) 除以廣告顯示次數 (曝光次數)。
conversions	double 轉換次數。僅納入 include_in_conversions_metric 屬性設為 true 的轉換動作。如果您使用轉換型出價，出價策略會調整設定來爭取這些轉換。
conversions_value	double 「轉換」欄位中所含轉換的轉換價值總和。您為轉換動作輸入價值後，這項指標才能派上用場。
historical_quality_score	int64 歷來品質分數。
impressions	int64 廣告在搜尋結果網頁或 Google 聯播網網站上顯示的頻率。
interaction_rate	double 使用者看到廣告後與廣告互動的頻率。計算方式為互動次數除以廣告顯示次數。
interactions	int64 互動次數。「互動」是指與文字廣告和購物廣告的廣告格式點擊、觀看影片廣告觀看等動作相關的主要使用者動作。
invalid_click_rate	double 報表統計期內，從點擊總數 (已篩選 + 未篩選的點擊) 中篩除的點擊所佔的百分比。
invalid_clicks	int64 Google 認為點擊次數不合理，因此沒有向您收費。
mobile_friendly_clicks_percentage	double 前往行動裝置友善網頁的行動點擊百分比。
search_absolute_top_impression_share	double 消費者的購物或搜尋廣告曝光中，出現在最顯眼的購物廣告位置所佔百分比。詳情請參閱 https://support.google.com/sa360/answer/9566729。系統會將低於 0.1 的值回報為 0.0999。
search_budget_lost_absolute_top_impression_share	double 這個數字代表了廣告因預算偏低，而無法讓搜尋結果排名顯示於搜尋結果頂端廣告的頻率。注意：搜尋聯播網預算錯失的絕對頂端曝光比重，會以 0 到 0.9 的範圍表示。系統會將超過 0.9 的值回報為 0.9001。
search_budget_lost_impression_share	double 廣告因為預算過低而無法在搜尋聯播網上顯示的預估百分比。注意：搜尋聯播網預算錯失的曝光比重會以 0 到 0.9 的範圍表示。系統會將超過 0.9 的值回報為 0.9001。
search_budget_lost_top_impression_share	double 這個數字用來估算廣告因預算偏低，而無法在熱門自然搜尋結果旁顯示的頻率。注意：搜尋聯播網預算錯失的頂端曝光比重，會以 0 到 0.9 的範圍表示。系統會將超過 0.9 的值回報為 0.9001。
search_click_share	double 將廣告在搜尋聯播網上實際獲得的點擊次數，除以預估可獲得的點擊次數後，所算出的百分比。注意：搜尋點擊比重的範圍以 0.1 到 1 的範圍表示。系統會將低於 0.1 的值回報為 0.0999。
search_exact_match_impression_share	double 計算方式是將您的廣告在搜尋聯播網上實際預估可獲得的曝光次數，除以與您關鍵字完全相符 (或關鍵字的近似變體) (不採用關鍵字比對類型) 所帶來的預估次數。注意：搜尋聯播網完全比對曝光比重會顯示在 0.1 到 1 的範圍內。系統會將低於 0.1 的值回報為 0.0999。
search_impression_share	double 將您在搜尋聯播網上獲得的曝光次數，除以預估可獲得的曝光次數後所算出的百分比。注意：搜尋聯播網曝光比重會以 0.1 到 1 的範圍表示。系統會將低於 0.1 的值回報為 0.0999。
search_rank_lost_absolute_top_impression_share	double 這個數字用來估算由於廣告評級不佳，導致廣告無法排在搜尋結果頂端廣告的頻率。注意：「搜尋聯播網：錯失的絕對頂端曝光比重」會以 0 到 0.9 的範圍表示。系統會將超過 0.9 的值回報為 0.9001。
search_rank_lost_impression_share	double 您的廣告因為廣告評級不佳，而無法在搜尋聯播網中獲得的曝光次數預估百分比。注意：排名錯失的曝光比重會顯示在 0 到 0.9 的範圍內。系統會將超過 0.9 的值回報為 0.9001。
search_rank_lost_top_impression_share	double 這項指標用來估算廣告因為廣告評級不佳，而無法在熱門自然搜尋結果旁顯示的頻率。注意：「搜尋聯播網排名錯失的頂端曝光比重」會以 0 到 0.9 的範圍表示。系統會將超過 0.9 的值回報為 0.9001。
search_top_impression_share	double 相較於頂端廣告的預估曝光次數，您從頂端廣告實際獲得的曝光次數。注意：搜尋聯播網頂端曝光比重會以 0.1 到 1 的範圍表示。系統會將低於 0.1 的值回報為 0.0999。 頂端廣告通常刊登在頂端自然搜尋結果上方，但視查詢而定，也可能出現在這類搜尋結果底下。
top_impression_percentage	double 顯示在頂端自然搜尋結果旁邊的廣告曝光百分比。
value_per_all_conversions	double 所有轉換的價值除以所有轉換次數。
value_per_all_conversions_by_conversion_date	double 所有轉換的價值除以所有轉換次數。如果選取這個資料欄和日期，日期欄中的值代表轉換日期。如需 by_conversion_date 欄的詳細資料，請參閱 https://support.google.com/sa360/answer/9250611。
value_per_conversion	double 可出價轉換的價值除以可出價轉換次數。顯示每次轉換的平均價值。
value_per_conversions_by_conversion_date	double 按轉換日期劃分的可出價轉換價值除以轉換日期，藉此算出可出價轉換。顯示每次轉換的平均價值 (依轉換日期)。如果選取這個資料欄和日期，日期欄中的值代表轉換日期。
client_account_view_through_conversions	int64 瀏覽後轉換總次數。如果客戶看到圖像或互動式多媒體廣告，之後未與另一個廣告互動 (例如點擊) 在您的網站上完成轉換，就算是一次轉換。
client_account_cross_sell_cost_of_goods_sold_micros	int64 「客戶帳戶交叉銷售銷貨成本」(COGS) 是指因廣告宣傳某項產品而售出其他產品所產生的總成本。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符，就屬於交叉銷售。「交叉銷售銷貨成本」是指所售出非宣傳產品的總費用。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。帽子的銷貨成本價值是 $3 美元，上衣則是 $5 美元。這筆訂單的交叉銷售銷貨成本為 NT $150 元。您必須透過購物車資料回報轉換資訊，才能使用這項指標。這項指標預設為貨幣價值，且預設為以客戶幣別傳回。請查看 metric_currency 參數：https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
cross_sell_cost_of_goods_sold_micros	int64 「交叉銷售銷貨成本」(COGS) 是指因廣告宣傳某項產品而售出其他產品所產生的總成本。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符，就屬於交叉銷售。「交叉銷售銷貨成本」是指所售出非宣傳產品的總費用。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。帽子的銷貨成本價值是 $3 美元，上衣則是 $5 美元。這筆訂單的交叉銷售銷貨成本為 NT $150 元。您必須透過購物車資料回報轉換資訊，才能使用這項指標。這項指標預設為貨幣價值，且預設為以客戶幣別傳回。請查看 metric_currency 參數：https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
client_account_cross_sell_gross_profit_micros	int64 「客戶帳戶交叉銷售毛利」是指扣除銷貨成本 (COGS) 後，因廣告宣傳某項產品而售出其他產品所產生的利潤。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。購買清單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符，就屬於交叉銷售。「交叉銷售毛利」是指扣除銷貨成本後，廣告中交叉銷售所帶來的收益。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。上衣的售價是 NT$600 元，銷貨成本價值則是 NT$150 元。這筆訂單的交叉銷售毛利計算方式為 NT $600 元 - NT $150 元 = NT$450 元。您必須透過購物車資料回報轉換資訊，才能使用這項指標。這項指標預設為貨幣價值，且預設為以客戶幣別傳回。請查看 metric_currency 參數：https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
cross_sell_gross_profit_micros	int64 「交叉銷售毛利」是指扣除銷貨成本 (COGS) 後，因廣告宣傳某項產品而售出其他產品所產生的利潤。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。購買清單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符，就屬於交叉銷售。「交叉銷售毛利」是指扣除銷貨成本後，廣告中交叉銷售所帶來的收益。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。上衣的售價是 NT$600 元，銷貨成本價值則是 NT$150 元。這筆訂單的交叉銷售毛利計算方式為 NT $600 元 - NT $150 元 = NT$450 元。您必須透過購物車資料回報轉換資訊，才能使用這項指標。這項指標預設為貨幣價值，且預設為以客戶幣別傳回。請查看 metric_currency 參數：https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
client_account_cross_sell_revenue_micros	int64 「客戶帳戶交叉銷售收益」是指因廣告宣傳某項產品而售出其他產品所賺取的總金額。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符，就屬於交叉銷售。「交叉銷售收益」是指廣告中交叉銷售所產生的總價值。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。帽子的售價是 $10 美元，上衣則是 $20 美元。這筆訂單的交叉銷售收益為 NT $600 元。您必須透過購物車資料回報轉換資訊，才能使用這項指標。這項指標預設為貨幣價值，且預設為以客戶幣別傳回。請查看 metric_currency 參數：https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
cross_sell_revenue_micros	int64 「交叉銷售收益」是指因廣告宣傳某項產品而售出其他產品所賺取的總金額。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符，就屬於交叉銷售。「交叉銷售收益」是指廣告中交叉銷售所產生的總價值。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。帽子的售價是 $10 美元，上衣則是 $20 美元。這筆訂單的交叉銷售收益為 NT $600 元。您必須透過購物車資料回報轉換資訊，才能使用這項指標。這項指標預設為貨幣價值，且預設為以客戶幣別傳回。請查看 metric_currency 參數：https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
client_account_cross_sell_units_sold	double 「客戶帳戶交叉銷售商品售出數量」是指因廣告宣傳某項產品而售出的其他產品總數。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符，就屬於交叉銷售。「交叉銷售商品售出數量」是指廣告的所有訂單帶來的交叉銷售產品總數。舉例來說，消費者點按帽子的購物廣告後，購買了同一款帽子、一件上衣和一件夾克。這筆訂單的交叉銷售商品售出數量為 2。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
cross_sell_units_sold	double 「交叉銷售商品售出數量」是指因廣告宣傳某項產品而售出的其他產品總數。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符，就屬於交叉銷售。「交叉銷售商品售出數量」是指廣告的所有訂單帶來的交叉銷售產品總數。舉例來說，消費者點按帽子的購物廣告後，購買了同一款帽子、一件上衣和一件夾克。這筆訂單的交叉銷售商品售出數量為 2。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
client_account_lead_cost_of_goods_sold_micros	int64 「客戶帳戶廣告產品銷貨成本」(COGS) 是指因廣告宣傳產品而售出該產品的總成本。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果使用者互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符，這些商品的成本就會計入廣告產品銷貨成本。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。帽子的銷貨成本價值是 $3 美元，上衣則是 $5 美元。這筆訂單的廣告產品銷貨成本為 NT $90 元。您必須透過購物車資料回報轉換資訊，才能使用這項指標。這項指標預設為貨幣價值，且預設為以客戶幣別傳回。請查看 metric_currency 參數：https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
lead_cost_of_goods_sold_micros	int64 「廣告產品銷貨成本」(COGS) 是指因廣告宣傳產品而售出該產品的總成本。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果使用者互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符，這些商品的成本就會計入廣告產品銷貨成本。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。帽子的銷貨成本價值是 $3 美元，上衣則是 $5 美元。這筆訂單的廣告產品銷貨成本為 NT $90 元。您必須透過購物車資料回報轉換資訊，才能使用這項指標。這項指標預設為貨幣價值，且預設為以客戶幣別傳回。請查看 metric_currency 參數：https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
client_account_lead_gross_profit_micros	int64 「客戶帳戶廣告產品毛利」是指扣除銷貨成本 (COGS) 後，因廣告宣傳產品而售出該產品所產生的利潤。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符，產生的銷售收益扣除銷貨成本，就是廣告產品毛利。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。帽子的售價是 NT$300 元，銷貨成本價值則是 NT$90 元。這筆訂單的廣告產品毛利計算方式為 NT $300 元 - NT $90 元 = NT$210 元。您必須透過購物車資料回報轉換資訊，才能使用這項指標。這項指標預設為貨幣價值，且預設為以客戶幣別傳回。請查看 metric_currency 參數：https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
lead_gross_profit_micros	int64 「廣告產品毛利」是指扣除銷貨成本 (COGS) 後，因廣告宣傳產品而售出該產品所產生的利潤。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符，產生的銷售收益扣除銷貨成本，就是廣告產品毛利。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。帽子的售價是 NT$300 元，銷貨成本價值則是 NT$90 元。這筆訂單的廣告產品毛利計算方式為 NT $300 元 - NT $90 元 = NT$210 元。您必須透過購物車資料回報轉換資訊，才能使用這項指標。這項指標預設為貨幣價值，且預設為以客戶幣別傳回。請查看 metric_currency 參數：https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
client_account_lead_revenue_micros	int64 「客戶帳戶廣告產品收益」是指因廣告宣傳產品而售出該產品所賺取的總金額。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符，廣告產品收益中就會顯示這些產品的銷售總價值。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。帽子的售價是 $10 美元，上衣則是 $20 美元。這筆訂單的廣告產品收益為 NT $300 元。您必須透過購物車資料回報轉換資訊，才能使用這項指標。這項指標預設為貨幣價值，且預設為以客戶幣別傳回。請查看 metric_currency 參數：https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
lead_revenue_micros	int64 「廣告產品收益」是指因廣告宣傳產品而售出該產品所賺取的總金額。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符，廣告產品收益中就會顯示這些產品的銷售總價值。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。帽子的售價是 $10 美元，上衣則是 $20 美元。這筆訂單的廣告產品收益為 NT $300 元。您必須透過購物車資料回報轉換資訊，才能使用這項指標。這項指標預設為貨幣價值，且預設為以客戶幣別傳回。請查看 metric_currency 參數：https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
client_account_lead_units_sold	double 「客戶帳戶廣告產品售出數量」是指因廣告宣傳產品而售出的該產品總數。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符，廣告商品售出數量中就會顯示售出產品總數。舉例來說，消費者點按帽子的購物廣告後，購買了同一款帽子、一件上衣和一件夾克。這筆訂單的廣告商品售出數量為 1。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
lead_units_sold	double 「廣告商品售出數量」是指因廣告宣傳產品而售出的該產品總數。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符，廣告商品售出數量中就會顯示售出產品總數。舉例來說，消費者點按帽子的購物廣告後，購買了同一款帽子、一件上衣和一件夾克。這筆訂單的廣告商品售出數量為 1。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。

MobileAppAsset

代表行動應用程式的素材資源。

欄位
app_id	string 必要欄位。用以識別行動應用程式的字串。只能包含平台原生 ID，例如「com.android.ebay」(Android 為「com.android.ebay」) 或 iOS 的「12345689」(iOS)。
app_store	MobileAppVendor 必要欄位。發行這個特定應用程式的應用程式商店。

PercentCpc

一種出價策略，也就是根據商品或服務，出價只佔廣告價格的一部分。

欄位
cpc_bid_ceiling_micros	int64 出價策略可設定的出價上限。此為選填欄位，由廣告客戶輸入，以當地微量形式指定。注意：零值解讀方式與未定義出價上限相同。
enhanced_cpc_enabled	bool 根據轉換發生的可能性，調高或調低每次競價的出價。個別出價可能會超過 cpc_bid_loo_micros ，但單一廣告活動的平均出價金額則不在此限。

RealTimeBiddingSetting

即時出價設定；只有指定 Ad Exchange 聯播網的廣告活動才能使用這項功能。

欄位
opt_in	bool 指出廣告活動是否選擇採用即時出價。

SearchAds360ExpandedDynamicSearchAdInfo

延展型動態搜尋廣告。

欄位
description1	string 廣告說明的第一行。
description2	string 廣告說明的第二行。
ad_tracking_id	int64 廣告的追蹤 ID。

SearchAds360ExpandedTextAdInfo

Search Ads 360 延展型文字廣告。

欄位
headline	string 廣告標題。
headline2	string 廣告的第二個標題。
headline3	string 廣告的第三個廣告標題。
description1	string 廣告說明的第一行。
description2	string 廣告說明的第二行。
path1	string 附加至自動產生的可見網址的文字，結尾附有分隔符號。
path2	string 附加至 path1 且含分隔符號的文字。
ad_tracking_id	int64 廣告的追蹤 ID。

SearchAds360ProductAdInfo

這個類型沒有任何欄位。

Search Ads 360 產品廣告。

SearchAds360ResponsiveSearchAdInfo

Search Ads 360 回應式搜尋廣告。

欄位
path1	string 附加至自動產生的可見網址的文字，結尾附有分隔符號。
path2	string 附加至 path1 且含分隔符號的文字。
ad_tracking_id	int64 廣告的追蹤 ID。

SearchAds360TextAdInfo

Search Ads 360 文字廣告。

欄位
headline	string 廣告標題。
description1	string 廣告說明的第一行。
description2	string 廣告說明的第二行。
display_url	string 廣告的顯示網址。
display_mobile_url	string 廣告的顯示行動版網址。
ad_tracking_id	int64 廣告的追蹤 ID。

路段

僅限區隔的欄位。

欄位
ad_network_type	AdNetworkType 廣告聯播網類型。
conversion_action_category	ConversionActionCategory 轉換動作類別。
conversion_custom_dimensions[]	Value 轉換自訂維度。
day_of_week	DayOfWeek 星期幾，例如 MONDAY。
device	Device 要套用指標的裝置。
keyword	Keyword 關鍵字條件。
product_channel	ProductChannel 產品的頻道。
product_channel_exclusivity	ProductChannelExclusivity 產品的通路獨佔性。
product_condition	ProductCondition 產品狀況，
product_sold_condition	ProductCondition 售出產品的狀況。
raw_event_conversion_dimensions[]	Value 原始事件轉換維度。
conversion_action	string 轉換動作的資源名稱。
conversion_action_name	string 轉換動作名稱。
date	string 指標適用的日期。格式為 yyyy-MM-dd，例如「2018-04-17」。
month	string 以每月第一天的日期表示的月份。格式為「yyyy-MM-dd」。
product_bidding_category_level1	string 產品的出價類別 (層級 1)。
product_bidding_category_level2	string 產品的出價類別 (層級 2)。
product_bidding_category_level3	string 產品的出價類別 (層級 3)。
product_bidding_category_level4	string 產品的出價類別 (層級 4)。
product_bidding_category_level5	string 產品的出價類別 (層級 5)。
product_brand	string 產品的品牌。
product_country	string 產品銷售國家/地區的指定地理區域常數資源名稱。
product_custom_attribute0	string 產品的自訂屬性 0。
product_custom_attribute1	string 產品的自訂屬性 1。
product_custom_attribute2	string 產品的自訂屬性 2。
product_custom_attribute3	string 產品的自訂屬性 3。
product_custom_attribute4	string 產品的自訂屬性 4。
product_item_id	string 產品的項目 ID。
product_language	string 產品語言的語言常數資源名稱。
product_sold_bidding_category_level1	string 售出產品的出價類別 (層級 1)。
product_sold_bidding_category_level2	string 售出產品的出價類別 (層級 2)。
product_sold_bidding_category_level3	string 售出產品的出價類別 (層級 3)。
product_sold_bidding_category_level4	string 售出產品的出價類別 (層級 4)。
product_sold_bidding_category_level5	string 售出產品的出價類別 (層級 5)。
product_sold_brand	string 售出產品的品牌。
product_sold_custom_attribute0	string 售出產品的自訂屬性 0。
product_sold_custom_attribute1	string 售出產品的自訂屬性 1。
product_sold_custom_attribute2	string 售出產品的自訂屬性 2。
product_sold_custom_attribute3	string 售出產品的自訂屬性 3。
product_sold_custom_attribute4	string 售出產品的自訂屬性 4。
product_sold_item_id	string 售出產品的項目 ID。
product_sold_title	string 售出產品的名稱。
product_sold_type_l1	string 售出產品的類型 (第 1 層)。
product_sold_type_l2	string 售出產品的類型 (第 2 層)。
product_sold_type_l3	string 售出產品的類型 (第 3 層)。
product_sold_type_l4	string 售出產品的類型 (第 4 層)。
product_sold_type_l5	string 售出產品的類型 (第 5 層)。
product_store_id	string 產品的商店 ID。
product_title	string 產品的標題。
product_type_l1	string 產品的類型 (第 1 級)。
product_type_l2	string 產品的類型 (第 2 級)。
product_type_l3	string 產品的類型 (第 3 級)。
product_type_l4	string 產品的類型 (第 4 級)。
product_type_l5	string 產品的類型 (第 5 級)。
quarter	string 季度，以季度第一天的日期表示。使用當季季度，例如 2018 年第二季是從 2018 年 4 月 1 日開始。格式為「yyyy-MM-dd」。
week	string 一週的定義為星期一到星期日，以星期一的日期表示。格式為「yyyy-MM-dd」。
year	int32 年，格式為 yyyy。
asset_interaction_target	AssetInteractionTarget 只搭配 CustomerAsset、CampaignAsset 和 adAsset 指標使用。指出互動指標是發生在素材資源本身，還是其他素材資源/廣告單元上。當廣告放送的所有部分 (例如「廣告本身」和「網站連結」等其他元件) 一起放送時，系統會將互動 (例如點擊) 計算在內。如果 engagement_on_this_asset 為 true，代表互動位於此特定素材資源，當 engagement_on_this_asset 為 false 時，表示互動並非在這個特定素材資源上，而是在放送此素材資源的廣告的其他部分發生。

TargetCpa

「目標單次轉換出價」是一種自動出價策略，可按照您指定的目標單次轉換出價盡量爭取轉換。

欄位
target_cpa_micros	int64 平均單次轉換出價目標。這個指定目標必須大於或等於最低計費單位 (以帳戶幣別為準)。
cpc_bid_ceiling_micros	int64 出價策略可設定的出價上限。這項限制會套用至策略管理的所有關鍵字。建議您只針對組合出價策略進行設定。
cpc_bid_floor_micros	int64 出價策略可設定的出價下限。這項限制會套用至策略管理的所有關鍵字。建議您只針對組合出價策略進行設定。

TargetCpm

這個類型沒有任何欄位。

「目標千次曝光出價」是一種自動出價策略，可根據您指定的目標千次曝光出價設定出價，盡可能提高成效。

TargetImpressionShare

這項自動出價策略可設定出價，讓特定百分比的搜尋廣告顯示在第一頁 (或其他目標地區) 的頂端。

欄位
location	TargetImpressionShareLocation 搜尋結果網頁上的目標地區。
location_fraction_micros	int64 選擇在目標地區顯示的廣告比例 (以百萬分之一為單位)。例如，1% 等於 10,000。
cpc_bid_ceiling_micros	int64 自動出價系統允許指定的最高單次點擊出價。這是廣告客戶輸入的必填欄位，可以設定上限值 (以當地微秒為單位)。

TargetOutrankShare

一種自動出價策略，會根據指定競價的目標比例設定出價，而廣告客戶應以高於特定競爭對手的排名做為出價。此策略已淘汰。

欄位
cpc_bid_ceiling_micros	Int64Value 出價策略可設定的出價上限。這項限制會套用至策略管理的所有關鍵字。

TargetRestriction

列出指定維度的設定。

欄位
targeting_dimension	TargetingDimension 要套用這些設定的指定目標維度。
bid_only	bool 指出是否限制廣告只針對您為這個「target_dimension」所選的條件顯示，或是指定這個「指定維度」的所有值，並根據您在其他「指定維度」中的指定目標顯示廣告。如果值為 true，表示這些條件只會套用出價調節係數，不會影響指定目標。如果值為 false，表示這些條件會限制指定目標並套用出價調節係數。

TargetRoas

這是一種自動出價策略，可協助您提高收益，同時平均分配特定的目標廣告投資報酬率。

欄位
target_roas	double 必要欄位。每單位支出的所選收益 (根據轉換資料)。值必須介於 0.01 到 1000.0 (含) 之間。
cpc_bid_ceiling_micros	int64 出價策略可設定的出價上限。這項限制會套用至策略管理的所有關鍵字。建議您只針對組合出價策略進行設定。
cpc_bid_floor_micros	int64 出價策略可設定的出價下限。這項限制會套用至策略管理的所有關鍵字。建議您只針對組合出價策略進行設定。

TargetSpend

「自動出價策略」會自動設定出價，在預算範圍內盡量爭取點擊。

欄位
target_spend_micros (deprecated)	int64 這個項目現已淘汰！ 盡量爭取點擊的支出目標。目標支出出價工具會嘗試支出這個值中較小的值或自然調節支出金額。如果未指定，則會使用預算做為支出目標。這個欄位已淘汰，不應再使用。詳情請參閱 https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html。
cpc_bid_ceiling_micros	int64 出價策略可設定的出價上限。這項限制會套用至策略管理的所有關鍵字。

TargetingSetting

廣告活動和廣告群組層級的指定目標相關功能設定。如要進一步瞭解指定目標設定，請參閱 https://support.google.com/google-ads/answer/7365594

欄位
target_restrictions[]	TargetRestriction 個別指定目標的維度設定，用於限制廣告活動或廣告群組的觸及範圍。

TextAsset

文字素材資源。

欄位
text	string 文字素材資源的文字內容。

TextLabel

一種標籤類型，以彩色背景顯示文字。

欄位
background_color	string 標籤的背景顏色，採用 RGB 格式。此字串必須符合規則運算式 '^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'。注意：管理員帳戶可能看不到背景顏色。
description	string 標籤的簡短說明，長度不可超過 200 個字元。

UnifiedCallAsset

統合的電話素材資源。

欄位
country_code	string 電話號碼的雙字母國家/地區代碼。例如：「US」、「us」。
phone_number	string 廣告客戶的原始電話號碼。範例：「1234567890」、「[phone]」
call_conversion_reporting_state	CallConversionReportingState 指出這項 CallAsset 是否應使用自己的來電轉換設定、採用帳戶層級設定，還是停用來電轉換。
call_conversion_action	string 要將來電轉換歸因於哪個轉換動作。如果未設定，系統會採用預設的轉換動作。只有在 call_conversion_reporting_state 設為 USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION 時，這個欄位才會生效。
ad_schedule_targets[]	AdScheduleInfo 非重疊時段清單，用於指定素材資源可能放送的所有時間間隔。每天最多只能有 6 個時間表，共 42 個。
call_only	bool 來電是否只顯示沒有網站連結的電話號碼。適用於 Microsoft Ads。
call_tracking_enabled	bool 是否應啟用來電追蹤。適用於 Microsoft Ads。
use_searcher_time_zone	bool 是否要在搜尋使用者的時區中顯示來電額外資訊。適用於 Microsoft Ads。
start_date	string 此素材資源有效且可以開始放送的開始日期，格式為 yyyy-MM-dd。
end_date	string 這項素材資源有效且仍在放送中的最後日期，格式為 yyyy-MM-dd。

UnifiedCalloutAsset

統一摘要素材資源。

欄位
callout_text	string 摘要文字。此字串長度必須介於 1 到 25 (含) 個字元之間。
start_date	string 此素材資源有效且可以開始放送的開始日期，格式為 yyyy-MM-dd。
end_date	string 這項素材資源有效且仍在放送中的最後日期，格式為 yyyy-MM-dd。
ad_schedule_targets[]	AdScheduleInfo 非重疊時段清單，用於指定素材資源可能放送的所有時間間隔。每天最多只能有 6 個時間表，共 42 個。
use_searcher_time_zone	bool 是否要在搜尋使用者的時區中顯示素材資源。適用於 Microsoft Ads。

UnifiedLocationAsset

統一的地點素材資源。

欄位
place_id	string 地點 ID 可以用來辨識 Google 地點介面集資料庫和 Google 地圖中的特定地點。只能針對特定客戶 ID 和素材資源類型填寫這個欄位。請參閱 https://developers.google.com/places/web-service/place-id，進一步瞭解地點 ID。
business_profile_locations[]	BusinessProfileLocation 客戶的商家所在地點清單。只有在從商家檔案帳戶同步處理地點素材資源時，才會傳回這個值。同一個帳戶可能有多個商家檔案資訊指向同一個地點 ID。
location_ownership_type	LocationOwnershipType 地點擁有權的類型。如果類型是「BUSINESS_OWNER」，就會以地點額外資訊的形式提供。如果類型是「聯盟」，就會做為經銷地點。

UnifiedPageFeedAsset

統一網頁動態饋給素材資源。

欄位
page_url	string 廣告客戶想指定的網頁。
labels[]	string 用來將網頁網址分組的標籤。

UnifiedSitelinkAsset

統合的網站連結素材資源。

欄位
link_text	string 網站連結的網址顯示文字。此字串長度必須介於 1 到 25 (含) 個字元之間。
description1	string 網站連結說明的第一行。如有設定，必須一併設定長度介於 1 到 35 之間 (含首尾)，並且包含 description2。
description2	string 網站連結說明的第二行。如有設定，必須一併設定長度介於 1 到 35 之間 (含首尾)，並且包含 description1。
start_date	string 此素材資源有效且可以開始放送的開始日期，格式為 yyyy-MM-dd。
end_date	string 這項素材資源有效且仍在放送中的最後日期，格式為 yyyy-MM-dd。
ad_schedule_targets[]	AdScheduleInfo 非重疊時段清單，用於指定素材資源可能放送的所有時間間隔。每天最多只能有 6 個時間表，共 42 個。
tracking_id	int64 用於追蹤網站連結素材資源點擊次數的 ID。這是 Yahoo!欄位。
use_searcher_time_zone	bool 是否要在搜尋使用者的時區中顯示網站連結素材資源。適用於 Microsoft Ads。
mobile_preferred	bool 是否偏好在行動裝置上顯示網站連結素材資源。適用於 Microsoft Ads。

UserListInfo

使用者名單條件。代表由廣告客戶指定指定的使用者名單。

欄位
user_list	string 使用者名單資源名稱。

值

一般資料容器。

欄位
聯集欄位 value。值。value 只能是下列其中一項：
boolean_value	bool 布林值。
int64_value	int64 int64。
float_value	float 一個浮點值，
double_value	double 雙倍。
string_value	string 字串。

WebpageConditionInfo

用於指定廣告客戶網站網頁的邏輯運算式。

欄位
operand	WebpageConditionOperand 網頁指定條件的運算元。
operator	WebpageConditionOperator 網頁指定條件的運算子。
argument	string 網頁指定條件的引數。

WebpageInfo

代表指定廣告客戶網站網頁的條件。

欄位
conditions[]	WebpageConditionInfo 用於指定網頁的條件或邏輯運算式。系統在評估指定目標時，會將網頁指定條件清單一併納入考量。如果條件清單空白，表示已指定廣告活動網站的所有網頁。 這是 CREATE 作業的必填欄位，不得用於 UPDATE 作業。
coverage_percentage	double 網站條件涵蓋率百分比。這是指根據廣告群組和廣告活動中的網站目標、排除網站目標和排除關鍵字，計算出的網站涵蓋率百分比。舉例來說，如果涵蓋率傳回為 1，表示其涵蓋率為 100%。這是唯讀欄位。
criterion_name	string 由這個參數定義的條件名稱。名稱值將用於識別、排序以及篩選這類參數類型的條件。 這是 CREATE 作業的必填欄位，不得用於 UPDATE 作業。

YoutubeVideoAsset

YouTube 資產。

欄位
youtube_video_title	string YouTube 影片標題。
youtube_video_id	string YouTube 影片 ID。這是 YouTube 影片網址中使用的 11 個字元字串值。