Package google.ads.searchads360.v0.resources

索引

• AccessibleBiddingStrategy (訊息)
• AccessibleBiddingStrategy.MaximizeConversionValue (訊息)
• AccessibleBiddingStrategy.MaximizeConversions (訊息)
• AccessibleBiddingStrategy.TargetCpa (訊息)
• AccessibleBiddingStrategy.TargetImpressionShare (訊息)
• AccessibleBiddingStrategy.TargetRoas (訊息)
• AccessibleBiddingStrategy.TargetSpend (訊息)
• Ad (訊息)
• AdGroup (訊息)
• AdGroupAd (訊息)
• AdGroupAdEffectiveLabel (訊息)
• AdGroupAdLabel (訊息)
• AdGroupAsset (訊息)
• AdGroupAssetSet (訊息)
• AdGroupAudienceView (訊息)
• AdGroupBidModifier (訊息)
• AdGroupCriterion (訊息)
• AdGroupCriterion.PositionEstimates (訊息)
• AdGroupCriterion.QualityInfo (訊息)
• AdGroupCriterionEffectiveLabel (訊息)
• AdGroupCriterionLabel (訊息)
• AdGroupEffectiveLabel (訊息)
• 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 (訊息)
• CampaignEffectiveLabel (訊息)
• 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 (訊息)
• UserLocationView (訊息)
• Visit (訊息)
• WebpageView (訊息)

AccessibleBiddingStrategy

代表客戶擁有及與客戶共用的 BiddingStrategies 檢視畫面。

與 BiddingStrategy 不同，這個資源除了包含這個客戶擁有的策略，也包含客戶管理員擁有的策略，以及與這個客戶共用的策略。這個資源不會提供指標，只會公開一小部分的出價策略屬性。

欄位
resource_name	string 可存取出價策略的資源名稱。AccessibleBiddingStrategy 資源名稱的格式如下： customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}
id	int64 出價策略的 ID。
name	string 出價策略的名稱。
type	BiddingStrategyType 出價策略類型。
owner_customer_id	int64 擁有出價策略的客戶 ID。
owner_descriptive_name	string 擁有出價策略的客戶描述性名稱。
聯集欄位 scheme。出價架構。 只能設定一個。scheme 只能是下列其中一項：
maximize_conversion_value	MaximizeConversionValue 自動出價策略，可協助您在預算範圍內，為廣告活動爭取最高轉換價值。
maximize_conversions	MaximizeConversions 這項自動出價策略可協助您在預算範圍內，為廣告活動爭取最多轉換。
target_cpa	TargetCpa 這是一種出價策略，可根據您指定的目標單次轉換出價設定出價，盡量為您爭取轉換。
target_impression_share	TargetImpressionShare 這項出價策略會根據您選擇的曝光百分比，自動進行最佳化調整。
target_roas	TargetRoas 這項出價策略可協助您盡量提高收益，同時將目標廣告投資報酬率設為平均值。
target_spend	TargetSpend 這是一種出價策略，可為您設定出價，在預算範圍內盡可能爭取點擊。

MaximizeConversionValue

自動出價策略，可協助您在預算範圍內，為廣告活動爭取最高轉換價值。

欄位
target_roas	double 目標廣告投資報酬率選項。如果設定了目標廣告投資報酬率，出價策略會盡量提高收益，同時將目標廣告投資報酬率設為平均值。如果目標廣告投資報酬率很高，出價策略可能無法用完預算。如未設定目標廣告投資報酬率，出價策略會盡量提高預算的廣告投資報酬率。

MaximizeConversions

這項自動出價策略可協助您在預算範圍內，為廣告活動爭取最多轉換。

欄位
target_cpa	int64 目標單次動作出價選項。這是指您願意為每次獲取支付的平均金額。
target_cpa_micros	int64 目標單次動作出價選項。這是指您願意為每次獲取支付的平均金額。

TargetCpa

這是一種自動出價策略，可根據您指定的目標單次轉換出價設定出價，盡量爭取轉換。

欄位
target_cpa_micros	int64 平均單次動作出價目標。這個目標應大於或等於帳戶幣別的最低計費單位。

TargetImpressionShare

這項自動出價策略會設定出價，確保一定比例的搜尋廣告顯示在第一頁頂端 (或其他指定位置)。

欄位
location	TargetImpressionShareLocation 搜尋結果網頁上的目標位置。
location_fraction_micros	int64 以微秒為單位，指定廣告在目標地區放送的比例。舉例來說，1% 等於 10,000。
cpc_bid_ceiling_micros	int64 自動出價系統可指定的最高單次點擊出價。這是廣告主輸入的必填欄位，用於設定上限，並在當地微觀區域中指定。

TargetRoas

這項自動出價策略會盡量提高收益，同時平均達到指定的目標廣告投資報酬率 (ROAS)。

欄位
target_roas	double 根據轉換資料計算，每單位支出的收益。

TargetSpend

這是一種自動出價策略，可為您設定出價，在預算範圍內盡可能爭取點擊。

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

廣告

廣告。

欄位
resource_name	string 廣告的資源名稱。廣告資源名稱的格式如下： customers/{customer_id}/ads/{ad_id}
final_urls[]	string 廣告在所有跨網域重新導向後可能連到的最終到達網址清單。
final_app_urls[]	FinalAppUrl 如果使用者已安裝特定應用程式，系統會在行動裝置上使用的最終應用程式網址清單。
final_mobile_urls[]	string 廣告經過所有跨網域重新導向後，可能的最終行動版網址清單。
type	AdType 廣告類型。
id	int64 廣告編號。
tracking_url_template	string 用於建構追蹤網址的網址範本。
final_url_suffix	string 建構最終到達網址時要使用的尾碼。
display_url	string 部分廣告格式的廣告說明中顯示的網址。
name	string 廣告的名稱。這項資訊僅用於識別廣告。不必是專屬網址，也不會影響放送的廣告。
聯集欄位 ad_data。與廣告類型相關的詳細資料。必須設定一個值。ad_data 只能是下列其中一項：
text_ad	SearchAds360TextAdInfo 文字廣告的相關詳細資料。
expanded_text_ad	SearchAds360ExpandedTextAdInfo 延展型文字廣告的相關詳細資料。
responsive_search_ad	SearchAds360ResponsiveSearchAdInfo 與回應式搜尋廣告相關的詳細資料。
product_ad	SearchAds360ProductAdInfo 產品廣告的詳細資料。
expanded_dynamic_search_ad	SearchAds360ExpandedDynamicSearchAdInfo 延展型動態搜尋廣告的相關詳細資料。

廣告群組

廣告群組。

欄位
resource_name	string 廣告群組的資源名稱。廣告群組資源名稱的格式如下： customers/{customer_id}/adGroups/{ad_group_id}
status	AdGroupStatus 廣告群組的狀態。
type	AdGroupType 廣告群組類型。
ad_rotation_mode	AdGroupAdRotationMode 廣告群組的廣告輪播模式。
creation_time	string 這個 ad_group 的建立時間戳記。時間戳記採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss」。
targeting_setting	TargetingSetting 指定目標相關功能的設定。
labels[]	string 附加至這個廣告群組的標籤資源名稱。
effective_labels[]	string 附加至這個廣告群組的有效標籤資源名稱。有效標籤是指沿用或直接指派給這個廣告群組的標籤。
engine_id	string 外部引擎帳戶中的廣告群組 ID。這個欄位僅適用於非 Google Ads 帳戶，例如 Yahoo Japan、Microsoft、百度等。如果是 Google Ads 實體，請改用「ad_group.id」。
start_date	string 這個廣告群組開始放送廣告的日期。根據預設，廣告群組會立即開始放送，或從廣告群組的開始日期開始放送，以較晚者為準。如果設定這個欄位，廣告群組會在客戶時區中指定日期的開頭開始放送。這個欄位僅適用於 Microsoft Advertising 和 Facebook 閘道帳戶。 格式：YYYY-MM-DD 範例：2019-03-14
end_date	string 廣告群組停止放送廣告的日期。根據預設，廣告群組會在廣告群組結束日期結束。如果設定這個欄位，廣告群組會在指定日期結束時，於客戶時區結束。這個欄位僅適用於 Microsoft Advertising 和 Facebook 閘道帳戶。 格式：YYYY-MM-DD 範例：2019-03-14
language_code	string 廣告群組中廣告和關鍵字的語言。這個欄位僅適用於 Microsoft Advertising 帳戶。詳情請參閱：https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage
last_modified_time	string 這個廣告群組上次修改的日期時間。日期時間採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss.ssssss」。
id	int64 廣告群組的 ID。
name	string 廣告群組的名稱。 建立新廣告群組時，這個欄位為必填，且不得為空白。 長度不得超過 255 個 UTF-8 全形字元。 不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。
tracking_url_template	string 用於建構追蹤網址的網址範本。
cpc_bid_micros	int64 最高單次點擊出價。
engine_status	AdGroupEngineStatus 廣告群組的引擎狀態。
final_url_suffix	string 網址範本，用於將參數附加至最終到達網址。

