SearchAds360Row

查詢傳回的資料列。

JSON 表示法 
{
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdEffectiveLabel": {
    object (AdGroupAdEffectiveLabel)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionEffectiveLabel": {
    object (AdGroupCriterionEffectiveLabel)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupEffectiveLabel": {
    object (AdGroupEffectiveLabel)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "asset": {
    object (Asset)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupTopCombinationView": {
    object (AssetGroupTopCombinationView)
  },
  "assetGroup": {
    object (AssetGroup)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignEffectiveLabel": {
    object (CampaignEffectiveLabel)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "cartDataSalesView": {
    object (CartDataSalesView)
  },
  "audience": {
    object (Audience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerAssetSet": {
    object (CustomerAssetSet)
  },
  "accessibleBiddingStrategy": {
    object (AccessibleBiddingStrategy)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "keywordView": {
    object (KeywordView)
  },
  "label": {
    object (Label)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "userList": {
    object (UserList)
  },
  "userLocationView": {
    object (UserLocationView)
  },
  "webpageView": {
    object (WebpageView)
  },
  "visit": {
    object (Visit)
  },
  "conversion": {
    object (Conversion)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  },
  "customColumns": [
    {
      object (Value)
    }
  ]
}
欄位
adGroup

object (AdGroup)

查詢中參照的廣告群組。
adGroupAd

object (AdGroupAd)

查詢中參照的廣告。
adGroupAdEffectiveLabel

object (AdGroupAdEffectiveLabel)

查詢中參照的廣告群組廣告有效標籤。
adGroupAdLabel

object (AdGroupAdLabel)

查詢中參照的廣告群組廣告標籤。
adGroupAsset

object (AdGroupAsset)

查詢中參照的廣告群組素材資源。
adGroupAssetSet

object (AdGroupAssetSet)

查詢中參照的廣告群組素材資源組合。
adGroupAudienceView

object (AdGroupAudienceView)

查詢中參照的廣告群組目標對象檢視畫面。
adGroupBidModifier

object (AdGroupBidModifier)

查詢中參照的出價調節係數。
adGroupCriterion

object (AdGroupCriterion)

查詢中參照的條件。
adGroupCriterionEffectiveLabel

object (AdGroupCriterionEffectiveLabel)

查詢中參照的廣告群組條件有效標籤。
adGroupCriterionLabel

object (AdGroupCriterionLabel)

查詢中參照的廣告群組條件標籤。
adGroupEffectiveLabel

object (AdGroupEffectiveLabel)

查詢中參照的廣告群組有效標籤。
adGroupLabel

object (AdGroupLabel)

查詢中參照的廣告群組標籤。
ageRangeView

object (AgeRangeView)

查詢中參照的年齡層檢視畫面。
asset

object (Asset)

查詢中參照的資產。
assetGroupAsset

object (AssetGroupAsset)

查詢中參照的素材資源群組素材資源。
assetGroupSignal

object (AssetGroupSignal)

查詢中參照的素材資源群組信號。
assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

查詢中參照的素材資源群組商家資訊群組篩選器。
assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

查詢中參照的素材資源群組最佳組合檢視畫面。
assetGroup

object (AssetGroup)

查詢中參照的素材資源群組。
assetSetAsset

object (AssetSetAsset)

查詢中參照的素材資源組合素材資源。
assetSet

object (AssetSet)

查詢中參照的素材資源組合。
biddingStrategy

object (BiddingStrategy)

查詢中參照的出價策略。
campaignBudget

object (CampaignBudget)

查詢中參照的廣告活動預算。
campaign

object (Campaign)

查詢中參照的廣告活動。
campaignAsset

object (CampaignAsset)

查詢中參照的廣告活動素材資源。
campaignAssetSet

object (CampaignAssetSet)

查詢中參照的廣告活動素材資源組合。
campaignAudienceView

object (CampaignAudienceView)

查詢中參照的廣告活動目標對象檢視畫面。
campaignCriterion

object (CampaignCriterion)

查詢中參照的廣告活動條件。
campaignEffectiveLabel

object (CampaignEffectiveLabel)

查詢中參照的廣告活動有效標籤。
campaignLabel

object (CampaignLabel)

查詢中參照的廣告活動標籤。
cartDataSalesView

object (CartDataSalesView)

查詢中參照的購物車資料銷售檢視畫面。
audience

object (Audience)

查詢中參照的目標對象。
conversionAction

object (ConversionAction)

查詢中參照的轉換動作。
conversionCustomVariable

object (ConversionCustomVariable)

查詢中參照的轉換自訂變數。
customer

object (Customer)

查詢中參照的顧客。
customerAsset

object (CustomerAsset)

查詢中參照的顧客資產。
customerAssetSet

object (CustomerAssetSet)

查詢中參照的顧客素材資源組合。
accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

查詢中參照的可存取出價策略。
customerClient

object (CustomerClient)

查詢中參照的 CustomerClient。
dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

查詢中參照的動態搜尋廣告搜尋字詞檢視畫面。
genderView

object (GenderView)

查詢中參照的性別檢視畫面。
geoTargetConstant

object (GeoTargetConstant)

查詢中參照的地理區域目標常數。
keywordView

object (KeywordView)

查詢中參照的關鍵字檢視畫面。
label

object (Label)

查詢中參照的標籤。
languageConstant

object (LanguageConstant)

查詢中參照的語言常數。
locationView

object (LocationView)

查詢中參照的位置檢視畫面。
productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

查詢中參照的產品出價類別。
productGroupView

object (ProductGroupView)

查詢中參照的產品群組檢視畫面。
shoppingPerformanceView

object (ShoppingPerformanceView)

查詢中參照的購物成效檢視畫面。
userList

object (UserList)

查詢中參照的使用者清單。
userLocationView

object (UserLocationView)

查詢中參照的使用者位置資訊檢視畫面。
webpageView

object (WebpageView)

查詢中參照的網頁檢視畫面。
visit

object (Visit)

查詢中參照的事件層級造訪。
conversion

object (Conversion)

查詢中參照的事件層級轉換。
metrics

object (Metrics)

指標。
segments

object (Segments)

區隔。
customColumns[]

object (Value)

自訂欄。

廣告群組

廣告群組。

JSON 表示法 
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus),
  "finalUrlSuffix": string
}
欄位
resourceName

string

廣告群組的資源名稱。廣告群組資源名稱的格式如下：

customers/{customerId}/adGroups/{adGroupId}
status

enum (AdGroupStatus)

廣告群組的狀態。
type

enum (AdGroupType)

廣告群組類型。
adRotationMode

enum (AdGroupAdRotationMode)

廣告群組的廣告輪播模式。
creationTime

string

這個廣告群組的建立時間戳記。時間戳記採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss」。
targetingSetting

object (TargetingSetting)

設定指定目標相關功能。
labels[]

string

附加至這個廣告群組的標籤資源名稱。
effectiveLabels[]

string

附加至這個廣告群組的有效標籤資源名稱。有效標籤是指沿用或直接指派給這個廣告群組的標籤。
engineId

string

外部引擎帳戶中的廣告群組 ID。這個欄位僅適用於非 Google Ads 帳戶，例如 Yahoo Japan、Microsoft、百度等。如果是 Google Ads 實體，請改用「adGroup.id」。
startDate

string

這個廣告群組開始放送廣告的日期。根據預設，廣告群組會立即開始放送，或從廣告群組的開始日期開始放送，以較晚者為準。如果設定這個欄位，廣告群組會在客戶時區的指定日期開始時啟動。這個欄位僅適用於 Microsoft Advertising 和 Facebook 閘道帳戶。

格式：YYYY-MM-DD 範例：2019-03-14
endDate

string

廣告群組停止放送廣告的日期。根據預設，廣告群組會在廣告群組結束日期結束。如果設定這個欄位，廣告群組會在客戶時區的指定日期結束時停止放送。這個欄位僅適用於 Microsoft Advertising 和 Facebook 閘道帳戶。

格式：YYYY-MM-DD 範例：2019-03-14
languageCode

string

廣告群組中廣告和關鍵字的語言。這個欄位僅適用於 Microsoft Advertising 帳戶。詳情請參閱：https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage
lastModifiedTime

string

這個廣告群組上次修改的日期時間。日期時間採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss.ssssss」。
id

string (int64 format)

廣告群組的 ID。
name

string

廣告群組的名稱。

建立新廣告群組時，這個欄位為必填，且不得為空白。

長度不得超過 255 個 UTF-8 全形字元。

不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。
trackingUrlTemplate

string

用於建構追蹤網址的網址範本。
cpcBidMicros

string (int64 format)

最高單次點擊出價。如果廣告群組的有效出價策略為「手動單次點擊出價」，系統就會使用這個欄位。如果廣告群組的廣告活動使用組合出價策略，系統會忽略這個欄位，且不適用。
engineStatus

enum (AdGroupEngineStatus)

廣告群組的引擎狀態。
finalUrlSuffix

string

網址範本，用於將參數附加至最終到達網址。

AdGroupStatus

廣告群組的可能狀態。

列舉
UNSPECIFIED 未指定狀態。
UNKNOWN

這個版本不支援收到的值。

這是僅供回應的值。
ENABLED 廣告群組已啟用。
PAUSED 廣告群組已暫停。
REMOVED 廣告群組已移除。

AdGroupType

列出廣告群組可能類型的列舉。

列舉
UNSPECIFIED 未指定類型。
UNKNOWN

這個版本不支援收到的值。

這是僅供回應的值。
SEARCH_STANDARD 搜尋廣告活動的預設廣告群組類型。
DISPLAY_STANDARD 多媒體廣告活動的預設廣告群組類型。
SHOPPING_PRODUCT_ADS 放送標準產品廣告的購物廣告活動廣告群組類型。
HOTEL_ADS 飯店廣告活動的預設廣告群組類型。
SHOPPING_SMART_ADS 智慧購物廣告活動中廣告群組的類型。
VIDEO_BUMPER 不可略過的串流內影片廣告 (短片)。
VIDEO_TRUE_VIEW_IN_STREAM TrueView (可略過) 串流內影片廣告。
VIDEO_TRUE_VIEW_IN_DISPLAY TrueView 多媒體影片廣告。
VIDEO_NON_SKIPPABLE_IN_STREAM 不可略過的串流內影片廣告。
VIDEO_OUTSTREAM 串流外影片廣告。
SEARCH_DYNAMIC_ADS 動態搜尋廣告廣告群組的廣告群組類型。
SHOPPING_COMPARISON_LISTING_ADS 購物比較產品廣告活動中廣告群組的類型。
PROMOTED_HOTEL_ADS 飯店廣告群組的廣告群組類型。
VIDEO_RESPONSIVE 影片回應式廣告群組。
VIDEO_EFFICIENT_REACH 影片有效觸及廣告群組。
SMART_CAMPAIGN_ADS 智慧廣告活動的廣告群組類型。
TRAVEL_ADS 旅遊廣告活動的廣告群組類型。

AdGroupAdRotationMode

廣告群組可能的廣告輪播模式。

列舉
UNSPECIFIED 未指定廣告輪播模式。
UNKNOWN

這個版本不支援收到的值。

這是僅供回應的值。
OPTIMIZE 根據點擊或轉換次數，最佳化廣告群組廣告。
ROTATE_FOREVER 永久平均輪播。

AdGroupEngineStatus

廣告群組引擎的狀態。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
AD_GROUP_ELIGIBLE

已淘汰，請勿使用。
AD_GROUP_EXPIRED 這個廣告群組的結束日期已過，因此未放送任何廣告。
AD_GROUP_REMOVED 廣告群組已刪除。
AD_GROUP_DRAFT 這個廣告群組的相關聯廣告群組仍為草稿，因此沒有廣告放送。
AD_GROUP_PAUSED 廣告群組已暫停。
AD_GROUP_SERVING 廣告群組有效，目前正在放送廣告。
AD_GROUP_SUBMITTED 廣告群組已提交 (Microsoft Bing Ads 舊版狀態)。
CAMPAIGN_PAUSED 廣告活動已暫停，因此這個廣告群組沒有放送任何廣告。
ACCOUNT_PAUSED 由於帳戶已暫停，這個廣告群組沒有放送任何廣告。

TargetingSetting

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

JSON 表示法 
{
  "targetRestrictions": [
    {
      object (TargetRestriction)
    }
  ]
}
欄位
targetRestrictions[]

object (TargetRestriction)

限制廣告活動或廣告群組觸及範圍的指定維度設定。

TargetRestriction

每個指定目標維度的指定目標設定清單。

JSON 表示法 
{
  "targetingDimension": enum (TargetingDimension),
  "bidOnly": boolean
}
欄位
targetingDimension

enum (TargetingDimension)

這些設定適用的指定目標維度。
bidOnly

boolean

指出是否要限制廣告只根據您為這個指定目標維度選取的條件放送，或是要指定這個指定目標維度的所有值，並根據其他指定目標維度的指定目標放送廣告。值為 true 表示這些條件只會套用出價調整幅度，不會影響指定目標。值為 false 表示這些條件會限制指定目標，並套用出價調整幅度。

TargetingDimension

列舉，說明可能的指定目標維度。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
KEYWORD 關鍵字條件，例如「火星遊輪」。關鍵字可做為自訂出價維度。關鍵字一律是指定目標維度，因此可能無法使用 TargetRestriction 設為目標「ALL」維度。
AUDIENCE 目標對象條件，包括使用者名單、使用者興趣、自訂興趣相似目標對象和自訂潛在目標消費者。
TOPIC 指定內容類別的主題條件，例如「category::Animals>Pets」。用於指定多媒體和影片廣告。
GENDER 指定性別的條件。
AGE_RANGE 指定年齡層的條件。
PLACEMENT 刊登位置條件，包括「www.flowers4sale.com」等網站，以及行動應用程式、行動應用程式類別、YouTube 影片和 YouTube 頻道。
PARENTAL_STATUS 家長狀態指定目標的條件。
INCOME_RANGE 收入範圍指定條件。

AdGroupAd

廣告群組廣告。

JSON 表示法 
{
  "resourceName": string,
  "status": enum (AdGroupAdStatus),
  "ad": {
    object (Ad)
  },
  "creationTime": string,
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "engineId": string,
  "engineStatus": enum (AdGroupAdEngineStatus),
  "lastModifiedTime": string
}
欄位
resourceName

string

廣告的資源名稱。廣告群組廣告資源名稱的格式為：

customers/{customerId}/adGroupAds/{adGroupId}~{adId}
status

enum (AdGroupAdStatus)

廣告的狀態。
ad

object (Ad)

廣告。
creationTime

string

這個廣告群組廣告的建立時間戳記。日期時間採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss.ssssss」。
labels[]

string

附加至這個廣告群組廣告的標籤資源名稱。
effectiveLabels[]

string

附加至這個廣告的有效標籤資源名稱。有效標籤是指沿用或直接指派給這個廣告的標籤。
engineId

string

外部引擎帳戶中的廣告 ID。這個欄位僅適用於 Search Ads 360 帳戶，例如 Yahoo Japan、Microsoft、百度等。如為非 Search Ads 360 實體，請改用「adGroupAd.ad.id」。
engineStatus

enum (AdGroupAdEngineStatus)

外部引擎帳戶中廣告的其他狀態。視外部帳戶類型而定，可能的狀態包括「有效」、「符合資格」、「待審查」等。
lastModifiedTime

string

上次修改這個廣告群組廣告的日期時間。日期時間採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss.ssssss」。

AdGroupAdStatus

廣告群組廣告的可能狀態。

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN

這個版本不支援收到的值。

這是僅供回應的值。
ENABLED 廣告群組廣告已啟用。
PAUSED 廣告群組廣告已暫停。
REMOVED 廣告群組廣告已移除。

FinalAppUrl

深層連結至指定作業系統應用程式的網址。

JSON 表示法 
{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}
欄位
osType

enum (AppUrlOperatingSystemType)

這個網址指定的作業系統。必填。
url

string

應用程式深層連結網址。深層連結會指定應用程式中與您想顯示內容相應的位置，格式應為 {scheme}://{host_path}。架構會識別要開啟的應用程式。您可以為應用程式使用以應用程式名稱開頭的自訂配置。主機和路徑會指定應用程式中內容所在的唯一位置。例如：「exampleapp://productid_1234」。必填。

AppUrlOperatingSystemType

作業系統

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
IOS Apple IOS 作業系統。
ANDROID Android 作業系統。

AdType

廣告的可能類型。

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN

這個版本不支援收到的值。

這是僅供回應的值。
TEXT_AD 廣告是文字廣告。
EXPANDED_TEXT_AD 廣告是延展型文字廣告。延展型文字廣告已淘汰。
CALL_ONLY_AD 廣告是來電專用廣告。
EXPANDED_DYNAMIC_SEARCH_AD 廣告是延展型動態搜尋廣告。
HOTEL_AD 廣告是飯店廣告。
SHOPPING_SMART_AD 廣告是智慧購物廣告。
SHOPPING_PRODUCT_AD 廣告是標準購物廣告。
VIDEO_AD 廣告是影片廣告。
GMAIL_AD 這是 Gmail 廣告。
IMAGE_AD 這則廣告是圖片廣告。
RESPONSIVE_SEARCH_AD 廣告是回應式搜尋廣告。
LEGACY_RESPONSIVE_DISPLAY_AD 廣告是舊版回應式多媒體廣告。
APP_AD 廣告是應用程式廣告。
LEGACY_APP_INSTALL_AD 廣告是舊版應用程式安裝廣告。
RESPONSIVE_DISPLAY_AD 廣告是回應式多媒體廣告。
LOCAL_AD 廣告是地區廣告。
HTML5_UPLOAD_AD 廣告是多媒體廣告上傳廣告，產品類型為 HTML5_UPLOAD_AD。
DYNAMIC_HTML5_AD 廣告是多媒體上傳廣告，且產品類型為 DYNAMIC_HTML5_*。
APP_ENGAGEMENT_AD 廣告是應用程式參與式廣告。
SHOPPING_COMPARISON_LISTING_AD 廣告是購物產品比較廣告。
VIDEO_BUMPER_AD 影片串場廣告。
VIDEO_NON_SKIPPABLE_IN_STREAM_AD 不可略過的串流內廣告。
VIDEO_OUTSTREAM_AD 串流外影片廣告。
VIDEO_TRUEVIEW_DISCOVERY_AD 影片 TrueView 多媒體廣告。
VIDEO_TRUEVIEW_IN_STREAM_AD 影片 TrueView 串流內廣告。
VIDEO_RESPONSIVE_AD 影片回應式廣告。
SMART_CAMPAIGN_AD 智慧廣告活動直接投放廣告。
APP_PRE_REGISTRATION_AD 通用應用程式預先註冊廣告。
TRAVEL_AD 旅遊廣告。
MULTIMEDIA_AD 多媒體廣告。

SyntheticContentInfo

來自不同來源 (例如廣告主和 Google 系統) 的合成內容認證容器。

JSON 表示法 
{
  "advertiserAttestation": {
    object (SyntheticContentAttestation)
  },
  "systemAttestation": {
    object (SyntheticContentAttestation)
  }
}
欄位
advertiserAttestation

object (SyntheticContentAttestation)

廣告主提供的輸入內容。
systemAttestation

object (SyntheticContentAttestation)

Google 系統生成的合成內容相關資訊。

SyntheticContentAttestation

代表單一來源的合成內容認證。

JSON 表示法 
{
  "status": enum (SyntheticContentAttestationStatus),
  "source": enum (SyntheticContentSource)
}
欄位
status

enum (SyntheticContentAttestationStatus)

指出這個來源是否將內容視為合成內容。
source

enum (SyntheticContentSource)

合成內容認證的來源。

SyntheticContentAttestationStatus

合成內容的驗證狀態。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
NOT_SYNTHETIC 內容經過認證，確認並非合成內容。
IS_SYNTHETIC 內容已認證為合成內容。

SyntheticContentSource

合成內容標示的來源。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
ADVERTISER_ATTESTED 廣告主提供的認證。
GOOGLE_GENERATED_ADVERTISER_REVIEWED 由 Google 生成，並經過廣告主審查或提供資訊的內容。
GOOGLE_GENERATED_FULLY_AUTOMATED Google 自動產生的內容，未經廣告主審查。

SearchAds360TextAdInfo

Search Ads 360 文字廣告。

JSON 表示法 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "displayUrl": string,
  "displayMobileUrl": string,
  "adTrackingId": string
}
欄位
headline

string

廣告標題。
description1

string

廣告內容描述的第一行。
description2

string

廣告說明的第二行。
displayUrl

string

廣告的顯示網址。
displayMobileUrl

string

廣告顯示的行動版網址。
adTrackingId

string (int64 format)

廣告的追蹤 ID。

SearchAds360ExpandedTextAdInfo

Search Ads 360 延展型文字廣告。延展型文字廣告已淘汰。請改用 SearchAds360ResponsiveSearchAd。

JSON 表示法 
{
  "headline": string,
  "headline2": string,
  "headline3": string,
  "description1": string,
  "description2": string,
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
欄位
headline

string

廣告標題。
headline2

string

廣告的第二個標題。
headline3

string

廣告的第三個標題。
description1

string

廣告內容描述的第一行。
description2

string

廣告說明的第二行。
path1

string

附加至自動產生的可見網址的文字，並以分隔符號分隔。
path2

string

以分隔符號附加至 path1 的文字。
adTrackingId

string (int64 format)

廣告的追蹤 ID。

SearchAds360ResponsiveSearchAdInfo

Search Ads 360 回應式搜尋廣告。

JSON 表示法 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
欄位
headlines[]

object (AdTextAsset)

廣告標題的文字素材資源清單。廣告放送時，系統會從這個清單中選取廣告標題。
descriptions[]

object (AdTextAsset)

說明的文字素材資源清單。廣告放送時，系統會從這份清單中選取說明。
path1

string

附加至自動產生的可見網址的文字，並以分隔符號分隔。
path2

string

以分隔符號附加至 path1 的文字。
adTrackingId

string (int64 format)

廣告的追蹤 ID。

AdTextAsset

廣告中使用的文字素材資源。

JSON 表示法 
{
  "text": string
}
欄位
text

string

素材資源文字。

SearchAds360ProductAdInfo

這個類型沒有任何欄位。

Search Ads 360 產品廣告。

SearchAds360ExpandedDynamicSearchAdInfo

延展型動態搜尋廣告。

JSON 表示法 
{
  "description1": string,
  "description2": string,
  "adTrackingId": string
}
欄位
description1

string

廣告內容描述的第一行。
description2

string

廣告說明的第二行。
adTrackingId

string (int64 format)

廣告的追蹤 ID。

AdGroupAdEngineStatus

列舉 AdGroupAd 引擎狀態。

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
AD_GROUP_AD_ELIGIBLE

已淘汰，請勿使用。
AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN 百度：廣告素材未獲核准。
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW 百度：行動版網址正由百度受理審核。
AD_GROUP_AD_PARTIALLY_INVALID 百度：廣告素材無法在行動裝置上放送，但可以在桌機上放送。
AD_GROUP_AD_TO_BE_ACTIVATED 百度：廣告素材已可啟用。
AD_GROUP_AD_NOT_REVIEWED 百度：廣告素材未經審核。
AD_GROUP_AD_ON_HOLD

已淘汰，請勿使用。Gemini 先前使用的
AD_GROUP_AD_PAUSED 廣告素材已暫停。
AD_GROUP_AD_REMOVED 廣告素材已移除。
AD_GROUP_AD_PENDING_REVIEW 廣告素材待審核。
AD_GROUP_AD_UNDER_REVIEW 廣告素材正在審核中。
AD_GROUP_AD_APPROVED 廣告素材已獲准。
AD_GROUP_AD_DISAPPROVED 廣告素材已遭拒登。
AD_GROUP_AD_SERVING 廣告素材正在放送。
AD_GROUP_AD_ACCOUNT_PAUSED 由於帳戶已暫停，廣告素材也隨之暫停。
AD_GROUP_AD_CAMPAIGN_PAUSED 廣告活動已暫停，因此廣告素材也暫停放送。
AD_GROUP_AD_AD_GROUP_PAUSED 廣告群組已暫停，因此廣告素材也暫停放送。

AdGroupAdEffectiveLabel

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

JSON 表示法 
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string,
  "ownerCustomerId": string
}
欄位
resourceName

string

廣告群組廣告有效標籤的資源名稱。廣告群組廣告有效標籤資源名稱的格式為：customers/{ownerCustomerId}/adGroupAdEffectiveLabels/{adGroupId}~{adId}~{label_id}
adGroupAd

string

附加有效標籤的廣告群組廣告。
label

string

指派給廣告群組廣告的有效標籤。
ownerCustomerId

string (int64 format)

擁有有效標籤的客戶 ID。

AdGroupAdLabel

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

JSON 表示法 
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string,
  "ownerCustomerId": string
}
欄位
resourceName

string

廣告群組廣告標籤的資源名稱。廣告群組廣告標籤資源名稱的格式為：customers/{ownerCustomerId}/adGroupAdLabels/{adGroupId}~{adId}~{label_id}
adGroupAd

