Package google.ads.searchads360.v0.resources

索引

• 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	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 出價策略擁有者的描述性_name。
聯集欄位 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

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

欄位
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 廣告跨網域重新導向的所有可能最終到達網址清單。
type	AdType 廣告類型。
id	int64 廣告編號。
display_url	string 某些廣告格式的廣告說明中顯示的網址。
name	string 廣告名稱。只能用於辨識廣告。這個名稱可以重複，也不會影響放送的廣告。「名稱」欄位目前僅支援 DisplayUploadAd、ImageAd、ShoppingComparisonListingAd 和 VideoAd。
聯集欄位 ad_data。廣告類型的詳細資料。只能設定一個值。ad_data 只能是下列其中一項：
text_ad	SearchAds360TextAdInfo 文字廣告的相關詳細資料。
expanded_text_ad	SearchAds360ExpandedTextAdInfo 延展型文字廣告的相關詳細資料。
responsive_search_ad	SearchAds360ResponsiveSearchAdInfo 回應式搜尋廣告的詳細資料。
product_ad	SearchAds360ProductAdInfo 產品廣告的相關詳細資料。
expanded_dynamic_search_ad	SearchAds360ExpandedDynamicSearchAdInfo 延展型動態搜尋廣告的詳細資料。

AdGroup

廣告群組。

欄位
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 與這個廣告群組附加的標籤資源名稱。
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.sssss」格式表示。
id	int64 廣告群組的 ID。
name	string 廣告群組的名稱。 這是必填欄位，建立新廣告群組時不得空白。 長度必須少於 255 個 UTF-8 全形字元。 這個值不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。
cpc_bid_micros	int64 最高單次點擊出價。
engine_status	AdGroupEngineStatus 廣告群組的引擎狀態。

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.sssss」格式表示。
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.sssss」格式表示。

AdGroupAdLabel

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

欄位
resource_name	string 廣告群組廣告標籤的資源名稱。廣告群組廣告標籤資源名稱的格式如下：customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}
ad_group_ad	string 附加標籤的廣告群組廣告。
label	string 指派給廣告群組廣告的標籤。

AdGroupAsset

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

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

AdGroupAssetSet

adAssetSet 是廣告群組和素材資源組合之間的連結。建立 廣告群組 AssetSet 時，系統會將素材資源組合與廣告群組連結。

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

AdGroupAudienceView

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

欄位
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。此廣告群組出價調節係數的條件。 從第 5 版開始建立作業時需要。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 中「已移除」的條件仍可能在使用者介面中顯示為已啟用。舉例來說，根據預設，廣告活動會向所有年齡層的使用者顯示，除非排除排除範圍。使用者介面會將各個年齡層顯示為「已啟用」，因為它們有資格看到廣告；但是，由於未加入任何正面條件，因此 廣告群組條件.status 會顯示「已移除」。
quality_info	QualityInfo 條件品質相關資訊。
type	CriterionType 條件的類型。
labels[]	string 附加至這個廣告群組條件的標籤資源名稱。
position_estimates	PositionEstimates 不同位置的標準出價估算值。
final_urls[]	string 廣告跨網域重新導向的所有可能最終到達網址清單。
engine_id	string 外部引擎帳戶中的廣告群組條件編號。這個欄位僅適用於非 Google Ads 帳戶，例如 Yahoo Japan、Microsoft、百度等。如果是 Google Ads 實體，請改用「ad_group_criterion.criterion_id」。
last_modified_time	string 此廣告群組條件上次修改的日期。日期時間以客戶的時區為準，並以「yyyy-MM-dd HH:mm:ss.sssss」格式表示。
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 的資訊不足，無法判斷值，系統可能不會填入這個欄位。

AdGroupCriterionLabel

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

欄位
resource_name	string 廣告群組條件標籤的資源名稱。廣告群組條件標籤資源名稱的格式如下：customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}
ad_group_criterion	string 附加標籤的廣告群組條件。
label	string 指派給廣告群組條件的標籤。

AdGroupLabel

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