AdGroupAd

廣告群組廣告。

欄位
resource_name	string 廣告的資源名稱。廣告群組廣告資源名稱的格式為： customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}
status	AdGroupAdStatus 廣告的狀態。
ad	Ad 廣告。
creation_time	string 這個 ad_group_ad 的建立時間戳記。日期時間採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss.ssssss」。
labels[]	string 附加至這個廣告群組廣告的標籤資源名稱。
effective_labels[]	string 附加至這個廣告的有效標籤資源名稱。有效標籤是指沿用或直接指派給這個廣告的標籤。
engine_id	string 外部引擎帳戶中的廣告 ID。這個欄位僅適用於 Search Ads 360 帳戶，例如 Yahoo Japan、Microsoft、百度等。如為非 Search Ads 360 實體，請改用「ad_group_ad.ad.id」。
engine_status	AdGroupAdEngineStatus 外部引擎帳戶中廣告的額外狀態。可能狀態 (視外部帳戶類型而定) 包括有效、符合資格、待審查等。
last_modified_time	string 上次修改這個廣告群組廣告的日期和時間。日期時間採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss.ssssss」。

AdGroupAdEffectiveLabel

廣告群組廣告與有效標籤之間的關係。有效標籤是指沿用或直接指派給這個廣告群組廣告的標籤。

欄位
resource_name	string 廣告群組廣告有效標籤的資源名稱。廣告群組廣告有效標籤資源名稱的格式為：customers/{owner_customer_id}/adGroupAdEffectiveLabels/{ad_group_id}~{ad_id}~{label_id}
ad_group_ad	string 附加有效標籤的廣告群組廣告。
label	string 指派給廣告群組廣告的有效標籤。
owner_customer_id	int64 擁有有效標籤的客戶 ID。

AdGroupAdLabel

廣告群組廣告與標籤之間的關係。

欄位
resource_name	string 廣告群組廣告標籤的資源名稱。廣告群組廣告標籤資源名稱的格式為：customers/{owner_customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}
ad_group_ad	string 附加標籤的廣告群組廣告。
label	string 指派給廣告群組廣告的標籤。
owner_customer_id	int64 擁有標籤的客戶 ID。

AdGroupAsset

廣告群組與素材資源之間的連結。

欄位
resource_name	string 廣告群組素材資源的資源名稱。AdGroupAsset 資源名稱的格式如下： customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}
ad_group	string 必要欄位。素材資源連結的廣告群組。
asset	string 必要欄位。連結至廣告群組的素材資源。
status	AssetLinkStatus 廣告群組素材資源的狀態。

AdGroupAssetSet

AdGroupAssetSet 是廣告群組和素材資源組合之間的連結。建立 AdGroupAssetSet 會將素材資源組合連結至廣告群組。

欄位
resource_name	string 廣告群組素材資源組合的資源名稱。廣告群組素材資源組合資源名稱的格式如下： customers/{customer_id}/adGroupAssetSets/{ad_group_id}~{asset_set_id}
ad_group	string 這個素材資源組合連結的廣告群組。
asset_set	string 連結至廣告群組的素材資源組合。
status	AssetSetLinkStatus 廣告群組素材資源組合的狀態。唯讀。

AdGroupAudienceView

廣告群組目標對象檢視畫面。包括多媒體廣告聯播網和 YouTube 聯播網廣告的興趣和再行銷名單成效資料，以及搜尋廣告再行銷名單 (RLSA)，並以目標對象層級匯總。

欄位
resource_name	string 廣告群組目標對象檢視畫面的資源名稱。廣告群組目標對象檢視資源名稱的格式如下： customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}

AdGroupBidModifier

代表廣告群組出價調節係數。

欄位
resource_name	string 廣告群組出價調節係數的資源名稱。廣告群組出價調節係數資源名稱的格式為： customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}
bid_modifier	double 條件相符時的出價調節係數。修飾符必須介於 0.1 到 10.0 之間。PreferredContent 的範圍為 1.0 至 6.0。使用 0 即可選擇不使用裝置類型。
聯集欄位 criterion。這個廣告群組出價調節係數的條件。 自 V5 起，建立作業時必須提供這項資訊。criterion 只能是下列其中一項：
device	DeviceInfo 裝置條件。

AdGroupCriterion

廣告群組條件。ad_group_criterion 報表只會傳回明確新增至廣告群組的條件。

欄位
resource_name	string 廣告群組條件的資源名稱。廣告群組條件資源名稱的格式為： customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}
creation_time	string 這個廣告群組條件的建立時間戳記。時間戳記採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss」。
status	AdGroupCriterionStatus 條件的狀態。 這是由用戶端設定的廣告群組條件實體狀態。注意：使用者介面報表可能會納入其他資訊，影響條件是否符合放送資格。在某些情況下，即使透過 API 移除條件，該條件在使用者介面中仍可能顯示為已啟用。舉例來說，廣告活動預設會向所有年齡層的使用者放送，除非您排除特定年齡層。由於這些年齡層符合廣告放送資格，因此使用者介面會將每個年齡範圍顯示為「已啟用」；但由於未新增任何正向條件，因此 AdGroupCriterion.status 會顯示「已移除」。
quality_info	QualityInfo 有關條件品質的資訊。
type	CriterionType 條件類型。
labels[]	string 附加至這個廣告群組條件的標籤資源名稱。
effective_labels[]	string 附加至這個廣告群組條件的有效標籤資源名稱。有效標籤是指沿用或直接指派給這個廣告群組條件的標籤。
position_estimates	PositionEstimates 不同位置的條件出價預估值。
final_urls[]	string 廣告在所有跨網域重新導向後可能連到的最終到達網址清單。
final_mobile_urls[]	string 所有跨網域重新導向後，可能的最終行動版網址清單。
url_custom_parameters[]	CustomParameter 用於取代 tracking_url_template、final_urls 或 mobile_final_urls 中自訂參數標記的對應清單。
engine_id	string 外部引擎帳戶中的廣告群組條件 ID。這個欄位僅適用於非 Google Ads 帳戶，例如 Yahoo Japan、Microsoft、百度等。如果是 Google Ads 實體，請改用「ad_group_criterion.criterion_id」。
last_modified_time	string 上次修改這個廣告群組條件的日期時間。日期時間採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss.ssssss」。
criterion_id	int64 指定條件的 ID。
ad_group	string 條件所屬的廣告群組。
negative	bool 是否要指定 (false) 或排除 (true) 條件。 這個欄位無法變更。如要將準則從正面改為負面，請先移除再重新新增。
bid_modifier	double 條件相符時的出價調節係數。修飾符必須介於 0.1 到 10.0 之間。大多數可指定條件類型都支援調節係數。
cpc_bid_micros	int64 單次點擊出價。
effective_cpc_bid_micros	int64 有效單次點擊出價。
engine_status	AdGroupCriterionEngineStatus 廣告群組條件的引擎狀態。
final_url_suffix	string 網址範本，用於將參數附加至最終到達網址。
tracking_url_template	string 用於建構追蹤網址的網址範本。
聯集欄位 criterion。廣告群組條件。 必須設定其中一個。criterion 只能是下列其中一項：
keyword	KeywordInfo 關鍵字。
listing_group	ListingGroupInfo 商家資訊群組。
age_range	AgeRangeInfo 年齡層。
gender	GenderInfo 性別。
user_list	UserListInfo 使用者清單。
webpage	WebpageInfo 網頁
location	LocationInfo 。

PositionEstimates

不同位置的條件出價預估值。

欄位
top_of_page_cpc_micros	int64 預估廣告顯示在搜尋結果第一頁頂端所需的單次點擊出價。

QualityInfo

廣告群組條件品質資訊的容器。

欄位
quality_score	int32 品質分數。 如果 Google 沒有足夠資訊來判斷值，可能就不會填入這個欄位。

AdGroupCriterionEffectiveLabel

廣告群組條件與有效標籤之間的關係。有效標籤是指沿用或直接指派給這個廣告群組條件的標籤。

欄位
resource_name	string 廣告群組條件有效標籤的資源名稱。廣告群組條件有效標籤資源名稱的格式為：customers/{owner_customer_id}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterion_id}~{label_id}
ad_group_criterion	string 有效標籤所附加的廣告群組條件。
label	string 指派給廣告群組條件的有效標籤。
owner_customer_id	int64 擁有有效標籤的客戶 ID。

AdGroupCriterionLabel

廣告群組條件與標籤之間的關係。

欄位
resource_name	string 廣告群組條件標籤的資源名稱。廣告群組條件標籤資源名稱的格式為：customers/{owner_customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}
ad_group_criterion	string 標籤所附加的廣告群組條件。
label	string 指派給廣告群組條件的標籤。
owner_customer_id	int64 擁有標籤的客戶 ID。

AdGroupEffectiveLabel

廣告群組與有效標籤之間的關係。有效標籤是指沿用或直接指派給這個廣告群組的標籤。