string

附加標籤的廣告群組廣告。
label

string

指派給廣告群組廣告的標籤。
ownerCustomerId

string (int64 format)

擁有標籤的客戶 ID。

AdGroupAsset

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

JSON 表示法 
{
  "resourceName": string,
  "adGroup": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
欄位
resourceName

string

廣告群組素材資源的資源名稱。AdGroupAsset 資源名稱的格式如下：

customers/{customerId}/adGroupAssets/{adGroupId}~{assetId}~{fieldType}
adGroup

string

必填。素材資源連結的廣告群組。
asset

string

必填。連結至廣告群組的素材資源。
status

enum (AssetLinkStatus)

廣告群組素材資源的狀態。

AssetLinkStatus

列舉，說明素材資源連結的狀態。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
ENABLED 已啟用資產連結。
REMOVED 資產連結已移除。
PAUSED 資產連結已暫停。

AdGroupAssetSet

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

JSON 表示法 
{
  "resourceName": string,
  "adGroup": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
欄位
resourceName

string

廣告群組素材資源組合的資源名稱。廣告群組素材資源組合資源名稱的格式如下：

customers/{customerId}/adGroupAssetSets/{adGroupId}~{asset_set_id}
adGroup

string

這個素材資源組合連結的廣告群組。
assetSet

string

連結至廣告群組的素材資源組合。
status

enum (AssetSetLinkStatus)

廣告群組素材資源組合的狀態。唯讀。

AssetSetLinkStatus

素材資源組合及其容器之間連結的可能狀態。

列舉
UNSPECIFIED 未指定狀態。
UNKNOWN 這個版本不支援收到的值。這是僅供回應的值。
ENABLED 已啟用素材資源組合與容器之間的連結。
REMOVED 移除素材資源組合與容器之間的連結。

AdGroupAudienceView

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

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

廣告群組目標對象檢視畫面的資源名稱。廣告群組目標對象檢視資源名稱的格式如下：

customers/{customerId}/adGroupAudienceViews/{adGroupId}~{criterionId}

AdGroupBidModifier

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

JSON 表示法 
{
  "resourceName": string,
  "bidModifier": number,

  // Union field criterion can be only one of the following:
  "device": {
    object (DeviceInfo)
  }
  // End of list of possible types for union field criterion.
}
欄位
resourceName

string

廣告群組出價調節係數的資源名稱。廣告群組出價調節係數資源名稱的格式為：

customers/{customerId}/adGroupBidModifiers/{adGroupId}~{criterionId}
bidModifier

number

條件相符時的出價調節係數。修飾符必須介於 0.1 到 10.0 之間。使用 0 即可選擇不使用裝置類型。

聯集欄位 criterion。這個廣告群組出價調節係數的條件。

從 V5 開始，建立作業時必須提供這項資訊。criterion 只能是下列其中一項：
device

object (DeviceInfo)

裝置條件。

DeviceInfo

裝置條件。

JSON 表示法 
{
  "type": enum (Device)
}
欄位
type

enum (Device)

裝置的類型。

裝置

列舉可供指定目標的 Google Ads 裝置。

列舉
UNSPECIFIED 不指定。
UNKNOWN 這個版本不含這個值。
MOBILE 配備完整瀏覽器的行動裝置。
TABLET 配備完整瀏覽器的平板電腦。
DESKTOP 電腦。
CONNECTED_TV 智慧型電視和遊戲主機。
OTHER 其他裝置類型。

AdGroupCriterion

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

JSON 表示法 
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "engineId": string,
  "lastModifiedTime": string,
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "engineStatus": enum (AdGroupCriterionEngineStatus),
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "location": {
    object (LocationInfo)
  }
  // End of list of possible types for union field criterion.
}
欄位
resourceName

string

廣告群組條件的資源名稱。廣告群組條件資源名稱的格式如下：

customers/{customerId}/adGroupCriteria/{adGroupId}~{criterionId}
creationTime

string

這個廣告群組條件的建立時間戳記。時間戳記採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss」。
status

enum (AdGroupCriterionStatus)

條件的狀態。

這是由用戶端設定的廣告群組條件實體狀態。注意：使用者介面報表可能會納入其他資訊，影響條件是否符合放送資格。在某些情況下，即使透過 API 移除條件，該條件在使用者介面中仍可能顯示為已啟用。舉例來說，除非排除，否則廣告活動預設會向所有年齡層的使用者放送。由於這些年齡層符合廣告顯示資格，使用者介面會將每個年齡層顯示為「已啟用」；但由於未新增任何正向條件，AdGroupCriterion.status 會顯示「已移除」。
qualityInfo

object (QualityInfo)

有關條件品質的資訊。
type

enum (CriterionType)

條件類型。
labels[]

string

附加至這個廣告群組條件的標籤資源名稱。
effectiveLabels[]

string

附加至這個廣告群組條件的有效標籤資源名稱。有效標籤是指繼承或直接指派給這個廣告群組條件的標籤。
positionEstimates

object (PositionEstimates)

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

string

廣告完成所有跨網域重新導向後，可能連到的最終到達網址清單。
finalMobileUrls[]

string

所有跨網域重新導向後，可能的最終行動版網址清單。
urlCustomParameters[]

object (CustomParameter)

用於取代 trackingUrlTemplate、finalUrls 或 mobile_final_urls 中自訂參數標記的對應清單。
engineId

string

外部引擎帳戶中的廣告群組條件 ID。這個欄位僅適用於非 Google Ads 帳戶，例如 Yahoo Japan、Microsoft、百度等。如果是 Google Ads 實體，請改用「adGroupCriterion.criterion_id」。
lastModifiedTime

string

這個廣告群組條件上次修改的日期時間。日期時間採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss.ssssss」。
criterionId

string (int64 format)

指定條件的 ID。
adGroup

string

條件所屬的廣告群組。
negative

boolean

是否要指定 (false) 或排除 (true) 條件。

這個欄位無法變更。如要將準則從正面切換為負面，請先移除再重新新增。
bidModifier

number

條件相符時的出價調節係數。修飾符必須介於 0.1 到 10.0 之間。大多數可指定條件類型都支援修飾符。
cpcBidMicros

string (int64 format)

單次點擊出價。
effectiveCpcBidMicros

string (int64 format)

有效單次點擊出價。
engineStatus

enum (AdGroupCriterionEngineStatus)

廣告群組條件的引擎狀態。
finalUrlSuffix

string

網址範本，用於將參數附加至最終到達網址。
trackingUrlTemplate

string

用於建構追蹤網址的網址範本。

聯集欄位 criterion。廣告群組條件。

必須設定一個選項。criterion 只能是下列其中一項：
keyword

object (KeywordInfo)

關鍵字。
listingGroup

object (ListingGroupInfo)

商家資訊群組。
ageRange

object (AgeRangeInfo)

年齡層。
gender

object (GenderInfo)

性別。
userList

object (UserListInfo)

使用者清單。
webpage

object (WebpageInfo)

網頁
location

object (LocationInfo)

。

AdGroupCriterionStatus

廣告群組條件的可能狀態。

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN

這個版本不支援收到的值。

這是僅供回應的值。
ENABLED 廣告群組條件已啟用。
PAUSED 廣告群組條件已暫停。
REMOVED 廣告群組條件已移除。

QualityInfo

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

JSON 表示法 
{
  "qualityScore": integer
}
欄位
qualityScore

integer

品質分數。

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

CriterionType

列舉說明可能的指定條件類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
KEYWORD 關鍵字，例如「火星遊輪」。
PLACEMENT 刊登位置 (又稱「網站」)，例如「www.flowers4sale.com」
MOBILE_APP_CATEGORY 要指定的行動應用程式類別。
MOBILE_APPLICATION 要指定的行動應用程式。
DEVICE 要指定的裝置。
LOCATION 要指定的地區。
LISTING_GROUP 要指定的商家資訊群組。
AD_SCHEDULE 廣告時段。
AGE_RANGE 年齡層。
GENDER 性別。
INCOME_RANGE 收入範圍。
PARENTAL_STATUS 家長狀態。
YOUTUBE_VIDEO YouTube 影片。
YOUTUBE_CHANNEL YouTube 頻道。
USER_LIST 使用者名單。
PROXIMITY 鄰近感應器。
TOPIC 多媒體廣告聯播網的主題目標 (例如「寵物與動物」)。
LISTING_SCOPE 要指定的商家資訊範圍。
LANGUAGE 語言。
IP_BLOCK IpBlock。
CONTENT_LABEL 排除類別的內容標籤。
CARRIER 電信業者。
USER_INTEREST 使用者感興趣的類別。
WEBPAGE 動態搜尋廣告的網頁條件。
OPERATING_SYSTEM_VERSION 那就是作業系統版本
APP_PAYMENT_MODEL 應用程式付款模式。
MOBILE_DEVICE 行動裝置。
CUSTOM_AFFINITY 自訂興趣相似目標對象。
CUSTOM_INTENT 自訂意願。
LOCATION_GROUP 地區群組。
CUSTOM_AUDIENCE 自訂目標對象
COMBINED_AUDIENCE 合併目標對象
KEYWORD_THEME 智慧廣告活動關鍵字主題
AUDIENCE 目標對象
LOCAL_SERVICE_ID 在地生活服務廣告服務 ID。
BRAND 品牌
BRAND_LIST 品牌清單
LIFE_EVENT 人生大事

PositionEstimates

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

JSON 表示法 
{
  "topOfPageCpcMicros": string
}
欄位
topOfPageCpcMicros

string (int64 format)

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

AdGroupCriterionEngineStatus

列舉 AdGroupCriterion 引擎狀態。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
AD_GROUP_CRITERION_ELIGIBLE

已淘汰，請勿使用。
AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN 百度：出價金額或品質分數過低，無法顯示。
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME 百度：因搜尋量過低已由百度設為暫停。
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW 百度：行動版網址正由百度受理審核。
AD_GROUP_CRITERION_PARTIALLY_INVALID 百度：某個裝置的到達網頁無效，但其他裝置的到達網頁有效。
AD_GROUP_CRITERION_TO_BE_ACTIVATED 百度：關鍵字已由百度帳戶管理小組建立完成並設為暫停，您隨時可予以啟用。
AD_GROUP_CRITERION_UNDER_REVIEW 百度：關鍵字正由百度受理審核。Gemini：條件正在審核中。
AD_GROUP_CRITERION_NOT_REVIEWED 百度：待審核的條件。
AD_GROUP_CRITERION_ON_HOLD

已淘汰，請勿使用。Gemini 先前使用的
AD_GROUP_CRITERION_PENDING_REVIEW Y!J：條件待審
AD_GROUP_CRITERION_PAUSED 準則已暫停。
AD_GROUP_CRITERION_REMOVED 已移除準則。
AD_GROUP_CRITERION_APPROVED 條件已獲核准。
AD_GROUP_CRITERION_DISAPPROVED 條件已遭拒登。
AD_GROUP_CRITERION_SERVING 條件有效且正在放送。
AD_GROUP_CRITERION_ACCOUNT_PAUSED 由於帳戶已暫停，因此條件也已暫停。

CustomParameter

可供 trackingUrlTemplate、finalUrls 或 mobile_final_urls 中的自訂參數代碼使用的對應。

JSON 表示法 
{
  "key": string,
  "value": string
}
欄位
key

string

與參數標記名稱相符的鍵。
value

string

要替換的值。

KeywordInfo

關鍵字條件。

JSON 表示法 
{
  "matchType": enum (KeywordMatchType),
  "text": string
}
欄位
matchType

enum (KeywordMatchType)

關鍵字的比對類型。
text

string

關鍵字文字 (最多 80 個半形字元和 10 個字)。

KeywordMatchType

可能的關鍵字比對類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
EXACT 完全比對。
PHRASE 詞組比對。
BROAD 廣泛比對。

ListingGroupInfo

商家資訊群組條件。

JSON 表示法 
{
  "type": enum (ListingGroupType)
}
欄位
type

enum (ListingGroupType)

商家資訊群組的類型。

ListingGroupType

商家資訊群組的類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
SUBDIVISION 沿著某些產品資訊維度細分產品。這些節點不會用於放送，以指定目標產品資訊項目，而是純粹用於定義樹狀結構。
UNIT 定義出價的商家資訊群組單元。

AgeRangeInfo

年齡層條件。

JSON 表示法 
{
  "type": enum (AgeRangeType)
}
欄位
type

enum (AgeRangeType)

年齡層類型。

AgeRangeType

客層年齡範圍類型 (例如 18 到 24 歲)。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
AGE_RANGE_18_24 年齡介於 18 到 24 歲。
AGE_RANGE_25_34 25 到 34 歲。
AGE_RANGE_35_44 35 到 44 歲。
AGE_RANGE_45_54 45 到 54 歲。
AGE_RANGE_55_64 年齡介於 55 到 64 歲。
AGE_RANGE_65_UP 65 歲以上。
AGE_RANGE_UNDETERMINED 年齡層未確定。

GenderInfo

性別條件。

JSON 表示法 
{
  "type": enum (GenderType)
}
欄位
type

enum (GenderType)

性別類型。

GenderType

客層性別類型 (例如女性)。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
MALE 男性。
FEMALE 女性。
UNDETERMINED 性別未確定。

UserListInfo

使用者名單條件。代表廣告主定義的目標對象名單。

JSON 表示法 
{
  "userList": string
}
欄位
userList

string

使用者名單資源名稱。

WebpageInfo

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

JSON 表示法 
{
  "conditions": [
    {
      object (WebpageConditionInfo)
    }
  ],
  "coveragePercentage": number,
  "criterionName": string
}
欄位
conditions[]

object (WebpageConditionInfo)

指定網頁的條件或邏輯運算式。評估網頁指定目標時，系統會將網頁指定目標條件清單以 AND 運算子合併。如果條件清單為空白，表示廣告活動網站的所有網頁都是指定目標。

建立作業必須填寫這個欄位，更新作業則不得填寫。
coveragePercentage

number

網站條件涵蓋率百分比。這是根據廣告群組和廣告活動中的網站目標、排除網站目標和排除關鍵字，計算出的網站涵蓋率百分比。舉例來說，如果涵蓋範圍傳回 1，表示涵蓋範圍為 100%。這是唯讀欄位。
criterionName

string

這個參數定義的條件名稱。系統會使用名稱值，識別、排序及篩選這類參數的條件。

建立作業必須填寫這個欄位，更新作業則不得填寫。

WebpageConditionInfo

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

JSON 表示法 
{
  "operand": enum (WebpageConditionOperand),
  "operator": enum (WebpageConditionOperator),
  "argument": string
}
欄位
operand

enum (WebpageConditionOperand)

網頁指定目標條件的運算元。
operator

enum (WebpageConditionOperator)

網頁指定條件的運算子。
argument

string

網頁指定目標條件的引數。

WebpageConditionOperand

網頁條件運算元 (網頁條件)。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
URL 表示網頁網址指定目標條件的運算元。
CATEGORY 表示網頁類別指定目標條件的運算元。
PAGE_TITLE 表示網頁標題指定條件的運算元。
PAGE_CONTENT 表示網頁指定內容條件的運算元。
CUSTOM_LABEL 表示網頁自訂標籤指定條件的運算元。

WebpageConditionOperator

網頁條件運算子 (位於網頁條件中)。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
EQUALS 引數網站條件等於比較對象網站條件。
CONTAINS 引數網頁條件是比較網頁條件的一部分。

地點資訊

地點條件。

JSON 表示法 
{
  "geoTargetConstant": string
}
欄位
geoTargetConstant

string

地理目標常數資源名稱。

AdGroupCriterionEffectiveLabel

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

JSON 表示法 
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string,
  "ownerCustomerId": string
}
欄位
resourceName

string

廣告群組條件有效標籤的資源名稱。廣告群組條件有效標籤資源名稱的格式為：customers/{ownerCustomerId}/adGroupCriterionEffectiveLabels/{adGroupId}~{criterionId}~{label_id}
adGroupCriterion

string

有效標籤所附加的廣告群組條件。
label

string

指派給廣告群組條件的有效標籤。
ownerCustomerId

string (int64 format)

擁有有效標籤的客戶 ID。

AdGroupCriterionLabel

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

JSON 表示法 
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string,
  "ownerCustomerId": string
}
欄位
resourceName

string

廣告群組條件標籤的資源名稱。廣告群組條件標籤資源名稱的格式為：customers/{ownerCustomerId}/adGroupCriterionLabels/{adGroupId}~{criterionId}~{label_id}
adGroupCriterion

string

標籤附加的廣告群組條件。
label

string

指派給廣告群組條件的標籤。
ownerCustomerId

string (int64 format)

擁有標籤的客戶 ID。

AdGroupEffectiveLabel

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

JSON 表示法 
{
  "resourceName": string,
  "adGroup": string,
  "label": string,
  "ownerCustomerId": string
}
欄位
resourceName

string

廣告群組有效標籤的資源名稱。廣告群組有效標籤資源名稱的格式為：customers/{ownerCustomerId}/adGroupEffectiveLabels/{adGroupId}~{label_id}
adGroup

string

有效標籤所附加的廣告群組。
label

string

指派給廣告群組的有效標籤。
ownerCustomerId

string (int64 format)

擁有有效標籤的客戶 ID。

AdGroupLabel

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

JSON 表示法 
{
  "resourceName": string,
  "adGroup": string,
  "label": string,
  "ownerCustomerId": string
}
欄位
resourceName

string

廣告群組標籤的資源名稱。廣告群組標籤資源名稱的格式為：customers/{ownerCustomerId}/adGroupLabels/{adGroupId}~{label_id}
adGroup

string

標籤所附加的廣告群組。
label

string

指派給廣告群組的標籤。
ownerCustomerId

string (int64 format)

擁有標籤的客戶 ID。

AgeRangeView

年齡層檢視畫面。

代表客戶成效指標 (例如曝光次數和點擊次數) 的檢視畫面，並依年齡範圍匯總。所有統計資料都會在廣告群組層級匯總。

注意：您可以使用 ageRangeView 按年齡範圍區隔指標，或使用 genderView 按性別區隔指標，但 Search Ads 360 API 不支援在單一查詢中同時按年齡範圍和性別區隔指標。Search Ads 360 API 不支援分析這兩個維度的合併成效。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

年齡範圍檢視畫面的資源名稱。年齡範圍檢視畫面資源名稱的格式如下：

customers/{customerId}/ageRangeViews/{adGroupId}~{criterionId}

素材資源

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