欄位
resource_name	string 廣告群組標籤的資源名稱。廣告群組標籤資源名稱的格式如下：customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}
ad_group	string 附加標籤的廣告群組。
label	string 指派給廣告群組的標籤。

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 在所有跨網域重新導向後方的可能最終到達網址清單。
status	AssetStatus 素材資源的狀態。
creation_time	string 建立這項資產時的時間戳記。時間戳記以客戶的時區為準，並以「yyyy-MM-dd HH:mm:ss」的格式顯示。
last_modified_time	string 上次修改這個資產的日期。日期時間以客戶的時區為準，並以「yyyy-MM-dd HH:mm:ss.sssss」格式表示。
id	int64 資產 ID。
name	string 素材資源名稱 (選填)。
tracking_url_template	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 個字元。廣告活動中的 ID 不得重複。
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 頂層組合檢視資源名稱的格式為：「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 是資產和資產集之間的連結。新增 AssetSetAsset 可連結資產與資產集。

欄位
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 必要欄位。目標對象的名稱。所有目標對象均不得重複。長度下限為 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 廣告的指定地理區域設定。
labels[]	string 廣告活動所附加標籤的資源名稱。
bidding_strategy_type	BiddingStrategyType 出價策略類型。 設定出價策略時，您可以選擇使用出價配置來建立標準出價策略，或設定「bidding_strategy」欄位建立組合出價策略。 這是唯讀欄位。
accessible_bidding_strategy	string AccessibleBiddingStrategy 的資源名稱為唯讀檢視畫面，顯示在附加的組合出價策略中，由「bidding_strategy」識別的未受限制屬性。如果廣告活動未使用組合策略，則為空白。所有能共用策略並讀取 AccessibleBiddingStrategy 資源的客戶，都能使用未受限制的策略屬性。反之，受限制的屬性則只有策略擁有者及其管理員可使用。受限制的屬性只能從出價策略資源中讀取。
frequency_caps[]	FrequencyCapEntry 此清單用來限制每位使用者看到這個廣告活動的廣告的頻率。
selective_optimization	SelectiveOptimization 這個廣告活動的選擇性最佳化設定，包括一組要為這個廣告活動最佳化的轉換動作。這項功能僅適用於將 MULTI_CHANNEL 做為 AdvertisingChannelType 以及 APP_CAMPAIGN_FOR_ENGAGEMENT 做為 AdvertisingChannelSubType 的應用程式廣告活動。
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 中淘汰。請改用 create_time。
creation_time	string 建立這個廣告活動的時間戳記。時間戳記以客戶的時區為準，並以「yyyy-MM-dd HH:mm:ss」的格式顯示。
last_modified_time	string 廣告活動上次修改的日期。日期時間以客戶的時區為準，並以「yyyy-MM-dd HH:mm:ss.sssss」格式表示。
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。廣告活動的出價策略。 必須為廣告活動組合 (透過出價策略服務建立) 或標準組合。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

這個廣告活動的選擇性最佳化設定，包括一組要為這個廣告活動最佳化的轉換動作。這項功能僅適用於將 MULTI_CHANNEL 做為 AdvertisingChannelType 以及 APP_CAMPAIGN_FOR_ENGAGEMENT 做為 AdvertisingChannelSubType 的應用程式廣告活動。

欄位
conversion_actions[]	string 選取一組用來最佳化這個廣告活動的轉換動作。

ShoppingSetting

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

欄位
feed_label	string 要加進廣告活動的產品動態饋給標籤。只能設定 feed_label 或 sales_country 其中一個。如果使用而不是 sales_country 值，則 feed_label 欄位可接受相同格式的國家/地區代碼，例如「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 預算金額，以帳戶當地幣別表示。金額是以微量指定，100 萬相當於一個貨幣單位。每月支出上限為這個金額的 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.sssss」格式表示。
criterion_id	int64 條件的 ID。 在變更期間，系統會忽略此欄位。
bid_modifier	float 符合條件時的出價修飾符。修飾符的範圍必須介於 0.1 至 10.0 之間。大多數可指定的條件類型都支援修飾符。如要停用裝置類型，請輸入 0。
negative	bool 要指定 (false) 或排除 (true) 條件。
聯集欄位 criterion。廣告活動條件。 只能設定一個值。criterion 只能採用下列其中一種設定：
keyword	KeywordInfo 關鍵字。
location	LocationInfo 。
device	DeviceInfo Device.
age_range	AgeRangeInfo 年齡層。
gender	GenderInfo 性別。
user_list	UserListInfo 使用者名單。
language	LanguageInfo 語言。
webpage	WebpageInfo 網頁。
location_group	LocationGroupInfo 地區群組