欄位
resource_name	string 廣告群組有效標籤的資源名稱。廣告群組有效標籤資源名稱的格式為：customers/{owner_customer_id}/adGroupEffectiveLabels/{ad_group_id}~{label_id}
ad_group	string 有效標籤所附加的廣告群組。
label	string 指派給廣告群組的有效標籤。
owner_customer_id	int64 擁有有效標籤的客戶 ID。

AdGroupLabel

廣告群組和標籤之間的關係。

欄位
resource_name	string 廣告群組標籤的資源名稱。廣告群組標籤資源名稱的格式為：customers/{owner_customer_id}/adGroupLabels/{ad_group_id}~{label_id}
ad_group	string 標籤附加的廣告群組。
label	string 指派給廣告群組的標籤。
owner_customer_id	int64 擁有標籤的客戶 ID。

AgeRangeView

年齡層檢視畫面。

欄位
resource_name	string 年齡範圍檢視區塊的資源名稱。年齡範圍檢視畫面資源名稱的格式如下： customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}

素材資源

素材資源是廣告的一部分，可供多個廣告共用。可以是圖片 (ImageAsset)、影片 (YoutubeVideoAsset) 等。素材資源是不可變動的，無法移除。如要停止顯示素材資源，請從使用該素材資源的實體中移除。

欄位
resource_name	string 資產的資源名稱。素材資源名稱的格式如下： customers/{customer_id}/assets/{asset_id}
type	AssetType 資產類型。
final_urls[]	string 所有跨網域重新導向後可能的最終到達網址清單。
final_mobile_urls[]	string 所有跨網域重新導向後，可能的最終行動版網址清單。
url_custom_parameters[]	CustomParameter 用於取代追蹤網址範本、最終到達網址和/或最終行動版網址中網址自訂參數標記的對應清單。
status	AssetStatus 資產狀態。
creation_time	string 這項資產的建立時間戳記。時間戳記採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss」。
last_modified_time	string 這項資產的上次修改日期和時間。日期時間採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss.ssssss」。
id	int64 資產 ID。
name	string 素材資源的選用名稱。
tracking_url_template	string 用於建構追蹤網址的網址範本。
final_url_suffix	string 網址範本，用於將參數附加至透過並行追蹤放送的到達網頁網址。
engine_status	AssetEngineStatus 素材資源的引擎狀態。
聯集欄位 asset_data。素材資源的具體類型。asset_data 只能是下列其中一項：
youtube_video_asset	YoutubeVideoAsset YouTube 影片素材資源。
image_asset	ImageAsset 圖片素材資源。
text_asset	TextAsset 文字素材資源。
callout_asset	UnifiedCalloutAsset 統一摘要素材資源。
sitelink_asset	UnifiedSitelinkAsset 統一網站連結素材資源。
page_feed_asset	UnifiedPageFeedAsset 統一的網頁動態饋給素材資源。
mobile_app_asset	MobileAppAsset 行動應用程式素材資源。
call_asset	UnifiedCallAsset 統一的電話素材資源。
call_to_action_asset	CallToActionAsset 行動號召素材資源。
location_asset	UnifiedLocationAsset 統一地點素材資源。

AssetGroup

素材資源群組。AssetGroupAsset 用於將素材資源連結至素材資源群組。AssetGroupSignal 用於將信號與素材資源群組建立關聯。

欄位
resource_name	string 素材資源群組的資源名稱。素材資源群組資源名稱的格式如下： customers/{customer_id}/assetGroups/{asset_group_id}
id	int64 素材資源群組的 ID。
campaign	string 這個素材資源群組所屬的廣告活動。連結至素材資源群組的素材資源。
name	string 必要欄位。素材資源群組名稱。必要欄位。長度不得少於 1 個字元，最多不得超過 128 個字元。廣告活動中的名稱不得重複。
final_urls[]	string 所有跨網域重新導向後的最終到達網址清單。在最高成效廣告活動中，除非選擇停用，否則網址預設會擴展。
final_mobile_urls[]	string 所有跨網域重新導向後的最終行動網址清單。在最高成效廣告活動中，除非選擇停用，否則網址預設會擴展。
status	AssetGroupStatus 素材資源群組的狀態。
path1	string 文字的第一部分，可能會附加至廣告中顯示的網址。
path2	string 第二部分文字，可能會附加在廣告中顯示的網址。只有在設定 path1 時，才能設定這個欄位。
ad_strength	AdStrength 這個素材資源群組的整體廣告優異度。

AssetGroupAsset

AssetGroupAsset 是素材資源和素材資源群組之間的連結。新增 AssetGroupAsset 會將素材資源連結至素材資源群組。

欄位
resource_name	string 素材資源群組素材資源的資源名稱。素材資源群組素材資源的資源名稱格式如下： customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}
asset_group	string 這個素材資源群組資產連結的素材資源群組。
asset	string 這個素材資源群組素材資源連結的素材資源。
field_type	AssetFieldType 素材資源在素材資源群組中的位置說明。例如：HEADLINE、YOUTUBE_VIDEO 等
status	AssetLinkStatus 素材資源與素材資源群組之間連結的狀態。

AssetGroupAssetCombinationData

素材資源群組素材資源組合資料

欄位
asset_combination_served_assets[]	AssetUsage 放送的素材資源。

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter 代表素材資源群組中的商家資訊群組篩選器樹狀結構節點。

欄位
resource_name	string 素材資源群組商家資訊群組篩選器的資源名稱。素材資源群組商家資訊群組篩選器資源名稱的格式如下： customers/{customer_id}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}
asset_group	string 這個素材資源群組商家資訊群組篩選器所屬的素材資源群組。
id	int64 ListingGroupFilter 的 ID。
type	ListingGroupFilterType 商家資訊群組篩選器節點的類型。
vertical	ListingGroupFilterVertical 代表目前節點樹狀結構的垂直項目。同一棵樹狀結構中的所有節點都必須屬於同一個垂直產業。
case_value	ListingGroupFilterDimension 商家資訊群組用來調整上層項目的維度值。根群組未定義。
parent_listing_group_filter	string 父項產品資訊群組細分的資源名稱。根商家資訊群組篩選節點為空值。
path	ListingGroupFilterDimensionPath 定義這個商家資訊群組篩選條件的維度路徑。

AssetGroupSignal

AssetGroupSignal 代表素材資源群組中的信號。信號的存在會告訴最高成效廣告活動，誰最有可能完成轉換。最高成效廣告活動會根據信號尋找意願相近或更強烈的新使用者，爭取在搜尋聯播網、多媒體廣告聯播網和影片聯播網上的轉換。

欄位
resource_name	string 素材資源群組信號的資源名稱。素材資源群組信號資源名稱的格式如下： customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id}
asset_group	string 這個素材資源群組信號所屬的素材資源群組。
聯集欄位 signal。素材資源群組的信號。signal 只能是下列其中一項：
audience	AudienceInfo 最高成效廣告活動要使用的目標對象信號。

AssetGroupTopCombinationView

素材資源群組素材資源組合的使用情況。

欄位
resource_name	string 素材資源群組最佳組合檢視畫面的資源名稱。AssetGroup Top Combination 檢視畫面資源名稱的格式為：「customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}」
asset_group_top_combinations[]	AssetGroupAssetCombinationData 一起放送的成效最佳素材資源組合。

AssetSet

代表資產集合的資產組合。使用 AssetSetAsset 將素材資源連結至素材資源組合。

欄位
id	int64 素材資源組合的 ID。
resource_name	string 素材資源組合的資源名稱。資產組合資源名稱的格式如下： customers/{customer_id}/assetSets/{asset_set_id}

AssetSetAsset

AssetSetAsset 是素材資源與素材資源組合之間的連結。新增 AssetSet：將素材資源連結至素材資源組合。

欄位
resource_name	string 資產組合資產的資源名稱。素材資源組合素材資源名稱的格式如下： customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}
asset_set	string 這個素材資源組合素材資源連結的素材資源組合。
asset	string 這個素材資源組合素材資源連結的素材資源。
status	AssetSetAssetStatus 素材資源組合素材資源的狀態。唯讀。

觀眾

目標對象是一種有效的指定目標選項，可讓您找出不同區隔 (例如詳細客層和興趣相似目標對象) 的共同特徵，建立能夠代表目標區隔中多個客群的目標對象。

欄位
resource_name	string 目標對象的資源名稱。目標對象名稱的格式如下： customers/{customer_id}/audiences/{audience_id}
id	int64 目標對象 ID。
name	string 必要欄位。目標對象名稱。所有目標對象的 ID 都不應重複。長度至少須為 1 個字元，最多不得超過 255 個字元。
description	string 這組目標對象的說明。

BiddingStrategy

出價策略。