JSON 表示法 
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "syntheticContentInfo": {
    object (SyntheticContentInfo)
  },
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "engineStatus": enum (AssetEngineStatus),

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "calloutAsset": {
    object (UnifiedCalloutAsset)
  },
  "sitelinkAsset": {
    object (UnifiedSitelinkAsset)
  },
  "pageFeedAsset": {
    object (UnifiedPageFeedAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "callAsset": {
    object (UnifiedCallAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "locationAsset": {
    object (UnifiedLocationAsset)
  }
  // End of list of possible types for union field asset_data.
}
欄位
resourceName

string

資產的資源名稱。素材資源名稱的格式如下：

customers/{customerId}/assets/{assetId}
type

enum (AssetType)

資產類型。
finalUrls[]

string

所有跨網域重新導向後，可能的最終到達網址清單。
finalMobileUrls[]

string

所有跨網域重新導向後，可能的最終行動版網址清單。
urlCustomParameters[]

object (CustomParameter)

用於取代 trackingUrlTemplate、finalUrls 和/或 finalMobileUrls 中網址自訂參數標記的對應清單。
status

enum (AssetStatus)

資產狀態。
creationTime

string

這項資產的建立時間戳記。時間戳記採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss」。
lastModifiedTime

string

這項資產的上次修改日期和時間。日期時間採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss.ssssss」。
syntheticContentInfo

object (SyntheticContentInfo)

素材資源的合成內容資訊。只有特定類型的素材資源可使用 syntheticContentInfo 欄位更新。

允許的 AssetType 值：* IMAGE * MEDIA_BUNDLE * YOUTUBE_VIDEO
id

string (int64 format)

資產 ID。
name

string

素材資源的選用名稱。
trackingUrlTemplate

string

用於建構追蹤網址的網址範本。
finalUrlSuffix

string

網址範本，用於將參數附加至透過並行追蹤放送的到達網頁網址。
engineStatus

enum (AssetEngineStatus)

素材資源的引擎狀態。
聯集欄位 asset_data。素材資源的具體類型。asset_data 只能是下列其中一項：
youtubeVideoAsset

object (YoutubeVideoAsset)

YouTube 影片素材資源。
imageAsset

object (ImageAsset)

圖片素材資源。
textAsset

object (TextAsset)

文字素材資源。
calloutAsset

object (UnifiedCalloutAsset)

統一摘要素材資源。
pageFeedAsset

object (UnifiedPageFeedAsset)

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

object (MobileAppAsset)

行動應用程式素材資源。
callAsset

object (UnifiedCallAsset)

統一電話素材資源。
callToActionAsset

object (CallToActionAsset)

行動號召素材資源。
locationAsset

object (UnifiedLocationAsset)

統一地點素材資源。

AssetType

列舉說明可能的資產類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
YOUTUBE_VIDEO YouTube 影片素材資源。
MEDIA_BUNDLE 媒體組合素材資源。
IMAGE 圖片素材資源。
TEXT 文字素材資源。
LEAD_FORM 待開發客戶表單素材資源。
BOOK_ON_GOOGLE 透過 Google 訂房素材資源。
PROMOTION 宣傳素材資源。
CALLOUT 摘要素材資源。
STRUCTURED_SNIPPET 網站簡介素材資源。
PAGE_FEED 網頁動態饋給素材資源。
DYNAMIC_EDUCATION 動態教育素材資源。
MOBILE_APP 行動應用程式素材資源。
HOTEL_CALLOUT 飯店摘要素材資源。
CALL 電話素材資源。
PRICE 價格素材資源。
CALL_TO_ACTION 行動號召素材資源。
DYNAMIC_REAL_ESTATE 動態房地產素材資源。
DYNAMIC_CUSTOM 動態自訂素材資源。
DYNAMIC_HOTELS_AND_RENTALS 動態飯店和度假民宿素材資源。
DYNAMIC_FLIGHTS 動態航班素材資源。
DYNAMIC_TRAVEL 動態旅遊素材資源。
DYNAMIC_LOCAL 動態當地素材資源。
DYNAMIC_JOBS 動態職缺素材資源。
LOCATION 地點素材資源。
HOTEL_PROPERTY 飯店房源素材資源。

AssetStatus

素材資源可能有的狀態。

列舉
UNSPECIFIED 未指定狀態。
UNKNOWN 這個版本不支援收到的值。這是僅供回應的值。
ENABLED 資產已啟用。
REMOVED 素材資源已移除。
ARCHIVED 資產已封存。
PENDING_SYSTEM_GENERATED 素材資源為系統生成，暫待使用者審查。

AssetEngineStatus

列舉說明可能的資產引擎狀態。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
SERVING 資產有效。
SERVING_LIMITED 素材資源有效，但受到限制。
DISAPPROVED 資產遭拒登 (不符合資格)。
DISABLED 資產已停用 (待處理)。
REMOVED 該資產已移除。

YoutubeVideoAsset

YouTube 資產。

JSON 表示法 
{
  "youtubeVideoTitle": string,
  "youtubeVideoId": string
}
欄位
youtubeVideoTitle

string

YouTube 影片標題。
youtubeVideoId

string

YouTube 影片 ID。這是 YouTube 影片網址中使用的 11 個字元字串值。

ImageAsset

圖片素材資源。

JSON 表示法 
{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "fileSize": string
}
欄位
mimeType

enum (MimeType)

圖片素材資源的 MIME 類型。
fullSize

object (ImageDimension)

這張圖片原始大小的中繼資料。
fileSize

string (int64 format)

圖片素材資源的檔案大小 (以位元組為單位)。

MimeType

MIME 類型

列舉
UNSPECIFIED 未指定 MIME 類型。
UNKNOWN

這個版本不支援收到的值。

這是僅供回應的值。
IMAGE_JPEG 圖片/jpeg 的 MIME 類型。
IMAGE_GIF 圖片/GIF 的 MIME 類型。
IMAGE_PNG 圖片/png 的 MIME 類型。
FLASH application/x-shockwave-flash 的 MIME 類型。
TEXT_HTML text/html 的 MIME 類型。
PDF 應用程式/pdf 的 MIME 類型。
MSWORD application/msword 的 MIME 類型。
MSEXCEL application/vnd.ms-excel 的 MIME 類型。
RTF application/rtf 的 MIME 類型。
AUDIO_WAV 音訊/wav 的 MIME 類型。
AUDIO_MP3 音訊/mp3 的 MIME 類型。
HTML5_AD_ZIP application/x-html5-ad-zip 的 MIME 類型。

ImageDimension

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

JSON 表示法 
{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}
欄位
heightPixels

string (int64 format)

圖片高度。
widthPixels

string (int64 format)

圖片寬度。
url

string

傳回具有此高度和寬度的圖片的網址。

TextAsset

文字素材資源。

JSON 表示法 
{
  "text": string
}
欄位
text

string

文字素材資源的文字內容。

UnifiedCalloutAsset

統一摘要素材資源。

JSON 表示法 
{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "useSearcherTimeZone": boolean
}
欄位
calloutText

string

摘要文字。這個字串的長度應介於 1 到 25 (含首尾)。
startDate

string

這項素材資源的生效日期，格式為 yyyy-MM-dd。
endDate

string

這個素材資源有效且仍在放送的最後日期，格式為 yyyy-MM-dd。
adScheduleTargets[]

object (AdScheduleInfo)

不重疊的排程清單，指定資產可放送的所有時間間隔。每天最多可設定 6 個時段，總共 42 個。
useSearcherTimeZone

boolean

是否要在搜尋使用者的時區中顯示資產。適用於 Microsoft Ads。

AdScheduleInfo

代表廣告時段條件。

AdSchedule 會指定廣告放送的星期和時間間隔。

同一天最多只能新增六個廣告時段。

JSON 表示法 
{
  "startMinute": enum (MinuteOfHour),
  "endMinute": enum (MinuteOfHour),
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer
}
欄位
startMinute

enum (MinuteOfHour)

這項排程在開始時間的小時過後幾分鐘開始。

建立作業必須填寫這個欄位，更新作業則不得填寫。
endMinute

enum (MinuteOfHour)

此排程結束時間的小時數之後的分鐘數。排定時間不含最後一分鐘。

建立作業必須填寫這個欄位，更新作業則不得填寫。
dayOfWeek

enum (DayOfWeek)

時間表適用的星期幾。

建立作業必須填寫這個欄位，更新作業則不得填寫。
startHour

integer

開始時間 (24 小時制)。這個欄位必須介於 0 到 23 之間 (含首尾)。

建立作業必須填寫這個欄位，更新作業則不得填寫。
endHour

integer

結束時間 (24 小時制)，24 代表一天結束。這個欄位的值必須介於 0 到 24 之間 (含首尾)。

建立作業必須填寫這個欄位，更新作業則不得填寫。

MinuteOfHour

列舉四分之一小時。例如「FIFTEEN」

列舉
UNSPECIFIED 不指定。
UNKNOWN 這個版本不含這個值。
ZERO 整點。
FIFTEEN 整點過後 15 分鐘。
THIRTY 整點過後 30 分鐘。
FORTY_FIVE 整點過後 45 分鐘。

DayOfWeek

列舉星期幾，例如「星期一」。

列舉
UNSPECIFIED 不指定。
UNKNOWN 這個版本不含這個值。
MONDAY 星期一。
TUESDAY 星期二。
WEDNESDAY 星期三。
THURSDAY 星期四。
FRIDAY 星期五。
SATURDAY 相同格式。
SUNDAY 星期日。

UnifiedSitelinkAsset

統一網站連結素材資源。

JSON 表示法 
{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "trackingId": string,
  "useSearcherTimeZone": boolean,
  "mobilePreferred": boolean
}
欄位
linkText

string

網站連結的網址顯示文字。這個字串的長度應介於 1 到 25 (含首尾)。
description1

string

網站連結說明的第一行。如要設定，長度必須介於 1 至 35 之間 (含首尾)，且也必須設定 description2。
description2

string

網站連結的第二行說明。如要設定，長度應介於 1 到 35 個字元之間 (含首尾)，且必須同時設定 description1。
startDate

string

這項素材資源的生效日期，格式為 yyyy-MM-dd。
endDate

string

這個素材資源有效且仍在放送的最後日期，格式為 yyyy-MM-dd。
adScheduleTargets[]

object (AdScheduleInfo)

不重疊的排程清單，指定資產可放送的所有時間間隔。每天最多可設定 6 個時段，總共 42 個。
trackingId

string (int64 format)

用於追蹤網站連結素材資源點擊的 ID。這是 Yahoo! 僅限日本的欄位。
useSearcherTimeZone

boolean

是否要在搜尋使用者的時區中顯示網站連結素材資源。適用於 Microsoft Ads。
mobilePreferred

boolean

偏好在行動裝置上顯示網站連結素材資源。適用於 Microsoft Ads。

UnifiedPageFeedAsset

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

JSON 表示法 
{
  "pageUrl": string,
  "labels": [
    string
  ]
}
欄位
pageUrl

string

廣告主想指定的網頁。
labels[]

string

用來將網頁網址分組的標籤。

MobileAppAsset

代表行動應用程式的資產。

JSON 表示法 
{
  "appId": string,
  "appStore": enum (MobileAppVendor)
}
欄位
appId

string

必填。可唯一識別行動應用程式的字串。其中應只包含平台原生 ID，例如 Android 的「com.android.ebay」或 iOS 的「12345689」。
appStore

enum (MobileAppVendor)

必填。發布這個特定應用程式的應用程式商店。

MobileAppVendor

行動應用程式供應商類型

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
APPLE_APP_STORE Apple App Store 的行動應用程式供應商。
GOOGLE_APP_STORE Google 應用程式商店的行動應用程式供應商。

UnifiedCallAsset

統一電話素材資源。

JSON 表示法 
{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "callOnly": boolean,
  "callTrackingEnabled": boolean,
  "useSearcherTimeZone": boolean,
  "startDate": string,
  "endDate": string
}
欄位
countryCode

string

電話號碼的雙字母國家/地區代碼。例如「US」、「us」。
phoneNumber

string

廣告主的原始電話號碼。範例：「1234567890」、「(123)456-7890」
callConversionReportingState

enum (CallConversionReportingState)

指出這個 CallAsset 應使用自己的來電轉換設定、遵循帳戶層級設定，還是停用來電轉換。
callConversionAction

string

要將來電轉換歸因於哪個轉換動作。如未設定，系統會使用預設轉換動作。只有在 callConversionReportingState 設為 USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION 時，這個欄位才會生效。
adScheduleTargets[]

object (AdScheduleInfo)

不重疊的排程清單，指定資產可放送的所有時間間隔。每天最多可設定 6 個時段，總共 42 個。
callOnly

boolean

僅限來電廣告是否只顯示電話號碼，而不提供網站連結。適用於 Microsoft Ads。
callTrackingEnabled

boolean

是否應啟用通話追蹤功能。適用於 Microsoft Ads。
useSearcherTimeZone

boolean

是否要在搜尋使用者的時區中顯示來電額外資訊。適用於 Microsoft Ads。
startDate

string

這項素材資源的生效日期，格式為 yyyy-MM-dd。
endDate

string

這個素材資源有效且仍在放送的最後日期，格式為 yyyy-MM-dd。

CallConversionReportingState

來電轉換動作狀態的可能資料類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
DISABLED 來電轉換動作已停用。
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION 來電轉換動作會使用帳戶層級設定的來電轉換類型。
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION 系統會使用在資源 (來電專用廣告/來電額外資訊) 層級設定的來電轉換類型，做為來電轉換動作。

CallToActionAsset

行動號召素材資源。

JSON 表示法 
{
  "callToAction": enum (CallToActionType)
}
欄位
callToAction

enum (CallToActionType)

行動號召。

CallToActionType

列舉說明可能的行動號召類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
LEARN_MORE 行動號召類型為「瞭解詳情」。
GET_QUOTE 行動號召類型為「取得報價」。
APPLY_NOW 行動號召類型為「立即申請」。
SIGN_UP 行動號召類型為「註冊」。
CONTACT_US 行動號召類型為「與我們聯絡」。
SUBSCRIBE 行動號召類型為「訂閱」。
DOWNLOAD 行動號召類型為「下載」。
BOOK_NOW 行動號召類型為「立即預訂」。
SHOP_NOW 行動號召類型為「立即選購」。
BUY_NOW 行動號召類型為「立即購買」。
DONATE_NOW 行動號召類型為「立即捐款」。
ORDER_NOW 行動號召類型為「立即訂購」。
PLAY_NOW 行動號召類型為「立即播放」。
SEE_MORE 行動號召類型為「查看更多」。
START_NOW 行動號召類型為「立即開始」。
VISIT_SITE 行動號召類型為「造訪網站」。
WATCH_NOW 行動號召類型為「立即觀看」。

UnifiedLocationAsset

統一地點素材資源。

JSON 表示法 
{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}
欄位
placeId

string

地點 ID 可以用來辨識 Google 地點介面集資料庫和 Google 地圖中的特定地點。這個欄位是特定客戶 ID 和資產類型的專屬欄位。如要進一步瞭解地點 ID，請參閱 https://developers.google.com/places/web-service/place-id。
businessProfileLocations[]

object (BusinessProfileLocation)

客戶的商家所在地點清單。只有在地點素材資源是從商家檔案帳戶同步時，才會傳回這項資訊。同一個帳戶下可能有多個商家檔案資訊，但指向同一個地點 ID。
locationOwnershipType

enum (LocationOwnershipType)

地點擁有權類型。如果類型為 BUSINESS_OWNER，系統會將其做為地點額外資訊放送。如果類型為 AFFILIATE，系統會將其做為聯盟地點放送。

BusinessProfileLocation

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

JSON 表示法 
{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}
欄位
labels[]

string

廣告主為商家檔案帳戶中的地點指定的標籤。這項資訊會與商家檔案帳戶同步。
storeCode

string

這個地點的商家檔案商店代碼。這項資訊會與商家檔案帳戶同步。
listingId

string (int64 format)

這個商家檔案地點的商家資訊 ID。這項資訊會與已連結的商家檔案帳戶同步。

LocationOwnershipType

地點擁有權的可能類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
BUSINESS_OWNER 地點的商家業主(舊版地點額外資訊 - LE)。
AFFILIATE 經銷地點(第三方地點額外資訊 - ALE)。

AssetGroupAsset

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

JSON 表示法 
{
  "resourceName": string,
  "assetGroup": string,
  "asset": string,
  "fieldType": enum (AssetFieldType),
  "status": enum (AssetLinkStatus)
}
欄位
resourceName

string

素材資源群組素材資源的資源名稱。素材資源群組素材資源的資源名稱格式如下：

customers/{customerId}/assetGroupAssets/{asset_group_id}~{assetId}~{fieldType}
assetGroup

string

這個素材資源群組資產連結的素材資源群組。
asset

string

這個素材資源群組素材資源連結的素材資源。
fieldType

enum (AssetFieldType)

素材資源在素材資源群組中的位置說明。例如：HEADLINE、YOUTUBE_VIDEO 等
status

enum (AssetLinkStatus)

素材資源與素材資源群組之間連結的狀態。

AssetFieldType

列舉，說明資產的可能刊登位置。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
HEADLINE 素材資源已連結，可做為廣告標題。
DESCRIPTION 素材資源已連結，可做為說明使用。
MANDATORY_AD_TEXT 素材資源已連結，可做為必要廣告文字。
MARKETING_IMAGE 素材資源已連結，可做為行銷圖片。
MEDIA_BUNDLE 素材資源已連結，可做為媒體組合使用。
YOUTUBE_VIDEO 資產已連結，可做為 YouTube 影片使用。
BOOK_ON_GOOGLE 素材資源會連結至廣告活動，表示飯店廣告活動已啟用「透過 Google 訂房」功能。
LEAD_FORM 素材資源已連結，可做為待開發客戶表單額外資訊使用。
PROMOTION 素材資源已連結，可做為促銷活動擴展功能。
CALLOUT 素材資源已連結，可做為摘要額外資訊使用。
STRUCTURED_SNIPPET 素材資源已連結，可做為網站簡介額外資訊使用。
MOBILE_APP 素材資源已連結，可做為行動應用程式額外資訊使用。
HOTEL_CALLOUT 素材資源已連結，可做為飯店摘要額外資訊使用。
CALL 素材資源已連結，可做為來電額外資訊使用。
PRICE 資產已連結，可做為價格額外資訊使用。
LONG_HEADLINE 素材資源已連結，可做為長標題使用。
BUSINESS_NAME 素材資源已連結，可做為商家名稱。
SQUARE_MARKETING_IMAGE 素材資源已連結，可做為正方形行銷圖片使用。
PORTRAIT_MARKETING_IMAGE 素材資源已連結，可做為直向行銷圖片。
VIDEO 該資產已連結，可做為非 YouTube 標誌使用。
CALL_TO_ACTION_SELECTION 連結素材資源，選取行動號召。
AD_IMAGE 素材資源已連結，可做為廣告圖片。
HOTEL_PROPERTY 素材資源已連結，可做為旅遊目標專用最高成效廣告活動中的飯店房源。
LONG_DESCRIPTION 素材資源已連結，可做為長說明使用。
CALL_TO_ACTION 素材資源已連結，可做為行動號召。

AssetGroupSignal

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

JSON 表示法 
{
  "resourceName": string,
  "assetGroup": string,

  // Union field signal can be only one of the following:
  "audience": {
    object (AudienceInfo)
  }
  // End of list of possible types for union field signal.
}
欄位
resourceName

string

素材資源群組信號的資源名稱。素材資源群組信號資源名稱的格式如下：

customers/{customerId}/assetGroupSignals/{asset_group_id}~{signal_id}
assetGroup

string

這個素材資源群組信號所屬的素材資源群組。
聯集欄位 signal。素材資源群組的信號。signal 只能是下列其中一項：
audience

object (AudienceInfo)

最高成效廣告活動要使用的目標對象信號。

AudienceInfo

目標對象條件。

JSON 表示法 
{
  "audience": string
}
欄位
audience

string

目標對象資源名稱。

AssetGroupListingGroupFilter

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

JSON 表示法 
{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "vertical": enum (ListingGroupFilterVertical),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}
欄位
resourceName

string

素材資源群組商家資訊群組篩選器的資源名稱。素材資源群組商家資訊群組篩選器資源名稱的格式如下：

customers/{customerId}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}
assetGroup

string

這個素材資源群組商家資訊群組篩選器所屬的素材資源群組。
id

string (int64 format)

ListingGroupFilter 的 ID。
type

enum (ListingGroupFilterType)

商家資訊群組篩選器節點的類型。
vertical

enum (ListingGroupFilterVertical)

垂直線代表目前的節點樹狀結構。同一棵樹狀結構中的所有節點都必須屬於同一個產業。
caseValue

object (ListingGroupFilterDimension)

商家資訊群組用來調整上層項目的維度值。根群組未定義。
parentListingGroupFilter

string

父項商品資訊群組細分的資源名稱。根商家資訊群組篩選節點為空值。
path

object (ListingGroupFilterDimensionPath)

定義這個商家資訊群組篩選條件的維度路徑。

ListingGroupFilterType

商家資訊群組篩選器的類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
SUBDIVISION 沿著某些產品資訊維度細分產品。
UNIT_INCLUDED 已納入的商家資訊群組篩選器葉節點。
UNIT_EXCLUDED 已排除的商家資訊群組篩選器葉節點。

ListingGroupFilterVertical

商家資訊群組篩選器產業類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
SHOPPING 代表購物垂直領域。垂直只適用於零售業專用最高成效廣告活動。

ListingGroupFilterDimension

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

JSON 表示法 
{

  // Union field dimension can be only one of the following:
  "productBiddingCategory": {
    object (ProductBiddingCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  }
  // End of list of possible types for union field dimension.
}
欄位
聯集欄位 dimension。系統一律會提供下列其中一種維度。dimension 只能是下列其中一項：
productBiddingCategory

object (ProductBiddingCategory)

產品優惠的出價類別。
productBrand

object (ProductBrand)

產品優惠的品牌。
productChannel

object (ProductChannel)

產品優惠的地區。
productCondition

object (ProductCondition)

產品供應項目的狀況。
productCustomAttribute

object (ProductCustomAttribute)

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

object (ProductItemId)

產品優惠的商品 ID。
productType

object (ProductType)

產品優惠類型。

ProductBiddingCategory

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

JSON 表示法 
{
  "level": enum (ListingGroupFilterBiddingCategoryLevel),
  "id": string
}
欄位
level

enum (ListingGroupFilterBiddingCategoryLevel)

指出分類中的類別層級。
id

string (int64 format)

產品出價類別的 ID。

這個 ID 等於本文所述的 google_product_category ID：https://support.google.com/merchants/answer/6324436

ListingGroupFilterBiddingCategoryLevel

商家資訊群組篩選器出價類別的層級。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
LEVEL1 第 1 級。
LEVEL2 第 2 級。
LEVEL3 第 3 級。
LEVEL4 第 4 級。
LEVEL5 第 5 級。

ProductBrand

產品品牌。

JSON 表示法 
{
  "value": string
}
欄位
value

string

產品品牌的字串值。

ProductChannel

產品優惠的地區。

JSON 表示法 
{
  "channel": enum (ListingGroupFilterProductChannel)
}
欄位
channel

enum (ListingGroupFilterProductChannel)

縣市的值。

ListingGroupFilterProductChannel

列舉，說明產品供應項目的地區。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
ONLINE 商品在線上販售。
LOCAL 商品在當地商店販售。

ProductCondition

產品供應項目的狀況。

JSON 表示法 
{
  "condition": enum (ListingGroupFilterProductCondition)
}
欄位
condition

enum (ListingGroupFilterProductCondition)

條件值。

ListingGroupFilterProductCondition

列舉，說明產品供應項目的狀況。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
NEW 產品狀況為新品。
REFURBISHED 產品狀況為整新品。
USED 產品狀況為二手。

ProductCustomAttribute

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

JSON 表示法 
{
  "index": enum (ListingGroupFilterCustomAttributeIndex),
  "value": string
}
欄位
index

enum (ListingGroupFilterCustomAttributeIndex)

指出自訂屬性的索引。
value

string

產品自訂屬性的字串值。

ListingGroupFilterCustomAttributeIndex

顧客屬性的索引。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
INDEX0 第一個商家資訊群組篩選器自訂屬性。
INDEX1 第二個商家資訊群組篩選器自訂屬性。
INDEX2 第三個商家資訊群組篩選器自訂屬性。
INDEX3 第四個商家資訊群組篩選器自訂屬性。
INDEX4 第五個商家資訊群組篩選器自訂屬性。

ProductItemId

產品優惠的商品 ID。

JSON 表示法 
{
  "value": string
}
欄位
value

string

ID 的值。

ProductType

產品優惠類型。

JSON 表示法 
{
  "level": enum (ListingGroupFilterProductTypeLevel),
  "value": string
}
欄位
level

enum (ListingGroupFilterProductTypeLevel)

類型層級。
value

string

類型的值。

ListingGroupFilterProductTypeLevel

列舉，說明產品供應項目類型的等級。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
LEVEL1 第 1 級。
LEVEL2 第 2 級。
LEVEL3 第 3 級。
LEVEL4 第 4 級。
LEVEL5 第 5 級。

ListingGroupFilterDimensionPath

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

JSON 表示法 
{
  "dimensions": [
    {
      object (ListingGroupFilterDimension)
    }
  ]
}
欄位
dimensions[]

object (ListingGroupFilterDimension)

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

AssetGroupTopCombinationView

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

JSON 表示法 
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
欄位
resourceName

string

素材資源群組最佳組合檢視畫面的資源名稱。AssetGroup Top Combination 檢視資源名稱的格式為：「customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}」
assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

一起放送的成效最佳素材資源組合。

AssetGroupAssetCombinationData

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

JSON 表示法 
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
欄位
assetCombinationServedAssets[]

object (AssetUsage)

已放送的素材資源。

AssetUsage

包含資產的使用資訊。

JSON 表示法 
{
  "asset": string,
  "servedAssetFieldType": enum (ServedAssetFieldType)
}
欄位
asset

string

資產的資源名稱。
servedAssetFieldType

enum (ServedAssetFieldType)

素材資源放送的欄位類型。

ServedAssetFieldType

可能的素材資源欄位類型。

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN

這個版本不支援收到的值。

這是僅供回應的值。
HEADLINE_1 素材資源用於標題 1。
HEADLINE_2 素材資源用於廣告標題 2。
HEADLINE_3 素材資源用於廣告標題 3。
DESCRIPTION_1 素材資源用於說明 1。
DESCRIPTION_2 素材資源用於說明 2。
HEADLINE 素材資源用於標題。只有在廣告中只有一個廣告標題時，才使用這項屬性。否則，請使用 HEADLINE_1、HEADLINE_2 或 HEADLINE_3 列舉
HEADLINE_IN_PORTRAIT 素材資源在直向圖片中做為廣告標題使用。
LONG_HEADLINE 素材資源用於長標題 (用於 MultiAssetResponsiveAd)。
DESCRIPTION 素材資源用於說明。只有在廣告中只有一項說明時，才使用這項功能。否則，請使用 DESCRIPTION_1 或 DESCRIPTION_@ 列舉
DESCRIPTION_IN_PORTRAIT 素材資源用做直向圖片的說明。
BUSINESS_NAME_IN_PORTRAIT 該素材資源用在直向圖片中的商家名稱。
BUSINESS_NAME 該素材資源用做商家名稱。
MARKETING_IMAGE 該素材資源曾做為行銷圖片。
MARKETING_IMAGE_IN_PORTRAIT 該素材資源已做為直向行銷圖片使用。
SQUARE_MARKETING_IMAGE 素材資源用做正方形行銷圖片。
PORTRAIT_MARKETING_IMAGE 素材資源已做為直向行銷圖片使用。
CALL_TO_ACTION 該素材資源用做行動號召。
YOU_TUBE_VIDEO 該資產曾做為 YouTube 影片使用。
CALL 這項素材資源會做為通話使用。
MOBILE_APP 這項資產用做行動應用程式。
CALLOUT 這項素材資源會做為摘要使用。
STRUCTURED_SNIPPET 這個素材資源會做為網站簡介使用。
PRICE 這項資產會做為價格使用。
PROMOTION 這項素材資源會做為促銷活動使用。
AD_IMAGE 這項素材資源會做為圖片使用。
LEAD_FORM 素材資源會做為待開發客戶表單。
DESCRIPTION_PREFIX 素材資源會做為說明前置字元。

AssetGroup

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

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "campaign": string,
  "name": string,
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "status": enum (AssetGroupStatus),
  "path1": string,
  "path2": string,
  "adStrength": enum (AdStrength)
}
欄位
resourceName

string

素材資源群組的資源名稱。素材資源群組資源名稱的格式如下：

customers/{customerId}/assetGroups/{asset_group_id}
id

string (int64 format)

素材資源群組的 ID。
campaign

string

與這個素材資源群組相關聯的廣告活動。連結至素材資源群組的素材資源。
name

string

必填。素材資源群組名稱。必填。長度不得少於 1 個字元，最多不得超過 128 個字元。廣告活動中的名稱不得重複。
finalUrls[]

string

所有跨網域重新導向後的最終到達網址清單。在最高成效廣告活動中，除非選擇停用，否則網址預設會擴展。
finalMobileUrls[]

string

所有跨網域重新導向後的最終行動網址清單。在最高成效廣告活動中，除非選擇停用，否則網址預設會擴展。
status

enum (AssetGroupStatus)

素材資源群組的狀態。
path1

string

文字的第一部分，可能會附加至廣告中顯示的網址。
path2

string

第二部分文字，可能會附加在廣告中顯示的網址。只有在設定 path1 時，才能設定這個欄位。
adStrength

enum (AdStrength)

這個素材資源群組的整體廣告優異度。

AssetGroupStatus

素材資源群組的可能狀態。

列舉
UNSPECIFIED 未指定狀態。
UNKNOWN 這個版本不支援收到的值。
ENABLED 素材資源群組已啟用。
PAUSED 素材資源群組已暫停。
REMOVED 系統會移除該素材資源群組。

AdStrength

列舉可能的廣告優異度。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
PENDING 廣告優異度目前尚待評估。
NO_ADS 無法生成廣告。
POOR 強度不佳。
AVERAGE 平均強度。
GOOD 肌力良好。
EXCELLENT 強度極佳。

AssetSetAsset

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

JSON 表示法 
{
  "resourceName": string,
  "assetSet": string,
  "asset": string,
  "status": enum (AssetSetAssetStatus)
}
欄位
resourceName

string

素材資源組合資產的資源名稱。素材資源組合素材資源名稱的格式如下：

customers/{customerId}/assetSetAssets/{asset_set_id}~{assetId}
assetSet

string

這個素材資源組合素材資源連結的素材資源組合。
asset

string

這個素材資源組合素材資源連結的素材資源。
status

enum (AssetSetAssetStatus)

素材資源組合素材資源的狀態。唯讀。

AssetSetAssetStatus

素材資源組合素材資源的可能狀態。

列舉
UNSPECIFIED 未指定狀態。
UNKNOWN 這個版本不支援收到的值。這是僅供回應的值。
ENABLED 素材資源組合素材資源已啟用。
REMOVED 移除素材資源組合素材資源。

AssetSet

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

JSON 表示法 
{
  "id": string,
  "resourceName": string
}
欄位
id

string (int64 format)

素材資源組合的 ID。
resourceName

string

素材資源組合的資源名稱。資產組合資源名稱的格式如下：

customers/{customerId}/assetSets/{asset_set_id}

BiddingStrategy

出價策略。

JSON 表示法 
{
  "resourceName": string,
  "status": enum (BiddingStrategyStatus),
  "type": enum (BiddingStrategyType),
  "currencyCode": string,
  "id": string,
  "name": string,
  "effectiveCurrencyCode": string,
  "campaignCount": string,
  "nonRemovedCampaignCount": string,

  // Union field scheme can be only one of the following:
  "enhancedCpc": {
    object (EnhancedCpc)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetOutrankShare": {
    object (TargetOutrankShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
欄位
resourceName

string

出價策略的資源名稱。出價策略資源名稱的格式如下：

customers/{customerId}/biddingStrategies/{biddingStrategyId}
status

enum (BiddingStrategyStatus)

出價策略的狀態。

這是唯讀欄位。
type

enum (BiddingStrategyType)

出價策略類型。設定出價方式，建立出價策略。

這是唯讀欄位。
currencyCode

string

出價策略使用的幣別 (ISO 4217 三個字母的代碼)。

如果是管理員客戶中的出價策略，則可在建立時設定幣別，預設為管理員客戶的幣別。對於放送廣告的客戶，這個欄位無法設定；放送廣告的客戶中，所有策略都會隱含使用放送廣告客戶的幣別。在所有情況下，effectiveCurrencyCode 欄位都會傳回策略使用的貨幣。
id

string (int64 format)

出價策略的 ID。
name

string

出價策略的名稱。帳戶中的所有出價策略都必須有不同的名稱。

這個字串的長度應介於 1 到 255 之間 (含首尾)，以 UTF-8 位元組為單位 (已修剪)。
effectiveCurrencyCode

string

出價策略使用的幣別 (ISO 4217 三個字母的代碼)。

如果是管理員客戶的出價策略，這是廣告主在建立策略時設定的幣別。如要為顧客提供服務，這是顧客的 currencyCode。

出價策略指標會以這個幣別回報。

這是唯讀欄位。
campaignCount

string (int64 format)

附加至這項出價策略的廣告活動數量。

這是唯讀欄位。
nonRemovedCampaignCount

string (int64 format)

附加至這項出價策略且未移除的廣告活動數量。

這是唯讀欄位。

聯集欄位 scheme。出價架構。

只能設定其中一個。scheme 只能是下列其中一項：
enhancedCpc

object (EnhancedCpc)

這項出價策略會針對較有可能促成轉換的點擊提高出價，並針對較不可能促成轉換的點擊降低出價。
maximizeConversionValue

object (MaximizeConversionValue)

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

object (MaximizeConversions)

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

object (TargetCpa)

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

object (TargetImpressionShare)

這項出價策略會根據您選擇的曝光百分比，自動進行最佳化調整。
targetOutrankShare

object (TargetOutrankShare)

這種出價策略會根據廣告主應在競價中勝過特定競爭對手的目標比例，設定出價。這個欄位已不適用；使用這個欄位建立新的出價策略，或將含有這個欄位的出價策略附加至廣告活動，都會失敗。允許變更已填入這項配置的策略。
targetRoas

object (TargetRoas)

這項出價策略可協助您盡量提高收益，同時平均達到指定的目標廣告投資報酬率。
targetSpend

object (TargetSpend)

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

BiddingStrategyStatus

出價策略的可能狀態。

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN

這個版本不支援收到的值。

這是僅供回應的值。
ENABLED 已啟用出價策略。
REMOVED 出價策略已移除。

BiddingStrategyType

列舉說明可能的出價策略類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
COMMISSION 佣金是自動出價策略，廣告主會支付轉換價值的一定比例。
ENHANCED_CPC 成本效益管理系統是一種出價策略，會針對較有可能促成轉換的點擊提高出價，若為較不能促成轉換的點擊，則調低出價。
INVALID 僅用於回傳值。表示廣告活動沒有出價策略。因此廣告活動無法放送。舉例來說，廣告活動可能已附加至管理員出價策略，但放送帳戶隨後與管理員帳戶取消連結。在這種情況下，廣告活動會自動與無法存取的經理出價策略分離，並改用「無效」出價策略類型。
MANUAL_CPA 手動出價策略，廣告主可為指定動作設定出價。
MANUAL_CPC 手動以點擊為準出價，使用者需為每次點擊付費。
MANUAL_CPM 手動曝光出價，使用者每千次曝光付費。
MANUAL_CPV 這項出價策略會針對每次影片觀看支付可設定的金額。
MAXIMIZE_CONVERSIONS 這項出價策略會根據每日預算，自動爭取最多轉換次數。
MAXIMIZE_CONVERSION_VALUE 這是一種自動出價策略，系統會自動設定出價，在預算範圍內盡量爭取最高收益。
PAGE_ONE_PROMOTED 「首頁宣傳」出價計畫，會設定最高單次點擊出價，爭取在 google.com 的首頁或首頁宣傳位置曝光。這個列舉值已淘汰。
PERCENT_CPC 單次點擊出價百分比是一種出價策略，出價金額是部分商品或服務廣告價格的一小部分。
TARGET_CPA 「目標單次動作出價」是一種自動出價策略，可按照您設定的目標單次動作出價盡量爭取轉換。
TARGET_CPM 「目標千次曝光出價」是一種自動出價策略，可按照您設定的目標千次曝光出價盡量爭取曝光。
TARGET_IMPRESSION_SHARE 這項自動出價策略會設定出價，確保一定比例的搜尋廣告顯示在第一頁頂端 (或其他指定位置)。
TARGET_OUTRANK_SHARE 「目標排名勝出率」是一種自動出價策略，會根據廣告主應勝過特定競爭對手的競價目標比例來設定出價。這個列舉值已淘汰。
TARGET_ROAS 「目標廣告投資報酬率」是一種自動出價策略，可協助您盡量提高收益，同時平均達到特定目標廣告投資報酬率。
TARGET_SPEND 「目標支出」是一種自動出價策略，能夠自動設定出價，在您的預算範圍內盡量爭取最多點擊。

EnhancedCpc

這個類型沒有任何欄位。

這項自動出價策略會針對較有可能促成轉換的點擊提高出價，並針對較不可能促成轉換的點擊降低出價。

這項出價策略已淘汰，無法再建立。如要使用相同功能，請將 enhancedCpcEnabled 設為 true，並使用 ManualCpc。

MaximizeConversionValue

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

JSON 表示法 
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetRoas": number
}
欄位
cpcBidCeilingMicros

string (int64 format)

出價策略可設定的最高出價上限。這項限制適用於策略管理的所有關鍵字。僅適用於組合出價策略。
cpcBidFloorMicros

string (int64 format)

出價策略可設定的出價下限。這項限制適用於策略管理的所有關鍵字。僅適用於組合出價策略。
targetRoas

number

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

MaximizeConversions

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

JSON 表示法 
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetCpaMicros": string
}
欄位
cpcBidCeilingMicros

string (int64 format)

出價策略可設定的最高出價上限。這項限制適用於策略管理的所有關鍵字。僅適用於組合出價策略。
cpcBidFloorMicros

string (int64 format)

出價策略可設定的出價下限。這項限制適用於策略管理的所有關鍵字。僅適用於組合出價策略。
targetCpaMicros

string (int64 format)

目標單次動作出價選項。這是指您願意為每個轉換動作支付的平均金額，以出價策略幣別的微單位表示。如果設定了目標單次動作出價，出價策略會以不超出目標單次動作出價為前提，盡量爭取轉換。如未設定目標單次動作出價，出價策略會盡量在預算內爭取最低單次動作出價。

TargetCpa

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

JSON 表示法 
{
  "targetCpaMicros": string,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
欄位
targetCpaMicros

string (int64 format)

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

string (int64 format)

出價策略可設定的最高出價上限。這項限制適用於策略管理的所有關鍵字。這項設定僅適用於組合出價策略。
cpcBidFloorMicros

string (int64 format)

出價策略可設定的出價下限。這項限制適用於策略管理的所有關鍵字。這項設定僅適用於組合出價策略。

TargetImpressionShare

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

JSON 表示法 
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
欄位
location

enum (TargetImpressionShareLocation)

搜尋結果網頁上的目標位置。
locationFractionMicros

string (int64 format)

以微秒為單位，指定廣告在目標地區放送的比例。舉例來說，1% 等於 10,000。
cpcBidCeilingMicros

string (int64 format)

自動出價系統可指定的最高單次點擊出價。這是廣告主輸入的必填欄位，用於設定上限，並在當地微觀區域中指定。

TargetImpressionShareLocation

列舉說明可能的目標。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
ANYWHERE_ON_PAGE 網頁上的任何位置。
TOP_OF_PAGE 廣告頂端方塊。
ABSOLUTE_TOP_OF_PAGE 廣告頂端方塊中的頂端版位。

TargetOutrankShare

這項智慧出價策略會根據目標競價比例設定出價，讓廣告主在競價中勝過特定競爭對手。這項策略已淘汰。

JSON 表示法 
{
  "cpcBidCeilingMicros": string
}
欄位
cpcBidCeilingMicros

string (Int64Value format)

出價策略可設定的最高出價上限。這項限制適用於策略管理的所有關鍵字。

TargetRoas

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

JSON 表示法 
{
  "targetRoas": number,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
欄位
targetRoas

number

必填。每單位支出的收益 (根據轉換資料)。值必須介於 0.01 至 1000.0 之間 (含)。
cpcBidCeilingMicros

string (int64 format)

出價策略可設定的最高出價上限。這項限制適用於策略管理的所有關鍵字。這項設定僅適用於組合出價策略。
cpcBidFloorMicros

string (int64 format)

出價策略可設定的出價下限。這項限制適用於策略管理的所有關鍵字。這項設定僅適用於組合出價策略。

TargetSpend

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

JSON 表示法 
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
欄位
targetSpendMicros
(deprecated)

string (int64 format)

已淘汰：盡量爭取點擊的支出目標。出價工具會盡量花費這個值或自然節流支出金額中較小的金額。如未指定，系統會將預算做為支出目標。這個欄位已淘汰，不應再使用。詳情請參閱 https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html。
cpcBidCeilingMicros

string (int64 format)

出價策略可設定的最高出價上限。這項限制適用於策略管理的所有關鍵字。

CampaignBudget

廣告活動預算。

JSON 表示法 
{
  "resourceName": string,
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "amountMicros": string
}
欄位
resourceName

string

廣告活動預算的資源名稱。廣告活動預算資源名稱的格式如下：

customers/{customerId}/campaignBudgets/{campaign_budget_id}
deliveryMethod

enum (BudgetDeliveryMethod)

放送方式會決定廣告活動預算的支出速度。

如果建立作業中未指定，則預設為 STANDARD。
period

enum (BudgetPeriod)

支出預算的時間範圍。如未指定，預設為 DAILY。
amountMicros

string (int64 format)

廣告活動每天平均支出的金額。如果 CampaignBudget period 設為預設值 DAILY，系統就會使用這個欄位。

金額是以帳戶當地幣別的百萬分之一為單位。一百萬微量單位等於一貨幣單位。有效每月支出上限為每日金額的 30.4 倍。

這個欄位與「totalAmountMicros」互斥。只能設定「amountMicros」或「totalAmountMicros」其中之一。

BudgetDeliveryMethod

預算可能的放送方式。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
STANDARD 預算伺服器會在整個時間範圍內平均節流放送。
ACCELERATED 預算伺服器不會限制放送，廣告會盡快放送。

BudgetPeriod

預算的可能週期。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
DAILY 每日預算：
FIXED_DAILY 固定每日預算。
CUSTOM_PERIOD 自訂預算可與 total_amount 搭配使用，指定生命週期預算上限。

廣告活動

廣告活動。

JSON 表示法 
{
  "resourceName": string,
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "effectiveLabels": [
    string
  ],
  "labels": [
    string
  ],
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "engineId": string,
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "createTime": string,
  "creationTime": string,
  "lastModifiedTime": string,
  "feedTypes": [
    enum (AssetSetType)
  ],
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "campaignBudget": string,
  "startDate": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "urlExpansionOptOut": boolean,

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  },
  "percentCpc": {
    object (PercentCpc)
  },
  "targetCpm": {
    object (TargetCpm)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
欄位
resourceName

string

廣告活動的資源名稱。廣告活動資源名稱的格式如下：

customers/{customerId}/campaigns/{campaignId}
status

enum (CampaignStatus)

廣告活動的狀態。

新增廣告活動時，狀態預設為「已啟用」。
servingStatus

enum (CampaignServingStatus)

廣告活動的廣告放送狀態。
biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

廣告活動出價策略的系統狀態。
adServingOptimizationStatus

enum (AdServingOptimizationStatus)

廣告活動的廣告放送最佳化狀態。
advertisingChannelType

enum (AdvertisingChannelType)

廣告活動中廣告的主要放送目標。您可以在 networkSettings 中調整指定目標選項。

建立新廣告活動時，這個欄位為必填，且不得為空白。

只能在建立廣告活動時設定。廣告活動建立完成後，就無法變更這個欄位。
advertisingChannelSubType

enum (AdvertisingChannelSubType)

(選用) 調整 advertisingChannelType。必須是上層管道類型的有效子類型。

只能在建立廣告活動時設定。廣告活動建立完成後，就無法變更這個欄位。
urlCustomParameters[]

object (CustomParameter)

用於取代 trackingUrlTemplate、finalUrls 或 mobile_final_urls 中自訂參數標記的對應清單。
realTimeBiddingSetting

object (RealTimeBiddingSetting)

即時出價設定，這項功能僅適用於指定 Ad Exchange 聯播網的廣告活動。
networkSettings

object (NetworkSettings)

廣告活動的聯播網設定。
dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

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

object (ShoppingSetting)

用來控管購物廣告活動的設定。
geoTargetTypeSetting

object (GeoTargetTypeSetting)

廣告地理區域指定目標設定。
effectiveLabels[]

string

附加至這個廣告活動的有效標籤資源名稱。有效標籤是指沿用或直接指派給這個廣告活動的標籤。
labels[]

string

附加至這個廣告活動的標籤資源名稱。
biddingStrategyType

enum (BiddingStrategyType)

出價策略類型。

您可以設定出價計畫來建立標準出價策略，也可以設定 biddingStrategy 欄位來建立組合出價策略。

這是唯讀欄位。
accessibleBiddingStrategy

string

AccessibleBiddingStrategy 的資源名稱，這是附加組合出價策略的不受限制屬性唯讀檢視畫面，由「biddingStrategy」識別。如果廣告活動未使用組合策略，則為空白。策略共用對象的所有客戶都能使用不受限制的策略屬性，並從 AccessibleBiddingStrategy 資源讀取這些屬性。相較之下，受限屬性僅供策略的擁有者客戶及其管理員使用。受限屬性只能從 BiddingStrategy 資源讀取。
frequencyCaps[]

object (FrequencyCapEntry)

這份名單會限制每位使用者看到此廣告活動廣告的頻率。
selectiveOptimization

object (SelectiveOptimization)

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

object (OptimizationGoalSetting)

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

object (TrackingSetting)

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

string

外部引擎帳戶中的廣告活動 ID。這個欄位僅適用於非 Google Ads 帳戶，例如 Yahoo Japan、Microsoft、百度等。如果是 Google Ads 實體，請改用「campaign.id」。
excludedParentAssetFieldTypes[]

enum (AssetFieldType)

應從這個廣告活動排除的素材資源欄位類型。廣告活動不會從上層繼承這些欄位類型的素材資源連結。
createTime

string

這個廣告活動的建立時間戳記。時間戳記採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss」。createTime 將在 v1 中淘汰。請改用 creationTime。
creationTime

string

這個廣告活動的建立時間戳記。時間戳記採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss」。
lastModifiedTime

string

上次修改這個廣告活動的日期時間。日期時間採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss.ssssss」。
feedTypes[]

enum (AssetSetType)

直接附加至這個廣告活動的動態饋給類型。
id

string (int64 format)

廣告活動的 ID。
name

string

廣告活動名稱。

建立新廣告活動時，這個欄位為必填，且不得為空白。

不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。
trackingUrlTemplate

string

用於建構追蹤網址的網址範本。
campaignBudget

string

廣告活動的廣告活動預算資源名稱。
startDate

string

廣告活動開始放送的日期，格式為 YYYY-MM-DD，時區為客戶時區。
endDate

string

廣告活動的最後一天，格式為 YYYY-MM-DD，以放送廣告的客戶時區為準。建立時預設為 2037 年 12 月 30 日，表示廣告活動會無限期放送。如要將現有廣告活動設為無限期放送，請將這個欄位設為 2037 年 12 月 30 日。
finalUrlSuffix

string

用於將查詢參數附加至以並行追蹤放送的到達網頁。
urlExpansionOptOut

boolean

代表選擇不將網址擴展至更精確的網址。如果選擇不擴展 (true)，系統只會指定素材資源群組中的最終到達網址，或是廣告主在 Google Merchant Center 或商家資料動態饋給中指定的網址。如果選擇不啟用 (false)，系統會指定整個網域。這個欄位只能為最高成效廣告活動設定，預設值為 false。

聯集欄位 campaign_bidding_strategy。廣告活動的出價策略。

必須是廣告組合 (透過 BiddingStrategy 服務建立) 或內嵌於廣告活動的標準出價策略。campaign_bidding_strategy 只能是下列其中一項：
biddingStrategy

string

廣告活動使用的組合出價策略資源名稱。
manualCpa

object (ManualCpa)

標準手動單次動作出價策略。手動出價策略，廣告主可為廣告主指定的動作設定出價。僅適用於在地生活服務廣告活動。
manualCpc

object (ManualCpc)

標準手動單次點擊出價策略。手動點擊出價，使用者需為每次點擊付費。
manualCpm

object (ManualCpm)

標準手動千次曝光出價策略。手動設定以曝光為準的出價，使用者每千次曝光就必須支付費用。
maximizeConversions

object (MaximizeConversions)

標準的「盡量爭取轉換」出價策略，可自動在預算範圍內爭取最多轉換次數。
maximizeConversionValue

object (MaximizeConversionValue)

標準「盡量提高轉換價值」出價策略，會自動設定出價，在預算範圍內盡量提高收益。
targetCpa

object (TargetCpa)

標準目標單次動作出價策略，會根據您設定的目標單次動作出價自動設定出價，盡可能爭取轉換。
targetImpressionShare

object (TargetImpressionShare)

目標曝光比重出價策略。這項自動出價策略會設定出價，以達到所選的曝光百分比。
targetRoas

object (TargetRoas)

標準目標廣告投資報酬率出價策略，會自動盡量提高收益，同時平均達到特定目標廣告投資報酬率。
targetSpend

object (TargetSpend)

標準的「目標支出」出價策略，會自動設定出價，在預算範圍內盡可能爭取最多點擊。
percentCpc

object (PercentCpc)

標準單次點擊出價百分比出價策略，出價為部分商品或服務廣告價格的一小部分。
targetCpm

object (TargetCpm)

這項出價策略會自動調整千次曝光出價。

CampaignStatus

廣告活動的可能狀態。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
ENABLED 廣告活動有效，可以放送廣告。
PAUSED 廣告活動已由使用者設為暫停。
REMOVED 廣告活動已移除。

CampaignServingStatus

廣告活動可能的放送狀態。

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN

這個版本不支援收到的值。

這是僅供回應的值。
SERVING 提供中。
NONE 無。
ENDED 已結束。
PENDING Pending.
SUSPENDED 已停權。

BiddingStrategySystemStatus

BiddingStrategy 可能的系統狀態。

列舉
UNSPECIFIED 表示發生未預期的錯誤，例如找不到出價策略類型或狀態資訊。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
ENABLED 這項出價策略正在運作，AdWords 沒有發現該策略有任何問題。
LEARNING_NEW 出價策略最近才剛建立或重新啟用，因此目前處於學習狀態。
LEARNING_SETTING_CHANGE 出價策略因近期設定變更而處於學習狀態。
LEARNING_BUDGET_CHANGE 由於預算近期經過變更，出價策略目前處於學習狀態。
LEARNING_COMPOSITION_CHANGE 由於與出價策略相關聯的廣告活動、廣告群組或關鍵字數量近期有變更，因此出價策略目前處於學習狀態。
LEARNING_CONVERSION_TYPE_CHANGE 出價策略取決於轉換報表，以及客戶最近修改的轉換類型 (與出價策略相關)。
LEARNING_CONVERSION_SETTING_CHANGE 出價策略取決於轉換報表，且客戶最近變更了轉換設定。
LIMITED_BY_CPC_BID_CEILING 出價策略受到出價上限限制。
LIMITED_BY_CPC_BID_FLOOR 出價底價使出價策略受到限制。
LIMITED_BY_DATA 過去幾週的轉換流量不足，因此出價策略受到限制。
LIMITED_BY_BUDGET 這項出價策略中，有很大一部分的關鍵字受到預算限制。
LIMITED_BY_LOW_PRIORITY_SPEND 出價策略的支出已遭降級，因此無法達到目標支出。
LIMITED_BY_LOW_QUALITY 這項出價策略中，有很大一部分關鍵字的品質分數偏低。
LIMITED_BY_INVENTORY 指定目標範圍過於狹窄，導致出價策略無法充分運用預算。
MISCONFIGURED_ZERO_ELIGIBILITY 智慧購物廣告活動缺少轉換追蹤 (沒有連線偵測) 和/或再行銷名單。
MISCONFIGURED_CONVERSION_TYPES 出價策略取決於轉換報表，但客戶缺少可根據這項策略回報的轉換類型。
MISCONFIGURED_CONVERSION_SETTINGS 出價策略取決於轉換報表，但客戶的轉換設定有誤。
MISCONFIGURED_SHARED_BUDGET 有廣告活動與策略中的廣告活動共用預算，但未納入出價策略。
MISCONFIGURED_STRATEGY_TYPE 廣告活動的策略類型無效，因此無法放送。
PAUSED 出價策略沒有發揮作用。出價策略沒有任何有效的廣告活動、廣告群組或關鍵字。或者出價策略未連結任何有效預算。
UNAVAILABLE 這項出價策略目前不支援狀態報表。
MULTIPLE_LEARNING 在這段期間，這項出價策略有多種 LEARNING_* 系統狀態。
MULTIPLE_LIMITED 在這段期間，這項出價策略有多種 LIMITED_* 系統狀態。
MULTIPLE_MISCONFIGURED 在這段期間，這項出價策略有多個 MISCONFIGURED_* 系統狀態。
MULTIPLE 這項出價策略在該段時間內有多種系統狀態。

AdServingOptimizationStatus

列舉說明可能的放送狀態。

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN

這個版本不支援收到的值。

這是僅供回應的值。
OPTIMIZE 系統會根據廣告活動的點閱率，盡量放送廣告。
CONVERSION_OPTIMIZE 系統會根據廣告活動的點閱率 * 轉換次數，盡量放送廣告。如果廣告活動未採用轉換最佳化工具出價策略，系統會預設為「最佳化」。
ROTATE 先平均輪播廣告 90 天，然後再將輪播設定改為「盡量爭取點擊」。
ROTATE_INDEFINITELY 平均放送成效較差的廣告，不進行最佳化。
UNAVAILABLE 無法查看廣告放送最佳化狀態。

AdvertisingChannelType

列舉說明各種廣告管道類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
SEARCH 搜尋聯播網。包括多媒體組合和搜尋廣告活動。
DISPLAY 僅限 Google 多媒體廣告聯播網。
SHOPPING 購物廣告活動會在購物資源和 google.com 搜尋結果中放送。
HOTEL 飯店廣告活動。
VIDEO 影片廣告活動。
MULTI_CHANNEL 應用程式廣告活動和參與式應用程式廣告活動，可在多個管道放送。
LOCAL 在地廣告活動。
SMART 智慧廣告活動。
PERFORMANCE_MAX 最高成效廣告活動。
LOCAL_SERVICES 在地生活服務廣告活動。
DISCOVERY 探索廣告活動。
TRAVEL 旅遊廣告活動。
SOCIAL 社群媒體廣告活動。

AdvertisingChannelSubType

列舉說明不同的管道子類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅做為回傳值。代表這個版本中的不明值。
SEARCH_MOBILE_APP 搜尋聯播網適用的行動應用程式廣告活動。
DISPLAY_MOBILE_APP 多媒體廣告聯播網的行動應用程式廣告活動。
SEARCH_EXPRESS 搜尋廣告的 AdWords Express 廣告活動。
DISPLAY_EXPRESS 多媒體廣告適用的 AdWords Express 廣告活動。
SHOPPING_SMART_ADS 智慧購物廣告活動。
DISPLAY_GMAIL_AD Gmail 廣告活動。
DISPLAY_SMART_CAMPAIGN 智慧型多媒體廣告活動：無法再新建這類廣告活動。
VIDEO_OUTSTREAM 串流外影片廣告活動。
VIDEO_ACTION 影片 TrueView 行動號召廣告活動。
VIDEO_NON_SKIPPABLE 採用不可略過影片廣告的影片廣告活動。
APP_CAMPAIGN 應用程式廣告活動可透過 Google 各項熱門資源 (包括 Google 搜尋、Google Play、YouTube 和 Google 多媒體廣告聯播網)，輕鬆宣傳 Android 或 iOS 應用程式。
APP_CAMPAIGN_FOR_ENGAGEMENT 參與式應用程式廣告活動：著重於透過 Google 各項熱門資源 (包括 Google 搜尋、YouTube 和 Google 多媒體廣告聯播網)，提高應用程式的再參與度。
LOCAL_CAMPAIGN 專為區域廣告設計的廣告活動。
SHOPPING_COMPARISON_LISTING_ADS 購物產品比較廣告活動。
SMART_CAMPAIGN 標準智慧廣告活動。
VIDEO_SEQUENCE 含有序列影片廣告的影片廣告活動。
APP_CAMPAIGN_FOR_PRE_REGISTRATION 應用程式預先註冊廣告活動專用於宣傳行動應用程式預先註冊，並在 Google Play、YouTube 和多媒體廣告聯播網等多個廣告管道中放送。
VIDEO_REACH_TARGET_FREQUENCY 採用「目標頻率」出價策略的影片觸及廣告活動。
TRAVEL_ACTIVITIES 旅遊活動廣告活動。
SOCIAL_FACEBOOK_TRACKING_ONLY 僅追蹤 Facebook 的社群媒體廣告活動。

RealTimeBiddingSetting

即時出價設定，這項功能僅適用於指定 Ad Exchange 聯播網的廣告活動。

JSON 表示法 
{
  "optIn": boolean
}
欄位
optIn

boolean

廣告活動是否已啟用即時出價。

NetworkSettings

廣告活動的聯播網設定。

JSON 表示法 
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean
}
欄位
targetSearchNetwork

boolean

廣告是否會在 Google 搜尋夥伴聯播網的網站上放送 (必須同時為 targetGoogleSearchtrue)。
targetContentNetwork

boolean

廣告是否會在 Google 多媒體廣告聯播網的指定刊登位置放送。刊登位置是使用刊登位置條件指定。
targetPartnerSearchNetwork

boolean

是否要在合作夥伴聯播網放送廣告。這項功能僅適用於部分合作夥伴帳戶。除非您已收到指示要使用這個欄位，否則您的帳戶可能不適用。這項設定不會控管廣告是否會在 Google 搜尋夥伴聯播網上放送，如要控管，請改用 targetSearchNetwork。

DynamicSearchAdsSetting

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

JSON 表示法 
{
  "domainName": string,
  "languageCode": string,
  "useSuppliedUrlsOnly": boolean
}
欄位
domainName

string

必填。這項設定代表的網際網路網域名稱，例如「google.com」或「www.google.com」。
languageCode

string

必填。指定網域語言的語言代碼，例如「en」。
useSuppliedUrlsOnly

boolean

廣告活動是否只使用廣告主提供的網址。

ShoppingSetting

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

JSON 表示法 
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "merchantId": string,
  "salesCountry": string,
  "campaignPriority": integer,
  "enableLocal": boolean
}
欄位
feedLabel

string

要納入廣告活動的產品動態饋給標籤。有效動態饋給標籤最多可包含 20 個字元，包括大寫字母、數字、連字號和底線。如果您先前在雙字母國家/地區代碼 (XX) 格式中使用已淘汰的 salesCountry，請改用 feedLabel 欄位。詳情請參閱動態饋給標籤說明文章。
useVehicleInventory

boolean

是否指定車輛資訊廣告空間。
merchantId

string (int64 format)

Merchant Center 帳戶 ID。建立作業時，必須填寫這個欄位。這個欄位無法變更購物廣告活動。
salesCountry

string

要納入廣告活動的產品銷售國家/地區。
campaignPriority

integer

廣告活動的優先順序。優先順序數值較高的廣告活動會優先放送，優先順序較低的廣告活動則會延後。購物廣告活動必須填寫這個欄位，值介於 0 到 2 之間 (含)。智慧購物廣告活動可選擇是否填寫這個欄位，但如果填寫，則必須等於 3。
enableLocal

boolean

是否納入店面產品。

GeoTargetTypeSetting

代表與廣告指定地理區域相關的一系列設定。

JSON 表示法 
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
欄位
positiveGeoTargetType

enum (PositiveGeoTargetType)

這個廣告活動中用於指定地理區域的設定。
negativeGeoTargetType

enum (NegativeGeoTargetType)

這個廣告活動使用的排除地理區域指定目標設定。

PositiveGeoTargetType

可能的指定地理區域類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 這個版本不含這個值。
PRESENCE_OR_INTEREST 指定使用者位於廣告主指定的地區，或對這些地區感興趣時，系統就會觸發廣告。
SEARCH_INTEREST 指定使用者搜尋廣告主指定的地區時，系統會觸發廣告。這項功能僅適用於搜尋和標準購物廣告活動。
PRESENCE 指定使用者位於或經常出現在廣告主指定的目標地區時，系統會觸發廣告。

NegativeGeoTargetType

可能的排除地理區域指定目標類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 這個版本不含這個值。
PRESENCE_OR_INTEREST 指定使用者位於或對廣告主排除的地區感興趣時，不顯示廣告。
PRESENCE 指定如果使用者位於廣告主排除的地區，就不會看到廣告。

FrequencyCapEntry

這個類型沒有任何欄位。

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

SelectiveOptimization

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

JSON 表示法 
{
  "conversionActions": [
    string
  ]
}
欄位
conversionActions[]

string

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

OptimizationGoalSetting

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

JSON 表示法 
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
欄位
optimizationGoalTypes[]

enum (OptimizationGoalType)

最佳化目標類型清單。

OptimizationGoalType

最佳化目標類型

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅做為回傳值。代表這個版本中的不明值。
CALL_CLICKS 針對來電點擊次數進行最佳化。來電點擊轉換次數是指使用者觀看廣告後，選取「通話」與商家聯絡的次數。
DRIVING_DIRECTIONS 針對規劃行車路線進行最佳化。駕駛路線轉換是指使用者在觀看廣告後，選取「取得路線」前往商家的次數。
APP_PRE_REGISTRATION 針對預先註冊進行最佳化。預先註冊轉換次數是指預先註冊人數，這些使用者會在應用程式發布時收到通知。

TrackingSetting

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

JSON 表示法 
{
  "trackingUrl": string
}
欄位
trackingUrl

string

用於動態追蹤的網址。

AssetSetType

素材資源組合的可能類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
PAGE_FEED 網頁素材資源組合。
DYNAMIC_EDUCATION 動態教育素材資源組合。
MERCHANT_CENTER_FEED Google Merchant Center 素材資源組合。
DYNAMIC_REAL_ESTATE 動態房地產素材資源組合。
DYNAMIC_CUSTOM 動態自訂素材資源組合。
DYNAMIC_HOTELS_AND_RENTALS 動態飯店和度假民宿素材資源組合。
DYNAMIC_FLIGHTS 動態航班素材資源組合。
DYNAMIC_TRAVEL 動態旅遊素材資源組合。
DYNAMIC_LOCAL 動態當地素材資源組合。
DYNAMIC_JOBS 動態職缺素材資源組合。
LOCATION_SYNC 已設定地點同步層級的素材資源組合。
BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP 商家檔案地區群組素材資源組合。
CHAIN_DYNAMIC_LOCATION_GROUP 連鎖店地區群組素材資源組合，可用於自有地點和經銷地點。
STATIC_LOCATION_GROUP 靜態地區群組素材資源組合，可用於自有地點和經銷地點。
HOTEL_PROPERTY 飯店房源素材資源組合，用於將飯店房源動態饋給連結至旅遊目標專用的最高成效廣告活動。
TRAVEL_FEED 旅遊動態饋給素材資源組合類型。可代表飯店動態饋給或觀光景點 (活動) 動態饋給。

ManualCpa

這個類型沒有任何欄位。

手動出價策略，廣告主可為指定動作設定出價。

ManualCpc

手動點擊出價，使用者需為每次點擊付費。

JSON 表示法 
{
  "enhancedCpcEnabled": boolean
}
欄位
enhancedCpcEnabled

boolean

是否要根據轉換最佳化工具資料提高出價。

ManualCpm

這個類型沒有任何欄位。

手動設定以曝光為準的出價，使用者每千次曝光就必須支付費用。

PercentCpc

出價策略：出價為部分商品或服務廣告價格的一小部分。

JSON 表示法 
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
欄位
cpcBidCeilingMicros

string (int64 format)

出價策略可設定的最高出價上限。這是廣告主輸入的選填欄位，並在當地微觀轉換中指定。注意：系統會將零值解讀為未定義 bid_ceiling。
enhancedCpcEnabled

boolean

根據促成轉換的可能性，在每次競價中調高或調低出價。個別出價可能會超過 cpcBidCeilingMicros，但廣告活動的平均出價金額不應超過。

TargetCpm

這個類型沒有任何欄位。

目標千次曝光出價是一種自動出價策略，會根據您設定的目標千次曝光出價，調整出價來盡量提升成效。

CampaignAsset

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

JSON 表示法 
{
  "resourceName": string,
  "status": enum (AssetLinkStatus),
  "campaign": string,
  "asset": string
}
欄位
resourceName

string

廣告活動資產的資源名稱。CampaignAsset 資源名稱的格式如下：

customers/{customerId}/campaignAssets/{campaignId}~{assetId}~{fieldType}
status

enum (AssetLinkStatus)

廣告活動素材資源的狀態。
campaign

string

素材資源連結的廣告活動。
asset

string

連結至廣告活動的素材資源。

CampaignAssetSet

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

JSON 表示法 
{
  "resourceName": string,
  "campaign": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
欄位
resourceName

string

廣告活動素材資源組合的資源名稱。素材資源組合素材資源名稱的格式如下：

customers/{customerId}/campaignAssetSets/{campaignId}~{asset_set_id}
campaign

string

與這個素材資源組合連結的廣告活動。
assetSet

string

已連結至廣告活動的素材資源組合。
status

enum (AssetSetLinkStatus)

廣告活動素材資源組合素材資源的狀態。唯讀。

CampaignAudienceView

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

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

廣告活動目標對象檢視畫面的資源名稱。廣告活動目標對象檢視畫面資源名稱的格式如下：

customers/{customerId}/campaignAudienceViews/{campaignId}~{criterionId}

CampaignCriterion

廣告活動條件。

JSON 表示法 
{
  "resourceName": string,
  "displayName": string,
  "type": enum (CriterionType),
  "status": enum (CampaignCriterionStatus),
  "lastModifiedTime": string,
  "criterionId": string,
  "bidModifier": number,
  "negative": boolean,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "device": {
    object (DeviceInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "language": {
    object (LanguageInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "locationGroup": {
    object (LocationGroupInfo)
  }
  // End of list of possible types for union field criterion.
}
欄位
resourceName

string

廣告活動條件的資源名稱。廣告活動條件資源名稱的格式如下：

customers/{customerId}/campaignCriteria/{campaignId}~{criterionId}
displayName

string

條件的顯示名稱。

如果是變動，系統會忽略這個欄位。
type

enum (CriterionType)

條件類型。
status

enum (CampaignCriterionStatus)

條件的狀態。
lastModifiedTime

string

上次修改這個廣告活動條件的時間。日期時間採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss.ssssss」。
criterionId

string (int64 format)

指定條件的 ID。

系統會在變動期間忽略這個欄位。
bidModifier

number

條件相符時的出價調節係數。修飾符必須介於 0.1 到 10.0 之間。大多數可指定條件類型都支援修飾符。使用 0 即可選擇不使用裝置類型。
negative

boolean

是否要指定 (false) 或排除 (true) 條件。

聯集欄位 criterion。廣告活動條件。

必須設定一個選項。criterion 只能是下列其中一項：
keyword

object (KeywordInfo)

關鍵字。
location

object (LocationInfo)

。
device

object (DeviceInfo)

裝置。
ageRange

object (AgeRangeInfo)

年齡層。
gender

object (GenderInfo)

性別。
userList

object (UserListInfo)

使用者清單。
language

object (LanguageInfo)

語言。
webpage

object (WebpageInfo)

網頁。
locationGroup

object (LocationGroupInfo)

地區群組

CampaignCriterionStatus

CampaignCriterion 的可能狀態。

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN

這個版本不支援收到的值。

這是僅供回應的值。
ENABLED 廣告活動條件已啟用。
PAUSED 廣告活動條件已暫停。
REMOVED 廣告活動條件已移除。

LanguageInfo

語言條件。

JSON 表示法 
{
  "languageConstant": string
}
欄位
languageConstant

string

語言常數資源名稱。

LocationGroupInfo

動態饋給中指定位置清單附近的半徑範圍。

JSON 表示法 
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "radius": string
}
欄位
geoTargetConstants[]

string

限制動態饋給中地理區域範圍的指定地理區域常數。目前只能使用一個地理位置目標常數。
radiusUnits

enum (LocationGroupRadiusUnits)

半徑單位。地理位置目標常數支援英里和公尺。動態饋給項目組合支援毫英里和公尺。這是必要欄位，必須在 CREATE 作業中設定。
feedItemSets[]

string

指定 FeedItem 的 FeedItemSets。如果指定多個 ID，則至少出現在一組 ID 中的所有項目都會成為指定目標。這個欄位無法與 geoTargetConstants 搭配使用。這是選用設定，只能在 CREATE 作業中設定。
radius

string (int64 format)

以指定單位表示目標地區附近的半徑範圍。這是必要欄位，必須在 CREATE 作業中設定。

LocationGroupRadiusUnits

地區群組的半徑距離單位 (例如英里)

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
METERS 公尺
MILES 英里
MILLI_MILES Milli Miles

CampaignEffectiveLabel

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

JSON 表示法 
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": string
}
欄位
resourceName

string

資源名稱。CampaignEffectiveLabel 資源名稱的格式為：customers/{ownerCustomerId}/campaignEffectiveLabels/{campaignId}~{label_id}
campaign

string

附加有效標籤的廣告活動。
label

string

指派給廣告活動的有效標籤。
ownerCustomerId

string (int64 format)

擁有有效標籤的客戶 ID。

CampaignLabel

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

JSON 表示法 
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": string
}
欄位
resourceName

string

資源名稱。廣告活動標籤資源名稱的格式為：customers/{ownerCustomerId}/campaignLabels/{campaignId}~{label_id}
campaign

string

附加標籤的廣告活動。
label

string

指派給廣告活動的標籤。
ownerCustomerId

string (int64 format)

擁有標籤的客戶 ID。

CartDataSalesView

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

如果導入「透過購物車資料回報的轉換」，系統會提供所購產品的相關資訊。對於在商品目錄動態饋給中定義，並透過 Google 廣告售出的產品，系統會提供收益、毛利、待開發客戶/交叉銷售指標等成效指標，以及品牌、類別等 Merchant Center 屬性。如要查看歸因於購物廣告點擊的購買交易，可以同時查看點擊和售出產品的維度。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

購物車資料銷售檢視區塊的資源名稱。購物車資料銷售檢視資源名稱的格式為：customers/{customerId}/cartDataSalesView

目標對象

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

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "description": string
}
欄位
resourceName

string

目標對象的資源名稱。目標對象名稱的格式如下：

customers/{customerId}/audiences/{audience_id}
id

string (int64 format)

目標對象 ID。
name

string

必填。目標對象名稱。所有目標對象的 ID 不得重複。長度至少須為 1 個字元，最多不得超過 255 個字元。
description

string

這組目標對象的說明。

ConversionAction

轉換動作。

JSON 表示法 
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "floodlightSettings": {
    object (FloodlightSettings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInClientAccountConversionsMetric": boolean,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "appId": string
}
欄位
resourceName

string

轉換動作的資源名稱。轉換動作資源名稱的格式如下：

customers/{customerId}/conversionActions/{conversionActionId}
creationTime

string

Floodlight 活動的建立時間戳記，格式為 ISO 8601。
status

enum (ConversionActionStatus)

這個轉換動作的轉換事件累積狀態。
type

enum (ConversionActionType)

這個轉換動作的類型。
category

enum (ConversionActionCategory)

這項轉換動作所記錄的轉換類別。
valueSettings

object (ValueSettings)

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

object (AttributionModelSettings)

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

object (FloodlightSettings)

Floodlight 轉換類型的 Floodlight 設定。
id

string (int64 format)

轉換動作的 ID。
name

string

轉換動作的名稱。

建立新的轉換動作時，這個欄位為必填，且不得為空白。
primaryForGoal

boolean

如果轉換動作的 primaryForGoal 位元為 false，則無論廣告活動的客戶轉換目標或廣告活動轉換目標為何，該轉換動作都無法用於所有廣告活動的出價。不過，自訂轉換目標不會遵守 primaryForGoal，因此如果廣告活動設定了自訂轉換目標，且轉換動作的 primaryForGoal = false，該轉換動作仍可出價。如未設定，預設值為 true。在 V9 中，由於 primaryForGoal 並未宣告為選用，因此只能在建立後透過「更新」作業設為 false。
ownerCustomer

string

轉換動作擁有者客戶的資源名稱，如果是系統定義的轉換動作，則為空值。
includeInClientAccountConversionsMetric

boolean

這個轉換動作是否應納入「clientAccountConversions」指標。
includeInConversionsMetric

boolean

這個轉換動作是否應納入「轉換」指標。
clickThroughLookbackWindowDays

string (int64 format)

互動 (例如點擊) 和轉換事件之間可能經過的最長天數。
appId

string

應用程式轉換動作的應用程式 ID。

ConversionActionStatus

轉換動作的可能狀態。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
ENABLED 系統會記錄轉換。
REMOVED 系統不會記錄轉換。
HIDDEN 系統不會記錄轉換，且轉換動作不會顯示在使用者介面中。

ConversionActionType

轉換動作的可能類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
AD_CALL 使用者點按廣告的電話號碼額外資訊時發生的轉換。
CLICK_TO_CALL 使用者在行動裝置上點選電話號碼時發生的轉換。
GOOGLE_PLAY_DOWNLOAD 使用者從 Google Play 商店下載行動應用程式時發生的轉換。
GOOGLE_PLAY_IN_APP_PURCHASE 使用者透過 Android 結帳服務在應用程式中購物時發生的轉換。
UPLOAD_CALLS 廣告主追蹤及上傳的通話轉換。
UPLOAD_CLICKS 廣告主追蹤並上傳的轉換，且已歸因於點擊。
WEBPAGE 網頁上發生的轉換。
WEBSITE_CALL 使用者從廣告主的網站撥打動態產生的電話號碼時發生的轉換。
STORE_SALES_DIRECT_UPLOAD 根據上傳的第一方或第三方商家資料，計算商店銷售轉換。只有在許可清單上的客戶，才能使用商店銷售直接上傳類型。
STORE_SALES 系統會根據商家上傳的第一方或第三方資料，以及/或是使用付款網路卡片進行的店內購物交易，計算商店銷售轉換。只有在許可清單上的顧客才能使用商店銷售類型。僅供檢視。
FIREBASE_ANDROID_FIRST_OPEN 透過 Firebase 追蹤 Android 應用程式初次開啟轉換。
FIREBASE_ANDROID_IN_APP_PURCHASE 透過 Firebase 追蹤 Android 應用程式的應用程式內購購物轉換。
FIREBASE_ANDROID_CUSTOM 透過 Firebase 追蹤的 Android 應用程式自訂轉換。
FIREBASE_IOS_FIRST_OPEN 透過 Firebase 追蹤的 iOS 應用程式初次開啟轉換。
FIREBASE_IOS_IN_APP_PURCHASE 透過 Firebase 追蹤 iOS 應用程式內購購物轉換。
FIREBASE_IOS_CUSTOM 透過 Firebase 追蹤的 iOS 應用程式自訂轉換。
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN 透過第三方應用程式數據分析追蹤 Android 應用程式的初次開啟轉換。
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE 透過第三方應用程式數據分析追蹤 Android 應用程式內購轉換。
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM 透過第三方應用程式數據分析追蹤的 Android 應用程式自訂轉換。
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN 透過第三方應用程式數據分析追蹤 iOS 應用程式初次開啟轉換。
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE 透過第三方應用程式數據分析追蹤的 iOS 應用程式內購購物轉換。
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM 透過第三方應用程式數據分析追蹤的 iOS 應用程式自訂轉換。
ANDROID_APP_PRE_REGISTRATION 使用者透過 Google Play 商店預先註冊行動應用程式時發生的轉換。僅供檢視。
ANDROID_INSTALLS_ALL_OTHER_APPS 追蹤所有 Google Play 下載次數，但應用程式專屬類型不會追蹤。僅供檢視。
FLOODLIGHT_ACTION 這類 Floodlight 活動會計算使用者在看到或點擊廣告主的任一廣告後，造訪特定網頁的次數。僅供檢視。
FLOODLIGHT_TRANSACTION 追蹤銷售次數或售出商品數量的 Floodlight 活動，也可擷取每筆銷售的總金額。僅供檢視。
GOOGLE_HOSTED 追蹤使用者與廣告互動後，在 Google 產品和服務中採取的本地動作轉換。僅供檢視。
LEAD_FORM_SUBMIT 使用者提交待開發客戶表單時，系統會記錄轉換。僅供檢視。
SALESFORCE

已淘汰：Salesforce 整合已於 2025 年 5 月 31 日停用。請參閱舊版 Salesforce 整合轉換升級常見問題。
SEARCH_ADS_360 從 Search Ads 360 Floodlight 資料匯入的轉換。僅供檢視。
SMART_CAMPAIGN_AD_CLICKS_TO_CALL 使用智慧廣告活動自訂條件，追蹤智慧廣告活動廣告中發生的通話轉換，不必設定通話追蹤。僅供檢視。
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL 使用者點選 Google 地圖中的通話元素。僅限智慧廣告活動。僅供檢視。
SMART_CAMPAIGN_MAP_DIRECTIONS 使用者在 Google 地圖中查詢前往商家所在地點的路線。僅限智慧廣告活動。僅供檢視。
SMART_CAMPAIGN_TRACKED_CALLS 使用智慧廣告活動自訂條件，追蹤在已設定通話追蹤的智慧廣告活動中發生的通話轉換。僅供檢視。
STORE_VISITS 使用者造訪廣告主零售商店時發生的轉換。僅供檢視。
WEBPAGE_CODELESS 從網站事件 (例如表單提交或網頁載入) 建立的轉換，且未使用個別編碼的事件程式碼片段。僅供檢視。
UNIVERSAL_ANALYTICS_GOAL 來自已連結通用 Analytics 目標的轉換。
UNIVERSAL_ANALYTICS_TRANSACTION 來自已連結通用 Analytics 交易的轉換。
GOOGLE_ANALYTICS_4_CUSTOM 來自已連結 Google Analytics 4 自訂事件轉換的轉換。
GOOGLE_ANALYTICS_4_PURCHASE 從已連結的 Google Analytics 4 購物轉換匯入的轉換。

ConversionActionCategory

與 ConversionAction 相關聯的轉換類別。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
DEFAULT 預設類別。
PAGE_VIEW 使用者造訪網頁。
PURCHASE 購買、銷售或「已下單」事件。
SIGNUP 註冊使用者動作。
LEAD 待開發客戶產生動作。
DOWNLOAD 軟體下載動作 (如應用程式)。
ADD_TO_CART 在廣告主網站上將商品加入購物車或購物袋。
BEGIN_CHECKOUT 有人在廣告主網站上進入結帳流程時。
SUBSCRIBE_PAID 產品或服務的付費訂閱開始時間。
PHONE_CALL_LEAD 撥打電話表示對廣告主提供的產品/服務感興趣。
IMPORTED_LEAD 從外部來源匯入 Google Ads 的待開發客戶轉換。
SUBMIT_LEAD_FORM 在廣告主網站上提交表單，表示對商家感興趣。
BOOK_APPOINTMENT 預約廣告主商家的服務。
REQUEST_QUOTE 要求報價或價格預估。
GET_DIRECTIONS 搜尋廣告主的商家所在地點，且有意願前往。
OUTBOUND_CLICK 點擊前往廣告主合作夥伴的網站。
CONTACT 透過電話、簡訊、電子郵件、即時通訊或其他方式與廣告主聯絡。
ENGAGEMENT 網站參與事件，例如網站停留時間較長或 Google Analytics 智慧目標。適用於 Google Analytics、Firebase、Google Analytics Gold 目標匯入。
STORE_VISIT 造訪實體商店。
STORE_SALE 實體商店的銷售交易。
QUALIFIED_LEAD 從外部來源匯入 Google Ads 的待開發客戶轉換，且已由廣告主 (行銷/銷售團隊) 進一步審核資格。在從開發客戶到銷售的過程中，廣告主會先取得待開發客戶，然後與消費者聯絡，進而採取行動。如果消費者感興趣，且最終可能會購買產品，廣告主就會將這類待開發客戶標示為「符合資格的待開發客戶」。
CONVERTED_LEAD 從外部來源匯入 Google Ads 的待開發客戶轉換，且已完成待開發客戶開發廣告主定義的指定階段。

ValueSettings

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

JSON 表示法 
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
欄位
defaultValue

number

當系統傳送這項轉換動作的轉換事件，但價值無效、不允許或遺漏時，或當這項轉換動作設為一律採用預設價值時，要使用的價值。
defaultCurrencyCode

string

如果傳送這個轉換動作的轉換事件時，貨幣代碼無效或遺漏，或是這個轉換動作設定為一律使用預設值，系統就會採用這個貨幣代碼。
alwaysUseDefaultValue

boolean

控制是否要使用預設值和預設幣別代碼，取代這個轉換動作的轉換事件中指定的價值和幣別代碼。

AttributionModelSettings

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

JSON 表示法 
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
欄位
attributionModel

enum (AttributionModel)

這個轉換動作的歸因模式類型。
dataDrivenModelStatus

enum (DataDrivenModelStatus)

轉換動作的以數據為準歸因模式狀態。

AttributionModel

歸因模式會說明如何將特定轉換的功勞分配給可能發生的多項先前互動。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
EXTERNAL 使用外部歸因模式。
GOOGLE_ADS_LAST_CLICK 將轉換完全歸功於使用者最終點擊。
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK 使用 Google 搜尋歸因，將轉換的所有功勞歸給最初點擊。
GOOGLE_SEARCH_ATTRIBUTION_LINEAR 使用 Google 搜尋歸因分析，將轉換功勞平均分配給所有點擊。
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY 使用 Google 搜尋歸因模式，根據點擊時間與轉換時間的間隔，以指數方式將轉換功勞歸給點擊 (半衰期為 1 週)。
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED 這種模式會將某次轉換的 40% 功勞歸因於最初和最終點擊。剩餘的 20% 則平均分配給所有其他點擊。這項功能會使用 Google 搜尋歸因。
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN 彈性模式，會使用機器學習技術，透過 Google 搜尋歸因判斷點擊間的適當功勞分配。

DataDrivenModelStatus

列舉以數據為準的模式狀態。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
AVAILABLE 以數據為準歸因模式可供使用。
STALE 以數據為準歸因模式已過時。至少 7 天未更新。目前仍在使用中，但如果 30 天內未更新，就會過期。
EXPIRED 以數據為準歸因模式已過期，該應用程式至少 30 天未更新，因此無法使用。最常見的原因是，最近 30 天內沒有足夠的事件數。
NEVER_GENERATED 系統從未生成以數據為準的模式。最常見的原因是任何 30 天期間內，都沒有達到所需事件數。

FloodlightSettings

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

JSON 表示法 
{
  "activityGroupTag": string,
  "activityTag": string,
  "activityId": string
}
欄位
activityGroupTag

string

用於在回報轉換時識別 Floodlight 活動群組的字串。
activityTag

string

用於在回報轉換時識別 Floodlight 活動的字串。
activityId

string (int64 format)

DoubleClick Campaign Manager (DCM) 中的 Floodlight 活動 ID。

ConversionCustomVariable

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

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "tag": string,
  "status": enum (ConversionCustomVariableStatus),
  "ownerCustomer": string,
  "family": enum (ConversionCustomVariableFamily),
  "cardinality": enum (ConversionCustomVariableCardinality),
  "floodlightConversionCustomVariableInfo": {
    object (FloodlightConversionCustomVariableInfo)
  },
  "customColumnIds": [
    string
  ]
}
欄位
resourceName

string

轉換自訂變數的資源名稱。轉換自訂變數資源名稱的格式如下：

customers/{customerId}/conversionCustomVariables/{conversion_custom_variable_id}
id

string (int64 format)

轉換自訂變數的 ID。
name

string

必填。轉換自訂變數的名稱。名稱不得重複。名稱長度上限為 100 個字元。前後不得有任何多餘空格。
tag

string

必填。轉換自訂變數的代碼。標記必須是獨一無二，且由「u」字元直接接續一個小於或等於 100 的數字組成。例如：「u4」。
status

enum (ConversionCustomVariableStatus)

轉換事件累積的轉換自訂變數狀態。
ownerCustomer

string

擁有轉換自訂變數的顧客資源名稱。
family

enum (ConversionCustomVariableFamily)

轉換自訂變數的系列。
cardinality

enum (ConversionCustomVariableCardinality)

轉換自訂變數的基數。
floodlightConversionCustomVariableInfo

object (FloodlightConversionCustomVariableInfo)

Search Ads 360 Floodlight 轉換自訂變數的欄位。
customColumnIds[]

string (int64 format)

使用這個轉換自訂變數的自訂欄 ID。

ConversionCustomVariableStatus

轉換自訂變數的可能狀態。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
ACTIVATION_NEEDED

轉換自訂變數待啟用，且必須設為「已啟用」，才會開始累積統計資料。

CREATE 和 UPDATE 要求無法使用這個狀態。
ENABLED 轉換自訂變數已啟用，並會累積統計資料。
PAUSED 轉換自訂變數已暫停，因此系統不會累計統計資料，直到您再次將其設為「已啟用」。

ConversionCustomVariableFamily

轉換自訂變數的系列。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
STANDARD 標準轉換自訂變數。顧客必須先啟用才能使用。
FLOODLIGHT 從 Floodlight 自訂變數匯入的轉換自訂變數。

ConversionCustomVariableCardinality

轉換自訂變數的基數。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
BELOW_ALL_LIMITS 轉換自訂變數的基數低於所有限制。變數可用於區隔，如果啟用變數，系統會累積新值統計資料。
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT 轉換自訂變數的基數超過區隔上限，但未超過統計資料上限。系統會停用區隔功能，但如果啟用變數，新值仍可累積統計資料。
APPROACHES_STATS_LIMIT 轉換自訂變數已超過區隔限制，且即將達到統計資料限制 (超過 90%)。系統會停用區隔功能，但如果啟用變數，新值仍可累積統計資料。
EXCEEDS_STATS_LIMIT 轉換自訂變數已超過區隔和統計資料限制。系統會停用區隔功能，且只有在現有值不會進一步增加變數基數的情況下，系統才會累積已啟用變數的統計資料。

FloodlightConversionCustomVariableInfo

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

JSON 表示法 
{
  "floodlightVariableType": enum (FloodlightVariableType),
  "floodlightVariableDataType": enum (FloodlightVariableDataType)
}
欄位
floodlightVariableType

enum (FloodlightVariableType)

在 Search Ads 360 中定義的 Floodlight 變數類型。
floodlightVariableDataType

enum (FloodlightVariableDataType)

在 Search Ads 360 中定義的 Floodlight 變數資料類型。

FloodlightVariableType

Floodlight 變數的類型，如 Search Ads 360 中所定義。詳情請參閱 https://support.google.com/searchads/answer/4397154?hl=en。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
DIMENSION 維度 Floodlight 變數類型。
METRIC 指標 Floodlight 變數類型。
UNSET 未設定 Floodlight 變數類型。

FloodlightVariableDataType

Floodlight 變數的資料類型，如 Search Ads 360 中所定義。詳情請參閱 https://support.google.com/searchads/answer/4397154?hl=en。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
NUMBER 代表「數字」類型的 Floodlight 變數。這個變數可以指派給維度或指標類型的 Floodlight 變數。
STRING 代表「字串」類型的 Floodlight 變數。這個變數可以指派給維度類型的 Floodlight 變數。

客戶

顧客。

JSON 表示法 
{
  "resourceName": string,
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "accountType": enum (AccountType),
  "doubleClickCampaignManagerSetting": {
    object (DoubleClickCampaignManagerSetting)
  },
  "accountStatus": enum (AccountStatus),
  "lastModifiedTime": string,
  "engineId": string,
  "status": enum (CustomerStatus),
  "creationTime": string,
  "managerId": string,
  "managerDescriptiveName": string,
  "subManagerId": string,
  "subManagerDescriptiveName": string,
  "associateManagerId": string,
  "associateManagerDescriptiveName": string,
  "accountLevel": enum (AccountLevelType),
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "manager": boolean
}
欄位
resourceName

string

客戶的資源名稱。客戶資源名稱的格式如下：

customers/{customerId}
conversionTrackingSetting

object (ConversionTrackingSetting)

客戶的轉換追蹤設定。
accountType

enum (AccountType)

引擎帳戶類型，例如 Google Ads、Microsoft Advertising、Yahoo Japan、百度、Facebook、引擎追蹤等。
doubleClickCampaignManagerSetting

object (DoubleClickCampaignManagerSetting)

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

enum (AccountStatus)

帳戶狀態，例如「已啟用」、「已暫停」、「已移除」等。
lastModifiedTime

string

這個顧客上次修改的日期時間。日期時間採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss.ssssss」。
engineId

string

外部引擎帳戶中的帳戶 ID。
status

enum (CustomerStatus)

顧客狀態。
creationTime

string

這個顧客的建立時間戳記。時間戳記採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss」。
managerId

string (int64 format)

管理員的客戶 ID。值為 0 表示客戶沒有 SA360 管理員。
managerDescriptiveName

string

管理員的描述性名稱。
subManagerId

string (int64 format)

副管理員的客戶 ID。值為 0 表示客戶沒有 SA360 副管理員。
subManagerDescriptiveName

string

副管理員的描述性名稱。
associateManagerId

string (int64 format)

助理管理員的客戶 ID。值為 0 表示客戶沒有 SA360 助理管理員。
associateManagerDescriptiveName

string

助理管理員的描述性名稱。
accountLevel

enum (AccountLevelType)

客戶的帳戶層級：管理員、副管理員、助理管理員、服務帳戶。
id

string (int64 format)

顧客 ID。
descriptiveName

string

選填，客戶的說明名稱 (可重複)。
currencyCode

string

帳戶使用的幣別。系統支援 ISO 4217 標準的部分貨幣代碼。
timeZone

string

顧客的當地時區 ID。
trackingUrlTemplate

string

網址範本，可根據參數建構追蹤網址。
finalUrlSuffix

string

用於將參數附加至最終到達網址的網址範本。
autoTaggingEnabled

boolean

是否為客戶啟用自動標記。
manager

boolean

顧客是否為管理員。

ConversionTrackingSetting

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

JSON 表示法 
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "googleAdsCrossAccountConversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
欄位
acceptedCustomerDataTerms

boolean

顧客是否已接受顧客數位資料條款。如果使用跨帳戶轉換追蹤，這個值會從管理員帳戶沿用。這是唯讀欄位。詳情請參閱 https://support.google.com/adspolicy/answer/7475709。
conversionTrackingStatus

enum (ConversionTrackingStatus)

轉換追蹤狀態。這項指標會指出顧客是否使用轉換追蹤，以及顧客的轉換追蹤擁有者。如果這位顧客使用跨帳戶轉換追蹤，系統傳回的值會因要求的 login-customer-id 而異。
enhancedConversionsForLeadsEnabled

boolean

顧客是否已啟用待開發客戶強化轉換功能。如果使用跨帳戶轉換追蹤，這個值會從管理員帳戶沿用。這是唯讀欄位。
googleAdsConversionCustomer

string

用來建立及管理轉換的客戶資源名稱。這是唯讀欄位。
conversionTrackingId

string (int64 format)

這個帳戶使用的轉換追蹤 ID。這個 ID 不會指出顧客是否使用轉換追蹤 (conversionTrackingStatus 會)。這是唯讀欄位。
googleAdsCrossAccountConversionTrackingId

string (int64 format)

客戶管理員的轉換追蹤 ID。如果顧客選擇啟用轉換追蹤，系統就會設定這個值，並覆寫 conversionTrackingId。這個欄位只能透過 Google Ads 使用者介面管理。這是唯讀欄位。
crossAccountConversionTrackingId

string (int64 format)

客戶管理員的轉換追蹤 ID。客戶採用跨帳戶轉換追蹤時，系統會設定這個值，並覆寫 conversionTrackingId。

ConversionTrackingStatus

客戶的轉換追蹤狀態。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
NOT_CONVERSION_TRACKED 客戶未使用任何轉換追蹤。
CONVERSION_TRACKING_MANAGED_BY_SELF 轉換動作是由這個客戶建立及管理。
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER 轉換動作是由要求 login-customer-id 中指定的管理員建立及管理。
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER 轉換動作是由與要求中指定的客戶或管理員不同的管理員建立及管理 login-customer-id。

AccountType

可能的引擎帳戶類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
BAIDU 百度帳戶。
ENGINE_TRACK 引擎追蹤帳戶。
FACEBOOK Facebook 帳戶。
FACEBOOK_GATEWAY 透過閘道管理的 Facebook 帳戶。
GOOGLE_ADS Google Ads 帳戶的成效，現在還來得及。
MICROSOFT Microsoft Advertising 帳戶。
SEARCH_ADS_360 Search Ads 360 管理員帳戶。
YAHOO_JAPAN Yahoo Japan 帳戶。

DoubleClickCampaignManagerSetting

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

JSON 表示法 
{
  "advertiserId": string,
  "networkId": string,
  "timeZone": string
}
欄位
advertiserId

string (int64 format)

與這個客戶相關聯的 Campaign Manager 廣告主 ID。
networkId

string (int64 format)

與這個客戶相關聯的 Campaign Manager 聯播網 ID。
timeZone

string

以 IANA 時區資料庫格式表示，與這個客戶相關聯的 Campaign Manager 聯播網時區，例如 America/New_York。

AccountStatus

帳戶可能出現的狀態。

列舉
UNSPECIFIED 預設值。
UNKNOWN 不明的值。
ENABLED 帳戶可以放送廣告。
PAUSED 帳戶已由使用者停用。
SUSPENDED 帳戶已透過內部程序停用。
REMOVED 帳戶已永久停用。
DRAFT 帳戶仍在設定中，尚未啟用。

CustomerStatus

顧客可能出現的狀態。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
ENABLED 表示帳戶有效，可放送廣告。
CANCELED 表示帳戶已取消，無法放送廣告。管理員使用者可以重新啟用。
SUSPENDED 表示帳戶已遭停權，無法放送廣告。只能由 Google 支援團隊啟用。
CLOSED 表示帳戶已關閉，無法放送廣告。測試帳戶也會顯示「已關閉」狀態。狀態為永久，可能無法重新開啟。

AccountLevelType

列舉說明可能的帳戶層級。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
CLIENT_ACCOUNT_FACEBOOK 客戶帳戶 (Facebook)
CLIENT_ACCOUNT_GOOGLE_ADS 客戶帳戶 (Google Ads)
CLIENT_ACCOUNT_MICROSOFT 客戶帳戶 (Microsoft)
CLIENT_ACCOUNT_YAHOO_JAPAN 客戶帳戶 (Yahoo Japan)
CLIENT_ACCOUNT_ENGINE_TRACK 客戶帳戶 (引擎追蹤)
MANAGER 最高層級管理員。
SUB_MANAGER 副管理員。
ASSOCIATE_MANAGER 助理管理員。

CustomerAsset

客戶與資產之間的連結。

JSON 表示法 
{
  "resourceName": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
欄位
resourceName

string

顧客資產的資源名稱。CustomerAsset 資源名稱的格式如下：

customers/{customerId}/customerAssets/{assetId}~{fieldType}
asset

string

必填。與客戶連結的資產。
status

enum (AssetLinkStatus)

顧客資產的狀態。

CustomerAssetSet

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

JSON 表示法 
{
  "resourceName": string,
  "assetSet": string,
  "customer": string,
  "status": enum (AssetSetLinkStatus)
}
欄位
resourceName

string

客戶素材資源組合的資源名稱。素材資源組合素材資源名稱的格式如下：

customers/{customerId}/customerAssetSets/{asset_set_id}
assetSet

string

連結至顧客的素材資源組合。
customer

string

素材資源組合連結的目標顧客。
status

enum (AssetSetLinkStatus)

客戶素材資源組合素材資源的狀態。唯讀。

AccessibleBiddingStrategy

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

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

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

  // Union field scheme can be only one of the following:
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
欄位
resourceName

string

可存取出價策略的資源名稱。AccessibleBiddingStrategy 資源名稱的格式如下：

customers/{customerId}/accessibleBiddingStrategies/{biddingStrategyId}
id

string (int64 format)

出價策略的 ID。
name

string

出價策略的名稱。
type

enum (BiddingStrategyType)

出價策略類型。
ownerCustomerId

string (int64 format)

擁有出價策略的客戶 ID。
ownerDescriptiveName

string

擁有出價策略的客戶 descriptiveName。

聯集欄位 scheme。出價架構。

只能設定其中一個。scheme 只能是下列其中一項：
maximizeConversionValue

object (MaximizeConversionValue)

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

object (MaximizeConversions)

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

object (TargetCpa)

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

object (TargetImpressionShare)

這項出價策略會根據您選擇的曝光百分比，自動進行最佳化調整。
targetRoas

object (TargetRoas)

這項出價策略可協助您盡量提高收益，同時平均達到指定的目標廣告投資報酬率。
targetSpend

object (TargetSpend)

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

MaximizeConversionValue

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

JSON 表示法 
{
  "targetRoas": number
}
欄位
targetRoas

number

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

MaximizeConversions

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

JSON 表示法 
{
  "targetCpa": string,
  "targetCpaMicros": string
}
欄位
targetCpa

string (int64 format)

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

string (int64 format)

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

TargetCpa

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

JSON 表示法 
{
  "targetCpaMicros": string
}
欄位
targetCpaMicros

string (int64 format)

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

TargetImpressionShare

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

JSON 表示法 
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
欄位
location

enum (TargetImpressionShareLocation)

搜尋結果網頁上的目標位置。
locationFractionMicros

string (int64 format)

以微秒為單位，指定廣告在目標地區放送的比例。舉例來說，1% 等於 10,000。
cpcBidCeilingMicros

string (int64 format)

自動出價系統可指定的最高單次點擊出價。這是廣告主輸入的必填欄位，用於設定上限，並在當地微觀區域中指定。

TargetRoas

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

JSON 表示法 
{
  "targetRoas": number
}
欄位
targetRoas

number

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

TargetSpend

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

JSON 表示法 
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
欄位
targetSpendMicros
(deprecated)

string (int64 format)

盡量爭取點擊的支出目標。出價工具會盡量花費這個值或自然節流支出金額中較小的金額。如未指定，系統會將預算做為支出目標。這個欄位已淘汰，不應再使用。詳情請參閱 https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html。
cpcBidCeilingMicros

string (int64 format)

出價策略可設定的最高出價上限。這項限制適用於策略管理的所有關鍵字。

ManagerLinkStatus

連結的可能狀態。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
ACTIVE 指出目前生效的關係
INACTIVE 表示關係已終止
PENDING 表示管理員已要求建立關係，但客戶尚未接受。
REFUSED 管理員已要求建立關係，但客戶拒絕了。
CANCELED 表示管理員已要求建立關係，但管理員取消了要求。

CustomerClient

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

JSON 表示法 
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
欄位
resourceName

string

客戶用戶端的資源名稱。CustomerClient 資源名稱的格式為：customers/{customerId}/customerClients/{client_customer_id}
appliedLabels[]

string

要求客戶擁有的標籤資源名稱，這些標籤會套用至用戶端客戶。標籤資源名稱的格式如下：

customers/{customerId}/labels/{label_id}
status

enum (CustomerStatus)

客戶的狀態。僅供檢視。
clientCustomer

string

連結至指定客戶的客戶客戶資源名稱。僅供檢視。
hidden

boolean

指出這是否為隱藏帳戶。

僅供檢視。
level

string (int64 format)

指定顧客與用戶端之間的距離。如果是自我連結，層級值為 0。僅供檢視。
timeZone

string

用戶端時區的通用區域資料庫 (CLDR) 字串表示法，例如 America/Los_Angeles。僅供檢視。
testAccount

boolean

指出用戶端是否為測試帳戶。僅供檢視。
manager

boolean

指出用戶端是否為管理員。僅供檢視。
descriptiveName

string

用戶端的描述性名稱。僅供檢視。
currencyCode

string

客戶的貨幣代碼 (例如「USD」、「EUR」)。僅供檢視。
id

string (int64 format)

客戶的 ID。僅供檢視。

DynamicSearchAdsSearchTermView

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

JSON 表示法 
{
  "resourceName": string,
  "landingPage": string
}
欄位
resourceName

string

動態搜尋廣告搜尋字詞檢視畫面的資源名稱。動態搜尋廣告搜尋字詞檢視畫面資源名稱的格式如下：

customers/{customerId}/dynamicSearchAdsSearchTermViews/{adGroupId}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}
landingPage

string

曝光的動態選取到達網頁網址。

這是唯讀欄位。

GenderView

性別檢視畫面資源。代表依性別彙整的顧客成效指標檢視畫面。所有統計資料都會在廣告群組層級匯總。

注意：您可以使用 ageRangeView 按年齡範圍區隔指標，或使用 genderView 按性別區隔指標，但 Search Ads 360 API 不支援在單一查詢中同時按年齡範圍和性別區隔指標。Search Ads 360 API 不支援分析這兩個維度的合併成效。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

性別檢視區的資源名稱。性別檢視畫面資源名稱的格式如下：

customers/{customerId}/genderViews/{adGroupId}~{criterionId}

GeoTargetConstant

指定地理區域常數。

JSON 表示法 
{
  "resourceName": string,
  "status": enum (GeoTargetConstantStatus),
  "id": string,
  "name": string,
  "countryCode": string,
  "targetType": string,
  "canonicalName": string,
  "parentGeoTarget": string
}
欄位
resourceName

string

地域目標常數的資源名稱。地域目標常數資源名稱的格式如下：

geoTargetConstants/{geo_target_constant_id}
status

enum (GeoTargetConstantStatus)

指定地理區域常數狀態。
id

string (int64 format)

指定地理區域常數的 ID。
name

string

指定地理區域常數的英文名稱。
countryCode

string

與目標相關的 ISO-3166-1 alpha-2 國家/地區代碼。
targetType

string

指定地理區域常數指定目標類型。
canonicalName

string

完整英文名稱，包含目標本身的名稱，以及父項和國家/地區的名稱。
parentGeoTarget

string

父項地域目標常數的資源名稱。地域目標常數資源名稱的格式如下：

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

地理區域常數的可能狀態。

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN

這個版本不支援收到的值。

這是僅供回應的值。
ENABLED 指定地理區域常數有效。
REMOVAL_PLANNED 地理區域目標常數已過時，將會移除。

KeywordView

關鍵字檢視畫面。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

關鍵字檢視畫面的資源名稱。關鍵字檢視畫面資源名稱的格式如下：

customers/{customerId}/keywordViews/{adGroupId}~{criterionId}

標籤

標籤。

JSON 表示法 
{
  "resourceName": string,
  "status": enum (LabelStatus),
  "textLabel": {
    object (TextLabel)
  },
  "id": string,
  "name": string
}
欄位
resourceName

string

資源名稱。標籤資源名稱的格式為：customers/{ownerCustomerId}/labels/{label_id}
status

enum (LabelStatus)

標籤狀態。僅供檢視。
textLabel

object (TextLabel)

這類標籤會在彩色背景上顯示文字。
id

string (int64 format)

標籤的 ID。僅供檢視。
name

string

標籤名稱。

建立新標籤時，這個欄位為必填，且不得為空白。

這個字串的長度應介於 1 到 80 個半形字元之間 (含首尾)。

LabelStatus

標籤的可能狀態。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
ENABLED 標籤已啟用。
REMOVED 標籤已移除。

TextLabel

這類標籤會在彩色背景上顯示文字。

JSON 表示法 
{
  "backgroundColor": string,
  "description": string
}
欄位
backgroundColor

string

標籤的背景顏色，格式為十六進位。這個字串必須符合規則運算式「^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$」。注意：管理員帳戶可能無法顯示背景顏色。
description

string

標籤的簡短說明。長度不得超過 200 個字元。

LanguageConstant

語言。

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
欄位
resourceName

string

語言常數的資源名稱。語言常數資源名稱的格式如下：

languageConstants/{criterionId}
id

string (int64 format)

語言常數的 ID。
code

string

語言代碼，例如「en_US」、「en_AU」、「es」、「fr」等。
name

string

語言的英文全名，例如「English (US)」、「Spanish」等。
targetable

boolean

語言是否可指定。

LocationView

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

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

位置檢視區塊的資源名稱。地點檢視畫面資源名稱的格式如下：

customers/{customerId}/locationViews/{campaignId}~{criterionId}

ProductBiddingCategoryConstant

產品出價類別。

JSON 表示法 
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
欄位
resourceName

string

產品出價類別的資源名稱。產品出價類別資源名稱的格式如下：

productBiddingCategoryConstants/{countryCode}~{level}~{id}
level

enum (ProductBiddingCategoryLevel)

產品出價類別的層級。
status

enum (ProductBiddingCategoryStatus)

產品出價類別的狀態。
id

string (int64 format)

產品出價類別的 ID。

這個 ID 等於本文所述的 google_product_category ID：https://support.google.com/merchants/answer/6324436。
countryCode

string

產品出價類別的雙字母大寫國家/地區代碼。
productBiddingCategoryConstantParent

string

父項產品出價類別的資源名稱。
languageCode

string

產品出價類別的語言代碼。
localizedName

string

顯示根據 languageCode 本地化的產品出價類別值。

ProductBiddingCategoryLevel

列舉，說明產品出價類別的層級。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
LEVEL1 第 1 級。
LEVEL2 第 2 級。
LEVEL3 第 3 級。
LEVEL4 第 4 級。
LEVEL5 第 5 級。

ProductBiddingCategoryStatus

列舉說明產品出價類別的狀態。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
ACTIVE 類別有效，可用於出價。
OBSOLETE 這個類別已過時。僅用於產生報表。

ProductGroupView

產品群組檢視畫面。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

產品群組檢視畫面的資源名稱。產品群組檢視畫面資源名稱的格式如下：

customers/{customerId}/productGroupViews/{adGroupId}~{criterionId}

ShoppingPerformanceView

購物成效檢視畫面。

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

shoppingPerformanceView 傳回的曝光次數和點擊次數統計資料，可能與廣告活動報表不同。shoppingPerformanceView 顯示廣告中產品的曝光次數和點擊次數，而廣告活動報表則顯示廣告本身的曝光次數和點擊次數。視格式而定，廣告可顯示零到多個產品，因此數字可能不相符。

在 Search Ads 360 使用者介面中，您可以在報表編輯器中選取「產品屬性」的欄，查詢廣告中顯示的產品曝光次數和點擊次數。舉例來說，選取「品牌」資料欄等同於選取 segments.product_brand。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

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

UserList

使用者清單。這是顧客可鎖定的使用者名單。使用者名單的專屬鍵包含下列欄位：id。請注意，除了 accessReason 設為 SHARED 的情況外，特定客戶擁有的使用者名單也必須有專屬的 name。違反專屬名稱限制會產生錯誤：UserListError.INVALID_NAME。

JSON 表示法 
{
  "resourceName": string,
  "type": enum (UserListType),
  "id": string,
  "name": string
}
欄位
resourceName

string

使用者名單的資源名稱。使用者名單資源名稱的格式如下：

customers/{customerId}/userLists/{userListId}
type

enum (UserListType)

這份清單的類型。

這是唯讀欄位。
id

string (int64 format)

使用者名單的 ID。
name

string

這份使用者名單的名稱。每個使用者名單的名稱都必須不重複，但如果使用者名單的名稱相同且accessReason設為SHARED，則不在此限。

UserListType

列舉，內含可能的使用者名單類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
REMARKETING 以轉換類型集合表示的 UserList。
LOGICAL 以其他使用者名單/興趣組合表示的使用者名單。
EXTERNAL_REMARKETING 在 Google Ad Manager 平台中建立的使用者名單。
RULE_BASED 與規則相關聯的 UserList。
SIMILAR 使用者名單，內含與其他使用者名單使用者類似的使用者。
CRM_BASED 廣告主以電子郵件或其他格式提供的第一方 CRM 資料使用者清單。

UserLocationView

使用者位置檢視畫面。

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

JSON 表示法 
{
  "resourceName": string,
  "countryCriterionId": string,
  "targetingLocation": boolean
}
欄位
resourceName

string

使用者位置資訊檢視區的資源名稱。UserLocation 檢視區塊資源名稱的格式如下：

customers/{customerId}/userLocationViews/{countryCriterionId}~{targetingLocation}
countryCriterionId

string (int64 format)

國家/地區的條件 ID。
targetingLocation

boolean

指出是否指定了地點。

WebpageView

網頁檢視畫面。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

網頁檢視的資源名稱。網頁檢視資源名稱的格式如下：

customers/{customerId}/webpageViews/{adGroupId}~{criterionId}

前往

一次造訪。

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitDateTime": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
欄位
resourceName

string

拜訪的資源名稱。造訪資源名稱的格式如下：

customers/{customerId}/visits/{adGroupId}~{criterionId}~{ds_visit_id}
id

string (int64 format)

造訪的 ID。
criterionId

string (int64 format)

Search Ads 360 關鍵字 ID。如果值為 0，表示關鍵字未歸因。
merchantId

string (int64 format)

包含遭點擊產品的 Search Ads 360 商品型錄帳戶 ID。在 Search Ads 360 中連結目錄帳戶時，Search Ads 360 會產生這組 ID。
adId

string (int64 format)

廣告 ID。值為 0 表示廣告未歸因。
clickId

string

每次造訪的專屬字串，會以點擊 ID 網址參數的形式傳遞至到達網頁。
visitDateTime

string

造訪事件的時間戳記。時間戳記採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss」。
productId

string

獲得點擊的產品 ID。
productChannel

enum (ProductChannel)

獲得點擊的產品銷售通路：線上或店面。
productLanguageCode

string

為內含產品相關資料的 Merchant Center 動態饋給設定的語言 (ISO-639-1)。
productStoreId

string

獲得點擊的店面商品目錄廣告中的商店。這組 ID 必須與店面產品動態饋給所使用的商店 ID 相符。
productCountryCode

string

為內含所點選產品的商品目錄動態饋給註冊的國家/地區 (ISO-3166 格式)。
assetId

string (int64 format)

在造訪事件期間互動的資產 ID。
assetFieldType

enum (AssetFieldType)

造訪事件的素材資源欄位類型。

ProductChannel

列舉，說明產品供應項目的地區。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
ONLINE 商品在線上販售。
LOCAL 商品在當地商店販售。

轉換

轉換。

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitId": string,
  "advertiserConversionId": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "attributionType": enum (AttributionType),
  "conversionDateTime": string,
  "conversionLastModifiedDateTime": string,
  "conversionVisitDateTime": string,
  "conversionQuantity": string,
  "conversionRevenueMicros": string,
  "floodlightOriginalRevenue": string,
  "floodlightOrderId": string,
  "status": enum (ConversionStatus),
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
欄位
resourceName

string

轉換的資源名稱。轉換資源名稱的格式如下：

customers/{customerId}/conversions/{adGroupId}~{criterionId}~{ds_conversion_id}
id

string (int64 format)

轉換的 ID
criterionId

string (int64 format)

Search Ads 360 條件 ID。值為 0 表示條件未歸因。
merchantId

string (int64 format)

包含遭點擊產品的 Search Ads 360 商品型錄帳戶 ID。在 Search Ads 360 中連結目錄帳戶時，Search Ads 360 會產生這組 ID。
adId

string (int64 format)

廣告 ID。值為 0 表示廣告未歸因。
clickId

string

系統會將轉換歸因於某次造訪，並將該次造訪的專屬字串以點擊 ID 網址參數的形式傳遞至到達網頁。
visitId

string (int64 format)

轉換歸因的 Search Ads 360 訪客 ID。
advertiserConversionId

string

如果是離線轉換，這是廣告主提供的 ID。如果廣告主未指定這類 ID，Search Ads 360 就會自動產生。如果是線上轉換，這會等於 id 欄或 floodlightOrderId 欄，視廣告主的 Floodlight 指示而定。
productId

string

獲得點擊的產品 ID。
productChannel

enum (ProductChannel)

獲得點擊的產品銷售通路：線上或店面。
productLanguageCode

string

為內含產品相關資料的 Merchant Center 動態饋給設定的語言 (ISO-639-1)。
productStoreId

string

獲得點擊的店面商品目錄廣告中的商店。這組 ID 必須與店面產品動態饋給所使用的商店 ID 相符。
productCountryCode

string

為內含獲得點擊產品的商品目錄動態饋給註冊的國家/地區 (ISO 3166 格式)。
attributionType

enum (AttributionType)

轉換歸因對象：造訪或關鍵字 + 廣告。
conversionDateTime

string

轉換事件的時間戳記。
conversionLastModifiedDateTime

string

上次修改轉換的時間戳記。
conversionVisitDateTime

string

轉換歸因的造訪時間戳記。
conversionQuantity

string (int64 format)

轉換記錄的商品數量，由 qty 網址參數決定。廣告主必須負責動態填入參數 (例如轉換中售出的商品數量)，否則系統會預設為 1。
conversionRevenueMicros

string (int64 format)

轉換事件的調整後收益 (以微元為單位)。這項費用一律會以放送帳戶的幣別計算。
floodlightOriginalRevenue

string (int64 format)

與 Floodlight 事件相關聯的原始收益 (以目前報表的貨幣為單位)，未經 Floodlight 貨幣指示修改。
floodlightOrderId

string

廣告主為轉換提供的 Floodlight 訂單 ID。
status

enum (ConversionStatus)

轉換的狀態，可為「ENABLED」或「REMOVED」。
assetId

string (int64 format)

轉換事件期間互動的資產 ID。
assetFieldType

enum (AssetFieldType)

轉換事件的素材資源欄位類型。

AttributionType

Search Ads 360 中的轉換歸因類型

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
VISIT 轉換歸因於造訪。
CRITERION_AD 轉換會歸因於一組條件和廣告。

ConversionStatus

轉換的可能狀態。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
ENABLED 已啟用轉換。
REMOVED 轉換已移除。

指標

指標資料。

JSON 表示法 
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionCustomMetrics": [
    {
      object (Value)
    }
  ],
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "rawEventConversionMetrics": [
    {
      object (Value)
    }
  ],
  "absoluteTopImpressionPercentage": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "visits": number,
  "allConversionsFromStoreWebsite": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpm": number,
  "clicks": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "clientAccountConversionsValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "clientAccountConversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsByConversionDate": number,
  "crossDeviceConversionsValue": number,
  "crossDeviceConversionsValueByConversionDate": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "averageQualityScore": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "generalInvalidClickRate": number,
  "generalInvalidClicks": string,
  "mobileFriendlyClicksPercentage": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "topImpressionPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "clientAccountViewThroughConversions": string,
  "orders": number,
  "averageOrderValueMicros": string,
  "averageCartSize": number,
  "costOfGoodsSoldMicros": string,
  "grossProfitMicros": string,
  "grossProfitMargin": number,
  "revenueMicros": string,
  "unitsSold": number,
  "clientAccountCrossSellCostOfGoodsSoldMicros": string,
  "crossSellCostOfGoodsSoldMicros": string,
  "clientAccountCrossSellGrossProfitMicros": string,
  "crossSellGrossProfitMicros": string,
  "clientAccountCrossSellRevenueMicros": string,
  "crossSellRevenueMicros": string,
  "clientAccountCrossSellUnitsSold": number,
  "crossSellUnitsSold": number,
  "clientAccountLeadCostOfGoodsSoldMicros": string,
  "leadCostOfGoodsSoldMicros": string,
  "clientAccountLeadGrossProfitMicros": string,
  "leadGrossProfitMicros": string,
  "clientAccountLeadRevenueMicros": string,
  "leadRevenueMicros": string,
  "clientAccountLeadUnitsSold": number,
  "leadUnitsSold": number,
  "uniqueUsers": string,
  "averageImpressionFrequencyPerUser": number
}
欄位
allConversionsValueByConversionDate

number

所有轉換的價值。如果選取這個資料欄和日期，日期資料欄中的值即為轉換日期。如要瞭解 by_conversion_date 欄的詳細資料，請參閱「關於『所有轉換』欄」。
allConversionsByConversionDate

number

轉換總次數。包括所有轉換，無論 includeInConversionsMetric 的值為何。如果選取這個資料欄和日期，日期資料欄中的值即為轉換日期。如要瞭解 by_conversion_date 欄的詳細資料，請參閱「關於『所有轉換』欄」。
conversionCustomMetrics[]

object (Value)

轉換自訂指標。
conversionsValueByConversionDate

number

可出價轉換的轉換價值總和 (依轉換日期)。如果選取這個資料欄和日期，日期資料欄中的值就是轉換日期。
conversionsByConversionDate

number

可出價轉換類型的轉換次數總和 (依轉換日期)。由於歸因模式，這項指標可能出現小數。如果同時選取這個資料欄和日期，日期資料欄中的值就是指轉換日期。
historicalCreativeQualityScore

enum (QualityScoreBucket)

廣告素材的歷來品質分數。
historicalLandingPageQualityScore

enum (QualityScoreBucket)

歷來到達網頁體驗的品質。
historicalSearchPredictedCtr

enum (QualityScoreBucket)

歷來搜尋預測點閱率。
interactionEventTypes[]

enum (InteractionEventType)

可付費和免費互動的類型。
rawEventConversionMetrics[]

object (Value)

原始事件轉換指標。
absoluteTopImpressionPercentage

number

「搜尋絕對頂端曝光比重」是指有多少百分比的搜尋廣告曝光位於最顯眼的搜尋廣告刊登位置。
allConversionsFromInteractionsRate

number

所有來自互動的轉換 (與瀏覽後轉換相對) 除以廣告互動次數。
allConversionsValue

number

所有轉換的價值。
allConversions

number

轉換總次數。包括所有轉換，無論 includeInConversionsMetric 的值為何。
allConversionsValuePerCost

number

所有轉換的價值除以廣告互動的總費用 (例如點擊文字廣告或觀看影片廣告)。
allConversionsFromClickToCall

number

使用者點按廣告當下或之後，點選「通話」按鈕致電給商家的次數。電話接通與否或通話持續時間等因素，不會納入計算。

這項指標僅適用於動態饋給項目。
allConversionsFromDirections

number

使用者點按廣告後，點選「取得路線」按鈕導航前往商家的次數。

這項指標僅適用於動態饋給項目。
allConversionsFromInteractionsValuePerInteraction

number

所有互動帶來的轉換價值除以互動總數。
allConversionsFromMenu

number

使用者點按廣告後，點選連結查看商家菜單的次數。

這項指標僅適用於動態饋給項目。
allConversionsFromOrder

number

使用者點擊廣告後向商家下單的次數。

這項指標僅適用於動態饋給項目。
allConversionsFromOtherEngagement

number

使用者點擊廣告後，發生其他轉換的次數 (例如：張貼評論或儲存商家地點)。

這項指標僅適用於動態饋給項目。
allConversionsFromStoreVisit

number

使用者點擊廣告後親臨商家的預估次數。

這項指標僅適用於動態饋給項目。
visits

number

Search Ads 360 成功記錄並轉送至廣告主到達網頁的點擊次數。
allConversionsFromStoreWebsite

number

使用者點按廣告後，前往商家網址的次數。

這項指標僅適用於動態饋給項目。
averageCost

number

您為每次互動支付的平均金額。計算方式是將廣告總費用除以互動總次數。
averageCpc

number

所有點擊的總費用除以獲得的點擊總次數。這項指標是金額價值，預設會以顧客的幣別傳回。請參閱「PARAMETERS」子句中的 metrics_currency 參數。
averageCpm

number

平均千次曝光出價。這項指標是金額價值，預設會以顧客的幣別傳回。請參閱「PARAMETERS」子句中的 metrics_currency 參數。
clicks

string (int64 format)

點擊次數。
contentBudgetLostImpressionShare

number

廣告符合在多媒體廣告聯播網上顯示的資格，但因為預算過低而未顯示的預估次數百分比。注意：內容預算錯失的曝光比重會回報在 0 到 0.9 的範圍內。任何大於 0.9 的值都會回報為 0.9001。
contentImpressionShare

number

將您在多媒體廣告聯播網上獲得的曝光次數，除以預估可獲得的曝光次數後所得出的百分比。

注意：內容曝光比重的報表範圍為 0.1 至 1。如果值低於 0.1，系統會回報為 0.0999。
contentRankLostImpressionShare

number

廣告因為廣告評級偏低，而錯失多媒體廣告聯播網曝光次數的預估百分比。

注意：內容排名錯失的曝光比重會回報在 0 到 0.9 的範圍內。任何大於 0.9 的值都會回報為 0.9001。
conversionsFromInteractionsRate

number

每個符合轉換資格的互動，平均可爭取到的轉換次數 (來自互動)。顯示廣告互動促成可出價轉換的平均頻率。
clientAccountConversionsValue

number

客戶帳戶轉換的價值。這項指標只會納入 includeInClientAccountConversionsMetric 屬性設為 true 的轉換動作。如果您使用以轉換為準出價，系統會調整出價策略來爭取這些轉換。
conversionsValuePerCost

number

可出價轉換的價值除以符合轉換資格的互動總費用。
conversionsFromInteractionsValuePerInteraction

number

互動促成的轉換價值除以廣告互動次數。這項指標只會納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用以轉換為準出價，系統會調整出價策略來爭取這些轉換。
clientAccountConversions

number

客戶帳戶轉換次數。這項指標只會納入 includeInClientAccountConversionsMetric 屬性設為 true 的轉換動作。如果您使用以轉換為準出價，系統會調整出價策略來爭取這些轉換。
costMicros

string (int64 format)

這段期間的單次點擊出價和千次曝光出價費用總和。這項指標是金額價值，預設會以顧客的幣別傳回。詳情請參閱參數子句中的 metrics_currency 參數。
costPerAllConversions

number

廣告互動費用除以所有轉換次數。
costPerConversion

number

平均單次轉換費用 (可出價轉換)。
costPerCurrentModelAttributedConversion

number

廣告互動費用除以目前模式歸因的轉換次數。這項指標只會納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用以轉換為準出價，系統會調整出價策略來爭取這些轉換。
crossDeviceConversions

number

顧客在某裝置上點按廣告，然後使用其他裝置或瀏覽器完成轉換。allConversions已納入跨裝置轉換。
crossDeviceConversionsByConversionDate

number

依轉換日期計算的跨裝置轉換次數。如要瞭解 by_conversion_date 欄的詳細資料，請參閱「關於『所有轉換』欄」一文。
crossDeviceConversionsValue

number

跨裝置轉換價值的總和。
crossDeviceConversionsValueByConversionDate

number

依轉換日期計算的跨裝置轉換價值總和。如要瞭解 by_conversion_date 欄的詳細資料，請參閱「關於『所有轉換』欄」一文。
ctr

number

廣告獲得的點擊次數 (點擊次數) 除以廣告顯示次數 (曝光次數)。
conversions

number

轉換次數。這項指標只會納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用以轉換為準出價，系統會調整出價策略來爭取這些轉換。
conversionsValue

number

「轉換」欄內所含轉換的價值總和。您為轉換動作輸入價值後，這項指標才能派上用場。
averageQualityScore

number

平均品質分數。
historicalQualityScore

string (int64 format)

歷來品質分數。
impressions

string (int64 format)

廣告顯示在搜尋結果網頁或 Google 聯播網網站上的次數。
interactionRate

number

使用者看到廣告後與廣告互動的頻率。計算方式為互動次數除以廣告顯示次數。
interactions

string (int64 format)

互動次數。「互動」是指與特定廣告格式相關聯的使用者主要動作，例如文字和購物廣告的「點擊」，以及影片廣告的「觀看」等。
invalidClickRate

number

報表統計期內，從點擊總數 (已篩除的點擊次數 + 未篩除的點擊次數) 中篩除的點擊次數百分比。
invalidClicks

string (int64 format)

Google 認為不合理的點擊次數，這類點擊不會向您收費。
generalInvalidClickRate

number

從點擊總數 (已篩除的點擊次數 + 未篩除的點擊次數) 中篩除一般無效點擊的百分比。這些點擊是經由例行篩除方式偵測到，且 Google 認為不符合規定的點擊，例如已知的無效資料中心流量、機器人和自動尋檢程式或其他檢索器、反常模式等。這類點擊不算廣告費，也不會影響您的帳戶統計資料。請參閱「篩選無效流量以確保品質」。
generalInvalidClicks

string (int64 format)

一般無效點擊次數。這些點擊是透過例行篩除方式偵測到的無效點擊，例如已知的無效資料中心流量、機器人和自動尋檢程式或其他檢索器、反常模式等。這類點擊不算廣告費，也不會影響您的帳戶統計資料。請參閱「篩選無效流量以確保品質」。
mobileFriendlyClicksPercentage

number

點擊行動廣告後連到的網頁中，經判定為「行動裝置友善」的網頁所佔的比例。
searchAbsoluteTopImpressionShare

number

有多少百分比的顧客購物或搜尋廣告曝光位於最顯眼的購物廣告刊登位置。詳情請參閱「頂端和絕對頂端指標簡介」。如果值低於 0.1，系統會回報為 0.0999。
searchBudgetLostAbsoluteTopImpressionShare

number

這項預估值表示廣告有多常因為預算偏低，無法成為搜尋結果中排序第一的頂端廣告。

注意：搜尋預算錯失的絕對頂端曝光比重會以 0 到 0.9 的範圍回報。任何大於 0.9 的值都會回報為 0.9001。
searchBudgetLostImpressionShare

number

廣告符合在搜尋聯播網上顯示的資格，但由於預算過低而未顯示的次數百分比 (估計值)。

注意：搜尋聯播網因預算而錯失的曝光比重會以 0 到 0.9 的範圍回報。任何大於 0.9 的值都會回報為 0.9001。
searchBudgetLostTopImpressionShare

number

這是指廣告因預算偏低，而無法在頂端自然搜尋結果旁顯示的次數百分比 (估計值)。

注意：搜尋聯播網錯失的頂端曝光比重 (預算) 的報表範圍為 0 到 0.9。任何大於 0.9 的值都會回報為 0.9001。
searchClickShare

number

將您在搜尋聯播網上獲得的點擊次數，除以預估可獲得的點擊次數後所得出的百分比。

注意：搜尋點擊比重的範圍為 0.1 到 1。如果值低於 0.1，系統會回報為 0.0999。
searchExactMatchImpressionShare

number

這是將廣告在搜尋聯播網上實際獲得的曝光次數，除以與您關鍵字完全相符或近似變體的搜尋字詞所帶來的預估廣告曝光次數後得出的百分比，與關鍵字比對類型無關。

注意：搜尋聯播網完全比對曝光比重會回報 0.1 到 1 之間的數值。如果值低於 0.1，系統會回報為 0.0999。
searchImpressionShare

number

這是將您在搜尋聯播網上獲得的曝光次數，除以預估可獲得的曝光次數後，所得到的百分比。

注意：搜尋曝光比重的範圍為 0.1 至 1。如果值低於 0.1，系統會回報為 0.0999。
searchRankLostAbsoluteTopImpressionShare

number

這項估算值代表廣告有多常因為廣告評級不佳，無法成為搜尋結果中排序第一的頂端廣告。

注意：搜尋排名錯失的絕對頂端曝光比重會以 0 到 0.9 的範圍回報。任何大於 0.9 的值都會回報為 0.9001。
searchRankLostImpressionShare

number

廣告因為廣告評級偏低，而無法在搜尋聯播網上獲得的預估曝光次數百分比。注意：搜尋排名錯失的曝光比重會以 0 到 0.9 的範圍回報。任何大於 0.9 的值都會回報為 0.9001。
searchRankLostTopImpressionShare

number

這項估算值表示廣告有多常因為廣告評級不佳，無法在頂端自然搜尋結果旁顯示。

注意：搜尋排名錯失的頂端曝光比重會以 0 到 0.9 的範圍回報。任何大於 0.9 的值都會回報為 0.9001。
searchTopImpressionShare

number

相較於廣告有資格獲得的頂端廣告曝光預估次數，廣告實際獲得的頂端廣告曝光次數。注意：搜尋聯播網頂端曝光比重的回報範圍為 0.1 到 1。如果值低於 0.1，系統會回報為 0.0999。

頂端廣告通常刊登在頂端自然搜尋結果上方，但視查詢而定，也可能出現在這類搜尋結果底下。
topImpressionPercentage

number

廣告曝光顯示於頂端自然搜尋結果旁的百分比。
valuePerAllConversions

number

所有轉換的價值除以所有轉換的次數。
valuePerAllConversionsByConversionDate

number

所有轉換的價值除以所有轉換的次數。如果選取這個資料欄和日期，日期資料欄中的值即為轉換日期。如要瞭解 by_conversion_date 欄的詳細資料，請參閱「關於『所有轉換』欄」。
valuePerConversion

number

可出價轉換價值除以可出價轉換次數。顯示每次可出價轉換的平均價值。
valuePerConversionsByConversionDate

number

以轉換日期為準的可出價轉換價值，除以以轉換日期為準的可出價轉換次數。顯示每個可出價轉換的平均價值 (依轉換日期)。如果選取這個資料欄和日期，日期資料欄中的值就是轉換日期。
clientAccountViewThroughConversions

string (int64 format)

瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告，但未與其他廣告互動 (例如點擊)，之後在您的網站上完成轉換，就會計為瀏覽後轉換。
orders

number

「訂單數」是指廣告為您帶來的購物轉換總數。

運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果轉換是歸給使用者先前與廣告的互動 (按下文字或購物廣告、觀看影片廣告等等)，就會計為一張訂單。

範例：使用者按下了帽子的購物廣告，隨後透過網站下單購買了同一款帽子和上衣。即使他們購買了 2 項產品，仍只會計為 1 張訂單。

您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
averageOrderValueMicros

string (int64 format)

「平均訂單價值」是指廣告促成每筆訂單帶來的平均收益。

運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。「平均訂單價值」是訂單總收益除以訂單總數所得的值。

範例：您收到 3 筆訂單，收益分別為 $10 美元、$15 美元和 $20 美元，平均訂單價值就是 $15 美元 = ($10 美元 + $15 美元 + $20 美元)/3。

您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
averageCartSize

number

「平均購物車內商品數量」是廣告所帶來每筆訂單中的平均產品數量。

運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。「平均購物車內商品數量」是售出的產品總數除以收到的訂單總數所得的值。

範例：你收到 2 筆訂單，第一筆有 3 項產品，第二筆有 2 項，購物車內平均商品數的計算方式為 (3+2)/2 = 2.5 項產品。

您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
costOfGoodsSoldMicros

string (int64 format)

「銷貨成本」(COGS) 是指廣告訂單中售出的產品所產生的總成本。

運作方式：你可以在 Merchant Center 中，為每項產品新增銷貨成本價值。如果您將透過購物車資料回報的轉換列入報表，系統便會比對售出的產品及相關銷貨成本價值，並根據這項資料計算每筆訂單產生的毛利。

例如：消費者點按帽子的購物廣告後，購買了同一款帽子和一件上衣。帽子的銷貨成本價值是 $3 美元，上衣則是 $5 美元。這筆訂單的銷貨成本計算方式為 $3 美元 + $5 美元 = $8 美元。

您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
grossProfitMicros

string (int64 format)

「毛利」是指扣除銷貨成本 (COGS) 後，廣告訂單所產生的利潤。

運作方式：毛利是指扣除銷貨成本後，廣告銷售所帶來的收益。計算毛利時，只會納入 Merchant Center 中具有銷貨成本價值的產品。

範例：使用者按下了帽子的購物廣告，隨後透過網站下單購買了同一款帽子和一件上衣。帽子的售價是 NT$300 元，上衣則是 NT$600 元。帽子的銷貨成本價值是 $3 美元，但上衣不具銷貨成本價值。計算這筆訂單的毛利時，只會將帽子列入考量，計算方式為 $10 美元 - $3 美元 = $7 美元。

您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
grossProfitMargin

number

「毛利率」是指在扣除銷貨成本 (COGS) 後，廣告訂單所產生的毛利百分比。

運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。「毛利率」是指產生的毛利除以總收益，再乘以 100% 所得出的值。計算毛利率時，只會納入 Merchant Center 中具有銷貨成本價值的產品。

範例：使用者透過網站下單購買了一頂帽子和一件上衣。帽子的售價是 NT$300 元，銷貨成本價值則是 NT$90 元。上衣的售價是 $20 美元，但不具銷貨成本價值。帽子有銷貨成本價值，因此計算這筆訂單的毛利率時，只會將帽子列入考量，計算方式為 ($10 美元 - $3 美元)/$10 美元 x 100% = 70%。

您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
revenueMicros

string (int64 format)

「收益」是指廣告訂單所賺取的總金額。

運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。「收益」是指扣除任何折扣後，廣告的所有訂單帶來的總價值。

範例：使用者按下了帽子的購物廣告，隨後透過網站下單購買了同一款帽子和一件上衣。帽子的售價是 $10 美元，上衣則是 $20 美元。整筆訂單提供 $5 美元的折扣。這筆訂單的收益計算方式為 ($10 美元 + $20 美元) - $5 美元 = $25 美元。

您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
unitsSold

number

「商品售出數量」是指因廣告而獲得的訂單中的售出產品總數。

運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。「商品售出數量」是指因廣告而獲得的所有訂單中的售出產品總數。

範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子、一件上衣和一件夾克。這筆訂單的商品售出數量為 3 個。

您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
clientAccountCrossSellCostOfGoodsSoldMicros

string (int64 format)

「客戶帳戶交叉銷售銷貨成本」(COGS) 是指因廣告宣傳某項產品而售出其他產品所產生的總成本。

運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符，就屬於交叉銷售。「交叉銷售銷貨成本」是指所售出非宣傳產品的總成本。

例如：消費者點按帽子的購物廣告後，購買了同一款帽子和一件上衣。帽子的銷貨成本價值是 $3 美元，上衣則是 $5 美元。這筆訂單的交叉銷售銷貨成本為 $5 美元。

您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。這項指標是金額價值，預設會以顧客的幣別傳回。請參閱「PARAMETERS」子句中的 metrics_currency 參數。
crossSellCostOfGoodsSoldMicros

string (int64 format)

「交叉銷售銷貨成本」(COGS) 是指因廣告宣傳某項產品而售出其他產品所產生的總成本。

運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符，就屬於交叉銷售。「交叉銷售銷貨成本」是指所售出非宣傳產品的總成本。

例如：消費者點按帽子的購物廣告後，購買了同一款帽子和一件上衣。帽子的銷貨成本價值是 $3 美元，上衣則是 $5 美元。這筆訂單的交叉銷售銷貨成本為 $5 美元。

您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。這項指標是金額價值，預設會以顧客的幣別傳回。請參閱「PARAMETERS」子句中的 metrics_currency 參數。
clientAccountCrossSellGrossProfitMicros

string (int64 format)

「客戶帳戶交叉銷售毛利」是指扣除銷貨成本後，因廣告宣傳某項產品而售出其他產品所產生的利潤。

運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。購買清單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符，就屬於交叉銷售。「交叉銷售毛利」是指扣除銷貨成本後，廣告中交叉銷售所帶來的收益。

例如：消費者點按帽子的購物廣告後，購買了同一款帽子和一件上衣。上衣的售價是 $20 美元，銷貨成本價值則是 $5 美元。這筆訂單的交叉銷售毛利計算方式為 $20 美元 - $5 美元 = $15 美元。

您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。這項指標是金額價值，預設會以顧客的幣別傳回。請參閱「PARAMETERS」子句中的 metrics_currency 參數。
crossSellGrossProfitMicros

string (int64 format)

「交叉銷售毛利」是指扣除銷貨成本 (COGS) 後，因廣告宣傳某項產品而售出其他產品所產生的利潤。

運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。購買清單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符，就屬於交叉銷售。「交叉銷售毛利」是指扣除銷貨成本後，廣告中交叉銷售所帶來的收益。

例如：消費者點按帽子的購物廣告後，購買了同一款帽子和一件上衣。上衣的售價是 $20 美元，銷貨成本價值則是 $5 美元。這筆訂單的交叉銷售毛利計算方式為 $20 美元 - $5 美元 = $15 美元。

您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。

這項指標是金額價值，預設會以顧客的幣別傳回。請參閱「PARAMETERS」子句中的 metrics_currency 參數。
clientAccountCrossSellRevenueMicros

string (int64 format)

「客戶帳戶交叉銷售收益」是指因為某產品廣告，連帶售出其他產品的總收益。

運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符，就屬於交叉銷售。「交叉銷售收益」是指廣告中交叉銷售所產生的總價值。

例如：消費者點按帽子的購物廣告後，購買了同一款帽子和一件上衣。帽子的售價是 $10 美元，上衣則是 $20 美元。這筆訂單的交叉銷售收益為 $20 美元。

您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。這項指標是金額價值，預設會以顧客的幣別傳回。請參閱「PARAMETERS」子句中的 metrics_currency 參數。
crossSellRevenueMicros

string (int64 format)

「交叉銷售收益」是指因廣告宣傳某項產品而售出其他產品所賺取的總金額。

運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符，就屬於交叉銷售。「交叉銷售收益」是指廣告中交叉銷售所產生的總價值。

例如：消費者點按帽子的購物廣告後，購買了同一款帽子和一件上衣。帽子的售價是 $10 美元，上衣則是 $20 美元。這筆訂單的交叉銷售收益為 $20 美元。

您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。這項指標是金額價值，預設會以顧客的幣別傳回。請參閱「PARAMETERS」子句中的 metrics_currency 參數。
clientAccountCrossSellUnitsSold

number

「客戶帳戶交叉銷售商品售出數量」是指因廣告宣傳某項產品而售出的其他產品總數。

運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符，就屬於交叉銷售。「交叉銷售商品售出數量」是指廣告的所有訂單帶來的交叉銷售產品總數。

範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子、一件上衣和一件夾克。這筆訂單的交叉銷售商品售出數量為 2。

您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
crossSellUnitsSold

number

「交叉銷售商品售出數量」是指因廣告宣傳某項產品而售出的其他產品總數。

運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符，就屬於交叉銷售。「交叉銷售商品售出數量」是指廣告的所有訂單帶來的交叉銷售產品總數。

範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子、一件上衣和一件夾克。這筆訂單的交叉銷售商品售出數量為 2。

您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
clientAccountLeadCostOfGoodsSoldMicros

string (int64 format)

「客戶帳戶廣告產品銷貨成本」(COGS) 是指因廣告宣傳產品而售出該產品的總成本。

運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果使用者互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符，這些商品的成本就會計入廣告產品銷貨成本。

例如：消費者點按帽子的購物廣告後，購買了同一款帽子和一件上衣。帽子的銷貨成本價值是 $3 美元，上衣則是 $5 美元。這筆訂單的廣告產品銷貨成本為 $3 美元。

您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。這項指標是金額價值，預設會以顧客的幣別傳回。請參閱「PARAMETERS」子句中的 metrics_currency 參數。
leadCostOfGoodsSoldMicros

string (int64 format)

「廣告產品銷貨成本」(COGS) 是指因廣告宣傳產品而售出該產品的總成本。

運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果使用者互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符，這些商品的成本就會計入廣告產品銷貨成本。

例如：消費者點按帽子的購物廣告後，購買了同一款帽子和一件上衣。帽子的銷貨成本價值是 $3 美元，上衣則是 $5 美元。這筆訂單的廣告產品銷貨成本為 $3 美元。

您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。這項指標是金額價值，預設會以顧客的幣別傳回。請參閱「PARAMETERS」子句中的 metrics_currency 參數。
clientAccountLeadGrossProfitMicros

string (int64 format)

「客戶帳戶廣告產品毛利」是指扣除銷貨成本後，因廣告宣傳產品而售出該產品所產生的利潤。

運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。消費者訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符，產生的銷售收益扣除銷貨成本就是廣告產品毛利。

例如：消費者點按帽子的購物廣告後，購買了同一款帽子和一件上衣。帽子的售價是 $10 美元，銷貨成本價值則是 $3 美元。這筆訂單的廣告產品毛利計算方式為 $10 美元 - $3 美元 = $7 美元。

您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。這項指標是金額價值，預設會以顧客的幣別傳回。請參閱「PARAMETERS」子句中的 metrics_currency 參數。
leadGrossProfitMicros

string (int64 format)

「廣告產品毛利」是指扣除銷貨成本 (COGS) 後，因廣告宣傳產品而售出該產品所產生的利潤。

運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。消費者訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符，產生的銷售收益扣除銷貨成本就是廣告產品毛利。

例如：消費者點按帽子的購物廣告後，購買了同一款帽子和一件上衣。帽子的售價是 $10 美元，銷貨成本價值則是 $3 美元。這筆訂單的廣告產品毛利計算方式為 $10 美元 - $3 美元 = $7 美元。

您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。這項指標是金額價值，預設會以顧客的幣別傳回。請參閱「PARAMETERS」子句中的 metrics_currency 參數。
clientAccountLeadRevenueMicros

string (int64 format)

「客戶帳戶廣告產品收益」是指因廣告宣傳產品而售出該產品所賺取的總金額。

運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符，廣告產品收益中就會顯示這些產品的銷售總價值。

例如：消費者點按帽子的購物廣告後，購買了同一款帽子和一件上衣。帽子的售價是 $10 美元，上衣則是 $20 美元。這筆訂單的廣告產品收益為 $10 美元。

您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。這項指標是金額價值，預設會以顧客的幣別傳回。請參閱「PARAMETERS」子句中的 metrics_currency 參數。
leadRevenueMicros

string (int64 format)

「廣告產品收益」是指因廣告宣傳產品而售出該產品所賺取的總金額。

運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符，廣告產品收益中就會顯示這些產品的銷售總價值。

例如：消費者點按帽子的購物廣告後，購買了同一款帽子和一件上衣。帽子的售價是 $10 美元，上衣則是 $20 美元。這筆訂單的廣告產品收益為 $10 美元。

您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。這項指標是金額價值，預設會以顧客的幣別傳回。請參閱「PARAMETERS」子句中的 metrics_currency 參數。
clientAccountLeadUnitsSold

number

客戶帳戶的廣告商品售出數量，是指因廣告宣傳相同產品而售出的產品總數。

運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。消費者訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符，廣告商品售出數量中就會顯示售出產品總數。

範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子、一件上衣和一件夾克。這筆訂單的廣告商品售出數量為 1。

您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
leadUnitsSold

number

「廣告商品售出數量」是指因廣告宣傳產品而售出的該產品總數。

運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。消費者訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符，廣告商品售出數量中就會顯示售出產品總數。

範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子、一件上衣和一件夾克。這筆訂單的廣告商品售出數量為 1。

您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。
uniqueUsers

string (int64 format)

在指定時間範圍內看過您廣告的不重複使用者人數。這項指標無法匯總，只能要求日期範圍在 92 天內的資料。這項指標適用於多媒體、影片、探索和應用程式廣告活動。
averageImpressionFrequencyPerUser

number

在要求的時間範圍內，不重複使用者看到您廣告的平均次數。這項指標無法匯總，只能要求日期範圍在 92 天內的資料。這項指標適用於多媒體、影片、探索和應用程式廣告活動。

值

一般資料容器。

JSON 表示法 
{

  // Union field value can be only one of the following:
  "booleanValue": boolean,
  "int64Value": string,
  "floatValue": number,
  "doubleValue": number,
  "stringValue": string
  // End of list of possible types for union field value.
}
欄位
聯集欄位 value。值。value 只能是下列其中一項：
booleanValue

boolean

布林值。
int64Value

string (int64 format)

int64。
floatValue

number

浮點數。
doubleValue

number

雙倍。
stringValue

string

字串。

QualityScoreBucket

列舉，列出可能的品質分數值區。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
BELOW_AVERAGE 廣告素材品質低於平均水準。
AVERAGE 廣告素材品質為平均水準。
ABOVE_AVERAGE 廣告素材品質高於平均水準。

InteractionEventType

列舉說明可付費和免費互動的可能類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
CLICK 按一下即可前往網站。在大多數情況下，這類互動會導向外部位置，通常是廣告主的到達網頁。這也是點擊事件的預設 InteractionEventType。
ENGAGEMENT 使用者明確表示想在原地與廣告互動。
VIDEO_VIEW 使用者觀看影片廣告。
NONE 廣告轉換事件的預設 InteractionEventType。如果廣告轉換資料列「未」指出應「宣傳」免費互動 (例如廣告轉換)，並將其列為核心指標的一部分，就會使用這項屬性。這些只是其他 (廣告) 轉換。

路段

僅限區隔欄位。

JSON 表示法 
{
  "adFormatType": enum (AdFormatType),
  "adNetworkType": enum (AdNetworkType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionCustomDimensions": [
    {
      object (Value)
    }
  ],
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "keyword": {
    object (Keyword)
  },
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "productSoldCondition": enum (ProductCondition),
  "rawEventConversionDimensions": [
    {
      object (Value)
    }
  ],
  "conversionAction": string,
  "conversionActionName": string,
  "date": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetMetro": string,
  "geoTargetPostalCode": string,
  "geoTargetRegion": string,
  "hour": integer,
  "month": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productItemId": string,
  "productLanguage": string,
  "productSoldBiddingCategoryLevel1": string,
  "productSoldBiddingCategoryLevel2": string,
  "productSoldBiddingCategoryLevel3": string,
  "productSoldBiddingCategoryLevel4": string,
  "productSoldBiddingCategoryLevel5": string,
  "productSoldBrand": string,
  "productSoldCustomAttribute0": string,
  "productSoldCustomAttribute1": string,
  "productSoldCustomAttribute2": string,
  "productSoldCustomAttribute3": string,
  "productSoldCustomAttribute4": string,
  "productSoldItemId": string,
  "productSoldTitle": string,
  "productSoldTypeL1": string,
  "productSoldTypeL2": string,
  "productSoldTypeL3": string,
  "productSoldTypeL4": string,
  "productSoldTypeL5": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "verticalAdsEventParticipantDisplayNames": string,
  "verticalAdsHotelClass": string,
  "verticalAdsListing": string,
  "verticalAdsListingBrand": string,
  "verticalAdsListingCity": string,
  "verticalAdsListingCountry": string,
  "verticalAdsListingRegion": string,
  "verticalAdsPartnerAccount": string,
  "verticalAdsVertical": enum (VerticalAdsItemVerticalType),
  "week": string,
  "year": integer,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
欄位
adFormatType

enum (AdFormatType)

廣告格式類型。
adNetworkType

enum (AdNetworkType)

廣告聯播網類型。
conversionActionCategory

enum (ConversionActionCategory)

轉換動作類別。
conversionCustomDimensions[]

object (Value)

轉換自訂維度。
dayOfWeek

enum (DayOfWeek)

星期幾，例如 MONDAY。
device

enum (Device)

指標適用的裝置。
keyword

object (Keyword)

關鍵字條件。
productChannel

enum (ProductChannel)

產品通路。
productChannelExclusivity

enum (ProductChannelExclusivity)

產品的通路獨佔性。
productCondition

enum (ProductCondition)

產品狀況。
productSoldCondition

enum (ProductCondition)

售出產品的狀況。
rawEventConversionDimensions[]

object (Value)

原始事件轉換維度。
conversionAction

string

轉換動作的資源名稱。
conversionActionName

string

轉換動作名稱。
date

string

指標適用的日期。格式為 yyyy-MM-dd，例如 2018-04-17。
geoTargetCity

string

代表城市的地理區域目標常數資源名稱。
geoTargetCountry

string

代表國家/地區的地域目標常數資源名稱。
geoTargetMetro

string

代表都會區的地理位置指定目標常數資源名稱。
geoTargetPostalCode

string

代表郵遞區號的地理位置目標常數資源名稱。
geoTargetRegion

string

代表區域的地理位置目標常數資源名稱。
hour

integer

一天中的小時數，介於 0 到 23 之間 (含 0 和 23)。
month

string

月份，以該月第一天的日期表示。格式為 yyyy-MM-dd。
productBiddingCategoryLevel1

string

產品的出價類別 (第 1 級)。
productBiddingCategoryLevel2

string

產品的出價類別 (第 2 層)。
productBiddingCategoryLevel3

string

產品的競價類別 (第 3 層)。
productBiddingCategoryLevel4

string

產品的競價類別 (第 4 層)。
productBiddingCategoryLevel5

string

產品的出價類別 (第 5 層)。
productBrand

string

產品品牌。
productCountry

string

產品銷售國家/地區的地理區域目標常數資源名稱。
productCustomAttribute0

string

產品的自訂屬性 0。
productCustomAttribute1

string

產品的自訂屬性 1。
productCustomAttribute2

string

產品的自訂屬性 2。
productCustomAttribute3

string

產品的自訂屬性 3。
productCustomAttribute4

string

產品的自訂屬性 4。
productItemId

string

產品的項目 ID。
productLanguage

string

產品語言的語言常數資源名稱。
productSoldBiddingCategoryLevel1

string

售出產品的出價類別 (第 1 層)。
productSoldBiddingCategoryLevel2

string

售出產品的出價類別 (第 2 層)。
productSoldBiddingCategoryLevel3

string

售出產品的競價類別 (第 3 層)。
productSoldBiddingCategoryLevel4

string

售出產品的出價類別 (第 4 層)。
productSoldBiddingCategoryLevel5

string

售出產品的出價類別 (第 5 層)。
productSoldBrand

string

售出產品的品牌。
productSoldCustomAttribute0

string

售出產品的自訂屬性 0。
productSoldCustomAttribute1

string

售出產品的自訂屬性 1。
productSoldCustomAttribute2

string

售出產品的自訂屬性 2。
productSoldCustomAttribute3

string

售出產品的自訂屬性 3。
productSoldCustomAttribute4

string

售出產品的自訂屬性 4。
productSoldItemId

string

售出產品的項目 ID。
productSoldTitle

string

售出產品的名稱。
productSoldTypeL1

string

售出產品的類型 (第 1 層)。
productSoldTypeL2

string

售出產品的類型 (第 2 層)。
productSoldTypeL3

string

售出產品的類型 (第 3 層)。
productSoldTypeL4

string

售出產品的類型 (第 4 層)。
productSoldTypeL5

string

售出產品的類型 (第 5 層)。
productStoreId

string

產品的商店 ID。
productTitle

string

產品的標題。
productTypeL1

string

產品類型 (第 1 層)。
productTypeL2

string

產品類型 (第 2 層)。
productTypeL3

string

產品類型 (第 3 層)。
productTypeL4

string

產品類型 (第 4 層)。
productTypeL5

string

產品類型 (第 5 層)。
quarter

string

以季的第一天日期表示季度。以日曆年為準，例如 2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。
verticalAdsEventParticipantDisplayNames

string

活動資訊中參與者的顯示名稱，例如表演者、講者或團隊。
verticalAdsHotelClass

string (int64 format)

飯店的類別，一般為 1 到 5 星，但可在飯店動態饋給中完全自訂。
verticalAdsListing

string

與刊登資訊曝光、點擊或轉換相關聯的刊登資訊。
verticalAdsListingBrand

string

與垂直廣告環境中特定商家資訊相關聯的品牌，例如汽車租賃、度假民宿或活動的品牌。
verticalAdsListingCity

string

直向廣告刊登所在城市。
verticalAdsListingCountry

string

直向廣告刊登所在的國家/地區。
verticalAdsListingRegion

string

直向廣告刊登的區域。
verticalAdsPartnerAccount

string (int64 format)

合作夥伴中心 (例如 Hotel Center) 內的特定合作夥伴帳戶，可提供垂直廣告的商品目錄動態饋給資料。
verticalAdsVertical

enum (VerticalAdsItemVerticalType)

產業廣告類型，例如度假民宿、租車或活動，用於在產業廣告的脈絡中分類及區隔資料。
week

string

週一到週日為一週，以週一的日期表示。格式為 yyyy-MM-dd。
year

integer

年份，格式為 yyyy。
assetInteractionTarget

object (AssetInteractionTarget)

僅適用於 CustomerAsset、CampaignAsset 和 AdGroupAsset 指標。指出互動指標是發生在素材資源本身，還是其他素材資源或廣告單元。如果廣告連同其他元件 (例如網站連結) 一起放送，系統會將所有部分的互動 (例如點擊) 納入計算。如果 interactionOnThisAsset 為 true，表示互動發生在這個特定素材資源上；如果 interactionOnThisAsset 為 false，表示互動發生在放送廣告的其他部分，而非這個特定素材資源。

AdFormatType

列舉 Google Ads 格式類型。

請注意，這項區隔僅適用於影片和需求開發廣告活動。素材資源僅支援影片素材資源。

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
VERTICAL_ADS_PROMOTION 這種廣告格式會在特定產業中宣傳特定實體，例如搜尋上的旅遊產業飯店廣告。
TEXT 標準文字廣告格式。目前僅適用於搜尋聯播網廣告。

AdNetworkType

列舉 Google Ads 聯播網類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 這個版本不含這個值。
SEARCH Google 搜尋。
SEARCH_PARTNERS 搜尋夥伴。
CONTENT 您廣告的位置
YOUTUBE_WATCH YouTube 影片
MIXED 跨聯播網。

關鍵字

關鍵字條件區隔。

JSON 表示法 
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
欄位
info

object (KeywordInfo)

關鍵字資訊。
adGroupCriterion

string

AdGroupCriterion 資源名稱。

ProductChannelExclusivity

列舉值，說明產品優惠的供應情形。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
SINGLE_CHANNEL 商品僅透過一個管道販售，即 ProductChannel 指出的實體商店或線上。
MULTI_CHANNEL 系統會將商品與線上或店面商店的對應商品配對，表示商品可透過 ShoppingProductChannels 購買。

ProductCondition

列舉，說明產品供應項目的狀況。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
OLD 產品狀況為舊品。
NEW 產品狀況為新品。
REFURBISHED 產品狀況為整新品。
USED 產品狀況為二手。

VerticalAdsItemVerticalType

列舉，說明 VERTICAL_ADS_ITEM_GROUP_RULE_LIST 類型 SharedSet 的直向廣告項目直向類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於回傳值。代表這個版本中的不明值。
HOTELS 飯店旅遊類別。
VACATION_RENTALS 度假民宿旅遊類別。
RENTAL_CARS 租車旅遊類別。
EVENTS 活動旅遊產業。
THINGS_TO_DO 旅遊垂直領域的觀光景點。
FLIGHTS 航班旅遊產業。

AssetInteractionTarget

AssetInteractionTarget 區隔。

JSON 表示法 
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
欄位
asset

string

素材資源名稱。
interactionOnThisAsset

boolean

僅適用於 CustomerAsset、CampaignAsset 和 AdGroupAsset 指標。指出互動指標是發生在素材資源本身，還是其他素材資源或廣告單元。