CampaignLabel

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

欄位
resource_name	string 資源名稱。廣告活動標籤資源名稱的格式如下：customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}
campaign	string 附加標籤的廣告活動。
label	string 指派給廣告活動的標籤。

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 指示而定，這個值應等於「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 轉換的狀態：已啟用或「已移除」。
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，則該轉換動作仍可出價。如果沒有設定，primary_for_goal 會預設為 true。在 V9 中，您只能透過「update」作業建立 primary_for_goal，因為這項動作並未宣告為選用，
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

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

欄位
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"}」的系統欄，

顧客

客戶。

欄位
resource_name	string 客戶的資源名稱。客戶資源名稱的格式如下： customers/{customer_id}
conversion_tracking_setting	ConversionTrackingSetting 客戶的轉換追蹤設定。
account_type	AccountType 引擎帳戶類型 (例如 Google Ads、Microsoft Advertising、Yahoo Japan、百度、Facebook、引擎追蹤等)
double_click_campaign_manager_setting	DoubleClickCampaignManagerSetting DoubleClick Campaign Manager (DCM) 設定。
account_status	AccountStatus 帳戶狀態，例如「已啟用」、「已暫停」、「已移除」等
last_modified_time	string 此客戶上次修改的日期。日期時間以客戶的時區為準，並以「yyyy-MM-dd HH:mm:ss.sssss」格式表示。
engine_id	string 外部引擎帳戶中的帳戶 ID。
status	CustomerStatus 客戶的狀態。
creation_time	string 建立這位客戶時的時間戳記。時間戳記以客戶的時區為準，並以「yyyy-MM-dd HH:mm:ss」的格式顯示。
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。這是唯讀欄位。

DoubleClickCampaignManagerSetting

DoubleClick Campaign Manager (DCM) 設定。

欄位
advertiser_id	int64 與此客戶相關聯的 Campaign Manager 廣告主 ID。
network_id	int64 與此客戶相關聯的 Campaign Manager 聯播網 ID。
time_zone	string 與這位客戶相關聯的 Campaign Manager 聯播網時區，以 IANA 時區資料庫格式表示，例如 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/{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 英文的完整語言名稱，例如「英文 (US)、西班牙文」等。
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 [Google 產品類別] 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 [Google 產品類別] 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 類型的欄位。 這個欄位僅適用於 SEGMENT 或 ATTRIBUTE 類別的構件。
data_type	SearchAds360FieldDataType 這個欄位會決定可與 WHERE 子句中構件搭配使用的運算子。
name	string 構件的名稱。
selectable	bool 指定構件是否可以在搜尋查詢的 SELECT 子句中使用。
filterable	bool 指定構件是否可以在搜尋查詢的 WHERE 子句中使用。
sortable	bool 指定成果是否可在搜尋查詢的 ORDER BY 子句中使用。
type_url	string 說明構件資料類型的 proto 網址。
is_repeated	bool 欄位構件是否重複。

ShoppingPerformanceView

Shopping 成效資料檢視。提供購物廣告活動統計資料，這些統計資料按數個產品維度層級匯總。Merchant Center 中的產品維度值 (例如品牌、類別、自訂屬性、產品狀況和產品類型)，都會反映對應事件記錄日期和時間時，各個維度的狀態。

欄位
resource_name	string 購物成效檢視畫面的資源名稱。購物效能檢視畫面資源名稱的格式如下：customers/{customer_id}/shoppingPerformanceView

UserList

使用者名單。這是客戶可能指定的使用者名單。

欄位
resource_name	string 使用者名單的資源名稱。使用者名單資源名稱的形式如下： customers/{customer_id}/userLists/{user_list_id}
type	UserListType 此清單的類型。 這是唯讀欄位。
id	int64 使用者名單的編號。
name	string 此使用者名單的名稱。視 access_reason 而定，使用者名單的名稱可能不得重複 (例如，若 access_reason=SHARED)

前往

一次造訪。

欄位
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}