欄位
resource_name	string 出價策略的資源名稱。出價策略資源名稱的格式如下： customers/{customer_id}/biddingStrategies/{bidding_strategy_id}
status	BiddingStrategyStatus 出價策略的狀態。 這是唯讀欄位。
type	BiddingStrategyType 出價策略類型。設定出價方式，建立出價策略。 這是唯讀欄位。
currency_code	string 出價策略使用的幣別 (ISO 4217 三個字母的代碼)。 如果是管理員客戶中的出價策略，則可在建立時設定幣別，預設為管理員客戶的幣別。放送客戶無法設定這個欄位；放送客戶中的所有策略都會隱含使用放送客戶的幣別。在所有情況下，effective_currency_code 欄位都會傳回策略使用的貨幣。
id	int64 出價策略的 ID。
name	string 出價策略的名稱。帳戶中的所有出價策略都必須有不同的名稱。 這個字串的長度應介於 1 到 255 個 UTF-8 位元組之間 (含首尾)，且經過修剪。
effective_currency_code	string 出價策略使用的幣別 (ISO 4217 三個字母的代碼)。 如果是管理員客戶的出價策略，這是廣告主建立策略時設定的幣別。如要為客戶提供服務，請使用客戶的 currency_code。 出價策略指標會以這個幣別回報。 這是唯讀欄位。
campaign_count	int64 附加至這項出價策略的廣告活動數量。 這是唯讀欄位。
non_removed_campaign_count	int64 附加至這項出價策略且未移除的廣告活動數量。 這是唯讀欄位。
聯集欄位 scheme。出價架構。 只能設定一個。scheme 只能是下列其中一項：
enhanced_cpc	EnhancedCpc 這項出價策略會針對較有可能促成轉換的點擊調高出價，並針對較不可能促成轉換的點擊調低出價。
maximize_conversion_value	MaximizeConversionValue 自動出價策略，可協助您在預算範圍內，為廣告活動爭取最高轉換價值。
maximize_conversions	MaximizeConversions 這項自動出價策略可協助您在預算範圍內，為廣告活動爭取最多轉換。
target_cpa	TargetCpa 這是一種出價策略，可根據您指定的目標單次轉換出價設定出價，盡量為您爭取轉換。
target_impression_share	TargetImpressionShare 這項出價策略會根據您選擇的曝光百分比，自動進行最佳化調整。
target_outrank_share	TargetOutrankShare 這種出價策略會根據廣告主應在競價中勝過特定競爭對手的目標比例，設定出價。這個欄位已不適用；使用這個欄位建立新的出價策略，或將含有這個欄位的出價策略附加至廣告活動，都會失敗。允許變更已填入這項配置的策略。
target_roas	TargetRoas 這項出價策略可協助您盡量提高收益，同時將目標廣告投資報酬率設為平均值。
target_spend	TargetSpend 這是一種出價策略，可為您設定出價，在預算範圍內盡可能爭取點擊。

廣告活動

廣告活動。

欄位
resource_name	string 廣告活動的資源名稱。廣告活動資源名稱的格式如下： customers/{customer_id}/campaigns/{campaign_id}
status	CampaignStatus 廣告活動的狀態。 新增廣告活動時，狀態預設為「已啟用」。
serving_status	CampaignServingStatus 廣告活動的廣告放送狀態。
bidding_strategy_system_status	BiddingStrategySystemStatus 廣告活動出價策略的系統狀態。
ad_serving_optimization_status	AdServingOptimizationStatus 廣告活動的廣告放送最佳化狀態。
advertising_channel_type	AdvertisingChannelType 廣告活動中廣告的主要放送目標。您可以在 network_settings 中調整指定目標選項。 建立新廣告活動時，這個欄位為必填，且不得為空白。 只能在建立廣告活動時設定。廣告活動建立完成後，就無法變更這個欄位。
advertising_channel_sub_type	AdvertisingChannelSubType (選用) 調整 advertising_channel_type。必須是上層管道類型的有效子類型。 只能在建立廣告活動時設定。廣告活動建立完成後，就無法變更這個欄位。
url_custom_parameters[]	CustomParameter 用於取代 tracking_url_template、final_urls 或 mobile_final_urls 中自訂參數標記的對應清單。
real_time_bidding_setting	RealTimeBiddingSetting 競價期間出價的設定，這項功能僅適用於指定 Ad Exchange 聯播網的廣告活動。
network_settings	NetworkSettings 廣告活動的聯播網設定。
dynamic_search_ads_setting	DynamicSearchAdsSetting 用來控管動態搜尋廣告的設定。
shopping_setting	ShoppingSetting 用來控管購物廣告活動的設定。
geo_target_type_setting	GeoTargetTypeSetting 廣告地理區域指定目標設定。
effective_labels[]	string 附加至這個廣告活動的有效標籤資源名稱。有效標籤是指沿用或直接指派給這個廣告活動的標籤。
labels[]	string 附加至這個廣告活動的標籤資源名稱。
bidding_strategy_type	BiddingStrategyType 出價策略類型。 您可以設定出價計畫來建立標準出價策略，也可以設定 bidding_strategy 欄位來建立組合出價策略。 這是唯讀欄位。
accessible_bidding_strategy	string AccessibleBiddingStrategy 的資源名稱，這是附加組合出價策略 (由「bidding_strategy」識別) 不受限制屬性的唯讀檢視畫面。如果廣告活動未使用組合策略，則為空白。策略共用對象的所有客戶都能使用不受限制的策略屬性，並從 AccessibleBiddingStrategy 資源讀取這些屬性。相較之下，受限屬性僅適用於策略的擁有者客戶及其管理員。受限屬性只能從 BiddingStrategy 資源讀取。
frequency_caps[]	FrequencyCapEntry 這份名單會限制每位使用者看到此廣告活動廣告的頻率。
selective_optimization	SelectiveOptimization 這個廣告活動的選擇性最佳化設定，包括一組可提升廣告活動效益的轉換動作。這項功能僅適用於 AdvertisingChannelType 為 MULTI_CHANNEL，且 AdvertisingChannelSubType 為 APP_CAMPAIGN 或 APP_CAMPAIGN_FOR_ENGAGEMENT 的應用程式廣告活動。
optimization_goal_setting	OptimizationGoalSetting 這個廣告活動的最佳化目標設定，包括一組最佳化目標類型。
tracking_setting	TrackingSetting 廣告活動層級的追蹤資訊設定。
engine_id	string 外部引擎帳戶中的廣告活動 ID。這個欄位僅適用於非 Google Ads 帳戶，例如 Yahoo Japan、Microsoft、百度等。如果是 Google Ads 實體，請改用「campaign.id」。
excluded_parent_asset_field_types[]	AssetFieldType 應從這個廣告活動排除的素材資源欄位類型。廣告活動不會從上層繼承這些欄位類型的素材資源連結。
create_time	string 這個廣告活動的建立時間戳記。時間戳記採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss」。create_time 將在 v1 中淘汰。請改用 creation_time。
creation_time	string 這個廣告活動的建立時間戳記。時間戳記採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss」。
last_modified_time	string 上次修改這個廣告活動的日期和時間。日期時間採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss.ssssss」。
feed_types[]	AssetSetType 直接附加至這個廣告活動的動態饋給類型。
id	int64 廣告活動的 ID。
name	string 廣告活動名稱。 建立新廣告活動時，這個欄位為必填，且不得為空白。 不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。
tracking_url_template	string 用於建構追蹤網址的網址範本。
campaign_budget	string 廣告活動的廣告活動預算資源名稱。
start_date	string 廣告活動開始放送的日期，格式為 YYYY-MM-DD，時區為客戶時區。
end_date	string 廣告活動的最後一天，以 YYYY-MM-DD 格式顯示，並採用放送廣告所在時區的日期。建立時，預設為 2037 年 12 月 30 日，表示廣告活動會無限期放送。如要將現有廣告活動設為無限期放送，請將這個欄位設為 2037 年 12 月 30 日。
final_url_suffix	string 尾碼：用於將查詢參數附加至以並行追蹤放送的到達網頁。
url_expansion_opt_out	bool 代表選擇不將網址擴展至更精確的網址。如果選擇不擴展 (true)，系統只會指定素材資源群組中的最終到達網址，或是廣告主在 Google Merchant Center 或商家資料動態饋給中指定的網址。如果選擇加入 (false)，系統會指定整個網域。這個欄位只能為最高成效廣告活動設定，預設值為 false。
聯集欄位 campaign_bidding_strategy。廣告活動的出價策略。 必須是廣告組合 (透過 BiddingStrategy 服務建立) 或內嵌於廣告活動的標準出價策略。campaign_bidding_strategy 只能是下列其中一項：
bidding_strategy	string 廣告活動使用的組合出價策略資源名稱。
manual_cpa	ManualCpa 標準手動單次動作出價策略。手動出價策略，可讓廣告主為廣告主指定的動作設定出價。僅適用於在地生活服務廣告活動。
manual_cpc	ManualCpc 標準手動單次點擊出價策略。手動點擊出價，使用者按點擊次數付費。
manual_cpm	ManualCpm 標準手動千次曝光出價策略。手動設定以曝光為準的出價，使用者每千次曝光就必須支付費用。
maximize_conversions	MaximizeConversions 標準的「盡量爭取轉換」出價策略，系統會自動調整出價，在預算範圍內爭取最多轉換。
maximize_conversion_value	MaximizeConversionValue 標準「盡量提高轉換價值」出價策略，會自動設定出價，在預算範圍內盡量提高收益。
target_cpa	TargetCpa 標準目標單次動作出價策略，會根據您設定的目標單次動作出價自動設定出價，盡可能爭取轉換。
target_impression_share	TargetImpressionShare 目標曝光比重出價策略。這項自動出價策略會設定出價，以達到所選的曝光百分比。
target_roas	TargetRoas 標準目標廣告投資報酬率出價策略，會自動盡量提高收益，同時平均達到特定目標廣告投資報酬率。
target_spend	TargetSpend 標準的「目標支出」出價策略，可自動設定出價，在預算範圍內盡可能爭取點擊。
percent_cpc	PercentCpc 標準單次點擊出價百分比出價策略，出價為部分商品或服務廣告價格的一小部分。
target_cpm	TargetCpm 這項出價策略會自動調整千次曝光出價。

