- JSON 表示法
- AccountBudget
- AccountBudgetStatus
- PendingAccountBudgetProposal
- AdGroupAdAssetCombinationView
- AssetUsage
- AdGroupAdAssetView
- AdGroupAdAssetPolicySummary
- AdGroupAudienceView
- AdGroupCriterionSimulation
- SimulationType
- SimulationModificationMethod
- CpcBidSimulationPointList
- CpcBidSimulationPoint
- PercentCpcBidSimulationPointList
- PercentCpcBidSimulationPoint
- AdGroupSimulation
- CpvBidSimulationPointList
- CpvBidSimulationPoint
- TargetCpaSimulationPointList
- TargetCpaSimulationPoint
- TargetRoasSimulationPointList
- TargetRoasSimulationPoint
- AgeRangeView
- AdScheduleView
- DomainCategory
- AssetFieldTypeView
- AssetGroupProductGroupView
- AssetGroupTopCombinationView
- AssetGroupAssetCombinationData
- AssetSetTypeView
- BiddingStrategySimulation
- CallView
- CallTrackingDisplayLocation
- CallType
- GoogleVoiceCallStatus
- CampaignAudienceView
- CampaignSearchTermInsight
- CampaignSimulation
- TargetImpressionShareSimulationPointList
- TargetImpressionShareSimulationPoint
- BudgetSimulationPointList
- BudgetSimulationPoint
- CarrierConstant
- ChangeEvent
- ChangeEventResourceType
- ChangeClientType
- ChangedResource
- ResourceChangeOperation
- ChangeStatus
- ChangeStatusResourceType
- ChangeStatusOperation
- CombinedAudience
- CombinedAudienceStatus
- ClickView
- ClickLocation
- CurrencyConstant
- AccessibleBiddingStrategy
- MaximizeConversionValue
- MaximizeConversions
- TargetCpa
- TargetImpressionShare
- TargetRoas
- TargetSpend
- CustomerClient
- CustomerSearchTermInsight
- DetailPlacementView
- PlacementType
- DetailedDemographic
- CriterionCategoryAvailability
- CriterionCategoryChannelAvailability
- CriterionCategoryChannelAvailabilityMode
- CriterionCategoryLocaleAvailability
- CriterionCategoryLocaleAvailabilityMode
- DisplayKeywordView
- DistanceView
- DistanceBucket
- DynamicSearchAdsSearchTermView
- ExpandedLandingPageView
- FeedPlaceholderView
- GenderView
- GeographicView
- GeoTargetingType
- GroupPlacementView
- HotelGroupView
- HotelPerformanceView
- HotelReconciliation
- HotelReconciliationStatus
- IncomeRangeView
- KeywordView
- LandingPageView
- LanguageConstant
- LocationView
- ManagedPlacementView
- MediaFile
- MediaType
- MediaImage
- MediaBundle
- MediaAudio
- MediaVideo
- LocalServicesEmployee
- LocalServicesEmployeeStatus
- LocalServicesEmployeeType
- UniversityDegree
- 落地
- 基金
- LocalServicesVerificationArtifact
- LocalServicesVerificationArtifactStatus
- LocalServicesVerificationArtifactType
- BackgroundCheckVerificationArtifact
- InsuranceVerificationArtifact
- LocalServicesInsuranceRejectionReason
- LocalServicesDocumentReadOnly
- LicenseVerificationArtifact
- LocalServicesLicenseRejectionReason
- BusinessRegistrationCheckVerificationArtifact
- LocalServicesBusinessRegistrationType
- LocalServicesBusinessRegistrationCheckRejectionReason
- BusinessRegistrationNumber
- BusinessRegistrationDocument
- MobileAppCategoryConstant
- MobileDeviceConstant
- MobileDeviceType
- OfflineConversionUploadClientSummary
- OfflineEventUploadClient
- OfflineConversionDiagnosticStatus
- OfflineConversionSummary
- OfflineConversionAlert
- OfflineConversionError
- CollectionSizeError
- ConversionAdjustmentUploadError
- ConversionUploadError
- DateError
- DistinctError
- FieldError
- MutateError
- NotAllowlistedError
- StringFormatError
- StringLengthError
- OperatingSystemVersionConstant
- OperatingSystemVersionOperatorType
- PaidOrganicSearchTermView
- QualifyingQuestion
- ParentalStatusView
- PerStoreView
- ProductCategoryConstant
- ProductCategoryState
- ProductCategoryLocalization
- ProductGroupView
- SearchTermView
- SearchTermTargetingStatus
- ShoppingPerformanceView
- SmartCampaignSearchTermView
- ThirdPartyAppAnalyticsLink
- TopicView
- TravelActivityGroupView
- TravelActivityPerformanceView
- UserInterest
- UserInterestTaxonomyType
- LifeEvent
- UserLocationView
- TopicConstant
- 影片
- WebpageView
- LeadFormSubmissionData
- LeadFormSubmissionField
- CustomLeadFormSubmissionField
- LocalServicesLead
- ContactDetails
- LeadType
- LeadStatus
- 注意:
- CreditDetails
- CreditState
- LocalServicesLeadConversation
- ConversationType
- ParticipantType
- PhoneCallDetails
- MessageDetails
- AndroidPrivacySharedKeyGoogleAdGroup
- AndroidPrivacyInteractionType
- AndroidPrivacyNetworkType
- AndroidPrivacySharedKeyGoogleCampaign
- AndroidPrivacySharedKeyGoogleNetworkType
- 指標
- InteractionEventType
- SearchVolumeRange
- 區隔
- AdDestinationType
- AdNetworkType
- BudgetCampaignAssociationStatus
- BudgetCampaignAssociationStatus
- ClickType
- ConversionAttributionEventType
- ConversionLagBucket
- ConversionOrAdjustmentLagBucket
- ExternalConversionSource
- HotelRateType
- HotelPriceBucket
- 關鍵字
- SearchEngineResultsPageType
- SearchTermMatchType
- 版位
- ConversionValueRulePrimaryDimension
- SkAdNetworkUserType
- SkAdNetworkAdEventType
- SkAdNetworkSourceApp
- SkAdNetworkAttributionCredit
- SkAdNetworkSourceType
- AssetInteractionTarget
- ConvertingUserPriorEngagementTypeAndLtvBucket
查詢傳回的資料列。
JSON 表示法 |
---|
{ "accountBudget": { object ( |
欄位 | |
---|---|
accountBudget |
查詢中的帳戶預算。 |
accountBudgetProposal |
查詢中參照的帳戶預算提案。 |
accountLink |
查詢中參照的 AccountLink。 |
adGroup |
查詢中參照的廣告群組。 |
adGroupAd |
查詢中參照的廣告。 |
adGroupAdAssetCombinationView |
查詢中的廣告群組廣告素材資源組合檢視畫面。 |
adGroupAdAssetView |
查詢中的廣告群組廣告素材資源檢視畫面。 |
adGroupAdLabel |
查詢中參照的廣告群組廣告標籤。 |
adGroupAsset |
查詢中參照的廣告群組素材資源。 |
adGroupAssetSet |
查詢中參照的廣告群組素材資源組合。 |
adGroupAudienceView |
查詢中參照的廣告群組目標對象資料檢視。 |
adGroupBidModifier |
查詢中參照的出價調節係數。 |
adGroupCriterion |
查詢中參照的條件。 |
adGroupCriterionCustomizer |
查詢中參照的廣告群組條件自訂參數。 |
adGroupCriterionLabel |
查詢中參照的廣告群組條件標籤。 |
adGroupCriterionSimulation |
查詢中參照的廣告群組條件模擬。 |
adGroupCustomizer |
查詢中參照的廣告群組自訂參數。 |
adGroupExtensionSetting |
查詢中參照的廣告群組額外資訊設定。 |
adGroupFeed |
查詢中參照的廣告群組動態饋給。 |
adGroupLabel |
查詢中參照的廣告群組標籤。 |
adGroupSimulation |
查詢中參照的廣告群組模擬。 |
adParameter |
查詢中參照的廣告參數。 |
ageRangeView |
查詢中參照的年齡層資料檢視。 |
adScheduleView |
查詢中參照的廣告時段資料檢視。 |
domainCategory |
查詢中參照的網域類別。 |
asset |
查詢中參照的資產。 |
assetFieldTypeView |
查詢中參照的資產欄位類型檢視畫面。 |
assetGroupAsset |
查詢中參照的素材資源群組素材資源。 |
assetGroupSignal |
查詢中參照的素材資源群組信號。 |
assetGroupListingGroupFilter |
查詢中參照的素材資源群組商家資訊群組篩選器。 |
assetGroupProductGroupView |
查詢中參照的素材資源群組產品群組檢視畫面。 |
assetGroupTopCombinationView |
查詢中參照的素材資源群組最佳組合資料檢視。 |
assetGroup |
查詢中參照的素材資源群組。 |
assetSetAsset |
查詢中參照的素材資源集素材資源。 |
assetSet |
查詢中參照的素材資源組合。 |
assetSetTypeView |
查詢中參照的素材資源集類型檢視畫面。 |
batchJob |
查詢中參照的批次工作。 |
biddingDataExclusion |
查詢中參照的出價資料排除。 |
biddingSeasonalityAdjustment |
查詢中參照的出價季節性調整。 |
biddingStrategy |
查詢中參照的出價策略。 |
biddingStrategySimulation |
查詢中參照的出價策略模擬。 |
billingSetup |
查詢中參照的帳單設定。 |
callView |
查詢中參照的呼叫檢視畫面。 |
campaignBudget |
查詢中參照的廣告活動預算。 |
campaign |
查詢中參照的廣告活動。 |
campaignAsset |
查詢中參照的廣告活動資產。 |
campaignAssetSet |
查詢中參照的廣告活動素材資源組合。 |
campaignAudienceView |
查詢中參照的廣告活動目標對象資料檢視。 |
campaignBidModifier |
查詢中參照的廣告活動出價調節係數。 |
campaignConversionGoal |
查詢中參照的 CampaignConversionGoal。 |
campaignCriterion |
查詢中參照的廣告活動條件。 |
campaignCustomizer |
查詢中參照的廣告活動自訂參數。 |
campaignDraft |
查詢中參照的廣告活動草稿。 |
campaignExtensionSetting |
查詢中參照的廣告活動額外資訊設定。 |
campaignFeed |
查詢中參照的廣告活動動態饋給。 |
campaignGroup |
AWQL 查詢中參照的廣告活動群組。 |
campaignLabel |
查詢中參照的廣告活動標籤。 |
campaignLifecycleGoal |
查詢中參照的廣告活動生命週期目標。 |
campaignSearchTermInsight |
查詢中參照的廣告活動搜尋字詞洞察。 |
campaignSharedSet |
AWQL 查詢中參照的廣告活動共用組合。 |
campaignSimulation |
查詢中參照的廣告活動模擬。 |
carrierConstant |
查詢中參照的電信業者常數。 |
changeEvent |
查詢中參照的 ChangeEvent。 |
changeStatus |
查詢中參照的 ChangeStatus。 |
combinedAudience |
查詢中參照的 MergedAudience。 |
audience |
查詢中參照的目標對象。 |
conversionAction |
查詢中參照的轉換動作。 |
conversionCustomVariable |
查詢中參照的轉換自訂變數。 |
conversionGoalCampaignConfig |
查詢中參照的 ConversionGoalCampaignConfig。 |
conversionValueRule |
查詢參照的轉換價值規則。 |
conversionValueRuleSet |
查詢中參照的轉換價值規則組合。 |
clickView |
查詢中參照的 ClickView。 |
currencyConstant |
查詢中參照的貨幣常數。 |
customAudience |
查詢中參照的 CustomAudience。 |
customConversionGoal |
查詢中參照的 CustomConversionGoal。 |
customInterest |
查詢中參照的 CustomInterest。 |
customer |
查詢中參照的客戶。 |
customerAsset |
查詢中參照的客戶素材資源。 |
customerAssetSet |
查詢中參照的客戶素材資源組合。 |
accessibleBiddingStrategy |
查詢中參照的可用出價策略。 |
customerCustomizer |
查詢中參照的客戶自訂參數。 |
customerManagerLink |
查詢中參照的 CustomerManagerLink。 |
customerClientLink |
查詢中參照的 CustomerClientLink。 |
customerClient |
查詢中參照的 CustomerClient。 |
customerConversionGoal |
查詢中參照的 CustomerConversionGoal。 |
customerExtensionSetting |
查詢中參照的客戶額外資訊設定。 |
customerFeed |
查詢中參照的顧客動態饋給。 |
customerLabel |
查詢中參照的客戶標籤。 |
customerLifecycleGoal |
查詢中參照的客戶生命週期目標。 |
customerNegativeCriterion |
查詢中參照的客戶排除條件。 |
customerSearchTermInsight |
查詢中參照的客戶搜尋字詞洞察。 |
customerUserAccess |
查詢中參照的 CustomerUserAccess。 |
customerUserAccessInvitation |
查詢中參照的客戶使用者存取邀請。 |
customizerAttribute |
查詢中參照的自訂參數屬性。 |
detailPlacementView |
查詢中參照的詳細資料刊登位置檢視畫面。 |
detailedDemographic |
查詢中參照的詳細客層。 |
displayKeywordView |
查詢中參照的多媒體廣告關鍵字資料檢視。 |
distanceView |
查詢中參照的距離檢視畫面。 |
dynamicSearchAdsSearchTermView |
查詢中參照的動態搜尋廣告搜尋字詞檢視畫面。 |
expandedLandingPageView |
查詢中參照的延展型到達網頁檢視畫面。 |
extensionFeedItem |
查詢中參照的擴充功能動態饋給項目。 |
feed |
查詢中參照的動態饋給。 |
feedItem |
查詢中參照的動態饋給項目。 |
feedItemSet |
查詢中參照的動態饋給項目集。 |
feedItemSetLink |
查詢中參照的動態饋給項目組合連結。 |
feedItemTarget |
查詢中參照的動態饋給項目目標。 |
feedMapping |
查詢中參照的動態饋給對應關係。 |
feedPlaceholderView |
查詢中參照的動態饋給預留位置檢視畫面。 |
genderView |
查詢中參照的性別檢視畫面。 |
geoTargetConstant |
查詢中參照的指定地理區域常數。 |
geographicView |
查詢中參照的地理區域檢視畫面。 |
groupPlacementView |
查詢中參照的群組刊登位置檢視畫面。 |
hotelGroupView |
查詢中參照的飯店群組檢視畫面。 |
hotelPerformanceView |
查詢中參照的飯店成效檢視畫面。 |
hotelReconciliation |
查詢中參照的飯店對帳列。 |
incomeRangeView |
查詢中參照的收入範圍檢視畫面。 |
keywordView |
查詢中參照的關鍵字檢視。 |
keywordPlan |
查詢中參照的關鍵字企劃書。 |
keywordPlanCampaign |
查詢中參照的關鍵字企劃書廣告活動。 |
keywordPlanCampaignKeyword |
查詢中參照的關鍵字企劃書廣告活動關鍵字。 |
keywordPlanAdGroup |
查詢中參照的關鍵字企劃書廣告群組。 |
keywordPlanAdGroupKeyword |
查詢中參照的關鍵字企劃書廣告群組。 |
keywordThemeConstant |
查詢中參照的關鍵字主題常數。 |
label |
查詢中參照的標籤。 |
landingPageView |
查詢中參照的到達網頁檢視畫面。 |
languageConstant |
查詢中參照的語言常數。 |
locationView |
查詢中參照的位置檢視畫面。 |
managedPlacementView |
查詢中參照的自選刊登位置資料檢視。 |
mediaFile |
查詢中參照的媒體檔案。 |
localServicesEmployee |
查詢中參照的「本機服務」員工。 |
localServicesVerificationArtifact |
查詢中參照的本機服務驗證成果。 |
mobileAppCategoryConstant |
查詢中參照的行動應用程式類別常數。 |
mobileDeviceConstant |
查詢中參照的行動裝置常數。 |
offlineConversionUploadClientSummary |
離線轉換上傳客戶摘要。 |
offlineUserDataJob |
查詢中參照的離線使用者資料工作。 |
operatingSystemVersionConstant |
查詢中參照的作業系統版本常數。 |
paidOrganicSearchTermView |
查詢中參照的付費隨機搜尋字詞檢視畫面。 |
qualifyingQuestion |
查詢中參照的資格問題。 |
parentalStatusView |
查詢中參照的家長狀態檢視畫面。 |
perStoreView |
查詢中參照的每項商店檢視畫面。 |
productCategoryConstant |
查詢中參照的產品類別。 |
productGroupView |
查詢中參照的產品群組檢視畫面。 |
productLink |
查詢中參照的產品連結。 |
productLinkInvitation |
查詢中的產品連結邀請。 |
recommendation |
查詢中參照的建議。 |
recommendationSubscription |
查詢中參照的建議訂閱項目。 |
searchTermView |
查詢中參照的搜尋字詞檢視畫面。 |
sharedCriterion |
查詢中參照的共用組合。 |
sharedSet |
查詢中參照的共用組合。 |
smartCampaignSetting |
查詢中參照的智慧廣告活動設定。 |
shoppingPerformanceView |
查詢中參照的購物成效資料檢視。 |
smartCampaignSearchTermView |
查詢中參照的智慧廣告活動搜尋字詞資料檢視。 |
thirdPartyAppAnalyticsLink |
查詢中參照的 AccountLink。 |
topicView |
查詢中參照的主題檢視表。 |
travelActivityGroupView |
查詢中參照的旅遊活動群組資料檢視。 |
travelActivityPerformanceView |
查詢中參照的旅遊活動成效資料檢視。 |
experiment |
查詢中參照的實驗。 |
experimentArm |
查詢中參照的實驗組。 |
userInterest |
查詢中參照的使用者興趣。 |
lifeEvent |
查詢中參照的人生大事。 |
userList |
查詢中參照的使用者名單。 |
userLocationView |
查詢中參照的使用者位置檢視畫面。 |
remarketingAction |
查詢中參照的再行銷動作。 |
topicConstant |
查詢中參照的主題常數。 |
video |
查詢中參照的影片。 |
webpageView |
查詢中參照的網頁檢視。 |
leadFormSubmissionData |
查詢中參照的待開發客戶表單使用者提交內容。 |
localServicesLead |
查詢中參照的在地生活服務主管。 |
localServicesLeadConversation |
根據查詢內容,在地生活服務引發的對話參照。 |
androidPrivacySharedKeyGoogleAdGroup |
查詢中參照的 Android 隱私權共用金鑰 Google 廣告群組。 |
androidPrivacySharedKeyGoogleCampaign |
查詢中參照的 Android 隱私權共用金鑰 Google 廣告活動。 |
androidPrivacySharedKeyGoogleNetworkType |
查詢中參照的 Android 隱私權共用金鑰 Google 網路類型。 |
metrics |
指標。 |
segments |
區隔。 |
AccountBudget
帳戶層級預算。其中包含預算本身的相關資訊,以及最近獲準對預算所做的變更,以及尚待審核的提案變更。「待審核提案」中會顯示待審核的提議變更 (如果有的話)。預算相關的有效詳細資料位於名為「approved_」、「adjusted_」且不含前置字元的欄位。某些有效的詳細資料可能與使用者原先要求的內容不同 (例如支出上限),系統會透過「proposed_」、「approved_」和「adjusted_」欄位將這些差異調整。
這項資源是透過 AccountBudgetProposal 變更,無法直接變更。預算無論何時最多只能有一個待處理的提案。正在等待待核准的提案。
獲準後,預算可能會受到調整 (例如抵免額調整項)。調整項會在「已核准」和「已調整」欄位之間建立差異,否則這些欄位會完全相同。
JSON 表示法 |
---|
{ "resourceName": string, "status": enum ( |
欄位 | |
---|---|
resourceName |
僅供輸出。帳戶層級預算的資源名稱。AccountBudget 資源名稱的格式如下:
|
status |
僅供輸出。這項帳戶層級預算的狀態。 |
totalAdjustmentsMicros |
僅供輸出。調整項總金額。 例如贈送抵免額。 |
amountServedMicros |
僅供輸出。已放送廣告的價值 (以百萬分之一為單位)。 這也包括超量放送費用,在此情況下,系統可能會自動將抵免額套用至預算 (請參閱 TotalAdjustsMicros)。 |
pendingProposal |
僅供輸出。修改這筆預算的待處理提案 (如果有的話)。 |
id |
僅供輸出。帳戶層級預算的 ID。 |
billingSetup |
僅供輸出。與這個帳戶層級預算相關聯的帳單設定資源名稱。BillingSetup 資源名稱的格式如下:
|
name |
僅供輸出。帳戶層級預算的名稱。 |
proposedStartDateTime |
僅供輸出。建議的帳戶層級預算開始時間,格式為 yyyy-MM-dd HH:mm:ss。如果提議的是 NOW 時間類型,則是指要求的時間。 |
approvedStartDateTime |
僅供輸出。帳戶層級預算的已核准開始時間,格式為 yyyy-MM-dd HH:mm:ss。 舉例來說,如果新預算在建議的開始時間後獲得核准,已核准的開始時間就是核准的時間。 |
purchaseOrderNumber |
僅供輸出。訂購單號碼是一種值,可協助使用者在月結單中參考這筆預算。 |
notes |
僅供輸出。與預算相關的附註。 |
聯集欄位 proposed_end_time 。建議的帳戶層級預算結束時間。proposed_end_time 只能是下列其中一項: |
|
proposedEndDateTime |
僅供輸出。建議的結束時間,格式為 yyyy-MM-dd HH:mm:ss。 |
proposedEndTimeType |
僅供輸出。建議的結束時間和定義明確的類型,例如 FOREVER。 |
聯集欄位 舉例來說,如果預算的結束時間已更新,且提案在提議的結束時間後獲得核准,則已核准的結束時間即為核准的時間。 |
|
approvedEndDateTime |
僅供輸出。已核准的結束時間,格式為 yyyy-MM-dd HH:mm:ss。 |
approvedEndTimeType |
僅供輸出。已核准的結束時間與定義明確的類型,例如 FOREVER。 |
聯集欄位 proposed_spending_limit 。提議的支出上限。proposed_spending_limit 只能是下列其中一項: |
|
proposedSpendingLimitMicros |
僅供輸出。建議的支出上限 (以百萬分之一為單位)。一百萬等於 1 單位。 |
proposedSpendingLimitType |
僅供輸出。提議的支出上限和定義明確的類型,例如 INFINITE。 |
聯集欄位 舉例來說,如果帳戶的支出金額超過提案核准時建議的支出上限,核准支出上限就會設為已支出的金額。 |
|
approvedSpendingLimitMicros |
僅供輸出。核准的支出上限 (以百萬分之一為單位)。一百萬等於 1 單位。只有在提議的支出上限是有限時才會填入資料,且該上限值一律會大於或等於提議的支出上限。 |
approvedSpendingLimitType |
僅供輸出。已核准的支出上限和明確定義的類型,例如 INFINITE。只有在已核准的支出上限為 INFINITE 時,系統才會填入這個值。 |
聯集欄位 這個值會決定帳戶的支出上限。 |
|
adjustedSpendingLimitMicros |
僅供輸出。調整後的支出上限 (以百萬分之一為單位)。一百萬等於 1 單位。 如果已核准的支出上限是有限,調整後的支出上限可能會因預算套用的調整項類型而不同。 如要瞭解各種調整項類型,請參閱:https://support.google.com/google-ads/answer/1704323 舉例來說,扣款調整會降低帳戶的支出上限。 |
adjustedSpendingLimitType |
僅供輸出。調整後的支出上限和定義明確的類型,例如 INFINITE。只有在調整後的支出上限為 INFINITE 的情況下,系統才會填入這個值。如果已核准的支出上限為 INFINITE,則保證達到一定上限。 |
AccountBudgetStatus
AccountBudget 的可能狀態。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
PENDING |
帳戶預算尚待審核。 |
APPROVED |
帳戶預算已通過核准。 |
CANCELLED |
使用者已取消帳戶預算。 |
PendingAccountBudgetProposal
與套用帳戶層級預算相關的待處理提案 (如適用)。
JSON 表示法 |
---|
{ "proposalType": enum ( |
欄位 | |
---|---|
proposalType |
僅供輸出。此提案的類型 (例如 END),可結束與這個提案相關的預算。 |
accountBudgetProposal |
僅供輸出。提案的資源名稱。AccountBudgetProposal 資源名稱的格式如下:
|
name |
僅供輸出。要指派給帳戶層級預算的名稱。 |
startDateTime |
僅供輸出。以 yyyy-MM-dd HH:mm:ss 格式顯示的開始時間。 |
purchaseOrderNumber |
僅供輸出。訂購單號碼是一種值,可協助使用者在月結單中參考這筆預算。 |
notes |
僅供輸出。與這筆預算相關的附註。 |
creationDateTime |
僅供輸出。此帳戶層級預算提案的建立時間。格式為「yyyy-MM-dd HH:mm:ss」。 |
聯集欄位 end_time 。帳戶層級預算的結束時間。end_time 只能是下列其中一項: |
|
endDateTime |
僅供輸出。結束時間,格式為 yyyy-MM-dd HH:mm:ss。 |
endTimeType |
僅供輸出。結束時間是明確定義的類型,例如 FOREVER。 |
聯集欄位 spending_limit 。支出上限。spending_limit 只能是下列其中一項: |
|
spendingLimitMicros |
僅供輸出。支出上限 (以百萬分之一為單位)。一百萬等於 1 單位。 |
spendingLimitType |
僅供輸出。支出上限與定義明確的類型,例如 INFINITE。 |
AdGroupAdAssetCombinationView
廣告群組廣告素材資源組合的使用情況。回應式搜尋廣告目前僅支援 AdAssetCombinationView,我們預計日後將支援更多廣告類型。
JSON 表示法 |
---|
{
"resourceName": string,
"servedAssets": [
{
object ( |
欄位 | |
---|---|
resourceName |
僅供輸出。廣告群組廣告素材資源組合檢視畫面的資源名稱。組合 ID 的長度為 128 位元,上方 64 位元會儲存在 asset_combination_id_high 中,而較低的 64 位元則儲存在 asset_combination_id_low 中。廣告群組廣告素材資源組合檢視資源名稱的格式如下: |
servedAssets[] |
僅供輸出。放送的素材資源。 |
enabled |
僅供輸出。素材資源組合和廣告最新版本的狀態。如果為 true,素材資源組合就會連結至廣告的最新版本。如果為 false,則表示該連結曾經存在,但已移除,且不會再顯示在最新版本的廣告中。 |
AssetUsage
內含資產的使用資訊。
JSON 表示法 |
---|
{
"asset": string,
"servedAssetFieldType": enum ( |
欄位 | |
---|---|
asset |
資產的資源名稱。 |
servedAssetFieldType |
素材資源的放送欄位類型。 |
AdGroupAdAssetView
廣告群組廣告與素材資源之間的連結。AppAds 和回應式搜尋廣告目前僅支援 廣告群組 AdAssetView。
JSON 表示法 |
---|
{ "resourceName": string, "fieldType": enum ( |
欄位 | |
---|---|
resourceName |
僅供輸出。廣告群組廣告素材資源檢視畫面的資源名稱。廣告群組廣告素材資源檢視資源名稱的格式為 (V4 之前):
廣告群組廣告素材資源檢視資源名稱的格式應為 (從 V4 開始):
|
fieldType |
僅供輸出。素材資源在廣告中的角色。 |
policySummary |
僅供輸出。廣告群組廣告素材資源的政策資訊。 |
performanceLabel |
僅供輸出。素材資源連結的成效。 |
pinnedField |
僅供輸出。固定欄位。 |
source |
僅供輸出。廣告群組廣告素材資源的來源。 |
adGroupAd |
僅供輸出。素材資源連結的廣告群組廣告。 |
asset |
僅供輸出。與廣告群組廣告連結的素材資源。 |
enabled |
僅供輸出。素材資源和廣告最新版本的狀態。如果為 true,素材資源會連結至廣告的最新版本。如果為 false,則表示該連結曾經存在,但已移除,且不會再顯示在最新版本的廣告中。 |
AdGroupAdAssetPolicySummary
包含廣告群組廣告素材資源的政策資訊。
JSON 表示法 |
---|
{ "policyTopicEntries": [ { object ( |
欄位 | |
---|---|
policyTopicEntries[] |
僅供輸出。廣告群組廣告素材資源的政策結果清單。 |
reviewStatus |
僅供輸出。這項廣告群組廣告素材資源的審核程序。 |
approvalStatus |
僅供輸出。這個廣告群組廣告素材資源的整體核准狀態,根據個別政策主題項目的狀態計算而得。 |
AdGroupAudienceView
廣告群組目標對象資料檢視。包括多媒體廣告聯播網和 YouTube 聯播網廣告的興趣和再行銷名單,以及在目標對象層級匯總的搜尋廣告再行銷名單。
JSON 表示法 |
---|
{ "resourceName": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。廣告群組目標對象檢視畫面的資源名稱。廣告群組目標對象資料檢視資源名稱的格式如下:
|
AdGroupCriterionSimulation
廣告群組條件模擬。以下分別列出支援的廣告管道類型、條件類型、模擬類型和模擬修改方法組合。從 V5 開始的飯店廣告群組條件模擬作業。
- 多媒體廣告 - 關鍵字 - 單次點擊出價 - 單次點擊出價 - UNIFORM
- 搜尋 - 關鍵字 - 單次點擊出價 - 單次點擊出價 - 排除
- SHOPPING - LISTING_GROUP -CPC_bid - UNIFORM
- 飯店 - LISTING_GROUP - 單次點擊出價 - 非重複出價
- 飯店 - LISTING_GROUP - PERCENT_CPC_BID - UNIFORM
JSON 表示法 |
---|
{ "resourceName": string, "type": enum ( |
欄位 | |
---|---|
resourceName |
僅供輸出。廣告群組條件模擬的資源名稱。廣告群組條件模擬資源名稱的格式如下:
|
type |
僅供輸出。模擬作業所修改的欄位。 |
modificationMethod |
僅供輸出。模擬作業如何修改欄位。 |
adGroupId |
僅供輸出。模擬作業的廣告群組 ID。 |
criterionId |
僅供輸出。模擬作業的條件 ID。 |
startDate |
僅供輸出。模擬依據的第一天,格式為 YYYY-MM-DD。 |
endDate |
僅供輸出。模擬結果的最後一天,格式為 YYYY-MM-DD。 |
聯集欄位 point_list 。模擬點清單。point_list 只能是下列其中一項: |
|
cpcBidPointList |
僅供輸出。如果模擬類型為「CPC_BID」,模擬點。 |
percentCpcBidPointList |
僅供輸出。如果模擬類型為 PERCENT_CPC_BID,模擬點就會發生。 |
SimulationType
列舉說明模擬作業修改的欄位。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
CPC_BID |
模擬結果可用於單次點擊出價。 |
CPV_BID |
模擬結果是針對單次收視出價。 |
TARGET_CPA |
模擬工具為單次轉換出價目標。 |
BID_MODIFIER |
這項模擬作業適用於出價調節係數, |
TARGET_ROAS |
模擬功能是針對廣告投資報酬率目標進行模擬。 |
PERCENT_CPC_BID |
模擬結果是單次點擊出價百分比。 |
TARGET_IMPRESSION_SHARE |
模擬結果是曝光比重目標。 |
BUDGET |
模擬作業僅適用於預算。 |
SimulationModificationMethod
列舉說明模擬作業修改欄位的方法。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
UNIFORM |
模擬中的值會套用至指定資源的所有子項。未遵循子資源的覆寫。 |
DEFAULT |
系統會將模擬中的值套用至指定資源。系統會遵循子資源的覆寫設定,且流量估算並未納入這些資源。 |
SCALING |
模擬中的值全都是由相同的因素縮放。舉例來說,在模擬的 TargetCpa 廣告活動中,系統會將廣告活動目標和所有廣告群組目標設定成 X 的係數。 |
CpcBidSimulationPointList
用於模擬「CPC_BID」類型模擬作業的容器。
JSON 表示法 |
---|
{
"points": [
{
object ( |
欄位 | |
---|---|
points[] |
一系列單次點擊出價金額的預測指標。 |
CpcBidSimulationPoint
特定單次點擊出價金額的預測指標。
JSON 表示法 |
---|
{ "requiredBudgetAmountMicros": string, "biddableConversions": number, "biddableConversionsValue": number, "clicks": string, "costMicros": string, "impressions": string, "topSlotImpressions": string, // Union field |
欄位 | |
---|---|
requiredBudgetAmountMicros |
廣告主為了獲得預估流量而必須設定的預計每日預算 (以廣告客戶貨幣的百萬分之一表示)。 |
biddableConversions |
預計可出價轉換次數。 |
biddableConversionsValue |
可出價轉換的預計總價值。 |
clicks |
預計點擊次數。 |
costMicros |
預估費用 (以百萬分之一為單位) |
impressions |
預計曝光次數。 |
topSlotImpressions |
預測的頂端版位曝光次數。只有搜尋廣告管道類型支援這個欄位。 |
聯集欄位 cpc_simulation_key_value 。如果 SimulationModificationMethod = UNIFORM 或 DEFAULT,已設定 cpc_bid_micros。當 SimulationModificationMethod = SCALING 時,已設定 cpc_bid_scaling_modifier。cpc_simulation_key_value 只能是下列其中一項: |
|
cpcBidMicros |
模擬單次點擊出價,預估指標是根據預測指標計算而得。 |
cpcBidScalingModifier |
模擬縮放修飾符是以預測指標為基礎。與模擬實體相關的所有單次點擊出價都會由這個修飾符調整。 |
PercentCpcBidSimulationPointList
用於模擬 PERCENT_CPC_BID 類型模擬點的容器。
JSON 表示法 |
---|
{
"points": [
{
object ( |
欄位 | |
---|---|
points[] |
一系列單次點擊出價百分比的預測指標。 |
PercentCpcBidSimulationPoint
特定單次點擊出價金額的預測指標。只有飯店廣告管道類型支援這個欄位。
JSON 表示法 |
---|
{ "percentCpcBidMicros": string, "biddableConversions": number, "biddableConversionsValue": number, "clicks": string, "costMicros": string, "impressions": string, "topSlotImpressions": string } |
欄位 | |
---|---|
percentCpcBidMicros |
模擬單次點擊出價百分比,預計指標是根據預測指標計算而得。單次點擊出價百分比 (以商品或服務在廣告價格中所佔的比例表示)。在這裡儲存的值為 1,000,000 * [fraction]。 |
biddableConversions |
預計可出價轉換次數。 |
biddableConversionsValue |
可出價轉換的預計總價值 (以當地幣別計算)。 |
clicks |
預計點擊次數。 |
costMicros |
預估費用 (以百萬分之一為單位) |
impressions |
預計曝光次數。 |
topSlotImpressions |
預測的頂端版位曝光次數。 |
AdGroupSimulation
廣告群組模擬。下方詳細說明瞭廣告管道類型、模擬類型和模擬修改方法所支援的組合。
- 搜尋聯播網 - 單次點擊出價 - 預設
- 搜尋 - 單次點擊出價 - 排除
- 搜尋 - TARGET_CPA - 非表單
- 搜尋 - TARGET_ROAS - 聯合國處理
- 多媒體 - 單次點擊出價 - 預設
- 多媒體廣告 - 單次點擊出價 - 不重複出價
- 多媒體廣告 - TARGET_CPA - 非必填
JSON 表示法 |
---|
{ "resourceName": string, "type": enum ( |
欄位 | |
---|---|
resourceName |
僅供輸出。廣告群組模擬的資源名稱。廣告群組模擬資源名稱的格式如下:
|
type |
僅供輸出。模擬作業所修改的欄位。 |
modificationMethod |
僅供輸出。模擬作業如何修改欄位。 |
adGroupId |
僅供輸出。模擬作業的廣告群組 ID。 |
startDate |
僅供輸出。模擬依據的第一天,格式為 YYYY-MM-DD。 |
endDate |
僅供輸出。模擬結果的最後一天,格式為 YYYY-MM-DD |
聯集欄位 point_list 。模擬點清單。point_list 只能是下列其中一項: |
|
cpcBidPointList |
僅供輸出。如果模擬類型為「CPC_BID」,模擬點。 |
cpvBidPointList |
僅供輸出。如果模擬類型為 CPV_BID,模擬點。 |
targetCpaPointList |
僅供輸出。如果模擬類型為 TARGET_CPA,則模擬點。 |
targetRoasPointList |
僅供輸出。如果模擬類型為「TARGET_ROAS」時,模擬點。 |
CpvBidSimulationPointList
用於模擬 CPV_BID 類型模擬點的容器。
JSON 表示法 |
---|
{
"points": [
{
object ( |
欄位 | |
---|---|
points[] |
一系列單次收視出價金額的預測指標。 |
CpvBidSimulationPoint
特定單次收視出價金額的預測指標。
JSON 表示法 |
---|
{ "cpvBidMicros": string, "costMicros": string, "impressions": string, "views": string } |
欄位 | |
---|---|
cpvBidMicros |
模擬單次收視出價是以預測指標為基礎。 |
costMicros |
預估費用 (以百萬分之一為單位) |
impressions |
預計曝光次數。 |
views |
預計觀看次數。 |
TargetCpaSimulationPointList
用於模擬 TARGET_CPA 類型模擬點的容器。
JSON 表示法 |
---|
{
"points": [
{
object ( |
欄位 | |
---|---|
points[] |
一系列目標單次轉換出價金額的預測指標。 |
TargetCpaSimulationPoint
特定目標單次轉換出價金額的預測指標。
JSON 表示法 |
---|
{ "requiredBudgetAmountMicros": string, "appInstalls": number, "inAppActions": number, "biddableConversions": number, "biddableConversionsValue": number, "clicks": string, "costMicros": string, "impressions": string, "topSlotImpressions": string, "interactions": string, // Union field |
欄位 | |
---|---|
requiredBudgetAmountMicros |
廣告主為了獲得預估流量而必須設定的預計每日預算 (以廣告客戶貨幣的百萬分之一表示)。 |
appInstalls |
預計應用程式安裝次數。 |
inAppActions |
預估應用程式內動作次數。 |
biddableConversions |
預計可出價轉換次數。 |
biddableConversionsValue |
可出價轉換的預計總價值。 |
clicks |
預計點擊次數。 |
costMicros |
預估費用 (以百萬分之一為單位) |
impressions |
預計曝光次數。 |
topSlotImpressions |
預測的頂端版位曝光次數。只有搜尋廣告管道類型支援這個欄位。 |
interactions |
預計互動次數。只有探索廣告管道類型支援這個欄位。 |
聯集欄位 target_cpa_simulation_key_value 。當 SimulationModificationMethod = UNIFORM 或 DEFAULT 時,系統會設定 target_cpa_micros。當 SimulationModificationMethod = SCALING 時,已設定 target_cpa_scaling_modifier。target_cpa_simulation_key_value 只能是下列其中一項: |
|
targetCpaMicros |
模擬目標單次轉換出價,其中預測指標是根據預測指標計算而得。 |
targetCpaScalingModifier |
模擬縮放修飾符是以預測指標為基礎。與模擬實體相關的所有單次操作出價目標都會由這個修飾符調整。 |
TargetRoasSimulationPointList
用於模擬 TARGET_ROAS 類型模擬點的容器。
JSON 表示法 |
---|
{
"points": [
{
object ( |
欄位 | |
---|---|
points[] |
一系列目標廣告投資報酬率金額的預測指標。 |
TargetRoasSimulationPoint
特定目標廣告投資報酬率金額的預測指標。
JSON 表示法 |
---|
{ "requiredBudgetAmountMicros": string, "targetRoas": number, "biddableConversions": number, "biddableConversionsValue": number, "clicks": string, "costMicros": string, "impressions": string, "topSlotImpressions": string } |
欄位 | |
---|---|
requiredBudgetAmountMicros |
廣告主為了獲得預估流量而必須設定的預計每日預算 (以廣告客戶貨幣的百萬分之一表示)。 |
targetRoas |
模擬目標廣告投資報酬率 (根據預測指標所依據)。 |
biddableConversions |
預計可出價轉換次數。 |
biddableConversionsValue |
可出價轉換的預計總價值。 |
clicks |
預計點擊次數。 |
costMicros |
預估費用 (以百萬分之一為單位) |
impressions |
預計曝光次數。 |
topSlotImpressions |
預測的頂端版位曝光次數。只有搜尋廣告管道類型支援這個欄位。 |
AgeRangeView
年齡層檢視。
JSON 表示法 |
---|
{ "resourceName": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。年齡層檢視畫面的資源名稱。年齡層檢視畫面資源名稱的格式如下:
|
AdScheduleView
廣告時段檢視畫面會按 AdSchedule 條件提供廣告活動成效摘要。
JSON 表示法 |
---|
{ "resourceName": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。廣告時段檢視畫面的資源名稱。AdSchedule 檢視表資源名稱的格式如下:
|
DomainCategory
檢索網域而自動產生的類別。如果廣告活動使用 DynamicSearchAdsSetting,系統會為網域產生網域類別。您可以使用 WebpageConditionInfo 指定這些類別。請參閱:https://support.google.com/google-ads/answer/2471185
JSON 表示法 |
---|
{ "resourceName": string, "campaign": string, "category": string, "languageCode": string, "domain": string, "coverageFraction": number, "categoryRank": string, "hasChildren": boolean, "recommendedCpcBidMicros": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。網域類別的資源名稱。網域類別資源名稱的格式如下:
|
campaign |
僅供輸出。建議採用這個類別的廣告活動。 |
category |
僅供輸出。網站網域的建議類別。舉例來說,如果您有電子產品網站,類別可以設為「相機」、「電視」等。 |
languageCode |
僅供輸出。指定網站語言的語言代碼,例如「en」代表英文。可以在動態搜尋廣告所需的 DynamicSearchAdsSetting 中指定語言。這是您希望 Google Ads 尋找、製作廣告及比對搜尋字詞的網頁所使用的語言。 |
domain |
僅供輸出。網站的網域。網域可以在動態搜尋廣告所需的 DynamicSearchAdsSetting 中指定。 |
coverageFraction |
僅供輸出。您網站上與這個類別相符的網頁比例。 |
categoryRank |
僅供輸出。這個類別在類別集中的位置。數字越小表示網域越符合網域;空值表示不建議使用。 |
hasChildren |
僅供輸出。指出此類別是否包含子類別。 |
recommendedCpcBidMicros |
僅供輸出。該類別的建議單次點擊出價。 |
AssetFieldTypeView
素材資源欄位類型檢視畫面。當使用素材資源做為額外資訊時,這個檢視畫面會回報各素材資源欄位類型的未重疊指標。
JSON 表示法 |
---|
{
"resourceName": string,
"fieldType": enum ( |
欄位 | |
---|---|
resourceName |
僅供輸出。資產欄位類型檢視畫面的資源名稱。資產欄位類型檢視資源名稱的格式如下所示:
|
fieldType |
僅供輸出。資產欄位類型檢視畫面的素材資源欄位類型。 |
AssetGroupProductGroupView
素材資源群組產品群組檢視畫面。
JSON 表示法 |
---|
{ "resourceName": string, "assetGroup": string, "assetGroupListingGroupFilter": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。素材資源群組產品群組檢視畫面的資源名稱。素材資源群組產品群組檢視畫面資源名稱的格式如下:
|
assetGroup |
僅供輸出。與商家資訊群組篩選器相關聯的素材資源群組。 |
assetGroupListingGroupFilter |
僅供輸出。素材資源群組商家資訊群組篩選器的資源名稱。 |
AssetGroupTopCombinationView
廣告群組廣告素材資源組合的使用情況。
JSON 表示法 |
---|
{
"resourceName": string,
"assetGroupTopCombinations": [
{
object ( |
欄位 | |
---|---|
resourceName |
僅供輸出。素材資源群組頂端組合檢視畫面的資源名稱。AssetGroup 頂層組合檢視資源名稱的格式為:「customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}」 |
assetGroupTopCombinations[] |
僅供輸出。共同放送的最佳素材資源組合。 |
AssetGroupAssetCombinationData
素材資源群組素材資源組合資料
JSON 表示法 |
---|
{
"assetCombinationServedAssets": [
{
object ( |
欄位 | |
---|---|
assetCombinationServedAssets[] |
僅供輸出。放送的素材資源。 |
AssetSetTypeView
素材資源集類型檢視畫面。這個檢視畫面會記錄每個素材資源集類型的未重疊指標。這份報表不包含子素材資源集類型。統計資料彙整於父項素材資源集類型下方。
JSON 表示法 |
---|
{
"resourceName": string,
"assetSetType": enum ( |
欄位 | |
---|---|
resourceName |
僅供輸出。資產集類型檢視畫面的資源名稱。資產集類型檢視資源名稱的格式如下:
|
assetSetType |
僅供輸出。素材資源集類型檢視畫面的素材資源集類型。 |
BiddingStrategySimulation
出價策略模擬。下方詳細說明瞭支援的模擬類型和模擬修改方法組合。
- TARGET_CPA - 聯合國工夫
- TARGET_ROAS - UNIFORM
JSON 表示法 |
---|
{ "resourceName": string, "biddingStrategyId": string, "type": enum ( |
欄位 | |
---|---|
resourceName |
僅供輸出。出價策略模擬的資源名稱。出價策略模擬資源名稱的格式如下:
|
biddingStrategyId |
僅供輸出。出價策略的共用組合 ID。 |
type |
僅供輸出。模擬作業所修改的欄位。 |
modificationMethod |
僅供輸出。模擬作業如何修改欄位。 |
startDate |
僅供輸出。模擬依據的第一天,格式為 YYYY-MM-DD。 |
endDate |
僅供輸出。模擬結果的最後一天,格式為 YYYY-MM-DD |
聯集欄位 point_list 。模擬點清單。point_list 只能是下列其中一項: |
|
targetCpaPointList |
僅供輸出。如果模擬類型為 TARGET_CPA,則模擬點。 |
targetRoasPointList |
僅供輸出。如果模擬類型為「TARGET_ROAS」時,模擬點。 |
CallView
一種通話檢視,內含來電專用廣告或來電額外資訊的來電追蹤資料。
JSON 表示法 |
---|
{ "resourceName": string, "callerCountryCode": string, "callerAreaCode": string, "callDurationSeconds": string, "startCallDateTime": string, "endCallDateTime": string, "callTrackingDisplayLocation": enum ( |
欄位 | |
---|---|
resourceName |
僅供輸出。呼叫檢視的資源名稱。呼叫檢視資源名稱的格式如下:
|
callerCountryCode |
僅供輸出。來電者的國家/地區代碼。 |
callerAreaCode |
僅供輸出。來電者的區碼。如果通話時間長度短於 15 秒,則為空值。 |
callDurationSeconds |
僅供輸出。廣告客戶提供的通話時間長度 (以秒為單位)。 |
startCallDateTime |
僅供輸出。廣告主提供的通話開始日期時間。 |
endCallDateTime |
僅供輸出。廣告主提供的通話結束日期時間。 |
callTrackingDisplayLocation |
僅供輸出。來電追蹤顯示位置。 |
type |
僅供輸出。呼叫類型。 |
callStatus |
僅供輸出。通話狀態。 |
CallTrackingDisplayLocation
可能的來電追蹤顯示位置。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
AD |
透過廣告撥打的電話。 |
LANDING_PAGE |
透過到達網頁廣告所撥打的電話。 |
CallType
發出呼叫時可能出現的屬性類型。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
MANUALLY_DIALED |
使用者手動撥打了電話。 |
HIGH_END_MOBILE_SEARCH |
一通行動的點選通話廣告格式。 |
GoogleVoiceCallStatus
Google 語音通話的可能狀態。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
MISSED |
未接聽來電。 |
RECEIVED |
已收到通話。 |
CampaignAudienceView
廣告活動目標對象檢視畫面。包含多媒體廣告聯播網和 YouTube 聯播網廣告的興趣和再行銷名單,以及依廣告活動和目標對象條件匯總的搜尋廣告再行銷名單 (RLSA)。這個檢視畫面只包含廣告活動層級附加的目標對象。
JSON 表示法 |
---|
{ "resourceName": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。廣告活動目標對象檢視畫面的資源名稱。廣告活動目標對象資料檢視資源名稱的格式如下:
|
CampaignSearchTermInsight
廣告活動搜尋字詞檢視。歷來資料從 2023 年 3 月起開始提供。
JSON 表示法 |
---|
{ "resourceName": string, "categoryLabel": string, "id": string, "campaignId": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。廣告活動層級搜尋字詞洞察的資源名稱。廣告活動層級搜尋字詞洞察資源名稱的格式如下:
|
categoryLabel |
僅供輸出。搜尋類別的標籤。如果搜尋字詞不符合其他類別,就會表示屬於「全部接收」類別。 |
id |
僅供輸出。深入分析的 ID。 |
campaignId |
僅供輸出。廣告活動的 ID。 |
CampaignSimulation
廣告活動模擬。下方詳細說明瞭廣告管道類型、模擬類型和模擬修改方法所支援的組合。
- 搜尋 - 單次點擊出價 - 排除
- 搜尋 - 單次點擊出價 - 放送
- 搜尋 - TARGET_CPA - 非表單
- 搜尋 - TARGET_CPA - SCALING
- 搜尋 - TARGET_ROAS - 聯合國處理
- 搜尋 - TARGET_IMPRESSION_SHARE - 專屬
- 搜尋聯播網 - 預算 - 公開
- 購物 - 預算 - 不公開
- 購物 - TARGET_ROAS - UNIFORM
- MULTI_CHANNEL - TARGET_CPA - UNIFORM
- MULTI_CHANNEL - TARGET_ROAS - UNIFORM
- 探索 - TARGET_CPA - 預設
- 多媒體廣告 - TARGET_CPA - 非必填
- PERFORMANCE_MAX - TARGET_CPA - UNIFORM
- PERFORMANCE_MAX - TARGET_ROAS - UNIFORM
- PERFORMANCE_MAX - 預算 - 非表單
JSON 表示法 |
---|
{ "resourceName": string, "campaignId": string, "type": enum ( |
欄位 | |
---|---|
resourceName |
僅供輸出。廣告活動模擬的資源名稱。廣告活動模擬資源名稱的格式如下:
|
campaignId |
僅供輸出。模擬作業的廣告活動 ID。 |
type |
僅供輸出。模擬作業所修改的欄位。 |
modificationMethod |
僅供輸出。模擬作業如何修改欄位。 |
startDate |
僅供輸出。模擬依據的第一天,格式為 YYYY-MM-DD。 |
endDate |
僅供輸出。模擬結果的最後一天,格式為 YYYY-MM-DD |
聯集欄位 point_list 。模擬點清單。point_list 只能是下列其中一項: |
|
cpcBidPointList |
僅供輸出。如果模擬類型為「CPC_BID」,模擬點。 |
targetCpaPointList |
僅供輸出。如果模擬類型為 TARGET_CPA,則模擬點。 |
targetRoasPointList |
僅供輸出。如果模擬類型為「TARGET_ROAS」時,模擬點。 |
targetImpressionSharePointList |
僅供輸出。如果模擬類型為 TARGET_IMPRESSION_SHARE,則模擬點。 |
budgetPointList |
僅供輸出。如果模擬類型為「BUDGET」,模擬點。 |
BudgetSimulationPointList
用於模擬「BUDGET」類型模擬點的容器。
JSON 表示法 |
---|
{
"points": [
{
object ( |
欄位 | |
---|---|
points[] |
一系列預算金額的預測指標。 |
BudgetSimulationPoint
特定預算金額的預測指標。
JSON 表示法 |
---|
{ "budgetAmountMicros": string, "requiredCpcBidCeilingMicros": string, "biddableConversions": number, "biddableConversionsValue": number, "clicks": string, "costMicros": string, "impressions": string, "topSlotImpressions": string, "interactions": string } |
欄位 | |
---|---|
budgetAmountMicros |
根據預計指標計算出的模擬預算。 |
requiredCpcBidCeilingMicros |
廣告客戶為了獲得這項模擬結果,必須設定的每日單次點擊出價上限 (以廣告客戶貨幣的百萬分之一表示)。只有採用「目標支出」出價策略的廣告活動才支援這個欄位。 |
biddableConversions |
預計可出價轉換次數。 |
biddableConversionsValue |
可出價轉換的預計總價值。 |
clicks |
預計點擊次數。 |
costMicros |
預估費用 (以百萬分之一為單位) |
impressions |
預計曝光次數。 |
topSlotImpressions |
預測的頂端版位曝光次數。只有搜尋廣告管道類型支援這個欄位。 |
interactions |
預計互動次數。只有探索廣告管道類型支援這個欄位。 |
CarrierConstant
可用於廣告活動指定目標的電信業者條件。
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "name": string, "countryCode": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。電信業者條件的資源名稱。電信業者條件資源名稱的格式如下:
|
id |
僅供輸出。電信業者條件的 ID。 |
name |
僅供輸出。通訊業者的全名 (英文)。 |
countryCode |
僅供輸出。通訊業者所在國家/地區的國家/地區代碼,例如「AR」、「FR」等 |
ChangeEvent
說明特定資源類型傳回資源的精細變更。並納入過去 30 天內透過 UI 或 API 所做的變更。變更後的欄位會顯示先前的和新值。ChangeEvent 可能需要最多 3 分鐘才會反映新的變更。
JSON 表示法 |
---|
{ "resourceName": string, "changeDateTime": string, "changeResourceType": enum ( |
欄位 | |
---|---|
resourceName |
僅供輸出。變更事件的資源名稱。變更事件資源名稱的格式如下:
|
changeDateTime |
僅供輸出。對這項資源提交變更的時間。 |
changeResourceType |
僅供輸出。已變更資源的類型。這會指定哪個資源會在舊資源和 newResource 中設定。 |
changeResourceName |
僅供輸出。發生這項變更的 Just 資源。 |
clientType |
僅供輸出。執行變更的位置。 |
userEmail |
僅供輸出。做出這項變更的使用者電子郵件。 |
oldResource |
僅供輸出。變更之前的舊資源。系統只會填入變更過的欄位。 |
newResource |
僅供輸出。變更後的新資源。系統只會填入變更過的欄位。 |
resourceChangeOperation |
僅供輸出。對已變更資源的作業。 |
changedFields |
僅供輸出。傳回資源中已變更欄位的清單。 此為以半形逗號分隔的完整欄位名稱清單,範例: |
campaign |
僅供輸出。受這項異動影響的廣告活動。 |
adGroup |
僅供輸出。受到這項變更影響的廣告群組。 |
feed |
僅供輸出。受到這項異動影響的動態饋給。 |
feedItem |
僅供輸出。受到這項變更影響的 FeedItem。 |
asset |
僅供輸出。受到這項變更影響的資產。 |
ChangeEventResourceType
列出 ChangesEvent 資源支援的資源類型。
列舉 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
僅用於傳回值。代表這個版本中的未分類資源。 |
AD |
廣告資源變更。 |
AD_GROUP |
廣告群組資源變更。 |
AD_GROUP_CRITERION |
廣告群組條件資源變更。 |
CAMPAIGN |
廣告活動資源變更。 |
CAMPAIGN_BUDGET |
CampaignBudget 資源變更。 |
AD_GROUP_BID_MODIFIER |
廣告群組 BidModifier 資源變更。 |
CAMPAIGN_CRITERION |
CampaignCriterion 資源變更。 |
FEED |
動態饋給資源變更。 |
FEED_ITEM |
FeedItem 資源變更。 |
CAMPAIGN_FEED |
CampaignFeed 資源變更。 |
AD_GROUP_FEED |
廣告群組動態饋給資源異動。 |
AD_GROUP_AD |
廣告群組廣告資源變更。 |
ASSET |
資產資源變更。 |
CUSTOMER_ASSET |
CustomerAsset 資源變更。 |
CAMPAIGN_ASSET |
CampaignAsset 資源變更。 |
AD_GROUP_ASSET |
廣告群組資產變更。 |
ASSET_SET |
AssetSet 資源變更。 |
ASSET_SET_ASSET |
AssetSetAsset 資源變更。 |
CAMPAIGN_ASSET_SET |
CampaignAssetSet 資源變更。 |
ChangeClientType
changeEvent 資源的執行來源。
列舉 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
僅用於傳回值。代表這個版本不明的未分類用戶端類型。 |
GOOGLE_ADS_WEB_CLIENT |
透過 ads.google.com.tw 所做的變更。例如透過廣告活動管理進行變更。 |
GOOGLE_ADS_AUTOMATED_RULE |
透過 Google Ads 自動規則所做的變更。 |
GOOGLE_ADS_SCRIPTS |
透過 Google Ads 指令碼所做的變更。 |
GOOGLE_ADS_BULK_UPLOAD |
透過 Google Ads 大量上傳功能所做的變更。 |
GOOGLE_ADS_API |
由 Google Ads API 所做的變更。 |
GOOGLE_ADS_EDITOR |
由 Google Ads 編輯器所做的變更。這個值是預留位置。API 不會傳回這些變更。 |
GOOGLE_ADS_MOBILE_APP |
由 Google Ads 行動應用程式所做的變更。 |
GOOGLE_ADS_RECOMMENDATIONS |
透過 Google Ads 建議所做的變更。 |
SEARCH_ADS_360_SYNC |
透過 Search Ads 360 同步作業所做的變更。 |
SEARCH_ADS_360_POST |
透過 Search Ads 360 發布所做的變更。 |
INTERNAL_TOOL |
透過內部工具所做的變更。舉例來說,如果使用者在廣告活動等實體中設定網址範本,系統就會自動將該範本與 SA360 Clickserver 網址包裝在一起。 |
OTHER |
未分類的變更類型 (例如透過 Google Ads 優待券兌換的變更)。 |
GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION |
訂閱 Google Ads 最佳化建議後所做的變更。 |
ChangedResource
展示所有支援資源的包裝函式 proto。系統只會設定 changeResourceType 資源。
JSON 表示法 |
---|
{ "ad": { object ( |
欄位 | |
---|---|
ad |
僅供輸出。設定 if changeResourceType == AD 時,才設定此參數。 |
adGroup |
僅供輸出。設定 if changeResourceType == AD_GROUP 時,才設定此參數。 |
adGroupCriterion |
僅供輸出。設定 if changeResourceType == AD_GROUP_CRITERION。 |
campaign |
僅供輸出。若 changeResourceType == CAMPAIGN,則設定此參數。 |
campaignBudget |
僅供輸出。若 changeResourceType == CAMPAIGN_BUDGET ,則設定此值。 |
adGroupBidModifier |
僅供輸出。設定如果 changeResourceType == AD_GROUP_BID_MODIFIER, |
campaignCriterion |
僅供輸出。如果 changeResourceType == CAMPAIGN_CRITERION,則設定此參數。 |
feed |
僅供輸出。如果 changeResourceType == FEED ,則設定此參數。 |
feedItem |
僅供輸出。如果 changeResourceType == FEED_ITEM,請設定此參數。 |
campaignFeed |
僅供輸出。如果 changeResourceType == CAMPAIGN_FEED 時,設定此參數,則設定此參數。 |
adGroupFeed |
僅供輸出。設定如果 changeResourceType == AD_GROUP_FEED, |
adGroupAd |
僅供輸出。設定 if changeResourceType == AD_GROUP_AD 時,才設定此參數。 |
asset |
僅供輸出。針對 changeResourceType == ASSET 設定。 |
customerAsset |
僅供輸出。如果 changeResourceType == CUSTOMER_ASSET ,設定此參數。 |
campaignAsset |
僅供輸出。針對 changeResourceType == CAMPAIGN_ASSET 設定。 |
adGroupAsset |
僅供輸出。設定 if changeResourceType == AD_GROUP_ASSET。 |
assetSet |
僅供輸出。如果 changeResourceType == ASSET_SET 設定,設定就會。 |
assetSetAsset |
僅供輸出。設定如果 changeResourceType == ASSET_SET_ASSET。 |
campaignAssetSet |
僅供輸出。若 changeResourceType == CAMPAIGN_ASSET_SET ,設定此參數。 |
ResourceChangeOperation
changeEvent 資源中已變更資源的作業。
列舉 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
僅用於傳回值。代表這個版本不明的未分類作業。 |
CREATE |
已建立資源。 |
UPDATE |
資源已修改。 |
REMOVE |
資源已移除。 |
ChangeStatus
說明傳回資源的狀態。ChangeStatus 可能需要最多 3 分鐘才會反映新的變更。
JSON 表示法 |
---|
{ "resourceName": string, "resourceType": enum ( |
欄位 | |
---|---|
resourceName |
僅供輸出。變更狀態的資源名稱。變更狀態資源名稱的格式如下:
|
resourceType |
僅供輸出。代表變更的資源類型。這會指定將會設定的欄位。舉例來說,如果是「AD_GROUP」,系統會設定「campaign」和「adGroup」欄位。 |
resourceStatus |
僅供輸出。代表已變更資源的狀態。 |
sharedSet |
僅供輸出。受到這項異動影響的 SharedSet。 |
campaignSharedSet |
僅供輸出。受到這項異動影響的 CampaignSharedSet。 |
asset |
僅供輸出。受到這項變更影響的資產。 |
customerAsset |
僅供輸出。受這項異動影響的客戶資產。 |
campaignAsset |
僅供輸出。受到這項異動影響的 CampaignAsset。 |
adGroupAsset |
僅供輸出。受這項異動影響的 adAsset。 |
combinedAudience |
僅供輸出。受這項異動影響的 MergedAudience。 |
lastChangeDateTime |
僅供輸出。最近一次變更於這項資源的時間。 |
campaign |
僅供輸出。受這項異動影響的廣告活動。 |
adGroup |
僅供輸出。受到這項變更影響的廣告群組。 |
adGroupAd |
僅供輸出。受到這項變更影響的 廣告群組廣告。 |
adGroupCriterion |
僅供輸出。受此變更影響的 廣告群組條件。 |
campaignCriterion |
僅供輸出。受到這項異動影響的 CampaignCriterion。 |
feed |
僅供輸出。受到這項異動影響的動態饋給。 |
feedItem |
僅供輸出。受到這項變更影響的 FeedItem。 |
adGroupFeed |
僅供輸出。受到這項異動影響的廣告群組動態饋給。 |
campaignFeed |
僅供輸出。受到這項異動影響的廣告活動動態饋給。 |
adGroupBidModifier |
僅供輸出。受這項變更影響的 廣告群組 BidModifier。 |
ChangeStatusResourceType
列舉列出 ChangeStatus 資源支援的資源類型。
列舉 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
僅用於傳回值。代表這個版本中的未分類資源。 |
AD_GROUP |
廣告群組資源變更。 |
AD_GROUP_AD |
廣告群組廣告資源變更。 |
AD_GROUP_CRITERION |
廣告群組條件資源變更。 |
CAMPAIGN |
廣告活動資源變更。 |
CAMPAIGN_CRITERION |
CampaignCriterion 資源變更。 |
FEED |
動態饋給資源變更。 |
FEED_ITEM |
FeedItem 資源變更。 |
AD_GROUP_FEED |
廣告群組動態饋給資源異動。 |
CAMPAIGN_FEED |
CampaignFeed 資源變更。 |
AD_GROUP_BID_MODIFIER |
廣告群組 BidModifier 資源變更。 |
SHARED_SET |
SharedSet 資源變更。 |
CAMPAIGN_SHARED_SET |
CampaignSharedSet 資源變更。 |
ASSET |
資產資源變更。 |
CUSTOMER_ASSET |
CustomerAsset 資源變更。 |
CAMPAIGN_ASSET |
CampaignAsset 資源變更。 |
AD_GROUP_ASSET |
廣告群組資產變更。 |
COMBINED_AUDIENCE |
MergedAudience 資源變更。 |
ChangeStatusOperation
已變更資源的狀態
列舉 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
僅用於傳回值。代表這個版本中的未分類資源。 |
ADDED |
已建立資源。 |
CHANGED |
資源已修改。 |
REMOVED |
資源已移除。 |
CombinedAudience
說明含有不同目標對象的合併目標對象資源。
JSON 表示法 |
---|
{
"resourceName": string,
"id": string,
"status": enum ( |
欄位 | |
---|---|
resourceName |
不可變動。合併目標對象的資源名稱。合併目標對象名稱的形式如下:
|
id |
僅供輸出。合併目標對象的 ID。 |
status |
僅供輸出。這個合併目標對象的狀態。指出合併目標對像是否已啟用或已移除。 |
name |
僅供輸出。合併目標對象的名稱。所有合併目標對象的值不得重複。 |
description |
僅供輸出。這個合併目標對象的說明。 |
CombinedAudienceStatus
列舉包括可能的合併目標對象狀態類型。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
ENABLED |
已啟用狀態 - 合併目標對像已啟用,可以指定。 |
REMOVED |
已移除狀態 - 合併目標對像已移除,且無法用於指定目標。 |
ClickView
點擊檢視畫面,內含各個點擊層級匯總的指標,包括有效和無效點擊。對非搜尋廣告活動來說,Metrics.clicks 代表有效與無效互動次數。包含 ClickView 的查詢必須採用一個篩選器,將結果範圍限制在一天內,而且可以要求在要求提出前 90 天以內的日期。
JSON 表示法 |
---|
{ "resourceName": string, "areaOfInterest": { object ( |
欄位 | |
---|---|
resourceName |
僅供輸出。點擊檢視的資源名稱。點擊檢視資源名稱的格式如下:
|
areaOfInterest |
僅供輸出。與曝光相關聯的興趣區域相符的地點條件。 |
locationOfPresence |
僅供輸出。與曝光相關聯的所在地條件相符。 |
keyword |
僅供輸出。相關的關鍵字 (如果有的話) 會對應到 SEARCH 管道。 |
keywordInfo |
僅供輸出。關於相關關鍵字的基本資訊 (如果有的話)。 |
gclid |
僅供輸出。Google 點擊編號。 |
pageNumber |
僅供輸出。刊登廣告的搜尋結果頁碼。 |
adGroupAd |
僅供輸出。關聯的廣告。 |
campaignLocationTarget |
僅供輸出。相關的廣告活動指定地區 (如果有的話)。 |
userList |
僅供輸出。相關的使用者名單 (如果有的話)。 |
ClickLocation
與點擊相關的地區條件。
JSON 表示法 |
---|
{ "city": string, "country": string, "metro": string, "mostSpecific": string, "region": string } |
欄位 | |
---|---|
city |
與曝光相關聯的城市位置條件。 |
country |
與曝光相關的國家/地區位置條件。 |
metro |
與曝光相關的都會區位置條件。 |
mostSpecific |
與曝光相關聯的最明確地區條件。 |
region |
與曝光相關聯的區域位置條件。 |
CurrencyConstant
貨幣常數。
JSON 表示法 |
---|
{ "resourceName": string, "code": string, "name": string, "symbol": string, "billableUnitMicros": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。貨幣常數的資源名稱。貨幣常數資源名稱的格式如下:
|
code |
僅供輸出。ISO 4217 三字母貨幣代碼,例如「USD」 |
name |
僅供輸出。貨幣的完整英文名稱。 |
symbol |
僅供輸出。表示這種貨幣的標準符號,例如「$」代表美元。 |
billableUnitMicros |
僅供輸出。此貨幣的計費單位。帳單金額應為這個值的倍數。 |
AccessibleBiddingStrategy
代表客戶擁有並與其共用的出價策略檢視畫面。
相較於出價策略,這項資源包括客戶管理員所擁有的策略,以及與客戶的共用策略,以及客戶擁有的策略。這項資源不提供指標,且隻公開一部分的出價策略屬性。
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "name": string, "type": enum ( |
欄位 | |
---|---|
resourceName |
僅供輸出。可存取出價策略的資源名稱。AccessibleBiddingStrategy 資源名稱的格式如下:
|
id |
僅供輸出。出價策略的 ID。 |
name |
僅供輸出。出價策略的名稱。 |
type |
僅供輸出。出價策略的類型。 |
ownerCustomerId |
僅供輸出。出價策略擁有者的客戶 ID。 |
ownerDescriptiveName |
僅供輸出。出價策略擁有者的描述性名稱。 |
聯集欄位 只能設定其中一項。 |
|
maximizeConversionValue |
僅供輸出。自動出價策略會以您的預算為廣告活動爭取最大轉換價值, |
maximizeConversions |
僅供輸出。一種自動出價策略,用您的預算為廣告活動爭取最多轉換。 |
targetCpa |
僅供輸出。這項出價策略會按照您指定的目標單次轉換出價盡量爭取轉換。 |
targetImpressionShare |
僅供輸出。會自動最佳化指定百分比曝光的出價策略。 |
targetRoas |
僅供輸出。這個出價策略會在平均分配特定目標廣告投資報酬率,協助您爭取最高收益。 |
targetSpend |
僅供輸出。這項出價策略會設定出價,在預算範圍內盡量爭取點擊。 |
MaximizeConversionValue
自動出價策略會以您的預算為廣告活動爭取最大轉換價值,
JSON 表示法 |
---|
{ "targetRoas": number } |
欄位 | |
---|---|
targetRoas |
僅供輸出。目標廣告投資報酬率選項。如果設定這項參數,出價策略會盡可能提高收益,同時平均地設定目標廣告投資報酬率。如果目標廣告投資報酬率偏高,出價策略可能無法用完整筆預算。如未設定目標廣告投資報酬率,出價策略會在預算範圍內盡可能達成最高廣告投資報酬率。 |
MaximizeConversions
一種自動出價策略,用您的預算為廣告活動爭取最多轉換。
JSON 表示法 |
---|
{ "targetCpaMicros": string } |
欄位 | |
---|---|
targetCpaMicros |
僅供輸出。目標單次轉換出價選項。這是指您願意為每次轉換支付的平均金額。 |
TargetCpa
「目標單次轉換出價」是一種自動出價策略,可按照您指定的目標單次轉換出價盡量爭取轉換。
JSON 表示法 |
---|
{ "targetCpaMicros": string } |
欄位 | |
---|---|
targetCpaMicros |
僅供輸出。平均單次轉換出價目標。這個指定目標必須大於或等於最低計費單位 (以帳戶幣別為準)。 |
TargetRoas
這是一種自動出價策略,可協助您提高收益,同時平均分配特定的目標廣告投資報酬率。
JSON 表示法 |
---|
{ "targetRoas": number } |
欄位 | |
---|---|
targetRoas |
僅供輸出。每單位支出的所選收益 (根據轉換資料)。 |
TargetSpend
「自動出價策略」會自動設定出價,在預算範圍內盡量爭取點擊。
JSON 表示法 |
---|
{ "targetSpendMicros": string, "cpcBidCeilingMicros": string } |
欄位 | |
---|---|
targetSpendMicros |
僅供輸出。盡量爭取點擊的支出目標。目標支出出價工具會嘗試支出這個值中較小的值或自然調節支出金額。如果未指定,則會使用預算做為支出目標。這個欄位已淘汰,不應再使用。詳情請參閱 https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html。 |
cpcBidCeilingMicros |
僅供輸出。出價策略可設定的出價上限。這項限制會套用至策略管理的所有關鍵字。 |
CustomerClient
指定客戶與客戶客戶之間的連結。只有管理員客戶能找到 CustomerClient。包含所有直接和間接客戶,以及管理員本身。
JSON 表示法 |
---|
{
"resourceName": string,
"appliedLabels": [
string
],
"status": enum ( |
欄位 | |
---|---|
resourceName |
僅供輸出。客戶用戶端的資源名稱。CustomerClient 資源名稱的格式如下: |
appliedLabels[] |
僅供輸出。提出要求的客戶所擁有的標籤資源名稱,該標籤將套用至客戶客戶。標籤資源名稱的格式如下:
|
status |
僅供輸出。客戶客戶的狀態。唯讀。 |
clientCustomer |
僅供輸出。與客戶連結的客戶資源名稱。唯讀。 |
level |
僅供輸出。指定客戶和客戶之間的距離。如為自我連結,層級值會是 0。唯讀。 |
timeZone |
僅供輸出。用戶端時區的常見語言代碼資料存放區 (CLDR) 字串,例如 America/Los_Angeles。唯讀。 |
testAccount |
僅供輸出。識別客戶是否為測試帳戶。唯讀。 |
manager |
僅供輸出。指出客戶是否為管理員。唯讀。 |
descriptiveName |
僅供輸出。客戶的描述性名稱。唯讀。 |
currencyCode |
僅供輸出。客戶的幣別代碼,例如「USD」、「EUR」。唯讀。 |
id |
僅供輸出。客戶的 ID。唯讀。 |
CustomerSearchTermInsight
客戶搜尋字詞檢視。歷來資料從 2023 年 3 月起開始提供。
JSON 表示法 |
---|
{ "resourceName": string, "categoryLabel": string, "id": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。客戶層級搜尋字詞洞察的資源名稱。客戶層級搜尋字詞洞察資源名稱的格式如下:
|
categoryLabel |
僅供輸出。搜尋類別的標籤。如果搜尋字詞不符合其他類別,就會表示屬於「全部接收」類別。 |
id |
僅供輸出。深入分析的 ID。 |
DetailPlacementView
包含依廣告群組和網址或 YouTube 影片匯總指標的資料檢視。
JSON 表示法 |
---|
{
"resourceName": string,
"placementType": enum ( |
欄位 | |
---|---|
resourceName |
僅供輸出。詳細資料位置檢視畫面的資源名稱。詳細資料刊登位置檢視表資源名稱的格式如下所示:
|
placementType |
僅供輸出。刊登位置的類型,例如網站、YouTube 影片和行動應用程式。 |
placement |
僅供輸出。詳細資料層級的自動刊登位置字串,例如網站網址、行動應用程式 ID 或 YouTube 影片 ID。 |
displayName |
僅供輸出。顯示名稱為網站的網址、YouTube 影片名稱,以及行動應用程式的翻譯行動應用程式名稱。 |
groupPlacementTargetUrl |
僅供輸出。群組刊登位置的網址 (例如網域、應用程式商店中的行動應用程式連結) 或 YouTube 頻道網址。 |
targetUrl |
僅供輸出。刊登位置的網址 (例如網站)、應用程式商店中的行動應用程式連結,或 YouTube 影片網址。 |
PlacementType
動態饋給對應的可能刊登位置類型。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
WEBSITE |
網站(例如「www.flowers4sale.com」)。 |
MOBILE_APP_CATEGORY |
行動應用程式類別(例如「遊戲」)。 |
MOBILE_APPLICATION |
行動應用程式(例如「mobileapp::2-com.whatsthewordanswers」) |
YOUTUBE_VIDEO |
YouTube 影片(例如「youtube.com/video/wtLJPvx7-ys」)。 |
YOUTUBE_CHANNEL |
YouTube 頻道(例如「youtube.com::L8ZULXASCc1I_oaOT0NaOQ」)。 |
GOOGLE_PRODUCTS |
Google 自有自營的途徑(例如「tv.google.com」)。 |
DetailedDemographic
詳細客層:一種按照興趣鎖定的產業,可用來根據長期生活資料觸及使用者。
JSON 表示法 |
---|
{
"resourceName": string,
"id": string,
"name": string,
"parent": string,
"launchedToAll": boolean,
"availabilities": [
{
object ( |
欄位 | |
---|---|
resourceName |
僅供輸出。詳細客層的資源名稱。詳細客層資源名稱的格式如下:
|
id |
僅供輸出。詳細客層的 ID。 |
name |
僅供輸出。詳細客層的名稱。例如:最高教育程度 |
parent |
僅供輸出。詳細客層的父項。 |
launchedToAll |
僅供輸出。如果詳細客層已適用於所有管道和語言代碼,則為 True。 |
availabilities[] |
僅供輸出。詳細客層的供應情形資訊。 |
CriterionCategoryAvailability
每個廣告管道的類別可用性資訊。
JSON 表示法 |
---|
{ "channel": { object ( |
欄位 | |
---|---|
channel |
該類別可用的頻道類型和子類型。 |
locale[] |
可供頻道類別使用的語言代碼。 |
CriterionCategoryChannelAvailability
可用的類別廣告管道類型和子類型資訊。
JSON 表示法 |
---|
{ "availabilityMode": enum ( |
欄位 | |
---|---|
availabilityMode |
通路適用格式。可以是 ALL_CHANNELS (其餘欄位未經設定)、CHANNEL_TYPE (只會設定 adChannelType 類型,此類別可供其底下的所有子類型使用) 或 CHANNEL_TYPE_AND_SUBTYPES (全部設定 adsChannelType、advertisingChannelSubType 和 includeDefaultChannelSubType)。 |
advertisingChannelType |
類別適用的頻道類型。 |
advertisingChannelSubType[] |
該類別適用的頻道類型下的頻道子類型。 |
includeDefaultChannelSubType |
是否包含預設管道子類型。舉例來說,如果 advertisingChannelType 為「DISPLAY」,且 includeDefaultChannelSubType 為「false」,代表有未設定管道子類型的預設多媒體廣告活動,就不會納入這項供應情形設定中。 |
CriterionCategoryChannelAvailabilityMode
列舉包含可能的 CriterionCategoryChannelAvailabilityMode。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
ALL_CHANNELS |
類別適用於所有管道類型和子類型的廣告活動。 |
CHANNEL_TYPE_AND_ALL_SUBTYPES |
類別適用於特定管道類型的廣告活動,包括該類別之下的所有子類型。 |
CHANNEL_TYPE_AND_SUBSET_SUBTYPES |
類別適用於特定管道類型和子類型的廣告活動。 |
CriterionCategoryLocaleAvailability
特定類別適用的地區資訊。
JSON 表示法 |
---|
{
"availabilityMode": enum ( |
欄位 | |
---|---|
availabilityMode |
地區供應情形的格式。可以是 LAUNCHED_TO_ALL (國家/地區和語言皆為空白)、COUNTRY (僅設定國家/地區)、LANGUAGE (僅設定語言)、COUNTRY_AND_LANGUAGE (設定國家/地區和語言)。 |
countryCode |
與類別相關聯的 ISO-3166-1 alpha-2 國家/地區代碼。 |
languageCode |
類別相關語言的 ISO 639-1 代碼。 |
CriterionCategoryLocaleAvailabilityMode
列舉包含可能的 CriterionCategoryLocaleAvailabilityMode 的列舉。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
ALL_LOCALES |
該類別適用於所有語言代碼的廣告活動。 |
COUNTRY_AND_ALL_LANGUAGES |
類別適用於要列於國家/地區清單中的廣告活動,不論語言為何。 |
LANGUAGE_AND_ALL_COUNTRIES |
類別適用於採用語言清單內的廣告活動,不考慮國家/地區。 |
COUNTRY_AND_LANGUAGE |
類別適用於位於國家/地區與語言組合清單中的廣告活動。 |
DisplayKeywordView
多媒體廣告關鍵字檢視畫面。
JSON 表示法 |
---|
{ "resourceName": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。多媒體廣告關鍵字檢視畫面的資源名稱。多媒體廣告關鍵字檢視資源名稱的格式如下:
|
DistanceView
距離檢視畫面,根據使用者與廣告客戶地點額外資訊之間的距離,顯示匯總相關指標。每個 DistanceBucket 會納入所有落在距離內,且每次曝光一次曝光,都會計入包含使用者距離的所有 DistanceBucket 指標中。
JSON 表示法 |
---|
{
"resourceName": string,
"distanceBucket": enum ( |
欄位 | |
---|---|
resourceName |
僅供輸出。距離檢視畫面的資源名稱。距離檢視資源名稱的格式如下:
|
distanceBucket |
僅供輸出。使用者與地點額外資訊之間的距離分組。 |
metricSystem |
僅供輸出。如果 DistanceBucket 使用的是公制系統,則為 True,否則為 false。 |
DistanceBucket
使用者與廣告客戶地點額外資訊之間的距離區間。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
WITHIN_700M |
使用者位於該地區 700 公尺以內。 |
WITHIN_1KM |
使用者位於該地點 1 公里內。 |
WITHIN_5KM |
使用者位於該地點 5 公里內。 |
WITHIN_10KM |
使用者位於該地點 10 公里內。 |
WITHIN_15KM |
使用者位於該地點 1.5 公里內。 |
WITHIN_20KM |
使用者位於該地點 20 公里內。 |
WITHIN_25KM |
使用者位於該地點 2.5 公里內。 |
WITHIN_30KM |
使用者位於該地點 30,000 以內。 |
WITHIN_35KM |
使用者位於該地點 3.5 公里內。 |
WITHIN_40KM |
使用者位於該地點 40 公里內。 |
WITHIN_45KM |
使用者位於該地點 45 公里內。 |
WITHIN_50KM |
使用者位於該地點 50 公里內。 |
WITHIN_55KM |
使用者位於該地點 5.5 公里內。 |
WITHIN_60KM |
使用者位於該地點 60 公里內。 |
WITHIN_65KM |
使用者位於該地點 65 公里內。 |
BEYOND_65KM |
使用者超過了地點的 6.5 公里。 |
WITHIN_0_7MILES |
使用者位於該地點 0.7 英里內。 |
WITHIN_1MILE |
使用者位於該地點 1 英里內。 |
WITHIN_5MILES |
使用者距離該地點 5 英里內。 |
WITHIN_10MILES |
使用者位於該地點 10 英里內。 |
WITHIN_15MILES |
使用者距離該地點 15 英里內。 |
WITHIN_20MILES |
距離該地 20 英里內的使用者。 |
WITHIN_25MILES |
使用者距離該地點 25 英里內。 |
WITHIN_30MILES |
距離該地 30 英里內的使用者。 |
WITHIN_35MILES |
使用者距離該地點 35 英里內。 |
WITHIN_40MILES |
使用者位於該地點 40 英里內。 |
BEYOND_40MILES |
使用者距離該地點超過 40 英里。 |
DynamicSearchAdsSearchTermView
動態搜尋廣告搜尋字詞檢視畫面。
JSON 表示法 |
---|
{ "resourceName": string, "searchTerm": string, "headline": string, "landingPage": string, "pageUrl": string, "hasNegativeKeyword": boolean, "hasMatchingKeyword": boolean, "hasNegativeUrl": boolean } |
欄位 | |
---|---|
resourceName |
僅供輸出。動態搜尋廣告搜尋字詞檢視畫面的資源名稱。動態搜尋廣告搜尋字詞檢視資源名稱的格式如下:
|
searchTerm |
僅供輸出。搜尋字詞 這是唯讀欄位。 |
headline |
僅供輸出。動態產生的動態搜尋廣告標題。 這是唯讀欄位。 |
landingPage |
僅供輸出。曝光時動態選取的到達網頁網址。 這是唯讀欄位。 |
pageUrl |
僅供輸出。針對曝光放送的網頁動態饋給項目網址。 這是唯讀欄位。 |
hasNegativeKeyword |
僅供輸出。如果查詢與排除關鍵字相符,則為 True。 這是唯讀欄位。 |
hasMatchingKeyword |
僅供輸出。如果將查詢新增至目標關鍵字,則為 True。 這是唯讀欄位。 |
hasNegativeUrl |
僅供輸出。如果查詢與排除網址相符,則為 True。 這是唯讀欄位。 |
ExpandedLandingPageView
到達網頁檢視畫面,內含在延展型最終到達網址層級匯總的指標。
JSON 表示法 |
---|
{ "resourceName": string, "expandedFinalUrl": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。展開到達網頁檢視畫面的資源名稱。延展型到達網頁檢視資源名稱的格式如下:
|
expandedFinalUrl |
僅供輸出。點擊後會導向的最終到達網址。 |
FeedPlaceholderView
動態饋給預留位置檢視畫面。
JSON 表示法 |
---|
{
"resourceName": string,
"placeholderType": enum ( |
欄位 | |
---|---|
resourceName |
僅供輸出。動態饋給預留位置檢視畫面的資源名稱。動態饋給預留位置檢視畫面資源名稱的格式如下:
|
placeholderType |
僅供輸出。動態饋給預留位置檢視畫面的預留位置類型。 |
GenderView
性別檢視。genderView 資源反映的是有效放送狀態,而非新增的條件。在預設情況下,未設有性別條件的廣告群組會向所有性別顯示,因此所有性別都會顯示在 genderView 中並附上統計資料。
JSON 表示法 |
---|
{ "resourceName": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。性別檢視的資源名稱。性別檢視資源名稱的格式如下:
|
GeographicView
地理區域檢視。
「地理區域檢視」會列出國家/地區層級匯總的所有指標,每個國家/地區一列。記錄使用者的實際位置或感興趣的區域的指標。如果使用了其他區隔欄位,每個國家/地區的資料可能不只一列。
JSON 表示法 |
---|
{
"resourceName": string,
"locationType": enum ( |
欄位 | |
---|---|
resourceName |
僅供輸出。地理區域檢視的資源名稱。地理檢視表資源名稱的格式如下:
|
locationType |
僅供輸出。廣告活動的指定地理區域類型。 |
countryCriterionId |
僅供輸出。國家/地區的條件 ID。 |
GeoTargetingType
可能的指定地理區域類型。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
這個版本無法辨識這個值。 |
AREA_OF_INTEREST |
使用者在查詢時感興趣的位置。 |
LOCATION_OF_PRESENCE |
發出查詢的使用者位置。 |
GroupPlacementView
群組刊登位置檢視畫面。
JSON 表示法 |
---|
{
"resourceName": string,
"placementType": enum ( |
欄位 | |
---|---|
resourceName |
僅供輸出。群組刊登位置檢視畫面的資源名稱。群組刊登位置檢視畫面資源名稱的格式如下:
|
placementType |
僅供輸出。刊登位置的類型,例如網站、YouTube 頻道、行動應用程式。 |
placement |
僅供輸出。群組層級的自動刊登位置字串,例如網域、行動應用程式 ID 或 YouTube 頻道 ID。 |
displayName |
僅供輸出。網站的網域名稱,YouTube 頻道的 YouTube 頻道名稱。 |
targetUrl |
僅供輸出。群組刊登位置的網址 (例如網域、應用程式商店中的行動應用程式連結) 或 YouTube 頻道網址。 |
HotelGroupView
飯店群組檢視畫面。
JSON 表示法 |
---|
{ "resourceName": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。飯店群組檢視畫面的資源名稱。飯店群組檢視畫面資源名稱的格式如下:
|
HotelPerformanceView
飯店成效檢視畫面。
JSON 表示法 |
---|
{ "resourceName": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。飯店成效檢視畫面的資源名稱。飯店成效檢視畫面資源名稱的格式如下:
|
HotelReconciliation
飯店對帳。內含飯店預訂轉換資訊,以便與廣告客戶記錄核對。使用大量上傳功能產生帳單前,這些資料列可更新或取消。
JSON 表示法 |
---|
{
"resourceName": string,
"commissionId": string,
"orderId": string,
"campaign": string,
"hotelCenterId": string,
"hotelId": string,
"checkInDate": string,
"checkOutDate": string,
"reconciledValueMicros": string,
"billed": boolean,
"status": enum ( |
欄位 | |
---|---|
resourceName |
不可變動。飯店對帳的資源名稱。飯店對帳資源名稱的格式如下:
|
commissionId |
必要欄位。僅供輸出。佣金 ID 是 Google 為這筆預訂提供的 ID。系統會為每個預訂事件指派一個佣金 ID,方便您進行房客入住比對。 |
orderId |
僅供輸出。訂單 ID 是這筆預訂的 ID,如同轉換追蹤代碼的「transaction_id」參數所提供的一樣。 |
campaign |
僅供輸出。與轉換相關聯的廣告活動資源名稱。 |
hotelCenterId |
僅供輸出。提供飯店廣告活動房價的 Hotel Center 帳戶 ID。 |
hotelId |
僅供輸出。預訂房源的專屬 ID,與 Hotel Center 動態饋給提供的 ID 相同。飯店 ID 來自轉換追蹤代碼的「ID」參數。 |
checkInDate |
僅供輸出。在訂票時記錄入住日期。如果在對帳時修改入住日期,修訂後的日期則會取代這一欄中的原始日期。格式為 YYYY-MM-DD。 |
checkOutDate |
僅供輸出。在預訂時記錄退房日期。如果在對帳時修改入住日期,修訂後的日期則會取代這一欄中的原始日期。格式為 YYYY-MM-DD。 |
reconciledValueMicros |
必要欄位。僅供輸出。已對帳金額是指房客支付的最終訂房金額。如果原始訂房價值因任何原因 (例如行程異動或升級銷售客房) 而改變,則已對帳金額應為收取的全部最終金額。如果預訂取消,已對帳金額應包含任何取消費或無法退款的住宿費用。這個值以基本單位貨幣的百萬分之一表示。舉例來說,$12.35 美元會以 12350000 表示。貨幣單位是以客戶的預設幣別計算。 |
billed |
僅供輸出。是否已結算特定預訂費用。結算完成後就無法修改預訂。 |
status |
必要欄位。僅供輸出。與對帳和帳單相關的預訂狀態。預訂費用必須在退房日期算起 45 天內完成對帳。凡是未在 45 天內對帳完畢的預訂都會以原價收費。 |
HotelReconciliationStatus
飯店預訂對帳狀態。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
這個版本無法辨識這個值。 |
RESERVATION_ENABLED |
預訂的時間是未來的日期,或旅客已入住但尚未超過退房日期。無法針對仍然有效的預訂進行對帳。 |
RECONCILIATION_NEEDED |
旅客已退房,或是已超過預訂日期但旅客並未取消。凡是沒有在退房日期算起 45 天內對帳完畢的預訂,都會依據原預訂價格收費。 |
RECONCILED |
這些預訂已對帳。完成對帳的預訂費用會在退房日期算起 45 天後收取。 |
CANCELED |
這項預訂已標記為取消。若取消入住的值大於零 (因設有最低住宿日數規定或取消費用),會在退房日期算起 45 天後收費。 |
IncomeRangeView
收入範圍檢視。
JSON 表示法 |
---|
{ "resourceName": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。收入範圍檢視畫面的資源名稱。收入範圍檢視資源名稱的格式如下:
|
KeywordView
關鍵字檢視。
JSON 表示法 |
---|
{ "resourceName": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。關鍵字檢視畫面的資源名稱。關鍵字檢視資源名稱的格式如下:
|
LandingPageView
到達網頁檢視畫面,含有未展開最終到達網址層級匯總的指標。
JSON 表示法 |
---|
{ "resourceName": string, "unexpandedFinalUrl": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。到達網頁檢視的資源名稱。到達網頁檢視資源名稱的格式如下:
|
unexpandedFinalUrl |
僅供輸出。廣告客戶指定的最終到達網址。 |
LanguageConstant
語言。
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "code": string, "name": string, "targetable": boolean } |
欄位 | |
---|---|
resourceName |
僅供輸出。語言常數的資源名稱。語言常數資源名稱的格式如下:
|
id |
僅供輸出。語言常數 ID。 |
code |
僅供輸出。語言代碼,例如「en_US」、「en_AU」、「es」、「fr」等等。 |
name |
僅供輸出。英文的完整語言名稱,例如「英文 (US)、西班牙文」等。 |
targetable |
僅供輸出。是否可指定該語言。 |
LocationView
地區檢視會按地區條件顯示廣告活動的成效摘要。如未設定 Location 條件,則不會傳回任何結果;請改用 GeoView 或 userLocationView 取得訪客位置資料。
JSON 表示法 |
---|
{ "resourceName": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。位置檢視的資源名稱。位置檢視畫面資源名稱的格式如下:
|
ManagedPlacementView
自選刊登位置檢視畫面。
JSON 表示法 |
---|
{ "resourceName": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。自選刊登位置檢視畫面的資源名稱。自選刊登位置檢視畫面資源名稱的格式如下:
|
MediaFile
媒體檔案。
JSON 表示法 |
---|
{ "resourceName": string, "type": enum ( |
欄位 | |
---|---|
resourceName |
不可變動。媒體檔案的資源名稱。媒體檔案資源名稱的格式如下:
|
type |
不可變動。媒體檔案類型。 |
mimeType |
僅供輸出。媒體檔案的 MIME 類型。 |
id |
僅供輸出。媒體檔案的 ID。 |
sourceUrl |
不可變動。原始媒體檔案的下載位置網址 (或檔案名稱)。只用於音訊和圖片類型的媒體。 |
name |
不可變動。媒體檔案名稱。用戶端可使用此名稱來識別先前上傳的媒體。 |
fileSize |
僅供輸出。媒體檔案大小,以位元組為單位。 |
聯集欄位 mediatype 。媒體檔案的特定類型。mediatype 只能是下列其中一項: |
|
image |
不可變動。封裝圖片。 |
mediaBundle |
不可變動。ZIP 封存檔,其中內容包含 HTML5 素材資源。 |
audio |
僅供輸出。封裝音訊。 |
video |
不可變動。封裝影片。 |
MediaType
媒體類型。
列舉 | |
---|---|
UNSPECIFIED |
尚未指定媒體類型。 |
UNKNOWN |
這個版本無法得知接收到的值。 這個值僅供回應使用。 |
IMAGE |
用於圖像廣告的靜態圖片。 |
ICON |
用於地圖廣告的小型圖片。 |
MEDIA_BUNDLE |
ZIP 檔案,用於範本廣告的欄位。 |
AUDIO |
音訊檔案。 |
VIDEO |
影片檔案。 |
DYNAMIC_IMAGE |
動畫圖片,例如 GIF 動畫。 |
MediaImage
封裝圖片。
JSON 表示法 |
---|
{ "data": string, "fullSizeImageUrl": string, "previewSizeImageUrl": string } |
欄位 | |
---|---|
data |
不可變動。原始圖片資料。 Base64 編碼的字串。 |
fullSizeImageUrl |
僅供輸出。圖片完整尺寸版本的網址。 |
previewSizeImageUrl |
僅供輸出。圖片預覽大小版本的網址。 |
MediaBundle
代表內含 HTML5 素材資源內容的 ZIP 封存媒體。
JSON 表示法 |
---|
{ "data": string, "url": string } |
欄位 | |
---|---|
data |
不可變動。原始壓縮資料。 Base64 編碼的字串。 |
url |
僅供輸出。用來存取已上傳壓縮資料的網址。例如:https://tpc.googlesyndication.com/simgad/123。這個欄位處於唯讀狀態。 |
MediaAudio
封裝音訊。
JSON 表示法 |
---|
{ "adDurationMillis": string } |
欄位 | |
---|---|
adDurationMillis |
僅供輸出。音訊的時間長度 (以毫秒為單位)。 |
MediaVideo
封裝影片。
JSON 表示法 |
---|
{ "adDurationMillis": string, "youtubeVideoId": string, "advertisingIdCode": string, "isciCode": string } |
欄位 | |
---|---|
adDurationMillis |
僅供輸出。影片的時間長度 (以毫秒為單位)。 |
youtubeVideoId |
不可變動。YouTube 影片 ID (如 YouTube 網址所示)。只要在這個 ID 中加入前置字串「https://www.youtube.com/watch?v=」,就能取得這部影片的 YouTube 串流網址。 |
advertisingIdCode |
僅供輸出。此影片的廣告數位識別代碼 (由美國廣告代理商協會所定義),主要用於電視廣告。 |
isciCode |
僅供輸出。此影片的業界標準商業識別碼 (Industry Standard Commercial Identifier) 代碼,主要用於電視廣告。 |
LocalServicesEmployee
在地生活服務員工資源。
JSON 表示法 |
---|
{ "resourceName": string, "creationDateTime": string, "status": enum ( |
欄位 | |
---|---|
resourceName |
不可變動。在地生活服務驗證的資源名稱。在地生活服務驗證資源名稱的格式如下:
|
creationDateTime |
僅供輸出。員工建立作業的時間戳記。格式為「YYYY-MM-DD HH:MM:SS」,以 Google Ads 帳戶的時區為準。範例:「2018-03-05 09:15:00」或「2018-02-01 14:34:30」 |
status |
僅供輸出。員工狀態,例如「已刪除」或「已啟用」。 |
type |
僅供輸出。員工類型。 |
universityDegrees[] |
僅供輸出。這名員工已取得並想要呈現的程度列表。 |
residencies[] |
僅供輸出。員工已完成居住的機構。 |
fellowships[] |
僅供輸出。該員工已完成補助的機構。 |
languagesSpoken[] |
僅供輸出。員工使用的語言標記,以下列語言標記表示:https://developers.google.com/admin-sdk/directory/v1/languages |
categoryIds[] |
僅供輸出。員工的類別。如需在地生活服務類別 ID 清單,請參閱 https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids。 |
id |
僅供輸出。員工的 ID。 |
jobTitle |
僅供輸出。這名員工的職稱,例如「資深合作夥伴」法律產業。 |
yearStartedPracticing |
僅供輸出。這名員工開始在這個領域練習的年份。 |
nationalProviderIdNumber |
僅供輸出。與員工相關聯的 NPI ID。 |
emailAddress |
僅供輸出。員工的電子郵件地址。 |
firstName |
僅供輸出。員工的名字。 |
middleName |
僅供輸出。員工的中間姓名。 |
lastName |
僅供輸出。員工的姓氏。 |
LocalServicesEmployeeStatus
列舉描述在地生活服務員工的狀態。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
ENABLED |
員工未遭移除,而且員工狀態為已啟用。 |
REMOVED |
員工已移除。用來從商家中刪除員工。 |
LocalServicesEmployeeType
描述在地生活服務員工類型的列舉,
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
BUSINESS_OWNER |
代表商家的擁有者。 |
EMPLOYEE |
代表商家的員工。 |
UniversityDegree
這名員工已取得並想要呈現的程度列表。
JSON 表示法 |
---|
{ "institutionName": string, "degree": string, "graduationYear": integer } |
欄位 | |
---|---|
institutionName |
僅供輸出。取得學位的大學名稱。 |
degree |
僅供輸出。取得的學位名稱。 |
graduationYear |
僅供輸出。畢業年份。 |
居住地資訊
員工的醫療居住地詳細資料。落地學是畢業生醫學教育的一個階段,由合格的醫療專業人員在資深臨床醫師的監督下執行。
JSON 表示法 |
---|
{ "institutionName": string, "completionYear": integer } |
欄位 | |
---|---|
institutionName |
僅供輸出。完成居住機構的名稱。 |
completionYear |
僅供輸出。完成年。 |
小鳥
關於員工的醫療資助計畫的詳細資訊。資助是指專業人士在完成居住地後進行的醫療訓練期間。
JSON 表示法 |
---|
{ "institutionName": string, "completionYear": integer } |
欄位 | |
---|---|
institutionName |
僅供輸出。您完成夥伴的任職名稱。 |
completionYear |
僅供輸出。完成年。 |
LocalServicesVerificationArtifact
在地生活服務驗證資源。
JSON 表示法 |
---|
{ "resourceName": string, "creationDateTime": string, "status": enum ( |
欄位 | |
---|---|
resourceName |
不可變動。在地生活服務驗證的資源名稱。在地生活服務驗證資源名稱的格式如下:
|
creationDateTime |
僅供輸出。這個驗證構件的建立時間戳記。格式為「YYYY-MM-DD HH:MM:SS」,以 Google Ads 帳戶的時區為準。範例:「2018-03-05 09:15:00」或「2018-02-01 14:34:30」 |
status |
僅供輸出。驗證構件的狀態。 |
artifactType |
僅供輸出。驗證構件的類型。 |
id |
僅供輸出。驗證構件的 ID。 |
聯集欄位 artifact_data 。驗證資訊類型。artifact_data 只能採用下列其中一種設定: |
|
backgroundCheckVerificationArtifact |
僅供輸出。背景調查驗證成果。 |
insuranceVerificationArtifact |
僅供輸出。保險驗證構件。 |
licenseVerificationArtifact |
僅供輸出。授權驗證成果。 |
businessRegistrationCheckVerificationArtifact |
僅供輸出。商業登記檢查驗證成果。 |
LocalServicesVerificationArtifactStatus
說明在地生活服務驗證成果的狀態列舉項目。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
PASSED |
構件已通過驗證, |
FAILED |
無法驗證構件。 |
PENDING |
正在驗證構件。 |
NO_SUBMISSION |
構件需要使用者在驗證相關資訊前上傳資訊。 |
CANCELLED |
使用者已取消構件。 |
LocalServicesVerificationArtifactType
說明可能的在地生活服務驗證成果類型,以列舉表示。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
BACKGROUND_CHECK |
背景檢查驗證成果。 |
INSURANCE |
保險驗證成果。 |
LICENSE |
授權驗證構件。 |
BUSINESS_REGISTRATION_CHECK |
商家登記檢查驗證成果。 |
BackgroundCheckVerificationArtifact
專門保存在地生活服務背景調查資訊的 proto。
JSON 表示法 |
---|
{ "caseUrl": string, "finalAdjudicationDateTime": string } |
欄位 | |
---|---|
caseUrl |
僅供輸出。存取背景大小寫的網址。 |
finalAdjudicationDateTime |
僅供輸出。這項背景調查案例結果判定的時間戳記。格式為「YYYY-MM-DD HH:MM:SS」,以 Google Ads 帳戶的時區為準。範例:「2018-03-05 09:15:00」或「2018-02-01 14:34:30」 |
InsuranceVerificationArtifact
儲存當地服務保險相關資訊的原型。
JSON 表示法 |
---|
{ "amountMicros": string, "rejectionReason": enum ( |
欄位 | |
---|---|
amountMicros |
僅供輸出。保險金額。以保險文件中所提及的貨幣「微量」計算。 |
rejectionReason |
僅供輸出。保險文件拒絕的原因。 |
insuranceDocumentReadonly |
僅供輸出。唯讀欄位,內含已上傳保險文件的資訊。 |
LocalServicesInsuranceRejectionReason
說明本地服務保險驗證構件可能遭拒的原因,以列舉說明。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
BUSINESS_NAME_MISMATCH |
商家名稱與在地生活服務廣告的商家名稱不符。 |
INSURANCE_AMOUNT_INSUFFICIENT |
保險金額不符合該地理區域 + 類別 ID 組合的法律摘要說明文件所列的規定。 |
EXPIRED |
保險文件已過期, |
NO_SIGNATURE |
保險文件缺少簽名。 |
NO_POLICY_NUMBER |
保險文件缺少保單號碼。 |
NO_COMMERCIAL_GENERAL_LIABILITY |
商業一般責任(CGL) 包裝盒未在保險文件中標示。 |
EDITABLE_FORMAT |
保險文件採用可編輯的格式。 |
CATEGORY_MISMATCH |
保險文件不涵蓋特定類別的保險。 |
MISSING_EXPIRATION_DATE |
保險文件缺少到期日。 |
POOR_QUALITY |
保險文件品質不佳 (圖像模糊、難以辨識等) |
POTENTIALLY_EDITED |
保險文件疑似遭到編輯。 |
WRONG_DOCUMENT_TYPE |
不接受保險文件。例如,我們不接受未投保的保險提案文件。 |
NON_FINAL |
保險文件並非最終文件。 |
OTHER |
保險文件有其他未明確列出的瑕疵。 |
LocalServicesDocumentReadOnly
包含唯讀存取資料的在地生活服務文件。
JSON 表示法 |
---|
{ "documentUrl": string } |
欄位 | |
---|---|
documentUrl |
用於存取已上傳「在地生活服務」文件的網址。 |
LicenseVerificationArtifact
保留在地生活服務授權相關資訊的原型。
JSON 表示法 |
---|
{ "licenseType": string, "licenseNumber": string, "licenseeFirstName": string, "licenseeLastName": string, "rejectionReason": enum ( |
欄位 | |
---|---|
licenseType |
僅供輸出。授權類型 / 名稱。 |
licenseNumber |
僅供輸出。執照號碼。 |
licenseeFirstName |
僅供輸出。被授權人的名字。 |
licenseeLastName |
僅供輸出。被授權人的姓氏。 |
rejectionReason |
僅供輸出。授權遭拒原因。 |
licenseDocumentReadonly |
僅供輸出。唯讀欄位,內含已上傳執照文件的資訊。 |
LocalServicesLicenseRejectionReason
舉例說明在地生活服務授權驗證成果可能會遭拒的原因。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
BUSINESS_NAME_MISMATCH |
商家名稱與在地生活服務廣告的商家名稱不符。 |
UNAUTHORIZED |
授權未經授權或遭到撤銷。 |
EXPIRED |
授權已過期。 |
POOR_QUALITY |
授權品質不佳 - 圖片模糊不清、難以辨識等 |
UNVERIFIABLE |
由於圖像無效,因此無法驗證授權。 |
WRONG_DOCUMENT_OR_ID |
執照與要求的文件類型不符,或是包含無效的 ID。 |
OTHER |
授權有其他未明確列出的瑕疵。 |
BusinessRegistrationCheckVerificationArtifact
專門保存在地生活服務公司登記檢查資訊的原型。
JSON 表示法 |
---|
{ "registrationType": enum ( |
欄位 | |
---|---|
registrationType |
僅供輸出。商業登記支票的類型 (號碼、文件)。 |
checkId |
僅供輸出。支票 ID,例如 vat_tax_id,代表「加值稅稅號」的規定。 |
rejectionReason |
僅供輸出。登記文件拒絕原因。 |
聯集欄位 business_registration 。商業登記證明文件的註冊資訊。請根據不同國家/地區的規定,使用這份表單填寫以下任一表單。business_registration 只能是下列其中一項: |
|
registrationNumber |
僅供輸出。儲存商家政府核發號碼的訊息。 |
registrationDocument |
僅供輸出。儲存商家文件資訊的訊息。 |
LocalServicesBusinessRegistrationType
描述在地生活服務公司登記驗證驗證成果的可能註冊類型,
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
NUMBER |
註冊編號檢查類型。 |
DOCUMENT |
註冊文件檢查類型。 |
LocalServicesBusinessRegistrationCheckRejectionReason
舉例說明在地生活服務公司註冊檢查驗證成果可能會遭到拒絕的原因。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
BUSINESS_NAME_MISMATCH |
商家名稱與在地生活服務廣告的商家名稱不符。 |
BUSINESS_DETAILS_MISMATCH |
商家詳細資料不符。 |
ID_NOT_FOUND |
找不到公司登記 ID。 |
POOR_DOCUMENT_IMAGE_QUALITY |
已上傳文件清晰不清、模糊不清等 |
DOCUMENT_EXPIRED |
上傳的文件已過期。 |
DOCUMENT_INVALID |
文件已撤銷或修訂。 |
DOCUMENT_TYPE_MISMATCH |
文件類型不符。 |
DOCUMENT_UNVERIFIABLE |
無法驗證上傳文件為合法文件。 |
OTHER |
因為發生問題,無法完成商業登記程序。如要瞭解詳情,請與 https://support.google.com/localservices 聯絡。 |
BusinessRegistrationNumber
專門保存在地生活服務公司登記號碼資訊的原型。
JSON 表示法 |
---|
{ "number": string } |
欄位 | |
---|---|
number |
僅供輸出。商家的政府核發號碼。 |
BusinessRegistrationDocument
一份固有服務商業登記文件特定資訊的原型。
JSON 表示法 |
---|
{
"documentReadonly": {
object ( |
欄位 | |
---|---|
documentReadonly |
僅供輸出。唯讀欄位,內含已上傳商業登記文件的資訊。 |
MobileAppCategoryConstant
行動應用程式類別常數。
JSON 表示法 |
---|
{ "resourceName": string, "id": integer, "name": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。行動應用程式類別常數的資源名稱。行動應用程式類別常數資源名稱的格式如下:
|
id |
僅供輸出。行動應用程式類別常數的 ID。 |
name |
僅供輸出。行動應用程式類別名稱。 |
MobileDeviceConstant
行動裝置常數。
JSON 表示法 |
---|
{
"resourceName": string,
"type": enum ( |
欄位 | |
---|---|
resourceName |
僅供輸出。行動裝置常數的資源名稱。行動裝置常數資源名稱的格式如下:
|
type |
僅供輸出。行動裝置的類型。 |
id |
僅供輸出。行動裝置常數的 ID。 |
name |
僅供輸出。行動裝置的名稱。 |
manufacturerName |
僅供輸出。行動裝置的製造商。 |
operatingSystemName |
僅供輸出。行動裝置的作業系統。 |
MobileDeviceType
行動裝置的類型。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
MOBILE |
手機。 |
TABLET |
平板電腦。 |
OfflineConversionUploadClientSummary
離線轉換上傳客戶摘要。
JSON 表示法 |
---|
{ "resourceName": string, "client": enum ( |
欄位 | |
---|---|
resourceName |
僅供輸出。離線轉換上傳客戶摘要的資源名稱。離線轉換上傳客戶摘要資源名稱的格式如下:
|
client |
僅供輸出。上傳事件的用戶端類型。 |
status |
僅供輸出。離線轉換客戶摘要的整體狀態。系統會從最近一個日期產生狀態 (含上傳統計資料) |
totalEventCount |
僅供輸出。已上傳事件總數。 |
successfulEventCount |
僅供輸出。成功上傳的事件總數。 |
successRate |
僅供輸出。成功率。 |
lastUploadDateTime |
僅供輸出。最近一次上傳批次的日期。格式為「yyyy-mm-dd hh:mm:ss」,並且以 Google Ads 帳戶的時區為準。 |
dailySummaries[] |
僅供輸出。最近 N 天的記錄統計資料摘要。 |
jobSummaries[] |
僅供輸出。依最近 N 項工作區分的記錄統計資料摘要。 |
alerts[] |
僅供輸出。每個錯誤代碼的詳細資料。系統會從最近一天的上傳統計資料中產生快訊。 |
OfflineEventUploadClient
客戶類型。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
GOOGLE_ADS_API |
Google Ads API: |
GOOGLE_ADS_WEB_CLIENT |
Google Ads 網路用戶端,可能包含多個來源,例如 Google Ads UI、SFTP 等。 |
ADS_DATA_CONNECTOR |
連結平台。 |
OfflineConversionDiagnosticStatus
離線擷取設定的可能狀態。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
EXCELLENT |
離線資料擷取設定已啟用,且最適合下游處理。 |
GOOD |
離線擷取設定已啟用,但仍有改善空間。查看快訊。 |
NEEDS_ATTENTION |
離線擷取設定已啟用,但有錯誤,請您留意。查看快訊。 |
NO_RECENT_UPLOAD |
離線擷取設定在過去 28 天內未收到任何資料,其中可能發生問題。 |
OfflineConversionSummary
過往上傳摘要,按照上傳日期或工作分類。
JSON 表示法 |
---|
{ "successfulCount": string, "failedCount": string, // Union field |
欄位 | |
---|---|
successfulCount |
僅供輸出。成功的事件總數。 |
failedCount |
僅供輸出。失敗事件總數。 |
聯集欄位 dimension_key 。摘要的維度鍵。dimension_key 只能是下列其中一項: |
|
jobId |
僅供輸出。最近 N 項工作的維度鍵。 |
uploadDate |
僅供輸出。最近 N 天內的維度鍵。 |
OfflineConversionAlert
離線轉換客戶摘要快訊。
JSON 表示法 |
---|
{
"error": {
object ( |
欄位 | |
---|---|
error |
僅供輸出。離線轉換用戶端快訊發生錯誤。 |
errorPercentage |
僅供輸出。錯誤百分比,這個欄位的範圍應為 [0, 1.0]。 |
OfflineConversionError
離線轉換客戶摘要可能發生錯誤。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位 error_code 。說明錯誤。error_code 只能是下列其中一項: |
|
collectionSizeError |
僅供輸出。最愛大小錯誤。 |
conversionAdjustmentUploadError |
僅供輸出。轉換調整項上傳錯誤。 |
conversionUploadError |
僅供輸出。轉換上傳錯誤。 |
dateError |
僅供輸出。日期錯誤。 |
distinctError |
僅供輸出。明確的錯誤。 |
fieldError |
僅供輸出。欄位錯誤。 |
mutateError |
僅供輸出。更改錯誤。 |
notAllowlistedError |
僅供輸出。「未加入許可清單」錯誤。 |
stringFormatError |
僅供輸出。字串格式錯誤。 |
stringLengthError |
僅供輸出。字串長度錯誤。 |
CollectionSizeError
說明可能的集合大小錯誤。
列舉 | |
---|---|
UNSPECIFIED |
未指定列舉。 |
UNKNOWN |
這個版本無法得知收到的錯誤代碼。 |
TOO_FEW |
太少了, |
TOO_MANY |
數量過多, |
ConversionAdjustmentUploadError
列舉說明可能的轉換調整項上傳錯誤。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
TOO_RECENT_CONVERSION_ACTION |
無法將事件匯入剛建立的轉換動作。請於 6 小時後再次嘗試匯入。 |
CONVERSION_ALREADY_RETRACTED |
轉換已撤銷。系統並未處理這項調整。 |
CONVERSION_NOT_FOUND |
找不到與這個轉換動作和轉換 ID 相對應的轉換。請確認轉換 ID 連結至正確的轉換動作,然後再試一次。 |
CONVERSION_EXPIRED |
無法對發生時間超過 54 天的轉換進行調整。 |
ADJUSTMENT_PRECEDES_CONVERSION |
調整項含有發生相關轉換前的adjustmentDateTime 。請確認 adjustmentDateTime 正確無誤,然後再試一次。 |
MORE_RECENT_RESTATEMENT_FOUND |
系統已針對相關轉換記錄較近期的調整項「adjustmentDateTime 」。請確認調整項 adjustmentDateTime 正確無誤,然後再試一次。 |
TOO_RECENT_CONVERSION |
轉換發生時間太近,因此無法記錄調整項。請調整發生超過 24 個小時的轉換。 |
CANNOT_RESTATE_CONVERSION_ACTION_THAT_ALWAYS_USES_DEFAULT_CONVERSION_VALUE |
無法對設為使用預設值的轉換進行調整。請檢查轉換動作價值設定,然後再試一次。 |
TOO_MANY_ADJUSTMENTS_IN_REQUEST |
在單一 API 要求中上傳的調整項必須少於 2,001 個。 |
TOO_MANY_ADJUSTMENTS |
轉換調整次數已達上限。請務必只對現有轉換進行必要的調整。 |
RESTATEMENT_ALREADY_EXISTS |
轉換先前已有相同的 adjustmentDateTime 重編。請確認調整項包含正確且不重複的adjustmentDateTime ,然後再試一次。 |
DUPLICATE_ADJUSTMENT_IN_REQUEST |
匯入的調整項與包含相同adjustmentDateTime 的轉換調整項重複。請確認調整項包含正確的adjustmentDateTime ,然後再試一次。 |
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS |
請確認您同意轉換設定中的顧客資料處理條款,然後再試一次。 |
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT |
無法搭配指定的轉換動作使用強化轉換。 |
INVALID_USER_IDENTIFIER |
請務必使用 SHA-256 對使用者提供的資料進行雜湊處理,並務必根據規範進行正規化。 |
UNSUPPORTED_USER_IDENTIFIER |
請使用使用者提供的資料 (例如使用 SHA-256 雜湊處理的電子郵件地址或電話號碼),然後再試一次。 |
GCLID_DATE_TIME_PAIR_AND_ORDER_ID_BOTH_SET |
無法同時設定 gclidDateTimePair 和 orderId。請只使用 1 種類型,然後再試一次。 |
CONVERSION_ALREADY_ENHANCED |
轉換已包含具有相同訂單 ID 和轉換動作的強化項目。請確認資料設定正確無誤,然後再試一次。 |
DUPLICATE_ENHANCEMENT_IN_REQUEST |
多個強化項目具有相同的轉換動作和訂單 ID。請確認資料設定正確無誤,然後再試一次。 |
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCEMENT |
根據 Google 客戶資料政策,這個帳戶無法使用強化轉換。請與您的 Google 代表聯絡。 |
MISSING_ORDER_ID_FOR_WEBPAGE |
網站轉換調整項需要訂單 ID (即交易 ID)。請確認網站代碼會擷取訂單 ID,且相同的訂單 ID 會連同調整項一併送出。 |
ORDER_ID_CONTAINS_PII |
調整項的訂單 ID 包含個人識別資訊 (PII),因此無法使用。 |
INVALID_JOB_ID |
要求中提供的工作 ID 不在許可範圍內。工作 ID 必須是 [1, 2^31] 範圍內的正整數。 |
NO_CONVERSION_ACTION_FOUND |
找不到調整要求中指定的轉換動作,請確認該動作可在這個帳戶中找到。 |
INVALID_CONVERSION_ACTION_TYPE |
上傳調整項時,不支援使用調整要求中指定的轉換動作類型。RETRACTION 或 RESTATEMENT 類型的轉換調整項只能用於「SALESFORCE 」、「UPLOAD_CLICK 」或「WEBPAGE 」類型的轉換動作。「ENHANCEMENT 」類型的轉換調整項只適用於「WEBPAGE 」類型的轉換動作。 |
ConversionUploadError
列舉說明可能的轉換上傳錯誤。
列舉 | |
---|---|
UNSPECIFIED |
未指定列舉。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
TOO_MANY_CONVERSIONS_IN_REQUEST |
在單一要求中上傳的事件少於 2,001 個。 |
UNPARSEABLE_GCLID |
無法解碼匯入的 Google 點擊 ID。請確認您並未修改點擊 ID。 |
CONVERSION_PRECEDES_EVENT |
匯入的事件含有點擊之前的 conversionDateTime 。請確認 conversionDateTime 正確無誤,然後再試一次。 |
EXPIRED_EVENT |
此轉換的點擊時間早於點閱後回溯期,因此無法記錄匯入的事件。請確認您匯入的是最新資料。 |
TOO_RECENT_EVENT |
與指定 ID 或 iOS 網址參數相關的點擊發生時間不到 6 小時。請於 6 小時後重試。 |
EVENT_NOT_FOUND |
匯入的事件無法歸因於特定點擊。原因可能是該事件並非來自 Google Ads 廣告活動。 |
UNAUTHORIZED_CUSTOMER |
點擊 ID 或來電連結至您無權存取的 Google Ads 帳戶。請確認要匯入轉換資料的帳戶由您的管理員帳戶管理。 |
TOO_RECENT_CONVERSION_ACTION |
無法將事件匯入剛建立的轉換動作。請於 6 小時後再次嘗試匯入。 |
CONVERSION_TRACKING_NOT_ENABLED_AT_IMPRESSION_TIME |
點擊時,該點擊 Google Ads 帳戶的有效轉換帳戶並未啟用轉換追蹤功能。 |
EXTERNAL_ATTRIBUTION_DATA_SET_FOR_NON_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION |
匯入的事件包含外部歸因資料,但轉換動作並未設為使用外部歸因模式。請確認轉換動作設定正確無誤,然後再試一次。 |
EXTERNAL_ATTRIBUTION_DATA_NOT_SET_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION |
轉換動作已設為使用外部歸因模式,但匯入的事件缺少資料。請確認匯入的事件包含外部歸因功勞,以及所有必要欄位。 |
ORDER_ID_NOT_PERMITTED_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION |
訂單 ID 無法用於以外部歸因模式評估的轉換。請確認轉換設定正確無誤,且匯入的事件僅包含必要資料,然後再試一次。 |
ORDER_ID_ALREADY_IN_USE |
匯入的事件包含先前記錄的訂單 ID,因此無法處理該事件。 |
DUPLICATE_ORDER_ID |
匯入的事件包含具有相同訂單 ID 的多個轉換,因此無法處理。請確認訂單 ID 並未重複,然後再試一次。 |
TOO_RECENT_CALL |
無法匯入 6 小時內發生的來電。請於 6 小時後再試一次。 |
EXPIRED_CALL |
此轉換動作的回溯期早於,因此無法記錄來電。請確認匯入內容已設定為取得最新資料。 |
CALL_NOT_FOUND |
找不到促成匯入事件的通話或點擊。請確認資料來源設定包含正確的 ID。 |
CONVERSION_PRECEDES_CALL |
呼叫的 conversionDateTime 位於相關點擊之前。確認 conversionDateTime 正確無誤。 |
CONVERSION_TRACKING_NOT_ENABLED_AT_CALL_TIME |
透過已匯入的來電時,該次點擊的 Google Ads 帳戶有效轉換帳戶中並未啟用轉換追蹤功能。 |
UNPARSEABLE_CALLERS_PHONE_NUMBER |
請確認電話號碼的格式是 E.164 (+16502531234)、國際 (+64 3-331 6005) 或美國國民電話號碼 (6502531234)。 |
CLICK_CONVERSION_ALREADY_EXISTS |
匯入的事件與現有轉換具有相同的點擊和 conversionDateTime 。請為每個不重複的事件使用不重複的 conversionDateTime 或訂單 ID,然後再試一次。 |
CALL_CONVERSION_ALREADY_EXISTS |
匯入的來電與現有轉換具有相同的 conversionDateTime 。請確認「conversionDateTime 」的設定正確無誤,然後再試一次。 |
DUPLICATE_CLICK_CONVERSION_IN_REQUEST |
多個事件具有相同的點擊和 conversionDateTime 。請確認 conversionDateTime 設定正確無誤,然後再試一次。 |
DUPLICATE_CALL_CONVERSION_IN_REQUEST |
多個活動具有相同的呼叫和 conversionDateTime 。請確認 conversionDateTime 設定正確無誤,然後再試一次。 |
CUSTOM_VARIABLE_NOT_ENABLED |
在轉換設定中啟用自訂變數,然後再試一次。 |
CUSTOM_VARIABLE_VALUE_CONTAINS_PII |
事件的自訂變數包含個人識別資訊 (PII),因此無法匯入。請移除這些變數,然後再試一次。 |
INVALID_CUSTOMER_FOR_CLICK |
匯入事件中的點擊連結至其他 Google Ads 帳戶。請確認您匯入至正確的帳戶。 |
INVALID_CUSTOMER_FOR_CALL |
通話中的點擊連結至其他 Google Ads 帳戶。請確認您匯入至正確的帳戶。向客戶查詢 conversionTrackingSetting.google_ads_conversion_customer,以識別正確的帳戶。 |
CONVERSION_NOT_COMPLIANT_WITH_ATT_POLICY |
該轉換來源不符合 Apple 應用程式透明度追蹤 (ATT) 政策規定,或客戶不同意追蹤,因此無法匯入整合。 |
CLICK_NOT_FOUND |
系統無法將這個事件的電子郵件地址或電話號碼對應至任何點擊。這可能是因為該事件不是由 Google Ads 廣告活動促成,您可以放心忽略這則警告。如果包含的匯入事件數量超出預期,建議您檢查設定。 |
INVALID_USER_IDENTIFIER |
請務必使用 SHA-256 對使用者提供的資料進行雜湊處理,並務必根據規範進行正規化。 |
EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION_NOT_PERMITTED_WITH_USER_IDENTIFIER |
使用者提供的資料無法與外部歸因模式搭配使用。請改用其他歸因模式或省略使用者 ID,然後再試一次。 |
UNSUPPORTED_USER_IDENTIFIER |
不支援提供的使用者 ID。請務必使用經過雜湊處理的電子郵件或電話號碼,然後再試一次。 |
GBRAID_WBRAID_BOTH_SET |
無法同時使用 gbraid 和 wbraid 參數。請只使用其中一個參數,然後再試一次。 |
UNPARSEABLE_WBRAID |
無法剖析事件匯入資料。請確認 wbraid 參數未遭到修改,然後再試一次。 |
UNPARSEABLE_GBRAID |
無法剖析事件匯入資料。請確認 gbraid 參數未遭到修改,然後再試一次。 |
ONE_PER_CLICK_CONVERSION_ACTION_NOT_PERMITTED_WITH_BRAID |
採用單次點擊單次轉換計算設定的轉換動作無法與 gbraid 或 wbraid 參數搭配使用。 |
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS |
根據 Google 客戶資料政策,這個帳戶無法使用強化轉換。請與您的 Google 代表聯絡。 |
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS |
請確認您同意轉換設定中的顧客資料處理條款,然後再試一次。如要檢查設定,您對「客戶」查詢 conversionTrackingSetting.accepted_customer_data_terms。 |
ORDER_ID_CONTAINS_PII |
事件的訂單 ID 包含個人識別資訊 (PII),因此無法匯入。 |
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS |
請確認已在轉換設定中啟用待開發客戶強化轉換,然後再試一次。如要檢查設定,您對「客戶」查詢 conversionTrackingSetting.enhanced_conversions_for_leads_enabled。 |
INVALID_JOB_ID |
要求中提供的工作 ID 不在許可範圍內。工作 ID 必須是 [1, 2^31] 範圍內的正整數。 |
NO_CONVERSION_ACTION_FOUND |
找不到上傳要求中指定的轉換動作,請確認該動作可在這個帳戶中找到。 |
INVALID_CONVERSION_ACTION_TYPE |
上傳要求中指定的轉換動作未設為用於上傳轉換。 |
DateError
列舉說明可能的日期錯誤。
列舉 | |
---|---|
UNSPECIFIED |
未指定列舉。 |
UNKNOWN |
這個版本無法得知收到的錯誤代碼。 |
INVALID_FIELD_VALUES_IN_DATE |
必須提供有效的日期。 |
INVALID_FIELD_VALUES_IN_DATE_TIME |
必須提供有效的日期時間做為欄位值。 |
INVALID_STRING_DATE |
字串的日期格式必須為 yyyy-mm-dd。 |
INVALID_STRING_DATE_TIME_MICROS |
字串的日期時間格式必須為 yyyy-mm-dd hh:mm:ss.sssss。 |
INVALID_STRING_DATE_TIME_SECONDS |
字串的日期時間格式必須為 yyyy-mm-dd hh:mm:ss。 |
INVALID_STRING_DATE_TIME_SECONDS_WITH_OFFSET |
字串的日期時間格式必須為 yyyy-mm-dd hh:mm:ss+|-hh:mm。 |
EARLIER_THAN_MINIMUM_DATE |
日期過早。 |
LATER_THAN_MAXIMUM_DATE |
日期晚於系統允許的期限。 |
DATE_RANGE_MINIMUM_DATE_LATER_THAN_MAXIMUM_DATE |
日期範圍邊界未按照順序排列。 |
DATE_RANGE_MINIMUM_AND_MAXIMUM_DATES_BOTH_NULL |
範圍內的兩個日期都是空值。 |
DistinctError
列舉說明可能的區別。
列舉 | |
---|---|
UNSPECIFIED |
未指定列舉。 |
UNKNOWN |
這個版本無法得知收到的錯誤代碼。 |
DUPLICATE_ELEMENT |
元素重複。 |
DUPLICATE_TYPE |
類型重複。 |
FieldError
列舉說明可能的欄位錯誤。
列舉 | |
---|---|
UNSPECIFIED |
未指定列舉。 |
UNKNOWN |
這個版本無法得知收到的錯誤代碼。 |
REQUIRED |
未填寫必填欄位。 |
IMMUTABLE_FIELD |
試圖要變動的欄位無法變更。 |
INVALID_VALUE |
欄位值無效。 |
VALUE_MUST_BE_UNSET |
無法設定這個欄位。 |
REQUIRED_NONEMPTY_LIST |
必填的重複欄位空白。 |
FIELD_CANNOT_BE_CLEARED |
無法清除這個欄位。 |
BLOCKED_VALUE |
欄位的值在這個欄位的拒絕清單中。 |
FIELD_CAN_ONLY_BE_CLEARED |
欄位的值無法修改,除非清除。 |
MutateError
列舉說明可能的 mut 錯誤。
列舉 | |
---|---|
UNSPECIFIED |
未指定列舉。 |
UNKNOWN |
這個版本無法得知收到的錯誤代碼。 |
RESOURCE_NOT_FOUND |
找不到要求的資源。 |
ID_EXISTS_IN_MULTIPLE_MUTATES |
無法在一個要求中變更同一項資源兩次。 |
INCONSISTENT_FIELD_VALUES |
欄位內容與其他代表相同資料的欄位不相符。 |
MUTATE_NOT_ALLOWED |
要求的資源不允許改變。 |
RESOURCE_NOT_IN_GOOGLE_ADS |
這項資源不在 Google Ads 中。屬於其他廣告系統。 |
RESOURCE_ALREADY_EXISTS |
正在建立的資源已存在。 |
RESOURCE_DOES_NOT_SUPPORT_VALIDATE_ONLY |
這項資源無法與「validateOnly」搭配使用。 |
OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE |
這項作業無法與「partialFailure」搭配使用。 |
RESOURCE_READ_ONLY |
嘗試寫入唯讀欄位。 |
NotAllowlistedError
說明可能未加入許可清單的錯誤。
列舉 | |
---|---|
UNSPECIFIED |
未指定列舉。 |
UNKNOWN |
這個版本無法得知收到的錯誤代碼。 |
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE |
顧客尚未加入許可清單,因此無法使用這項功能。 |
StringFormatError
列舉說明可能的字串格式錯誤。
列舉 | |
---|---|
UNSPECIFIED |
未指定列舉。 |
UNKNOWN |
這個版本無法得知收到的錯誤代碼。 |
ILLEGAL_CHARS |
您輸入的字串值含有禁止使用的字元。 |
INVALID_FORMAT |
您輸入的字串值不適用於相關聯的欄位。 |
StringLengthError
說明可能的字串長度錯誤。
列舉 | |
---|---|
UNSPECIFIED |
未指定列舉。 |
UNKNOWN |
這個版本無法得知收到的錯誤代碼。 |
EMPTY |
指定欄位中至少要有一個非空白字元。 |
TOO_SHORT |
太短。 |
TOO_LONG |
名稱過長。 |
OperatingSystemVersionConstant
行動作業系統版本或版本範圍 (視 operatorType
而定)。如要查看可用的行動平台清單,請前往 https://developers.google.com/google-ads/api/reference/data/codes-formats#mobile-platforms
JSON 表示法 |
---|
{
"resourceName": string,
"operatorType": enum ( |
欄位 | |
---|---|
resourceName |
僅供輸出。作業系統版本常數的資源名稱。作業系統版本常數資源名稱的格式如下:
|
operatorType |
僅供輸出。決定此常數要代表單一版本或版本範圍。 |
id |
僅供輸出。作業系統版本的 ID。 |
name |
僅供輸出。作業系統的名稱。 |
osMajorVersion |
僅供輸出。OS 主要版本號碼。 |
osMinorVersion |
僅供輸出。OS 子版本號碼。 |
OperatingSystemVersionOperatorType
作業系統版本類型。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
EQUALS_TO |
等於指定版本。 |
GREATER_THAN_EQUALS_TO |
大於或等於指定的版本。 |
PaidOrganicSearchTermView
付費隨機搜尋字詞檢視畫面可在廣告群組層級顯示按搜尋字詞匯總的廣告和自然搜尋結果搜尋統計資料。
JSON 表示法 |
---|
{ "resourceName": string, "searchTerm": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。搜尋字詞檢視畫面的資源名稱。搜尋字詞檢視表資源名稱的格式如下:
|
searchTerm |
僅供輸出。搜尋字詞。 |
QualifyingQuestion
待開發客戶表單的篩選問題。
JSON 表示法 |
---|
{ "resourceName": string, "qualifyingQuestionId": string, "locale": string, "text": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。資格問題的資源名稱。 「qualifiedQuestions/{qualeligibilityQuestionId}」 |
qualifyingQuestionId |
僅供輸出。資格問題的 ID。 |
locale |
僅供輸出。資格問題的語言代碼。 |
text |
僅供輸出。資格問題。 |
ParentalStatusView
家長狀態檢視模式。
JSON 表示法 |
---|
{ "resourceName": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。家長狀態檢視畫面的資源名稱。家長狀態檢視資源名稱的格式如下:
|
PerStoreView
每筆商店檢視畫面。這項檢視畫面會提供廣告客戶個別商店曝光觸及率和本地動作轉換統計資料。
JSON 表示法 |
---|
{ "resourceName": string, "placeId": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。每個商店檢視畫面的資源名稱。個別商店檢視表資源名稱的格式如下:
|
placeId |
僅供輸出。每個商店檢視畫面的地點 ID。 |
ProductCategoryConstant
產品類別。
JSON 表示法 |
---|
{ "resourceName": string, "categoryId": string, "level": enum ( |
欄位 | |
---|---|
resourceName |
僅供輸出。產品類別的資源名稱。產品類別資源名稱的格式如下:
|
categoryId |
僅供輸出。產品類別的 ID。 這個 ID 等同於 google_product_category [Google 產品類別] ID,詳情請參閱 https://support.google.com/merchants/answer/6324436。 |
level |
僅供輸出。產品類別層級。 |
state |
僅供輸出。產品類別狀態。 |
localizations[] |
僅供輸出。產品類別的所有可用本地化版本清單。 |
productCategoryConstantParent |
僅供輸出。父項產品類別的資源名稱。 |
ProductCategoryState
列舉用來說明產品類別的狀態。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
ENABLED |
類別已啟用。 |
OBSOLETE |
類別已過時,只會用於製作報表。 |
ProductCategoryLocalization
產品類別本地化。
JSON 表示法 |
---|
{ "regionCode": string, "languageCode": string, "value": string } |
欄位 | |
---|---|
regionCode |
僅供輸出。本地化類別的 ISO 3166-1 國家/地區代碼 (採大寫兩個英文字母)。 |
languageCode |
僅供輸出。本地化類別的雙字母 ISO 639-1 語言代碼。 |
value |
僅供輸出。指定語言代碼的類別名稱。 |
ProductGroupView
產品群組檢視。
JSON 表示法 |
---|
{ "resourceName": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。產品群組檢視畫面的資源名稱。產品群組檢視資源名稱的格式如下:
|
SearchTermView
搜尋字詞檢視畫面,內含廣告群組層級依搜尋字詞匯總的指標。
JSON 表示法 |
---|
{
"resourceName": string,
"status": enum ( |
欄位 | |
---|---|
resourceName |
僅供輸出。搜尋字詞檢視畫面的資源名稱。搜尋字詞檢視表資源名稱的格式如下:
|
status |
僅供輸出。表示搜尋字詞目前是您的目標或排除關鍵字。 |
searchTerm |
僅供輸出。搜尋字詞。 |
adGroup |
僅供輸出。放送搜尋字詞的廣告群組。 |
SearchTermTargetingStatus
表示搜尋字詞是其中一個指定或排除關鍵字。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
ADDED |
搜尋字詞已新增至目標關鍵字中。 |
EXCLUDED |
搜尋字詞與排除關鍵字相符。 |
ADDED_EXCLUDED |
已加入及排除搜尋字詞。 |
NONE |
未指定或排除搜尋字詞。 |
ShoppingPerformanceView
Shopping 成效資料檢視。提供購物廣告活動統計資料,這些統計資料按數個產品維度層級匯總。Merchant Center 中的產品維度值 (例如品牌、類別、自訂屬性、產品狀況和產品類型),都會反映對應事件記錄日期和時間時,各個維度的狀態。
JSON 表示法 |
---|
{ "resourceName": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。購物成效檢視畫面的資源名稱。購物效能檢視畫面資源名稱的格式如下: |
SmartCampaignSearchTermView
智慧廣告活動搜尋字詞檢視畫面。
JSON 表示法 |
---|
{ "resourceName": string, "searchTerm": string, "campaign": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。智慧廣告活動搜尋字詞檢視畫面的資源名稱。智慧廣告活動搜尋字詞資料檢視資源名稱的格式如下:
|
searchTerm |
僅供輸出。搜尋字詞。 |
campaign |
僅供輸出。放送搜尋字詞的智慧廣告活動。 |
ThirdPartyAppAnalyticsLink
資料共用連結,允許將第三方應用程式數據分析匯入 Google Ads 客戶。
JSON 表示法 |
---|
{ "resourceName": string, "shareableLinkId": string } |
欄位 | |
---|---|
resourceName |
不可變動。第三方應用程式數據分析連結的資源名稱。第三方應用程式數據分析連結資源名稱的格式如下:
|
shareableLinkId |
僅供輸出。設定應用程式數據分析時,應提供給第三方的共用連結 ID。您可使用 ThirdPartyAppAnalyticsLinkService 中的重新產生方法,重新產生這個 ID。 |
TopicView
主題檢視區塊。
JSON 表示法 |
---|
{ "resourceName": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。主題檢視畫面的資源名稱。主題檢視表資源名稱的格式如下:
|
TravelActivityGroupView
旅遊活動群組檢視畫面。
JSON 表示法 |
---|
{ "resourceName": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。旅遊活動群組檢視畫面的資源名稱。旅遊活動群組檢視畫面資源名稱的格式如下:
|
TravelActivityPerformanceView
旅遊活動成效資料檢視。
JSON 表示法 |
---|
{ "resourceName": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。旅遊活動成效檢視畫面的資源名稱。旅遊活動效能檢視資源名稱的格式如下:
|
UserInterest
使用者興趣:要指定的特定興趣產業。
JSON 表示法 |
---|
{ "resourceName": string, "taxonomyType": enum ( |
欄位 | |
---|---|
resourceName |
僅供輸出。使用者興趣的資源名稱。使用者興趣資源名稱的格式如下:
|
taxonomyType |
僅供輸出。使用者興趣的分類類型, |
availabilities[] |
僅供輸出。使用者興趣的供應情形資訊。 |
userInterestId |
僅供輸出。使用者興趣的 ID。 |
name |
僅供輸出。使用者興趣的名稱。 |
userInterestParent |
僅供輸出。使用者興趣的父項。 |
launchedToAll |
僅供輸出。如果使用者興趣適用於所有管道和地區,則為 True。 |
UserInterestTaxonomyType
列舉包含可能的 UserInterestTaxonomyTypes。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
AFFINITY |
使用者興趣相似度。 |
IN_MARKET |
使用者興趣的市場。 |
MOBILE_APP_INSTALL_USER |
已知已安裝指定類別應用程式的使用者。 |
VERTICAL_GEO |
按照興趣顯示產業的地理位置。 |
NEW_SMART_PHONE_USER |
新智慧型手機使用者的興趣條件。 |
LifeEvent
人生大事:可讓您鎖定特定興趣導向的產業,在使用者適逢人生重要里程碑時觸及他們。
JSON 表示法 |
---|
{
"resourceName": string,
"id": string,
"name": string,
"parent": string,
"launchedToAll": boolean,
"availabilities": [
{
object ( |
欄位 | |
---|---|
resourceName |
僅供輸出。人生大事的資源名稱。人生大事資源名稱的格式如下:
|
id |
僅供輸出。人生大事的 ID。 |
name |
僅供輸出。人生大事的名稱,例如「最近搬家」 |
parent |
僅供輸出。LifeEvent 的父項。 |
launchedToAll |
僅供輸出。如果人生大事開放給所有頻道和語言代碼,則為 true。 |
availabilities[] |
僅供輸出。人生大事的供應情形資訊。 |
UserLocationView
使用者位置檢視。
使用者位置檢視畫麵包含國家/地區層級匯總的所有指標,每個國家/地區一列。是根據目標或非目標地區記錄使用者實際位置的指標。如果使用了其他區隔欄位,每個國家/地區的資料可能不只一列。
JSON 表示法 |
---|
{ "resourceName": string, "countryCriterionId": string, "targetingLocation": boolean } |
欄位 | |
---|---|
resourceName |
僅供輸出。使用者位置檢視畫面的資源名稱。UserLocation 檢視表資源名稱的格式如下:
|
countryCriterionId |
僅供輸出。國家/地區的條件 ID。 |
targetingLocation |
僅供輸出。指出是否已指定地區。 |
TopicConstant
根據刊登位置所屬的類別 (例如「寵物與動物/寵物/狗」),使用主題指定或排除 Google 多媒體廣告聯播網中的刊登位置。
JSON 表示法 |
---|
{ "resourceName": string, "path": [ string ], "id": string, "topicConstantParent": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。主題常數的資源名稱。主題常數資源名稱的格式如下:
|
path[] |
僅供輸出。要指定或排除的類別。陣列中每個後續的元素都代表更明確的子類別。舉例來說,{"Pets & Animals", "Pets", "Dogs"} 代表「寵物與動物/寵物/狗」類別。如要查看可用的主題類別清單,請前往 https://developers.google.com/google-ads/api/reference/data/verticals |
id |
僅供輸出。主題的 ID。 |
topicConstantParent |
僅供輸出。主題常數父項的資源名稱。 |
影片
影片。
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "channelId": string, "durationMillis": string, "title": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。影片的資源名稱。影片資源名稱的格式如下:
|
id |
僅供輸出。影片的 ID。 |
channelId |
僅供輸出。影片的擁有者頻道 ID。 |
durationMillis |
僅供輸出。影片的時間長度 (以毫秒為單位)。 |
title |
僅供輸出。影片的標題。 |
WebpageView
網頁瀏覽。
JSON 表示法 |
---|
{ "resourceName": string } |
欄位 | |
---|---|
resourceName |
僅供輸出。網頁檢視的資源名稱。網頁檢視資源名稱的格式如下:
|
LeadFormSubmissionData
來自待開發客戶表單提交的資料。
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "asset": string, "campaign": string, "leadFormSubmissionFields": [ { object ( |
欄位 | |
---|---|
resourceName |
僅供輸出。待開發客戶表單提交資料的資源名稱。待開發客戶表單提交資料資源名稱的格式如下:
|
id |
僅供輸出。這份待開發客戶表單提交的 ID。 |
asset |
僅供輸出。與提交的待開發客戶表單相關聯的素材資源。 |
campaign |
僅供輸出。與提交的待開發客戶表單相關聯的廣告活動。 |
leadFormSubmissionFields[] |
僅供輸出。與待開發客戶表單相關聯的提交資料。 |
customLeadFormSubmissionFields[] |
僅供輸出。與自訂待開發客戶表單相關聯的提交資料。 |
adGroup |
僅供輸出。與提交的待開發客戶表單相關聯的廣告群組。 |
adGroupAd |
僅供輸出。與提交的待開發客戶表單相關聯的 廣告群組廣告。 |
gclid |
僅供輸出。與已轉入待開發客戶表單相關聯的 Google 點擊 ID。 |
submissionDateTime |
僅供輸出。待開發客戶表單的提交日期和時間。格式為「yyyy-mm-dd hh:mm:ss+|-hh:mm」,例如「2019-01-01 12:32:45-08:00」。 |
LeadFormSubmissionField
所提交待開發客戶表單中的欄位。
JSON 表示法 |
---|
{
"fieldType": enum ( |
欄位 | |
---|---|
fieldType |
僅供輸出。待開發客戶表單欄位的欄位類型。 |
fieldValue |
僅供輸出。待開發客戶表單欄位的欄位值。 |
CustomLeadFormSubmissionField
提交的自訂問題中的欄位
JSON 表示法 |
---|
{ "questionText": string, "fieldValue": string } |
欄位 | |
---|---|
questionText |
僅供輸出。自訂問題的問題文字,長度上限為 300 個半形字元。 |
fieldValue |
僅供輸出。自訂問題回覆的欄位值,最多 70 個半形字元。 |
LocalServicesLead
在地生活服務待開發客戶的資料。內含使用者向廣告客戶撥打電話、傳送訊息或預訂書籍時產生的待開發客戶詳細資料。詳情請參閱:https://ads.google.com/local-services-ads
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "categoryId": string, "serviceId": string, "contactDetails": { object ( |
欄位 | |
---|---|
resourceName |
僅供輸出。在地生活服務待開發客戶資料的資源名稱。在地生活服務待開發客戶資源名稱的格式為
|
id |
僅供輸出。此待開發客戶的 ID。 |
categoryId |
僅供輸出。待開發客戶的服務類別。例如: |
serviceId |
僅供輸出。類別的服務。例如: |
contactDetails |
僅供輸出。待開發客戶的聯絡資料。 |
leadType |
僅供輸出。在地生活服務待開發客戶類型:電話、訊息、預訂等 |
leadStatus |
僅供輸出。待開發客戶的目前狀態。 |
creationDateTime |
僅供輸出。在地生活服務廣告待開發客戶建立的日期。格式為「YYYY-MM-DD HH:MM:SS」,以 Google Ads 帳戶的時區為準。範例:「2018-03-05 09:15:00」或「2018-02-01 14:34:30」 |
locale |
僅供輸出。「在地生活服務」供應商連結待開發客戶時所用的語言。詳情請參閱 https://developers.google.com/google-ads/api/data/codes-formats#locales。 |
leadCharged |
僅供輸出。如果廣告主必須支付待開發客戶費用,則為 True。 |
note |
僅供輸出。廣告主已為待開發客戶新增附註。 |
creditDetails |
僅供輸出。待開發客戶的信用詳細資料。 |
ContactDetails
含有消費者詳細聯絡資料的欄位。
JSON 表示法 |
---|
{ "phoneNumber": string, "email": string, "consumerName": string } |
欄位 | |
---|---|
phoneNumber |
僅供輸出。E164 格式的消費者電話號碼。 |
email |
僅供輸出。消費者電子郵件地址。 |
consumerName |
僅供輸出。消費者名稱 (如果 google.com 上的「訊息」或「預訂」表單提供消費者名稱) |
LeadType
可能的待開發客戶類型。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
MESSAGE |
訊息待開發客戶。 |
PHONE_CALL |
來電建立的待開發客戶。 |
BOOKING |
預訂待開發客戶。 |
LeadStatus
可能的待開發客戶狀態。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
NEW |
廣告主尚未看過的新待開發客戶。 |
ACTIVE |
尚未與廣告客戶互動的待開發客戶。 |
BOOKED |
已預訂待開發客戶。 |
DECLINED |
廣告主已拒絕待開發客戶。 |
EXPIRED |
待開發客戶因閒置過久而過期。 |
DISABLED |
由於垃圾內容或爭議而停用。 |
CONSUMER_DECLINED |
消費者拒絕了待開發客戶。 |
WIPED_OUT |
並抹除待開發客戶的個人識別資訊。 |
注意事項
代表廣告客戶為待開發客戶新增的附註。廣告主可以編輯附註,從而重設編輯時間和變更說明。
JSON 表示法 |
---|
{ "editDateTime": string, "description": string } |
欄位 | |
---|---|
editDateTime |
僅供輸出。待開發客戶附註的修改日期。格式為「YYYY-MM-DD HH:MM:SS」,以 Google Ads 帳戶的時區為準。範例:「2018-03-05 09:15:00」或「2018-02-01 14:34:30」 |
description |
僅供輸出。待開發客戶附註內容。 |
CreditDetails
代表待開發客戶的抵免額詳情。
JSON 表示法 |
---|
{
"creditState": enum ( |
欄位 | |
---|---|
creditState |
僅供輸出。待開發客戶的信用狀態。 |
creditStateLastUpdateDateTime |
僅供輸出。待開發客戶信用狀態最近一次更新的日期。格式為「YYYY-MM-DD HH:MM:SS」,以 Google Ads 帳戶的時區為準。範例:「2018-03-05 09:15:00」或「2018-02-01 14:34:30」 |
CreditState
可能的待開發客戶功勞狀態。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
PENDING |
抵免額待處理。 |
CREDITED |
已申請抵免額。 |
LocalServicesLeadConversation
在地生活服務待開發客戶對話的資料。包含待開發客戶對話的詳細資料。當使用者透過廣告客戶撥打電話、傳送訊息或預約服務時,系統就會產生這項資料。這些變數會附加至待開發客戶。詳情請參閱:https://ads.google.com/local-services-ads
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "conversationChannel": enum ( |
欄位 | |
---|---|
resourceName |
僅供輸出。由在地生活服務產生對話資料的資源名稱。在地生活服務待開發客戶對話的資源名稱形式為
|
id |
僅供輸出。此待開發客戶對話的 ID。 |
conversationChannel |
僅供輸出。GLS 待開發客戶對話類型:EMAIL、MESSAGE、PHONE_CALL、SMS 等 |
participantType |
僅供輸出。待開發客戶對話的參與者類型 (ADVERTISER 或 CONSUMER)。 |
lead |
僅供輸出。與待開發客戶對話相關聯的待開發客戶資源名稱。 |
eventDateTime |
僅供輸出。在地生活服務廣告建立待開發客戶對話的日期。格式為「YYYY-MM-DD HH:MM:SS」,以 Google Ads 帳戶的時區為準。範例:「2018-03-05 09:15:00」或「2018-02-01 14:34:30」 |
phoneCallDetails |
僅供輸出。關於 PHONE_CALL 的通話通話詳細資料。 |
messageDetails |
僅供輸出。關於 EMAIL、MESSAGE 或 SMS 的訊息對話詳細資料。 |
ConversationType
可能的待開發客戶對話類型。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
EMAIL |
電子郵件待開發客戶對話。 |
MESSAGE |
訊息待開發客戶對話。 |
PHONE_CALL |
電話待開發客戶對話。 |
SMS |
簡訊待開發客戶對話。 |
BOOKING |
預訂待開發客戶對話。 |
ParticipantType
待開發客戶對話參與者可能的類型。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
ADVERTISER |
在地生活服務廣告供應商參與者。 |
CONSUMER |
在地生活服務廣告消費者參與者。 |
PhoneCallDetails
代表通話對話的詳細資料。
JSON 表示法 |
---|
{ "callDurationMillis": string, "callRecordingUrl": string } |
欄位 | |
---|---|
callDurationMillis |
僅供輸出。通話的時間長度 (以毫秒為單位)。 |
callRecordingUrl |
僅供輸出。電話錄音音訊檔案的網址。 |
MessageDetails
代表文字訊息在電子郵件、簡訊或簡訊中的詳細資料。
JSON 表示法 |
---|
{ "text": string, "attachmentUrls": [ string ] } |
欄位 | |
---|---|
text |
僅供輸出。郵件的文字內容。 |
attachmentUrls[] |
僅供輸出。簡訊或電子郵件附件的網址。這些網址可透過開發人員權杖下載附件的內容。 |
AndroidPrivacyInteractionType
列舉互動類型
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
這個版本無法辨識這個值。 |
CLICK |
實體點擊互動類型。 |
ENGAGED_VIEW |
10 秒參與收視互動類型。 |
VIEW |
觀看 (廣告曝光) 互動類型。 |
AndroidPrivacyNetworkType
列舉網路類型
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
這個版本無法辨識這個值。 |
SEARCH |
搜尋聯播網。 |
DISPLAY |
您廣告的位置 |
YOUTUBE |
YouTube 聯播網。 |
指標
指標資料。
JSON 表示法 |
---|
{ "allConversionsValueByConversionDate": number, "allConversionsByConversionDate": number, "conversionsValueByConversionDate": number, "conversionsByConversionDate": number, "historicalCreativeQualityScore": enum ( |
欄位 | |
---|---|
allConversionsValueByConversionDate |
所有轉換的價值。如果選取這個資料欄和日期,日期欄中的值代表轉換日期。如需 by_conversion_date 欄的詳細資料,請參閱 https://support.google.com/google-ads/answer/9549009。 |
allConversionsByConversionDate |
轉換總次數。無論 includeInConversionsMetric 價值為何,系統都會計入所有轉換。如果選取這個資料欄和日期,日期欄中的值代表轉換日期。如需 by_conversion_date 欄的詳細資料,請參閱 https://support.google.com/google-ads/answer/9549009。 |
conversionsValueByConversionDate |
轉換價值。僅納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價,出價策略會調整設定來爭取這些轉換。如果選取這個資料欄和日期,日期欄中的值代表轉換日期。如需 by_conversion_date 欄的詳細資料,請參閱 https://support.google.com/google-ads/answer/9549009。 |
conversionsByConversionDate |
轉換次數。僅納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價,出價策略會調整設定來爭取這些轉換。如果選取這個資料欄和日期,日期欄中的值代表轉換日期。如需 by_conversion_date 欄的詳細資料,請參閱 https://support.google.com/google-ads/answer/9549009。 |
historicalCreativeQualityScore |
廣告素材歷來品質分數。 |
historicalLandingPageQualityScore |
歷來到達網頁體驗的品質。 |
historicalSearchPredictedCtr |
歷來搜尋預測點閱率 (CTR)。 |
interactionEventTypes[] |
應付費和免費互動類型。 |
skAdNetworkInstalls |
iOS Store Kit 廣告聯播網轉換次數。 |
skAdNetworkTotalConversions |
iOS Store Kit 廣告聯播網轉換總數。 |
publisherPurchasedClicks |
發布商透過付費方式或獎勵活動從他人的資源獲得流量後,所爭取到的點擊 |
publisherOrganicClicks |
發布商並未透過獎勵活動付費,或是從獎勵活動中獲得的流量,所獲得的點擊次數 |
publisherUnknownClicks |
來自非「發布商購買」或「發布商自然」流量的點擊 |
absoluteTopImpressionPercentage |
「搜尋絕對頂端曝光比重」是指有多少百分比的搜尋廣告曝光位於最顯眼的搜尋廣告刊登位置。 |
activeViewCpm |
平均可視曝光費用 ( |
activeViewCtr |
Active View 可評估點擊次數除以 Active View 可視曝光次數。 這項指標只會針對多媒體廣告聯播網回報。 |
activeViewImpressions |
用來評估廣告在多媒體廣告聯播網網站上可見的頻率。 |
activeViewMeasurability |
Active View 可評估的曝光次數在已放送曝光次數中所佔的比例。 |
activeViewMeasurableCostMicros |
您獲得的 Active View 可評估曝光費用。 |
activeViewMeasurableImpressions |
廣告在刊登位置可見位置顯示的次數。 |
activeViewViewability |
廣告出現在已啟用 Active View 的網站上 (可評估曝光) 且可見 (可視曝光) 的次數百分比。 |
allConversionsFromInteractionsRate |
互動帶來的所有轉換 (意即瀏覽後轉換) 除以廣告互動次數。 |
allConversionsValue |
所有轉換的價值。 |
allNewCustomerLifetimeValue |
所有新顧客的生命週期轉換價值。如果在帳戶層級或廣告活動層級設定獲取新客目標,就會納入新顧客的額外轉換價值 (包括可出價和不可出價轉換)。如果廣告活動採用獲取新客目標,並選取「針對新顧客提高出價」,這些價值就會納入「allConversionsValue」中。詳情請參閱 https://support.google.com/google-ads/answer/12080169。 |
allConversions |
轉換總次數。無論 includeInConversionsMetric 價值為何,系統都會計入所有轉換。 |
allConversionsValuePerCost |
計算方式是將所有轉換的價值除以廣告互動費用 (例如點擊文字廣告或觀看影片廣告)。 |
allConversionsFromClickToCall |
使用者按下廣告當下或之後,點擊「致電」按鈕致電商家的次數。計算這項數據時,電話接通與否或通話持續時間等因素不會被納入。 這項指標僅適用於動態饋給項目。 |
allConversionsFromDirections |
使用者按下廣告後,點選「取得路線」按鈕前往商家的次數。 這項指標僅適用於動態饋給項目。 |
allConversionsFromInteractionsValuePerInteraction |
將互動帶來的所有轉換值除以互動總數。 |
allConversionsFromMenu |
使用者點擊廣告後,點擊連結查看商家選單的次數。 這項指標僅適用於動態饋給項目。 |
allConversionsFromOrder |
使用者按下廣告後下單的次數。 這項指標僅適用於動態饋給項目。 |
allConversionsFromOtherEngagement |
使用者按下廣告後,發生其他轉換的次數 (例如張貼評論或儲存商家地點)。 這項指標僅適用於動態饋給項目。 |
allConversionsFromStoreVisit |
使用者點擊廣告後親臨門市的預估次數。 這項指標僅適用於動態饋給項目。 |
allConversionsFromStoreWebsite |
使用者點擊廣告後,前往商店網址的次數。 這項指標僅適用於動態饋給項目。 |
auctionInsightSearchAbsoluteTopImpressionPercentage |
這個指標是競價分析報表的一部分,用來瞭解其他參與者的廣告在搜尋結果網頁上最顯眼位置顯示的頻率。這個百分比只會用來計算您在網頁上進行的競價。 這項指標並未公開。 |
auctionInsightSearchImpressionShare |
這項指標屬於競價分析報表的一部分,可顯示其他參與者獲得的曝光次數百分比,以及廣告有資格獲得的曝光總數。系統會將低於 0.1 的值回報為 0.0999。 這項指標並未公開。 |
auctionInsightSearchOutrankingShare |
這個指標是競價分析報表的一部分,用來表示相較於廣告有資格獲得的曝光總數,您的廣告排名在競價中勝過另一名參與者 (也就是顯示在上方) 的曝光次數百分比。系統會將低於 0.1 的值回報為 0.0999。 這項指標並未公開。 |
auctionInsightSearchOverlapRate |
這項指標是競價分析報表的一部分,用來瞭解其他參與者的廣告和您的廣告同時獲得曝光的頻率。 這項指標並未公開。 |
auctionInsightSearchPositionAboveRate |
這個指標屬於競價分析報表的一部分,會指出其他參與者的廣告和您的廣告在同一個頁面上顯示時,其排名超越您的頻率。 這項指標並未公開。 |
auctionInsightSearchTopImpressionPercentage |
這項指標是競價分析報表的一部分,用來瞭解其他參與者的廣告在熱門自然搜尋結果旁顯示的頻率。這個百分比只會用來計算您在網頁上進行的競價。 這項指標並未公開。 |
averageCost |
您為每次互動支付的平均金額。計算方式是將廣告總費用除以互動總次數。 |
averageCpc |
所有點擊的總費用除以獲得的點擊總數。 |
averageCpe |
您為每次廣告參與支付的平均費用。計算方式是將所有廣告參與的總費用除以廣告參與總數。 |
averageCpm |
平均千次曝光出價 |
averageCpv |
每次有人觀看您的廣告時,您需要支付的平均費用金額。計算方式是所有廣告收視次數的總費用除以觀看次數。 |
averagePageViews |
每個工作階段的平均網頁瀏覽量。 |
averageTimeOnSite |
所有工作階段的總時間長度 (以秒為單位) 除以工作階段數。從 Google Analytics (分析) 匯入。 |
benchmarkAverageMaxCpc |
顯示其他廣告客戶如何對類似產品出價。 |
biddableAppInstallConversions |
應用程式安裝次數。 |
biddableAppPostInstallConversions |
應用程式內動作次數。 |
benchmarkCtr |
這項指標會根據使用者看到廣告點擊的頻率,顯示其他廣告主類似產品的購物廣告成效。 |
bounceRate |
使用者只造訪您網站上單一網頁的點擊百分比。從 Google Analytics (分析) 匯入。 |
clicks |
點擊次數。 |
combinedClicks |
廣告在非付費搜尋結果中顯示的次數,是廣告或網站搜尋結果的點擊次數。詳情請參閱以下說明頁面:https://support.google.com/google-ads/answer/3097241。 |
combinedClicksPerQuery |
廣告在非付費結果中獲得點擊的次數 (合併點擊次數) 除以合併查詢次數。詳情請參閱以下說明頁面:https://support.google.com/google-ads/answer/3097241。 |
combinedQueries |
在非付費結果中傳回您網站的網頁,或帶出您其中一則文字廣告的搜尋次數。詳情請參閱以下說明頁面:https://support.google.com/google-ads/answer/3097241。 |
contentBudgetLostImpressionShare |
廣告因為預算過低而無法在多媒體廣告聯播網上顯示的預估次數百分比。注意:內容預算錯失的曝光比重會以 0 到 0.9 的範圍表示。系統會將超過 0.9 的值回報為 0.9001。 |
contentImpressionShare |
將您在多媒體廣告聯播網上獲得的曝光次數除以預估可獲得的曝光次數後,所得到的百分比。注意:系統回報的內容曝光比重介於 0.1 到 1 之間。系統會將低於 0.1 的值回報為 0.0999。 |
conversionLastReceivedRequestDateTime |
這個轉換動作的轉換代碼上次成功觸發並由 Google Ads 擷取。這個觸發事件可能不是歸因轉換的結果 (例如,因為代碼是透過瀏覽器觸發,因此先前並未點擊適當廣告客戶的廣告)。日期/時間是以客戶的時區為準。 |
conversionLastConversionDate |
這個轉換動作最近的轉換日期。日期是以客戶的時區為準。 |
contentRankLostImpressionShare |
廣告因為廣告評級不佳,而無法在多媒體廣告聯播網上獲得的曝光次數預估百分比。注意:系統記錄的「多媒體廣告聯播網:錯失的曝光比重」會以 0 到 0.9 的範圍內。系統會將超過 0.9 的值回報為 0.9001。 |
conversionsFromInteractionsRate |
將互動所帶來的轉換除以廣告互動次數 (例如點擊文字廣告或觀看影片廣告)。僅納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價,出價策略會調整設定來爭取這些轉換。 |
conversionsValue |
轉換價值。僅納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價,出價策略會調整設定來爭取這些轉換。 |
newCustomerLifetimeValue |
新顧客的生命週期轉換價值。如果您在帳戶層級或廣告活動層級設定獲取新客目標,就會納入可出價轉換的新顧客額外轉換價值。如果廣告活動採用獲取新客目標,並選取「針對新顧客提高出價」,這些價值就會納入「conversionsValue」來進行最佳化。詳情請參閱 https://support.google.com/google-ads/answer/12080169。 |
conversionsValuePerCost |
轉換價值除以廣告互動費用。僅納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價,出價策略會調整設定來爭取這些轉換。 |
conversionsFromInteractionsValuePerInteraction |
互動轉換價值除以廣告互動次數。僅納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價,出價策略會調整設定來爭取這些轉換。 |
conversions |
轉換次數。僅納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價,出價策略會調整設定來爭取這些轉換。 |
costMicros |
在這段期間內,您的單次點擊出價和千次曝光出價總和。 |
costPerAllConversions |
廣告互動費用除以所有轉換。 |
costPerConversion |
廣告互動費用除以轉換次數。僅納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價,出價策略會調整設定來爭取這些轉換。 |
costPerCurrentModelAttributedConversion |
廣告互動費用除以目前的模式歸因轉換次數。僅納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價,出價策略會調整設定來爭取這些轉換。 |
crossDeviceConversions |
客戶在某部裝置上點擊 Google Ads 廣告,然後使用其他裝置或瀏覽器完成轉換。所有轉換已納入跨裝置轉換。 |
crossDeviceConversionsValueMicros |
跨裝置轉換的價值總和 (以百萬分之一為單位)。 |
ctr |
廣告獲得的點擊次數 (點擊次數) 除以廣告顯示次數 (曝光次數)。 |
currentModelAttributedConversions |
顯示在您目前選用的歸因模式下,歷來轉換資料的模樣。僅納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價,出價策略會調整設定來爭取這些轉換。 |
currentModelAttributedConversionsFromInteractionsRate |
目前模式的歸因轉換是將互動帶來的轉換次數除以廣告互動次數 (例如點擊文字廣告或觀看影片廣告)。僅納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價,出價策略會調整設定來爭取這些轉換。 |
currentModelAttributedConversionsFromInteractionsValuePerInteraction |
目前模式歸因轉換的價值除以廣告互動次數。僅納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價,出價策略會調整設定來爭取這些轉換。 |
currentModelAttributedConversionsValue |
目前模式歸因轉換的價值。僅納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價,出價策略會調整設定來爭取這些轉換。 |
currentModelAttributedConversionsValuePerCost |
目前模式歸因轉換的價值除以廣告互動費用。僅納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價,出價策略會調整設定來爭取這些轉換。 |
engagementRate |
使用者看到廣告後與廣告互動的頻率。計算方式是將廣告展開次數除以廣告顯示次數。 |
engagements |
參與次數。每次有觀眾展開您的燈箱廣告,就算一次主動參與。未來,將有更多廣告類型提供主動參與指標。 |
hotelAverageLeadValueMicros |
根據點擊次數計算的平均待開發客戶價值。 |
hotelCommissionRateMicros |
佣金出價費率 (以百萬分之一表示)。20% 的佣金會以 200,000 的比率表示。 |
hotelExpectedCommissionCost |
預期佣金費用。將佣金值乘以廣告客戶幣別的 Hotel_commission_rate 所得的結果。 |
hotelPriceDifferencePercentage |
報表飯店廣告客戶提供的價格與競爭廣告客戶提供的最低價格,兩者之間的平均價差。 |
hotelEligibleImpressions |
飯店合作夥伴在動態饋給成效下可能獲得的曝光次數。 |
historicalQualityScore |
歷來品質分數。 |
gmailForwards |
廣告以訊息形式轉寄給他人的次數。 |
gmailSaves |
使用者將您的 Gmail 廣告以郵件形式儲存到收件匣的次數。 |
gmailSecondaryClicks |
Gmail 廣告展開狀態下的到達網頁點擊次數。 |
impressionsFromStoreReach |
根據地點顯示的商家廣告次數。 這項指標僅適用於動態饋給項目。 |
impressions |
廣告在搜尋結果網頁或 Google 聯播網網站上顯示的頻率。 |
interactionRate |
使用者看到廣告後與廣告互動的頻率。計算方式為互動次數除以廣告顯示次數。 |
interactions |
互動次數。「互動」是指與文字廣告和購物廣告的廣告格式點擊、觀看影片廣告觀看等動作相關的主要使用者動作。 |
invalidClickRate |
報表統計期內,從點擊總數 (已篩選 + 未篩選的點擊) 中篩除的點擊所佔的百分比。 |
invalidClicks |
Google 認為點擊次數不合理,因此沒有向您收費。 |
messageChats |
針對符合訊息追蹤資格的點選傳訊曝光發起的訊息即時通訊數量。 |
messageImpressions |
符合訊息追蹤資格的點選傳訊息曝光次數。 |
messageChatRate |
發起的即時通訊訊息 (messageChat) 除以訊息曝光次數 (訊息曝光次數)。使用者從廣告曝光中發起訊息即時通訊的比率,其中含有訊息選項和訊息追蹤。請注意,對於特定訊息曝光,這個速率可能會大於 1.0。 |
mobileFriendlyClicksPercentage |
前往行動裝置友善網頁的行動點擊百分比。 |
optimizationScoreUplift |
所有最佳化建議的最佳化分數總升幅。 |
optimizationScoreUrl |
Google Ads 網頁介面中最佳化分數頁面的網址。您可以從 |
organicClicks |
使用者在某項查詢的非付費結果中,按下您網站搜尋結果的次數。詳情請參閱以下說明頁面:https://support.google.com/google-ads/answer/3097241。 |
organicClicksPerQuery |
使用者在非付費結果中點選您網站的搜尋結果的次數,除以傳回您網站網頁的搜尋總數 (自然查詢)。詳情請參閱以下說明頁面:https://support.google.com/google-ads/answer/3097241。 |
organicImpressions |
網站在非付費搜尋結果中顯示的商品數量。詳情請參閱以下說明頁面:https://support.google.com/google-ads/answer/3097241。 |
organicImpressionsPerQuery |
將您網站的網頁列在非付費搜尋結果中的次數 (自然曝光次數) 除以非付費結果中的搜尋結果傳回網站的次數 (自然查詢) 所得的值。詳情請參閱以下說明頁面:https://support.google.com/google-ads/answer/3097241。 |
organicQueries |
在免付費搜尋結果中,傳回網站產品資訊的搜尋總次數。詳情請參閱以下說明頁面:https://support.google.com/google-ads/answer/3097241。 |
percentNewVisitors |
首次工作階段 (使用者過去從未造訪過您的網站的使用者) 所佔的百分比。從 Google Analytics (分析) 匯入。 |
phoneCalls |
離線通話次數。 |
phoneImpressions |
離線電話曝光次數。 |
phoneThroughRate |
獲得的通話次數 (來電) 除以電話號碼顯示次數 (電話曝光) 所算出的比例。 |
relativeCtr |
您的點閱率除以刊登您廣告的網站上,所有廣告客戶的平均點閱率。評估您的廣告在多媒體廣告聯播網網站上與其他廣告相較之下的成效。 |
searchAbsoluteTopImpressionShare |
消費者的購物或搜尋廣告曝光中,出現在最顯眼的購物廣告位置所佔百分比。詳情請參閱 https://support.google.com/google-ads/answer/7501826。系統會將低於 0.1 的值回報為 0.0999。 |
searchBudgetLostAbsoluteTopImpressionShare |
這個數字代表了廣告因預算偏低,而無法讓搜尋結果排名顯示於搜尋結果頂端廣告的頻率。注意:搜尋聯播網預算錯失的絕對頂端曝光比重,會以 0 到 0.9 的範圍表示。系統會將超過 0.9 的值回報為 0.9001。 |
searchBudgetLostImpressionShare |
廣告因為預算過低而無法在搜尋聯播網上顯示的預估百分比。注意:搜尋聯播網預算錯失的曝光比重會以 0 到 0.9 的範圍表示。系統會將超過 0.9 的值回報為 0.9001。 |
searchBudgetLostTopImpressionShare |
這個數字用來估算廣告因預算偏低,而無法在熱門自然搜尋結果旁顯示的頻率。注意:搜尋聯播網預算錯失的頂端曝光比重,會以 0 到 0.9 的範圍表示。系統會將超過 0.9 的值回報為 0.9001。 |
searchClickShare |
將廣告在搜尋聯播網上實際獲得的點擊次數,除以預估可獲得的點擊次數後,所算出的百分比。注意:搜尋點擊比重的範圍以 0.1 到 1 的範圍表示。系統會將低於 0.1 的值回報為 0.0999。 |
searchExactMatchImpressionShare |
計算方式是將您的廣告在搜尋聯播網上實際預估可獲得的曝光次數,除以與您關鍵字完全相符 (或關鍵字的近似變體) (不採用關鍵字比對類型) 所帶來的預估次數。注意:搜尋聯播網完全比對曝光比重會顯示在 0.1 到 1 的範圍內。系統會將低於 0.1 的值回報為 0.0999。 |
searchImpressionShare |
將您在搜尋聯播網上獲得的曝光次數,除以預估可獲得的曝光次數後所算出的百分比。注意:搜尋聯播網曝光比重會以 0.1 到 1 的範圍表示。系統會將低於 0.1 的值回報為 0.0999。 |
searchRankLostAbsoluteTopImpressionShare |
這個數字用來估算由於廣告評級不佳,導致廣告無法排在搜尋結果頂端廣告的頻率。注意:「搜尋聯播網:錯失的絕對頂端曝光比重」會以 0 到 0.9 的範圍表示。系統會將超過 0.9 的值回報為 0.9001。 |
searchRankLostImpressionShare |
您的廣告因為廣告評級不佳,而無法在搜尋聯播網中獲得的曝光次數預估百分比。注意:排名錯失的曝光比重會顯示在 0 到 0.9 的範圍內。系統會將超過 0.9 的值回報為 0.9001。 |
searchRankLostTopImpressionShare |
這項指標用來估算廣告因為廣告評級不佳,而無法在熱門自然搜尋結果旁顯示的頻率。注意:「搜尋聯播網排名錯失的頂端曝光比重」會以 0 到 0.9 的範圍表示。系統會將超過 0.9 的值回報為 0.9001。 |
searchTopImpressionShare |
相較於頂端廣告的預估曝光次數,您從頂端廣告實際獲得的曝光次數。注意:搜尋聯播網頂端曝光比重會以 0.1 到 1 的範圍表示。系統會將低於 0.1 的值回報為 0.0999。 頂端廣告通常刊登在頂端自然搜尋結果上方,但視查詢而定,也可能出現在這類搜尋結果底下。 |
searchVolume |
搜尋字詞洞察類別的搜尋量範圍。 |
speedScore |
這是指行動廣告在點擊後的網頁載入速度。分數的範圍從 1 到 10,10 代表最快。 |
averageTargetCpaMicros |
平均目標單次轉換出價,如果無法使用 (如果無法使用的話),則一律設定這個值 (例如來自組合出價策略或非目標單次轉換出價的廣告活動)。 |
averageTargetRoas |
平均目標廣告投資報酬率;如果無法使用,則不設定這個值 (例如來自組合出價策略或非目標廣告投資報酬率的廣告活動)。 |
topImpressionPercentage |
顯示在頂端自然搜尋結果旁邊的廣告曝光百分比。 |
validAcceleratedMobilePagesClicksPercentage |
連往有效 AMP 網頁的 Accelerated Mobile Pages (AMP) 到達網頁廣告點擊百分比。 |
valuePerAllConversions |
所有轉換的價值除以所有轉換次數。 |
valuePerAllConversionsByConversionDate |
所有轉換的價值除以所有轉換次數。如果選取這個資料欄和日期,日期欄中的值代表轉換日期。如需 by_conversion_date 欄的詳細資料,請參閱 https://support.google.com/google-ads/answer/9549009。 |
valuePerConversion |
轉換價值除以轉換次數。僅納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價,出價策略會調整設定來爭取這些轉換。 |
valuePerConversionsByConversionDate |
轉換價值除以轉換次數。僅納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價,出價策略會調整設定來爭取這些轉換。如果選取這個資料欄和日期,日期欄中的值代表轉換日期。如需 by_conversion_date 欄的詳細資料,請參閱 https://support.google.com/google-ads/answer/9549009。 |
valuePerCurrentModelAttributedConversion |
目前模式歸因轉換的價值除以轉換次數。僅納入 includeInConversionsMetric 屬性設為 true 的轉換動作。如果您使用轉換型出價,出價策略會調整設定來爭取這些轉換。 |
videoQuartileP100Rate |
觀眾看完整部影片的曝光次數百分比。 |
videoQuartileP25Rate |
觀眾收看影片 25% 的曝光次數百分比。 |
videoQuartileP50Rate |
觀眾收看影片 50% 的曝光次數百分比。 |
videoQuartileP75Rate |
觀眾收看影片 75% 的曝光次數百分比。 |
videoViewRate |
將 TrueView 影片廣告獲得的觀看次數除以曝光次數,包括 TrueView 多媒體廣告的縮圖曝光次數。 |
videoViews |
影片廣告的觀看次數。 |
viewThroughConversions |
瀏覽後轉換總次數。如果客戶看到圖像或互動式多媒體廣告,之後未與另一個廣告互動 (例如點擊) 在您的網站上完成轉換,就算是一次轉換。 |
allConversionsFromLocationAssetClickToCall |
發生可付費廣告事件 (點擊或曝光) 後,任何地點途徑的通話按鈕點擊次數。這項評估資料來自以素材資源為依據的位置。 |
allConversionsFromLocationAssetDirections |
發生可收費廣告事件 (點擊或曝光) 後,任何地點表面的行車路線點擊次數。這項評估資料來自以素材資源為依據的位置。 |
allConversionsFromLocationAssetMenu |
發生可付費廣告事件 (點擊或曝光) 後,任何地點途徑的選單連結點擊次數。這項評估資料來自以素材資源為依據的位置。 |
allConversionsFromLocationAssetOrder |
發生可收費廣告事件 (點擊或曝光) 後,任何地點表面的訂單點擊次數。這項評估資料來自以素材資源為依據的位置。 |
allConversionsFromLocationAssetOtherEngagement |
發生可收費廣告事件 (點擊或曝光) 後,在任何地點表面上點擊的其他類型本地動作次數。這項評估資料來自以素材資源為依據的位置。 |
allConversionsFromLocationAssetStoreVisits |
發生可付費廣告事件 (點擊或曝光) 後,親臨門市的預估次數。這項評估資料來自以素材資源為依據的位置。 |
allConversionsFromLocationAssetWebsite |
發生可付費廣告事件 (點擊或曝光) 後,任何地點途徑的網站網址點擊次數。這項評估資料來自以素材資源為依據的位置。 |
eligibleImpressionsFromLocationAssetStoreReach |
顯示商店位置或用於指定目標的曝光次數。這項評估資料來自以素材資源為依據的位置。 |
viewThroughConversionsFromLocationAssetClickToCall |
曝光後任何地點途徑的通話按鈕點擊次數。這項評估資料來自以素材資源為依據的位置。 |
viewThroughConversionsFromLocationAssetDirections |
曝光後任何地點表面的行車路線點擊次數。這項評估資料來自以素材資源為依據的位置。 |
viewThroughConversionsFromLocationAssetMenu |
廣告曝光後,任何地點途徑的選單連結點擊次數。這項評估資料來自以素材資源為依據的位置。 |
viewThroughConversionsFromLocationAssetOrder |
曝光後任何地點途徑的訂單點擊次數。這項評估資料來自以素材資源為依據的位置。 |
viewThroughConversionsFromLocationAssetOtherEngagement |
曝光後任何地點途徑產生的其他本地動作點擊次數。這項評估資料來自以素材資源為依據的位置。 |
viewThroughConversionsFromLocationAssetStoreVisits |
廣告曝光後親臨門市的預估次數。這項評估資料來自以素材資源為依據的位置。 |
viewThroughConversionsFromLocationAssetWebsite |
廣告曝光後,在任何地點上點擊的網站網址。這項評估資料來自以素材資源為依據的位置。 |
orders |
「訂單數」是指廣告為您帶來的購物轉換總數。運作方式:消費者在網站上完成購物後,由您將透過購物車資料回報的轉換列入報表。如果轉換是歸給使用者先前與廣告的互動 (按下文字或購物廣告、觀看影片廣告等等),就會計為一張訂單。例如:消費者點按帽子的購物廣告後,透過網站下單購買了同一款帽子和一件上衣。即使消費者購買了 2 項產品,仍只會計為 1 筆訂單。您必須將透過購物車資料回報的轉換列入報表,才能使用這項指標。 |
averageOrderValueMicros |
「平均訂單價值」是指廣告促成每筆訂單帶來的平均收益。運作方式:消費者在網站上完成購物後,由您將透過購物車資料回報的轉換列入報表。「平均訂單價值」是訂單總收益除以訂單總數所得的值。例如:您收到 3 筆訂單,收益分別為 NT $300 元、NT$450 元和 NT $600 元,平均訂單價值就是 $15 美元 = ($10 美元 + $15 美元 + $20 美元)/3。您必須將透過購物車資料回報的轉換列入報表,才能使用這項指標。 |
averageCartSize |
「購物車內平均商品數」是指廣告所帶來每筆訂單中的平均產品數量。運作方式:消費者在網站上完成購物後,由您將透過購物車資料回報的轉換列入報表。「平均購物車內商品數量」是售出的產品總數除以收到的訂單總數所得的值。例如:您收到 2 筆訂單,第一筆有 3 項產品,第二筆有 2 項,平均購物車內商品數量就是 2.5 項產品 = (3+2)/2。您必須將透過購物車資料回報的轉換列入報表,才能使用這項指標。 |
costOfGoodsSoldMicros |
「銷貨成本」(COGS) 是指廣告訂單中售出的產品所產生的總成本。運作方式:您可以在 Merchant Center 中,為每項產品新增銷貨成本價值。如果您將透過購物車資料回報的轉換列入報表,系統便會比對售出的產品及相關銷貨成本價值,並根據這項資料計算每筆訂單產生的毛利。範例:使用者按下了帽子的購物廣告,隨後購買了同一款帽子和一件上衣。帽子的銷貨成本價值是 $3 美元,上衣則是 $5 美元。這筆訂單的銷貨成本計算方式為 NT $90 元 + NT $150 元 = NT $240 元。您必須將透過購物車資料回報的轉換列入報表,才能使用這項指標。 |
grossProfitMicros |
「毛利」是指扣除銷貨成本 (COGS) 後,廣告訂單所產生的利潤。運作方式:毛利是指扣除銷貨成本後,廣告銷售所帶來的收益。計算毛利時,只會納入 Merchant Center 中具有銷貨成本價值的產品。例如:消費者點按帽子的購物廣告後,透過網站下單購買了同一款帽子和一件上衣。帽子的售價是 NT$300 元,上衣則是 NT$600 元。帽子的銷貨成本價值是 $3 美元,但上衣不具銷貨成本價值。計算這筆訂單的毛利時,只會將帽子列入考量,計算方式為 NT $300 元 - NT $90 元 = NT$210 元。您必須將透過購物車資料回報的轉換列入報表,才能使用這項指標。 |
grossProfitMargin |
「毛利率」是指在扣除銷貨成本 (COGS) 後,廣告訂單所產生的毛利百分比。運作方式:消費者在網站上完成購物後,由您將透過購物車資料回報的轉換列入報表。「毛利率」是指產生的毛利除以總收益,再乘以 100% 所得出的值。計算毛利率時,只會納入 Merchant Center 中具有銷貨成本價值的產品。例如:消費者透過網站下單購買了一頂帽子和一件上衣。帽子的售價是 NT$300 元,銷貨成本價值則是 NT$90 元。上衣的售價是 $20 美元,但不具銷貨成本價值。帽子有銷貨成本價值,因此計算這筆訂單的毛利率時,只會將帽子列入考量,計算方式為 (NT$300 元 - NT$90 元)/NT$300 元 x 100% = 70%。您必須將透過購物車資料回報的轉換列入報表,才能使用這項指標。 |
revenueMicros |
「收益」是指廣告訂單所產生的總金額。運作方式:消費者在網站上完成購物後,由您將透過購物車資料回報的轉換列入報表。「收益」是指扣除任何折扣後,廣告的所有訂單帶來的總價值。例如:消費者點按帽子的購物廣告後,透過網站下單購買了同一款帽子和一件上衣。帽子的售價是 $10 美元,上衣則是 $20 美元。整筆訂單提供 $5 美元的折扣。這筆訂單的收益計算方式為 (NT $300 元 + NT$600 元) - NT $150 元 = NT$750 元。您必須將透過購物車資料回報的轉換列入報表,才能使用這項指標。 |
unitsSold |
「商品售出數量」是指因廣告而獲得的訂單中的售出產品總數。運作方式:消費者在網站上完成購物後,由您將透過購物車資料回報的轉換列入報表。「商品售出數量」是指因廣告而獲得的所有訂單中的售出產品總數。舉例來說,消費者點按帽子的購物廣告後,購買了同一款帽子、一件上衣和一件夾克。這筆訂單的商品售出數量為 3 個。您必須將透過購物車資料回報的轉換列入報表,才能使用這項指標。 |
crossSellCostOfGoodsSoldMicros |
「交叉銷售銷貨成本」(COGS) 是指因廣告宣傳某項產品而售出其他產品所產生的總成本。運作方式:消費者在網站上完成購物後,由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」),系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符,就屬於交叉銷售。「交叉銷售銷貨成本」是指所售出非宣傳產品的總費用。範例:使用者按下了帽子的購物廣告,隨後購買了同一款帽子和一件上衣。帽子的銷貨成本價值是 $3 美元,上衣則是 $5 美元。這筆訂單的交叉銷售銷貨成本為 NT $150 元。您必須將透過購物車資料回報的轉換列入報表,才能使用這項指標。 |
crossSellGrossProfitMicros |
「交叉銷售毛利」是指扣除銷貨成本 (COGS) 後,因廣告宣傳某項產品而售出其他產品所產生的利潤。運作方式:消費者在網站上完成購物後,由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」),系統就會將這項產品視為宣傳的產品。購買清單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符,就屬於交叉銷售。「交叉銷售毛利」是指扣除銷貨成本後,廣告中交叉銷售所帶來的收益。範例:使用者按下了帽子的購物廣告,隨後購買了同一款帽子和一件上衣。上衣的售價是 NT$600 元,銷貨成本價值則是 NT$150 元。這筆訂單的交叉銷售毛利計算方式為 NT $600 元 - NT $150 元 = NT$450 元。您必須將透過購物車資料回報的轉換列入報表,才能使用這項指標。 |
crossSellRevenueMicros |
「交叉銷售收益」是指因廣告宣傳某項產品而售出其他產品所賺取的總金額。運作方式:消費者在網站上完成購物後,由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」),系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符,就屬於交叉銷售。「交叉銷售收益」是指廣告中交叉銷售所產生的總價值。範例:使用者按下了帽子的購物廣告,隨後購買了同一款帽子和一件上衣。帽子的售價是 $10 美元,上衣則是 $20 美元。這筆訂單的交叉銷售收益為 NT $600 元。您必須將透過購物車資料回報的轉換列入報表,才能使用這項指標。 |
crossSellUnitsSold |
「交叉銷售商品售出數量」是指因廣告宣傳某項產品而售出的其他產品總數。運作方式:消費者在網站上完成購物後,由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」),系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符,就屬於交叉銷售。「交叉銷售商品售出數量」是指廣告的所有訂單帶來的交叉銷售產品總數。舉例來說,消費者點按帽子的購物廣告後,購買了同一款帽子、一件上衣和一件夾克。這筆訂單的交叉銷售商品售出數量為 2。您必須將透過購物車資料回報的轉換列入報表,才能使用這項指標。 |
leadCostOfGoodsSoldMicros |
「廣告產品銷貨成本」(COGS) 是指因廣告宣傳產品而售出該產品的總成本。運作方式:消費者在網站上完成購物後,由您將透過購物車資料回報的轉換列入報表。如果使用者互動的廣告含有相關產品 (請參閱「購物廣告」),系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符,這些商品的成本就會計入廣告產品銷貨成本。範例:使用者按下了帽子的購物廣告,隨後購買了同一款帽子和一件上衣。帽子的銷貨成本價值是 $3 美元,上衣則是 $5 美元。這筆訂單的廣告產品銷貨成本為 NT $90 元。您必須將透過購物車資料回報的轉換列入報表,才能使用這項指標。 |
leadGrossProfitMicros |
「廣告產品毛利」是指扣除銷貨成本 (COGS) 後,因廣告宣傳產品而售出該產品所產生的利潤。運作方式:消費者在網站上完成購物後,由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」),系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符,產生的銷售收益扣除銷貨成本,就是廣告產品毛利。範例:使用者按下了帽子的購物廣告,隨後購買了同一款帽子和一件上衣。帽子的售價是 NT$300 元,銷貨成本價值則是 NT$90 元。這筆訂單的廣告產品毛利計算方式為 NT $300 元 - NT $90 元 = NT$210 元。您必須將透過購物車資料回報的轉換列入報表,才能使用這項指標。 |
leadRevenueMicros |
「廣告產品收益」是指因廣告宣傳產品而售出該產品所賺取的總金額。運作方式:消費者在網站上完成購物後,由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」),系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符,廣告產品收益中就會顯示這些產品的銷售總價值。範例:使用者按下了帽子的購物廣告,隨後購買了同一款帽子和一件上衣。帽子的售價是 $10 美元,上衣則是 $20 美元。這筆訂單的廣告產品收益為 NT $300 元。您必須將透過購物車資料回報的轉換列入報表,才能使用這項指標。 |
leadUnitsSold |
「廣告商品售出數量」是指因廣告宣傳產品而售出的該產品總數。運作方式:消費者在網站上完成購物後,由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」),系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符,廣告商品售出數量中就會顯示售出產品總數。舉例來說,消費者點按帽子的購物廣告後,購買了同一款帽子、一件上衣和一件夾克。這筆訂單的廣告商品售出數量為 1。您必須將透過購物車資料回報的轉換列入報表,才能使用這項指標。 |
uniqueUsers |
在指定的時間範圍內,看過您廣告的不重複使用者人數。這項指標無法匯總,且只能要求在 92 天以下的日期範圍。這項指標適用於以下類型的廣告活動:多媒體、影片、探索和應用程式。 |
averageImpressionFrequencyPerUser |
在指定時間範圍內,不重複使用者看到您廣告的平均次數。這項指標無法匯總,且只能要求在 92 天以下的日期範圍。這項指標適用於以下類型的廣告活動:多媒體、影片、探索和應用程式。 |
InteractionEventType
列舉可能的應付費和免費互動類型。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
CLICK |
按一下網站。在多數情況下,系統會將這項互動導向外部位置,通常是廣告客戶的到達網頁。也是點擊事件的預設 InteractionEventType。 |
ENGAGEMENT |
使用者表示有意與廣告互動。 |
VIDEO_VIEW |
使用者看過影片廣告。 |
NONE |
廣告轉換事件的預設 InteractionEventType。如果廣告轉換列「並未」表示免費互動 (例如廣告轉換) 應「宣傳」並記錄在核心指標中,就需要使用這項指標。這些轉換就是其他 (廣告) 轉換。 |
SearchVolumeRange
搜尋量範圍。實際搜尋量落在這個範圍內。
JSON 表示法 |
---|
{ "min": string, "max": string } |
欄位 | |
---|---|
min |
搜尋量下限。 |
max |
搜尋量上限。 |
路段
僅限區隔的欄位。
JSON 表示法 |
---|
{ "adDestinationType": enum ( |
欄位 | |
---|---|
adDestinationType |
廣告到達網頁類型。 |
adNetworkType |
廣告聯播網類型。 |
budgetCampaignAssociationStatus |
預算廣告活動連結狀態。 |
clickType |
Click type. |
conversionActionCategory |
轉換動作類別。 |
conversionAttributionEventType |
轉換歸因事件類型。 |
conversionLagBucket |
列舉值,代表曝光到轉換之間經過的天數。 |
conversionOrAdjustmentLagBucket |
列舉值,代表曝光與轉換之間,或曝光與轉換調整之間經過的天數。 |
dayOfWeek |
星期幾,例如 MONDAY。 |
device |
要套用指標的裝置。 |
externalConversionSource |
外部轉換來源。 |
hotelCheckInDayOfWeek |
飯店入住日期。 |
hotelDateSelectionType |
飯店日期選取類型。 |
hotelRateType |
飯店房價類型。 |
hotelPriceBucket |
飯店價格區間。 |
keyword |
關鍵字條件。 |
monthOfYear |
月份,例如 1 月。 |
placeholderType |
預留位置類型。這個指標只會用於動態饋給項目指標。 |
productChannel |
產品的頻道。 |
productChannelExclusivity |
產品的通路獨佔性。 |
productCondition |
產品狀況, |
recommendationType |
建議類型。 |
searchEngineResultsPageType |
搜尋引擎結果網頁的類型。 |
searchTermMatchType |
觸發廣告的關鍵字比對類型 (包括變體)。 |
slot |
廣告的位置。 |
conversionValueRulePrimaryDimension |
已套用轉換價值規則的主要維度。NO_RULE_APPLIED 會顯示未套用價值規則的轉換所記錄的總價值。「原始」會顯示已套用價值規則的轉換原始價值。GEO_LOCATION、DEVICE,目標對象會顯示套用價值規則後的淨調整項。 |
skAdNetworkUserType |
iOS Store Kit 廣告聯播網使用者類型。 |
skAdNetworkAdEventType |
iOS Store Kit 廣告聯播網廣告事件類型。 |
skAdNetworkAttributionCredit |
iOS Store Kit Kit 廣告聯播網歸因功勞 |
skAdNetworkCoarseConversionValue |
iOS Store Kit 廣告聯播網概略的轉換價值。 |
skAdNetworkSourceType |
顯示帶來 iOS Store Kit Kit Network Network 安裝的廣告的來源類型。空值代表區隔不適用,例如非 iOS 廣告活動,或來源網域和來源應用程式都不在 Apple 傳送的回傳中。 |
newVersusReturningCustomers |
這項功能的用途是按照使用者是新客戶或回訪客戶來區隔轉換。這類區隔通常用於評估獲取新客目標的影響。 |
activityAccountId |
活動帳戶 ID。 |
activityCity |
提供旅遊活動的城市。 |
activityCountry |
提供旅遊活動的國家/地區。 |
activityRating |
活動評分。 |
activityState |
提供旅遊活動的國家/地區。 |
externalActivityId |
廣告主提供的活動編號。 |
adGroup |
廣告群組的資源名稱。 |
assetGroup |
素材資源群組的資源名稱。 |
auctionInsightDomain |
競價分析報表中參與者的網域 (可見網址)。 |
campaign |
廣告活動的資源名稱。 |
conversionAction |
轉換動作的資源名稱。 |
conversionActionName |
轉換動作名稱。 |
conversionAdjustment |
系統會按照原始轉換和轉換價值,以及若經過調整後的差異值,區隔轉換欄。虛列資料則符合原本所述的方式;但「true」列現在的資料和原本說明的資料有差異。加總這兩者的調整後資料。 |
date |
指標適用的日期。格式為 yyyy-MM-dd,例如「2018-04-17」。 |
geoTargetAirport |
代表機場的指定地理區域常數資源名稱。 |
geoTargetCanton |
代表行政區的指定地理區域常數資源名稱。 |
geoTargetCity |
地理目標常數的資源名稱,該常數代表城市。 |
geoTargetCountry |
代表國家/地區的指定地理區域常數資源名稱。 |
geoTargetCounty |
代表郡/縣的指定地理區域常數資源名稱。 |
geoTargetDistrict |
指定地理區域常數的資源名稱,該常數代表區域。 |
geoTargetMetro |
代表都會區的指定地理區域常數資源名稱。 |
geoTargetMostSpecificLocation |
指定地理區域常數的資源名稱,代表最明確的位置。 |
geoTargetPostalCode |
代表郵遞區號的指定地理區域常數資源名稱。 |
geoTargetProvince |
代表州/省的指定地理區域常數資源名稱。 |
geoTargetRegion |
代表區域的指定地理區域常數資源名稱。 |
geoTargetState |
代表狀態的指定地理區域常數資源名稱。 |
hotelBookingWindowDays |
飯店預訂期 (天)。 |
hotelCenterId |
Hotel Center ID。 |
hotelCheckInDate |
飯店入住日期。格式為「yyyy-MM-dd」。 |
hotelCity |
旅館所在城市。 |
hotelClass |
飯店星級。 |
hotelCountry |
旅館所在國家/地區。 |
hotelLengthOfStay |
飯店入住天數。 |
hotelRateRuleId |
飯店房價規則 ID。 |
hotelState |
旅館所在州/省。 |
hour |
時段,以 0 到 23 (含) 之間的數字表示。 |
interactionOnThisExtension |
只搭配動態饋給項目指標使用。指出互動指標是發生在動態饋給項目本身,還是其他額外資訊/廣告單元上。 |
month |
以每月第一天的日期表示的月份。格式為「yyyy-MM-dd」。 |
partnerHotelId |
合作夥伴飯店 ID。 |
productAggregatorId |
產品的集結網站 ID。 |
productCategoryLevel1 |
產品的類別 (第 1 級)。 |
productCategoryLevel2 |
產品的類別 (第 2 層)。 |
productCategoryLevel3 |
產品的類別 (第 3 級)。 |
productCategoryLevel4 |
產品的類別 (第 4 級)。 |
productCategoryLevel5 |
產品的類別 (第 5 層)。 |
productBrand |
產品的品牌。 |
productCountry |
產品銷售國家/地區的指定地理區域常數資源名稱。 |
productCustomAttribute0 |
產品的自訂屬性 0。 |
productCustomAttribute1 |
產品的自訂屬性 1。 |
productCustomAttribute2 |
產品的自訂屬性 2。 |
productCustomAttribute3 |
產品的自訂屬性 3。 |
productCustomAttribute4 |
產品的自訂屬性 4。 |
productFeedLabel |
產品的動態饋給標籤。 |
productItemId |
產品的項目 ID。 |
productLanguage |
產品語言的語言常數資源名稱。 |
productMerchantId |
產品的商家 ID。 |
productStoreId |
產品的商店 ID。 |
productTitle |
產品的標題。 |
productTypeL1 |
產品的類型 (第 1 級)。 |
productTypeL2 |
產品的類型 (第 2 級)。 |
productTypeL3 |
產品的類型 (第 3 級)。 |
productTypeL4 |
產品的類型 (第 4 級)。 |
productTypeL5 |
產品的類型 (第 5 級)。 |
quarter |
季度,以季度第一天的日期表示。使用當季季度,例如 2018 年第二季是從 2018 年 4 月 1 日開始。格式為「yyyy-MM-dd」。 |
searchSubcategory |
搜尋字詞子類別。如果搜尋字詞不適用於其他子類別,則代表不涵蓋該子類別的搜尋字詞。 |
searchTerm |
搜尋字詞。 |
webpage |
代表網頁條件的廣告群組條件資源名稱。 |
week |
一週的定義為星期一到星期日,以星期一的日期表示。格式為「yyyy-MM-dd」。 |
year |
年,格式為 yyyy。 |
skAdNetworkConversionValue |
iOS Store Kit 廣告聯播網轉換價值。空值代表此區隔不適用,例如非 iOS 廣告活動。 |
skAdNetworkSourceApp |
應用程式在何處顯示帶來 iOS Store Kit Kit Network Network 安裝的廣告。空值代表此區隔不適用 (例如非 iOS 廣告活動),或是 Apple 傳送的任何回傳中都不包含這個區隔。 |
skAdNetworkSourceDomain |
顯示帶來 iOS Store Kit Kit Network Network 安裝的廣告所在的網站。空值代表此區隔不適用 (例如非 iOS 廣告活動),或是 Apple 傳送的任何回傳中都不包含這個區隔。 |
skAdNetworkPostbackSequenceIndex |
iOS Store Kit 廣告聯播網回傳序列索引。 |
assetInteractionTarget |
只搭配 CustomerAsset、CampaignAsset 和 adAsset 指標使用。指出互動指標是發生在素材資源本身,還是其他素材資源/廣告單元上。當廣告放送的所有部分 (例如「廣告本身」和「網站連結」等其他元件) 一起放送時,系統會將互動 (例如點擊) 計算在內。如果 engagementOnThisAsset 為 true,代表互動位於此特定素材資源,當 engagementOnThisAsset 為 False 時,代表互動並非在特定素材資源上,而是在放送這項素材資源的其他部分發生。 |
AdDestinationType
列舉 Google Ads 目的地類型
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
這個版本無法辨識這個值。 |
NOT_APPLICABLE |
廣告不會將使用者帶往其他到達網頁 |
WEBSITE |
網站 |
APP_DEEP_LINK |
應用程式深層連結 |
APP_STORE |
iOS App Store 或 Play 商店 |
PHONE_CALL |
通話撥號 |
MAP_DIRECTIONS |
地圖應用程式 |
LOCATION_LISTING |
位置資訊專用網頁 |
MESSAGE |
文字訊息 |
LEAD_FORM |
待開發客戶產生表單 |
YOUTUBE |
YouTube |
UNMODELED_FOR_CONVERSIONS |
包含不明鍵的轉換廣告到達網頁 |
AdNetworkType
列舉 Google Ads 聯播網類型。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
這個版本無法辨識這個值。 |
SEARCH |
Google 搜尋。 |
SEARCH_PARTNERS |
搜尋聯播網夥伴。 |
CONTENT |
您廣告的位置 |
MIXED |
跨聯播網。 |
YOUTUBE |
YouTube |
GOOGLE_TV |
Google TV |
BudgetCampaignAssociationStatus
「BudgetCampaignAssociationStatus」區隔。
JSON 表示法 |
---|
{
"status": enum ( |
欄位 | |
---|---|
status |
預算廣告活動連結狀態。 |
campaign |
廣告活動資源名稱。 |
BudgetCampaignAssociationStatus
預算與廣告活動之間的關聯狀態。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
ENABLED |
廣告活動目前使用預算。 |
REMOVED |
廣告活動已不再使用該預算。 |
ClickType
列舉 Google Ads 點擊類型。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
這個版本無法辨識這個值。 |
APP_DEEPLINK |
應用程式參與式廣告深層連結。 |
BREADCRUMBS |
導覽標記。 |
BROADBAND_PLAN |
寬頻方案。 |
CALL_TRACKING |
手動撥打的電話。 |
CALLS |
。 |
CLICK_ON_ENGAGEMENT_AD |
點按參與式廣告。 |
GET_DIRECTIONS |
行車路線。 |
LOCATION_EXPANSION |
取得地點詳細資料。 |
LOCATION_FORMAT_CALL |
。 |
LOCATION_FORMAT_DIRECTIONS |
。 |
LOCATION_FORMAT_IMAGE |
圖片。 |
LOCATION_FORMAT_LANDING_PAGE |
前往到達網頁。 |
LOCATION_FORMAT_MAP |
地圖。 |
LOCATION_FORMAT_STORE_INFO |
前往商店資訊。 |
LOCATION_FORMAT_TEXT |
文字。 |
MOBILE_CALL_TRACKING |
行動通話。 |
OFFER_PRINTS |
列印優惠。 |
OTHER |
其他。 |
PRODUCT_EXTENSION_CLICKS |
產品加號方塊優惠。 |
PRODUCT_LISTING_AD_CLICKS |
購物 - 產品 - 線上。 |
SITELINKS |
網站連結。 |
STORE_LOCATOR |
顯示附近門市。 |
URL_CLICKS |
廣告標題。 |
VIDEO_APP_STORE_CLICKS |
App Store。 |
VIDEO_CALL_TO_ACTION_CLICKS |
行動號召重疊廣告。 |
VIDEO_CARD_ACTION_HEADLINE_CLICKS |
資訊卡。 |
VIDEO_END_CAP_CLICKS |
結尾展示畫面。 |
VIDEO_WEBSITE_CLICKS |
網站。 |
VISUAL_SITELINKS |
視覺網站連結。 |
WIRELESS_PLAN |
無線網路方案。 |
PRODUCT_LISTING_AD_LOCAL |
購物 - 產品 - 本地。 |
PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL |
購物 - 產品 - 多管道本地。 |
PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE |
購物 - 產品 - 多管道線上。 |
PRODUCT_LISTING_ADS_COUPON |
購物 - 產品 - 優待券。 |
PRODUCT_LISTING_AD_TRANSACTABLE |
購物 - 產品 - 在 Google 上銷售。 |
PRODUCT_AD_APP_DEEPLINK |
購物 - 產品 - 應用程式參與式廣告深層連結。 |
SHOWCASE_AD_CATEGORY_LINK |
購物 - 展示 - 類別。 |
SHOWCASE_AD_LOCAL_STOREFRONT_LINK |
購物 - 展示 - 本地店面。 |
SHOWCASE_AD_ONLINE_PRODUCT_LINK |
購物 - 展示 - 線上產品。 |
SHOWCASE_AD_LOCAL_PRODUCT_LINK |
購物 - 展示 - 店面商品。 |
PROMOTION_EXTENSION |
促銷額外資訊。 |
SWIPEABLE_GALLERY_AD_HEADLINE |
廣告標題。 |
SWIPEABLE_GALLERY_AD_SWIPES |
滑動。 |
SWIPEABLE_GALLERY_AD_SEE_MORE |
歡迎瞭解詳情。 |
SWIPEABLE_GALLERY_AD_SITELINK_ONE |
網站連結 1. |
SWIPEABLE_GALLERY_AD_SITELINK_TWO |
網站連結 2. |
SWIPEABLE_GALLERY_AD_SITELINK_THREE |
網站連結 3. |
SWIPEABLE_GALLERY_AD_SITELINK_FOUR |
網站連結 4. |
SWIPEABLE_GALLERY_AD_SITELINK_FIVE |
網站連結 5: |
HOTEL_PRICE |
飯店房價。 |
PRICE_EXTENSION |
價格額外資訊。 |
HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION |
在 Google 上預訂的飯店房間選項。 |
SHOPPING_COMPARISON_LISTING |
購物 - 比較商家資訊。 |
CROSS_NETWORK |
跨聯播網。來自最高成效廣告活動和探索廣告活動。 |
ConversionAttributionEventType
歸因的轉換事件類型。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
代表這個版本未知的值。 |
IMPRESSION |
系統會將轉換歸因於曝光。 |
INTERACTION |
轉換歸因於互動。 |
ConversionLagBucket
列舉表示曝光到轉換之間經過的天數。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
LESS_THAN_ONE_DAY |
轉換時間差區間從 0 到 1 天。包含 0 天,不包含 1 天。 |
ONE_TO_TWO_DAYS |
轉換時間差區間從 1 到 2 天。包含 1 天,不包含 2 天。 |
TWO_TO_THREE_DAYS |
轉換時間差區間從 2 到 3 天。包含 2 天,不包含 3 天。 |
THREE_TO_FOUR_DAYS |
轉換時間差區間從 3 到 4 天。包含 3 天,不包含 4 天。 |
FOUR_TO_FIVE_DAYS |
轉換時間差區間從 4 到 5 天。包含 4 天,不含 5 天。 |
FIVE_TO_SIX_DAYS |
轉換時間差區間從 5 到 6 天。包含 5 天,不含 6 天。 |
SIX_TO_SEVEN_DAYS |
轉換時間差區間從 6 到 7 天。包含 6 天,不包含 7 天。 |
SEVEN_TO_EIGHT_DAYS |
轉換時間差區間從 7 天到 8 天。包含 7 天,不包含 8 天。 |
EIGHT_TO_NINE_DAYS |
轉換時間差區間從 8 天到 9 天。包含 8 天,不包含 9 天。 |
NINE_TO_TEN_DAYS |
轉換時間差區間從 9 到 10 天。包含 9 天,不包含 10 天。 |
TEN_TO_ELEVEN_DAYS |
轉換時間差區間從 10 到 11 天。包含 10 天,不包含 11 天。 |
ELEVEN_TO_TWELVE_DAYS |
轉換時間差區間從 11 天到 12 天。包含 11 天,不包含 12 天。 |
TWELVE_TO_THIRTEEN_DAYS |
轉換時間差區間從 12 到 13 天。包含 12 天,不包含 13 天。 |
THIRTEEN_TO_FOURTEEN_DAYS |
轉換時間差區間從 13 到 14 天。包含 13 天,不包含 14 天。 |
FOURTEEN_TO_TWENTY_ONE_DAYS |
轉換時間差區間從 14 至 21 天。包含 14 天,不包含 21 天。 |
TWENTY_ONE_TO_THIRTY_DAYS |
轉換時間差區間從 21 到 30 天。包含 21 天,不包含 30 天。 |
THIRTY_TO_FORTY_FIVE_DAYS |
轉換時間差區間從 30 到 45 天。包含 30 天,不包含 45 天。 |
FORTY_FIVE_TO_SIXTY_DAYS |
轉換時間差區間從 45 天到 60 天。包含 45 天,不包含 60 天。 |
SIXTY_TO_NINETY_DAYS |
轉換時間差區間從 60 天到 90 天。包含 60 天,不包含 90 天。 |
ConversionOrAdjustmentLagBucket
列舉代表從曝光到轉換之間,或曝光與轉換調整之間經過的天數。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
CONVERSION_LESS_THAN_ONE_DAY |
轉換時間差區間從 0 到 1 天。包含 0 天,不包含 1 天。 |
CONVERSION_ONE_TO_TWO_DAYS |
轉換時間差區間從 1 到 2 天。包含 1 天,不包含 2 天。 |
CONVERSION_TWO_TO_THREE_DAYS |
轉換時間差區間從 2 到 3 天。包含 2 天,不包含 3 天。 |
CONVERSION_THREE_TO_FOUR_DAYS |
轉換時間差區間從 3 到 4 天。包含 3 天,不包含 4 天。 |
CONVERSION_FOUR_TO_FIVE_DAYS |
轉換時間差區間從 4 到 5 天。包含 4 天,不含 5 天。 |
CONVERSION_FIVE_TO_SIX_DAYS |
轉換時間差區間從 5 到 6 天。包含 5 天,不含 6 天。 |
CONVERSION_SIX_TO_SEVEN_DAYS |
轉換時間差區間從 6 到 7 天。包含 6 天,不包含 7 天。 |
CONVERSION_SEVEN_TO_EIGHT_DAYS |
轉換時間差區間從 7 天到 8 天。包含 7 天,不包含 8 天。 |
CONVERSION_EIGHT_TO_NINE_DAYS |
轉換時間差區間從 8 天到 9 天。包含 8 天,不包含 9 天。 |
CONVERSION_NINE_TO_TEN_DAYS |
轉換時間差區間從 9 到 10 天。包含 9 天,不包含 10 天。 |
CONVERSION_TEN_TO_ELEVEN_DAYS |
轉換時間差區間從 10 到 11 天。包含 10 天,不包含 11 天。 |
CONVERSION_ELEVEN_TO_TWELVE_DAYS |
轉換時間差區間從 11 天到 12 天。包含 11 天,不包含 12 天。 |
CONVERSION_TWELVE_TO_THIRTEEN_DAYS |
轉換時間差區間從 12 到 13 天。包含 12 天,不包含 13 天。 |
CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS |
轉換時間差區間從 13 到 14 天。包含 13 天,不包含 14 天。 |
CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS |
轉換時間差區間從 14 至 21 天。包含 14 天,不包含 21 天。 |
CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS |
轉換時間差區間從 21 到 30 天。包含 21 天,不包含 30 天。 |
CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS |
轉換時間差區間從 30 到 45 天。包含 30 天,不包含 45 天。 |
CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS |
轉換時間差區間從 45 天到 60 天。包含 45 天,不包含 60 天。 |
CONVERSION_SIXTY_TO_NINETY_DAYS |
轉換時間差區間從 60 天到 90 天。包含 60 天,不包含 90 天。 |
ADJUSTMENT_LESS_THAN_ONE_DAY |
轉換調整項時間差區間介於 0 至 1 天。包含 0 天,不包含 1 天。 |
ADJUSTMENT_ONE_TO_TWO_DAYS |
轉換調整項時間差區間介於 1 至 2 天。包含 1 天,不包含 2 天。 |
ADJUSTMENT_TWO_TO_THREE_DAYS |
轉換調整項時間差區間介於 2 至 3 天。包含 2 天,不包含 3 天。 |
ADJUSTMENT_THREE_TO_FOUR_DAYS |
轉換調整項時間差區間介於 3 至 4 天。包含 3 天,不包含 4 天。 |
ADJUSTMENT_FOUR_TO_FIVE_DAYS |
轉換調整項時間差區間介於 4 至 5 天。包含 4 天,不含 5 天。 |
ADJUSTMENT_FIVE_TO_SIX_DAYS |
轉換調整項時間差區間介於 5 至 6 天。包含 5 天,不含 6 天。 |
ADJUSTMENT_SIX_TO_SEVEN_DAYS |
轉換調整項時間差區間介於 6 至 7 天。包含 6 天,不包含 7 天。 |
ADJUSTMENT_SEVEN_TO_EIGHT_DAYS |
轉換調整項時間差區間介於 7 至 8 天。包含 7 天,不包含 8 天。 |
ADJUSTMENT_EIGHT_TO_NINE_DAYS |
轉換調整項時間差區間介於 8 至 9 天。包含 8 天,不包含 9 天。 |
ADJUSTMENT_NINE_TO_TEN_DAYS |
轉換調整項時間差區間介於 9 至 10 天。包含 9 天,不包含 10 天。 |
ADJUSTMENT_TEN_TO_ELEVEN_DAYS |
轉換調整項時間差區間介於 10 至 11 天。包含 10 天,不包含 11 天。 |
ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS |
轉換調整項時間差區間介於 11 至 12 天。包含 11 天,不包含 12 天。 |
ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS |
轉換調整項時間差區間介於 12 至 13 天。包含 12 天,不包含 13 天。 |
ADJUSTMENT_THIRTEEN_TO_FOURTEEN_DAYS |
轉換調整項時間差區間介於 13 至 14 天。包含 13 天,不包含 14 天。 |
ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS |
轉換調整項時間差區間介於 14 至 21 天。包含 14 天,不包含 21 天。 |
ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS |
轉換調整項時間差區間介於 21 至 30 天。包含 21 天,不包含 30 天。 |
ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS |
轉換調整項時間差區間介於 30 至 45 天。包含 30 天,不包含 45 天。 |
ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS |
轉換調整項時間差區間介於 45 至 60 天。包含 45 天,不包含 60 天。 |
ADJUSTMENT_SIXTY_TO_NINETY_DAYS |
轉換調整項時間差介於 60 到 90 天。包含 60 天,不包含 90 天。 |
ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS |
轉換調整項時間差介於 90 到 145 天。包含 90 天,不包含 145 天。 |
CONVERSION_UNKNOWN |
轉換時間差類別 UNKNOWN。這是指在 Google Ads 支援轉換時間差區間之前的日期。 |
ADJUSTMENT_UNKNOWN |
轉換調整項時間差類別 UNKNOWN。這是指在 Google Ads 支援轉換調整項時間差區間之前的日期。 |
ExternalConversionSource
與 ConversionAction 相關聯的外部轉換來源。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
代表這個版本未知的值。 |
WEBPAGE |
這是指使用者在觀看廣告後前往特定網頁時發生的轉換;在 Google Ads 使用者介面中會顯示為「網站」。 |
ANALYTICS |
轉換來自已連結的 Google Analytics (分析) 目標或交易,在 Google Ads 使用者介面中會顯示為「Analytics (分析)」。 |
UPLOAD |
透過 ConversionUploadService 上傳的網站轉換;在 Google Ads 使用者介面中會顯示為「從點擊次數匯入」。 |
AD_CALL_METRICS |
這是指使用者直接在廣告上點按來電額外資訊時產生的轉換,在 Google Ads 使用者介面中會顯示為「廣告轉接來電」。 |
WEBSITE_CALL_METRICS |
轉換是指使用者在按下廣告後,從廣告客戶的網站撥打動態產生的電話號碼 (透過安裝 JavaScript),接著在 Google Ads 使用者介面中顯示為「網站來電」。 |
STORE_VISITS |
這是指使用者在點擊 Google 廣告後造訪廣告主的零售商店,並在 Google Ads 使用者介面中顯示為「親臨門市」。 |
ANDROID_IN_APP |
使用者採取應用程式內動作時發生的轉換,例如在 Android 應用程式中完成購買;在 Google Ads 使用者介面中顯示為「Android 應用程式內動作」。 |
IOS_IN_APP |
使用者採取應用程式內動作時發生的轉換,例如在 iOS 應用程式中完成購買;在 Google Ads 使用者介面中顯示為「iOS 應用程式內動作」。 |
IOS_FIRST_OPEN |
這是指使用者首次開啟 iOS 應用程式時發生的轉換;在 Google Ads 使用者介面中,轉換會顯示為「iOS 應用程式安裝 (初次開啟)」。 |
APP_UNSPECIFIED |
未提供 AppPlatform 的舊版應用程式轉換;在 Google Ads UI 中顯示為「行動應用程式」。 |
ANDROID_FIRST_OPEN |
這是指使用者首次開啟 Android 應用程式時發生的轉換;在 Google Ads 使用者介面中會顯示為「Android 應用程式安裝 (初次開啟)」。 |
UPLOAD_CALLS |
透過 ConversionUploadService 上傳的來電轉換資料;在 Google Ads 使用者介面中會顯示為「從來電匯入」。 |
FIREBASE |
轉換來自已連結的 Firebase 事件;在 Google Ads UI 中會顯示為「Firebase」。 |
CLICK_TO_CALL |
這是指使用者點選手機號碼時發生的轉換,在 Google Ads 使用者介面中顯示為「電話號碼點擊」。 |
SALESFORCE |
轉換來自 Salesforce,在 Google Ads 使用者介面中會顯示為「Salesforce.com」。 |
STORE_SALES_CRM |
轉換來自客戶關係管理系統記錄的店內購物,在 Google Ads 使用者介面中會顯示為「商店銷售 (資料合作夥伴)」。 |
STORE_SALES_PAYMENT_NETWORK |
轉換來自付款聯播網的店內購物,在 Google Ads 使用者介面中會顯示為「商店銷售 (付款聯播網)」。 |
GOOGLE_PLAY |
無程式碼 Google Play 轉換;在 Google Ads 使用者介面中會顯示為「Google Play」。 |
THIRD_PARTY_APP_ANALYTICS |
轉換來自已連結的第三方應用程式分析事件;在 Google Ads 使用者介面中會顯示為「第三方應用程式分析」。 |
GOOGLE_ATTRIBUTION |
由 Google 歸因分析控制的轉換。 |
STORE_SALES_DIRECT_UPLOAD |
商店銷售轉換是根據第一方或第三方商家資料所上傳的。在 Google Ads 使用者介面中,顯示為「商店銷售 (直接上傳)」。 |
STORE_SALES |
根據上傳的第三方或第三方商家資料,和/或透過付款網路中的卡片在店內購物產生的商店銷售轉換。在 Google Ads 使用者介面中顯示為「商店銷售」。 |
SEARCH_ADS_360 |
從 Search Ads 360 Floodlight 資料匯入的轉換。 |
GOOGLE_HOSTED |
與廣告互動後,追蹤來自 Google 產品和服務的本地動作的轉換。 |
FLOODLIGHT |
Floodlight 代碼回報的轉換。 |
ANALYTICS_SEARCH_ADS_360 |
來自 Google Analytics (分析) 專為 Search Ads 360 提供的轉換。在 Google Ads 使用者介面中會顯示為 Analytics (分析) (SA360)。 |
FIREBASE_SEARCH_ADS_360 |
Search Ads 360 已連結 Firebase 事件帶來的轉換。 |
DISPLAY_AND_VIDEO_360_FLOODLIGHT |
Floodlight 針對 DV360 記錄的轉換。 |
HotelRateType
列舉可能的飯店房價類型。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
這個版本無法辨識這個值。 |
UNAVAILABLE |
無法提供費率類型資訊。 |
PUBLIC_RATE |
所有人都能查看房價。 |
QUALIFIED_RATE |
提供會員方案費率,並滿足基本條件,例如提供公開費率。UI 處理方式會依照公開費率加上刪除線,代表使用者可以享有折扣。如要進一步瞭解合格費率,請參閱:https://developers.google.com/hotels/hotel-ads/dev-guide/qualified-rates |
PRIVATE_RATE |
符合特定資格條件的使用者能享有的費率,例如所有登入使用者、20% 的行動裝置使用者、加拿大境內的所有行動裝置使用者等。 |
HotelPriceBucket
列舉可能的飯店價格區間。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
這個版本無法辨識這個值。 |
LOWEST_UNIQUE |
唯一最低價。合作夥伴的價格最低,且其他合作夥伴的價格不多。 |
LOWEST_TIED |
並列最低價。合作夥伴價格落在最低價差不多。 |
NOT_LOWEST |
並非最低價。合作夥伴的價格與最低價差不多。 |
ONLY_PARTNER_SHOWN |
是唯一顯示的合作夥伴。 |
關鍵字
關鍵字條件區隔。
JSON 表示法 |
---|
{
"info": {
object ( |
欄位 | |
---|---|
info |
關鍵字資訊。 |
adGroupCriterion |
廣告群組條件資源名稱。 |
SearchEngineResultsPageType
搜尋引擎結果網頁的類型。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
ADS_ONLY |
搜尋引擎結果網頁中只包含廣告。 |
ORGANIC_ONLY |
搜尋引擎結果網頁中只納入自然搜尋結果。 |
ADS_AND_ORGANIC |
廣告和自然搜尋結果都包含在搜尋引擎結果網頁中。 |
SearchTermMatchType
觸發廣告的關鍵字可能的比對類型 (包括變體)。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
BROAD |
廣泛比對。 |
EXACT |
完全比對。 |
PHRASE |
詞組比對。 |
NEAR_EXACT |
完全比對 (近似變體)。 |
NEAR_PHRASE |
詞組比對 (近似變體)。 |
運算單元
列舉廣告的可能位置。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
這個版本無法辨識這個值。 |
SEARCH_SIDE |
Google 搜尋:側邊。 |
SEARCH_TOP |
Google 搜尋:頂端。 |
SEARCH_OTHER |
Google 搜尋:其他。 |
CONTENT |
Google 多媒體廣告聯播網 |
SEARCH_PARTNER_TOP |
搜尋聯播網夥伴:頂端。 |
SEARCH_PARTNER_OTHER |
搜尋聯播網夥伴:其他。 |
MIXED |
跨聯播網。 |
ConversionValueRulePrimaryDimension
識別轉換價值規則統計資料的主要維度。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
NO_RULE_APPLIED |
適用於啟用價值規則後未套用價值規則的轉換。 |
ORIGINAL |
以下是套用價值規則的轉換:原始統計資料。 |
NEW_VS_RETURNING_USER |
符合新客戶或回訪顧客條件時。 |
GEO_LOCATION |
符合查詢時間地理位置條件時。 |
DEVICE |
符合查詢時瀏覽裝置條件時。 |
AUDIENCE |
符合查詢時目標對象條件時。 |
MULTIPLE |
套用多項規則時。 |
SkAdNetworkUserType
列舉 SkAdNetwork 使用者類型
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
這個版本無法辨識這個值。 |
UNAVAILABLE |
回傳中包含此值,或是我們基於其他原因而沒有這些資料。 |
NEW_INSTALLER |
使用者首次安裝應用程式。 |
REINSTALLER |
使用者先前已安裝應用程式。 |
SkAdNetworkAdEventType
列舉 SkAdNetwork 廣告事件類型
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
這個版本無法辨識這個值。 |
UNAVAILABLE |
回傳中包含此值,或是我們基於其他原因而沒有這些資料。 |
INTERACTION |
使用者與廣告互動。 |
VIEW |
使用者觀看廣告。 |
SkAdNetworkSourceApp
SkAdNetworkSourceApp 區隔。
JSON 表示法 |
---|
{ "skAdNetworkSourceAppId": string } |
欄位 | |
---|---|
skAdNetworkSourceAppId |
帶來 iOS Store Kit Kit Network Network 安裝的廣告所在的應用程式 ID。 |
SkAdNetworkAttributionCredit
列舉 SkAdNetwork 歸因抵免額。
列舉 | |
---|---|
UNSPECIFIED |
預設值。這個值等於空值。 |
UNKNOWN |
此 API 版本無法辨識這個值。這個 API 版本無法傳回 true 列舉值,或系統尚未支援。 |
UNAVAILABLE |
回傳中包含此值,或是我們基於其他原因而沒有這些資料。 |
WON |
Google 是贏得廣告標示的廣告聯播網。 |
CONTRIBUTED |
Google 符合歸因資格,但未獲勝。 |
SkAdNetworkSourceType
列舉 SkAdNetwork 來源類型
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
這個版本無法辨識這個值。 |
UNAVAILABLE |
回傳中包含來源應用程式 ID 或來源網域,或是我們基於其他原因而沒有這些資料。 |
WEBSITE |
廣告顯示在網頁上。 |
MOBILE_APPLICATION |
廣告已在應用程式中顯示。 |
AssetInteractionTarget
AssetInteractionTarget 區隔。
JSON 表示法 |
---|
{ "asset": string, "interactionOnThisAsset": boolean } |
欄位 | |
---|---|
asset |
資產資源名稱。 |
interactionOnThisAsset |
只搭配 CustomerAsset、CampaignAsset 和 adAsset 指標使用。指出互動指標是發生在素材資源本身,還是其他素材資源/廣告單元上。 |
ConvertingUserPriorEngagementTypeAndLtvBucket
列舉會轉換使用者先前的參與類型和生命週期價值區間
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
這個版本無法辨識這個值。 |
NEW |
廣告主第一次進行轉換。 |
RETURNING |
正在轉換的使用者將回到廣告主頁面。回訪的定義因轉換類型而異 (例如第二次親臨門市與第二次線上購物)。 |
NEW_AND_HIGH_LTV |
轉換新使用者是廣告主的新對象,生命週期價值很高。 |