DynamicSearchAdsSetting

用來控管動態搜尋廣告的設定。

欄位
domain_name	string 必要欄位。這項設定代表的網際網路網域名稱，例如「google.com」或「www.google.com」。
language_code	string 必要欄位。指定網域語言的語言代碼，例如「en」。
use_supplied_urls_only	bool 廣告活動是否只使用廣告主提供的網址。

GeoTargetTypeSetting

代表與廣告地理區域目標相關的一組設定。

欄位
positive_geo_target_type	PositiveGeoTargetType 這個廣告活動中用於指定排除地區的設定。
negative_geo_target_type	NegativeGeoTargetType 這個廣告活動使用的排除地域指定目標設定。

NetworkSettings

廣告活動的聯播網設定。

欄位
target_google_search	bool 是否要與 google.com 搜尋結果一起放送廣告。
target_search_network	bool 廣告是否會在 Google 搜尋聯播網的合作夥伴網站上放送 (必須同時為 target_google_search true)。
target_content_network	bool 廣告是否會在 Google 多媒體廣告聯播網的指定刊登位置放送。刊登位置是使用刊登位置條件指定。
target_partner_search_network	bool 廣告是否會在 Google 合作夥伴聯播網放送。這項功能僅適用於部分 Google 合作夥伴帳戶。

OptimizationGoalSetting

這個廣告活動的最佳化目標設定，包括一組最佳化目標類型。

欄位
optimization_goal_types[]	OptimizationGoalType 最佳化目標類型清單。

SelectiveOptimization

這個廣告活動的選擇性最佳化設定，包括一組可提升廣告活動效益的轉換動作。這項功能僅適用於 AdvertisingChannelType 為 MULTI_CHANNEL，且 AdvertisingChannelSubType 為 APP_CAMPAIGN 或 APP_CAMPAIGN_FOR_ENGAGEMENT 的應用程式廣告活動。

欄位
conversion_actions[]	string 選取的轉換動作資源名稱組合，用於最佳化這個廣告活動。

ShoppingSetting

購物廣告活動的設定。定義廣告活動可宣傳的產品範圍，以及這個廣告活動與其他購物廣告活動的互動方式。

欄位
feed_label	string 要納入廣告活動的產品動態饋給標籤。只能設定 feed_label 或 sales_country 其中之一。如果使用 feed_label 欄位而非 sales_country，則接受的國家/地區代碼格式相同，例如「XX」。否則可以是 Google Merchant Center 中用於動態饋給標籤的任何字串。
use_vehicle_inventory	bool 是否指定車輛資訊廣告空間。
merchant_id	int64 Merchant Center 帳戶的 ID。建立作業時，必須填寫這個欄位。這個欄位無法變更購物廣告活動。
sales_country	string 要納入廣告活動的產品銷售國家/地區。
campaign_priority	int32 廣告活動的優先順序。優先順序數值較高的廣告活動會優先放送，優先順序較低的廣告活動則會延後。購物廣告活動必須填寫這個欄位，值介於 0 到 2 之間 (含頭尾)。智慧購物廣告活動可選擇是否填寫這個欄位，但如果填寫，則必須等於 3。
enable_local	bool 是否要納入店面產品。

TrackingSetting

廣告活動層級的追蹤資訊設定。

欄位
tracking_url	string 用於動態追蹤的網址。

CampaignAsset

廣告活動與資產之間的連結。

欄位
resource_name	string 廣告活動資產的資源名稱。CampaignAsset 資源名稱的格式如下： customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}
status	AssetLinkStatus 廣告活動素材資源的狀態。
campaign	string 素材資源連結的廣告活動。
asset	string 連結至廣告活動的素材資源。

CampaignAssetSet

CampaignAssetSet 是廣告活動和素材資源組合之間的連結。新增 CampaignAssetSet 會將素材資源組合連結至廣告活動。

欄位
resource_name	string 廣告活動素材資源組合的資源名稱。素材資源組合素材資源名稱的格式如下： customers/{customer_id}/campaignAssetSets/{campaign_id}~{asset_set_id}
campaign	string 素材資源組合連結的廣告活動。
asset_set	string 已連結至廣告活動的素材資源組合。
status	AssetSetLinkStatus 廣告活動素材資源組合素材資源的狀態。唯讀。

CampaignAudienceView

廣告活動目標對象檢視畫面。包括多媒體廣告聯播網和 YouTube 聯播網廣告的興趣和再行銷名單，以及搜尋廣告再行銷名單 (RLSA) 的成效資料，並依廣告活動和目標對象條件彙整。這個檢視畫面只會顯示在廣告活動層級附加的目標對象。

欄位
resource_name	string 廣告活動目標對象檢視畫面的資源名稱。廣告活動目標對象檢視畫面資源名稱的格式如下： customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}

CampaignBudget

廣告活動預算。

欄位
resource_name	string 廣告活動預算的資源名稱。廣告活動預算資源名稱的格式如下： customers/{customer_id}/campaignBudgets/{campaign_budget_id}
delivery_method	BudgetDeliveryMethod 放送方式會決定廣告活動預算的支出速度。 如果建立作業中未指定，則預設為 STANDARD。
period	BudgetPeriod 支出預算的時間範圍。如果未指定，預設值為 DAILY。
amount_micros	int64 預算金額，以帳戶的當地幣別表示。金額以微量單位指定，一百萬微量單位等於一貨幣單位。每月支出上限為這個金額的 30.4 倍。

CampaignCriterion

廣告活動條件。

欄位
resource_name	string 廣告活動條件的資源名稱。廣告活動條件資源名稱的格式如下： customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}
display_name	string 條件的顯示名稱。 如果是變動，系統會忽略這個欄位。
type	CriterionType 條件類型。
status	CampaignCriterionStatus 條件的狀態。
last_modified_time	string 上次修改這個廣告活動條件的時間。日期時間採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss.ssssss」。
criterion_id	int64 指定條件的 ID。 系統會在變動期間忽略這個欄位。
bid_modifier	float 條件相符時的出價調節係數。修飾符必須介於 0.1 到 10.0 之間。大多數可指定條件類型都支援調節係數。使用 0 即可選擇不使用裝置類型。
negative	bool 是否要指定 (false) 或排除 (true) 條件。
聯集欄位 criterion。廣告活動條件。 必須設定其中一個。criterion 只能是下列其中一項：
keyword	KeywordInfo 關鍵字。
location	LocationInfo 。
device	DeviceInfo 裝置。
age_range	AgeRangeInfo 年齡層。
gender	GenderInfo 性別。
user_list	UserListInfo 使用者清單。
language	LanguageInfo 語言。
webpage	WebpageInfo 網頁。
location_group	LocationGroupInfo 地區群組

CampaignEffectiveLabel

代表廣告活動與有效標籤之間的關係。有效標籤是指沿用或直接指派給這個廣告活動的標籤。

欄位
resource_name	string 資源名稱。CampaignEffectivelabel 資源名稱的格式為：customers/{owner_customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}
campaign	string 附加有效標籤的廣告活動。
label	string 指派給廣告活動的有效標籤。
owner_customer_id	int64 擁有有效標籤的客戶 ID。

CampaignLabel

代表廣告活動與標籤之間的關係。

欄位
resource_name	string 資源名稱。廣告活動標籤資源名稱的格式為：customers/{owner_customer_id}/campaignLabels/{campaign_id}~{label_id}
campaign	string 附加標籤的廣告活動。
label	string 指派給廣告活動的標籤。
owner_customer_id	int64 擁有標籤的客戶 ID。

CartDataSalesView

購物車資料銷售檢視畫面。

欄位
resource_name	string 購物車資料銷售檢視區塊的資源名稱。購物車資料銷售檢視畫面資源名稱的格式為：customers/{customer_id}/cartDataSalesView

轉換

轉換。

欄位
resource_name	string 轉換的資源名稱。轉換資源名稱的格式如下： customers/{customer_id}/conversions/{ad_group_id}~{criterion_id}~{ds_conversion_id}
id	int64 轉換的 ID
criterion_id	int64 Search Ads 360 條件 ID。值為 0 表示條件未歸因。
merchant_id	int64 包含遭點擊產品的 Search Ads 360 商品型錄帳戶 ID。在 Search Ads 360 中連結目錄帳戶時，Search Ads 360 會產生這組 ID。
ad_id	int64 廣告 ID。值為 0 表示廣告未歸因。
click_id	string 系統會將轉換歸因於某次造訪，並將該次造訪的專屬字串以點擊 ID 網址參數的形式傳遞至到達網頁。
visit_id	int64 轉換歸因的 Search Ads 360 訪客 ID。
advertiser_conversion_id	string 如果是離線轉換，這是廣告主提供的 ID。如果廣告主未指定這類 ID，Search Ads 360 就會自動產生。如果是線上轉換，這個值會等於 ID 欄或 floodlight_order_id 欄，視廣告主的 Floodlight 指示而定。
product_id	string 遭點擊的產品 ID。
product_channel	ProductChannel 獲得點擊的產品銷售通路：線上或店面。
product_language_code	string 為內含產品相關資料的 Merchant Center 動態饋給設定的語言 (ISO-639-1)。
product_store_id	string 獲得點擊的店面商品目錄廣告中的商店。這組 ID 必須與店面產品動態饋給所使用的商店 ID 相符。
product_country_code	string 為內含獲得點擊產品的商品目錄動態饋給註冊的國家/地區 (ISO 3166 格式)。
attribution_type	AttributionType 轉換歸因對象：造訪或關鍵字 + 廣告。
conversion_date_time	string 轉換事件的時間戳記。
conversion_last_modified_date_time	string 上次修改轉換的時間戳記。
conversion_visit_date_time	string 轉換歸因的造訪時間戳記。
conversion_quantity	int64 轉換記錄的商品數量，由 qty 網址參數決定。廣告主必須負責以動態方式填入參數 (例如轉換中售出的商品數量)，否則系統會預設為 1。
conversion_revenue_micros	int64 轉換事件的調整後收益 (以微元為單位)。這項金額一律會以放送帳戶的幣別計算。
floodlight_original_revenue	int64 與 Floodlight 事件相關聯的原始收益 (以目前報表的貨幣表示)，未經 Floodlight 貨幣指示修改。
floodlight_order_id	string 廣告主為轉換提供的 Floodlight 訂單 ID。
status	ConversionStatus 轉換的狀態，可以是「ENABLED」或「REMOVED」。
asset_id	int64 轉換事件期間互動的資產 ID。
asset_field_type	AssetFieldType 轉換事件的素材資源欄位類型。

ConversionAction

轉換動作。

欄位
resource_name	string 轉換動作的資源名稱。轉換動作資源名稱的格式如下： customers/{customer_id}/conversionActions/{conversion_action_id}
creation_time	string Floodlight 活動的建立時間戳記，格式為 ISO 8601。
status	ConversionActionStatus 這個轉換動作的轉換事件累積狀態。
type	ConversionActionType 這個轉換動作的類型。
category	ConversionActionCategory 這項轉換動作所記錄的轉換類別。
value_settings	ValueSettings 與這個轉換動作相關聯的轉換事件價值設定。
attribution_model_settings	AttributionModelSettings 與這項轉換動作歸因模式相關的設定。
floodlight_settings	FloodlightSettings Floodlight 轉換類型的 Floodlight 設定。
id	int64 轉換動作的 ID。
name	string 轉換動作的名稱。 建立新的轉換動作時，這個欄位為必填，且不得為空白。
primary_for_goal	bool 如果轉換動作的 primary_for_goal 位元為 false，則無論廣告活動的客戶轉換目標或廣告活動轉換目標為何，所有廣告活動都無法針對該轉換動作出價。不過，自訂轉換目標不會遵守 primary_for_goal，因此如果廣告活動設定了自訂轉換目標，且轉換動作的 primary_for_goal = false，該轉換動作仍可出價。如未設定，預設值為 true。在 V9 中，由於 primary_for_goal 並未宣告為選用，因此只能在透過「更新」作業建立後，將其設為 false。
owner_customer	string 轉換動作擁有者客戶的資源名稱，如果是系統定義的轉換動作，則為空值。
include_in_client_account_conversions_metric	bool 這個轉換動作是否應納入「client_account_conversions」指標。
include_in_conversions_metric	bool 這個轉換動作是否應納入「轉換」指標。
click_through_lookback_window_days	int64 互動 (例如點擊) 和轉換事件之間可能經過的最長天數。
app_id	string 應用程式轉換動作的應用程式 ID。

AttributionModelSettings

與這項轉換動作歸因模式相關的設定。

欄位
attribution_model	AttributionModel 這個轉換動作的歸因模式類型。
data_driven_model_status	DataDrivenModelStatus 轉換動作的以數據為準歸因模式狀態。

FloodlightSettings

與 Floodlight 轉換動作相關的設定。

欄位
activity_group_tag	string 用於在轉換報表中識別 Floodlight 活動群組的字串。
activity_tag	string 用於在轉換報表中識別 Floodlight 活動的字串。
activity_id	int64 DoubleClick Campaign Manager (DCM) 中的 Floodlight 活動 ID。

ValueSettings

與這個轉換動作相關聯的轉換事件價值設定。

欄位
default_value	double 當系統傳送這項轉換動作的轉換事件，但價值無效、不允許或遺漏時，或當這項轉換動作設定為一律採用預設價值時，要使用的價值。
default_currency_code	string 如果傳送這個轉換動作的轉換事件時，貨幣代碼無效或遺漏，或是這個轉換動作設定為一律使用預設值，系統就會採用這個貨幣代碼。
always_use_default_value	bool 控制是否要使用預設值和預設幣別代碼，取代這個轉換動作的轉換事件中指定的價值和幣別代碼。

ConversionCustomVariable

轉換自訂變數。請參閱「關於新版 Search Ads 360 中的 Floodlight 自訂指標和維度」一文：https://support.google.com/sa360/answer/13567857

欄位
resource_name	string 轉換自訂變數的資源名稱。轉換自訂變數資源名稱的格式如下： customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}
id	int64 轉換自訂變數的 ID。
name	string 必要欄位。轉換自訂變數的名稱。名稱不得重複，名稱長度上限為 100 個字元。前後不得有任何多餘空格。
tag	string 必要欄位。轉換自訂變數的代碼。標記應為不重複的字元，且必須以「u」開頭，後面直接接上小於或等於 100 的數字。例如：「u4」。
status	ConversionCustomVariableStatus 轉換事件累積的轉換自訂變數狀態。
owner_customer	string 擁有轉換自訂變數的顧客資源名稱。
family	ConversionCustomVariableFamily 轉換自訂變數的系列。
cardinality	ConversionCustomVariableCardinality 轉換自訂變數的基數。
floodlight_conversion_custom_variable_info	FloodlightConversionCustomVariableInfo Search Ads 360 Floodlight 轉換自訂變數的欄位。
custom_column_ids[]	int64 使用這個轉換自訂變數的自訂欄 ID。

FloodlightConversionCustomVariableInfo

Search Ads 360 Floodlight 轉換自訂變數的相關資訊。

欄位
floodlight_variable_type	FloodlightVariableType 在 Search Ads 360 中定義的 Floodlight 變數類型。
floodlight_variable_data_type	FloodlightVariableDataType 在 Search Ads 360 中定義的 Floodlight 變數資料類型。

ConversionTrackingSetting

與 Search Ads 360 轉換追蹤相關的客戶層級設定集合。

欄位
accepted_customer_data_terms	bool 顧客是否已接受顧客數位資料條款。如果使用跨帳戶轉換追蹤，這個值會從管理員帳戶沿用。這是唯讀欄位。詳情請參閱 https://support.google.com/adspolicy/answer/7475709。
conversion_tracking_status	ConversionTrackingStatus 轉換追蹤狀態。這項資訊會指出顧客是否使用轉換追蹤，以及顧客的轉換追蹤擁有者是誰。如果這位顧客使用跨帳戶轉換追蹤，系統傳回的值會因要求的 login-customer-id 而異。
enhanced_conversions_for_leads_enabled	bool 顧客是否已啟用待開發客戶強化轉換功能。如果使用跨帳戶轉換追蹤，這個值會從管理員帳戶沿用。這是唯讀欄位。
google_ads_conversion_customer	string 用來建立及管理轉換的客戶資源名稱。這是唯讀欄位。
conversion_tracking_id	int64 這個帳戶使用的轉換追蹤 ID。這個 ID 不會指出顧客是否使用轉換追蹤 (conversion_tracking_status 會)。這是唯讀欄位。
google_ads_cross_account_conversion_tracking_id	int64 客戶管理員的轉換追蹤 ID。這項設定會在顧客選擇啟用轉換追蹤時設定，並會覆寫 conversion_tracking_id。這個欄位只能透過 Google Ads 使用者介面管理。這是唯讀欄位。
cross_account_conversion_tracking_id	int64 客戶管理員的轉換追蹤 ID。如果客戶選擇採用跨帳戶轉換追蹤，系統就會設定這個值，並覆寫 conversion_tracking_id。

CustomColumn

自訂欄。請參閱 https://support.google.com/sa360/answer/9633916，瞭解 Search Ads 360 自訂欄。

欄位
resource_name	string 自訂資料欄的資源名稱。自訂欄資源名稱的格式如下： customers/{customer_id}/customColumns/{custom_column_id}
id	int64 自訂欄的 ID。
name	string 使用者定義的自訂資料欄名稱。
description	string 自訂欄的使用者定義說明。
value_type	CustomColumnValueType 自訂欄的結果值類型。
references_attributes	bool 如果自訂欄參照一或多個屬性，則為 True。
references_metrics	bool 如果自訂資料欄參照一或多個指標，則為 True。
queryable	bool 如果自訂資料欄可用於 SearchAds360Service.Search 和 SearchAds360Service.SearchStream 的查詢，則為 True。
referenced_system_columns[]	string 這個自訂欄參照的系統欄清單。舉例來說，自訂資料欄「曝光次數和點擊次數總和」已參照系統資料欄「metrics.clicks」和「metrics.impressions」。
render_type	CustomColumnRenderType 如何解讀自訂欄的結果值。

客戶

顧客。

欄位
resource_name	string 客戶的資源名稱。客戶資源名稱的格式如下： customers/{customer_id}
conversion_tracking_setting	ConversionTrackingSetting 客戶的轉換追蹤設定。
account_type	AccountType 引擎帳戶類型，例如 Google Ads、Microsoft Advertising、Yahoo Japan、百度、Facebook、Engine Track 等。
double_click_campaign_manager_setting	DoubleClickCampaignManagerSetting 管理員客戶的 DoubleClick Campaign Manager (DCM) 設定。
account_status	AccountStatus 帳戶狀態，例如「已啟用」、「已暫停」、「已移除」等。
last_modified_time	string 上次修改這個客戶的日期和時間。日期時間採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss.ssssss」。
engine_id	string 外部引擎帳戶中的帳戶 ID。
status	CustomerStatus 顧客狀態。
creation_time	string 這個顧客的建立時間戳記。時間戳記採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss」。
manager_id	int64 管理員的客戶 ID。值為 0 表示客戶沒有 SA360 管理員。
manager_descriptive_name	string 管理員的描述性名稱。
sub_manager_id	int64 副管理員的客戶 ID。值為 0 表示客戶沒有子項 SA360 管理員。
sub_manager_descriptive_name	string 副管理員的描述性名稱。
associate_manager_id	int64 助理管理員的客戶 ID。值為 0 表示客戶沒有 SA360 助理管理員。
associate_manager_descriptive_name	string 副理的描述性名稱。
account_level	AccountLevelType 客戶的帳戶層級：管理員、副管理員、助理管理員、服務帳戶。
id	int64 顧客 ID。
descriptive_name	string 選填，可重複的客戶說明名稱。
currency_code	string 帳戶使用的幣別。系統支援 ISO 4217 標準中的部分貨幣代碼。
time_zone	string 顧客的當地時區 ID。
tracking_url_template	string 網址範本，可根據參數建構追蹤網址。
final_url_suffix	string 將參數附加至最終到達網址的網址範本。
auto_tagging_enabled	bool 是否為顧客啟用自動標記。
manager	bool 顧客是否為管理員。

CustomerAsset

客戶與素材資源之間的連結。

欄位
resource_name	string 顧客資產的資源名稱。CustomerAsset 資源名稱的格式如下： customers/{customer_id}/customerAssets/{asset_id}~{field_type}
asset	string 必要欄位。與客戶連結的資產。
status	AssetLinkStatus 客戶資產的狀態。

CustomerAssetSet

CustomerAssetSet 是客戶與素材資源組合之間的連結。新增 CustomerAssetSet 會將素材資源組合連結至顧客。

欄位
resource_name	string 客戶資產組合的資源名稱。素材資源組合素材資源名稱的格式如下： customers/{customer_id}/customerAssetSets/{asset_set_id}
asset_set	string 連結至顧客的素材資源組合。
customer	string 素材資源組合連結的目標顧客。
status	AssetSetLinkStatus 客戶素材資源組合素材資源的狀態。唯讀。

CustomerClient

指定客戶與客戶客戶之間的連結。只有管理員客戶才有 CustomerClient。包括所有直接和間接客戶，以及管理員本身。

欄位
resource_name	string 客戶用戶端的資源名稱。CustomerClient 資源名稱的格式為：customers/{customer_id}/customerClients/{client_customer_id}
applied_labels[]	string 套用至客戶客戶的標籤資源名稱 (由要求客戶擁有)。標籤資源名稱的格式如下： customers/{customer_id}/labels/{label_id}
status	CustomerStatus 客戶的狀態。僅供檢視。
client_customer	string 連結至指定客戶的客戶客戶資源名稱。僅供檢視。
hidden	bool 指出這是否為隱藏帳戶。 僅供檢視。
level	int64 指定顧客與用戶端之間的距離。如果是自我連結，層級值為 0。僅供檢視。
time_zone	string 用戶端時區的通用區域資料庫 (CLDR) 字串表示法，例如 America/Los_Angeles。僅供檢視。
test_account	bool 指出用戶端是否為測試帳戶。僅供檢視。
manager	bool 指出用戶端是否為管理員。僅供檢視。
descriptive_name	string 用戶端的描述性名稱。僅供檢視。
currency_code	string 客戶的幣別代碼 (例如「USD」、「EUR」)。僅供檢視。
id	int64 客戶的客戶 ID。僅供檢視。

CustomerManagerLink

代表客戶與管理員的連結關係。

欄位
resource_name	string 資源名稱。CustomerManagerLink 資源名稱的格式為：customers/{customer_id}/customerManagerLinks/{manager_customer_id}~{manager_link_id}
status	ManagerLinkStatus 客戶與管理員之間的連結狀態。
manager_customer	string 連結至客戶的管理員客戶。
manager_link_id	int64 客戶與管理員連結的 ID。這是唯讀欄位。
start_time	string 建立 CustomerManagerLink 的時間戳記。時間戳記採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss」。

DoubleClickCampaignManagerSetting

管理員客戶的 DoubleClick Campaign Manager (DCM) 設定。

欄位
advertiser_id	int64 與這個客戶相關聯的 Campaign Manager 廣告主 ID。
network_id	int64 與這個客戶相關聯的 Campaign Manager 聯播網 ID。
time_zone	string 以 IANA 時區資料庫格式表示，與這個客戶相關聯的 Campaign Manager 聯播網時區，例如 America/New_York。

DynamicSearchAdsSearchTermView

動態搜尋廣告搜尋字詞檢視畫面。

欄位
resource_name	string 動態搜尋廣告搜尋字詞檢視畫面的資源名稱。動態搜尋廣告搜尋字詞檢視畫面資源名稱的格式如下： customers/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}
landing_page	string 曝光的動態選取到達網頁網址。 這是唯讀欄位。

GenderView

性別檢視畫面。gender_view 資源反映的是有效放送狀態，而非新增的條件。如果廣告群組沒有性別條件，預設會向所有性別顯示，因此所有性別都會出現在 gender_view 中，並附上統計資料。

欄位
resource_name	string 性別檢視區塊的資源名稱。性別檢視畫面資源名稱的格式如下： customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}

GeoTargetConstant

指定地理區域常數。

欄位
resource_name	string 地理目標常數的資源名稱。地域目標常數資源名稱的格式如下： geoTargetConstants/{geo_target_constant_id}
status	GeoTargetConstantStatus 指定地理區域常數狀態。
id	int64 指定地理區域常數的 ID。
name	string 指定地理區域常數的英文名稱。
country_code	string 與目標相關的 ISO-3166-1 alpha-2 國家/地區代碼。
target_type	string 指定地理區域常數指定類型。
canonical_name	string 建構完成的完整英文名稱，包含目標本身的名稱，以及父項和國家/地區的名稱。
parent_geo_target	string 父項地理區域目標常數的資源名稱。地域目標常數資源名稱的格式如下： geoTargetConstants/{parent_geo_target_constant_id}

KeywordView

關鍵字檢視畫面。

欄位
resource_name	string 關鍵字檢視畫面的資源名稱。關鍵字檢視畫面資源名稱的格式如下： customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}

標籤

標籤。

欄位
resource_name	string 資源名稱。標籤資源名稱的格式為：customers/{owner_customer_id}/labels/{label_id}
status	LabelStatus 標籤狀態。僅供檢視。
text_label	TextLabel 這類標籤會在彩色背景上顯示文字。
id	int64 標籤的 ID。僅供檢視。
name	string 標籤名稱。 建立新標籤時，這個欄位為必填，且不得留空。 這個字串的長度應介於 1 到 80 個半形字元之間 (含首尾)。

LanguageConstant

語言。

欄位
resource_name	string 語言常數的資源名稱。語言常數資源名稱的格式如下： languageConstants/{criterion_id}
id	int64 語言常數的 ID。
code	string 語言代碼，例如「en_US」、「en_AU」、「es」、「fr」等。
name	string 語言的英文全名，例如「English (US)」、「Spanish」等。
targetable	bool 語言是否可指定。

ListingGroupFilterDimension

素材資源群組商家資訊群組篩選器的商家資訊維度。

欄位
聯集欄位 dimension。系統一律會提供下列其中一種維度。dimension 只能是下列其中一項：
product_bidding_category	ProductBiddingCategory 產品優惠的競價類別。
product_brand	ProductBrand 產品優惠的品牌。
product_channel	ProductChannel 產品優惠的地區。
product_condition	ProductCondition 產品優惠的狀況。
product_custom_attribute	ProductCustomAttribute 產品供應項目的自訂屬性。
product_item_id	ProductItemId 產品方案的商品 ID。
product_type	ProductType 產品優惠類型。

ProductBiddingCategory

特定層級的競價類別元素。頂層類別位於第 1 層，子類別位於第 2 層，以此類推。目前最多支援 5 個層級。使用者必須指定維度類型，指出類別的層級。相同細分的案件都必須使用相同維度類型 (類別層級)。

欄位
level	ListingGroupFilterBiddingCategoryLevel 指出分類中的類別層級。
id	int64 產品出價類別的 ID。 這個 ID 等於本文所述的 google_product_category ID：https://support.google.com/merchants/answer/6324436

ProductBrand

產品品牌。

欄位
value	string 產品品牌的字串值。

ProductChannel

產品優惠的地區。

欄位
channel	ListingGroupFilterProductChannel 縣市的值。

ProductCondition

產品優惠的狀況。

欄位
condition	ListingGroupFilterProductCondition 條件值。

ProductCustomAttribute

產品供應項目的自訂屬性。

欄位
index	ListingGroupFilterCustomAttributeIndex 表示自訂屬性的索引。
value	string 產品自訂屬性的字串值。

ProductItemId

產品方案的商品 ID。

欄位
value	string ID 的值。

ProductType

產品優惠類型。

欄位
level	ListingGroupFilterProductTypeLevel 類型層級。
value	string 類型的值。

ListingGroupFilterDimensionPath

定義商家資訊群組篩選器的維度路徑。

欄位
dimensions[]	ListingGroupFilterDimension 透過商家資訊群組篩選器階層 (不含根節點) 到這個商家資訊群組篩選器的完整維度路徑。

LocationView

地區檢視畫面會依地區條件，彙整廣告活動的成效。

欄位
resource_name	string 位置資訊檢視區塊的資源名稱。地點檢視畫面資源名稱的格式如下： customers/{customer_id}/locationViews/{campaign_id}~{criterion_id}

ProductBiddingCategoryConstant

產品出價類別。

欄位
resource_name	string 產品出價類別的資源名稱。產品出價類別資源名稱的格式如下： productBiddingCategoryConstants/{country_code}~{level}~{id}
level	ProductBiddingCategoryLevel 產品出價類別的層級。
status	ProductBiddingCategoryStatus 產品出價類別的狀態。
id	int64 產品出價類別的 ID。 這個 ID 等於本文所述的 google_product_category ID：https://support.google.com/merchants/answer/6324436。
country_code	string 產品出價類別的雙字母大寫國家/地區代碼。
product_bidding_category_constant_parent	string 父項產品出價類別的資源名稱。
language_code	string 產品出價類別的語言代碼。
localized_name	string 顯示根據 language_code 本地化的產品出價類別值。

ProductGroupView

產品群組檢視畫面。

欄位
resource_name	string 產品群組檢視畫面的資源名稱。產品群組檢視畫面資源名稱的格式如下： customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}

SearchAds360Field

SearchAds360Service 使用的欄位或資源 (構件)。

欄位
resource_name	string 構件的資源名稱。構件資源名稱的格式如下： SearchAds360Fields/{name}
category	SearchAds360FieldCategory 構件類別。
selectable_with[]	string 所有可與所述構件搭配選取的資源、區隔和指標名稱。
attribute_resources[]	string 所有可透過所述構件選取的資源名稱。如果搜尋查詢中包含這些資源的欄位，指標就不會區隔。 這個欄位只會針對類別為 RESOURCE 的構件進行設定。
metrics[]	string 這個欄位會列出所有可與所述構件搭配使用的指標名稱 (用於 FROM 子句時)。只有類別為「RESOURCE」的構件會設定這項屬性。
segments[]	string 這個欄位會列出所有構件的名稱 (無論是區隔或其他資源)，這些構件會納入搜尋查詢，並在 FROM 子句中使用所述構件時，提供區隔指標。只有類別為「RESOURCE」的構件會設定這項屬性。
enum_values[]	string 如果構件是 ENUM 類型的欄位，則構件可假設的值。 這個欄位只會針對「區隔」或「屬性」類別的構件進行設定。
data_type	SearchAds360FieldDataType 這個欄位會決定可在 WHERE 子句中搭配構件使用的運算子。
name	string 構件名稱。
selectable	bool 構件是否可在搜尋查詢的 SELECT 子句中使用。
filterable	bool 構件是否可在搜尋查詢的 WHERE 子句中使用。
sortable	bool 構件是否可用於搜尋查詢的 ORDER BY 子句。
type_url	string 描述構件資料類型的 proto 網址。
is_repeated	bool 欄位構件是否重複。

ShoppingPerformanceView

購物成效檢視畫面。提供在多個產品維度層級匯總的購物廣告活動統計資料。Merchant Center 的產品維度值 (例如品牌、類別、自訂屬性、產品狀況和產品類型) 會反映記錄對應事件時各維度的狀態。

欄位
resource_name	string 購物廣告活動成效檢視畫面的資源名稱。購物廣告活動成效檢視畫面資源名稱的格式為：customers/{customer_id}/shoppingPerformanceView

UserList

使用者清單。這是客戶可鎖定的使用者名單。

欄位
resource_name	string 使用者名單的資源名稱。使用者名單資源名稱的格式如下： customers/{customer_id}/userLists/{user_list_id}
type	UserListType 這份清單的類型。 這是唯讀欄位。
id	int64 使用者名單的 ID。
name	string 這份使用者名單的名稱。視 access_reason 而定，使用者名單名稱可能不是專屬名稱 (例如，如果 access_reason=SHARED)

UserLocationView

使用者位置檢視畫面。

「使用者位置」檢視畫面會顯示以國家/地區為單位的匯總指標，每個國家/地區各占一行。這份報表會按已指定或未指定地區，顯示使用者實際所在地區的指標。如果使用其他區隔欄位，每個國家/地區可能會有多個資料列。

欄位
resource_name	string 使用者位置資訊檢視區的資源名稱。UserLocation 檢視資源名稱的格式如下： customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}
country_criterion_id	int64 國家/地區的條件 ID。
targeting_location	bool 指出是否指定了位置。

前往

一次拜訪。

欄位
resource_name	string 拜訪的資源名稱。造訪資源名稱的格式如下： customers/{customer_id}/visits/{ad_group_id}~{criterion_id}~{ds_visit_id}
id	int64 造訪的 ID。
criterion_id	int64 Search Ads 360 關鍵字 ID。如果值為 0，表示關鍵字未歸因。
merchant_id	int64 包含遭點擊產品的 Search Ads 360 商品型錄帳戶 ID。在 Search Ads 360 中連結目錄帳戶時，Search Ads 360 會產生這組 ID。
ad_id	int64 廣告 ID。值為 0 表示廣告未歸因。
click_id	string 每次造訪的專屬字串，會以點擊 ID 網址參數的形式傳遞至到達網頁。
visit_date_time	string 造訪事件的時間戳記。時間戳記採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss」。
product_id	string 遭點擊的產品 ID。
product_channel	ProductChannel 獲得點擊的產品銷售通路：線上或店面。
product_language_code	string 為內含產品相關資料的 Merchant Center 動態饋給設定的語言 (ISO-639-1)。
product_store_id	string 獲得點擊的店面商品目錄廣告中的商店。這組 ID 必須與店面產品動態饋給所使用的商店 ID 相符。
product_country_code	string 為內含所點選產品的商品目錄動態饋給註冊的國家/地區 (ISO-3166 格式)。
asset_id	int64 在造訪事件期間互動的資產 ID。
asset_field_type	AssetFieldType 造訪事件的素材資源欄位類型。

WebpageView

網頁檢視畫面。

欄位
resource_name	string 網頁檢視的資源名稱。網頁檢視資源名稱的格式如下： customers/{customer_id}/webpageViews/{ad_group_id}~{criterion_id}