GoogleAdsRow

Một hàng được trả về từ truy vấn.

Biểu diễn dưới dạng JSON 
{
  "accountBudget": {
    object (AccountBudget)
  },
  "accountBudgetProposal": {
    object (AccountBudgetProposal)
  },
  "accountLink": {
    object (AccountLink)
  },
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdAssetCombinationView": {
    object (AdGroupAdAssetCombinationView)
  },
  "adGroupAdAssetView": {
    object (AdGroupAdAssetView)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionCustomizer": {
    object (AdGroupCriterionCustomizer)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupCriterionSimulation": {
    object (AdGroupCriterionSimulation)
  },
  "adGroupCustomizer": {
    object (AdGroupCustomizer)
  },
  "adGroupExtensionSetting": {
    object (AdGroupExtensionSetting)
  },
  "adGroupFeed": {
    object (AdGroupFeed)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "adGroupSimulation": {
    object (AdGroupSimulation)
  },
  "adParameter": {
    object (AdParameter)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "adScheduleView": {
    object (AdScheduleView)
  },
  "domainCategory": {
    object (DomainCategory)
  },
  "asset": {
    object (Asset)
  },
  "assetFieldTypeView": {
    object (AssetFieldTypeView)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupProductGroupView": {
    object (AssetGroupProductGroupView)
  },
  "assetGroupTopCombinationView": {
    object (AssetGroupTopCombinationView)
  },
  "assetGroup": {
    object (AssetGroup)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "assetSetTypeView": {
    object (AssetSetTypeView)
  },
  "batchJob": {
    object (BatchJob)
  },
  "biddingDataExclusion": {
    object (BiddingDataExclusion)
  },
  "biddingSeasonalityAdjustment": {
    object (BiddingSeasonalityAdjustment)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "biddingStrategySimulation": {
    object (BiddingStrategySimulation)
  },
  "billingSetup": {
    object (BillingSetup)
  },
  "callView": {
    object (CallView)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignBidModifier": {
    object (CampaignBidModifier)
  },
  "campaignConversionGoal": {
    object (CampaignConversionGoal)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignCustomizer": {
    object (CampaignCustomizer)
  },
  "campaignDraft": {
    object (CampaignDraft)
  },
  "campaignExtensionSetting": {
    object (CampaignExtensionSetting)
  },
  "campaignFeed": {
    object (CampaignFeed)
  },
  "campaignGroup": {
    object (CampaignGroup)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "campaignLifecycleGoal": {
    object (CampaignLifecycleGoal)
  },
  "campaignSearchTermInsight": {
    object (CampaignSearchTermInsight)
  },
  "campaignSharedSet": {
    object (CampaignSharedSet)
  },
  "campaignSimulation": {
    object (CampaignSimulation)
  },
  "carrierConstant": {
    object (CarrierConstant)
  },
  "changeEvent": {
    object (ChangeEvent)
  },
  "changeStatus": {
    object (ChangeStatus)
  },
  "combinedAudience": {
    object (CombinedAudience)
  },
  "audience": {
    object (Audience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "conversionGoalCampaignConfig": {
    object (ConversionGoalCampaignConfig)
  },
  "conversionValueRule": {
    object (ConversionValueRule)
  },
  "conversionValueRuleSet": {
    object (ConversionValueRuleSet)
  },
  "clickView": {
    object (ClickView)
  },
  "currencyConstant": {
    object (CurrencyConstant)
  },
  "customAudience": {
    object (CustomAudience)
  },
  "customConversionGoal": {
    object (CustomConversionGoal)
  },
  "customInterest": {
    object (CustomInterest)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerAssetSet": {
    object (CustomerAssetSet)
  },
  "accessibleBiddingStrategy": {
    object (AccessibleBiddingStrategy)
  },
  "customerCustomizer": {
    object (CustomerCustomizer)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClientLink": {
    object (CustomerClientLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "customerConversionGoal": {
    object (CustomerConversionGoal)
  },
  "customerExtensionSetting": {
    object (CustomerExtensionSetting)
  },
  "customerFeed": {
    object (CustomerFeed)
  },
  "customerLabel": {
    object (CustomerLabel)
  },
  "customerLifecycleGoal": {
    object (CustomerLifecycleGoal)
  },
  "customerNegativeCriterion": {
    object (CustomerNegativeCriterion)
  },
  "customerSearchTermInsight": {
    object (CustomerSearchTermInsight)
  },
  "customerUserAccess": {
    object (CustomerUserAccess)
  },
  "customerUserAccessInvitation": {
    object (CustomerUserAccessInvitation)
  },
  "customizerAttribute": {
    object (CustomizerAttribute)
  },
  "detailPlacementView": {
    object (DetailPlacementView)
  },
  "detailedDemographic": {
    object (DetailedDemographic)
  },
  "displayKeywordView": {
    object (DisplayKeywordView)
  },
  "distanceView": {
    object (DistanceView)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "expandedLandingPageView": {
    object (ExpandedLandingPageView)
  },
  "extensionFeedItem": {
    object (ExtensionFeedItem)
  },
  "feed": {
    object (Feed)
  },
  "feedItem": {
    object (FeedItem)
  },
  "feedItemSet": {
    object (FeedItemSet)
  },
  "feedItemSetLink": {
    object (FeedItemSetLink)
  },
  "feedItemTarget": {
    object (FeedItemTarget)
  },
  "feedMapping": {
    object (FeedMapping)
  },
  "feedPlaceholderView": {
    object (FeedPlaceholderView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "geographicView": {
    object (GeographicView)
  },
  "groupPlacementView": {
    object (GroupPlacementView)
  },
  "hotelGroupView": {
    object (HotelGroupView)
  },
  "hotelPerformanceView": {
    object (HotelPerformanceView)
  },
  "hotelReconciliation": {
    object (HotelReconciliation)
  },
  "incomeRangeView": {
    object (IncomeRangeView)
  },
  "keywordView": {
    object (KeywordView)
  },
  "keywordPlan": {
    object (KeywordPlan)
  },
  "keywordPlanCampaign": {
    object (KeywordPlanCampaign)
  },
  "keywordPlanCampaignKeyword": {
    object (KeywordPlanCampaignKeyword)
  },
  "keywordPlanAdGroup": {
    object (KeywordPlanAdGroup)
  },
  "keywordPlanAdGroupKeyword": {
    object (KeywordPlanAdGroupKeyword)
  },
  "keywordThemeConstant": {
    object (KeywordThemeConstant)
  },
  "label": {
    object (Label)
  },
  "landingPageView": {
    object (LandingPageView)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "managedPlacementView": {
    object (ManagedPlacementView)
  },
  "mediaFile": {
    object (MediaFile)
  },
  "localServicesEmployee": {
    object (LocalServicesEmployee)
  },
  "localServicesVerificationArtifact": {
    object (LocalServicesVerificationArtifact)
  },
  "mobileAppCategoryConstant": {
    object (MobileAppCategoryConstant)
  },
  "mobileDeviceConstant": {
    object (MobileDeviceConstant)
  },
  "offlineConversionUploadClientSummary": {
    object (OfflineConversionUploadClientSummary)
  },
  "offlineUserDataJob": {
    object (OfflineUserDataJob)
  },
  "operatingSystemVersionConstant": {
    object (OperatingSystemVersionConstant)
  },
  "paidOrganicSearchTermView": {
    object (PaidOrganicSearchTermView)
  },
  "qualifyingQuestion": {
    object (QualifyingQuestion)
  },
  "parentalStatusView": {
    object (ParentalStatusView)
  },
  "perStoreView": {
    object (PerStoreView)
  },
  "productCategoryConstant": {
    object (ProductCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "productLink": {
    object (ProductLink)
  },
  "productLinkInvitation": {
    object (ProductLinkInvitation)
  },
  "recommendation": {
    object (Recommendation)
  },
  "recommendationSubscription": {
    object (RecommendationSubscription)
  },
  "searchTermView": {
    object (SearchTermView)
  },
  "sharedCriterion": {
    object (SharedCriterion)
  },
  "sharedSet": {
    object (SharedSet)
  },
  "smartCampaignSetting": {
    object (SmartCampaignSetting)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "smartCampaignSearchTermView": {
    object (SmartCampaignSearchTermView)
  },
  "thirdPartyAppAnalyticsLink": {
    object (ThirdPartyAppAnalyticsLink)
  },
  "topicView": {
    object (TopicView)
  },
  "travelActivityGroupView": {
    object (TravelActivityGroupView)
  },
  "travelActivityPerformanceView": {
    object (TravelActivityPerformanceView)
  },
  "experiment": {
    object (Experiment)
  },
  "experimentArm": {
    object (ExperimentArm)
  },
  "userInterest": {
    object (UserInterest)
  },
  "lifeEvent": {
    object (LifeEvent)
  },
  "userList": {
    object (UserList)
  },
  "userLocationView": {
    object (UserLocationView)
  },
  "remarketingAction": {
    object (RemarketingAction)
  },
  "topicConstant": {
    object (TopicConstant)
  },
  "video": {
    object (Video)
  },
  "webpageView": {
    object (WebpageView)
  },
  "leadFormSubmissionData": {
    object (LeadFormSubmissionData)
  },
  "localServicesLead": {
    object (LocalServicesLead)
  },
  "localServicesLeadConversation": {
    object (LocalServicesLeadConversation)
  },
  "androidPrivacySharedKeyGoogleAdGroup": {
    object (AndroidPrivacySharedKeyGoogleAdGroup)
  },
  "androidPrivacySharedKeyGoogleCampaign": {
    object (AndroidPrivacySharedKeyGoogleCampaign)
  },
  "androidPrivacySharedKeyGoogleNetworkType": {
    object (AndroidPrivacySharedKeyGoogleNetworkType)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  }
}
Trường
accountBudget

object (AccountBudget)

Ngân sách tài khoản trong truy vấn.
accountBudgetProposal

object (AccountBudgetProposal)

Đề xuất ngân sách tài khoản được tham chiếu trong truy vấn.
adGroup

object (AdGroup)

Nhóm quảng cáo được tham chiếu trong truy vấn.
adGroupAd

object (AdGroupAd)

Quảng cáo được tham chiếu trong truy vấn.
adGroupAdAssetCombinationView

object (AdGroupAdAssetCombinationView)

Chế độ xem tổ hợp thành phần quảng cáo của nhóm quảng cáo trong cụm từ tìm kiếm.
adGroupAdAssetView

object (AdGroupAdAssetView)

Chế độ xem thành phần quảng cáo của nhóm quảng cáo trong truy vấn.
adGroupAdLabel

object (AdGroupAdLabel)

Nhãn quảng cáo của nhóm quảng cáo được tham chiếu trong truy vấn.
adGroupAsset

object (AdGroupAsset)

Thành phần nhóm quảng cáo được tham chiếu trong truy vấn.
adGroupAssetSet

object (AdGroupAssetSet)

Tập hợp thành phần của nhóm quảng cáo được tham chiếu trong truy vấn.
adGroupAudienceView

object (AdGroupAudienceView)

Chế độ xem đối tượng của nhóm quảng cáo được đề cập trong truy vấn.
adGroupBidModifier

object (AdGroupBidModifier)

Công cụ sửa đổi giá thầu được tham chiếu trong truy vấn.
adGroupCriterion

object (AdGroupCriterion)

Tiêu chí được tham chiếu trong truy vấn.
adGroupCriterionCustomizer

object (AdGroupCriterionCustomizer)

Thông số tuỳ chỉnh tiêu chí của nhóm quảng cáo được tham chiếu trong truy vấn.
adGroupCriterionLabel

object (AdGroupCriterionLabel)

Nhãn tiêu chí của nhóm quảng cáo được tham chiếu trong truy vấn.
adGroupCriterionSimulation

object (AdGroupCriterionSimulation)

Mô phỏng tiêu chí nhóm quảng cáo được tham chiếu trong truy vấn.
adGroupCustomizer

object (AdGroupCustomizer)

Thông số tuỳ chỉnh nhóm quảng cáo được tham chiếu trong truy vấn.
adGroupExtensionSetting

object (AdGroupExtensionSetting)

Cài đặt tiện ích nhóm quảng cáo được tham chiếu trong truy vấn.
adGroupFeed

object (AdGroupFeed)

Nguồn cấp dữ liệu nhóm quảng cáo được tham chiếu trong truy vấn.
adGroupLabel

object (AdGroupLabel)

Nhãn nhóm quảng cáo được tham chiếu trong truy vấn.
adGroupSimulation

object (AdGroupSimulation)

Mô phỏng nhóm quảng cáo được tham chiếu trong truy vấn.
adParameter

object (AdParameter)

Thông số quảng cáo được tham chiếu trong truy vấn.
ageRangeView

object (AgeRangeView)

Chế độ xem độ tuổi được tham chiếu trong truy vấn.
adScheduleView

object (AdScheduleView)

Chế độ xem lịch quảng cáo được tham chiếu trong truy vấn.
domainCategory

object (DomainCategory)

Danh mục miền được tham chiếu trong truy vấn.
asset

object (Asset)

Thành phần được tham chiếu trong truy vấn.
assetFieldTypeView

object (AssetFieldTypeView)

Chế độ xem loại trường tài sản được tham chiếu trong truy vấn.
assetGroupAsset

object (AssetGroupAsset)

Thành phần nhóm thành phần được tham chiếu trong truy vấn.
assetGroupSignal

object (AssetGroupSignal)

Tín hiệu về nhóm thành phần được tham chiếu trong truy vấn.
assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

Bộ lọc nhóm trang thông tin của nhóm thành phần được tham chiếu trong truy vấn.
assetGroupProductGroupView

object (AssetGroupProductGroupView)

Chế độ xem nhóm sản phẩm của nhóm thành phần được đề cập trong truy vấn.
assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

Chế độ xem kiểu kết hợp hàng đầu của nhóm thành phần được đề cập trong truy vấn.
assetGroup

object (AssetGroup)

Nhóm thành phần được tham chiếu trong truy vấn.
assetSetAsset

object (AssetSetAsset)

Thành phần của nhóm thành phần được tham chiếu trong truy vấn.
assetSet

object (AssetSet)

Tập hợp thành phần được tham chiếu trong truy vấn.
assetSetTypeView

object (AssetSetTypeView)

Chế độ xem loại nhóm thành phần được tham chiếu trong truy vấn.
batchJob

object (BatchJob)

Công việc hàng loạt được tham chiếu trong truy vấn.
biddingDataExclusion

object (BiddingDataExclusion)

Tiêu chí loại trừ dữ liệu đặt giá thầu được đề cập trong truy vấn.
biddingSeasonalityAdjustment

object (BiddingSeasonalityAdjustment)

Hệ số điều chỉnh theo thời vụ cho chiến lược đặt giá thầu được đề cập trong truy vấn.
biddingStrategy

object (BiddingStrategy)

Chiến lược đặt giá thầu được tham chiếu trong truy vấn.
biddingStrategySimulation

object (BiddingStrategySimulation)

Hoạt động mô phỏng chiến lược đặt giá thầu được đề cập trong truy vấn.
billingSetup

object (BillingSetup)

Thông tin thanh toán được tham chiếu trong truy vấn.
callView

object (CallView)

Chế độ xem lệnh gọi được tham chiếu trong truy vấn.
campaignBudget

object (CampaignBudget)

Ngân sách chiến dịch được tham chiếu trong truy vấn.
campaign

object (Campaign)

Chiến dịch được tham chiếu trong truy vấn.
campaignAsset

object (CampaignAsset)

Thành phần chiến dịch được tham chiếu trong truy vấn.
campaignAssetSet

object (CampaignAssetSet)

Tập hợp thành phần chiến dịch được tham chiếu trong truy vấn.
campaignAudienceView

object (CampaignAudienceView)

Chế độ xem đối tượng của chiến dịch được đề cập trong truy vấn.
campaignBidModifier

object (CampaignBidModifier)

Công cụ sửa đổi giá thầu của chiến dịch được tham chiếu trong truy vấn.
campaignConversionGoal

object (CampaignConversionGoal)

Chiến dịch chuyển đổi mục tiêu được tham chiếu trong truy vấn.
campaignCriterion

object (CampaignCriterion)

Tiêu chí chiến dịch được tham chiếu trong truy vấn.
campaignCustomizer

object (CampaignCustomizer)

Thông số tuỳ chỉnh chiến dịch được tham chiếu trong truy vấn.
campaignDraft

object (CampaignDraft)

Bản nháp chiến dịch được tham chiếu trong truy vấn.
campaignExtensionSetting

object (CampaignExtensionSetting)

Cài đặt tiện ích chiến dịch được tham chiếu trong truy vấn.
campaignFeed

object (CampaignFeed)

Nguồn cấp dữ liệu chiến dịch được tham chiếu trong truy vấn.
campaignGroup

object (CampaignGroup)

Nhóm chiến dịch được tham chiếu trong truy vấn AWQL.
campaignLabel

object (CampaignLabel)

Nhãn chiến dịch được tham chiếu trong truy vấn.
campaignLifecycleGoal

object (CampaignLifecycleGoal)

Mục tiêu trong vòng đời của chiến dịch được đề cập trong truy vấn.
campaignSearchTermInsight

object (CampaignSearchTermInsight)

Thông tin chi tiết về cụm từ tìm kiếm của chiến dịch được tham chiếu trong truy vấn.
campaignSharedSet

object (CampaignSharedSet)

Nhóm chia sẻ chiến dịch được tham chiếu trong truy vấn AWQL.
campaignSimulation

object (CampaignSimulation)

Mô phỏng chiến dịch được tham chiếu trong truy vấn.
carrierConstant

object (CarrierConstant)

Hằng số sóng mang được tham chiếu trong truy vấn.
changeEvent

object (ChangeEvent)

ChangeEvent được tham chiếu trong truy vấn.
changeStatus

object (ChangeStatus)

ChangeStatus được tham chiếu trong truy vấn.
combinedAudience

object (CombinedAudience)

Đối tượng kết hợp được tham chiếu trong truy vấn.
audience

object (Audience)

Đối tượng được tham chiếu trong truy vấn.
conversionAction

object (ConversionAction)

Hành động chuyển đổi được tham chiếu trong truy vấn.
conversionCustomVariable

object (ConversionCustomVariable)

Biến tuỳ chỉnh của lượt chuyển đổi được tham chiếu trong truy vấn.
conversionGoalCampaignConfig

object (ConversionGoalCampaignConfig)

ConversionTargetCampaignConfig được tham chiếu trong truy vấn.
conversionValueRule

object (ConversionValueRule)

Quy tắc về giá trị lượt chuyển đổi được tham chiếu trong truy vấn.
conversionValueRuleSet

object (ConversionValueRuleSet)

Bộ quy tắc về giá trị lượt chuyển đổi được tham chiếu trong truy vấn.
clickView

object (ClickView)

ClickView được tham chiếu trong truy vấn.
currencyConstant

object (CurrencyConstant)

Hằng số tiền tệ được tham chiếu trong truy vấn.
customAudience

object (CustomAudience)

Đối tượng tuỳ chỉnh được tham chiếu trong truy vấn.
customConversionGoal

object (CustomConversionGoal)

Custom Chuyển đổi mục tiêu được tham chiếu trong truy vấn.
customInterest

object (CustomInterest)

Custominterest được tham chiếu trong truy vấn.
customer

object (Customer)

Khách hàng được tham chiếu trong truy vấn.
customerAsset

object (CustomerAsset)

Thành phần khách hàng được tham chiếu trong truy vấn.
customerAssetSet

object (CustomerAssetSet)

Tập hợp thành phần của khách hàng được tham chiếu trong truy vấn.
accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

Chiến lược đặt giá thầu có thể truy cập được tham chiếu trong truy vấn.
customerCustomizer

object (CustomerCustomizer)

Thông số tuỳ chỉnh khách hàng được tham chiếu trong truy vấn.
customerClient

object (CustomerClient)

CustomerClient được tham chiếu trong truy vấn.
customerConversionGoal

object (CustomerConversionGoal)

CustomerConversionsTarget được tham chiếu trong truy vấn.
customerExtensionSetting

object (CustomerExtensionSetting)

Chế độ cài đặt phần mở rộng dành cho khách hàng được tham chiếu trong truy vấn.
customerFeed

object (CustomerFeed)

Nguồn cấp dữ liệu khách hàng được tham chiếu trong truy vấn.
customerLabel

object (CustomerLabel)

Nhãn khách hàng được tham chiếu trong truy vấn.
customerLifecycleGoal

object (CustomerLifecycleGoal)

Mục tiêu về vòng đời của khách hàng được đề cập trong truy vấn.
customerNegativeCriterion

object (CustomerNegativeCriterion)

Tiêu chí phủ định về khách hàng được tham chiếu trong truy vấn.
customerSearchTermInsight

object (CustomerSearchTermInsight)

Thông tin chi tiết về cụm từ tìm kiếm của khách hàng được tham chiếu trong cụm từ tìm kiếm.
customerUserAccess

object (CustomerUserAccess)

CustomerUserAccess được tham chiếu trong truy vấn.
customerUserAccessInvitation

object (CustomerUserAccessInvitation)

CustomerUserAccessInvitation được tham chiếu trong truy vấn.
customizerAttribute

object (CustomizerAttribute)

Thuộc tính thông số tuỳ chỉnh được tham chiếu trong truy vấn.
detailPlacementView

object (DetailPlacementView)

Chế độ xem vị trí chi tiết được tham chiếu trong truy vấn.
detailedDemographic

object (DetailedDemographic)

Thông tin nhân khẩu học chi tiết được đề cập trong truy vấn.
displayKeywordView

object (DisplayKeywordView)

Chế độ xem từ khoá hiển thị được tham chiếu trong truy vấn.
distanceView

object (DistanceView)

Chế độ xem khoảng cách được tham chiếu trong truy vấn.
dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

Chế độ xem cụm từ tìm kiếm cho quảng cáo tìm kiếm động được tham chiếu trong truy vấn.
expandedLandingPageView

object (ExpandedLandingPageView)

Chế độ xem trang đích mở rộng được tham chiếu trong truy vấn.
extensionFeedItem

object (ExtensionFeedItem)

Mục nguồn cấp dữ liệu của tiện ích được tham chiếu trong truy vấn.
feed

object (Feed)

Nguồn cấp dữ liệu được tham chiếu trong truy vấn.
feedItem

object (FeedItem)

Mục nguồn cấp dữ liệu được tham chiếu trong truy vấn.
feedItemSet

object (FeedItemSet)

Nhóm mục nguồn cấp dữ liệu được tham chiếu trong truy vấn.
feedItemTarget

object (FeedItemTarget)

Mục tiêu mục nguồn cấp dữ liệu được tham chiếu trong truy vấn.
feedMapping

object (FeedMapping)

Ánh xạ nguồn cấp dữ liệu được tham chiếu trong truy vấn.
feedPlaceholderView

object (FeedPlaceholderView)

Chế độ xem phần giữ chỗ của nguồn cấp dữ liệu được tham chiếu trong truy vấn.
genderView

object (GenderView)

Chế độ xem theo giới tính được đề cập trong truy vấn.
geoTargetConstant

object (GeoTargetConstant)

Hằng số mục tiêu địa lý được tham chiếu trong truy vấn.
geographicView

object (GeographicView)

Chế độ xem địa lý được tham chiếu trong truy vấn.
groupPlacementView

object (GroupPlacementView)

Thành phần hiển thị vị trí nhóm được tham chiếu trong truy vấn.
hotelGroupView

object (HotelGroupView)

Chế độ xem nhóm khách sạn được tham chiếu trong truy vấn.
hotelPerformanceView

object (HotelPerformanceView)

Chế độ xem hiệu suất của khách sạn được tham chiếu trong truy vấn.
hotelReconciliation

object (HotelReconciliation)

Dữ liệu điều chỉnh cho khách sạn được tham chiếu trong truy vấn.
incomeRangeView

object (IncomeRangeView)

Chế độ xem phạm vi thu nhập được tham chiếu trong truy vấn.
keywordView

object (KeywordView)

Chế độ xem từ khoá được tham chiếu trong truy vấn.
keywordPlan

object (KeywordPlan)

Kế hoạch từ khoá được tham chiếu trong truy vấn.
keywordPlanCampaign

object (KeywordPlanCampaign)

Chiến dịch kế hoạch từ khoá được đề cập trong truy vấn.
keywordPlanCampaignKeyword

object (KeywordPlanCampaignKeyword)

Từ khoá của chiến dịch kế hoạch từ khoá được đề cập trong truy vấn.
keywordPlanAdGroup

object (KeywordPlanAdGroup)

Nhóm quảng cáo kế hoạch từ khoá được tham chiếu trong truy vấn.
keywordPlanAdGroupKeyword

object (KeywordPlanAdGroupKeyword)

Nhóm quảng cáo kế hoạch từ khoá được tham chiếu trong truy vấn.
keywordThemeConstant

object (KeywordThemeConstant)

Hằng số chủ đề từ khoá được tham chiếu trong truy vấn.
label

object (Label)

Nhãn được tham chiếu trong truy vấn.
landingPageView

object (LandingPageView)

Chế độ xem trang đích được tham chiếu trong truy vấn.
languageConstant

object (LanguageConstant)

Hằng ngôn ngữ được tham chiếu trong truy vấn.
locationView

object (LocationView)

Chế độ xem vị trí được tham chiếu trong truy vấn.
managedPlacementView

object (ManagedPlacementView)

Chế độ xem vị trí được quản lý được tham chiếu trong truy vấn.
mediaFile

object (MediaFile)

Tệp nội dung nghe nhìn được tham chiếu trong truy vấn.
localServicesEmployee

object (LocalServicesEmployee)

Nhân viên dịch vụ địa phương được đề cập trong truy vấn.
localServicesVerificationArtifact

object (LocalServicesVerificationArtifact)

Cấu phần phần mềm xác minh dịch vụ cục bộ được tham chiếu trong truy vấn.
mobileAppCategoryConstant

object (MobileAppCategoryConstant)

Hằng số danh mục ứng dụng di động được tham chiếu trong truy vấn.
mobileDeviceConstant

object (MobileDeviceConstant)

Hằng số thiết bị di động được tham chiếu trong truy vấn.
offlineConversionUploadClientSummary

object (OfflineConversionUploadClientSummary)

Thông tin tóm tắt về việc tải lượt chuyển đổi ngoại tuyến lên ở cấp khách hàng.
offlineUserDataJob

object (OfflineUserDataJob)

Công việc liên quan đến dữ liệu người dùng ngoại tuyến được tham chiếu trong truy vấn.
operatingSystemVersionConstant

object (OperatingSystemVersionConstant)

Hằng số phiên bản hệ điều hành được tham chiếu trong truy vấn.
paidOrganicSearchTermView

object (PaidOrganicSearchTermView)

Chế độ xem cụm từ tìm kiếm tự nhiên có trả phí được đề cập trong truy vấn.
qualifyingQuestion

object (QualifyingQuestion)

Câu hỏi định lượng được đề cập trong truy vấn.
parentalStatusView

object (ParentalStatusView)

Chế độ xem tình trạng con cái được tham chiếu trong truy vấn.
perStoreView

object (PerStoreView)

Chế độ xem theo cửa hàng được tham chiếu trong truy vấn.
productCategoryConstant

object (ProductCategoryConstant)

Danh mục sản phẩm được tham chiếu trong truy vấn.
productGroupView

object (ProductGroupView)

Chế độ xem nhóm sản phẩm được đề cập trong truy vấn.
recommendation

object (Recommendation)

Đề xuất được tham chiếu trong truy vấn.
recommendationSubscription

object (RecommendationSubscription)

Gói thuê bao đề xuất được tham chiếu trong truy vấn.
searchTermView

object (SearchTermView)

Chế độ xem cụm từ tìm kiếm được tham chiếu trong truy vấn.
sharedCriterion

object (SharedCriterion)

Tập hợp dùng chung được tham chiếu trong truy vấn.
sharedSet

object (SharedSet)

Tập hợp dùng chung được tham chiếu trong truy vấn.
smartCampaignSetting

object (SmartCampaignSetting)

Chế độ cài đặt chiến dịch Thông minh được đề cập trong truy vấn.
shoppingPerformanceView

object (ShoppingPerformanceView)

Chế độ xem hiệu suất mua sắm được tham chiếu trong truy vấn.
smartCampaignSearchTermView

object (SmartCampaignSearchTermView)

Chế độ xem cụm từ tìm kiếm của chiến dịch Thông minh được đề cập trong truy vấn.
topicView

object (TopicView)

Chế độ xem chủ đề được tham chiếu trong truy vấn.
travelActivityGroupView

object (TravelActivityGroupView)

Chế độ xem nhóm hoạt động đi lại được tham chiếu trong truy vấn.
travelActivityPerformanceView

object (TravelActivityPerformanceView)

Chế độ xem hiệu suất hoạt động đi lại được tham chiếu trong truy vấn.
experiment

object (Experiment)

Thử nghiệm được tham chiếu trong truy vấn.
experimentArm

object (ExperimentArm)

Nhóm thử nghiệm được tham chiếu trong truy vấn.
userInterest

object (UserInterest)

Mối quan tâm của người dùng được đề cập trong truy vấn.
lifeEvent

object (LifeEvent)

Sự kiện trong đời được tham chiếu trong truy vấn.
userList

object (UserList)

Danh sách người dùng được tham chiếu trong truy vấn.
userLocationView

object (UserLocationView)

Chế độ xem vị trí của người dùng được tham chiếu trong truy vấn.
remarketingAction

object (RemarketingAction)

Hành động tiếp thị lại được đề cập trong truy vấn.
topicConstant

object (TopicConstant)

Hằng số chủ đề được tham chiếu trong truy vấn.
video

object (Video)

Video được tham chiếu trong truy vấn.
webpageView

object (WebpageView)

Chế độ xem trang web được tham chiếu trong truy vấn.
leadFormSubmissionData

object (LeadFormSubmissionData)

Thông tin mà người dùng gửi qua biểu mẫu khách hàng tiềm năng được tham chiếu trong truy vấn.
localServicesLead

object (LocalServicesLead)

Khách hàng tiềm năng dịch vụ địa phương được đề cập trong truy vấn.
localServicesLeadConversation

object (LocalServicesLeadConversation)

Cuộc trò chuyện với khách hàng tiềm năng liên quan đến dịch vụ địa phương được tham chiếu trong truy vấn.
androidPrivacySharedKeyGoogleAdGroup

object (AndroidPrivacySharedKeyGoogleAdGroup)

Khoá dùng chung về quyền riêng tư trên Android của nhóm quảng cáo trên Google được tham chiếu trong truy vấn.
androidPrivacySharedKeyGoogleCampaign

object (AndroidPrivacySharedKeyGoogleCampaign)

Chiến dịch khoá dùng chung về quyền riêng tư trên Android được đề cập trong truy vấn.
androidPrivacySharedKeyGoogleNetworkType

object (AndroidPrivacySharedKeyGoogleNetworkType)

Khoá dùng chung về quyền riêng tư trên Android loại mạng Google được tham chiếu trong truy vấn.
metrics

object (Metrics)

Các chỉ số.
segments

object (Segments)

Phân khúc.

AccountBudget

Ngân sách cấp tài khoản. Mục này chứa thông tin về ngân sách, cũng như các thay đổi được phê duyệt gần đây nhất đối với ngân sách và các thay đổi được đề xuất đang chờ phê duyệt. Những nội dung thay đổi đề xuất đang chờ phê duyệt (nếu có) sẽ nằm trong mục "Đề xuất đang chờ xử lý". Bạn có thể tìm thấy thông tin chi tiết có hiệu lực về ngân sách trong các trường có tiền tố "Approved_", "adjusted_" và những URL không có tiền tố. Vì một số thông tin chi tiết có hiệu quả có thể khác với thông tin mà người dùng đã yêu cầu ban đầu (ví dụ: hạn mức chi tiêu), nên những điểm khác biệt này sẽ được thay thế bằng "đề xuất_", "được phê duyệt_" và có thể là "đã điều chỉnh_" mới.

Tài nguyên này được thay đổi bằng cách sử dụng AccountBudgetĐề xuất và không thể thay đổi trực tiếp. Ngân sách có thể có tối đa một đề xuất đang chờ xử lý tại bất kỳ thời điểm nào. Nội dung đề xuất này sẽ được đọc thông qua mục Đang chờ đề xuất.

Sau khi được phê duyệt, ngân sách có thể bị điều chỉnh, chẳng hạn như điều chỉnh tín dụng. Các điều chỉnh sẽ tạo ra sự khác biệt giữa trạng thái "đã phê duyệt" và "đã điều chỉnh" các trường khác nhau.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "status": enum (AccountBudgetStatus),
  "totalAdjustmentsMicros": string,
  "amountServedMicros": string,
  "pendingProposal": {
    object (PendingAccountBudgetProposal)
  },
  "id": string,
  "billingSetup": string,
  "name": string,
  "proposedStartDateTime": string,
  "approvedStartDateTime": string,
  "purchaseOrderNumber": string,
  "notes": string,

  // Union field proposed_end_time can be only one of the following:
  "proposedEndDateTime": string,
  "proposedEndTimeType": enum (TimeType)
  // End of list of possible types for union field proposed_end_time.

  // Union field approved_end_time can be only one of the following:
  "approvedEndDateTime": string,
  "approvedEndTimeType": enum (TimeType)
  // End of list of possible types for union field approved_end_time.

  // Union field proposed_spending_limit can be only one of the following:
  "proposedSpendingLimitMicros": string,
  "proposedSpendingLimitType": enum (SpendingLimitType)
  // End of list of possible types for union field proposed_spending_limit.

  // Union field approved_spending_limit can be only one of the following:
  "approvedSpendingLimitMicros": string,
  "approvedSpendingLimitType": enum (SpendingLimitType)
  // End of list of possible types for union field approved_spending_limit.

  // Union field adjusted_spending_limit can be only one of the following:
  "adjustedSpendingLimitMicros": string,
  "adjustedSpendingLimitType": enum (SpendingLimitType)
  // End of list of possible types for union field adjusted_spending_limit.
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của ngân sách cấp tài khoản. Tên tài nguyên AccountBudget có dạng:

customers/{customerId}/accountBudgets/{account_budget_id}
status

enum (AccountBudgetStatus)

Chỉ có đầu ra. Trạng thái của ngân sách cấp tài khoản này.
totalAdjustmentsMicros

string (int64 format)

Chỉ có đầu ra. Tổng số tiền điều chỉnh.

Một ví dụ về việc điều chỉnh là khoản tín dụng ưu đãi.
amountServedMicros

string (int64 format)

Chỉ có đầu ra. Giá trị của Quảng cáo đã được phân phát, tính bằng phần triệu.

Điều này bao gồm chi phí phân phối quá, trong trường hợp khoản ghi nợ có thể được tự động áp dụng cho ngân sách (xem tổng AdjustsMicros).
pendingProposal

object (PendingAccountBudgetProposal)

Chỉ có đầu ra. Đề xuất đang chờ xử lý về việc sửa đổi ngân sách này (nếu có).
id

string (int64 format)

Chỉ có đầu ra. Mã ngân sách cấp tài khoản.
billingSetup

string

Chỉ có đầu ra. Tên tài nguyên của thông tin thanh toán được liên kết với ngân sách cấp tài khoản này. Tên tài nguyên BillingSetup có dạng như sau:

customers/{customerId}/billingSetups/{billing_setup_id}
name

string

Chỉ có đầu ra. Tên ngân sách cấp tài khoản.
proposedStartDateTime

string

Chỉ có đầu ra. Thời gian bắt đầu đề xuất của ngân sách cấp tài khoản theo định dạng yyyy-MM-dd HH:mm:ss. Nếu loại thời gian bắt đầu là NOW được đề xuất, thì đây là thời điểm yêu cầu.
approvedStartDateTime

string

Chỉ có đầu ra. Thời gian bắt đầu được phê duyệt của ngân sách cấp tài khoản theo định dạng yyyy-MM-dd HH:mm:ss.

Ví dụ: nếu ngân sách mới được phê duyệt sau thời gian bắt đầu đề xuất, thì thời gian bắt đầu được phê duyệt là thời điểm phê duyệt.
purchaseOrderNumber

string

Chỉ có đầu ra. Số đơn đặt hàng là một giá trị giúp người dùng tham khảo ngân sách này trong hoá đơn hằng tháng của họ.
notes

string

Chỉ có đầu ra. Các ghi chú liên quan đến ngân sách.
Trường kết hợp proposed_end_time. Thời gian kết thúc đề xuất của ngân sách cấp tài khoản. proposed_end_time chỉ có thể là một trong những trạng thái sau đây:
proposedEndDateTime

string

Chỉ có đầu ra. Thời gian kết thúc đề xuất ở định dạng yyyy-MM-dd HH:mm:ss.
proposedEndTimeType

enum (TimeType)

Chỉ có đầu ra. Thời gian kết thúc đề xuất ở dạng được xác định rõ, ví dụ: FOREVER.

Trường kết hợp approved_end_time. Thời gian kết thúc được phê duyệt của ngân sách cấp tài khoản.

Ví dụ: nếu thời gian kết thúc ngân sách được cập nhật và đề xuất được phê duyệt sau thời gian kết thúc đề xuất, thì thời gian kết thúc được phê duyệt chính là thời điểm phê duyệt. approved_end_time chỉ có thể là một trong những trạng thái sau đây:
approvedEndDateTime

string

Chỉ có đầu ra. Thời gian kết thúc được phê duyệt theo định dạng yyyy-MM-dd HH:mm:ss.
approvedEndTimeType

enum (TimeType)

Chỉ có đầu ra. Thời gian kết thúc được phê duyệt là loại được xác định rõ, ví dụ: FOREVER.
Trường kết hợp proposed_spending_limit. Hạn mức chi tiêu đề xuất. proposed_spending_limit chỉ có thể là một trong những trạng thái sau đây:
proposedSpendingLimitMicros

string (int64 format)

Chỉ có đầu ra. Hạn mức chi tiêu đề xuất tính bằng phần triệu. Một triệu tương đương với một đơn vị.
proposedSpendingLimitType

enum (SpendingLimitType)

Chỉ có đầu ra. Hạn mức chi tiêu đề xuất là một loại được xác định rõ ràng, ví dụ: INFINITE.

Trường kết hợp approved_spending_limit. Hạn mức chi tiêu được phê duyệt.

Ví dụ: nếu số tiền tài khoản đã chi tiêu vượt quá hạn mức chi tiêu đề xuất tại thời điểm đề xuất được phê duyệt, thì hạn mức chi tiêu được phê duyệt sẽ được đặt thành số tiền đã chi tiêu. approved_spending_limit chỉ có thể là một trong những trạng thái sau đây:
approvedSpendingLimitMicros

string (int64 format)

Chỉ có đầu ra. Hạn mức chi tiêu được phê duyệt tính bằng phần triệu. Một triệu tương đương với một đơn vị. Hệ thống sẽ chỉ điền hạn mức chi tiêu đề xuất nếu hạn mức chi tiêu đề xuất là có hạn và sẽ luôn lớn hơn hoặc bằng hạn mức chi tiêu đề xuất.
approvedSpendingLimitType

enum (SpendingLimitType)

Chỉ có đầu ra. Giới hạn chi tiêu được phê duyệt dưới dạng một loại được xác định rõ ràng, ví dụ: INFINITE. Hệ thống sẽ chỉ điền hạn mức chi tiêu được phê duyệt là INFINITE.

Trường kết hợp adjusted_spending_limit. Hạn mức chi tiêu sau khi áp dụng mức điều chỉnh. Các mức điều chỉnh được lưu trữ trong total_ adjustmentss_micros.

Giá trị này có quyết định cuối cùng về số tiền tài khoản được phép chi tiêu. adjusted_spending_limit chỉ có thể là một trong những trạng thái sau đây:
adjustedSpendingLimitMicros

string (int64 format)

Chỉ có đầu ra. Hạn mức chi tiêu được điều chỉnh tính bằng phần triệu. Một triệu tương đương với một đơn vị.

Nếu hạn mức chi tiêu được phê duyệt là có hạn, thì hạn mức chi tiêu điều chỉnh có thể thay đổi tuỳ thuộc vào các hình thức điều chỉnh được áp dụng cho ngân sách này (nếu có).

Bạn có thể xem các loại điều chỉnh khác nhau tại đây: https://support.google.com/google-ads/answer/1704323

Ví dụ: khoản điều chỉnh ghi nợ sẽ giảm số tiền mà tài khoản được phép chi tiêu.
adjustedSpendingLimitType

enum (SpendingLimitType)

Chỉ có đầu ra. Hạn mức chi tiêu được điều chỉnh là một loại được xác định rõ ràng, ví dụ: INFINITE. Giá trị này sẽ chỉ được điền nếu hạn mức chi tiêu đã điều chỉnh là INFINITE. Chúng tôi đảm bảo hạn mức này sẽ là đúng nếu hạn mức chi tiêu được phê duyệt là INFINITE.

AccountBudgetStatus

Các trạng thái có thể có của Ngân sách tài khoản.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
PENDING Ngân sách tài khoản đang chờ phê duyệt.
APPROVED Ngân sách tài khoản đã được phê duyệt.
CANCELLED Người dùng đã huỷ ngân sách tài khoản.

PendingAccountBudgetProposal

Một đề xuất đang chờ xử lý được liên kết với ngân sách cấp tài khoản kèm theo, nếu có.

Biểu diễn dưới dạng JSON 
{
  "proposalType": enum (AccountBudgetProposalType),
  "accountBudgetProposal": string,
  "name": string,
  "startDateTime": string,
  "purchaseOrderNumber": string,
  "notes": string,
  "creationDateTime": string,

  // Union field end_time can be only one of the following:
  "endDateTime": string,
  "endTimeType": enum (TimeType)
  // End of list of possible types for union field end_time.

  // Union field spending_limit can be only one of the following:
  "spendingLimitMicros": string,
  "spendingLimitType": enum (SpendingLimitType)
  // End of list of possible types for union field spending_limit.
}
Trường
proposalType

enum (AccountBudgetProposalType)

Chỉ có đầu ra. Loại đề xuất này, ví dụ: END để kết thúc ngân sách liên kết với đề xuất này.
accountBudgetProposal

string

Chỉ có đầu ra. Tên tài nguyên của đề xuất. Tên tài nguyên AccountBudget Đề xuất có biểu mẫu:

customers/{customerId}/accountBudgetProposals/{account_budget_proposal_id}
name

string

Chỉ có đầu ra. Tên để chỉ định cho ngân sách cấp tài khoản.
startDateTime

string

Chỉ có đầu ra. Thời gian bắt đầu theo định dạng yyyy-MM-dd HH:mm:ss.
purchaseOrderNumber

string

Chỉ có đầu ra. Số đơn đặt hàng là một giá trị giúp người dùng tham khảo ngân sách này trong hoá đơn hằng tháng của họ.
notes

string

Chỉ có đầu ra. Các ghi chú liên quan đến ngân sách này.
creationDateTime

string

Chỉ có đầu ra. Thời điểm tạo đề xuất ngân sách cấp tài khoản này. Được định dạng là yyyy-MM-dd HH:mm:ss.
Trường kết hợp end_time. Thời gian kết thúc của ngân sách cấp tài khoản. end_time chỉ có thể là một trong những trạng thái sau đây:
endDateTime

string

Chỉ có đầu ra. Thời gian kết thúc theo định dạng yyyy-MM-dd HH:mm:ss.
endTimeType

enum (TimeType)

Chỉ có đầu ra. Thời gian kết thúc ở dạng được xác định rõ, ví dụ: VĨNH VIỄN.
Trường kết hợp spending_limit. Hạn mức chi tiêu. spending_limit chỉ có thể là một trong những trạng thái sau đây:
spendingLimitMicros

string (int64 format)

Chỉ có đầu ra. Hạn mức chi tiêu tính bằng phần triệu. Một triệu tương đương với một đơn vị.
spendingLimitType

enum (SpendingLimitType)

Chỉ có đầu ra. Hạn mức chi tiêu là một loại được xác định rõ ràng, ví dụ: INFINITE.

AdGroupAdAssetCombinationView

Chế độ xem về việc sử dụng tổ hợp thành phần quảng cáo của nhóm quảng cáo. Hiện tại, chúng tôi chỉ hỗ trợ AdGroupAdAssetEndView cho Quảng cáo tìm kiếm thích ứng, với nhiều loại quảng cáo khác được lên kế hoạch trong tương lai.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "servedAssets": [
    {
      object (AssetUsage)
    }
  ],
  "enabled": boolean
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem tổ hợp thành phần quảng cáo trong nhóm quảng cáo. Mã kết hợp dài 128 bit, trong đó 64 bit trên được lưu trữ trong asset_organization_id_high và 64 bit dưới được lưu trữ trong asset_composable_id_low. Tên tài nguyên của chế độ xem Kết hợp thành phần nhóm quảng cáo có dạng: customers/{customerId}/adGroupAdAssetCombinationViews/{AdGroupAd.ad_group_id}~{AdGroupAd.ad.ad_id}~{AssetCombination.asset_combination_id_low}~{AssetCombination.asset_combination_id_high}
servedAssets[]

object (AssetUsage)

Chỉ có đầu ra. Thành phần được phân phát.
enabled

boolean

Chỉ có đầu ra. Trạng thái giữa kiểu kết hợp thành phần và phiên bản mới nhất của quảng cáo. Nếu đúng, tổ hợp thành phần đó sẽ được liên kết với phiên bản mới nhất của quảng cáo. Nếu sai, thì tức là đường liên kết đã từng tồn tại nhưng đã bị xoá và không còn xuất hiện trong phiên bản mới nhất của quảng cáo.

AssetUsage

Chứa thông tin về việc sử dụng tài sản.

Biểu diễn dưới dạng JSON 
{
  "asset": string,
  "servedAssetFieldType": enum (ServedAssetFieldType)
}
Trường
asset

string

Tên tài nguyên của thành phần.
servedAssetFieldType

enum (ServedAssetFieldType)

Loại trường phân phát của tài sản.

AdGroupAdAssetView

Mối liên kết giữa một Nhóm quảng cáo và một Nội dung. Hiện tại, chúng tôi chỉ hỗ trợ AdGroupAdAssetView cho AppAds và Quảng cáo tìm kiếm thích ứng.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "fieldType": enum (AssetFieldType),
  "policySummary": {
    object (AdGroupAdAssetPolicySummary)
  },
  "performanceLabel": enum (AssetPerformanceLabel),
  "pinnedField": enum (ServedAssetFieldType),
  "source": enum (AssetSource),
  "adGroupAd": string,
  "asset": string,
  "enabled": boolean
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem thành phần quảng cáo trong nhóm quảng cáo. Tên tài nguyên chế độ xem thành phần quảng cáo của nhóm quảng cáo có dạng (Trước phiên bản 4):

customers/{customerId}/adGroupAdAssets/{AdGroupAdAsset.ad_group_id}~{AdGroupAdAsset.ad.ad_id}~{AdGroupAdAsset.asset_id}~{AdGroupAdAsset.field_type}

Tên tài nguyên chế độ xem thành phần quảng cáo của nhóm quảng cáo có dạng như sau (Bắt đầu từ phiên bản 4):

customers/{customerId}/adGroupAdAssetViews/{AdGroupAdAsset.ad_group_id}~{AdGroupAdAsset.ad_id}~{AdGroupAdAsset.asset_id}~{AdGroupAdAsset.field_type}
fieldType

enum (AssetFieldType)

Chỉ có đầu ra. Vai trò của thành phần trong quảng cáo.
policySummary

object (AdGroupAdAssetPolicySummary)

Chỉ có đầu ra. Thông tin chính sách cho thành phần quảng cáo trong nhóm quảng cáo.
performanceLabel

enum (AssetPerformanceLabel)

Chỉ có đầu ra. Hiệu suất của mối liên kết tài sản.
pinnedField

enum (ServedAssetFieldType)

Chỉ có đầu ra. Trường đã ghim.
source

enum (AssetSource)

Chỉ có đầu ra. Nguồn của thành phần quảng cáo trong nhóm quảng cáo.
adGroupAd

string

Chỉ có đầu ra. Quảng cáo trong nhóm quảng cáo mà tài sản được liên kết.
asset

string

Chỉ có đầu ra. Thành phần được liên kết với quảng cáo trong nhóm quảng cáo.
enabled

boolean

Chỉ có đầu ra. Trạng thái giữa thành phần và phiên bản mới nhất của quảng cáo. Nếu đúng, thành phần này sẽ được liên kết với phiên bản mới nhất của quảng cáo. Nếu sai, thì tức là đường liên kết đã từng tồn tại nhưng đã bị xoá và không còn xuất hiện trong phiên bản mới nhất của quảng cáo.

AdGroupAdAssetPolicySummary

Chứa thông tin chính sách cho một thành phần quảng cáo trong nhóm quảng cáo.

Biểu diễn dưới dạng JSON 
{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}
Trường
policyTopicEntries[]

object (PolicyTopicEntry)

Chỉ có đầu ra. Danh sách các phát hiện về chính sách cho thành phần quảng cáo của nhóm quảng cáo.
reviewStatus

enum (PolicyReviewStatus)

Chỉ có đầu ra. Vị trí của thành phần quảng cáo này trong nhóm quảng cáo trong quá trình xem xét.
approvalStatus

enum (PolicyApprovalStatus)

Chỉ có đầu ra. Trạng thái phê duyệt tổng thể của thành phần quảng cáo trong nhóm quảng cáo này, được tính dựa trên trạng thái của từng mục nhập chủ đề chính sách riêng lẻ.

AdGroupAudienceView

Chế độ xem đối tượng của một nhóm quảng cáo. Bao gồm dữ liệu hiệu suất từ các mối quan tâm, danh sách tái tiếp thị cho quảng cáo trên Mạng Hiển thị và quảng cáo trên Mạng YouTube cũng như danh sách tái tiếp thị dành cho quảng cáo tìm kiếm (RLSA), được tổng hợp ở cấp đối tượng.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem đối tượng nhóm quảng cáo. Tên tài nguyên chế độ xem đối tượng của nhóm quảng cáo có dạng:

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

AdGroupCriterionSimulation

Mô phỏng tiêu chí nhóm quảng cáo. Các kiểu kết hợp được hỗ trợ của loại kênh quảng cáo, loại tiêu chí, loại mô phỏng và phương pháp sửa đổi mô phỏng được nêu chi tiết lần lượt dưới đây. Các thao tác mô phỏng AdGroupCriterion khách sạn bắt đầu từ phiên bản 5.

  1. DISPLAY - KEYWORD - CPC_BID - UNIFORM
  2. TÌM KIẾM - KEYWORD - CPC_BID - UNIFORM
  3. MUA SẮM – LISTING_GROUP – CPC_BID – UNIFORM
  4. KHÁCH SẠN – LISTING_GROUP – CPC_BID – UNIFORM
  5. KHÁCH SẠN – LISTING_GROUP – PERCENT_CPC_BID – UNIFORM
Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "adGroupId": string,
  "criterionId": string,
  "startDate": string,
  "endDate": string,

  // Union field point_list can be only one of the following:
  "cpcBidPointList": {
    object (CpcBidSimulationPointList)
  },
  "percentCpcBidPointList": {
    object (PercentCpcBidSimulationPointList)
  }
  // End of list of possible types for union field point_list.
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của mô phỏng tiêu chí nhóm quảng cáo. Tên tài nguyên mô phỏng tiêu chí nhóm quảng cáo có dạng như sau:

customers/{customerId}/adGroupCriterionSimulations/{adGroupId}~{criterionId}~{type}~{modificationMethod}~{startDate}~{endDate}
type

enum (SimulationType)

Chỉ có đầu ra. Trường mà mô phỏng sửa đổi.
modificationMethod

enum (SimulationModificationMethod)

Chỉ có đầu ra. Cách hoạt động mô phỏng sửa đổi trường.
adGroupId

string (int64 format)

Chỉ có đầu ra. Mã nhóm quảng cáo của mô phỏng.
criterionId

string (int64 format)

Chỉ có đầu ra. Mã tiêu chí của mô phỏng.
startDate

string

Chỉ có đầu ra. Ngày đầu tiên sử dụng mô phỏng, ở định dạng YYYY-MM-DD.
endDate

string

Chỉ có đầu ra. Ngày cuối cùng của hoạt động mô phỏng, ở định dạng YYYY-MM-DD.
Trường kết hợp point_list. Danh sách các điểm mô phỏng. point_list chỉ có thể là một trong những trạng thái sau đây:
cpcBidPointList

object (CpcBidSimulationPointList)

Chỉ có đầu ra. Điểm mô phỏng nếu loại mô phỏng là CPC_BID.
percentCpcBidPointList

object (PercentCpcBidSimulationPointList)

Chỉ có đầu ra. Điểm mô phỏng nếu loại mô phỏng là PERCENT_CPC_BID.

SimulationType

Enum mô tả trường mà một phiên mô phỏng sửa đổi.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
CPC_BID Phần mô phỏng dành cho giá thầu CPC.
CPV_BID Hoạt động mô phỏng dành cho giá thầu CPV.
TARGET_CPA Hoạt động mô phỏng này là dành cho mục tiêu CPA.
BID_MODIFIER Hoạt động mô phỏng là dành cho hệ số sửa đổi giá thầu.
TARGET_ROAS Hoạt động mô phỏng là dành cho mục tiêu ROAS.
PERCENT_CPC_BID Phần mô phỏng dành cho giá thầu CPC phần trăm.
TARGET_IMPRESSION_SHARE Hoạt động mô phỏng này là dành cho mục tiêu tỷ lệ hiển thị.
BUDGET Việc mô phỏng là dùng trong phạm vi ngân sách.

SimulationModificationMethod

Enum mô tả phương thức mà mô phỏng sửa đổi một trường.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
UNIFORM Các giá trị trong mô phỏng được áp dụng thống nhất cho tất cả phần tử con của một tài nguyên nhất định. Không tuân thủ các cơ chế ghi đè trên tài nguyên con.
DEFAULT Các giá trị trong mô phỏng đã được áp dụng cho tài nguyên đã cho. Các cơ chế ghi đè trên tài nguyên con được tuân thủ và số liệu ước tính về lưu lượng truy cập không bao gồm những tài nguyên này.
SCALING Tất cả các giá trị trong một phiên mô phỏng đều được điều chỉnh theo tỷ lệ theo cùng một hệ số. Ví dụ: trong một chiến dịch TargetCpa được mô phỏng, mục tiêu chiến dịch và tất cả mục tiêu của nhóm quảng cáo được điều chỉnh theo hệ số X.

CpcBidSimulationPointList

Vùng chứa các điểm mô phỏng cho các mô phỏng thuộc loại CPC_BID.

Biểu diễn dưới dạng JSON 
{
  "points": [
    {
      object (CpcBidSimulationPoint)
    }
  ]
}
Trường
points[]

object (CpcBidSimulationPoint)

Chỉ số dự kiến cho một loạt số tiền giá thầu CPC.

CpcBidSimulationPoint

Các chỉ số dự kiến cho một mức giá thầu CPC cụ thể.

Biểu diễn dưới dạng JSON 
{
  "requiredBudgetAmountMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,

  // Union field cpc_simulation_key_value can be only one of the following:
  "cpcBidMicros": string,
  "cpcBidScalingModifier": number
  // End of list of possible types for union field cpc_simulation_key_value.
}
Trường
requiredBudgetAmountMicros

string (int64 format)

Ngân sách hằng ngày bắt buộc dự kiến mà nhà quảng cáo phải đặt để nhận được lưu lượng truy cập ước tính, tính theo đơn vị tiền tệ của nhà quảng cáo.
biddableConversions

number

Số lượt chuyển đổi có thể đặt giá thầu dự kiến.
biddableConversionsValue

number

Tổng giá trị dự kiến của các lượt chuyển đổi có thể đặt giá thầu.
clicks

string (int64 format)

Số lượt nhấp dự kiến.
costMicros

string (int64 format)

Chi phí dự kiến rất nhỏ.
impressions

string (int64 format)

Số lượt hiển thị dự kiến.
topSlotImpressions

string (int64 format)

Số lượt hiển thị dự kiến ở vị trí hàng đầu. Chỉ loại kênh quảng cáo tìm kiếm mới hỗ trợ trường này.
Trường kết hợp cpc_simulation_key_value. Khi SimulateModifyMethod = UNIFORM hoặc DEFAULT, cpc_bid_micros sẽ được đặt. Khi SimulateulationMethod = SCALING, cpc_bid_scaling_modifier được đặt. cpc_simulation_key_value chỉ có thể là một trong những trạng thái sau đây:
cpcBidMicros

string (int64 format)

Giá thầu CPC được mô phỏng làm cơ sở cho các chỉ số dự kiến.
cpcBidScalingModifier

number

Đối tượng sửa đổi tỷ lệ được mô phỏng làm cơ sở cho các chỉ số dự kiến. Tất cả giá thầu CPC liên quan đến thực thể được mô phỏng đều được điều chỉnh theo tỷ lệ.

PercentCpcBidSimulationPointList

Vùng chứa các điểm mô phỏng cho các lượt mô phỏng thuộc loại PERCENT_CPC_BID.

Biểu diễn dưới dạng JSON 
{
  "points": [
    {
      object (PercentCpcBidSimulationPoint)
    }
  ]
}
Trường
points[]

object (PercentCpcBidSimulationPoint)

Các chỉ số dự kiến cho một loạt các mức giá thầu CPC theo tỷ lệ phần trăm.

PercentCpcBidSimulationPoint

Chỉ số dự kiến cho một tỷ lệ phần trăm CPC cụ thể. Chỉ loại kênh Quảng cáo khách sạn mới hỗ trợ trường này.

Biểu diễn dưới dạng JSON 
{
  "percentCpcBidMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string
}
Trường
percentCpcBidMicros

string (int64 format)

Tỷ lệ phần trăm CPC được mô phỏng làm cơ sở cho các chỉ số dự kiến. % CPC được thể hiện dưới dạng một phần của giá quảng cáo cho một số hàng hóa hoặc dịch vụ. Giá trị được lưu trữ ở đây là 1.000.000 * [phân số].
biddableConversions

number

Số lượt chuyển đổi có thể đặt giá thầu dự kiến.
biddableConversionsValue

number

Tổng giá trị dự kiến của các lượt chuyển đổi có thể đặt giá thầu tính theo nội tệ.
clicks

string (int64 format)

Số lượt nhấp dự kiến.
costMicros

string (int64 format)

Chi phí dự kiến rất nhỏ.
impressions

string (int64 format)

Số lượt hiển thị dự kiến.
topSlotImpressions

string (int64 format)

Số lượt hiển thị dự kiến ở vị trí hàng đầu.

AdGroupSimulation

Mô phỏng nhóm quảng cáo. Các kết hợp được hỗ trợ của loại kênh quảng cáo, loại mô phỏng và phương pháp sửa đổi mô phỏng được nêu chi tiết tương ứng bên dưới.

  1. TÌM KIẾM – CPC_BID – MẶC ĐỊNH
  2. TÌM KIẾM – CPC_BID – UNIFORM
  3. TÌM KIẾM - TARGET_CPA - UNIFORM
  4. TÌM KIẾM - TARGET_ROAS - UNIFORM
  5. HIỂN THỊ – CPC_BID – MẶC ĐỊNH
  6. DISPLAY – CPC_BID – UNIFORM
  7. DISPLAY – TARGET_CPA – UNIFORM
Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "adGroupId": string,
  "startDate": string,
  "endDate": string,

  // Union field point_list can be only one of the following:
  "cpcBidPointList": {
    object (CpcBidSimulationPointList)
  },
  "cpvBidPointList": {
    object (CpvBidSimulationPointList)
  },
  "targetCpaPointList": {
    object (TargetCpaSimulationPointList)
  },
  "targetRoasPointList": {
    object (TargetRoasSimulationPointList)
  }
  // End of list of possible types for union field point_list.
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của hoạt động mô phỏng nhóm quảng cáo. Tên tài nguyên mô phỏng nhóm quảng cáo có dạng như sau:

customers/{customerId}/adGroupSimulations/{adGroupId}~{type}~{modificationMethod}~{startDate}~{endDate}
type

enum (SimulationType)

Chỉ có đầu ra. Trường mà mô phỏng sửa đổi.
modificationMethod

enum (SimulationModificationMethod)

Chỉ có đầu ra. Cách hoạt động mô phỏng sửa đổi trường.
adGroupId

string (int64 format)

Chỉ có đầu ra. Mã nhóm quảng cáo của hoạt động mô phỏng.
startDate

string

Chỉ có đầu ra. Ngày đầu tiên của quá trình mô phỏng, có định dạng YYYY-MM-DD.
endDate

string

Chỉ có đầu ra. Ngày cuối cùng của hoạt động mô phỏng, theo định dạng YYYY-MM-DD
Trường kết hợp point_list. Danh sách các điểm mô phỏng. point_list chỉ có thể là một trong những trạng thái sau đây:
cpcBidPointList

object (CpcBidSimulationPointList)

Chỉ có đầu ra. Điểm mô phỏng nếu loại mô phỏng là CPC_BID.
cpvBidPointList

object (CpvBidSimulationPointList)

Chỉ có đầu ra. Điểm mô phỏng nếu loại mô phỏng là CPV_BID.
targetCpaPointList

object (TargetCpaSimulationPointList)

Chỉ có đầu ra. Điểm mô phỏng nếu loại mô phỏng là TARGET_CPA.
targetRoasPointList

object (TargetRoasSimulationPointList)

Chỉ có đầu ra. Điểm mô phỏng nếu loại mô phỏng là TARGET_ROAS.

CpvBidSimulationPointList

Vùng chứa các điểm mô phỏng cho những mô phỏng thuộc loại CPV_BID.

Biểu diễn dưới dạng JSON 
{
  "points": [
    {
      object (CpvBidSimulationPoint)
    }
  ]
}
Trường
points[]

object (CpvBidSimulationPoint)

Các chỉ số dự kiến cho một loạt giá thầu CPV.

CpvBidSimulationPoint

Các chỉ số dự kiến cho một giá thầu CPV cụ thể.

Biểu diễn dưới dạng JSON 
{
  "cpvBidMicros": string,
  "costMicros": string,
  "impressions": string,
  "views": string
}
Trường
cpvBidMicros

string (int64 format)

Giá thầu CPV được mô phỏng làm cơ sở cho các chỉ số dự kiến.
costMicros

string (int64 format)

Chi phí dự kiến rất nhỏ.
impressions

string (int64 format)

Số lượt hiển thị dự kiến.
views

string (int64 format)

Số lượt xem dự kiến.

TargetCpaSimulationPointList

Vùng chứa các điểm mô phỏng cho các mô phỏng thuộc loại TARGET_CPA.

Biểu diễn dưới dạng JSON 
{
  "points": [
    {
      object (TargetCpaSimulationPoint)
    }
  ]
}
Trường
points[]

object (TargetCpaSimulationPoint)

Chỉ số dự kiến cho một loạt các mức CPA mục tiêu.

TargetCpaSimulationPoint

Các chỉ số dự kiến cho một mức CPA mục tiêu cụ thể.

Biểu diễn dưới dạng JSON 
{
  "requiredBudgetAmountMicros": string,
  "appInstalls": number,
  "inAppActions": number,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,
  "interactions": string,

  // Union field target_cpa_simulation_key_value can be only one of the
  // following:
  "targetCpaMicros": string,
  "targetCpaScalingModifier": number
  // End of list of possible types for union field
  // target_cpa_simulation_key_value.
}
Trường
requiredBudgetAmountMicros

string (int64 format)

Ngân sách hàng ngày bắt buộc dự kiến mà nhà quảng cáo phải đặt để nhận được lưu lượng truy cập ước tính, tính theo đơn vị tiền tệ của nhà quảng cáo.
appInstalls

number

Số lượt cài đặt ứng dụng dự kiến.
inAppActions

number

Số hành động trong ứng dụng dự kiến.
biddableConversions

number

Số lượt chuyển đổi có thể đặt giá thầu dự kiến.
biddableConversionsValue

number

Tổng giá trị dự kiến của các lượt chuyển đổi có thể đặt giá thầu.
clicks

string (int64 format)

Số lượt nhấp dự kiến.
costMicros

string (int64 format)

Chi phí dự kiến rất nhỏ.
impressions

string (int64 format)

Số lượt hiển thị dự kiến.
topSlotImpressions

string (int64 format)

Số lượt hiển thị dự kiến ở vị trí hàng đầu. Chỉ loại kênh quảng cáo tìm kiếm mới hỗ trợ trường này.
interactions

string (int64 format)

Số lượt tương tác dự kiến. Chỉ loại kênh quảng cáo khám phá mới hỗ trợ trường này.
Trường kết hợp target_cpa_simulation_key_value. Khi SimulateModifyMethod = UNIFORM hoặc DEFAULT, target_cpa_micros sẽ được đặt. Khi SimulationModificationMethod = SCALING, target_cpa_scaling_modifier sẽ được đặt. target_cpa_simulation_key_value chỉ có thể là một trong những trạng thái sau đây:
targetCpaMicros

string (int64 format)

CPA mục tiêu được mô phỏng làm cơ sở cho các chỉ số dự kiến.
targetCpaScalingModifier

number

Đối tượng sửa đổi tỷ lệ được mô phỏng làm cơ sở cho các chỉ số dự kiến. Tất cả mục tiêu CPA liên quan đến thực thể mô phỏng đều được điều chỉnh theo tỷ lệ.

TargetRoasSimulationPointList

Vùng chứa các điểm mô phỏng cho các mô phỏng thuộc loại TARGET_ROAS.

Biểu diễn dưới dạng JSON 
{
  "points": [
    {
      object (TargetRoasSimulationPoint)
    }
  ]
}
Trường
points[]

object (TargetRoasSimulationPoint)

Chỉ số dự kiến cho một loạt số tiền ROAS mục tiêu.

TargetRoasSimulationPoint

Các chỉ số dự kiến cho một mức ROAS mục tiêu cụ thể.

Biểu diễn dưới dạng JSON 
{
  "requiredBudgetAmountMicros": string,
  "targetRoas": number,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string
}
Trường
requiredBudgetAmountMicros

string (int64 format)

Ngân sách hàng ngày bắt buộc dự kiến mà nhà quảng cáo phải đặt để nhận được lưu lượng truy cập ước tính, tính theo đơn vị tiền tệ của nhà quảng cáo.
targetRoas

number

Lợi tức mục tiêu trên chi tiêu quảng cáo được mô phỏng làm cơ sở cho các chỉ số dự kiến.
biddableConversions

number

Số lượt chuyển đổi có thể đặt giá thầu dự kiến.
biddableConversionsValue

number

Tổng giá trị dự kiến của các lượt chuyển đổi có thể đặt giá thầu.
clicks

string (int64 format)

Số lượt nhấp dự kiến.
costMicros

string (int64 format)

Chi phí dự kiến rất nhỏ.
impressions

string (int64 format)

Số lượt hiển thị dự kiến.
topSlotImpressions

string (int64 format)

Số lượt hiển thị dự kiến ở vị trí hàng đầu. Chỉ loại kênh quảng cáo Tìm kiếm mới hỗ trợ trường này.

AgeRangeView

Chế độ xem độ tuổi.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem độ tuổi. Tên tài nguyên của chế độ xem độ tuổi có dạng như sau:

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

AdScheduleView

Chế độ xem lịch quảng cáo tóm tắt hiệu suất của chiến dịch theo tiêu chí của AdSchedule.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem lịch quảng cáo. Tên tài nguyên chế độ xem AdSchedule có dạng:

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

DomainCategory

Một danh mục được tạo tự động bằng cách thu thập thông tin một miền. Nếu một chiến dịch sử dụng DynamicSearchAdsSetting, thì các danh mục miền sẽ được tạo cho miền đó. Bạn có thể nhắm mục tiêu các danh mục bằng cách sử dụng WebpageConditionInfo. Hãy xem bài viết: https://support.google.com/google-ads/answer/2471185

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "campaign": string,
  "category": string,
  "languageCode": string,
  "domain": string,
  "coverageFraction": number,
  "categoryRank": string,
  "hasChildren": boolean,
  "recommendedCpcBidMicros": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của danh mục miền. Tên tài nguyên danh mục miền có dạng như sau:

customers/{customerId}/domainCategories/{campaignId}~{category_base64}~{languageCode}
campaign

string

Chỉ có đầu ra. Chiến dịch nên dùng danh mục này.
category

string

Chỉ có đầu ra. Danh mục đề xuất cho miền trang web, ví dụ: nếu bạn có trang web về đồ điện tử, thì các danh mục có thể là "máy ảnh", "TV", v.v.
languageCode

string

Chỉ có đầu ra. Mã ngôn ngữ chỉ định ngôn ngữ của trang web, ví dụ: "en" cho tiếng Anh. Bạn có thể chỉ định ngôn ngữ trong Cài đặt DynamicSearchAds bắt buộc đối với quảng cáo tìm kiếm động. Đây là ngôn ngữ của các trang trên trang web của bạn mà bạn muốn Google Ads tìm, tạo quảng cáo và so khớp các nội dung tìm kiếm.
domain

string

Chỉ có đầu ra. Miền của trang web. Bạn có thể chỉ định miền trong Cài đặt DynamicSearchAds bắt buộc đối với quảng cáo tìm kiếm động.
coverageFraction

number

Chỉ có đầu ra. Tỷ lệ số trang trên trang web của bạn khớp với danh mục này.
categoryRank

string (int64 format)

Chỉ có đầu ra. Vị trí của danh mục này trong tập hợp danh mục. Số càng thấp thì kết quả càng phù hợp với miền đó. rỗng biểu thị là không được khuyến nghị.
hasChildren

boolean

Chỉ có đầu ra. Cho biết liệu danh mục này có các danh mục con hay không.
recommendedCpcBidMicros

string (int64 format)

Chỉ có đầu ra. Chi phí mỗi lượt nhấp đề xuất cho danh mục đó.

AssetFieldTypeView

Chế độ xem loại trường tài sản. Chế độ xem này báo cáo các chỉ số không bị tính thừa cho từng loại trường thành phần khi thành phần đó được dùng làm phần mở rộng.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "fieldType": enum (AssetFieldType)
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem loại trường thành phần. Tên tài nguyên chế độ xem của loại trường thành phần có dạng như sau:

customers/{customerId}/assetFieldTypeViews/{fieldType}
fieldType

enum (AssetFieldType)

Chỉ có đầu ra. Loại trường tài sản của chế độ xem loại trường tài sản.

AssetGroupProductGroupView

Chế độ xem nhóm sản phẩm của nhóm thành phần.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "assetGroup": string,
  "assetGroupListingGroupFilter": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem nhóm sản phẩm trong nhóm thành phần. Tên tài nguyên chế độ xem nhóm sản phẩm của nhóm thành phần có dạng như sau:

customers/{customerId}/assetGroupProductGroupViews/{assetGroupId}~{listing_group_filter_id}
assetGroup

string

Chỉ có đầu ra. Nhóm thành phần được liên kết với bộ lọc nhóm trang thông tin.
assetGroupListingGroupFilter

string

Chỉ có đầu ra. Tên tài nguyên của bộ lọc nhóm trang thông tin của nhóm thành phần.

AssetGroupTopCombinationView

Chế độ xem về việc sử dụng tổ hợp thành phần quảng cáo của nhóm quảng cáo.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem tổ hợp hàng đầu của nhóm thành phần. Tên tài nguyên của chế độ xem Kết hợp hàng đầu AssetGroup có dạng: ""customer/{customerId}/assetGroupTopKết hợpViews/{assetGroupId}~{asset_Chế_category}"
assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

Chỉ có đầu ra. Các kiểu kết hợp thành phần hiệu quả nhất được phân phát cùng nhau.

AssetGroupAssetCombinationData

Dữ liệu kết hợp thành phần của nhóm thành phần

Biểu diễn dưới dạng JSON 
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
Trường
assetCombinationServedAssets[]

object (AssetUsage)

Chỉ có đầu ra. Thành phần được phân phát.

AssetSetTypeView

Chế độ xem loại nhóm thành phần. Chế độ xem này báo cáo các chỉ số không bị tính thừa cho từng loại nhóm thành phần. Các loại nhóm thành phần con không được đưa vào báo cáo này. Số liệu thống kê của chúng được tổng hợp theo loại nhóm thành phần chính.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "assetSetType": enum (AssetSetType)
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem loại nhóm thành phần. Tên tài nguyên chế độ xem của loại nhóm thành phần có dạng như sau:

customers/{customerId}/assetSetTypeViews/{assetSetType}
assetSetType

enum (AssetSetType)

Chỉ có đầu ra. Loại nhóm thành phần của chế độ xem loại nhóm thành phần.

BiddingStrategySimulation

Mô phỏng chiến lược đặt giá thầu. Các kết hợp được hỗ trợ của loại mô phỏng và phương pháp sửa đổi mô phỏng được nêu chi tiết tương ứng bên dưới.

  1. TARGET_CPA – UNIFORM
  2. TARGET_ROAS – UNIFORM
Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "biddingStrategyId": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "startDate": string,
  "endDate": string,

  // Union field point_list can be only one of the following:
  "targetCpaPointList": {
    object (TargetCpaSimulationPointList)
  },
  "targetRoasPointList": {
    object (TargetRoasSimulationPointList)
  }
  // End of list of possible types for union field point_list.
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của hoạt động mô phỏng chiến lược đặt giá thầu. Tên tài nguyên mô phỏng chiến lược đặt giá thầu có dạng như sau:

customers/{customerId}/biddingStrategySimulations/{biddingStrategyId}~{type}~{modificationMethod}~{startDate}~{endDate}
biddingStrategyId

string (int64 format)

Chỉ có đầu ra. Chiến lược đặt giá thầu dùng chung mã nhóm mô phỏng.
type

enum (SimulationType)

Chỉ có đầu ra. Trường mà mô phỏng sửa đổi.
modificationMethod

enum (SimulationModificationMethod)

Chỉ có đầu ra. Cách hoạt động mô phỏng sửa đổi trường.
startDate

string

Chỉ có đầu ra. Ngày đầu tiên sử dụng mô phỏng, ở định dạng YYYY-MM-DD.
endDate

string

Chỉ có đầu ra. Ngày cuối cùng của hoạt động mô phỏng, theo định dạng YYYY-MM-DD
Trường kết hợp point_list. Danh sách các điểm mô phỏng. point_list chỉ có thể là một trong những trạng thái sau đây:
targetCpaPointList

object (TargetCpaSimulationPointList)

Chỉ có đầu ra. Điểm mô phỏng nếu loại mô phỏng là TARGET_CPA.
targetRoasPointList

object (TargetRoasSimulationPointList)

Chỉ có đầu ra. Điểm mô phỏng nếu loại mô phỏng là TARGET_ROAS.

CallView

Chế độ xem cuộc gọi bao gồm dữ liệu để theo dõi cuộc gọi của quảng cáo chỉ tạo cuộc gọi điện thoại hoặc phần mở rộng về cuộc gọi.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "callerCountryCode": string,
  "callerAreaCode": string,
  "callDurationSeconds": string,
  "startCallDateTime": string,
  "endCallDateTime": string,
  "callTrackingDisplayLocation": enum (CallTrackingDisplayLocation),
  "type": enum (CallType),
  "callStatus": enum (GoogleVoiceCallStatus)
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của khung hiển thị lệnh gọi. Tên tài nguyên chế độ xem lệnh gọi có dạng:

customers/{customerId}/callViews/{call_detail_id}
callerCountryCode

string

Chỉ có đầu ra. Mã quốc gia của người gọi.
callerAreaCode

string

Chỉ có đầu ra. Mã vùng của người gọi. Rỗng nếu thời lượng cuộc gọi ngắn hơn 15 giây.
callDurationSeconds

string (int64 format)

Chỉ có đầu ra. Thời lượng cuộc gọi do nhà quảng cáo cung cấp, tính bằng giây.
startCallDateTime

string

Chỉ có đầu ra. Ngày bắt đầu cuộc gọi do nhà quảng cáo cung cấp.
endCallDateTime

string

Chỉ có đầu ra. Ngày kết thúc cuộc gọi do nhà quảng cáo cung cấp.
callTrackingDisplayLocation

enum (CallTrackingDisplayLocation)

Chỉ có đầu ra. Vị trí hiển thị tính năng theo dõi cuộc gọi.
type

enum (CallType)

Chỉ có đầu ra. Loại cuộc gọi.
callStatus

enum (GoogleVoiceCallStatus)

Chỉ có đầu ra. Trạng thái của cuộc gọi.

CallTrackingDisplayLocation

Các vị trí hiển thị theo dõi cuộc gọi có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
AD Cuộc gọi điện thoại được thực hiện từ quảng cáo.
LANDING_PAGE Cuộc gọi điện thoại được thực hiện từ quảng cáo trên trang đích sẽ trỏ đến.

CallType

Các loại thuộc tính có thể có từ nơi thực hiện cuộc gọi.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
MANUALLY_DIALED Cuộc gọi điện thoại đã được quay số theo cách thủ công.

GoogleVoiceCallStatus

Các trạng thái có thể có của cuộc gọi Google Voice.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
MISSED Cuộc gọi bị nhỡ.
RECEIVED Đã nhận được cuộc gọi.

CampaignAudienceView

Chế độ xem đối tượng chiến dịch. Bao gồm dữ liệu hiệu suất từ các mối quan tâm, danh sách tái tiếp thị cho quảng cáo trên Mạng Hiển thị và quảng cáo trên Mạng YouTube, cũng như danh sách tái tiếp thị dành cho quảng cáo tìm kiếm (RLSA), được tổng hợp theo tiêu chí chiến dịch và tiêu chí đối tượng. Chế độ xem này chỉ bao gồm đối tượng được đính kèm ở cấp chiến dịch.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem đối tượng của chiến dịch. Tên tài nguyên chế độ xem đối tượng của chiến dịch có dạng:

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

CampaignSearchTermInsight

Chế độ xem cụm từ tìm kiếm Chiến dịch. Chỉ có dữ liệu trong quá khứ bắt đầu từ tháng 3 năm 2023.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "categoryLabel": string,
  "id": string,
  "campaignId": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của thông tin chi tiết về cụm từ tìm kiếm ở cấp chiến dịch. Tên tài nguyên về thông tin chi tiết về cụm từ tìm kiếm ở cấp chiến dịch có dạng như sau:

customers/{customerId}/campaignSearchTermInsights/{campaignId}~{categoryId}
categoryLabel

string

Chỉ có đầu ra. Nhãn cho danh mục tìm kiếm. Chuỗi trống biểu thị danh mục tổng hợp cho các cụm từ tìm kiếm không phù hợp với một danh mục khác.
id

string (int64 format)

Chỉ có đầu ra. Mã của thông tin chi tiết.
campaignId

string (int64 format)

Chỉ có đầu ra. Mã của chiến dịch.

CampaignSimulation

Mô phỏng chiến dịch. Các kết hợp được hỗ trợ của loại kênh quảng cáo, loại mô phỏng và phương pháp sửa đổi mô phỏng được nêu chi tiết tương ứng bên dưới.

  • TÌM KIẾM – CPC_BID – UNIFORM
  • TÌM KIẾM – CPC_BID – TÍNH TOÁN
  • TÌM KIẾM - TARGET_CPA - UNIFORM
  • TÌM KIẾM – TARGET_CPA – HOẠT ĐỘNG CHIA SẺ
  • TÌM KIẾM - TARGET_ROAS - UNIFORM
  • TÌM KIẾM - TARGET_VIEWS_SHARE - UNIFORM
  • TÌM KIẾM – NGÂN SÁCH – ĐỒNG BỘ
  • MUA SẮM – NGÂN SÁCH – ĐỒNG BỘ
  • MUA SẮM – TARGET_ROAS – UNIFORM
  • MULTI_CHANNEL – TARGET_CPA – UNIFORM
  • MULTI_CHANNEL – TARGET_ROAS – UNIFORM
  • KHÁM PHÁ – TARGET_CPA – MẶC ĐỊNH
  • DISPLAY – TARGET_CPA – UNIFORM
  • PERFORMANCE_MAX - TARGET_CPA - UNIFORM
  • PERFORMANCE_MAX – TARGET_ROAS – UNIFORM
  • PERFORMANCE_MAX – NGÂN SÁCH – UNIFORM
Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "campaignId": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "startDate": string,
  "endDate": string,

  // Union field point_list can be only one of the following:
  "cpcBidPointList": {
    object (CpcBidSimulationPointList)
  },
  "targetCpaPointList": {
    object (TargetCpaSimulationPointList)
  },
  "targetRoasPointList": {
    object (TargetRoasSimulationPointList)
  },
  "targetImpressionSharePointList": {
    object (TargetImpressionShareSimulationPointList)
  },
  "budgetPointList": {
    object (BudgetSimulationPointList)
  }
  // End of list of possible types for union field point_list.
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của hoạt động mô phỏng chiến dịch. Tên tài nguyên mô phỏng chiến dịch có dạng:

customers/{customerId}/campaignSimulations/{campaignId}~{type}~{modificationMethod}~{startDate}~{endDate}
campaignId

string (int64 format)

Chỉ có đầu ra. Mã chiến dịch của hoạt động mô phỏng.
type

enum (SimulationType)

Chỉ có đầu ra. Trường mà mô phỏng sửa đổi.
modificationMethod

enum (SimulationModificationMethod)

Chỉ có đầu ra. Cách hoạt động mô phỏng sửa đổi trường.
startDate

string

Chỉ có đầu ra. Ngày đầu tiên sử dụng mô phỏng, ở định dạng YYYY-MM-DD.
endDate

string

Chỉ có đầu ra. Ngày cuối cùng của hoạt động mô phỏng, theo định dạng YYYY-MM-DD
Trường kết hợp point_list. Danh sách các điểm mô phỏng. point_list chỉ có thể là một trong những trạng thái sau đây:
cpcBidPointList

object (CpcBidSimulationPointList)

Chỉ có đầu ra. Điểm mô phỏng nếu loại mô phỏng là CPC_BID.
targetCpaPointList

object (TargetCpaSimulationPointList)

Chỉ có đầu ra. Điểm mô phỏng nếu loại mô phỏng là TARGET_CPA.
targetRoasPointList

object (TargetRoasSimulationPointList)

Chỉ có đầu ra. Điểm mô phỏng nếu loại mô phỏng là TARGET_ROAS.
targetImpressionSharePointList

object (TargetImpressionShareSimulationPointList)

Chỉ có đầu ra. Điểm mô phỏng nếu loại mô phỏng là TARGET_VIEWS_SHARE.
budgetPointList

object (BudgetSimulationPointList)

Chỉ có đầu ra. Điểm mô phỏng nếu loại mô phỏng là BUDGET.

TargetImpressionShareSimulationPointList

Vùng chứa các điểm mô phỏng cho các hệ thống mô phỏng thuộc loại TARGET_GOAL_SHARE.

Biểu diễn dưới dạng JSON 
{
  "points": [
    {
      object (TargetImpressionShareSimulationPoint)
    }
  ]
}
Trường
points[]

object (TargetImpressionShareSimulationPoint)

Chỉ số dự kiến cho một giá trị tỷ lệ hiển thị mục tiêu cụ thể.

TargetImpressionShareSimulationPoint

Chỉ số dự kiến cho một giá trị tỷ lệ hiển thị mục tiêu cụ thể.

Biểu diễn dưới dạng JSON 
{
  "targetImpressionShareMicros": string,
  "requiredCpcBidCeilingMicros": string,
  "requiredBudgetAmountMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,
  "absoluteTopImpressions": string
}
Trường
targetImpressionShareMicros

string (int64 format)

Giá trị tỷ lệ hiển thị mục tiêu được mô phỏng (tính bằng micrô giây) làm cơ sở cho các chỉ số dự kiến. Ví dụ: tỷ lệ hiển thị 10%, bằng 0, 1, được lưu trữ dưới dạng 100_000. Giá trị này đã được xác thực và không vượt quá 1 triệu (100%).
requiredCpcBidCeilingMicros

string (int64 format)

Mức trần giá thầu cpc hàng ngày dự kiến mà nhà quảng cáo phải đặt để áp dụng mô phỏng này, theo giá trị cực nhỏ của đơn vị tiền tệ của nhà quảng cáo.
requiredBudgetAmountMicros

string (int64 format)

Ngân sách hàng ngày bắt buộc dự kiến mà nhà quảng cáo phải đặt để nhận được lưu lượng truy cập ước tính, tính theo đơn vị tiền tệ của nhà quảng cáo.
biddableConversions

number

Số lượt chuyển đổi có thể đặt giá thầu dự kiến.
biddableConversionsValue

number

Tổng giá trị dự kiến của các lượt chuyển đổi có thể đặt giá thầu.
clicks

string (int64 format)

Số lượt nhấp dự kiến.
costMicros

string (int64 format)

Chi phí dự kiến rất nhỏ.
impressions

string (int64 format)

Số lượt hiển thị dự kiến.
topSlotImpressions

string (int64 format)

Số lượt hiển thị dự kiến ở vị trí hàng đầu. Chỉ loại kênh quảng cáo tìm kiếm mới hỗ trợ trường này.
absoluteTopImpressions

string (int64 format)

Số lượt hiển thị ở vị trí đầu tiên dự kiến. Chỉ loại kênh quảng cáo tìm kiếm mới hỗ trợ trường này.

BudgetSimulationPointList

Vùng chứa các điểm mô phỏng cho các mô phỏng thuộc loại BUDGET.

Biểu diễn dưới dạng JSON 
{
  "points": [
    {
      object (BudgetSimulationPoint)
    }
  ]
}
Trường
points[]

object (BudgetSimulationPoint)

Chỉ số dự kiến cho một loạt số tiền ngân sách.

BudgetSimulationPoint

Các chỉ số dự kiến cho một mức ngân sách cụ thể.

Biểu diễn dưới dạng JSON 
{
  "budgetAmountMicros": string,
  "requiredCpcBidCeilingMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,
  "interactions": string
}
Trường
budgetAmountMicros

string (int64 format)

Ngân sách được mô phỏng làm cơ sở cho các chỉ số dự kiến.
requiredCpcBidCeilingMicros

string (int64 format)

Mức trần giá thầu cpc hàng ngày dự kiến mà nhà quảng cáo phải đặt để áp dụng mô phỏng này, theo giá trị cực nhỏ của đơn vị tiền tệ của nhà quảng cáo. Chỉ những chiến dịch sử dụng chiến lược đặt giá thầu theo Mức chi tiêu mục tiêu mới hỗ trợ trường này.
biddableConversions

number

Số lượt chuyển đổi có thể đặt giá thầu dự kiến.
biddableConversionsValue

number

Tổng giá trị dự kiến của các lượt chuyển đổi có thể đặt giá thầu.
clicks

string (int64 format)

Số lượt nhấp dự kiến.
costMicros

string (int64 format)

Chi phí dự kiến rất nhỏ.
impressions

string (int64 format)

Số lượt hiển thị dự kiến.
topSlotImpressions

string (int64 format)

Số lượt hiển thị dự kiến ở vị trí hàng đầu. Chỉ loại kênh quảng cáo tìm kiếm mới hỗ trợ trường này.
interactions

string (int64 format)

Số lượt tương tác dự kiến. Chỉ loại kênh quảng cáo khám phá mới hỗ trợ trường này.

CarrierConstant

Tiêu chí mạng di động có thể được sử dụng trong nhắm mục tiêu chiến dịch.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "countryCode": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của tiêu chí sóng mang. Tên tài nguyên tiêu chí sóng mang có dạng như sau:

carrierConstants/{criterionId}
id

string (int64 format)

Chỉ có đầu ra. Mã của tiêu chí hãng vận chuyển.
name

string

Chỉ có đầu ra. Tên đầy đủ của hãng vận chuyển bằng tiếng Anh.
countryCode

string

Chỉ có đầu ra. Mã quốc gia của quốc gia có hãng vận chuyển, ví dụ: "AR", "FR", v.v.

ChangeEvent

Mô tả sự thay đổi chi tiết của tài nguyên được trả về của một số loại tài nguyên nhất định. Các thay đổi được thực hiện thông qua giao diện người dùng hoặc API trong 30 ngày qua cũng được đưa vào. Các giá trị trước đó và mới của các trường đã thay đổi sẽ hiển thị. Thay đổi có thể cần tới 3 phút để phản ánh thay đổi mới.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "changeDateTime": string,
  "changeResourceType": enum (ChangeEventResourceType),
  "changeResourceName": string,
  "clientType": enum (ChangeClientType),
  "userEmail": string,
  "oldResource": {
    object (ChangedResource)
  },
  "newResource": {
    object (ChangedResource)
  },
  "resourceChangeOperation": enum (ResourceChangeOperation),
  "changedFields": string,
  "campaign": string,
  "adGroup": string,
  "feed": string,
  "feedItem": string,
  "asset": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của sự kiện thay đổi. Đổi tên tài nguyên sự kiện có dạng như sau:

customers/{customerId}/changeEvents/{timestamp_micros}~{command_index}~{mutate_index}
changeDateTime

string

Chỉ có đầu ra. Thời điểm thay đổi được thực hiện trên tài nguyên này.
changeResourceType

enum (ChangeEventResourceType)

Chỉ có đầu ra. Loại tài nguyên đã thay đổi. Điều này cho biết tài nguyên nào sẽ được đặt trong oldResource và newResource.
changeResourceName

string

Chỉ có đầu ra. Đơn giản là tài nguyên này đã xảy ra thay đổi.
clientType

enum (ChangeClientType)

Chỉ có đầu ra. Vị trí thực hiện thay đổi.
userEmail

string

Chỉ có đầu ra. Email của người dùng đã thực hiện thay đổi này.
oldResource

object (ChangedResource)

Chỉ có đầu ra. Tài nguyên cũ trước khi thay đổi. Chỉ những trường đã thay đổi sẽ được điền sẵn.
newResource

object (ChangedResource)

Chỉ có đầu ra. Tài nguyên mới sau khi thay đổi. Chỉ những trường đã thay đổi sẽ được điền sẵn.
resourceChangeOperation

enum (ResourceChangeOperation)

Chỉ có đầu ra. Thao tác trên tài nguyên đã thay đổi.
changedFields

string (FieldMask format)

Chỉ có đầu ra. Danh sách các trường đã bị thay đổi trong tài nguyên được trả về.

Đây là danh sách các tên trường đủ điều kiện được phân tách bằng dấu phẩy. Ví dụ: "user.displayName,photo"
campaign

string

Chỉ có đầu ra. Chiến dịch bị ảnh hưởng bởi thay đổi này.
adGroup

string

Chỉ có đầu ra. Nhóm Quảng cáo bị ảnh hưởng bởi thay đổi này.
feed

string

Chỉ có đầu ra. Nguồn cấp dữ liệu bị ảnh hưởng bởi thay đổi này.
feedItem

string

Chỉ có đầu ra. Mục nguồn cấp dữ liệu bị ảnh hưởng bởi thay đổi này.
asset

string

Chỉ có đầu ra. Tài sản chịu ảnh hưởng của thay đổi này.

ChangeEventResourceType

Enum liệt kê các loại tài nguyên được hỗ trợ theo tài nguyên ChangeEvent.

Enum
UNSPECIFIED Chưa chỉ định giá trị nào.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị một tài nguyên chưa phân loại (không xác định) trong phiên bản này.
AD Thay đổi về tài nguyên quảng cáo.
AD_GROUP Thay đổi tài nguyên Nhóm quảng cáo.
AD_GROUP_CRITERION Thay đổi tài nguyên Tiêu chí nhóm quảng cáo.
CAMPAIGN Thay đổi tài nguyên Chiến dịch.
CAMPAIGN_BUDGET Thay đổi tài nguyên Ngân sách chiến dịch.
AD_GROUP_BID_MODIFIER Thay đổi tài nguyên của AdGroupBidModifier.
CAMPAIGN_CRITERION Thay đổi tài nguyên Tiêu chí chiến dịch.
FEED Thay đổi tài nguyên Nguồn cấp dữ liệu.
FEED_ITEM Thay đổi tài nguyên FeedItem.
CAMPAIGN_FEED Thay đổi tài nguyên CampaignFeed.
AD_GROUP_FEED Thay đổi tài nguyên AdGroupFeed.
AD_GROUP_AD Thay đổi tài nguyên của Nhóm quảng cáo.
ASSET Thay đổi về tài nguyên thành phần.
CUSTOMER_ASSET Thay đổi tài nguyên CustomerAsset.
CAMPAIGN_ASSET Thay đổi tài nguyên CampaignAsset.
AD_GROUP_ASSET Thay đổi tài nguyên AdGroupAsset.
ASSET_SET Thay đổi tài nguyên AssetSet.
ASSET_SET_ASSET Thay đổi tài nguyên AssetSetAsset.
CAMPAIGN_ASSET_SET Thay đổi tài nguyên CampaignAssetSet.

ChangeClientType

Nguồn mà tài nguyên changeEvent đã được thực hiện.

Enum
UNSPECIFIED Chưa chỉ định giá trị nào.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị một loại ứng dụng chưa phân loại không xác định trong phiên bản này.
GOOGLE_ADS_WEB_CLIENT Các thay đổi được thực hiện thông qua "ads.google.com". Ví dụ: các thay đổi được thực hiện thông qua hoạt động quản lý chiến dịch.
GOOGLE_ADS_AUTOMATED_RULE Các thay đổi được thực hiện thông qua quy tắc tự động của Google Ads.
GOOGLE_ADS_SCRIPTS Các thay đổi đã thực hiện thông qua tập lệnh Google Ads.
GOOGLE_ADS_BULK_UPLOAD Các thay đổi do tính năng tải lên hàng loạt của Google Ads thực hiện.
GOOGLE_ADS_API Các thay đổi do API Google Ads thực hiện.
GOOGLE_ADS_EDITOR Các thay đổi do Google Ads Editor thực hiện. Giá trị này là một phần giữ chỗ. API không trả về những thay đổi này.
GOOGLE_ADS_MOBILE_APP Các thay đổi do ứng dụng Google Ads thực hiện.
GOOGLE_ADS_RECOMMENDATIONS Các thay đổi đã thực hiện thông qua đề xuất của Google Ads.
SEARCH_ADS_360_SYNC Các thay đổi đã thực hiện thông qua tính năng Đồng bộ hoá Search Ads 360.
SEARCH_ADS_360_POST Các thay đổi được thực hiện thông qua Bài đăng trên Search Ads 360.
INTERNAL_TOOL Thay đổi được thực hiện thông qua các công cụ nội bộ. Ví dụ: khi người dùng đặt mẫu URL trên một thực thể như Chiến dịch, mẫu URL đó sẽ tự động được bao bọc bằng URL máy chủ lượt nhấp SA360.
OTHER Những loại thay đổi không được phân loại, ví dụ: thay đổi do sử dụng phiếu giảm giá thông qua Google Ads.
GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION Các thay đổi được thực hiện nhờ đăng ký nhận các đề xuất của Google Ads.

ChangedResource

Một proto trình bao bọc cho thấy tất cả tài nguyên được hỗ trợ. Chỉ có tài nguyên của changeResourceType được đặt.

Biểu diễn dưới dạng JSON 
{
  "ad": {
    object (Ad)
  },
  "adGroup": {
    object (AdGroup)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "feed": {
    object (Feed)
  },
  "feedItem": {
    object (FeedItem)
  },
  "campaignFeed": {
    object (CampaignFeed)
  },
  "adGroupFeed": {
    object (AdGroupFeed)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "asset": {
    object (Asset)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  }
}
Trường
ad

object (Ad)

Chỉ có đầu ra. Đặt nếu changeResourceType == AD.
adGroup

object (AdGroup)

Chỉ có đầu ra. Đặt nếu changeResourceType == AD_GROUP.
adGroupCriterion

object (AdGroupCriterion)

Chỉ có đầu ra. Đặt nếu changeResourceType == AD_GROUP_ ván
campaign

object (Campaign)

Chỉ có đầu ra. Đặt nếu changeResourceType == CAMPAIGN.
campaignBudget

object (CampaignBudget)

Chỉ có đầu ra. Đặt nếu changeResourceType == CAMPAIGN_BUDGET.
adGroupBidModifier

object (AdGroupBidModifier)

Chỉ có đầu ra. Đặt nếu changeResourceType == AD_GROUP_BID_ung.
campaignCriterion

object (CampaignCriterion)

Chỉ có đầu ra. Đặt nếu changeResourceType == CAMPAIGN_SCOPE.
feed

object (Feed)

Chỉ có đầu ra. Đặt nếu changeResourceType == FEED.
feedItem

object (FeedItem)

Chỉ có đầu ra. Đặt nếu changeResourceType == FEED_ITEM.
campaignFeed

object (CampaignFeed)

Chỉ có đầu ra. Đặt nếu changeResourceType == CAMPAIGN_FEED.
adGroupFeed

object (AdGroupFeed)

Chỉ có đầu ra. Đặt nếu changeResourceType == AD_GROUP_FEED.
adGroupAd

object (AdGroupAd)

Chỉ có đầu ra. Đặt nếu changeResourceType == AD_GROUP_AD.
asset

object (Asset)

Chỉ có đầu ra. Đặt nếu changeResourceType == ASSET.
customerAsset

object (CustomerAsset)

Chỉ có đầu ra. Đặt nếu changeResourceType == CUSTOMER_ASSET.
campaignAsset

object (CampaignAsset)

Chỉ có đầu ra. Đặt nếu changeResourceType == CAMPAIGN_ASSET.
adGroupAsset

object (AdGroupAsset)

Chỉ có đầu ra. Đặt nếu changeResourceType == AD_GROUP_ASSET.
assetSet

object (AssetSet)

Chỉ có đầu ra. Đặt nếu changeResourceType == ASSET_SET.
assetSetAsset

object (AssetSetAsset)

Chỉ có đầu ra. Đặt nếu changeResourceType == ASSET_SET_ASSET.
campaignAssetSet

object (CampaignAssetSet)

Chỉ có đầu ra. Đặt nếu changeResourceType == CAMPAIGN_ASSET_SET.

ResourceChangeOperation

Thao tác trên tài nguyên đã thay đổi trong tài nguyên changeEvent.

Enum
UNSPECIFIED Chưa chỉ định giá trị nào.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị một toán tử chưa phân loại và không xác định trong phiên bản này.
CREATE Đã tạo tài nguyên.
UPDATE Tài nguyên đã được sửa đổi.
REMOVE Tài nguyên đã bị xoá.

ChangeStatus

Mô tả trạng thái của tài nguyên được trả về. ChangeStatus có thể cần tới 3 phút để phản ánh thay đổi mới.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "resourceType": enum (ChangeStatusResourceType),
  "resourceStatus": enum (ChangeStatusOperation),
  "sharedSet": string,
  "campaignSharedSet": string,
  "asset": string,
  "customerAsset": string,
  "campaignAsset": string,
  "adGroupAsset": string,
  "combinedAudience": string,
  "lastChangeDateTime": string,
  "campaign": string,
  "adGroup": string,
  "adGroupAd": string,
  "adGroupCriterion": string,
  "campaignCriterion": string,
  "feed": string,
  "feedItem": string,
  "adGroupFeed": string,
  "campaignFeed": string,
  "adGroupBidModifier": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của trạng thái thay đổi. Tên tài nguyên trạng thái thay đổi có dạng như sau:

customers/{customerId}/changeStatus/{change_status_id}
resourceType

enum (ChangeStatusResourceType)

Chỉ có đầu ra. Biểu thị loại tài nguyên đã thay đổi. Điều này cho biết trường nào sẽ được đặt. Ví dụ: đối với AD_GROUP, trường chiến dịch và nhóm quảng cáo sẽ được đặt.
resourceStatus

enum (ChangeStatusOperation)

Chỉ có đầu ra. Biểu thị trạng thái của tài nguyên đã thay đổi.
sharedSet

string

Chỉ có đầu ra. SharedSet bị ảnh hưởng bởi thay đổi này.
campaignSharedSet

string

Chỉ có đầu ra. CampaignSharedSet bị ảnh hưởng bởi thay đổi này.
asset

string

Chỉ có đầu ra. Tài sản chịu ảnh hưởng của thay đổi này.
customerAsset

string

Chỉ có đầu ra. CustomerAsset bị ảnh hưởng bởi thay đổi này.
campaignAsset

string

Chỉ có đầu ra. Tài sản chiến dịch chịu ảnh hưởng của thay đổi này.
adGroupAsset

string

Chỉ có đầu ra. Nhóm Quảng cáo thành phần bị ảnh hưởng bởi thay đổi này.
combinedAudience

string

Chỉ có đầu ra. Đối tượng kết hợp bị ảnh hưởng bởi thay đổi này.
lastChangeDateTime

string

Chỉ có đầu ra. Thời gian xảy ra thay đổi gần đây nhất trên tài nguyên này.
campaign

string

Chỉ có đầu ra. Chiến dịch bị ảnh hưởng bởi thay đổi này.
adGroup

string

Chỉ có đầu ra. Nhóm Quảng cáo bị ảnh hưởng bởi thay đổi này.
adGroupAd

string

Chỉ có đầu ra. Nhóm Quảng cáo bị ảnh hưởng bởi thay đổi này.
adGroupCriterion

string

Chỉ có đầu ra. Tiêu chí Nhóm Quảng cáo bị ảnh hưởng bởi thay đổi này.
campaignCriterion

string

Chỉ có đầu ra. Tiêu chí Chiến dịch bị ảnh hưởng bởi thay đổi này.
feed

string

Chỉ có đầu ra. Nguồn cấp dữ liệu bị ảnh hưởng bởi thay đổi này.
feedItem

string

Chỉ có đầu ra. Mục nguồn cấp dữ liệu bị ảnh hưởng bởi thay đổi này.
adGroupFeed

string

Chỉ có đầu ra. Nhóm quảng cáo nguồn cấp dữ liệu bị ảnh hưởng bởi thay đổi này.
campaignFeed

string

Chỉ có đầu ra. Nguồn cấp dữ liệu chiến dịch bị ảnh hưởng bởi thay đổi này.
adGroupBidModifier

string

Chỉ có đầu ra. thay đổi này đã ảnh hưởng đến nhóm AdGroupModifier.

ChangeStatusResourceType

Enum liệt kê các loại tài nguyên được hỗ trợ theo tài nguyên ChangeStatus.

Enum
UNSPECIFIED Chưa chỉ định giá trị nào.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị một tài nguyên chưa phân loại (không xác định) trong phiên bản này.
AD_GROUP Thay đổi tài nguyên Nhóm quảng cáo.
AD_GROUP_AD Thay đổi tài nguyên của Nhóm quảng cáo.
AD_GROUP_CRITERION Thay đổi tài nguyên Tiêu chí nhóm quảng cáo.
CAMPAIGN Thay đổi tài nguyên Chiến dịch.
CAMPAIGN_CRITERION Thay đổi tài nguyên Tiêu chí chiến dịch.
FEED Thay đổi tài nguyên Nguồn cấp dữ liệu.
FEED_ITEM Thay đổi tài nguyên FeedItem.
AD_GROUP_FEED Thay đổi tài nguyên AdGroupFeed.
CAMPAIGN_FEED Thay đổi tài nguyên CampaignFeed.
AD_GROUP_BID_MODIFIER Thay đổi tài nguyên của AdGroupBidModifier.
SHARED_SET Thay đổi tài nguyên SharedSet.
CAMPAIGN_SHARED_SET Thay đổi tài nguyên CampaignSharedSet.
ASSET Thay đổi về tài nguyên thành phần.
CUSTOMER_ASSET Thay đổi tài nguyên CustomerAsset.
CAMPAIGN_ASSET Thay đổi tài nguyên CampaignAsset.
AD_GROUP_ASSET Thay đổi tài nguyên AdGroupAsset.
COMBINED_AUDIENCE Thay đổi tài nguyên kết hợp đối tượng.

ChangeStatusOperation

Trạng thái của tài nguyên đã thay đổi

Enum
UNSPECIFIED Chưa chỉ định giá trị nào.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị một tài nguyên chưa phân loại (không xác định) trong phiên bản này.
ADDED Đã tạo tài nguyên.
CHANGED Tài nguyên đã được sửa đổi.
REMOVED Tài nguyên đã bị xoá.

CombinedAudience

Mô tả tài nguyên cho đối tượng kết hợp bao gồm nhiều đối tượng.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "id": string,
  "status": enum (CombinedAudienceStatus),
  "name": string,
  "description": string
}
Trường
resourceName

string

Không thể thay đổi. Tên tài nguyên của đối tượng kết hợp. Tên đối tượng được kết hợp có dạng:

customers/{customerId}/combinedAudience/{combined_audience_id}
id

string (int64 format)

Chỉ có đầu ra. Mã của đối tượng kết hợp.
status

enum (CombinedAudienceStatus)

Chỉ có đầu ra. Trạng thái của đối tượng kết hợp này. Cho biết liệu đối tượng kết hợp được bật hay xoá.
name

string

Chỉ có đầu ra. Tên của đối tượng kết hợp. Giá trị này phải khác nhau trên tất cả các đối tượng kết hợp.
description

string

Chỉ có đầu ra. Nội dung mô tả về đối tượng kết hợp này.

CombinedAudienceStatus

Enum chứa các loại trạng thái của đối tượng kết hợp có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
ENABLED Trạng thái Đã bật – đối tượng kết hợp đang bật và có thể nhắm mục tiêu.
REMOVED Trạng thái đã xoá – đối tượng kết hợp đã bị xoá và không thể dùng để nhắm mục tiêu.

ClickView

Chế độ xem lượt nhấp với các chỉ số được tổng hợp ở từng cấp độ lượt nhấp, bao gồm cả lượt nhấp hợp lệ và không hợp lệ. Đối với các chiến dịch không phải là chiến dịch Tìm kiếm, chỉ số lượt nhấp thể hiện số lượt tương tác hợp lệ và không hợp lệ. Các truy vấn bao gồm ClickView phải có bộ lọc giới hạn kết quả trong một ngày và có thể được yêu cầu cho các truy vấn cách đây 90 ngày trước thời điểm yêu cầu.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "areaOfInterest": {
    object (ClickLocation)
  },
  "locationOfPresence": {
    object (ClickLocation)
  },
  "keyword": string,
  "keywordInfo": {
    object (KeywordInfo)
  },
  "gclid": string,
  "pageNumber": string,
  "adGroupAd": string,
  "campaignLocationTarget": string,
  "userList": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của khung hiển thị lượt nhấp. Tên tài nguyên của khung hiển thị lượt nhấp có dạng như sau:

customers/{customerId}/clickViews/{date (yyyy-MM-dd)}~{gclid}
areaOfInterest

object (ClickLocation)

Chỉ có đầu ra. Tiêu chí vị trí khớp với khu vực quan tâm liên quan đến hiển thị.
locationOfPresence

object (ClickLocation)

Chỉ có đầu ra. Tiêu chí vị trí khớp với vị trí hiện diện được liên kết với lượt hiển thị.
keyword

string

Chỉ có đầu ra. Từ khoá được liên kết, nếu có một từ khoá và lượt nhấp tương ứng với kênh TÌM KIẾM.
keywordInfo

object (KeywordInfo)

Chỉ có đầu ra. Thông tin cơ bản về từ khoá được liên kết, nếu có.
gclid

string

Chỉ có đầu ra. Mã lượt nhấp của Google.
pageNumber

string (int64 format)

Chỉ có đầu ra. Số trang trong kết quả tìm kiếm, nơi quảng cáo được hiển thị.
adGroupAd

string

Chỉ có đầu ra. Quảng cáo được liên kết.
campaignLocationTarget

string

Chỉ có đầu ra. Mục tiêu vị trí chiến dịch được liên kết, nếu có.
userList

string

Chỉ có đầu ra. Danh sách người dùng được liên kết, nếu có.

ClickLocation

Tiêu chí về vị trí được liên kết với một lượt nhấp.

Biểu diễn dưới dạng JSON 
{
  "city": string,
  "country": string,
  "metro": string,
  "mostSpecific": string,
  "region": string
}
Trường
city

string

Tiêu chí vị trí thành phố được liên kết với lượt hiển thị.
country

string

Tiêu chí vị trí quốc gia được liên kết với lượt hiển thị.
metro

string

Tiêu chí vị trí thành phố lớn được liên kết với lượt hiển thị.
mostSpecific

string

Tiêu chí vị trí cụ thể nhất được liên kết với lượt hiển thị.
region

string

Tiêu chí vị trí khu vực được liên kết với lượt hiển thị.

CurrencyConstant

Hằng số tiền tệ.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "code": string,
  "name": string,
  "symbol": string,
  "billableUnitMicros": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của hằng số tiền tệ. Tên tài nguyên hằng số tiền tệ có dạng như sau:

currencyConstants/{code}
code

string

Chỉ có đầu ra. Mã đơn vị tiền tệ gồm ba chữ cái theo ISO 4217, ví dụ: "USD"
name

string

Chỉ có đầu ra. Tên đầy đủ bằng tiếng Anh của đơn vị tiền tệ.
symbol

string

Chỉ có đầu ra. Biểu tượng tiêu chuẩn để mô tả đơn vị tiền tệ này, ví dụ: '$' cho Đô la Mỹ.
billableUnitMicros

string (int64 format)

Chỉ có đầu ra. Đơn vị có thể tính phí cho đơn vị tiền tệ này. Số tiền đã lập hoá đơn phải là bội số của giá trị này.

AccessibleBiddingStrategy

Thể hiện chế độ xem Đặt giá thầu do khách hàng sở hữu và chia sẻ với khách hàng.

Trái ngược với BiddingStrategy, tài nguyên này bao gồm các chiến lược do người quản lý của khách hàng sở hữu và được chia sẻ với khách hàng này, ngoài các chiến lược mà khách hàng này sở hữu. Tài nguyên này không cung cấp các chỉ số và chỉ trình bày một số ít các thuộc tính Đặt giá thầu.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

  // Union field scheme can be only one of the following:
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chiến lược đặt giá thầu có thể truy cập. Tên tài nguyên AccessibleBidStrategy có dạng:

customers/{customerId}/accessibleBiddingStrategies/{biddingStrategyId}
id

string (int64 format)

Chỉ có đầu ra. Mã của chiến lược đặt giá thầu.
name

string

Chỉ có đầu ra. Tên của chiến lược đặt giá thầu.
type

enum (BiddingStrategyType)

Chỉ có đầu ra. Loại chiến lược đặt giá thầu.
ownerCustomerId

string (int64 format)

Chỉ có đầu ra. Mã của khách hàng sở hữu chiến lược đặt giá thầu.
ownerDescriptiveName

string

Chỉ có đầu ra. descriptionName của Khách hàng sở hữu chiến lược đặt giá thầu.

Trường kết hợp scheme. Giao thức đặt giá thầu.

Bạn chỉ có thể đặt một. scheme chỉ có thể là một trong những trạng thái sau đây:
maximizeConversionValue

object (MaximizeConversionValue)

Chỉ có đầu ra. Một chiến lược đặt giá thầu tự động giúp bạn nhận được giá trị lượt chuyển đổi cao nhất cho chiến dịch khi chi tiêu ngân sách.
maximizeConversions

object (MaximizeConversions)

Chỉ có đầu ra. Một chiến lược đặt giá thầu tự động giúp nhận được nhiều lượt chuyển đổi nhất cho chiến dịch khi chi tiêu ngân sách của bạn.
targetCpa

object (TargetCpa)

Chỉ có đầu ra. Chiến lược đặt giá thầu sẽ đặt giá thầu để giúp bạn nhận được nhiều lượt chuyển đổi nhất có thể ở mức giá mỗi chuyển đổi (CPA) mục tiêu mà bạn đã đặt.
targetImpressionShare

object (TargetImpressionShare)

Chỉ có đầu ra. Chiến lược đặt giá thầu tự động tối ưu hoá theo tỷ lệ phần trăm lượt hiển thị đã chọn.
targetRoas

object (TargetRoas)

Chỉ có đầu ra. Chiến lược đặt giá thầu giúp bạn tối đa hoá doanh thu trong khi vẫn đạt được lợi tức trên chi tiêu quảng cáo (ROAS) mục tiêu cụ thể.
targetSpend

object (TargetSpend)

Chỉ có đầu ra. Chiến lược giá thầu sẽ đặt giá thầu để giúp bạn nhận được nhiều lượt nhấp nhất có thể trong phạm vi ngân sách của mình.

MaximizeConversionValue

Một chiến lược đặt giá thầu tự động giúp bạn nhận được giá trị lượt chuyển đổi cao nhất cho chiến dịch khi chi tiêu ngân sách.

Biểu diễn dưới dạng JSON 
{
  "targetRoas": number
}
Trường
targetRoas

number

Chỉ có đầu ra. Tuỳ chọn lợi tức mục tiêu trên chi tiêu quảng cáo (ROAS). Nếu được đặt, chiến lược giá thầu sẽ tối đa hoá doanh thu trong khi tính trung bình lợi tức mục tiêu trên chi tiêu quảng cáo. Nếu ROAS mục tiêu cao, chiến lược giá thầu có thể không chi tiêu được toàn bộ ngân sách. Nếu bạn không đặt ROAS mục tiêu, chiến lược giá thầu sẽ nhắm đến việc đạt được ROAS cao nhất có thể trong phạm vi ngân sách.

MaximizeConversions

Một chiến lược đặt giá thầu tự động giúp nhận được nhiều lượt chuyển đổi nhất cho chiến dịch khi chi tiêu ngân sách của bạn.

Biểu diễn dưới dạng JSON 
{
  "targetCpaMicros": string
}
Trường
targetCpaMicros

string (int64 format)

Chỉ có đầu ra. Tuỳ chọn chi phí thu nạp khách hàng (CPA) mục tiêu. Đây là số tiền trung bình mà bạn muốn chi tiêu cho mỗi lượt thu nạp khách hàng.

TargetCpa

Một chiến lược giá thầu tự động sẽ đặt giá thầu để giúp bạn nhận được nhiều lượt chuyển đổi nhất có thể ở mức giá mỗi chuyển đổi (CPA) mục tiêu mà bạn đã đặt.

Biểu diễn dưới dạng JSON 
{
  "targetCpaMicros": string
}
Trường
targetCpaMicros

string (int64 format)

Chỉ có đầu ra. Mục tiêu CPA trung bình. Mục tiêu này phải lớn hơn hoặc bằng đơn vị có thể tính phí tối thiểu dựa trên đơn vị tiền tệ của tài khoản.

TargetImpressionShare

Một chiến lược đặt giá thầu tự động sẽ đặt giá thầu sao cho một tỷ lệ phần trăm quảng cáo tìm kiếm nhất định xuất hiện ở đầu trang đầu tiên (hoặc vị trí khác được nhắm mục tiêu).

Biểu diễn dưới dạng JSON 
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
Trường
location

enum (TargetImpressionShareLocation)

Chỉ có đầu ra. Vị trí được nhắm mục tiêu trên trang kết quả tìm kiếm.
locationFractionMicros

string (int64 format)

Tỷ lệ phần trăm quảng cáo được chọn sẽ hiển thị ở vị trí được nhắm mục tiêu tính theo micro giây. Ví dụ: 1% bằng 10.000.
cpcBidCeilingMicros

string (int64 format)

Chỉ có đầu ra. Giá thầu CPC cao nhất mà hệ thống đặt giá thầu tự động được phép chỉ định. Đây là trường bắt buộc do nhà quảng cáo nhập giá trị trần và được chỉ định trong phạm vi cục bộ.

TargetRoas

Một chiến lược đặt giá thầu tự động giúp bạn tối đa hoá doanh thu trong khi vẫn đạt được một mức lợi tức mục tiêu trên chi tiêu quảng cáo (ROAS) mục tiêu cụ thể.

Biểu diễn dưới dạng JSON 
{
  "targetRoas": number
}
Trường
targetRoas

number

Chỉ có đầu ra. Doanh thu đã chọn (dựa trên dữ liệu lượt chuyển đổi) trên mỗi đơn vị chi tiêu.

TargetSpend

Một chiến lược đặt giá thầu tự động giúp bạn đặt giá thầu để giúp bạn nhận được nhiều lượt nhấp nhất có thể trong phạm vi ngân sách của mình.

Biểu diễn dưới dạng JSON 
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
Trường
targetSpendMicros
(deprecated)

string (int64 format)

Chỉ có đầu ra. Mục tiêu chi tiêu mà bạn đặt ra để tối đa hoá số lượt nhấp. Bên đặt giá thầu Mục tiêu chi tiêu sẽ cố gắng chi tiêu ít hơn giá trị này hoặc số tiền chi tiêu điều tiết tự nhiên. Nếu bạn không chỉ định, ngân sách sẽ được dùng làm mục tiêu chi tiêu. Trường này không được dùng nữa và không nên được sử dụng nữa. Hãy xem https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html để biết thông tin chi tiết.
cpcBidCeilingMicros

string (int64 format)

Chỉ có đầu ra. Hạn mức giá thầu tối đa mà chiến lược giá thầu có thể đặt. Giới hạn này áp dụng cho tất cả từ khóa do chiến lược quản lý.

CustomerClient

Mối liên kết giữa khách hàng cụ thể và khách hàng của khách hàng. Đối tượng CustomerClient chỉ dành cho khách hàng là người quản lý. Tất cả khách hàng trực tiếp và gián tiếp của khách hàng đều được bao gồm, cũng như bản thân người quản lý.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của ứng dụng của khách hàng. Tên tài nguyên CustomerClient có dạng: customers/{customerId}/customerClients/{client_customer_id}
appliedLabels[]

string

Chỉ có đầu ra. Tên tài nguyên của những nhãn thuộc sở hữu của khách hàng đưa ra yêu cầu được áp dụng cho khách hàng của khách hàng. Tên tài nguyên nhãn có dạng:

customers/{customerId}/labels/{label_id}
status

enum (CustomerStatus)

Chỉ có đầu ra. Trạng thái của khách hàng là khách hàng. Chỉ có thể đọc.
clientCustomer

string

Chỉ có đầu ra. Tên tài nguyên của khách hàng-khách hàng được liên kết với một khách hàng cụ thể. Chỉ có thể đọc.
hidden

boolean

Chỉ có đầu ra. Chỉ định xem đây có phải là tài khoản bị ẩn hay không. Chỉ có thể đọc.
level

string (int64 format)

Chỉ có đầu ra. Khoảng cách giữa khách hàng và khách hàng nhất định. Đối với bản thân liên kết, giá trị cấp sẽ là 0. Chỉ có thể đọc.
timeZone

string

Chỉ có đầu ra. Chuỗi Kho lưu trữ dữ liệu ngôn ngữ phổ biến (CLDR) biểu thị múi giờ của ứng dụng, ví dụ: America/Los_Angeles. Chỉ có thể đọc.
testAccount

boolean

Chỉ có đầu ra. Xác định xem khách hàng có phải là một tài khoản thử nghiệm hay không. Chỉ có thể đọc.
manager

boolean

Chỉ có đầu ra. Xác định xem khách hàng có phải là một người quản lý hay không. Chỉ có thể đọc.
descriptiveName

string

Chỉ có đầu ra. Tên mô tả của khách hàng. Chỉ có thể đọc.
currencyCode

string

Chỉ có đầu ra. Mã đơn vị tiền tệ (ví dụ: "USD", "EUR") của khách hàng. Chỉ có thể đọc.
id

string (int64 format)

Chỉ có đầu ra. Mã của khách hàng của khách hàng. Chỉ có thể đọc.

CustomerSearchTermInsight

Chế độ xem cụm từ tìm kiếm khách hàng. Chỉ có dữ liệu trong quá khứ bắt đầu từ tháng 3 năm 2023.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "categoryLabel": string,
  "id": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của thông tin chi tiết về cụm từ tìm kiếm ở cấp khách hàng. Tên tài nguyên về thông tin chi tiết về cụm từ tìm kiếm ở cấp khách hàng có dạng như sau:

customers/{customerId}/customerSearchTermInsights/{categoryId}
categoryLabel

string

Chỉ có đầu ra. Nhãn cho danh mục tìm kiếm. Một chuỗi trống biểu thị danh mục tổng hợp cho các cụm từ tìm kiếm không phù hợp với một danh mục khác.
id

string (int64 format)

Chỉ có đầu ra. Mã của thông tin chi tiết.

DetailPlacementView

Lượt xem có các chỉ số được tổng hợp theo nhóm quảng cáo và URL hoặc video trên YouTube.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "placementType": enum (PlacementType),
  "placement": string,
  "displayName": string,
  "groupPlacementTargetUrl": string,
  "targetUrl": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem vị trí chi tiết. Tên tài nguyên của chế độ xem vị trí chi tiết có dạng:

customers/{customerId}/detailPlacementViews/{adGroupId}~{base64_placement}
placementType

enum (PlacementType)

Chỉ có đầu ra. Loại vị trí, ví dụ: Trang web, Video trên YouTube và Ứng dụng dành cho thiết bị di động.
placement

string

Chỉ có đầu ra. Chuỗi vị trí tự động ở cấp chi tiết, e. g. URL của trang web, ID ứng dụng dành cho thiết bị di động hoặc ID video trên YouTube.
displayName

string

Chỉ có đầu ra. Tên hiển thị là tên URL của trang web, tên video trên YouTube cho video trên YouTube và bản dịch tên ứng dụng di động cho ứng dụng di động.
groupPlacementTargetUrl

string

Chỉ có đầu ra. URL của vị trí nhóm (ví dụ: miền), đường liên kết đến ứng dụng di động trong cửa hàng ứng dụng hoặc URL của kênh YouTube.
targetUrl

string

Chỉ có đầu ra. URL của vị trí, ví dụ: trang web, liên kết đến ứng dụng dành cho thiết bị di động trong cửa hàng ứng dụng hoặc URL video trên YouTube.

PlacementType

Các loại vị trí có thể có cho mối liên kết nguồn cấp dữ liệu.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
WEBSITE Trang web(ví dụ: "www.flowers4sale.com").
MOBILE_APP_CATEGORY Danh mục ứng dụng dành cho thiết bị di động(ví dụ: "Trò chơi").
MOBILE_APPLICATION ứng dụng trên điện thoại di động(ví dụ: '{3}::2-com.whatsthewordanswers').
YOUTUBE_VIDEO Video trên YouTube(ví dụ: "youtube.com/video/wtLJPvx7-ys").
YOUTUBE_CHANNEL Kênh YouTube(ví dụ: "youtube.com::L8ZULXASCc1I_oaOT0NaOQ").
GOOGLE_PRODUCTS Các nền tảng do Google sở hữu và điều hành(ví dụ: "tv.google.com").

DetailedDemographic

Thông tin chi tiết về nhân khẩu học: một ngành dọc dựa trên mối quan tâm cụ thể sẽ được nhắm đến để tiếp cận người dùng dựa trên dữ liệu về cuộc đời của họ.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "parent": string,
  "launchedToAll": boolean,
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ]
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của thông tin nhân khẩu học chi tiết. Tên của nguồn nhân khẩu học chi tiết có dạng:

customers/{customerId}/detailedDemographics/{detailed_demographic_id}
id

string (int64 format)

Chỉ có đầu ra. Mã của thông tin nhân khẩu học chi tiết.
name

string

Chỉ có đầu ra. Tên của thông tin nhân khẩu học chi tiết. Ví dụ: "Trình độ học vấn cao nhất"
parent

string

Chỉ có đầu ra. Cấp độ gốc của nhân khẩu học chi tiết.
launchedToAll

boolean

Chỉ có đầu ra. Đúng nếu thông tin nhân khẩu học chi tiết được triển khai cho tất cả các kênh và ngôn ngữ.
availabilities[]

object (CriterionCategoryAvailability)

Chỉ có đầu ra. Thông tin về tình trạng còn hàng của thông tin nhân khẩu học chi tiết.

CriterionCategoryAvailability

Thông tin về khả năng cung cấp danh mục, theo từng kênh quảng cáo.

Biểu diễn dưới dạng JSON 
{
  "channel": {
    object (CriterionCategoryChannelAvailability)
  },
  "locale": [
    {
      object (CriterionCategoryLocaleAvailability)
    }
  ]
}
Trường
channel

object (CriterionCategoryChannelAvailability)

Các loại kênh và loại phụ có sẵn cho danh mục này.
locale[]

object (CriterionCategoryLocaleAvailability)

Danh mục địa phương có sẵn cho kênh.

CriterionCategoryChannelAvailability

Thông tin về loại kênh quảng cáo và các loại phụ của một danh mục.

Biểu diễn dưới dạng JSON 
{
  "availabilityMode": enum (CriterionCategoryChannelAvailabilityMode),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": [
    enum (AdvertisingChannelSubType)
  ],
  "includeDefaultChannelSubType": boolean
}
Trường
availabilityMode

enum (CriterionCategoryChannelAvailabilityMode)

Định dạng của phạm vi cung cấp kênh. Có thể là ALL_CHANNELS (các trường còn lại sẽ không được đặt), CHANNEL_TYPE (chỉ loại AdvertisingChannelType sẽ được đặt, danh mục có sẵn cho tất cả các loại phụ trong đó) hoặc CHANNEL_TYPE_AND_SUBTYPES (advertisingChannelType, advertisingChannelSubType và includeDefaultChannelSubType sẽ đều được đặt).
advertisingChannelType

enum (AdvertisingChannelType)

Loại kênh có sẵn danh mục.
advertisingChannelSubType[]

enum (AdvertisingChannelSubType)

Loại kênh phụ thuộc loại kênh có sẵn danh mục đó.
includeDefaultChannelSubType

boolean

Liệu có loại kênh phụ mặc định của kênh hay không. Ví dụ: AdvertisingChannelType là DISPLAY và includeDefaultChannelSubType là false có nghĩa là chiến dịch hiển thị mặc định không đặt loại kênh phụ sẽ không được đưa vào cấu hình khả năng sử dụng này.

CriterionCategoryChannelAvailabilityMode

Enum chứa CriterionCategoryChannelAvailabilityMode có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
ALL_CHANNELS Danh mục này dành cho các chiến dịch thuộc tất cả các loại kênh và loại phụ.
CHANNEL_TYPE_AND_ALL_SUBTYPES Danh mục này dành cho các chiến dịch thuộc một loại kênh cụ thể, bao gồm tất cả các loại phụ của loại kênh đó.
CHANNEL_TYPE_AND_SUBSET_SUBTYPES Danh mục này dành cho các chiến dịch thuộc một loại kênh và(các) loại phụ cụ thể.

CriterionCategoryLocaleAvailability

Thông tin về ngôn ngữ của một danh mục.

Biểu diễn dưới dạng JSON 
{
  "availabilityMode": enum (CriterionCategoryLocaleAvailabilityMode),
  "countryCode": string,
  "languageCode": string
}
Trường
availabilityMode

enum (CriterionCategoryLocaleAvailabilityMode)

Định dạng của phạm vi cung cấp ngôn ngữ. Có thể là LAUNCHED_TO_ALL (cả quốc gia và ngôn ngữ đều sẽ bị trống), COUNTRY (chỉ quốc gia được đặt), LANGUAGE (chỉ ngôn ngữ mới được đặt), COUNTRY_AND_LANGUAGE (cả quốc gia và ngôn ngữ sẽ được đặt).
countryCode

string

Mã quốc gia theo ISO-3166-1 alpha-2 được liên kết với danh mục.
languageCode

string

Mã ISO 639-1 của ngôn ngữ được liên kết với danh mục.

CriterionCategoryLocaleAvailabilityMode

Enum chứa tiêu chí CriterionCategoryLocaleAvailabilityMode.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
ALL_LOCALES Danh mục này có sẵn cho các chiến dịch thuộc tất cả ngôn ngữ.
COUNTRY_AND_ALL_LANGUAGES Danh mục này có sẵn cho các chiến dịch trong danh sách quốc gia, bất kể ngôn ngữ.
LANGUAGE_AND_ALL_COUNTRIES Danh mục này có sẵn cho các chiến dịch trong danh sách ngôn ngữ, bất kể quốc gia.
COUNTRY_AND_LANGUAGE Danh mục này có sẵn cho các chiến dịch trong danh sách các cặp ngôn ngữ, quốc gia.

DisplayKeywordView

Chế độ xem từ khoá hiển thị.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của khung hiển thị từ khoá hiển thị. Tên tài nguyên của chế độ xem Từ khoá hiển thị có dạng như sau:

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

DistanceView

Chế độ xem khoảng cách với các chỉ số được tổng hợp theo khoảng cách của người dùng từ phần mở rộng về địa điểm của nhà quảng cáo. Mỗi Nhóm khoảng cách bao gồm tất cả các lượt hiển thị nằm trong khoảng cách của nó và một lượt hiển thị duy nhất sẽ đóng góp vào chỉ số cho tất cả các Nhóm khoảng cách có bao gồm khoảng cách của người dùng.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "distanceBucket": enum (DistanceBucket),
  "metricSystem": boolean
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của khung hiển thị khoảng cách. Tên tài nguyên của chế độ xem khoảng cách có dạng:

customers/{customerId}/distanceViews/1~{distanceBucket}
distanceBucket

enum (DistanceBucket)

Chỉ có đầu ra. Nhóm khoảng cách người dùng với phần mở rộng về địa điểm.
metricSystem

boolean

Chỉ có đầu ra. "True" nếu DistanceBucket đang sử dụng hệ thống chỉ số, nếu không sẽ là false.

DistanceBucket

Nhóm khoảng cách cho khoảng cách của người dùng đến phần mở rộng về địa điểm của nhà quảng cáo.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
WITHIN_700M Người dùng cách vị trí trong phạm vi 700m.
WITHIN_1KM Người dùng cách vị trí đó trong phạm vi 1KM.
WITHIN_5KM Người dùng cách vị trí đó trong phạm vi 5KM.
WITHIN_10KM Người dùng cách vị trí đó trong phạm vi 10KM.
WITHIN_15KM Người dùng cách vị trí đó trong phạm vi 15KM.
WITHIN_20KM Người dùng cách vị trí đó trong phạm vi 20KM.
WITHIN_25KM Người dùng cách vị trí đó trong phạm vi 25KM.
WITHIN_30KM Người dùng cách vị trí đó trong phạm vi 30KM.
WITHIN_35KM Người dùng cách vị trí đó trong phạm vi 35KM.
WITHIN_40KM Người dùng cách vị trí đó trong phạm vi 40KM.
WITHIN_45KM Người dùng cách vị trí đó trong phạm vi 45KM.
WITHIN_50KM Người dùng cách vị trí đó trong phạm vi 50KM.
WITHIN_55KM Người dùng cách vị trí đó trong phạm vi 55KM.
WITHIN_60KM Người dùng cách vị trí trong phạm vi 60KM.
WITHIN_65KM Người dùng cách vị trí đó trong phạm vi 65KM.
BEYOND_65KM Người dùng cách vị trí đó quá 65KM.
WITHIN_0_7MILES Người dùng cách vị trí đó 0,7 dặm.
WITHIN_1MILE Người dùng cách vị trí trong phạm vi 1 dặm.
WITHIN_5MILES Người dùng cách vị trí trong phạm vi 5 dặm.
WITHIN_10MILES Người dùng cách vị trí đó trong phạm vi 10 dặm.
WITHIN_15MILES Người dùng cách vị trí trong phạm vi 15 dặm.
WITHIN_20MILES Người dùng cách vị trí đó trong phạm vi 20 dặm.
WITHIN_25MILES Người dùng cách vị trí trong phạm vi 25 dặm.
WITHIN_30MILES Người dùng ở trong vòng 30 dặm từ vị trí đó.
WITHIN_35MILES Người dùng cách vị trí đó trong phạm vi 35 dặm.
WITHIN_40MILES Người dùng cách vị trí trong phạm vi 40 dặm.
BEYOND_40MILES Người dùng ở quá 40 dặm so với vị trí.

DynamicSearchAdsSearchTermView

Chế độ xem cụm từ tìm kiếm cho quảng cáo tìm kiếm động.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "searchTerm": string,
  "headline": string,
  "landingPage": string,
  "pageUrl": string,
  "hasNegativeKeyword": boolean,
  "hasMatchingKeyword": boolean,
  "hasNegativeUrl": boolean
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem cụm từ tìm kiếm trong quảng cáo tìm kiếm động. Tên tài nguyên của chế độ xem cụm từ tìm kiếm của quảng cáo tìm kiếm động có dạng như sau:

customers/{customerId}/dynamicSearchAdsSearchTermViews/{adGroupId}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}
searchTerm

string

Chỉ có đầu ra. Cụm từ tìm kiếm

Trường này ở chế độ chỉ đọc.
headline

string

Chỉ có đầu ra. Dòng tiêu đề được tạo động của Quảng cáo tìm kiếm động.

Trường này ở chế độ chỉ đọc.
landingPage

string

Chỉ có đầu ra. URL trang đích được chọn linh động của lượt hiển thị.

Trường này ở chế độ chỉ đọc.
pageUrl

string

Chỉ có đầu ra. URL của mục nguồn cấp dữ liệu trang được phân phát cho lượt hiển thị.

Trường này ở chế độ chỉ đọc.
hasNegativeKeyword

boolean

Chỉ có đầu ra. Đúng nếu truy vấn khớp với từ khoá phủ định.

Trường này ở chế độ chỉ đọc.
hasMatchingKeyword

boolean

Chỉ có đầu ra. Đúng nếu cụm từ tìm kiếm được thêm vào từ khoá được nhắm mục tiêu.

Trường này ở chế độ chỉ đọc.
hasNegativeUrl

boolean

Chỉ có đầu ra. Đúng nếu truy vấn khớp với một URL phủ định.

Trường này ở chế độ chỉ đọc.

ExpandedLandingPageView

Lượt xem trang đích có các chỉ số được tổng hợp ở cấp URL cuối cùng mở rộng.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "expandedFinalUrl": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem trang đích mở rộng. Tên tài nguyên của chế độ xem trang đích mở rộng có dạng:

customers/{customerId}/expandedLandingPageViews/{expanded_final_url_fingerprint}
expandedFinalUrl

string

Chỉ có đầu ra. URL cuối cùng mà các lượt nhấp được chuyển đến.

FeedPlaceholderView

Chế độ xem phần giữ chỗ nguồn cấp dữ liệu.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "placeholderType": enum (PlaceholderType)
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của khung hiển thị phần giữ chỗ nguồn cấp dữ liệu. Tên tài nguyên chế độ xem phần giữ chỗ của nguồn cấp dữ liệu có dạng như sau:

customers/{customerId}/feedPlaceholderViews/{placeholderType}
placeholderType

enum (PlaceholderType)

Chỉ có đầu ra. Loại phần giữ chỗ của chế độ xem phần giữ chỗ nguồn cấp dữ liệu.

GenderView

Chế độ xem theo giới tính. Tài nguyêngenderView phản ánh trạng thái phân phát hiệu quả, thay vì tiêu chí nào được thêm vào. Theo mặc định, nhóm quảng cáo không có tiêu chí giới tính hiển thị cho tất cả giới tính, do đó, tất cả giới tính đều xuất hiện tronggenderView cùng với số liệu thống kê.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem theo giới tính. Tên tài nguyên chế độ xem giới tính có dạng như sau:

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

GeographicView

Chế độ xem địa lý.

Chế độ xem địa lý bao gồm tất cả các chỉ số được tổng hợp ở cấp quốc gia, một hàng cho mỗi quốc gia. Chế độ này báo cáo các chỉ số tại vị trí thực tế của người dùng hoặc khu vực mà họ quan tâm. Nếu sử dụng các trường phân khúc khác, bạn có thể nhận được nhiều hàng cho mỗi quốc gia.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "locationType": enum (GeoTargetingType),
  "countryCriterionId": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem địa lý. Tên tài nguyên chế độ xem địa lý có dạng:

customers/{customerId}/geographicViews/{countryCriterionId}~{locationType}
locationType

enum (GeoTargetingType)

Chỉ có đầu ra. Loại tiêu chí nhắm mục tiêu theo địa lý của chiến dịch.
countryCriterionId

string (int64 format)

Chỉ có đầu ra. Mã tiêu chí cho quốc gia.

GeoTargetingType

Các loại nhắm mục tiêu theo địa lý có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Phiên bản này không xác định được giá trị.
AREA_OF_INTEREST Vị trí mà người dùng quan tâm trong khi tìm kiếm.
LOCATION_OF_PRESENCE Vị trí của người dùng đưa ra truy vấn.

GroupPlacementView

Chế độ xem vị trí theo nhóm.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "placementType": enum (PlacementType),
  "placement": string,
  "displayName": string,
  "targetUrl": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem vị trí nhóm. Tên tài nguyên của chế độ xem vị trí nhóm có dạng:

customers/{customerId}/groupPlacementViews/{adGroupId}~{base64_placement}
placementType

enum (PlacementType)

Chỉ có đầu ra. Loại vị trí, ví dụ: Trang web, Kênh YouTube, Ứng dụng dành cho thiết bị di động.
placement

string

Chỉ có đầu ra. Chuỗi vị trí tự động ở cấp nhóm, e. g. miền web, mã ứng dụng di động hoặc mã nhận dạng kênh YouTube.
displayName

string

Chỉ có đầu ra. Tên miền đối với trang web và tên kênh YouTube đối với kênh YouTube.
targetUrl

string

Chỉ có đầu ra. URL của vị trí nhóm (ví dụ: miền), đường liên kết đến ứng dụng di động trong cửa hàng ứng dụng hoặc URL của kênh YouTube.

HotelGroupView

Chế độ xem nhóm khách sạn.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem nhóm khách sạn. Tên tài nguyên chế độ xem Nhóm khách sạn có dạng như sau:

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

HotelPerformanceView

Chế độ xem hiệu suất khách sạn.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem hiệu suất khách sạn. Tên tài nguyên chế độ xem hiệu suất của khách sạn có dạng như sau:

customers/{customerId}/hotelPerformanceView

HotelReconciliation

Điều chỉnh cho khách sạn. Báo cáo này chứa thông tin về lượt chuyển đổi của các lượt đặt phòng khách sạn để đối chiếu với hồ sơ của nhà quảng cáo. Bạn có thể cập nhật hoặc huỷ các hàng này trước khi thanh toán thông qua tính năng Tải lên hàng loạt.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "commissionId": string,
  "orderId": string,
  "campaign": string,
  "hotelCenterId": string,
  "hotelId": string,
  "checkInDate": string,
  "checkOutDate": string,
  "reconciledValueMicros": string,
  "billed": boolean,
  "status": enum (HotelReconciliationStatus)
}
Trường
resourceName

string

Không thể thay đổi. Tên tài nguyên của bản điều chỉnh cho khách sạn. Tên tài nguyên điều chỉnh cho khách sạn có dạng như sau:

customers/{customerId}/hotelReconciliations/{commissionId}
commissionId

string

Bắt buộc. Chỉ có đầu ra. Mã hoa hồng là mã của Google cho lượt đặt phòng này. Mỗi sự kiện đặt phòng đều được gán một Mã hoa hồng để giúp bạn so khớp sự kiện đó với một khách lưu trú.
orderId

string

Chỉ có đầu ra. Mã đơn hàng là giá trị nhận dạng lượt đặt trước này như được cung cấp trong "transaction_id" của thẻ theo dõi lượt chuyển đổi.
campaign

string

Chỉ có đầu ra. Tên tài nguyên cho Chiến dịch được liên kết với lượt chuyển đổi.
hotelCenterId

string (int64 format)

Chỉ có đầu ra. Giá trị nhận dạng của tài khoản Hotel Center cung cấp giá cho Chiến dịch khách sạn.
hotelId

string

Chỉ có đầu ra. Giá trị nhận dạng duy nhất của cơ sở lưu trú được đặt phòng, như được cung cấp trong nguồn cấp dữ liệu của Hotel Center. Mã khách sạn lấy từ "Mã" của thẻ theo dõi lượt chuyển đổi.
checkInDate

string

Chỉ có đầu ra. Ngày nhận phòng được ghi lại khi khách đặt phòng. Nếu ngày nhận phòng được sửa đổi theo thông tin đối chiếu, thì ngày sửa đổi sẽ thay thế ngày ban đầu trong cột này. Định dạng là YYYY-MM-DD.
checkOutDate

string

Chỉ có đầu ra. Ngày trả phòng được ghi lại khi khách đặt phòng. Nếu ngày nhận phòng được sửa đổi theo thông tin đối chiếu, thì ngày sửa đổi sẽ thay thế ngày ban đầu trong cột này. Định dạng là YYYY-MM-DD.
reconciledValueMicros

string (int64 format)

Bắt buộc. Chỉ có đầu ra. Giá trị đã đối chiếu là giá trị cuối cùng của một lượt đặt phòng mà khách đã thanh toán. Nếu giá trị đặt phòng ban đầu thay đổi vì bất kỳ lý do gì, chẳng hạn như thay đổi hành trình hoặc bán thêm phòng, thì giá trị đã đối chiếu phải là toàn bộ số tiền cuối cùng được thu thập. Nếu một lượt đặt phòng bị hủy, giá trị đã đối chiếu phải bao gồm mọi khoản phí hủy hoặc tiền phòng không thể hoàn lại. Giá trị được tính bằng phần triệu của đơn vị tiền tệ cơ sở. Ví dụ: $12, 35 sẽ được trình bày là 12350000. Đơn vị tiền tệ được tính bằng đơn vị tiền tệ mặc định của khách hàng.
billed

boolean

Chỉ có đầu ra. Liệu một lượt đặt phòng nhất định có được tính phí hay không. Bạn không thể sửa đổi lượt đặt phòng sau khi đã lập hóa đơn.
status

enum (HotelReconciliationStatus)

Bắt buộc. Chỉ có đầu ra. Trạng thái hiện tại của một lượt đặt phòng liên quan đến việc đối chiếu và thanh toán. Bạn phải đối chiếu các lượt đặt phòng trong vòng 45 ngày sau ngày trả phòng. Mọi lượt đặt phòng không được đối chiếu trong vòng 45 ngày sẽ được lập hóa đơn theo giá trị ban đầu.

HotelReconciliationStatus

Trạng thái điều chỉnh yêu cầu đặt phòng khách sạn.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Giá trị này không xác định trong phiên bản này.
RESERVATION_ENABLED Đơn đặt phòng áp dụng cho ngày trong tương lai hoặc một lượt lưu trú đang diễn ra nhưng chưa qua ngày trả phòng. Bạn không thể đối chiếu một đơn đặt phòng vẫn còn hiệu lực.
RECONCILIATION_NEEDED Đã trả phòng hoặc đã qua ngày đặt phòng mà không có sự kiện hủy. Những đơn đặt phòng không được đối chiếu trong vòng 45 ngày kể từ ngày trả phòng sẽ được lập hóa đơn dựa trên giá đặt phòng ban đầu.
RECONCILED Những đơn đặt phòng này đã được đối chiếu. Những lượt đặt phòng đã đối chiếu sẽ được lập hoá đơn sau 45 ngày kể từ ngày trả phòng.
CANCELED Đơn đặt phòng này được đánh dấu là đã hủy. Những lượt lưu trú bị hủy có giá trị lớn hơn 0 (do các quy tắc về lượt lưu trú tối thiểu hoặc các khoản phí hủy) sẽ được lập hóa đơn sau 45 ngày kể từ ngày trả phòng.

IncomeRangeView

Chế độ xem phạm vi thu nhập.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem phạm vi thu nhập. Tên tài nguyên của chế độ xem phạm vi thu nhập có dạng như sau:

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

KeywordView

Chế độ xem từ khoá.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của khung hiển thị từ khoá. Tên tài nguyên của chế độ xem từ khoá có dạng như sau:

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

LandingPageView

Chế độ xem trang đích có các chỉ số được tổng hợp ở cấp URL cuối cùng không mở rộng.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "unexpandedFinalUrl": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem trang đích. Tên tài nguyên lượt xem trang đích có dạng như sau:

customers/{customerId}/landingPageViews/{unexpanded_final_url_fingerprint}
unexpandedFinalUrl

string

Chỉ có đầu ra. URL cuối cùng do nhà quảng cáo chỉ định.

LanguageConstant

Một ngôn ngữ.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của hằng số ngôn ngữ. Tên tài nguyên hằng số ngôn ngữ có dạng:

languageConstants/{criterionId}
id

string (int64 format)

Chỉ có đầu ra. Mã nhận dạng của hằng số ngôn ngữ.
code

string

Chỉ có đầu ra. Mã ngôn ngữ, ví dụ: "en_US", "en_AU", "es", "fr", v.v.
name

string

Chỉ có đầu ra. Tên đầy đủ của ngôn ngữ bằng tiếng Anh, ví dụ: "tiếng Anh (Mỹ)", "tiếng Tây Ban Nha", v.v.
targetable

boolean

Chỉ có đầu ra. Liệu ngôn ngữ có thể nhắm mục tiêu hay không.

LocationView

Chế độ xem vị trí tóm tắt hiệu suất của chiến dịch theo tiêu chí Vị trí. Nếu bạn không đặt tiêu chí Vị trí, thì sẽ không có kết quả nào được trả về; thay vào đó, hãy sử dụng geoView hoặc userLocationView cho dữ liệu vị trí của khách truy cập.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem vị trí. Tên tài nguyên chế độ xem vị trí có dạng:

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

ManagedPlacementView

Chế độ xem vị trí được quản lý.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem Vị trí được quản lý. Tên tài nguyên chế độ xem vị trí được quản lý có dạng:

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

MediaFile

Một tệp nội dung nghe nhìn.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "type": enum (MediaType),
  "mimeType": enum (MimeType),
  "id": string,
  "sourceUrl": string,
  "name": string,
  "fileSize": string,

  // Union field mediatype can be only one of the following:
  "image": {
    object (MediaImage)
  },
  "mediaBundle": {
    object (MediaBundle)
  },
  "audio": {
    object (MediaAudio)
  },
  "video": {
    object (MediaVideo)
  }
  // End of list of possible types for union field mediatype.
}
Trường
resourceName

string

Không thể thay đổi. Tên tài nguyên của tệp đa phương tiện. Tên tài nguyên tệp nội dung nghe nhìn có dạng như sau:

customers/{customerId}/mediaFiles/{media_file_id}
type

enum (MediaType)

Không thể thay đổi. Loại tệp nội dung nghe nhìn.
mimeType

enum (MimeType)

Chỉ có đầu ra. Loại mime của tệp nội dung nghe nhìn.
id

string (int64 format)

Chỉ có đầu ra. Mã nhận dạng của tệp nội dung nghe nhìn.
sourceUrl

string

Không thể thay đổi. URL của nơi tệp nội dung nghe nhìn gốc được tải xuống (hoặc tên tệp). Chỉ dùng cho nội dung nghe nhìn thuộc loại AUDIO và IMAGE.
name

string

Không thể thay đổi. Tên của tệp nội dung nghe nhìn. Khách hàng có thể dùng tên này để xác định nội dung nghe nhìn đã tải lên trước đây.
fileSize

string (int64 format)

Chỉ có đầu ra. Kích thước của tệp nội dung nghe nhìn tính bằng byte.
Trường kết hợp mediatype. Loại cụ thể của tệp đa phương tiện. mediatype chỉ có thể là một trong những trạng thái sau đây:
image

object (MediaImage)

Không thể thay đổi. Đóng gói một hình ảnh.
mediaBundle

object (MediaBundle)

Không thể thay đổi. Một tệp ZIP lưu trữ nội dung nghe nhìn chứa thành phần HTML5.
audio

object (MediaAudio)

Chỉ có đầu ra. Đóng gói tệp âm thanh.
video

object (MediaVideo)

Không thể thay đổi. Đóng gói video.

MediaType

Loại nội dung nghe nhìn.

Enum
UNSPECIFIED Loại phương tiện chưa được chỉ định.
UNKNOWN

Không xác định được giá trị đã nhận trong phiên bản này.

Đây là giá trị chỉ phản hồi.
IMAGE Hình ảnh tĩnh, được sử dụng cho quảng cáo hình ảnh.
ICON Hình ảnh nhỏ, được sử dụng cho quảng cáo bản đồ.
MEDIA_BUNDLE ZIP, được sử dụng trong các trường của quảng cáo mẫu.
AUDIO Tệp âm thanh.
VIDEO Tệp video.
DYNAMIC_IMAGE Hình ảnh động, chẳng hạn như GIF động.

MediaImage

Đóng gói một hình ảnh.

Biểu diễn dưới dạng JSON 
{
  "data": string,
  "fullSizeImageUrl": string,
  "previewSizeImageUrl": string
}
Trường
data

string (bytes format)

Không thể thay đổi. Dữ liệu hình ảnh thô.

Chuỗi được mã hoá base64.
fullSizeImageUrl

string

Chỉ có đầu ra. URL đến phiên bản có kích thước đầy đủ của hình ảnh.
previewSizeImageUrl

string

Chỉ có đầu ra. URL cho phiên bản kích thước xem trước của hình ảnh.

MediaBundle

Đại diện cho một tệp lưu trữ ZIP chứa nội dung chứa thành phần HTML5.

Biểu diễn dưới dạng JSON 
{
  "data": string,
  "url": string
}
Trường
data

string (bytes format)

Không thể thay đổi. Dữ liệu thô nén.

Chuỗi được mã hoá base64.
url

string

Chỉ có đầu ra. URL để truy cập vào dữ liệu nén đã tải lên. Ví dụ: https://tpc.googlesyndication.com/simgad/123 Đây là trường chỉ đọc.

MediaAudio

Đóng gói một Âm thanh.

Biểu diễn dưới dạng JSON 
{
  "adDurationMillis": string
}
Trường
adDurationMillis

string (int64 format)

Chỉ có đầu ra. Thời lượng của Âm thanh tính bằng mili giây.

MediaVideo

Đóng gói video.

Biểu diễn dưới dạng JSON 
{
  "adDurationMillis": string,
  "youtubeVideoId": string,
  "advertisingIdCode": string,
  "isciCode": string
}
Trường
adDurationMillis

string (int64 format)

Chỉ có đầu ra. Thời lượng của Video tính bằng mili giây.
youtubeVideoId

string

Không thể thay đổi. ID của video trên YouTube (như trong các URL trên YouTube). Thêm tiền tố "https://www.youtube.com/watch?v=" và mã này sẽ nhận được URL phát trực tuyến trên YouTube cho video này.
advertisingIdCode

string

Chỉ có đầu ra. Mã nhận dạng kỹ thuật số của quảng cáo dành cho video này, theo định nghĩa của Hiệp hội các đại lý quảng cáo Hoa Kỳ, được sử dụng chủ yếu cho các chương trình quảng cáo trên truyền hình.
isciCode

string

Chỉ có đầu ra. Mã nhận dạng thương mại tiêu chuẩn ngành cho video này, được sử dụng chủ yếu cho quảng cáo truyền hình.

LocalServicesEmployee

Nguồn nhân viên cung cấp dịch vụ địa phương.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "creationDateTime": string,
  "status": enum (LocalServicesEmployeeStatus),
  "type": enum (LocalServicesEmployeeType),
  "universityDegrees": [
    {
      object (UniversityDegree)
    }
  ],
  "residencies": [
    {
      object (Residency)
    }
  ],
  "fellowships": [
    {
      object (Fellowship)
    }
  ],
  "languagesSpoken": [
    string
  ],
  "categoryIds": [
    string
  ],
  "id": string,
  "jobTitle": string,
  "yearStartedPracticing": integer,
  "nationalProviderIdNumber": string,
  "emailAddress": string,
  "firstName": string,
  "middleName": string,
  "lastName": string
}
Trường
resourceName

string

Không thể thay đổi. Tên tài nguyên của Quy trình xác minh Dịch vụ địa phương. Tên tài nguyên Xác minh dịch vụ địa phương có dạng:

customers/{customerId}/localServicesEmployees/{gls_employee_id}
creationDateTime

string

Chỉ có đầu ra. Dấu thời gian tạo nhân viên. Định dạng là "YYYY-MM-DD HH:MM:SS" theo múi giờ của tài khoản Google Ads. Ví dụ: "2018-03-05 09:15:00" hoặc "2018-02-01 14:34:30"
status

enum (LocalServicesEmployeeStatus)

Chỉ có đầu ra. Trạng thái nhân viên, chẳng hạn như BỊ XÓA hoặc ĐÃ BẬT.
type

enum (LocalServicesEmployeeType)

Chỉ có đầu ra. Loại nhân viên.
universityDegrees[]

object (UniversityDegree)

Chỉ có đầu ra. Danh sách các bằng cấp mà nhân viên này đã đạt được và muốn nêu bật.
residencies[]

object (Residency)

Chỉ có đầu ra. Các tổ chức mà nhân viên đã hoàn thành thời gian cư trú.
fellowships[]

object (Fellowship)

Chỉ có đầu ra. Các tổ chức mà nhân viên đã hoàn thành chương trình học bổng.
languagesSpoken[]

string

Chỉ có đầu ra. Ngôn ngữ mà nhân viên nói, được thể hiện dưới dạng thẻ ngôn ngữ từ https://developers.google.com/admin-sdk/directory/v1/languages
categoryIds[]

string

Chỉ có đầu ra. Loại nhân viên. Bạn có thể tìm thấy danh sách mã danh mục Dịch vụ địa phương tại https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids.
id

string (int64 format)

Chỉ có đầu ra. Mã nhận dạng của nhân viên.
jobTitle

string

Chỉ có đầu ra. Chức danh cho nhân viên này, chẳng hạn như "Đối tác cấp cao" trong các ngành dọc pháp lý.
yearStartedPracticing

integer

Chỉ có đầu ra. Năm mà nhân viên này bắt đầu hành nghề trong lĩnh vực này.
nationalProviderIdNumber

string

Chỉ có đầu ra. Mã NPI của nhân viên.
emailAddress

string

Chỉ có đầu ra. Địa chỉ email của nhân viên.
firstName

string

Chỉ có đầu ra. Tên của nhân viên.
middleName

string

Chỉ có đầu ra. Tên đệm của nhân viên.
lastName

string

Chỉ có đầu ra. Họ của nhân viên.

LocalServicesEmployeeStatus

Enum mô tả trạng thái của một nhân viên cung cấp dịch vụ địa phương.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
ENABLED Nhân viên không bị xoá và tư cách nhân viên đang hoạt động.
REMOVED Đã xoá nhân viên này. Dùng để xoá một nhân viên khỏi doanh nghiệp.

LocalServicesEmployeeType

Enum mô tả các loại nhân viên cung cấp dịch vụ địa phương.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
BUSINESS_OWNER Đại diện cho chủ sở hữu của doanh nghiệp.
EMPLOYEE Đại diện cho một nhân viên của doanh nghiệp.

UniversityDegree

Danh sách các bằng cấp mà nhân viên này đã đạt được và muốn nêu bật.

Biểu diễn dưới dạng JSON 
{
  "institutionName": string,
  "degree": string,
  "graduationYear": integer
}
Trường
institutionName

string

Chỉ có đầu ra. Tên của trường đại học cấp bằng.
degree

string

Chỉ có đầu ra. Tên của bằng cấp.
graduationYear

integer

Chỉ có đầu ra. Năm tốt nghiệp.

Địa chỉ cư trú

Thông tin chi tiết về nội dung cư trú của nhân viên y tế. Nội trú là một giai đoạn của chương trình đào tạo y sau đại học, trong đó thực hành chuyên môn y tế đủ tiêu chuẩn dưới sự giám sát của một bác sĩ lâm sàng cấp cao.

Biểu diễn dưới dạng JSON 
{
  "institutionName": string,
  "completionYear": integer
}
Trường
institutionName

string

Chỉ có đầu ra. Tên của tổ chức nơi người hoàn thành nội dung cư trú.
completionYear

integer

Chỉ có đầu ra. Năm hoàn thành.

Học bổng

Thông tin chi tiết về học bổng y tế của nhân viên. Học bổng là khoảng thời gian đào tạo y khoa mà chuyên gia thực hiện sau khi kết thúc nội trú.

Biểu diễn dưới dạng JSON 
{
  "institutionName": string,
  "completionYear": integer
}
Trường
institutionName

string

Chỉ có đầu ra. Tên của chương trình học bổng mà học bổng được hoàn thành.
completionYear

integer

Chỉ có đầu ra. Năm hoàn thành.

LocalServicesVerificationArtifact

Tài nguyên xác minh dịch vụ địa phương.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "creationDateTime": string,
  "status": enum (LocalServicesVerificationArtifactStatus),
  "artifactType": enum (LocalServicesVerificationArtifactType),
  "id": string,

  // Union field artifact_data can be only one of the following:
  "backgroundCheckVerificationArtifact": {
    object (BackgroundCheckVerificationArtifact)
  },
  "insuranceVerificationArtifact": {
    object (InsuranceVerificationArtifact)
  },
  "licenseVerificationArtifact": {
    object (LicenseVerificationArtifact)
  },
  "businessRegistrationCheckVerificationArtifact": {
    object (BusinessRegistrationCheckVerificationArtifact)
  }
  // End of list of possible types for union field artifact_data.
}
Trường
resourceName

string

Không thể thay đổi. Tên tài nguyên của Quy trình xác minh Dịch vụ địa phương. Tên tài nguyên Xác minh dịch vụ địa phương có dạng:

customers/{customerId}/localServicesVerificationArtifacts/{verification_artifact_id}
creationDateTime

string

Chỉ có đầu ra. Dấu thời gian khi cấu phần phần mềm xác minh này được tạo. Định dạng là "YYYY-MM-DD HH:MM:SS" theo múi giờ của tài khoản Google Ads. Ví dụ: "2018-03-05 09:15:00" hoặc "2018-02-01 14:34:30"
status

enum (LocalServicesVerificationArtifactStatus)

Chỉ có đầu ra. Trạng thái của cấu phần phần mềm xác minh.
artifactType

enum (LocalServicesVerificationArtifactType)

Chỉ có đầu ra. Loại cấu phần phần mềm xác minh.
id

string (int64 format)

Chỉ có đầu ra. Mã của cấu phần phần mềm xác minh.
Trường kết hợp artifact_data. Các loại thông tin xác minh. artifact_data chỉ có thể là một trong những trạng thái sau đây:
backgroundCheckVerificationArtifact

object (BackgroundCheckVerificationArtifact)

Chỉ có đầu ra. Cấu phần phần mềm xác minh kiểm tra lai lịch.
insuranceVerificationArtifact

object (InsuranceVerificationArtifact)

Chỉ có đầu ra. Cấu phần phần mềm xác minh bảo hiểm.
licenseVerificationArtifact

object (LicenseVerificationArtifact)

Chỉ có đầu ra. Cấu phần phần mềm xác minh giấy phép.
businessRegistrationCheckVerificationArtifact

object (BusinessRegistrationCheckVerificationArtifact)

Chỉ có đầu ra. Cấu phần phần mềm xác minh kiểm tra giấy đăng ký kinh doanh.

LocalServicesVerificationArtifactStatus

Enum mô tả trạng thái của cấu phần phần mềm xác minh dịch vụ địa phương.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
PASSED Cấu phần phần mềm đã vượt qua quá trình xác minh.
FAILED Cấu phần phần mềm không xác minh được.
PENDING Cấu phần phần mềm đang trong quá trình xác minh.
NO_SUBMISSION Cấu phần phần mềm cần người dùng tải thông tin lên trước khi được xác minh.
CANCELLED Cấu phần phần mềm đã bị người dùng hủy.

LocalServicesVerificationArtifactType

Enum mô tả các loại cấu phần phần mềm xác minh dịch vụ địa phương có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
BACKGROUND_CHECK Cấu phần phần mềm xác minh kiểm tra lai lịch.
INSURANCE Cấu phần mềm xác minh bảo hiểm.
LICENSE Cấu phần phần mềm xác minh giấy phép.
BUSINESS_REGISTRATION_CHECK Cấu phần phần mềm xác minh kiểm tra giấy đăng ký kinh doanh.

BackgroundCheckVerificationArtifact

Một proto chứa thông tin dành riêng cho việc kiểm tra lai lịch của dịch vụ địa phương.

Biểu diễn dưới dạng JSON 
{
  "caseUrl": string,
  "finalAdjudicationDateTime": string
}
Trường
caseUrl

string

Chỉ có đầu ra. URL để truy cập chữ hoa chữ thường.
finalAdjudicationDateTime

string

Chỉ có đầu ra. Dấu thời gian khi kết quả kiểm tra lai lịch này được phân xử. Định dạng là "YYYY-MM-DD HH:MM:SS" theo múi giờ của tài khoản Google Ads. Ví dụ: "2018-03-05 09:15:00" hoặc "2018-02-01 14:34:30"

InsuranceVerificationArtifact

Một giao thức chứa thông tin dành riêng cho một dịch vụ bảo hiểm dịch vụ địa phương.

Biểu diễn dưới dạng JSON 
{
  "amountMicros": string,
  "rejectionReason": enum (LocalServicesInsuranceRejectionReason),
  "insuranceDocumentReadonly": {
    object (LocalServicesDocumentReadOnly)
  }
}
Trường
amountMicros

string (int64 format)

Chỉ có đầu ra. Số tiền bảo hiểm. Chỉ số này được đo bằng đơn vị "phần triệu" đơn vị tiền tệ được đề cập trong chứng từ bảo hiểm.
rejectionReason

enum (LocalServicesInsuranceRejectionReason)

Chỉ có đầu ra. Lý do từ chối của giấy tờ bảo hiểm.
insuranceDocumentReadonly

object (LocalServicesDocumentReadOnly)

Chỉ có đầu ra. Trường chỉ đọc có chứa thông tin của giấy tờ bảo hiểm đã tải lên.

LocalServicesInsuranceRejectionReason

Enum mô tả những lý do có thể khiến mã xác minh bảo hiểm dịch vụ địa phương bị từ chối.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
BUSINESS_NAME_MISMATCH Tên doanh nghiệp không khớp với tên doanh nghiệp của Quảng cáo dịch vụ địa phương.
INSURANCE_AMOUNT_INSUFFICIENT Số tiền bảo hiểm không đáp ứng yêu cầu được nêu trong tài liệu tóm tắt pháp lý cho tổ hợp mã địa lý + mã danh mục đó.
EXPIRED Chứng từ bảo hiểm đã hết hạn.
NO_SIGNATURE Chứng từ bảo hiểm thiếu chữ ký.
NO_POLICY_NUMBER Chứng từ bảo hiểm thiếu số hợp đồng.
NO_COMMERCIAL_GENERAL_LIABILITY Hộp Trách nhiệm pháp lý thương mại(CGL) không được đánh dấu trong chứng từ bảo hiểm.
EDITABLE_FORMAT Tài liệu bảo hiểm có định dạng có thể chỉnh sửa.
CATEGORY_MISMATCH Chứng từ bảo hiểm không bao gồm bảo hiểm cho một danh mục cụ thể.
MISSING_EXPIRATION_DATE Giấy tờ bảo hiểm thiếu ngày hết hạn.
POOR_QUALITY Giấy tờ bảo hiểm có chất lượng kém – hình ảnh bị mờ, không đọc được, v.v.
POTENTIALLY_EDITED Giấy tờ bảo hiểm bị nghi ngờ đã bị chỉnh sửa.
WRONG_DOCUMENT_TYPE Giấy tờ bảo hiểm không được chấp nhận. Ví dụ: tài liệu đề xuất bảo hiểm nhưng thiếu phạm vi bảo hiểm sẽ không được chấp nhận.
NON_FINAL Chứng từ bảo hiểm chưa phải là cuối cùng.
OTHER Giấy tờ bảo hiểm có một lỗi khác không được nêu rõ.

LocalServicesDocumentReadOnly

Tài liệu về Dịch vụ địa phương có dữ liệu chỉ có thể đọc.

Biểu diễn dưới dạng JSON 
{
  "documentUrl": string
}
Trường
documentUrl

string

URL để truy cập vào một tài liệu đã tải lên trên Dịch vụ địa phương.

LicenseVerificationArtifact

Một proto chứa thông tin dành riêng cho một giấy phép dịch vụ địa phương.

Biểu diễn dưới dạng JSON 
{
  "licenseType": string,
  "licenseNumber": string,
  "licenseeFirstName": string,
  "licenseeLastName": string,
  "rejectionReason": enum (LocalServicesLicenseRejectionReason),
  "licenseDocumentReadonly": {
    object (LocalServicesDocumentReadOnly)
  }
}
Trường
licenseType

string

Chỉ có đầu ra. Tên / loại giấy phép.
licenseNumber

string

Chỉ có đầu ra. Số giấy phép.
licenseeFirstName

string

Chỉ có đầu ra. Tên của bên được cấp phép.
licenseeLastName

string

Chỉ có đầu ra. Họ của bên được cấp phép.
rejectionReason

enum (LocalServicesLicenseRejectionReason)

Chỉ có đầu ra. Lý do từ chối giấy phép.
licenseDocumentReadonly

object (LocalServicesDocumentReadOnly)

Chỉ có đầu ra. Trường chỉ đọc có chứa thông tin về tài liệu giấy phép đã tải lên.

LocalServicesLicenseRejectionReason

Enum mô tả những lý do có thể khiến một cấu phần phần mềm xác minh giấy phép dịch vụ địa phương bị từ chối.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
BUSINESS_NAME_MISMATCH Tên doanh nghiệp không khớp với tên doanh nghiệp của Quảng cáo dịch vụ địa phương.
UNAUTHORIZED Giấy phép không được phép hoặc đã bị thu hồi.
EXPIRED Giấy phép đã hết hạn.
POOR_QUALITY Giấy phép có chất lượng kém – hình ảnh bị mờ, không đọc được, v.v.
UNVERIFIABLE Không xác minh được giấy phép do hình ảnh không hợp lệ.
WRONG_DOCUMENT_OR_ID Giấy phép không phải là loại tài liệu được yêu cầu hoặc có chứa mã nhận dạng không hợp lệ.
OTHER Giấy phép có một lỗi khác chưa được nêu rõ.

BusinessRegistrationCheckVerificationArtifact

Một proto lưu giữ thông tin dành riêng cho việc kiểm tra giấy đăng ký kinh doanh dịch vụ địa phương.

Biểu diễn dưới dạng JSON 
{
  "registrationType": enum (LocalServicesBusinessRegistrationType),
  "checkId": string,
  "rejectionReason": enum (LocalServicesBusinessRegistrationCheckRejectionReason),

  // Union field business_registration can be only one of the following:
  "registrationNumber": {
    object (BusinessRegistrationNumber)
  },
  "registrationDocument": {
    object (BusinessRegistrationDocument)
  }
  // End of list of possible types for union field business_registration.
}
Trường
registrationType

enum (LocalServicesBusinessRegistrationType)

Chỉ có đầu ra. Loại giấy kiểm tra giấy đăng ký kinh doanh (số hiệu, giấy tờ).
checkId

string

Chỉ có đầu ra. Mã của séc, chẳng hạn như vat_tax_id, biểu thị "Mã số thuế GTGT" .
rejectionReason

enum (LocalServicesBusinessRegistrationCheckRejectionReason)

Chỉ có đầu ra. Lý do từ chối giấy tờ đăng ký.
Trường kết hợp business_registration. Thông tin đăng ký giấy chứng nhận đăng ký kinh doanh. Đó sẽ là một trong các hình thức sau đây dựa trên yêu cầu của nhiều quốc gia. business_registration chỉ có thể là một trong những trạng thái sau đây:
registrationNumber

object (BusinessRegistrationNumber)

Chỉ có đầu ra. Tin nhắn lưu trữ số điện thoại do chính phủ cấp cho doanh nghiệp.
registrationDocument

object (BusinessRegistrationDocument)

Chỉ có đầu ra. Tin nhắn lưu trữ thông tin tài liệu cho doanh nghiệp.

LocalServicesBusinessRegistrationType

Enum mô tả các loại hình đăng ký có thể có của cấu phần phần mềm xác minh kiểm tra đăng ký doanh nghiệp dịch vụ địa phương.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
NUMBER Loại kiểm tra số đăng ký.
DOCUMENT Loại kiểm tra giấy tờ đăng ký.

LocalServicesBusinessRegistrationCheckRejectionReason

Enum mô tả những lý do có thể bị từ chối của cấu phần phần mềm xác minh kiểm tra giấy đăng ký kinh doanh dịch vụ địa phương.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
BUSINESS_NAME_MISMATCH Tên doanh nghiệp không khớp với tên doanh nghiệp của Quảng cáo dịch vụ địa phương.
BUSINESS_DETAILS_MISMATCH Thông tin doanh nghiệp không khớp.
ID_NOT_FOUND Không tìm thấy mã đăng ký kinh doanh.
POOR_DOCUMENT_IMAGE_QUALITY Giấy tờ được tải lên không rõ ràng, bị mờ, v.v.
DOCUMENT_EXPIRED Tài liệu được tải lên đã hết hạn.
DOCUMENT_INVALID Tài liệu đã bị thu hồi hoặc bị huỷ bỏ.
DOCUMENT_TYPE_MISMATCH Loại tài liệu không khớp.
DOCUMENT_UNVERIFIABLE Không thể xác minh rằng tài liệu đã tải lên là hợp lệ.
OTHER Quy trình đăng ký kinh doanh chưa hoàn tất do có vấn đề. Hãy liên hệ với https://support.google.com/localservices để tìm hiểu thêm.

BusinessRegistrationNumber

Một proto chứa thông tin cụ thể cho số đăng ký kinh doanh dịch vụ địa phương.

Biểu diễn dưới dạng JSON 
{
  "number": string
}
Trường
number

string

Chỉ có đầu ra. Số điện thoại do chính phủ cấp cho doanh nghiệp.

BusinessRegistrationDocument

Một proto chứa thông tin dành riêng cho giấy tờ đăng ký kinh doanh dịch vụ địa phương.

Biểu diễn dưới dạng JSON 
{
  "documentReadonly": {
    object (LocalServicesDocumentReadOnly)
  }
}
Trường
documentReadonly

object (LocalServicesDocumentReadOnly)

Chỉ có đầu ra. Trường chỉ đọc có chứa thông tin của tài liệu đăng ký kinh doanh đã tải lên.

MobileAppCategoryConstant

Hằng số danh mục ứng dụng dành cho thiết bị di động.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "id": integer,
  "name": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của hằng số danh mục ứng dụng di động. Tên tài nguyên hằng số của danh mục ứng dụng dành cho thiết bị di động có dạng:

mobileAppCategoryConstants/{mobile_app_category_id}
id

integer

Chỉ có đầu ra. Mã của hằng số danh mục ứng dụng di động.
name

string

Chỉ có đầu ra. Tên danh mục ứng dụng dành cho thiết bị di động.

MobileDeviceConstant

Hằng số thiết bị di động.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "type": enum (MobileDeviceType),
  "id": string,
  "name": string,
  "manufacturerName": string,
  "operatingSystemName": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của hằng số thiết bị di động. Tên tài nguyên hằng số trên thiết bị di động có dạng như sau:

mobileDeviceConstants/{criterionId}
type

enum (MobileDeviceType)

Chỉ có đầu ra. Loại thiết bị di động.
id

string (int64 format)

Chỉ có đầu ra. Mã của hằng số thiết bị di động.
name

string

Chỉ có đầu ra. Tên của thiết bị di động.
manufacturerName

string

Chỉ có đầu ra. Nhà sản xuất thiết bị di động.
operatingSystemName

string

Chỉ có đầu ra. Hệ điều hành của thiết bị di động.

MobileDeviceType

Loại thiết bị di động.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
MOBILE Điện thoại di động.
TABLET Máy tính bảng.

OfflineConversionUploadClientSummary

Thông tin tóm tắt về việc tải lượt chuyển đổi ngoại tuyến lên ở cấp khách hàng.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "client": enum (OfflineEventUploadClient),
  "status": enum (OfflineConversionDiagnosticStatus),
  "totalEventCount": string,
  "successfulEventCount": string,
  "successRate": number,
  "lastUploadDateTime": string,
  "dailySummaries": [
    {
      object (OfflineConversionSummary)
    }
  ],
  "jobSummaries": [
    {
      object (OfflineConversionSummary)
    }
  ],
  "alerts": [
    {
      object (OfflineConversionAlert)
    }
  ]
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của bản tóm tắt về lượt tải lượt chuyển đổi ngoại tuyến lên ở cấp khách hàng. Tên tài nguyên tóm tắt ứng dụng tải lượt chuyển đổi ngoại tuyến lên có dạng như sau:

customers/{customerId}/offlineConversionUploadClientSummaries/{client}
client

enum (OfflineEventUploadClient)

Chỉ có đầu ra. Loại ứng dụng của sự kiện tải lên.
status

enum (OfflineConversionDiagnosticStatus)

Chỉ có đầu ra. Trạng thái chung của phần tóm tắt về khách hàng chuyển đổi ngoại tuyến. Trạng thái được tạo vào ngày gần đây nhất theo lịch cùng với số liệu thống kê về video tải lên.
totalEventCount

string (int64 format)

Chỉ có đầu ra. Tổng số sự kiện đã tải lên.
successfulEventCount

string (int64 format)

Chỉ có đầu ra. Tổng số sự kiện đã tải lên thành công.
successRate

number

Chỉ có đầu ra. Tỷ lệ thành công.
lastUploadDateTime

string

Chỉ có đầu ra. Ngày của lô tải lên mới nhất. Định dạng là "yyyy-mm-dd hh:mm:ss" và được đặt theo múi giờ của tài khoản Google Ads.
dailySummaries[]

object (OfflineConversionSummary)

Chỉ có đầu ra. Tóm tắt số liệu thống kê nhật ký trong N ngày qua.
jobSummaries[]

object (OfflineConversionSummary)

Chỉ có đầu ra. Tóm tắt số liệu thống kê về lịch sử theo N công việc gần đây nhất.
alerts[]

object (OfflineConversionAlert)

Chỉ có đầu ra. Thông tin chi tiết cho từng mã lỗi. Cảnh báo được tạo vào ngày gần đây nhất theo lịch cùng với số liệu thống kê về video tải lên.

OfflineEventUploadClient

Loại khách hàng.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
GOOGLE_ADS_API API Google Ads.
GOOGLE_ADS_WEB_CLIENT Ứng dụng web Google Ads, có thể bao gồm nhiều nguồn như Giao diện người dùng quảng cáo, Giao thức truyền tệp bảo mật (SFTP), v.v.
ADS_DATA_CONNECTOR Nền tảng kết nối.

OfflineConversionDiagnosticStatus

Các trạng thái có thể có của quá trình thiết lập quy trình nhập dữ liệu ngoại tuyến.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
EXCELLENT Chế độ thiết lập quy trình nhập dữ liệu ngoại tuyến của bạn đang hoạt động và được tối ưu cho quá trình xử lý về sau.
GOOD Chế độ thiết lập quy trình nhập dữ liệu ngoại tuyến của bạn đang hoạt động, nhưng bạn vẫn có thể cải thiện thêm. Xem các cảnh báo.
NEEDS_ATTENTION Chế độ thiết lập quy trình nhập dữ liệu ngoại tuyến của bạn đang hoạt động, nhưng có một số lỗi mà bạn cần chú ý. Xem các cảnh báo.
NO_RECENT_UPLOAD Chế độ thiết lập quy trình nhập dữ liệu ngoại tuyến chưa nhận được dữ liệu trong 28 ngày qua, có thể đã xảy ra lỗi.

OfflineConversionSummary

Thông tin tóm tắt về các lượt tải lên trước đây, nhóm theo ngày tải lên hoặc công việc.

Biểu diễn dưới dạng JSON 
{
  "successfulCount": string,
  "failedCount": string,

  // Union field dimension_key can be only one of the following:
  "jobId": string,
  "uploadDate": string
  // End of list of possible types for union field dimension_key.
}
Trường
successfulCount

string (int64 format)

Chỉ có đầu ra. Tổng số sự kiện thành công.
failedCount

string (int64 format)

Chỉ có đầu ra. Tổng số sự kiện không thành công.
Trường kết hợp dimension_key. Khoá phương diện để tóm tắt. dimension_key chỉ có thể là một trong những trạng thái sau đây:
jobId

string (int64 format)

Chỉ có đầu ra. Khoá thứ nguyên cho N công việc gần đây nhất.
uploadDate

string

Chỉ có đầu ra. Khoá phương diện trong N ngày qua.

OfflineConversionAlert

Thông báo về bản tóm tắt ứng dụng chuyển đổi ngoại tuyến.

Biểu diễn dưới dạng JSON 
{
  "error": {
    object (OfflineConversionError)
  },
  "errorPercentage": number
}
Trường
error

object (OfflineConversionError)

Chỉ có đầu ra. Lỗi khi gửi cảnh báo về ứng dụng chuyển đổi ngoại tuyến.
errorPercentage

number

Chỉ có đầu ra. Tỷ lệ phần trăm lỗi, phạm vi của trường này phải là [0, 1.0].

OfflineConversionError

Các lỗi có thể xảy ra đối với thông tin tóm tắt về ứng dụng chuyển đổi ngoại tuyến.

Biểu diễn dưới dạng JSON 
{

  // Union field error_code can be only one of the following:
  "collectionSizeError": enum (CollectionSizeError),
  "conversionAdjustmentUploadError": enum (ConversionAdjustmentUploadError),
  "conversionUploadError": enum (ConversionUploadError),
  "dateError": enum (DateError),
  "distinctError": enum (DistinctError),
  "fieldError": enum (FieldError),
  "mutateError": enum (MutateError),
  "notAllowlistedError": enum (NotAllowlistedError),
  "stringFormatError": enum (StringFormatError),
  "stringLengthError": enum (StringLengthError)
  // End of list of possible types for union field error_code.
}
Trường
Trường kết hợp error_code. Lỗi về nội dung mô tả. error_code chỉ có thể là một trong những trạng thái sau đây:
collectionSizeError

enum (CollectionSizeError)

Chỉ có đầu ra. Lỗi kích thước bộ sưu tập.
conversionAdjustmentUploadError

enum (ConversionAdjustmentUploadError)

Chỉ có đầu ra. Đã xảy ra lỗi khi tải mức điều chỉnh lượt chuyển đổi lên.
conversionUploadError

enum (ConversionUploadError)

Chỉ có đầu ra. Lỗi khi tải lượt chuyển đổi lên.
dateError

enum (DateError)

Chỉ có đầu ra. Lỗi ngày.
distinctError

enum (DistinctError)

Chỉ có đầu ra. Lỗi riêng biệt.
fieldError

enum (FieldError)

Chỉ có đầu ra. Lỗi trường.
mutateError

enum (MutateError)

Chỉ có đầu ra. Lỗi thay đổi.
notAllowlistedError

enum (NotAllowlistedError)

Chỉ có đầu ra. Lỗi không có trong danh sách cho phép.
stringFormatError

enum (StringFormatError)

Chỉ có đầu ra. Lỗi định dạng chuỗi.
stringLengthError

enum (StringLengthError)

Chỉ có đầu ra. Lỗi độ dài chuỗi.

CollectionSizeError

Enum mô tả các lỗi có thể xảy ra về kích thước bộ sưu tập.

Enum
UNSPECIFIED Chưa xác định enum.
UNKNOWN Không xác định được mã lỗi đã nhận trong phiên bản này.
TOO_FEW Quá ít.
TOO_MANY Quá nhiều.

ConversionAdjustmentUploadError

Enum mô tả các lỗi có thể xảy ra khi tải mức điều chỉnh lượt chuyển đổi lên.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
TOO_RECENT_CONVERSION_ACTION Không thể nhập sự kiện vào hành động chuyển đổi vừa tạo. Hãy thử nhập lại sau 6 giờ nữa.
CONVERSION_ALREADY_RETRACTED Lượt chuyển đổi này đã được rút lại. Mức điều chỉnh này chưa được xử lý.
CONVERSION_NOT_FOUND Không tìm thấy lượt chuyển đổi cho hành động chuyển đổi và giá trị nhận dạng lượt chuyển đổi này. Hãy đảm bảo rằng bạn đã liên kết giá trị nhận dạng lượt chuyển đổi với đúng hành động chuyển đổi, rồi thử lại.
CONVERSION_EXPIRED Không thể điều chỉnh một lượt chuyển đổi đã xảy ra hơn 54 ngày trước.
ADJUSTMENT_PRECEDES_CONVERSION Mức điều chỉnh có adjustmentDateTime xảy ra trước lượt chuyển đổi được liên kết. Hãy đảm bảo adjustmentDateTime của bạn là chính xác rồi thử lại.
MORE_RECENT_RESTATEMENT_FOUND Mức điều chỉnh gần đây hơn adjustmentDateTime đã được báo cáo cho lượt chuyển đổi liên quan. Hãy đảm bảo mức điều chỉnh adjustmentDateTime là chính xác, rồi thử lại.
TOO_RECENT_CONVERSION Mức điều chỉnh không được ghi lại vì lượt chuyển đổi xảy ra quá gần đây. Hãy thử điều chỉnh một lượt chuyển đổi đã xảy ra ít nhất 24 giờ trước.
CANNOT_RESTATE_CONVERSION_ACTION_THAT_ALWAYS_USES_DEFAULT_CONVERSION_VALUE Không thể điều chỉnh lượt chuyển đổi được thiết lập để sử dụng giá trị mặc định. Hãy kiểm tra chế độ cài đặt giá trị hành động chuyển đổi, rồi thử lại.
TOO_MANY_ADJUSTMENTS_IN_REQUEST Hãy thử tải lên tối đa 2.001 mức điều chỉnh trong một yêu cầu API.
TOO_MANY_ADJUSTMENTS Lượt chuyển đổi đã được điều chỉnh đến số lần tối đa. Hãy đảm bảo rằng bạn chỉ thực hiện mức điều chỉnh cần thiết đối với lượt chuyển đổi hiện có.
RESTATEMENT_ALREADY_EXISTS Lượt chuyển đổi này đã được sửa đổi trước đó có cùng adjustmentDateTime. Hãy đảm bảo mức điều chỉnh của bạn có adjustmentDateTime chính xác và duy nhất, rồi thử lại.
DUPLICATE_ADJUSTMENT_IN_REQUEST Mức điều chỉnh đã nhập có một mức điều chỉnh lượt chuyển đổi trùng lặp có cùng adjustmentDateTime. Hãy đảm bảo mức điều chỉnh có adjustmentDateTime chính xác rồi thử lại.
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS Đảm bảo rằng bạn đồng ý với các điều khoản xử lý dữ liệu khách hàng trong phần cài đặt lượt chuyển đổi, rồi thử lại.
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT Không thể sử dụng tính năng lượt chuyển đổi nâng cao với hành động chuyển đổi được chỉ định.
INVALID_USER_IDENTIFIER Đảm bảo rằng bạn đã băm dữ liệu do người dùng cung cấp bằng thuật toán SHA-256 và đảm bảo rằng bạn đang chuẩn hoá theo nguyên tắc.
UNSUPPORTED_USER_IDENTIFIER Hãy sử dụng dữ liệu do người dùng cung cấp, chẳng hạn như email hoặc số điện thoại được băm bằng thuật toán SHA-256, rồi thử lại.
GCLID_DATE_TIME_PAIR_AND_ORDER_ID_BOTH_SET Không thể đặt cả gclidDateTimePair và orderId. Vui lòng chỉ sử dụng 1 loại, rồi thử lại.
CONVERSION_ALREADY_ENHANCED Lượt chuyển đổi đã được nâng cao với cùng một mã đơn hàng và hành động chuyển đổi. Hãy đảm bảo dữ liệu của bạn được thiết lập chính xác, rồi thử lại.
DUPLICATE_ENHANCEMENT_IN_REQUEST Nhiều mức nâng cao có cùng hành động chuyển đổi và mã đơn hàng. Hãy đảm bảo dữ liệu của bạn được thiết lập chính xác, rồi thử lại.
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCEMENT Không thể sử dụng tính năng lượt chuyển đổi nâng cao cho tài khoản này do chính sách về dữ liệu khách hàng của Google. Liên hệ với đại diện Google của bạn.
MISSING_ORDER_ID_FOR_WEBPAGE Để điều chỉnh lượt chuyển đổi trên trang web, bạn phải nhập mã đơn hàng (ví dụ: mã giao dịch). Hãy đảm bảo rằng thẻ trang web của bạn có mã đơn hàng và bạn gửi cùng mã đơn hàng cho mức điều chỉnh của mình.
ORDER_ID_CONTAINS_PII Không thể sử dụng mức điều chỉnh với Mã đơn hàng chứa thông tin nhận dạng cá nhân (PII).
INVALID_JOB_ID Mã công việc được cung cấp trong yêu cầu không nằm trong phạm vi cho phép. Mã công việc phải là một số nguyên dương trong phạm vi [1, 2^31).
NO_CONVERSION_ACTION_FOUND Không tìm thấy hành động chuyển đổi được chỉ định trong yêu cầu điều chỉnh. Hãy đảm bảo hành động chuyển đổi đó có trong tài khoản này.
INVALID_CONVERSION_ACTION_TYPE Loại hành động chuyển đổi được chỉ định trong yêu cầu điều chỉnh không được hỗ trợ để tải mức điều chỉnh lên. Bạn chỉ được phép sử dụng mức điều chỉnh cho lượt chuyển đổi thuộc loại RETRACTION hoặc RESTATEMENT cho những hành động chuyển đổi thuộc loại SALESFORCE, UPLOAD_CLICK hoặc WEBPAGE. Bạn chỉ được phép sử dụng mức điều chỉnh cho lượt chuyển đổi thuộc loại ENHANCEMENT cho hành động chuyển đổi thuộc loại WEBPAGE.

ConversionUploadError

Enum mô tả các lỗi có thể xảy ra khi tải lượt chuyển đổi lên.

Enum
UNSPECIFIED Chưa xác định enum.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
TOO_MANY_CONVERSIONS_IN_REQUEST Tải ít hơn 2.001 sự kiện lên trong một yêu cầu.
UNPARSEABLE_GCLID Không thể giải mã GCLID đã nhập. Hãy đảm bảo bạn chưa sửa đổi mã lượt nhấp.
CONVERSION_PRECEDES_EVENT Sự kiện được nhập có conversionDateTime trước lượt nhấp. Hãy đảm bảo conversionDateTime của bạn là chính xác rồi thử lại.
EXPIRED_EVENT Không thể ghi lại sự kiện được nhập vì lượt nhấp của sự kiện đó đã xảy ra trước khoảng thời gian xảy ra lượt nhấp của lượt chuyển đổi này. Hãy đảm bảo bạn nhập dữ liệu mới nhất.
TOO_RECENT_EVENT Lượt nhấp được liên kết với giá trị nhận dạng hoặc tham số URL cho iOS đã xảy ra chưa đến 6 giờ trước. Hãy thử lại sau khi hết 6 giờ.
EVENT_NOT_FOUND Không thể phân bổ sự kiện được nhập cho một lượt nhấp. Điều này có thể xảy ra do sự kiện này không đến từ một chiến dịch trên Google Ads.
UNAUTHORIZED_CUSTOMER Mã lượt nhấp hoặc cuộc gọi được liên kết với một tài khoản Google Ads mà bạn không có quyền truy cập. Hãy đảm bảo bạn nhập lượt chuyển đổi cho các tài khoản được quản lý bởi tài khoản người quản lý của bạn.
TOO_RECENT_CONVERSION_ACTION Không thể nhập sự kiện vào hành động chuyển đổi vừa tạo. Hãy thử nhập lại sau 6 giờ nữa.
CONVERSION_TRACKING_NOT_ENABLED_AT_IMPRESSION_TIME Tại thời điểm xảy ra lượt nhấp, tính năng theo dõi lượt chuyển đổi chưa được bật trong tài khoản chuyển đổi hiệu quả của tài khoản Google Ads của lượt nhấp đó.
EXTERNAL_ATTRIBUTION_DATA_SET_FOR_NON_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION Sự kiện đã nhập bao gồm dữ liệu phân bổ bên ngoài, nhưng hành động chuyển đổi không được thiết lập để sử dụng mô hình phân bổ bên ngoài. Hãy đảm bảo hành động chuyển đổi được thiết lập chính xác, rồi thử lại.
EXTERNAL_ATTRIBUTION_DATA_NOT_SET_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION Bạn đã thiết lập hành động chuyển đổi để sử dụng mô hình phân bổ bên ngoài, nhưng sự kiện đã nhập bị thiếu dữ liệu. Hãy đảm bảo sự kiện đã nhập bao gồm giá trị đóng góp được phân bổ bên ngoài và tất cả các trường cần thiết.
ORDER_ID_NOT_PERMITTED_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION Bạn không thể sử dụng mã đơn hàng cho lượt chuyển đổi được đo lường bằng mô hình phân bổ bên ngoài. Hãy đảm bảo rằng lượt chuyển đổi được định cấu hình chính xác và các sự kiện được nhập chỉ bao gồm dữ liệu cần thiết, rồi thử lại.
ORDER_ID_ALREADY_IN_USE Sự kiện đã nhập bao gồm mã đơn hàng đã được ghi lại trước đó, vì vậy, sự kiện này chưa được xử lý.
DUPLICATE_ORDER_ID Các sự kiện đã nhập bao gồm nhiều lượt chuyển đổi có cùng mã đơn hàng và không được xử lý. Hãy đảm bảo mã đơn hàng không trùng lặp, rồi thử lại.
TOO_RECENT_CALL Không thể nhập những cuộc gọi diễn ra cách đây chưa đến 6 giờ. Hãy thử tải dữ liệu lên lại sau 6 giờ nữa.
EXPIRED_CALL Không thể ghi lại cuộc gọi vì cuộc gọi đó đã xảy ra trước giai đoạn xem lại của hành động chuyển đổi này. Hãy nhớ định cấu hình quá trình nhập để nhận được dữ liệu mới nhất.
CALL_NOT_FOUND Không thể tìm thấy cuộc gọi hoặc lượt nhấp dẫn đến sự kiện được nhập. Hãy đảm bảo nguồn dữ liệu của bạn được thiết lập để bao gồm các giá trị nhận dạng chính xác.
CONVERSION_PRECEDES_CALL Cuộc gọi có conversionDateTime trước lượt nhấp được liên kết. Đảm bảo conversionDateTime của bạn là chính xác.
CONVERSION_TRACKING_NOT_ENABLED_AT_CALL_TIME Tại thời điểm cuộc gọi được nhập, tính năng theo dõi lượt chuyển đổi chưa được bật trong tài khoản chuyển đổi hiệu quả của tài khoản Google Ads của lượt nhấp đó.
UNPARSEABLE_CALLERS_PHONE_NUMBER Đảm bảo rằng các số điện thoại có định dạng là E.164 (+16502531234), Quốc tế (+64 3-331 6005) hoặc số điện thoại quốc gia Hoa Kỳ (6502531234).
CLICK_CONVERSION_ALREADY_EXISTS Sự kiện được nhập có cùng lượt nhấp và conversionDateTime với một lượt chuyển đổi hiện có. Hãy sử dụng một conversionDateTime hoặc mã đơn hàng duy nhất cho từng sự kiện riêng biệt rồi thử lại.
CALL_CONVERSION_ALREADY_EXISTS Cuộc gọi được nhập có cùng conversionDateTime với một lượt chuyển đổi hiện có. Hãy đảm bảo conversionDateTime của bạn được thiết lập chính xác rồi thử lại.
DUPLICATE_CLICK_CONVERSION_IN_REQUEST Nhiều sự kiện có cùng lượt nhấp và conversionDateTime. Hãy đảm bảo conversionDateTime được định cấu hình chính xác rồi thử lại.
DUPLICATE_CALL_CONVERSION_IN_REQUEST Nhiều sự kiện có cùng lệnh gọi và conversionDateTime. Hãy đảm bảo conversionDateTime của bạn được định cấu hình chính xác, rồi thử lại.
CUSTOM_VARIABLE_NOT_ENABLED Hãy bật biến tuỳ chỉnh trong chế độ cài đặt lượt chuyển đổi, rồi thử lại.
CUSTOM_VARIABLE_VALUE_CONTAINS_PII Không thể nhập những sự kiện có biến tuỳ chỉnh chứa thông tin nhận dạng cá nhân (PII). Hãy xoá các biến này, rồi thử lại.
INVALID_CUSTOMER_FOR_CLICK Lượt nhấp từ sự kiện đã nhập được liên kết với một tài khoản Google Ads khác. Hãy đảm bảo rằng bạn đang nhập sự kiện vào đúng tài khoản.
INVALID_CUSTOMER_FOR_CALL Lượt nhấp từ lệnh gọi được liên kết với một tài khoản Google Ads khác. Hãy đảm bảo rằng bạn đang nhập sự kiện vào đúng tài khoản. Truy vấn conversionTrackingSettings.google_ads_conversion_customer đối với Khách hàng để xác định đúng tài khoản.
CONVERSION_NOT_COMPLIANT_WITH_ATT_POLICY Không thể nhập mâu thuẫn vì nguồn chuyển đổi không tuân thủ chính sách Theo dõi tính minh bạch trong ứng dụng (ATT) của Apple hoặc do khách hàng không đồng ý theo dõi.
CLICK_NOT_FOUND Không thể so khớp địa chỉ email hoặc số điện thoại của sự kiện này với một lượt nhấp. Lỗi này có thể là do sự kiện không bắt nguồn từ một chiến dịch trên Google Ads, nên bạn có thể yên tâm bỏ qua cảnh báo này. Nếu lỗi này bao gồm nhiều sự kiện được nhập hơn so với dự kiến, thì bạn có thể cần kiểm tra chế độ thiết lập của mình.
INVALID_USER_IDENTIFIER Đảm bảo rằng bạn đã băm dữ liệu do người dùng cung cấp bằng thuật toán SHA-256 và đảm bảo rằng bạn đang chuẩn hoá theo nguyên tắc.
EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION_NOT_PERMITTED_WITH_USER_IDENTIFIER Không thể sử dụng dữ liệu do người dùng cung cấp cùng với các mô hình phân bổ bên ngoài. Hãy sử dụng một mô hình phân bổ khác hoặc bỏ qua giá trị nhận dạng người dùng, rồi thử lại.
UNSUPPORTED_USER_IDENTIFIER Các giá trị nhận dạng người dùng đã cung cấp không được hỗ trợ. Vui lòng chỉ sử dụng email hoặc số điện thoại đã băm, rồi thử lại.
GBRAID_WBRAID_BOTH_SET Không thể sử dụng cả tham số gBraid và wBraid. Vui lòng chỉ sử dụng một tham số, rồi thử lại.
UNPARSEABLE_WBRAID Không thể phân tích cú pháp dữ liệu nhập sự kiện. Hãy kiểm tra xem tham số wBraid có bị sửa đổi hay không rồi thử lại.
UNPARSEABLE_GBRAID Không thể phân tích cú pháp dữ liệu nhập sự kiện. Hãy kiểm tra xem tham số gBraid có bị sửa đổi hay không rồi thử lại.
ONE_PER_CLICK_CONVERSION_ACTION_NOT_PERMITTED_WITH_BRAID Không thể sử dụng những hành động chuyển đổi áp dụng phương thức tính một lần cho mỗi lượt nhấp với tham số gBraid hoặc wBraid.
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS Không thể sử dụng tính năng lượt chuyển đổi nâng cao cho tài khoản này do chính sách về dữ liệu khách hàng của Google. Liên hệ với đại diện Google của bạn.
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS Đảm bảo rằng bạn đồng ý với các điều khoản xử lý dữ liệu khách hàng trong phần cài đặt lượt chuyển đổi, rồi thử lại. Bạn có thể kiểm tra chế độ cài đặt của mình bằng cách truy vấn conversionTrackingSettings.accepted_customer_data_terms đối với Khách hàng.
ORDER_ID_CONTAINS_PII Không thể nhập các sự kiện có mã đơn hàng chứa thông tin nhận dạng cá nhân (PII).
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS Đảm bảo rằng bạn đã bật tính năng lượt chuyển đổi nâng cao cho khách hàng tiềm năng trong phần cài đặt lượt chuyển đổi, rồi thử lại. Bạn có thể kiểm tra chế độ cài đặt của mình bằng cách truy vấn conversionTrackingSettings.enhanced_conversions_for_leads_enabled đối với Khách hàng.
INVALID_JOB_ID Mã công việc được cung cấp trong yêu cầu không nằm trong phạm vi cho phép. Mã công việc phải là một số nguyên dương trong phạm vi [1, 2^31).
NO_CONVERSION_ACTION_FOUND Không tìm thấy hành động chuyển đổi được chỉ định trong yêu cầu tải lên. Hãy đảm bảo hành động chuyển đổi đó có trong tài khoản này.
INVALID_CONVERSION_ACTION_TYPE Hành động chuyển đổi được chỉ định trong yêu cầu tải lên chưa được thiết lập để tải lượt chuyển đổi lên.

DateError

Enum mô tả các lỗi ngày có thể xảy ra.

Enum
UNSPECIFIED Chưa xác định enum.
UNKNOWN Không xác định được mã lỗi đã nhận trong phiên bản này.
INVALID_FIELD_VALUES_IN_DATE Các giá trị trường đã cho không tương ứng với ngày hợp lệ.
INVALID_FIELD_VALUES_IN_DATE_TIME Các giá trị trường đã cho không tương ứng với ngày giờ hợp lệ.
INVALID_STRING_DATE Định dạng của chuỗi ngày phải là yyyy-mm-dd.
INVALID_STRING_DATE_TIME_MICROS Định dạng của chuỗi ngày giờ phải là yyyy-mm-dd hh:mm:ss.ssssss.
INVALID_STRING_DATE_TIME_SECONDS Định dạng của chuỗi ngày giờ phải là yyyy-mm-dd hh:mm:ss.
INVALID_STRING_DATE_TIME_SECONDS_WITH_OFFSET Định dạng của chuỗi ngày giờ phải là yyyy-mm-dd hh:mm:ss+|-hh:mm.
EARLIER_THAN_MINIMUM_DATE Ngày trước ngày tối thiểu cho phép.
LATER_THAN_MAXIMUM_DATE Ngày sau ngày tối đa cho phép.
DATE_RANGE_MINIMUM_DATE_LATER_THAN_MAXIMUM_DATE Giới hạn phạm vi ngày không theo thứ tự.
DATE_RANGE_MINIMUM_AND_MAXIMUM_DATES_BOTH_NULL Cả hai ngày trong phạm vi đều rỗng.

DistinctError

Enum mô tả các lỗi riêng biệt có thể xảy ra.

Enum
UNSPECIFIED Chưa xác định enum.
UNKNOWN Không xác định được mã lỗi đã nhận trong phiên bản này.
DUPLICATE_ELEMENT Phần tử trùng lặp.
DUPLICATE_TYPE Loại trùng lặp.

FieldError

Enum mô tả các lỗi trường có thể xảy ra.

Enum
UNSPECIFIED Chưa xác định enum.
UNKNOWN Không xác định được mã lỗi đã nhận trong phiên bản này.
REQUIRED Thiếu trường bắt buộc.
IMMUTABLE_FIELD Không thể thay đổi trường đã cố gắng thay đổi.
INVALID_VALUE Giá trị của trường này không hợp lệ.
VALUE_MUST_BE_UNSET Không thể đặt trường này.
REQUIRED_NONEMPTY_LIST Trường lặp lại bắt buộc bị trống.
FIELD_CANNOT_BE_CLEARED Không thể xoá trường này.
BLOCKED_VALUE Giá trị của trường này nằm trong danh sách từ chối của trường này.
FIELD_CAN_ONLY_BE_CLEARED Bạn không thể sửa đổi giá trị của trường, trừ trường hợp xóa.

MutateError

Enum mô tả các lỗi đột biến có thể xảy ra.

Enum
UNSPECIFIED Chưa xác định enum.
UNKNOWN Không xác định được mã lỗi đã nhận trong phiên bản này.
RESOURCE_NOT_FOUND Không tìm thấy tài nguyên được yêu cầu.
ID_EXISTS_IN_MULTIPLE_MUTATES Không thể thay đổi cùng một tài nguyên hai lần trong một yêu cầu.
INCONSISTENT_FIELD_VALUES Nội dung của trường này không khớp với một trường khác đại diện cho cùng một dữ liệu.
MUTATE_NOT_ALLOWED Không được phép thay đổi tài nguyên được yêu cầu.
RESOURCE_NOT_IN_GOOGLE_ADS Tài nguyên không có trong Google Ads. Thuộc tính này thuộc về một hệ thống quảng cáo khác.
RESOURCE_ALREADY_EXISTS Tài nguyên đang được tạo đã tồn tại.
RESOURCE_DOES_NOT_SUPPORT_VALIDATE_ONLY Không thể sử dụng tài nguyên này với "validateOnly".
OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE Không thể sử dụng thao tác này với lỗi "partialFailure".
RESOURCE_READ_ONLY Cố gắng ghi vào các trường chỉ có thể đọc.

NotAllowlistedError

Enum mô tả các lỗi có thể xảy ra không có trong danh sách cho phép.

Enum
UNSPECIFIED Chưa xác định enum.
UNKNOWN Không xác định được mã lỗi đã nhận trong phiên bản này.
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE Khách hàng không có tên trong danh sách được phép sử dụng tính năng này.

StringFormatError

Enum mô tả các lỗi định dạng chuỗi có thể xảy ra.

Enum
UNSPECIFIED Chưa xác định enum.
UNKNOWN Không xác định được mã lỗi đã nhận trong phiên bản này.
ILLEGAL_CHARS Giá trị chuỗi nhập chứa các ký tự không được phép.
INVALID_FORMAT Giá trị chuỗi nhập không hợp lệ đối với trường đã liên kết.

StringLengthError

Enum mô tả các lỗi có thể xảy ra về độ dài chuỗi.

Enum
UNSPECIFIED Chưa xác định enum.
UNKNOWN Không xác định được mã lỗi đã nhận trong phiên bản này.
EMPTY Trường được chỉ định phải có ít nhất một ký tự không có khoảng trắng.
TOO_SHORT Quá ngắn.
TOO_LONG Tên quá dài.

OperatingSystemVersionConstant

Phiên bản hệ điều hành dành cho thiết bị di động hoặc nhiều phiên bản, tuỳ thuộc vào operatorType. Danh sách các nền tảng di động hiện có tại https://developers.google.com/google-ads/api/reference/data/codes-formats#mobile-platforms

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "operatorType": enum (OperatingSystemVersionOperatorType),
  "id": string,
  "name": string,
  "osMajorVersion": integer,
  "osMinorVersion": integer
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của hằng số phiên bản hệ điều hành. Tên tài nguyên không đổi của phiên bản hệ điều hành có dạng như sau:

operatingSystemVersionConstants/{criterionId}
operatorType

enum (OperatingSystemVersionOperatorType)

Chỉ có đầu ra. Xác định xem hằng số này đại diện cho một phiên bản hay một phạm vi phiên bản.
id

string (int64 format)

Chỉ có đầu ra. Mã của phiên bản hệ điều hành.
name

string

Chỉ có đầu ra. Tên hệ điều hành.
osMajorVersion

integer

Chỉ có đầu ra. Số phiên bản lớn của hệ điều hành.
osMinorVersion

integer

Chỉ có đầu ra. Số phiên bản nhỏ của hệ điều hành.

OperatingSystemVersionOperatorType

Loại phiên bản hệ điều hành.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
EQUALS_TO Bằng với phiên bản đã chỉ định.
GREATER_THAN_EQUALS_TO Lớn hơn hoặc bằng phiên bản được chỉ định.

PaidOrganicSearchTermView

Chế độ xem cụm từ tìm kiếm không phải trả tiền có trả phí cung cấp chế độ xem số liệu thống kê về kết quả tìm kiếm trên các quảng cáo và trang thông tin tự nhiên được tổng hợp theo cụm từ tìm kiếm ở cấp nhóm quảng cáo.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "searchTerm": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem cụm từ tìm kiếm. Tên tài nguyên của chế độ xem cụm từ tìm kiếm có dạng như sau:

customers/{customerId}/paidOrganicSearchTermViews/{campaignId}~ {adGroupId}~{URL-base64 search term}
searchTerm

string

Chỉ có đầu ra. Cụm từ tìm kiếm.

QualifyingQuestion

Các câu hỏi đánh giá cho Biểu mẫu khách hàng tiềm năng.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "qualifyingQuestionId": string,
  "locale": string,
  "text": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của câu hỏi sàng lọc.

' đủ điều kiện đặt câu hỏi/{QualingQuestionId}'
qualifyingQuestionId

string (int64 format)

Chỉ có đầu ra. Mã của câu hỏi xác định điều kiện.
locale

string

Chỉ có đầu ra. Ngôn ngữ của câu hỏi xác định điều kiện.
text

string

Chỉ có đầu ra. Câu hỏi sàng lọc.

ParentalStatusView

Chế độ xem tình trạng con cái.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem tình trạng con cái. Tên tài nguyên của chế độ xem Tình trạng con cái có dạng như sau:

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

PerStoreView

Chế độ xem theo cửa hàng. Chế độ xem này cung cấp số liệu thống kê về lượt chuyển đổi dẫn đến hành động liên quan đến địa điểm thực tế và phạm vi tiếp cận lượt hiển thị trên mỗi cửa hàng cho nhà quảng cáo.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "placeId": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem theo mỗi cửa hàng. Tên tài nguyên trên mỗi lượt xem cửa hàng có dạng như sau:

customers/{customerId}/perStoreViews/{placeId}
placeId

string

Chỉ có đầu ra. Mã địa điểm của chế độ xem mỗi cửa hàng.

ProductCategoryConstant

Danh mục sản phẩm.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "categoryId": string,
  "level": enum (ProductCategoryLevel),
  "state": enum (ProductCategoryState),
  "localizations": [
    {
      object (ProductCategoryLocalization)
    }
  ],
  "productCategoryConstantParent": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của danh mục sản phẩm. Tên tài nguyên danh mục sản phẩm có dạng:

productCategoryConstants/{level}~{categoryId}
categoryId

string (int64 format)

Chỉ có đầu ra. Mã của danh mục sản phẩm.

Mã này tương đương với mã google_product_category [danh_mục_sản_phẩm_của_Google] như mô tả trong bài viết này: https://support.google.com/merchants/answer/6324436.
level

enum (ProductCategoryLevel)

Chỉ có đầu ra. Cấp của danh mục sản phẩm.
state

enum (ProductCategoryState)

Chỉ có đầu ra. Trạng thái của danh mục sản phẩm.
localizations[]

object (ProductCategoryLocalization)

Chỉ có đầu ra. Danh sách tất cả nội dung bản địa hoá hiện có của danh mục sản phẩm.
productCategoryConstantParent

string

Chỉ có đầu ra. Tên tài nguyên của danh mục sản phẩm chính.

ProductCategoryState

Enum mô tả trạng thái của danh mục sản phẩm.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
ENABLED Danh mục đã được bật.
OBSOLETE Danh mục này đã lỗi thời. Chỉ dùng cho mục đích báo cáo.

ProductCategoryLocalization

Bản địa hoá danh mục sản phẩm.

Biểu diễn dưới dạng JSON 
{
  "regionCode": string,
  "languageCode": string,
  "value": string
}
Trường
regionCode

string

Chỉ có đầu ra. Mã quốc gia gồm hai chữ cái theo ISO 3166-1 viết hoa của danh mục đã bản địa hoá.
languageCode

string

Chỉ có đầu ra. Mã ngôn ngữ gồm hai chữ cái theo ISO 639-1 của danh mục đã bản địa hoá.
value

string

Chỉ có đầu ra. Tên danh mục bằng ngôn ngữ được chỉ định.

ProductGroupView

Chế độ xem nhóm sản phẩm.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem nhóm sản phẩm. Tên tài nguyên trong chế độ xem nhóm sản phẩm có dạng:

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

SearchTermView

Chế độ xem cụm từ tìm kiếm với các chỉ số được tổng hợp theo cụm từ tìm kiếm ở cấp nhóm quảng cáo.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "status": enum (SearchTermTargetingStatus),
  "searchTerm": string,
  "adGroup": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem cụm từ tìm kiếm. Tên tài nguyên của chế độ xem cụm từ tìm kiếm có dạng như sau:

customers/{customerId}/searchTermViews/{campaignId}~{adGroupId}~{URL-base64_search_term}
status

enum (SearchTermTargetingStatus)

Chỉ có đầu ra. Cho biết liệu cụm từ tìm kiếm hiện tại có phải là một trong các từ khoá được nhắm mục tiêu hay loại trừ của bạn hay không.
searchTerm

string

Chỉ có đầu ra. Cụm từ tìm kiếm.
adGroup

string

Chỉ có đầu ra. Nhóm quảng cáo chứa cụm từ tìm kiếm được phân phát.

SearchTermTargetingStatus

Cho biết liệu cụm từ tìm kiếm đó có phải là một trong các từ khoá được nhắm mục tiêu hay bị loại trừ của bạn hay không.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
ADDED Cụm từ tìm kiếm được thêm vào từ khoá được nhắm mục tiêu.
EXCLUDED Cụm từ tìm kiếm khớp với một từ khoá phủ định.
ADDED_EXCLUDED Cụm từ tìm kiếm vừa được thêm và bị loại trừ.
NONE Cụm từ tìm kiếm không được nhắm mục tiêu hay loại trừ.

ShoppingPerformanceView

Chế độ xem hiệu suất mua sắm. Cung cấp số liệu thống kê tổng hợp về chiến dịch Mua sắm ở một số cấp phương diện sản phẩm. Các giá trị phương diện sản phẩm trong Merchant Center như thương hiệu, danh mục, thuộc tính tuỳ chỉnh, tình trạng sản phẩm và loại sản phẩm sẽ thể hiện trạng thái của từng phương diện kể từ ngày và giờ ghi lại sự kiện tương ứng.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem hiệu suất Mua sắm. Tên tài nguyên chế độ xem hiệu suất mua sắm có dạng: customers/{customerId}/shoppingPerformanceView

SmartCampaignSearchTermView

Chế độ xem cụm từ tìm kiếm của chiến dịch Thông minh.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "searchTerm": string,
  "campaign": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem cụm từ tìm kiếm trong chiến dịch Thông minh. Tên tài nguyên chế độ xem cụm từ tìm kiếm của chiến dịch Thông minh có dạng như sau:

customers/{customerId}/smartCampaignSearchTermViews/{campaignId}~{URL-base64_search_term}
searchTerm

string

Chỉ có đầu ra. Cụm từ tìm kiếm.
campaign

string

Chỉ có đầu ra. Chiến dịch Thông minh mà cụm từ tìm kiếm được phân phát.

TopicView

Chế độ xem theo chủ đề.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của khung hiển thị chủ đề. Tên tài nguyên chế độ xem chủ đề có dạng:

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

TravelActivityGroupView

Chế độ xem nhóm hoạt động đi lại.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem nhóm hoạt động đi lại. Tên tài nguyên của chế độ xem Nhóm hoạt động du lịch có dạng như sau:

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

TravelActivityPerformanceView

Chế độ xem hiệu suất hoạt động đi lại.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem hiệu suất hoạt động đi lại. Tên tài nguyên chế độ xem hiệu suất Hoạt động du lịch có dạng như sau:

customers/{customerId}/travelActivityPerformanceView

Sở thích của người dùng

Mối quan tâm của người dùng: một ngành dọc dựa trên mối quan tâm cụ thể sẽ được nhắm mục tiêu.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "taxonomyType": enum (UserInterestTaxonomyType),
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ],
  "userInterestId": string,
  "name": string,
  "userInterestParent": string,
  "launchedToAll": boolean
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên mà người dùng quan tâm. Tên tài nguyên về mối quan tâm của người dùng có dạng như sau:

customers/{customerId}/userInterests/{userInterestId}
taxonomyType

enum (UserInterestTaxonomyType)

Chỉ có đầu ra. Loại phân loại mối quan tâm của người dùng.
availabilities[]

object (CriterionCategoryAvailability)

Chỉ có đầu ra. Thông tin về tình trạng còn hàng mà người dùng quan tâm.
userInterestId

string (int64 format)

Chỉ có đầu ra. Mã mối quan tâm của người dùng.
name

string

Chỉ có đầu ra. Tên của mối quan tâm của người dùng.
userInterestParent

string

Chỉ có đầu ra. Cấp độ gốc của mối quan tâm của người dùng.
launchedToAll

boolean

Chỉ có đầu ra. Đúng nếu mối quan tâm của người dùng được triển khai cho tất cả các kênh và ngôn ngữ.

UserInterestTaxonomyType

Enum chứa UserinterestTaxonomyTypes có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
AFFINITY Đối tượng tương đồng với mối quan tâm này của người dùng.
IN_MARKET Thị trường cho mối quan tâm của người dùng này.
MOBILE_APP_INSTALL_USER Người dùng được xác định là đã cài đặt các ứng dụng trong các danh mục được chỉ định.
VERTICAL_GEO Vị trí địa lý của ngành dọc dựa trên mối quan tâm.
NEW_SMART_PHONE_USER Tiêu chí về mối quan tâm của người dùng đối với người dùng điện thoại thông minh mới.

LifeEvent

Sự kiện trong đời: một ngành dọc cụ thể dựa trên mối quan tâm sẽ được nhắm đến để tiếp cận người dùng khi họ trải qua các mốc quan trọng trong cuộc đời.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "parent": string,
  "launchedToAll": boolean,
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ]
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của sự kiện trong đời. Tên tài nguyên sự kiện trong đời có dạng như sau:

customers/{customerId}/lifeEvents/{lifeEventId}
id

string (int64 format)

Chỉ có đầu ra. Mã của sự kiện trong đời.
name

string

Chỉ có đầu ra. Tên của sự kiện trong đời (ví dụ: "Mới di chuyển gần đây")
parent

string

Chỉ có đầu ra. Cấp độ gốc của LifeEvent.
launchedToAll

boolean

Chỉ có đầu ra. Đúng nếu sự kiện trong đời được phát hành cho tất cả các kênh và ngôn ngữ.
availabilities[]

object (CriterionCategoryAvailability)

Chỉ có đầu ra. Thông tin về tình trạng còn hàng của sự kiện trong đời.

UserLocationView

Chế độ xem vị trí của người dùng.

Chế độ xem vị trí của người dùng bao gồm tất cả các chỉ số tổng hợp ở cấp quốc gia, một hàng cho mỗi quốc gia. Báo cáo các chỉ số tại vị trí thực tế của người dùng theo vị trí được nhắm mục tiêu hoặc không được nhắm mục tiêu. Nếu sử dụng các trường phân đoạn khác, bạn có thể nhận được nhiều hàng cho mỗi quốc gia.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "countryCriterionId": string,
  "targetingLocation": boolean
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên trong chế độ xem vị trí của người dùng. Tên tài nguyên chế độ xem UserLocation có dạng:

customers/{customerId}/userLocationViews/{countryCriterionId}~{targetingLocation}
countryCriterionId

string (int64 format)

Chỉ có đầu ra. Mã tiêu chí cho quốc gia.
targetingLocation

boolean

Chỉ có đầu ra. Cho biết vị trí có được nhắm mục tiêu hay không.

TopicConstant

Sử dụng chủ đề để nhắm mục tiêu hoặc loại trừ vị trí trong Mạng Hiển thị của Google dựa trên danh mục của vị trí (ví dụ: "Thú cưng & động vật/Thú cưng/chó").

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "path": [
    string
  ],
  "id": string,
  "topicConstantParent": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của hằng số chủ đề. tên tài nguyên hằng số chủ đề có dạng:

topicConstants/{topic_id}
path[]

string

Chỉ có đầu ra. Danh mục cần nhắm mục tiêu hoặc loại trừ. Mỗi phần tử tiếp theo trong mảng mô tả một danh mục phụ cụ thể hơn. Ví dụ: {"Thú cưng & Động vật", "Thú cưng", "Chó"} đại diện cho "Thú cưng & Động vật/Thú cưng/Chó" danh mục. Danh sách các danh mục chủ đề có sẵn tại https://developers.google.com/google-ads/api/reference/data/verticals
id

string (int64 format)

Chỉ có đầu ra. Mã của chủ đề.
topicConstantParent

string

Chỉ có đầu ra. Tên tài nguyên của hằng số chủ đề gốc.

Video

Một video.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "id": string,
  "channelId": string,
  "durationMillis": string,
  "title": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của video. Tên tài nguyên video có dạng:

customers/{customerId}/videos/{videoId}
id

string

Chỉ có đầu ra. Mã nhận dạng của video.
channelId

string

Chỉ có đầu ra. Mã kênh chủ sở hữu của video.
durationMillis

string (int64 format)

Chỉ có đầu ra. Thời lượng của video tính bằng mili giây.
title

string

Chỉ có đầu ra. Tiêu đề của video.

WebpageView

Chế độ xem trang web.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của khung hiển thị trang web. Tên tài nguyên lượt xem trang web có dạng:

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

LeadFormSubmissionData

Dữ liệu từ các lượt gửi biểu mẫu khách hàng tiềm năng.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "id": string,
  "asset": string,
  "campaign": string,
  "leadFormSubmissionFields": [
    {
      object (LeadFormSubmissionField)
    }
  ],
  "customLeadFormSubmissionFields": [
    {
      object (CustomLeadFormSubmissionField)
    }
  ],
  "adGroup": string,
  "adGroupAd": string,
  "gclid": string,
  "submissionDateTime": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của dữ liệu về lượt gửi biểu mẫu khách hàng tiềm năng. Tên tài nguyên dữ liệu gửi biểu mẫu khách hàng tiềm năng có dạng như sau:

customers/{customerId}/leadFormSubmissionData/{lead_form_submission_data_id}
id

string

Chỉ có đầu ra. Mã của lượt gửi biểu mẫu khách hàng tiềm năng này.
asset

string

Chỉ có đầu ra. Thành phần được liên kết với biểu mẫu khách hàng tiềm năng đã gửi.
campaign

string

Chỉ có đầu ra. Chiến dịch được liên kết với biểu mẫu khách hàng tiềm năng đã gửi.
leadFormSubmissionFields[]

object (LeadFormSubmissionField)

Chỉ có đầu ra. Dữ liệu về lượt gửi biểu mẫu khách hàng tiềm năng có liên kết với một biểu mẫu khách hàng tiềm năng.
customLeadFormSubmissionFields[]

object (CustomLeadFormSubmissionField)

Chỉ có đầu ra. Dữ liệu về lượt gửi biểu mẫu được liên kết với một biểu mẫu khách hàng tiềm năng tuỳ chỉnh.
adGroup

string

Chỉ có đầu ra. Nhóm quảng cáo được liên kết với biểu mẫu khách hàng tiềm năng đã gửi.
adGroupAd

string

Chỉ có đầu ra. Nhóm quảng cáo được liên kết với biểu mẫu khách hàng tiềm năng đã gửi.
gclid

string

Chỉ có đầu ra. Mã lượt nhấp của Google được liên kết với biểu mẫu khách hàng tiềm năng đã gửi.
submissionDateTime

string

Chỉ có đầu ra. Ngày và giờ gửi biểu mẫu khách hàng tiềm năng. Định dạng là "yyyy-mm-dd hh:mm:ss+|-hh:mm", ví dụ: "2019-01-01 12:32:45-08:00".

LeadFormSubmissionField

Các trường trong biểu mẫu khách hàng tiềm năng đã gửi.

Biểu diễn dưới dạng JSON 
{
  "fieldType": enum (LeadFormFieldUserInputType),
  "fieldValue": string
}
Trường
fieldType

enum (LeadFormFieldUserInputType)

Chỉ có đầu ra. Loại trường dành cho các trường trong biểu mẫu khách hàng tiềm năng.
fieldValue

string

Chỉ có đầu ra. Giá trị trường cho các trường trong biểu mẫu khách hàng tiềm năng.

CustomLeadFormSubmissionField

Các trường trong câu hỏi tuỳ chỉnh đã gửi

Biểu diễn dưới dạng JSON 
{
  "questionText": string,
  "fieldValue": string
}
Trường
questionText

string

Chỉ có đầu ra. Nội dung câu hỏi cho câu hỏi tuỳ chỉnh, số lượng ký tự tối đa là 300.
fieldValue

string

Chỉ có đầu ra. Giá trị trường để trả lời câu hỏi tùy chỉnh, số ký tự tối đa là 70.

LocalServicesLead

Dữ liệu của Trưởng nhóm dịch vụ địa phương. Chứa thông tin chi tiết về Khách hàng tiềm năng được tạo khi nhà quảng cáo gọi điện, nhắn tin hoặc mua sách. Thông tin khác: https://ads.google.com/local-services-ads

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "id": string,
  "categoryId": string,
  "serviceId": string,
  "contactDetails": {
    object (ContactDetails)
  },
  "leadType": enum (LeadType),
  "leadStatus": enum (LeadStatus),
  "creationDateTime": string,
  "locale": string,
  "leadCharged": boolean,
  "note": {
    object (Note)
  },
  "creditDetails": {
    object (CreditDetails)
  }
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của dữ liệu về khách hàng tiềm năng liên quan đến dịch vụ địa phương. Tên của tài nguyên dành cho Khách hàng tiềm năng của Dịch vụ địa phương có biểu mẫu

customers/{customerId}/localServicesLead/{local_services_lead_id}
id

string (int64 format)

Chỉ có đầu ra. Mã của Khách hàng tiềm năng này.
categoryId

string

Chỉ có đầu ra. Danh mục dịch vụ của khách hàng tiềm năng. Ví dụ: xcat:service_area_business_hvac, xcat:service_area_business_real_estate_agent, v.v. Để biết thêm thông tin chi tiết, hãy xem: https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids
serviceId

string

Chỉ có đầu ra. Dịch vụ cho danh mục. Ví dụ: buyer_agent, seller_agent cho danh mục xcat:service_area_business_real_estate_agent.
contactDetails

object (ContactDetails)

Chỉ có đầu ra. Thông tin liên hệ của khách hàng tiềm năng.
leadType

enum (LeadType)

Chỉ có đầu ra. Loại khách hàng tiềm năng Dịch vụ địa phương: qua điện thoại, tin nhắn, lượt đặt trước, v.v.
leadStatus

enum (LeadStatus)

Chỉ có đầu ra. Trạng thái hiện tại của khách hàng tiềm năng.
creationDateTime

string

Chỉ có đầu ra. Ngày mà khách hàng tiềm năng được tạo bằng Quảng cáo dịch vụ địa phương. Định dạng là "YYYY-MM-DD HH:MM:SS" theo múi giờ của tài khoản Google Ads. Ví dụ: "2018-03-05 09:15:00" hoặc "2018-02-01 14:34:30"
locale

string

Chỉ có đầu ra. Ngôn ngữ được nhà cung cấp Dịch vụ địa phương sử dụng liên kết với khách hàng tiềm năng. Hãy xem https://developers.google.com/google-ads/api/data/codes-formats#locales
leadCharged

boolean

Chỉ có đầu ra. Đúng nếu nhà quảng cáo bị tính phí cho khách hàng tiềm năng.
note

object (Note)

Chỉ có đầu ra. Ghi chú do nhà quảng cáo thêm cho khách hàng tiềm năng.
creditDetails

object (CreditDetails)

Chỉ có đầu ra. Chi tiết về mức tín dụng của khách hàng tiềm năng.

ContactDetails

Các trường có chứa thông tin liên hệ của người tiêu dùng.

Biểu diễn dưới dạng JSON 
{
  "phoneNumber": string,
  "email": string,
  "consumerName": string
}
Trường
phoneNumber

string

Chỉ có đầu ra. Số điện thoại của người tiêu dùng ở định dạng E164.
email

string

Chỉ có đầu ra. Địa chỉ email của người tiêu dùng.
consumerName

string

Chỉ có đầu ra. Tên người tiêu dùng nếu người tiêu dùng đã cung cấp tên trong biểu mẫu Tin nhắn hoặc Đặt phòng trên google.com

LeadType

Các kiểu khách hàng tiềm năng có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
MESSAGE Khách hàng tiềm năng qua tin nhắn.
PHONE_CALL Khách hàng tiềm năng được tạo bằng cuộc gọi điện thoại.
BOOKING Khách hàng tiềm năng đặt trước.

LeadStatus

Các trạng thái khách hàng tiềm năng có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
NEW Khách hàng tiềm năng mới mà nhà quảng cáo chưa nhìn thấy.
ACTIVE Khách hàng tiềm năng mà nhà quảng cáo đã tương tác.
BOOKED Đã đặt trước khách hàng tiềm năng.
DECLINED Nhà quảng cáo đã từ chối khách hàng tiềm năng.
EXPIRED Khách hàng tiềm năng đã hết hạn do không hoạt động.
DISABLED Bị vô hiệu do spam hoặc tranh chấp.
CONSUMER_DECLINED Người tiêu dùng đã từ chối thông tin khách hàng tiềm năng.
WIPED_OUT Thông tin nhận dạng cá nhân của khách hàng tiềm năng đã bị xoá.

Lưu ý

Đại diện cho một ghi chú do nhà quảng cáo thêm vào khách hàng tiềm năng. Nhà quảng cáo có thể chỉnh sửa ghi chú. Thao tác này sẽ đặt lại thời gian chỉnh sửa và thay đổi nội dung mô tả.

Biểu diễn dưới dạng JSON 
{
  "editDateTime": string,
  "description": string
}
Trường
editDateTime

string

Chỉ có đầu ra. Ngày chỉnh sửa ghi chú về khách hàng tiềm năng. Định dạng là "YYYY-MM-DD HH:MM:SS" theo múi giờ của tài khoản Google Ads. Ví dụ: "2018-03-05 09:15:00" hoặc "2018-02-01 14:34:30"
description

string

Chỉ có đầu ra. Nội dung của ghi chú về khách hàng tiềm năng.

CreditDetails

Thể hiện thông tin chi tiết về giá trị đóng góp của một khách hàng tiềm năng.

Biểu diễn dưới dạng JSON 
{
  "creditState": enum (CreditState),
  "creditStateLastUpdateDateTime": string
}
Trường
creditState

enum (CreditState)

Chỉ có đầu ra. Trạng thái tín dụng của khách hàng tiềm năng.
creditStateLastUpdateDateTime

string

Chỉ có đầu ra. Ngày cập nhật trạng thái tín dụng của khách hàng tiềm năng lần gần đây nhất. Định dạng là "YYYY-MM-DD HH:MM:SS" theo múi giờ của tài khoản Google Ads. Ví dụ: "2018-03-05 09:15:00" hoặc "2018-02-01 14:34:30"

CreditState

Trạng thái tín dụng có thể có của một khách hàng tiềm năng.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
PENDING Khoản tín dụng đang chờ xử lý.
CREDITED Yêu cầu tín dụng đã hoàn tất.

LocalServicesLeadConversation

Dữ liệu từ cuộc trò chuyện của khách hàng tiềm năng Dịch vụ địa phương. Chứa thông tin chi tiết về Cuộc trò chuyện với khách hàng tiềm năng được tạo khi người dùng gọi điện, nhắn tin hoặc mua sách dịch vụ từ nhà quảng cáo. Các thông tin này được thêm vào một Khách hàng tiềm năng. Thông tin khác: https://ads.google.com/local-services-ads

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "id": string,
  "conversationChannel": enum (ConversationType),
  "participantType": enum (ParticipantType),
  "lead": string,
  "eventDateTime": string,
  "phoneCallDetails": {
    object (PhoneCallDetails)
  },
  "messageDetails": {
    object (MessageDetails)
  }
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của dữ liệu về cuộc trò chuyện của khách hàng tiềm năng liên quan đến dịch vụ địa phương. Tên tài nguyên của cuộc trò chuyện với khách hàng tiềm năng của Dịch vụ địa phương có biểu mẫu

customers/{customerId}/localServicesLeadConversation/{local_services_lead_conversation_id}
id

string (int64 format)

Chỉ có đầu ra. Mã của cuộc trò chuyện khách hàng tiềm năng này.
conversationChannel

enum (ConversationType)

Chỉ có đầu ra. Loại cuộc trò chuyện khách hàng tiềm năng trên GLS, EMAIL, MESSAGE, PHONE_CALL, SMS, v.v.
participantType

enum (ParticipantType)

Chỉ có đầu ra. Kiểu người tham gia trong cuộc trò chuyện khách hàng tiềm năng, ADVERTISER hoặc CONSUMER.
lead

string

Chỉ có đầu ra. Tên tài nguyên của Khách hàng tiềm năng được liên kết với Cuộc trò chuyện về khách hàng tiềm năng.
eventDateTime

string

Chỉ có đầu ra. Ngày tạo cuộc trò chuyện của khách hàng tiềm năng do Quảng cáo dịch vụ địa phương tạo. Định dạng là "YYYY-MM-DD HH:MM:SS" theo múi giờ của tài khoản Google Ads. Ví dụ: "2018-03-05 09:15:00" hoặc "2018-02-01 14:34:30"
phoneCallDetails

object (PhoneCallDetails)

Chỉ có đầu ra. Thông tin chi tiết về cuộc trò chuyện cuộc gọi điện thoại trong trường hợp PHONE_CALL.
messageDetails

object (MessageDetails)

Chỉ có đầu ra. Chi tiết về cuộc trò chuyện bằng tin nhắn trong trường hợp EMAIL, MESSAGE hoặc SMS.

ConversationType

Các loại cuộc trò chuyện khách hàng tiềm năng có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
EMAIL Gửi email đến cuộc trò chuyện của khách hàng tiềm năng.
MESSAGE Cuộc trò chuyện qua tin nhắn với khách hàng tiềm năng.
PHONE_CALL Cuộc trò chuyện của khách hàng tiềm năng qua cuộc gọi điện thoại.
SMS Cuộc trò chuyện với khách hàng tiềm năng qua SMS.
BOOKING Lượt trò chuyện đặt trước của khách hàng tiềm năng.

ParticipantType

Những kiểu người tham gia cuộc trò chuyện chính.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
ADVERTISER Người tham gia Nhà cung cấp quảng cáo dịch vụ địa phương.
CONSUMER Người tham gia chương trình Người tiêu dùng tham gia Quảng cáo dịch vụ địa phương.

PhoneCallDetails

Biểu thị thông tin chi tiết về cuộc trò chuyện qua cuộc gọi điện thoại.

Biểu diễn dưới dạng JSON 
{
  "callDurationMillis": string,
  "callRecordingUrl": string
}
Trường
callDurationMillis

string (int64 format)

Chỉ có đầu ra. Thời lượng (tính bằng mili giây) của cuộc gọi điện thoại (từ đầu đến cuối).
callRecordingUrl

string

Chỉ có đầu ra. URL đến tệp âm thanh trong bản ghi âm cuộc gọi.

MessageDetails

Biểu thị các thông tin chi tiết của tin nhắn văn bản trong trường hợp email, tin nhắn hoặc SMS.

Biểu diễn dưới dạng JSON 
{
  "text": string,
  "attachmentUrls": [
    string
  ]
}
Trường
text

string

Chỉ có đầu ra. Nội dung văn bản của tin nhắn.
attachmentUrls[]

string

Chỉ có đầu ra. URL đến tệp đính kèm trong email hoặc SMS. Nhà phát triển có thể dùng các URL này để tải nội dung của tệp đính kèm xuống bằng cách sử dụng mã của nhà phát triển.

AndroidPrivacySharedKeyGoogleAdGroup

Chế độ xem khoá được chia sẻ về quyền riêng tư trên Android cho khoá nhóm quảng cáo của Google.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "campaignId": string,
  "androidPrivacyInteractionType": enum (AndroidPrivacyInteractionType),
  "androidPrivacyInteractionDate": string,
  "androidPrivacyNetworkType": enum (AndroidPrivacyNetworkType),
  "adGroupId": string,
  "sharedAdGroupKey": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của khoá dùng chung về quyền riêng tư trên Android. Tên tài nguyên chính dùng chung về quyền riêng tư trên Android có dạng như sau:

customers/{customerId}/androidPrivacySharedKeyGoogleAdGroups/{campaignId}~{adGroupId}~{androidPrivacyInteractionType}~{androidPrivacyNetworkType}~{androidPrivacyInteractionDate(yyyy-mm-dd)}
campaignId

string (int64 format)

Chỉ có đầu ra. Mã chiến dịch được sử dụng trong mã hoá khoá chia sẻ.
androidPrivacyInteractionType

enum (AndroidPrivacyInteractionType)

Chỉ có đầu ra. Enum loại tương tác được dùng trong mã hoá khoá chia sẻ.
androidPrivacyInteractionDate

string

Chỉ có đầu ra. Ngày tương tác được dùng trong phương thức mã hoá khoá dùng chung theo định dạng "YYYY-MM-DD" theo múi giờ UTC.
androidPrivacyNetworkType

enum (AndroidPrivacyNetworkType)

Chỉ có đầu ra. Enum loại mạng được dùng trong mã hoá khoá chia sẻ.
adGroupId

string (int64 format)

Chỉ có đầu ra. Mã nhóm quảng cáo được sử dụng trong mã hoá khoá chia sẻ.
sharedAdGroupKey

string

Chỉ có đầu ra. Chuỗi hex 128 bit của khoá nhóm quảng cáo dùng chung được mã hoá, bao gồm cả "0x" tiền tố. Bạn có thể dùng khoá này để thực hiện toán tử bitwise OR với khoá chuyển đổi tổng hợp nhằm tạo khoá tổng hợp đầy đủ nhằm truy xuất Báo cáo API tổng hợp trong Hộp cát về quyền riêng tư của Android.

AndroidPrivacyInteractionType

Liệt kê các loại tương tác

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Phiên bản này không xác định được giá trị.
CLICK Loại tương tác nhấp chuột vật lý.
ENGAGED_VIEW Loại tương tác lượt xem được thực hiện 10 giây.
VIEW Loại tương tác xem (lượt hiển thị quảng cáo).

AndroidPrivacyNetworkType

Liệt kê các loại mạng

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Phiên bản này không xác định được giá trị.
SEARCH Mạng tìm kiếm.
DISPLAY Mạng hiển thị
YOUTUBE Mạng YouTube.

AndroidPrivacySharedKeyGoogleCampaign

Chế độ xem khoá được chia sẻ về quyền riêng tư trên Android cho khoá chiến dịch trên Google.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "campaignId": string,
  "androidPrivacyInteractionType": enum (AndroidPrivacyInteractionType),
  "androidPrivacyInteractionDate": string,
  "sharedCampaignKey": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của khoá dùng chung về quyền riêng tư trên Android. Tên tài nguyên chính dùng chung về quyền riêng tư trên Android có dạng như sau:

customers/{customerId}/androidPrivacySharedKeyGoogleCampaigns/{campaignId}~{androidPrivacyInteractionType}~{androidPrivacyInteractionDate(yyyy-mm-dd)}
campaignId

string (int64 format)

Chỉ có đầu ra. Mã chiến dịch được sử dụng trong mã hoá khoá chia sẻ.
androidPrivacyInteractionType

enum (AndroidPrivacyInteractionType)

Chỉ có đầu ra. Enum loại tương tác được dùng trong mã hoá khoá chia sẻ.
androidPrivacyInteractionDate

string

Chỉ có đầu ra. Ngày tương tác được dùng trong phương thức mã hoá khoá dùng chung theo định dạng "YYYY-MM-DD" theo múi giờ UTC.
sharedCampaignKey

string

Chỉ có đầu ra. Chuỗi hex 128 bit của khoá chiến dịch dùng chung được mã hoá, bao gồm cả "0x" tiền tố. Bạn có thể dùng khoá này để thực hiện toán tử bitwise OR với khoá chuyển đổi tổng hợp nhằm tạo khoá tổng hợp đầy đủ nhằm truy xuất Báo cáo API tổng hợp trong Hộp cát về quyền riêng tư của Android.

AndroidPrivacySharedKeyGoogleNetworkType

Chế độ xem khoá được chia sẻ về quyền riêng tư trên Android cho khoá loại mạng của Google.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "campaignId": string,
  "androidPrivacyInteractionType": enum (AndroidPrivacyInteractionType),
  "androidPrivacyInteractionDate": string,
  "androidPrivacyNetworkType": enum (AndroidPrivacyNetworkType),
  "sharedNetworkTypeKey": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của khoá dùng chung về quyền riêng tư trên Android. Tên tài nguyên chính dùng chung về quyền riêng tư trên Android có dạng như sau:

customers/{customerId}/androidPrivacySharedKeyGoogleNetworkTypes/{campaignId}~{androidPrivacyInteractionType}~{androidPrivacyNetworkType}~{androidPrivacyInteractionDate(yyyy-mm-dd)}
campaignId

string (int64 format)

Chỉ có đầu ra. Mã chiến dịch được sử dụng trong mã hoá khoá chia sẻ.
androidPrivacyInteractionType

enum (AndroidPrivacyInteractionType)

Chỉ có đầu ra. Enum loại tương tác được dùng trong mã hoá khoá chia sẻ.
androidPrivacyInteractionDate

string

Chỉ có đầu ra. Ngày tương tác được dùng trong phương thức mã hoá khoá dùng chung theo định dạng "YYYY-MM-DD" theo múi giờ UTC.
androidPrivacyNetworkType

enum (AndroidPrivacyNetworkType)

Chỉ có đầu ra. Enum loại mạng được dùng trong mã hoá khoá chia sẻ.
sharedNetworkTypeKey

string

Chỉ có đầu ra. Chuỗi hex 128 bit của khoá loại mạng dùng chung được mã hoá, bao gồm cả "0x" tiền tố. Bạn có thể dùng khoá này để thực hiện toán tử bitwise OR với khoá chuyển đổi tổng hợp nhằm tạo khoá tổng hợp đầy đủ nhằm truy xuất Báo cáo API tổng hợp trong Hộp cát về quyền riêng tư của Android.

Chỉ số

Dữ liệu về chỉ số.

Biểu diễn dưới dạng JSON 
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "skAdNetworkInstalls": string,
  "skAdNetworkTotalConversions": string,
  "publisherPurchasedClicks": string,
  "publisherOrganicClicks": string,
  "publisherUnknownClicks": string,
  "absoluteTopImpressionPercentage": number,
  "activeViewCpm": number,
  "activeViewCtr": number,
  "activeViewImpressions": string,
  "activeViewMeasurability": number,
  "activeViewMeasurableCostMicros": string,
  "activeViewMeasurableImpressions": string,
  "activeViewViewability": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allNewCustomerLifetimeValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "allConversionsFromStoreWebsite": number,
  "auctionInsightSearchAbsoluteTopImpressionPercentage": number,
  "auctionInsightSearchImpressionShare": number,
  "auctionInsightSearchOutrankingShare": number,
  "auctionInsightSearchOverlapRate": number,
  "auctionInsightSearchPositionAboveRate": number,
  "auctionInsightSearchTopImpressionPercentage": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpe": number,
  "averageCpm": number,
  "averageCpv": number,
  "averagePageViews": number,
  "averageTimeOnSite": number,
  "benchmarkAverageMaxCpc": number,
  "biddableAppInstallConversions": number,
  "biddableAppPostInstallConversions": number,
  "benchmarkCtr": number,
  "bounceRate": number,
  "clicks": string,
  "combinedClicks": string,
  "combinedClicksPerQuery": number,
  "combinedQueries": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "conversionLastReceivedRequestDateTime": string,
  "conversionLastConversionDate": string,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "conversionsValue": number,
  "newCustomerLifetimeValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "conversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsValueMicros": string,
  "ctr": number,
  "currentModelAttributedConversions": number,
  "currentModelAttributedConversionsFromInteractionsRate": number,
  "currentModelAttributedConversionsFromInteractionsValuePerInteraction": number,
  "currentModelAttributedConversionsValue": number,
  "currentModelAttributedConversionsValuePerCost": number,
  "engagementRate": number,
  "engagements": string,
  "hotelAverageLeadValueMicros": number,
  "hotelCommissionRateMicros": string,
  "hotelExpectedCommissionCost": number,
  "hotelPriceDifferencePercentage": number,
  "hotelEligibleImpressions": string,
  "historicalQualityScore": string,
  "gmailForwards": string,
  "gmailSaves": string,
  "gmailSecondaryClicks": string,
  "impressionsFromStoreReach": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "messageChats": string,
  "messageImpressions": string,
  "messageChatRate": number,
  "mobileFriendlyClicksPercentage": number,
  "optimizationScoreUplift": number,
  "optimizationScoreUrl": string,
  "organicClicks": string,
  "organicClicksPerQuery": number,
  "organicImpressions": string,
  "organicImpressionsPerQuery": number,
  "organicQueries": string,
  "percentNewVisitors": number,
  "phoneCalls": string,
  "phoneImpressions": string,
  "phoneThroughRate": number,
  "relativeCtr": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "searchVolume": {
    object (SearchVolumeRange)
  },
  "speedScore": string,
  "averageTargetCpaMicros": string,
  "averageTargetRoas": number,
  "topImpressionPercentage": number,
  "validAcceleratedMobilePagesClicksPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "valuePerCurrentModelAttributedConversion": number,
  "videoQuartileP100Rate": number,
  "videoQuartileP25Rate": number,
  "videoQuartileP50Rate": number,
  "videoQuartileP75Rate": number,
  "videoViewRate": number,
  "videoViews": string,
  "viewThroughConversions": string,
  "allConversionsFromLocationAssetClickToCall": number,
  "allConversionsFromLocationAssetDirections": number,
  "allConversionsFromLocationAssetMenu": number,
  "allConversionsFromLocationAssetOrder": number,
  "allConversionsFromLocationAssetOtherEngagement": number,
  "allConversionsFromLocationAssetStoreVisits": number,
  "allConversionsFromLocationAssetWebsite": number,
  "eligibleImpressionsFromLocationAssetStoreReach": string,
  "viewThroughConversionsFromLocationAssetClickToCall": number,
  "viewThroughConversionsFromLocationAssetDirections": number,
  "viewThroughConversionsFromLocationAssetMenu": number,
  "viewThroughConversionsFromLocationAssetOrder": number,
  "viewThroughConversionsFromLocationAssetOtherEngagement": number,
  "viewThroughConversionsFromLocationAssetStoreVisits": number,
  "viewThroughConversionsFromLocationAssetWebsite": number,
  "orders": number,
  "averageOrderValueMicros": string,
  "averageCartSize": number,
  "costOfGoodsSoldMicros": string,
  "grossProfitMicros": string,
  "grossProfitMargin": number,
  "revenueMicros": string,
  "unitsSold": number,
  "crossSellCostOfGoodsSoldMicros": string,
  "crossSellGrossProfitMicros": string,
  "crossSellRevenueMicros": string,
  "crossSellUnitsSold": number,
  "leadCostOfGoodsSoldMicros": string,
  "leadGrossProfitMicros": string,
  "leadRevenueMicros": string,
  "leadUnitsSold": number,
  "uniqueUsers": string,
  "averageImpressionFrequencyPerUser": number
}
Trường
allConversionsValueByConversionDate

number

Giá trị của tất cả lượt chuyển đổi. Khi bạn chọn cột này có ngày, các giá trị trong cột ngày có nghĩa là ngày chuyển đổi. Thông tin chi tiết về các cột by_conversion_date có tại https://support.google.com/google-ads/answer/9549009.
allConversionsByConversionDate

number

Tổng số lần chuyển đổi. Chỉ số này bao gồm tất cả các lượt chuyển đổi bất kể giá trị của includeInConversionsMetric. Khi bạn chọn cột này có ngày, các giá trị trong cột ngày có nghĩa là ngày chuyển đổi. Thông tin chi tiết về các cột by_conversion_date có tại https://support.google.com/google-ads/answer/9549009.
conversionsValueByConversionDate

number

Giá trị của lượt chuyển đổi. Chỉ bao gồm những hành động chuyển đổi có thuộc tính includeInConversionsMetric được đặt thành true. Nếu bạn sử dụng chiến lược đặt giá thầu dựa trên lượt chuyển đổi, thì các chiến lược giá thầu của bạn sẽ tối ưu hoá cho những lượt chuyển đổi này. Khi bạn chọn cột này có ngày, các giá trị trong cột ngày có nghĩa là ngày chuyển đổi. Thông tin chi tiết về các cột by_conversion_date có tại https://support.google.com/google-ads/answer/9549009.
conversionsByConversionDate

number

Số chuyển đổi. Chỉ số này chỉ bao gồm những hành động chuyển đổi có thuộc tính includeInConversionsMetric được đặt thành true. Nếu bạn sử dụng chiến lược đặt giá thầu dựa trên lượt chuyển đổi, thì các chiến lược giá thầu của bạn sẽ tối ưu hoá cho những lượt chuyển đổi này. Khi bạn chọn cột này có ngày, các giá trị trong cột ngày có nghĩa là ngày chuyển đổi. Thông tin chi tiết về các cột by_conversion_date có tại https://support.google.com/google-ads/answer/9549009.
historicalCreativeQualityScore

enum (QualityScoreBucket)

Điểm chất lượng của mẫu quảng cáo trước đây.
historicalLandingPageQualityScore

enum (QualityScoreBucket)

Chất lượng của trải nghiệm trang đích trước đây.
historicalSearchPredictedCtr

enum (QualityScoreBucket)

Tỷ lệ nhấp (CTR) được dự đoán trong tìm kiếm trong quá khứ.
interactionEventTypes[]

enum (InteractionEventType)

Các loại tương tác có thể thanh toán và miễn phí.
skAdNetworkInstalls

string (int64 format)

Số lượt chuyển đổi trên Mạng quảng cáo của Bộ công cụ dành cho iOS.
skAdNetworkTotalConversions

string (int64 format)

Tổng số lượt chuyển đổi trên Mạng quảng cáo Bộ công cụ iOS Store.
publisherPurchasedClicks

string (int64 format)

Số lượt nhấp trên những tài sản không thuộc quyền sở hữu của nhà xuất bản từ lưu lượng truy cập mà nhà xuất bản đã trả phí để có được hoặc đã nhận được thông qua hoạt động khuyến khích
publisherOrganicClicks

string (int64 format)

Số lượt nhấp trên những tài sản nhận được lưu lượng truy cập mà nhà xuất bản không trả phí hoặc có được thông qua hoạt động có tặng thưởng
publisherUnknownClicks

string (int64 format)

Lượt nhấp từ lưu lượng truy cập không được xác định là "Nhà xuất bản đã mua" hoặc "Nhà xuất bản không phải trả tiền"
absoluteTopImpressionPercentage

number

Tỷ lệ hiển thị ở vị trí đầu tiên trên Mạng Tìm kiếm là tỷ lệ phần trăm lượt hiển thị quảng cáo Tìm kiếm tại vị trí nổi bật nhất trên Mạng Tìm kiếm.
activeViewCpm

number

Chi phí trung bình của số lượt hiển thị có thể xem (activeViewImpressions).
activeViewCtr

number

Số nhấp chuột có thể đo lường của Chế độ xem đang kích hoạt chia cho số lần hiển thị có thể xem của chế độ xem đang kích hoạt.

Chỉ số này chỉ được báo cáo cho Mạng Hiển thị.
activeViewImpressions

string (int64 format)

Đo lường tần suất quảng cáo của bạn có thể xem trên trang web Mạng hiển thị.
activeViewMeasurability

number

Tỷ lệ số lượt hiển thị mà Chế độ xem đang kích hoạt có thể đo lường trên số lượt hiển thị đã phân phát.
activeViewMeasurableCostMicros

string (int64 format)

Chi phí của số lượt hiển thị mà bạn nhận được có thể đo lường bằng Chế độ xem đang kích hoạt.
activeViewMeasurableImpressions

string (int64 format)

Số lần quảng cáo của bạn xuất hiện trên các vị trí mà chúng có thể được xem.
activeViewViewability

number

Phần trăm thời gian khi quảng cáo của bạn đã xuất hiện trên trang web có bật Chế độ xem đang kích hoạt (số lần hiển thị có thể đo lường) và có thể xem (số lần hiển thị có thể xem).
allConversionsFromInteractionsRate

number

Tất cả lượt chuyển đổi từ lượt tương tác (trái ngược với lượt chuyển đổi từ lượt xem hết) chia cho số lượt tương tác với quảng cáo.
allConversionsValue

number

Giá trị của tất cả lượt chuyển đổi.
allNewCustomerLifetimeValue

number

Tất cả khách hàng mới giá trị chuyển đổi lâu dài của bạn. Nếu bạn đã thiết lập mục tiêu thu nạp khách hàng ở cấp tài khoản hoặc cấp chiến dịch, thì giá trị này sẽ bao gồm giá trị lượt chuyển đổi bổ sung từ khách hàng mới đối với cả lượt chuyển đổi có thể đặt giá thầu và không thể đặt giá thầu. Nếu chiến dịch của bạn đã sử dụng mục tiêu thu nạp khách hàng và chọn "đặt giá thầu cao hơn cho khách hàng mới", thì các giá trị này sẽ được đưa vào "allConversionsValue". Hãy xem https://support.google.com/google-ads/answer/12080169 để biết thêm chi tiết.
allConversions

number

Tổng số lần chuyển đổi. Số liệu này bao gồm tất cả các lượt chuyển đổi bất kể giá trị của includeInConversionsMetric.
allConversionsValuePerCost

number

Giá trị của tất cả lượt chuyển đổi chia cho tổng chi phí của các lượt tương tác với quảng cáo (chẳng hạn như số lượt nhấp đối với quảng cáo dạng văn bản hoặc số lượt xem đối với quảng cáo dạng video).
allConversionsFromClickToCall

number

Số lần mọi người nhấp vào nút "Gọi" để gọi cửa hàng trong hoặc sau khi nhấp vào quảng cáo. Số liệu này không cho biết cuộc gọi có được kết nối hay không hoặc thời lượng của cuộc gọi.

Chỉ số này chỉ áp dụng cho các mục trong nguồn cấp dữ liệu.
allConversionsFromDirections

number

Số lần người dùng nhấp vào nút "Xem đường đi" để điều hướng đến cửa hàng sau khi nhấp vào quảng cáo.

Chỉ số này chỉ áp dụng cho các mục trong nguồn cấp dữ liệu.
allConversionsFromInteractionsValuePerInteraction

number

Giá trị của tất cả các lượt chuyển đổi từ các lượt tương tác chia cho tổng số lượt tương tác.
allConversionsFromMenu

number

Số lần người dùng nhấp vào đường liên kết để xem thực đơn của một cửa hàng sau khi nhấp vào quảng cáo.

Chỉ số này chỉ áp dụng cho các mục trong nguồn cấp dữ liệu.
allConversionsFromOrder

number

Số lần mọi người đặt hàng tại một cửa hàng sau khi nhấp vào quảng cáo.

Chỉ số này chỉ áp dụng cho các mục trong nguồn cấp dữ liệu.
allConversionsFromOtherEngagement

number

Số lượt chuyển đổi khác (ví dụ: đăng bài đánh giá hoặc lưu vị trí của cửa hàng) xảy ra sau khi người dùng nhấp vào quảng cáo.

Chỉ số này chỉ áp dụng cho các mục trong nguồn cấp dữ liệu.
allConversionsFromStoreVisit

number

Số lần ước tính mọi người đã ghé qua cửa hàng sau khi nhấp vào quảng cáo.

Chỉ số này chỉ áp dụng cho các mục trong nguồn cấp dữ liệu.
allConversionsFromStoreWebsite

number

Số lần mọi người được đưa đến URL của một cửa hàng sau khi nhấp vào quảng cáo.

Chỉ số này chỉ áp dụng cho các mục trong nguồn cấp dữ liệu.
auctionInsightSearchAbsoluteTopImpressionPercentage

number

Chỉ số này là một phần của báo cáo Thông tin chi tiết về phiên đấu giá và cho biết tần suất quảng cáo của một người tham gia khác hiển thị ở vị trí nổi bật nhất trên trang kết quả tìm kiếm. Tỷ lệ phần trăm này chỉ được tính trong các phiên đấu giá mà bạn đã xuất hiện trên trang.

Chỉ số này không công khai.
auctionInsightSearchImpressionShare

number

Chỉ số này là một phần của báo cáo Thông tin chi tiết về phiên đấu giá. Chỉ số này cho biết tỷ lệ phần trăm số lượt hiển thị mà một người tham gia khác nhận được trên tổng số lượt hiển thị mà quảng cáo của bạn đủ điều kiện. Bất kỳ giá trị nào dưới 0,1 được báo cáo là 0,0999.

Chỉ số này không công khai.
auctionInsightSearchOutrankingShare

number

Chỉ số này là một phần của báo cáo Thông tin chi tiết về phiên đấu giá và cho biết tỷ lệ phần trăm số lượt hiển thị mà quảng cáo của bạn đã được xếp hạng cao hơn (hiển thị ở trên) một người tham gia khác trong phiên đấu giá, so với tổng số lần hiển thị mà quảng cáo của bạn đủ điều kiện. Bất kỳ giá trị nào dưới 0,1 được báo cáo là 0,0999.

Chỉ số này không công khai.
auctionInsightSearchOverlapRate

number

Chỉ số này là một phần của báo cáo Thông tin chi tiết về phiên đấu giá và cho biết tần suất quảng cáo của một người tham gia khác nhận được hiển thị khi quảng cáo của bạn cũng nhận được hiển thị.

Chỉ số này không công khai.
auctionInsightSearchPositionAboveRate

number

Chỉ số này là một phần của báo cáo Thông tin chi tiết về phiên đấu giá và cho biết tần suất quảng cáo của một người tham gia khác đã được hiển thị ở vị trí cao hơn quảng cáo của bạn, khi cả hai quảng cáo của bạn được hiển thị trên cùng một trang.

Chỉ số này không công khai.
auctionInsightSearchTopImpressionPercentage

number

Chỉ số này là một phần của báo cáo Thông tin chi tiết về phiên đấu giá và cho biết tần suất quảng cáo của một người tham gia khác hiển thị bên cạnh kết quả tìm kiếm tự nhiên hàng đầu. Tỷ lệ phần trăm này chỉ được tính trong các phiên đấu giá mà bạn đã xuất hiện trên trang.

Chỉ số này không công khai.
averageCost

number

Số tiền trung bình mà bạn trả cho mỗi lượt tương tác. Số tiền này là tổng chi phí quảng cáo của bạn chia cho tổng số lần tương tác.
averageCpc

number

Tổng chi phí của tất cả lượt nhấp chia cho tổng số lượt nhấp đã nhận được.
averageCpe

number

Số tiền trung bình mà bạn bị tính phí cho một lượt tương tác với quảng cáo. Số tiền này là tổng chi phí của tất cả lượt tương tác với quảng cáo chia cho tổng số lượt tương tác với quảng cáo.
averageCpm

number

Chi phí trung bình cho mỗi nghìn lượt hiển thị (CPM).
averageCpv

number

Số tiền trung bình bạn trả mỗi khi ai đó xem quảng cáo của bạn. CPV trung bình được xác định bởi tổng chi phí của tất cả các lần xem quảng cáo chia cho số lần xem.

averagePageViews

number

Số trang trung bình được xem trên mỗi phiên.
averageTimeOnSite

number

Tổng thời lượng của tất cả các phiên (tính bằng giây) / số phiên. Được nhập từ Google Analytics.
benchmarkAverageMaxCpc

number

Chỉ báo về cách các nhà quảng cáo khác đang đặt giá thầu cho các sản phẩm tương tự.
biddableAppInstallConversions

number

Số lượt cài đặt ứng dụng.
biddableAppPostInstallConversions

number

Số hành động trong ứng dụng.
benchmarkCtr

number

Chỉ báo về cách các nhà quảng cáo khác Quảng cáo mua sắm cho các sản phẩm tương tự đang hoạt động dựa trên tần suất người dùng nhìn thấy quảng cáo của họ nhấp vào quảng cáo đó.
bounceRate

number

Tỷ lệ phần trăm lượt nhấp mà người dùng chỉ truy cập vào một trang duy nhất trên trang web của bạn. Được nhập từ Google Analytics.
clicks

string (int64 format)

Số lượt nhấp.
combinedClicks

string (int64 format)

Số lần người dùng nhấp vào quảng cáo hoặc trang thông tin của trang web của bạn trong các kết quả không tính phí. Hãy xem trang trợ giúp tại https://support.google.com/google-ads/answer/3097241 để biết thông tin chi tiết.
combinedClicksPerQuery

number

Số lần nhấp vào quảng cáo hoặc trang web của bạn trong kết quả không tính phí (combinedClicks) chia cho kết hợpTruy vấn. Hãy xem trang trợ giúp tại https://support.google.com/google-ads/answer/3097241 để biết thông tin chi tiết.
combinedQueries

string (int64 format)

Số lượt tìm kiếm trả về các trang từ trang web của bạn trong kết quả không tính phí hoặc cho thấy một trong các quảng cáo dạng văn bản của bạn. Hãy xem trang trợ giúp tại https://support.google.com/google-ads/answer/3097241 để biết thông tin chi tiết.
contentBudgetLostImpressionShare

number

Tỷ lệ phần trăm ước tính số lần quảng cáo của bạn đủ điều kiện hiển thị trên Mạng Hiển thị nhưng đã không hiển thị vì ngân sách quá thấp. Lưu ý: Tỷ lệ hiển thị bị mất do ngân sách nội dung được báo cáo trong khoảng từ 0 đến 0,9. Bất kỳ giá trị nào lớn hơn 0,9 đều được báo cáo là 0,9001.
contentImpressionShare

number

Số lượt hiển thị mà bạn đã nhận được trên Mạng Hiển thị chia cho số lượt hiển thị ước tính mà bạn đủ điều kiện để nhận. Lưu ý: Tỷ lệ hiển thị nội dung được báo cáo trong khoảng 0,1 đến 1. Bất kỳ giá trị nào dưới 0,1 được báo cáo là 0,0999.
conversionLastReceivedRequestDateTime

string

Ngày/giờ gần đây nhất của một thẻ chuyển đổi cho hành động chuyển đổi này đã được kích hoạt thành công và Google Ads đã xem được. Sự kiện kích hoạt này có thể không phải là kết quả của một lượt chuyển đổi có thể phân bổ (ví dụ: vì thẻ được kích hoạt từ một trình duyệt trước đó chưa từng nhấp vào quảng cáo của một nhà quảng cáo thích hợp). Ngày/giờ được đặt theo múi giờ của khách hàng.
conversionLastConversionDate

string

Ngày xảy ra lượt chuyển đổi gần đây nhất cho hành động chuyển đổi này. Ngày được tính theo múi giờ của khách hàng.
contentRankLostImpressionShare

number

Phần trăm hiển thị ước tính trên Mạng hiển thị mà quảng cáo của bạn không nhận được do Xếp hạng quảng cáo thấp. Lưu ý: Tỷ lệ hiển thị bị mất theo thứ hạng nội dung được báo cáo trong khoảng từ 0 đến 0,9. Bất kỳ giá trị nào lớn hơn 0,9 đều được báo cáo là 0,9001.
conversionsFromInteractionsRate

number

Lượt chuyển đổi từ lượt tương tác chia cho số lượt tương tác với quảng cáo (chẳng hạn như lượt nhấp đối với quảng cáo dạng văn bản hoặc lượt xem đối với quảng cáo dạng video). Chỉ bao gồm những hành động chuyển đổi có thuộc tính includeInConversionsMetric được đặt thành true. Nếu bạn sử dụng chiến lược đặt giá thầu dựa trên lượt chuyển đổi, thì các chiến lược giá thầu của bạn sẽ tối ưu hoá cho những lượt chuyển đổi này.
conversionsValue

number

Giá trị của lượt chuyển đổi. Chỉ bao gồm những hành động chuyển đổi có thuộc tính includeInConversionsMetric được đặt thành true. Nếu bạn sử dụng chiến lược đặt giá thầu dựa trên lượt chuyển đổi, thì các chiến lược giá thầu của bạn sẽ tối ưu hoá cho những lượt chuyển đổi này.
newCustomerLifetimeValue

number

Số lượng khách hàng mới giá trị chuyển đổi lâu dài của bạn. Nếu bạn đã thiết lập mục tiêu thu nạp khách hàng ở cấp tài khoản hoặc cấp chiến dịch, thì giá trị này sẽ bao gồm giá trị lượt chuyển đổi bổ sung từ khách hàng mới cho các lượt chuyển đổi có thể đặt giá thầu. Nếu chiến dịch của bạn đã sử dụng mục tiêu thu nạp khách hàng và chọn "đặt giá thầu cao hơn cho khách hàng mới", thì các giá trị này sẽ được đưa vào "conversionsValue" để tối ưu hoá. Hãy xem https://support.google.com/google-ads/answer/12080169 để biết thêm chi tiết.
conversionsValuePerCost

number

Giá trị của số lượt chuyển đổi chia cho chi phí của các lượt tương tác với quảng cáo. Chỉ bao gồm những hành động chuyển đổi có thuộc tính includeInConversionsMetric được đặt thành true. Nếu bạn sử dụng chiến lược đặt giá thầu dựa trên lượt chuyển đổi, thì các chiến lược giá thầu của bạn sẽ tối ưu hoá cho những lượt chuyển đổi này.
conversionsFromInteractionsValuePerInteraction

number

Giá trị chuyển đổi từ số lần tương tác chia cho số lần tương tác với quảng cáo. Chỉ số này chỉ bao gồm những hành động chuyển đổi có thuộc tính includeInConversionsMetric được đặt thành true. Nếu bạn sử dụng chiến lược đặt giá thầu dựa trên lượt chuyển đổi, thì các chiến lược giá thầu của bạn sẽ tối ưu hoá cho những lượt chuyển đổi này.
conversions

number

Số chuyển đổi. Chỉ bao gồm những hành động chuyển đổi có thuộc tính includeInConversionsMetric được đặt thành true. Nếu bạn sử dụng chiến lược đặt giá thầu dựa trên lượt chuyển đổi, thì các chiến lược giá thầu của bạn sẽ tối ưu hoá cho những lượt chuyển đổi này.
costMicros

string (int64 format)

Tổng chi phí chi phí mỗi lượt nhấp (CPC) và chi phí mỗi nghìn lượt hiển thị (CPM) trong khoảng thời gian này.
costPerAllConversions

number

Chi phí của các lượt tương tác với quảng cáo chia cho tất cả các lượt chuyển đổi.
costPerConversion

number

Chi phí của số lượt tương tác với quảng cáo chia cho số lượt chuyển đổi. Chỉ bao gồm những hành động chuyển đổi có thuộc tính includeInConversionsMetric được đặt thành true. Nếu bạn sử dụng chiến lược đặt giá thầu dựa trên lượt chuyển đổi, thì các chiến lược giá thầu của bạn sẽ tối ưu hoá cho những lượt chuyển đổi này.
costPerCurrentModelAttributedConversion

number

Chi phí của các lượt tương tác với quảng cáo chia cho số lượt chuyển đổi được phân bổ của mô hình hiện tại. Chỉ bao gồm những hành động chuyển đổi có thuộc tính includeInConversionsMetric được đặt thành true. Nếu bạn sử dụng chiến lược đặt giá thầu dựa trên lượt chuyển đổi, thì các chiến lược giá thầu của bạn sẽ tối ưu hoá cho những lượt chuyển đổi này.
crossDeviceConversions

number

Lượt chuyển đổi khi một khách hàng nhấp vào quảng cáo Google Ads trên một thiết bị, sau đó chuyển đổi trên một thiết bị hoặc trình duyệt khác. Lượt chuyển đổi thiết bị chéo đã được đưa vào tất cả lượt chuyển đổi.
crossDeviceConversionsValueMicros

string (int64 format)

Tổng giá trị của các lượt chuyển đổi trên nhiều thiết bị, tính bằng micrô giây.
ctr

number

Số lượt nhấp mà quảng cáo của bạn nhận được (Số lượt nhấp) chia cho số lần quảng cáo được hiển thị (Số lượt hiển thị).
currentModelAttributedConversions

number

Cho biết dữ liệu lượt chuyển đổi trước đây của bạn sẽ trông như thế nào trong mô hình phân bổ mà bạn hiện đang chọn. Chỉ bao gồm những hành động chuyển đổi có thuộc tính includeInConversionsMetric được đặt thành true. Nếu bạn sử dụng chiến lược đặt giá thầu dựa trên lượt chuyển đổi, thì các chiến lược giá thầu của bạn sẽ tối ưu hoá cho những lượt chuyển đổi này.
currentModelAttributedConversionsFromInteractionsRate

number

Mô hình hiện tại là số lượt chuyển đổi được phân bổ từ các lượt tương tác chia cho số lượt tương tác với quảng cáo (chẳng hạn như lượt nhấp đối với quảng cáo dạng văn bản hoặc lượt xem đối với quảng cáo dạng video). Chỉ bao gồm những hành động chuyển đổi có thuộc tính includeInConversionsMetric được đặt thành true. Nếu bạn sử dụng chiến lược đặt giá thầu dựa trên lượt chuyển đổi, thì các chiến lược giá thầu của bạn sẽ tối ưu hoá cho những lượt chuyển đổi này.
currentModelAttributedConversionsFromInteractionsValuePerInteraction

number

Giá trị của các lượt chuyển đổi được phân bổ trong mô hình hiện tại từ các lượt tương tác chia cho số lượt tương tác với quảng cáo. Chỉ bao gồm những hành động chuyển đổi có thuộc tính includeInConversionsMetric được đặt thành true. Nếu bạn sử dụng chiến lược đặt giá thầu dựa trên lượt chuyển đổi, thì các chiến lược giá thầu của bạn sẽ tối ưu hoá cho những lượt chuyển đổi này.
currentModelAttributedConversionsValue

number

Giá trị của các lượt chuyển đổi phân bổ hiện tại của mô hình. Chỉ bao gồm những hành động chuyển đổi có thuộc tính includeInConversionsMetric được đặt thành true. Nếu bạn sử dụng chiến lược đặt giá thầu dựa trên lượt chuyển đổi, thì các chiến lược giá thầu của bạn sẽ tối ưu hoá cho những lượt chuyển đổi này.
currentModelAttributedConversionsValuePerCost

number

Giá trị của các lượt chuyển đổi được phân bổ theo mô hình hiện tại chia cho chi phí của các lượt tương tác với quảng cáo. Chỉ bao gồm những hành động chuyển đổi có thuộc tính includeInConversionsMetric được đặt thành true. Nếu bạn sử dụng chiến lược đặt giá thầu dựa trên lượt chuyển đổi, thì các chiến lược giá thầu của bạn sẽ tối ưu hoá cho những lượt chuyển đổi này.
engagementRate

number

Tần suất mọi người tương tác với quảng cáo của bạn sau khi quảng cáo đó hiển thị cho họ. Đây là số lần mở rộng quảng cáo chia cho số lần quảng cáo của bạn hiển thị.
engagements

string (int64 format)

Số lượt tương tác. Một lần tương tác xảy ra khi một người xem mở rộng quảng cáo Hộp đèn của bạn. Ngoài ra, trong tương lai, các loại quảng cáo khác có thể hỗ trợ chỉ số tương tác.
hotelAverageLeadValueMicros

number

Giá trị khách hàng tiềm năng trung bình dựa trên số lượt nhấp.
hotelCommissionRateMicros

string (int64 format)

Tỷ lệ giá thầu phí hoa hồng tính bằng phần triệu. Tỷ lệ hoa hồng 20% tương đương 200.000 đồng.
hotelExpectedCommissionCost

number

Chi phí hoa hồng dự kiến. Kết quả của việc nhân giá trị phí hoa hồng nhân với giá trị của Hotel_commission_rate tính theo đơn vị tiền tệ của nhà quảng cáo.
hotelPriceDifferencePercentage

number

Mức chênh lệch giá trung bình giữa giá do nhà quảng cáo khách sạn báo cáo cung cấp và giá thấp nhất do nhà quảng cáo cạnh tranh cung cấp.
hotelEligibleImpressions

string (int64 format)

Số lượt hiển thị mà đối tác khách sạn lẽ ra đã có thể nhận được dựa trên hiệu suất của nguồn cấp dữ liệu.
historicalQualityScore

string (int64 format)

Điểm chất lượng trong quá khứ.
gmailForwards

string (int64 format)

Số lần quảng cáo được chuyển tiếp đến người khác dưới dạng tin nhắn.
gmailSaves

string (int64 format)

Số lần ai đó đã lưu quảng cáo Gmail của bạn vào hộp thư đến của họ dưới dạng thư.
gmailSecondaryClicks

string (int64 format)

Số lần nhấp vào trang đích ở trạng thái mở rộng của quảng cáo Gmail.
impressionsFromStoreReach

string (int64 format)

Số lượt hiển thị quảng cáo dựa trên vị trí của cửa hàng.

Chỉ số này chỉ áp dụng cho các mục trong nguồn cấp dữ liệu.
impressions

string (int64 format)

Đếm tần suất quảng cáo của bạn đã xuất hiện trên trang kết quả tìm kiếm hoặc trang web trên Mạng Google.
interactionRate

number

Tần suất mọi người tương tác với quảng cáo của bạn sau khi quảng cáo đó hiển thị cho họ. Đây là số lần tương tác chia cho số lần quảng cáo của bạn được hiển thị.
interactions

string (int64 format)

Số lượt tương tác. Tương tác là hành động chính của người dùng được liên kết với một định dạng quảng cáo – lượt nhấp đối với quảng cáo dạng văn bản và quảng cáo mua sắm, lượt xem đối với quảng cáo dạng video, v.v.
invalidClickRate

number

Tỷ lệ phần trăm số lượt nhấp được lọc ra khỏi tổng số lượt nhấp (số lượt nhấp đã lọc + số lượt nhấp chưa được lọc) trong kỳ báo cáo.
invalidClicks

string (int64 format)

Số lượt nhấp mà Google coi là bất hợp pháp và không bị tính phí.
messageChats

string (int64 format)

Số cuộc trò chuyện qua tin nhắn được bắt đầu cho các lượt hiển thị Nhấp để nhắn tin đủ điều kiện theo dõi tin nhắn.
messageImpressions

string (int64 format)

Số lượt hiển thị Nhấp để nhắn tin đủ điều kiện theo dõi tin nhắn.
messageChatRate

number

Số cuộc trò chuyện đã bắt đầu (messageChat) chia cho số lượt hiển thị tin nhắn (messageImpressions). Tỷ lệ người dùng bắt đầu cuộc trò chuyện tin nhắn từ một lần hiển thị quảng cáo với tùy chọn nhắn tin và theo dõi tin nhắn được bật. Xin lưu ý rằng tỷ lệ này có thể lớn hơn 1 đối với một lượt hiển thị tin nhắn nhất định.
mobileFriendlyClicksPercentage

number

Tỷ lệ phần trăm số lần nhấp trên thiết bị di động chuyển đến một trang thân thiện với thiết bị di động.
optimizationScoreUplift

number

Tổng mức tăng điểm tối ưu hoá của tất cả nội dung đề xuất.
optimizationScoreUrl

string

URL cho trang điểm tối ưu hoá trong giao diện web của Google Ads. Bạn có thể chọn chỉ số này từ customer hoặc campaign và có thể phân đoạn theo segments.recommendation_type. Ví dụ: SELECT metrics.optimization_score_url, segments.recommendation_type FROM customer sẽ trả về một URL cho mỗi tổ hợp riêng biệt (khách hàng, loại đề xuất).
organicClicks

string (int64 format)

Số lần ai đó nhấp chuột vào danh sách của trang web của bạn trong các kết quả không phải trả tiền cho một truy vấn cụ thể. Hãy xem trang trợ giúp tại https://support.google.com/google-ads/answer/3097241 để biết thông tin chi tiết.
organicClicksPerQuery

number

Số lần ai đó đã nhấp vào danh sách trang web của bạn trong các kết quả không phải trả tiền (không phải trả tiền) chia cho tổng số tìm kiếm đã trả về các trang từ trang web của bạn (không phải trả tiền). Hãy xem trang trợ giúp tại https://support.google.com/google-ads/answer/3097241 để biết thông tin chi tiết.
organicImpressions

string (int64 format)

Số lượng danh sách cho trang web của bạn trong các kết quả tìm kiếm không phải trả tiền. Hãy xem trang trợ giúp tại https://support.google.com/google-ads/answer/3097241 để biết thông tin chi tiết.
organicImpressionsPerQuery

number

Số lần một trang trên trang web của bạn được liệt kê trong kết quả tìm kiếm không phải trả tiền (không phải trả tiền để hiển thị) chia cho số lượt tìm kiếm trả về danh sách trang web của bạn trong kết quả tìm kiếm không phải trả tiền (không phải trả tiền để tìm kiếm). Hãy xem trang trợ giúp tại https://support.google.com/google-ads/answer/3097241 để biết thông tin chi tiết.
organicQueries

string (int64 format)

Tổng số lượt tìm kiếm trả về trang web của bạn trong kết quả không tính phí. Hãy xem trang trợ giúp tại https://support.google.com/google-ads/answer/3097241 để biết thông tin chi tiết.
percentNewVisitors

number

Tỷ lệ phần trăm số phiên lần đầu (từ những người chưa bao giờ truy cập vào trang web của bạn trước đó). Được nhập từ Google Analytics.
phoneCalls

string (int64 format)

Số cuộc gọi điện thoại ngoại tuyến.
phoneImpressions

string (int64 format)

Số lượt hiển thị số điện thoại ngoại tuyến.
phoneThroughRate

number

Số cuộc gọi điện thoại đã nhận (phoneCall) chia cho số lần số điện thoại của bạn được hiển thị (phoneImpressions).
relativeCtr

number

Tỷ lệ nhấp (Ctr) chia cho tỷ lệ nhấp trung bình của tất cả các nhà quảng cáo trên những trang web hiển thị quảng cáo của bạn. Đo lường cách quảng cáo của bạn hoạt động trên các trang web Mạng Hiển thị so với các quảng cáo khác trên cùng trang web.
searchAbsoluteTopImpressionShare

number

Tỷ lệ phần trăm số lượt hiển thị quảng cáo Mua sắm hoặc quảng cáo Tìm kiếm của khách hàng được xuất hiện tại vị trí Mua sắm nổi bật nhất. Hãy xem https://support.google.com/google-ads/answer/7501826 để biết thông tin chi tiết. Bất kỳ giá trị nào dưới 0,1 được báo cáo là 0,0999.
searchBudgetLostAbsoluteTopImpressionShare

number

Con số này ước tính tần suất quảng cáo của bạn không phải là quảng cáo đầu tiên trong số những quảng cáo hàng đầu trong kết quả tìm kiếm do ngân sách thấp. Lưu ý: Tỷ lệ hiển thị ở vị trí đầu tiên bị mất do ngân sách tìm kiếm được báo cáo trong khoảng từ 0 đến 0,9. Bất kỳ giá trị nào lớn hơn 0,9 đều được báo cáo là 0,9001.
searchBudgetLostImpressionShare

number

Tỷ lệ phần trăm ước tính số lần quảng cáo của bạn đủ điều kiện hiển thị trên Mạng Tìm kiếm nhưng lại không hiển thị vì ngân sách quá thấp. Lưu ý: Tỷ lệ hiển thị bị mất ngân sách tìm kiếm được báo cáo trong khoảng từ 0 đến 0,9. Bất kỳ giá trị nào lớn hơn 0,9 đều được báo cáo là 0,9001.
searchBudgetLostTopImpressionShare

number

Con số này ước tính tần suất quảng cáo của bạn không xuất hiện bên cạnh kết quả tìm kiếm tự nhiên hàng đầu do ngân sách thấp. Lưu ý: Tỷ lệ hiển thị ở vị trí hàng đầu bị mất ngân sách trên Mạng Tìm kiếm được báo cáo trong khoảng từ 0 đến 0,9. Bất kỳ giá trị nào lớn hơn 0,9 đều được báo cáo là 0,9001.
searchClickShare

number

Số lượt nhấp mà bạn nhận được trên Mạng Tìm kiếm chia cho số lượt nhấp ước tính mà bạn đủ điều kiện nhận. Lưu ý: Tỷ lệ nhấp chuột trên mạng tìm kiếm được báo cáo trong khoảng từ 0,1 đến 1. Bất kỳ giá trị nào dưới 0,1 được báo cáo là 0,0999.
searchExactMatchImpressionShare

number

Số lượt hiển thị bạn đã nhận được chia cho số lượt hiển thị ước tính mà bạn đủ điều kiện nhận trên Mạng Tìm kiếm cho cụm từ tìm kiếm khớp chính xác với từ khoá (hoặc là các biến thể gần giống của từ khoá), bất kể kiểu khớp từ khoá của bạn là gì. Lưu ý: Tỷ lệ hiển thị đối sánh chính xác trên Mạng Tìm kiếm được báo cáo trong khoảng 0,1 đến 1. Bất kỳ giá trị nào dưới 0,1 được báo cáo là 0,0999.
searchImpressionShare

number

Số lượt hiển thị mà bạn nhận được trên Mạng Tìm kiếm chia cho số lượt hiển thị ước tính mà bạn đủ điều kiện để nhận. Lưu ý: Tỷ lệ hiển thị trên Mạng Tìm kiếm được báo cáo trong khoảng từ 0,1 đến 1. Bất kỳ giá trị nào dưới 0,1 được báo cáo là 0,0999.
searchRankLostAbsoluteTopImpressionShare

number

Con số này ước tính tần suất quảng cáo của bạn không phải là quảng cáo đầu tiên trong số những quảng cáo hàng đầu trong kết quả tìm kiếm do Thứ hạng quảng cáo thấp. Lưu ý: Tỷ lệ hiển thị ở vị trí đầu tiên bị mất thứ hạng trên Mạng Tìm kiếm được báo cáo trong khoảng từ 0 đến 0,9. Bất kỳ giá trị nào lớn hơn 0,9 đều được báo cáo là 0,9001.
searchRankLostImpressionShare

number

Phần trăm số lượt hiển thị ước tính trên Mạng Tìm kiếm mà quảng cáo của bạn không nhận được do Thứ hạng quảng cáo thấp. Lưu ý: Tỷ lệ hiển thị bị mất thứ hạng tìm kiếm được báo cáo trong khoảng từ 0 đến 0,9. Bất kỳ giá trị nào lớn hơn 0,9 đều được báo cáo là 0,9001.
searchRankLostTopImpressionShare

number

Con số này ước tính tần suất quảng cáo của bạn không xuất hiện bên cạnh kết quả tìm kiếm tự nhiên hàng đầu do Thứ hạng quảng cáo thấp. Lưu ý: Tỷ lệ hiển thị ở vị trí hàng đầu bị mất thứ hạng trên Mạng Tìm kiếm được báo cáo trong khoảng từ 0 đến 0,9. Bất kỳ giá trị nào lớn hơn 0,9 đều được báo cáo là 0,9001.
searchTopImpressionShare

number

Số lượt hiển thị mà bạn nhận được trong số những quảng cáo hàng đầu so với số lượt hiển thị ước tính mà bạn đủ điều kiện nhận được trong số những quảng cáo hàng đầu. Lưu ý: Tỷ lệ hiển thị ở vị trí hàng đầu trên Mạng Tìm kiếm được báo cáo trong khoảng 0,1 đến 1. Bất kỳ giá trị nào dưới 0,1 được báo cáo là 0,0999.

Quảng cáo hàng đầu thường nằm phía trên kết quả tự nhiên hàng đầu, mặc dù quảng cáo hàng đầu có thể hiển thị bên dưới kết quả tự nhiên hàng đầu đối với một số cụm từ tìm kiếm nhất định.
searchVolume

object (SearchVolumeRange)

Phạm vi lượng tìm kiếm cho một danh mục thông tin chi tiết về cụm từ tìm kiếm.
speedScore

string (int64 format)

Đo lường tốc độ tải trang sau khi nhấp vào quảng cáo trên thiết bị di động của bạn. Phạm vi điểm số là từ 1 đến 10, 10 là nhanh nhất.
averageTargetCpaMicros

string (int64 format)

CPA mục tiêu trung bình hoặc không đặt nếu không có (ví dụ: đối với các chiến dịch có lưu lượng truy cập từ chiến lược đặt giá thầu danh mục đầu tư hoặc không phải tCPA).
averageTargetRoas

number

ROAS mục tiêu trung bình hoặc không đặt nếu không có (ví dụ: cho những chiến dịch có lưu lượng truy cập từ chiến lược đặt giá thầu danh mục đầu tư hoặc không phải tROAS).
topImpressionPercentage

number

Tỷ lệ phần trăm số lượt hiển thị quảng cáo của bạn xuất hiện bên cạnh kết quả tìm kiếm tự nhiên hàng đầu.
validAcceleratedMobilePagesClicksPercentage

number

Tỷ lệ phần trăm số lần nhấp vào quảng cáo vào trang đích Accelerated Mobile Pages (AMP) để tiếp cận một trang AMP hợp lệ.
valuePerAllConversions

number

Giá trị của tất cả lượt chuyển đổi chia cho số lượng tất cả lượt chuyển đổi.
valuePerAllConversionsByConversionDate

number

Giá trị của tất cả lượt chuyển đổi chia cho số lượng tất cả lượt chuyển đổi. Khi bạn chọn cột này cùng với ngày, các giá trị trong cột ngày sẽ có nghĩa là ngày chuyển đổi. Thông tin chi tiết về các cột by_conversion_date có tại https://support.google.com/google-ads/answer/9549009.
valuePerConversion

number

Giá trị của lượt chuyển đổi chia cho số lượt chuyển đổi. Chỉ bao gồm những hành động chuyển đổi có thuộc tính includeInConversionsMetric được đặt thành true. Nếu bạn sử dụng chiến lược đặt giá thầu dựa trên lượt chuyển đổi, thì các chiến lược giá thầu của bạn sẽ tối ưu hoá cho những lượt chuyển đổi này.
valuePerConversionsByConversionDate

number

Giá trị của lượt chuyển đổi chia cho số lượt chuyển đổi. Chỉ bao gồm những hành động chuyển đổi có thuộc tính includeInConversionsMetric được đặt thành true. Nếu bạn sử dụng chiến lược đặt giá thầu dựa trên lượt chuyển đổi, thì các chiến lược giá thầu của bạn sẽ tối ưu hoá cho những lượt chuyển đổi này. Khi bạn chọn cột này có ngày, các giá trị trong cột ngày có nghĩa là ngày chuyển đổi. Thông tin chi tiết về các cột by_conversion_date có tại https://support.google.com/google-ads/answer/9549009.
valuePerCurrentModelAttributedConversion

number

Giá trị của các lượt chuyển đổi được phân bổ theo mô hình hiện tại chia cho số lượt chuyển đổi. Chỉ bao gồm những hành động chuyển đổi có thuộc tính includeInConversionsMetric được đặt thành true. Nếu bạn sử dụng chiến lược đặt giá thầu dựa trên lượt chuyển đổi, thì các chiến lược giá thầu của bạn sẽ tối ưu hoá cho những lượt chuyển đổi này.
videoQuartileP100Rate

number

Tỷ lệ phần trăm số lượt hiển thị trong đó người xem đã xem toàn bộ video của bạn.
videoQuartileP25Rate

number

Tỷ lệ phần trăm số lượt hiển thị trong đó người xem đã xem 25% video của bạn.
videoQuartileP50Rate

number

Tỷ lệ phần trăm số lượt hiển thị trong đó người xem đã xem 50% video của bạn.
videoQuartileP75Rate

number

Tỷ lệ phần trăm số lượt hiển thị trong đó người xem đã xem 75% video của bạn.
videoViewRate

number

Số lượt xem mà quảng cáo video TrueView của bạn nhận được chia cho số lần hiển thị của quảng cáo, kể cả số lần hiển thị hình thu nhỏ cho quảng cáo TrueView trong hiển thị.
videoViews

string (int64 format)

Số lần quảng cáo dạng video của bạn được xem.
viewThroughConversions

string (int64 format)

Tổng số lượt chuyển đổi từ lượt xem hết. Những điều này xảy ra khi khách hàng xem quảng cáo hình ảnh hoặc quảng cáo đa phương tiện, sau đó hoàn thành chuyển đổi trên trang web của bạn mà không tương tác (ví dụ: nhấp vào) một quảng cáo khác.
allConversionsFromLocationAssetClickToCall

number

Số lượt nhấp vào nút gọi trên vị trí bất kỳ sau một sự kiện quảng cáo có tính phí (lượt nhấp hoặc lượt hiển thị). Thông tin đo lường này được lấy từ vị trí dựa trên Thành phần.
allConversionsFromLocationAssetDirections

number

Số lượt nhấp để xem thông tin đường lái xe trên bất kỳ nền tảng vị trí nào sau một sự kiện quảng cáo có tính phí (lượt nhấp hoặc lượt hiển thị). Thông tin đo lường này được lấy từ vị trí dựa trên Thành phần.
allConversionsFromLocationAssetMenu

number

Số lượt nhấp vào đường liên kết đến đường liên kết đến trình đơn trên bất kỳ nền tảng vị trí nào sau một sự kiện quảng cáo có tính phí (lượt nhấp hoặc lượt hiển thị). Thông tin đo lường này được lấy từ vị trí dựa trên Thành phần.
allConversionsFromLocationAssetOrder

number

Số lượt nhấp vào đơn đặt hàng trên một vị trí bất kỳ sau một sự kiện quảng cáo có tính phí (lượt nhấp hoặc lượt hiển thị). Thông tin đo lường này được lấy từ vị trí dựa trên Thành phần.
allConversionsFromLocationAssetOtherEngagement

number

Số loại lượt nhấp vào hành động liên quan đến địa điểm thực tế khác trên một vị trí bất kỳ sau một sự kiện quảng cáo có tính phí (lượt nhấp hoặc lượt hiển thị). Thông tin đo lường này được lấy từ vị trí dựa trên Thành phần.
allConversionsFromLocationAssetStoreVisits

number

Số lượt ghé thăm cửa hàng thực tế ước tính sau một sự kiện quảng cáo có tính phí (lượt nhấp hoặc lượt hiển thị). Thông tin đo lường này được lấy từ vị trí dựa trên Thành phần.
allConversionsFromLocationAssetWebsite

number

Số lượt nhấp vào URL của trang web trên một nền tảng vị trí bất kỳ sau một sự kiện quảng cáo có tính phí (lượt nhấp hoặc lượt hiển thị). Thông tin đo lường này được lấy từ vị trí dựa trên Thành phần.
eligibleImpressionsFromLocationAssetStoreReach

string (int64 format)

Số lượt hiển thị mà vị trí cửa hàng xuất hiện hoặc vị trí được dùng để nhắm mục tiêu. Thông tin đo lường này được lấy từ vị trí dựa trên Thành phần.
viewThroughConversionsFromLocationAssetClickToCall

number

Số lượt nhấp vào nút gọi trên nền tảng vị trí bất kỳ sau một lượt hiển thị. Thông tin đo lường này được lấy từ vị trí dựa trên Thành phần.
viewThroughConversionsFromLocationAssetDirections

number

Số lượt nhấp để xem thông tin đường lái xe trên bất kỳ bề mặt vị trí nào sau một lượt hiển thị. Chỉ số này đến từ Vị trí dựa trên thành phần.
viewThroughConversionsFromLocationAssetMenu

number

Số lượt nhấp vào đường liên kết trình đơn trên nền tảng vị trí bất kỳ sau một lượt hiển thị. Thông tin đo lường này được lấy từ vị trí dựa trên Thành phần.
viewThroughConversionsFromLocationAssetOrder

number

Số lượt nhấp vào đơn đặt hàng trên một vị trí bất kỳ sau một lượt hiển thị. Thông tin đo lường này được lấy từ vị trí dựa trên Thành phần.
viewThroughConversionsFromLocationAssetOtherEngagement

number

Số lượng các loại lượt nhấp vào hành động liên quan đến địa điểm thực tế khác trên nền tảng vị trí bất kỳ sau khi quảng cáo hiển thị. Thông tin đo lường này được lấy từ vị trí dựa trên Thành phần.
viewThroughConversionsFromLocationAssetStoreVisits

number

Số lượt ghé thăm cửa hàng thực tế sau khi quảng cáo hiển thị ước tính. Thông tin đo lường này được lấy từ vị trí dựa trên Thành phần.
viewThroughConversionsFromLocationAssetWebsite

number

Số lượt nhấp vào URL của trang web trên nền tảng vị trí bất kỳ sau một lượt hiển thị. Thông tin đo lường này được lấy từ vị trí dựa trên Thành phần.
orders

number

Số đơn đặt hàng là tổng số lượt chuyển đổi giao dịch mua mà bạn nhận được từ quảng cáo của mình. Cách hoạt động: Bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng cho các giao dịch mua hàng đã hoàn tất trên trang web của mình. Nếu một lượt chuyển đổi được phân bổ cho các lượt tương tác trước đó với quảng cáo của bạn (lượt nhấp đối với quảng cáo dạng văn bản hoặc quảng cáo Mua sắm, lượt xem đối với quảng cáo dạng video, v.v.), thì lượt chuyển đổi đó sẽ được tính là một đơn đặt hàng. Ví dụ: Một người dùng nhấp vào quảng cáo Mua sắm về một chiếc mũ. Sau đó, họ mua chiếc mũ đó và một chiếc áo sơ mi trong một đơn đặt hàng trên trang web của bạn. Mặc dù người dùng mua 2 sản phẩm, nhưng lượt chuyển đổi này sẽ được tính là 1 đơn đặt hàng. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng.
averageOrderValueMicros

string (int64 format)

Giá trị trung bình của đơn đặt hàng là doanh thu trung bình mà bạn nhận được từ mỗi đơn đặt hàng do quảng cáo của bạn mang lại. Cách hoạt động: Bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng cho các giao dịch mua hàng đã hoàn tất trên trang web của mình. Giá trị trung bình của đơn đặt hàng là tổng doanh thu của các đơn đặt hàng chia cho tổng số đơn đặt hàng. Ví dụ: Bạn nhận được 3 đơn đặt hàng với tổng doanh thu là 10 đô la, 15 đô la và 20 đô la. Giá trị trung bình của đơn đặt hàng là $15 = ($10 + $15 + $20) / 3. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng.
averageCartSize

number

Kích thước trung bình của giỏ hàng là số lượng sản phẩm trung bình trong mỗi đơn đặt hàng do quảng cáo của bạn mang lại. Cách hoạt động: Bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng cho các giao dịch mua hàng đã hoàn tất trên trang web của mình. Kích thước trung bình của giỏ hàng là tổng số sản phẩm đã bán chia cho tổng số đơn đặt hàng mà bạn nhận được. Ví dụ: Bạn nhận được 2 đơn đặt hàng. Đơn đặt hàng thứ nhất gồm 3 sản phẩm, còn đơn đặt hàng thứ hai gồm 2 sản phẩm. Kích thước trung bình của giỏ hàng là: (3 + 2)/2 = 2,5 sản phẩm. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng.
costOfGoodsSoldMicros

string (int64 format)

Giá vốn hàng bán (COGS) là tổng chi phí của những sản phẩm bạn đã bán được thông qua các đơn đặt hàng mà quảng cáo của bạn mang lại. Cách hoạt động: Bạn có thể thêm giá vốn hàng bán cho tất cả sản phẩm trong Merchant Center. Nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng, những sản phẩm bạn đã bán sẽ được so khớp với giá vốn hàng bán của chúng, và giá vốn hàng bán có thể được dùng để tính lợi nhuận gộp mà bạn kiếm được trên mỗi đơn đặt hàng. Ví dụ: Một người dùng nhấp vào quảng cáo Mua sắm về một chiếc mũ. Sau đó, họ mua chiếc mũ đó và một chiếc áo sơ mi. Chiếc mũ có giá vốn hàng bán là 3 đô la, chiếc áo có giá vốn hàng bán là 5 đô la. Giá vốn hàng bán cho đơn đặt hàng này là: 3 + 5 = 8 đô la. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng.
grossProfitMicros

string (int64 format)

Lợi nhuận gộp là lợi nhuận bạn kiếm được từ những đơn đặt hàng do quảng cáo của bạn mang lại, trừ đi giá vốn hàng bán (COGS). Cách hoạt động: Lợi nhuận gộp là doanh thu bạn kiếm được từ doanh số bán hàng do quảng cáo của bạn mang lại, trừ đi giá vốn hàng bán. Chỉ những sản phẩm có giá vốn hàng bán trong Merchant Center mới được tính toán lợi nhuận gộp. Ví dụ: Một người dùng nhấp vào quảng cáo Mua sắm về một chiếc mũ. Sau đó, họ mua chiếc mũ đó và một chiếc áo sơ mi trong một đơn đặt hàng trên trang web của bạn. Chiếc mũ có giá 10 đô la và áo sơ mi có giá 20 đô la. Chiếc mũ có giá vốn hàng bán là 3 đô la, còn chiếc áo không có giá vốn hàng bán. Lợi nhuận gộp cho đơn đặt hàng này sẽ chỉ tính đến chiếc mũ, tức là: 10 - 3 = 7 đô la. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng.
grossProfitMargin

number

Biên lợi nhuận gộp là tỷ lệ phần trăm lợi nhuận gộp mà bạn kiếm được từ những đơn đặt hàng do quảng cáo của bạn mang lại, trừ đi giá vốn hàng bán (COGS). Cách hoạt động: Bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng cho các giao dịch mua hàng đã hoàn tất trên trang web của mình. Biên lợi nhuận gộp bằng lợi nhuận gộp mà bạn kiếm được chia cho tổng doanh thu rồi nhân với 100%. Chỉ những sản phẩm có giá vốn hàng bán trong Merchant Center mới được tính toán biên lợi nhuận gộp. Ví dụ: Một người dùng mua một chiếc mũ và một chiếc áo sơ mi trong một đơn đặt hàng trên trang web của bạn. Chiếc mũ có giá 10 đô la và có giá vốn hàng bán là 3 đô la. Chiếc áo có giá 20 đô la nhưng không có giá vốn hàng bán. Biên lợi nhuận gộp cho đơn đặt hàng này sẽ chỉ tính đến chiếc mũ vì sản phẩm này có giá vốn hàng bán. Do đó, biên lợi nhuận gộp là: (10 - 3)/10 x 100% = 70%. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng.
revenueMicros

string (int64 format)

Doanh thu là tổng số tiền bạn kiếm được từ những đơn đặt hàng mà quảng cáo của bạn mang lại. Cách hoạt động: Bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng cho các giao dịch mua hàng đã hoàn tất trên trang web của mình. Doanh thu là tổng giá trị của tất cả những đơn đặt hàng mà bạn nhận được từ quảng cáo của mình, trừ đi mọi khoản chiết khấu. Ví dụ: Một người dùng nhấp vào quảng cáo Mua sắm về một chiếc mũ. Sau đó, họ mua chiếc mũ đó và một chiếc áo sơ mi trong một đơn đặt hàng trên trang web của bạn. Chiếc mũ có giá 10 đô la và áo sơ mi có giá 20 đô la. Toàn bộ đơn đặt hàng được chiết khấu 5 đô la. Doanh thu từ đơn đặt hàng này là: (10 + 20) - 5 = 25 đô la. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng.
unitsSold

number

Số lượng sản phẩm đã bán là tổng số sản phẩm đã bán từ các đơn đặt hàng mà quảng cáo của bạn mang lại. Cách hoạt động: Bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng cho các giao dịch mua hàng đã hoàn tất trên trang web của mình. Số lượng sản phẩm đã bán là tổng số sản phẩm đã bán từ tất cả các đơn đặt hàng mà quảng cáo của bạn mang lại. Ví dụ: Một người dùng nhấp vào quảng cáo Mua sắm về một chiếc mũ, rồi mua chiếc mũ đó, một chiếc áo sơ mi và một chiếc áo khoác. Số lượng sản phẩm được bán trong đơn đặt hàng này là 3. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng.
crossSellCostOfGoodsSoldMicros

string (int64 format)

Giá vốn hàng bán kèm (COGS) là tổng chi phí cho việc bán sản phẩm nhờ quảng cáo một sản phẩm khác. Cách hoạt động: Bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng cho các giao dịch mua hàng đã hoàn tất trên trang web của mình. Nếu người dùng tương tác với quảng cáo trước khi mua sản phẩm được liên kết (xem quảng cáo Mua sắm), thì sản phẩm này được coi là sản phẩm được quảng cáo. Mọi sản phẩm có trong đơn đặt hàng của khách hàng đều là sản phẩm đã bán. Nếu sản phẩm được quảng cáo không phải là sản phẩm đã bán, thì sản phẩm đã bán được gọi là sản phẩm bán kèm. Giá vốn hàng bán kèm là tổng giá vốn của những sản phẩm đã bán và không được quảng cáo. Ví dụ: Một người dùng nhấp vào quảng cáo Mua sắm về một chiếc mũ, rồi mua chiếc mũ đó và một chiếc áo sơ mi. Chiếc mũ có giá vốn hàng bán là 3 đô la, chiếc áo có giá vốn hàng bán là 5 đô la. Giá vốn hàng bán kèm trong đơn đặt hàng này là 5 đô la. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng.
crossSellGrossProfitMicros

string (int64 format)

Lợi nhuận gộp từ hoạt động bán kèm là lợi nhuận bạn kiếm được từ những sản phẩm đã bán nhờ quảng cáo về một sản phẩm khác, trừ đi giá vốn hàng bán (COGS). Cách hoạt động: Bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng cho các giao dịch mua hàng đã hoàn tất trên trang web của mình. Nếu người dùng tương tác với quảng cáo trước khi mua sản phẩm được liên kết (xem quảng cáo Mua sắm), thì sản phẩm này được coi là sản phẩm được quảng cáo. Mọi sản phẩm có trong giao dịch mua này đều là sản phẩm đã bán. Nếu sản phẩm được quảng cáo không phải là sản phẩm đã bán, thì sản phẩm đã bán được gọi là sản phẩm bán kèm. Lợi nhuận gộp từ hoạt động bán kèm là doanh thu bạn kiếm được từ hoạt động bán kèm do quảng cáo của bạn mang lại, trừ đi giá vốn hàng bán. Ví dụ: Một người dùng nhấp vào quảng cáo Mua sắm về một chiếc mũ, rồi mua chiếc mũ đó và một chiếc áo sơ mi. Chiếc áo có giá 20 đô la và có giá vốn hàng bán là 5 đô la. Lợi nhuận gộp từ hoạt động bán kèm của đơn đặt hàng này là 20 - 5 = 15 đô la. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng.
crossSellRevenueMicros

string (int64 format)

Doanh thu từ hoạt động bán kèm là tổng số tiền bạn kiếm được từ những sản phẩm đã bán được nhờ quảng cáo về một sản phẩm khác. Cách hoạt động: Bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng cho các giao dịch mua hàng đã hoàn tất trên trang web của mình. Nếu người dùng tương tác với quảng cáo trước khi mua sản phẩm được liên kết (xem quảng cáo Mua sắm), thì sản phẩm này được coi là sản phẩm được quảng cáo. Mọi sản phẩm có trong đơn đặt hàng của khách hàng đều là sản phẩm đã bán. Nếu sản phẩm được quảng cáo không phải là sản phẩm đã bán, thì sản phẩm đã bán được gọi là sản phẩm bán kèm. Doanh thu từ hoạt động bán kèm là tổng giá trị mà bạn kiếm được từ hoạt động bán kèm mà quảng cáo của bạn mang lại. Ví dụ: Một người dùng nhấp vào quảng cáo Mua sắm về một chiếc mũ. Sau đó, họ mua chiếc mũ đó và một chiếc áo sơ mi. Chiếc mũ có giá 10 đô la và áo sơ mi có giá 20 đô la. Doanh thu từ hoạt động bán kèm trong đơn đặt hàng này là 20 đô la. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng.
crossSellUnitsSold

number

Số lượng sản phẩm đã bán kèm là tổng số sản phẩm đã bán được nhờ quảng cáo một sản phẩm khác. Cách hoạt động: Bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng cho các giao dịch mua hàng đã hoàn tất trên trang web của mình. Nếu người dùng tương tác với quảng cáo trước khi mua sản phẩm được liên kết (xem quảng cáo Mua sắm), thì sản phẩm này được coi là sản phẩm được quảng cáo. Mọi sản phẩm có trong đơn đặt hàng của khách hàng đều là sản phẩm đã bán. Nếu sản phẩm được quảng cáo không phải là sản phẩm đã bán, thì sản phẩm đã bán được gọi là sản phẩm bán kèm. Số lượng sản phẩm đã bán kèm là tổng số sản phẩm đã bán kèm trong tất cả các đơn đặt hàng do quảng cáo của bạn mang lại. Ví dụ: Một người dùng nhấp vào quảng cáo Mua sắm về một chiếc mũ, rồi mua chiếc mũ đó, một chiếc áo sơ mi và một chiếc áo khoác. Số lượng sản phẩm đã bán kèm trong đơn đặt hàng này là 2. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng.
leadCostOfGoodsSoldMicros

string (int64 format)

Giá vốn hàng bán (COGS) của sản phẩm được quảng cáo là tổng giá vốn của những sản phẩm đã bán nhờ quảng cáo về sản phẩm đó. Cách hoạt động: Bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng cho các giao dịch mua hàng đã hoàn tất trên trang web của mình. Nếu người dùng tương tác với quảng cáo có một sản phẩm được liên kết (xem quảng cáo Mua sắm), thì sản phẩm này được coi là sản phẩm được quảng cáo. Mọi sản phẩm có trong đơn đặt hàng của khách hàng đều là sản phẩm đã bán. Nếu sản phẩm được quảng cáo và sản phẩm đã bán khớp với nhau, thì chi phí của những hàng hoá này được tính vào mục giá vốn hàng bán của sản phẩm được quảng cáo. Ví dụ: Một người dùng nhấp vào quảng cáo Mua sắm về một chiếc mũ. Sau đó, họ mua chiếc mũ đó và một chiếc áo sơ mi. Chiếc mũ có giá vốn hàng bán là 3 đô la, chiếc áo có giá vốn hàng bán là 5 đô la. Giá vốn hàng bán của sản phẩm được quảng cáo trong đơn đặt hàng này là 3 đô la. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng.
leadGrossProfitMicros

string (int64 format)

Lợi nhuận gộp của sản phẩm được quảng cáo là lợi nhuận bạn kiếm được từ những sản phẩm đã bán nhờ quảng cáo về sản phẩm đó, trừ đi giá vốn hàng bán (COGS). Cách hoạt động: Bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng cho các giao dịch mua hàng đã hoàn tất trên trang web của mình. Nếu người dùng tương tác với quảng cáo trước khi mua sản phẩm được liên kết (xem quảng cáo Mua sắm), thì sản phẩm này được coi là sản phẩm được quảng cáo. Mọi sản phẩm có trong đơn đặt hàng của khách hàng đều là sản phẩm đã bán. Nếu sản phẩm được quảng cáo và sản phẩm đã bán khớp với nhau, thì doanh thu bạn kiếm được từ doanh số bán hàng đó trừ đi giá vốn hàng bán sẽ là lợi nhuận gộp của sản phẩm được quảng cáo. Ví dụ: Một người dùng nhấp vào quảng cáo Mua sắm về một chiếc mũ, rồi mua chiếc mũ đó và một chiếc áo sơ mi. Chiếc mũ có giá 10 đô la và có giá vốn hàng bán là 3 đô la. Lợi nhuận gộp của sản phẩm được quảng cáo trong đơn đặt hàng này là: 10 − 3 = 7 đô la. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng.
leadRevenueMicros

string (int64 format)

Doanh thu của sản phẩm được quảng cáo là tổng số tiền bạn kiếm được từ những sản phẩm đã bán được nhờ quảng cáo cho sản phẩm đó. Cách hoạt động: Bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng cho các giao dịch mua hàng đã hoàn tất trên trang web của mình. Nếu người dùng tương tác với quảng cáo trước khi mua sản phẩm được liên kết (xem quảng cáo Mua sắm), thì sản phẩm này được coi là sản phẩm được quảng cáo. Mọi sản phẩm có trong đơn đặt hàng của khách hàng đều là sản phẩm đã bán. Nếu sản phẩm được quảng cáo và sản phẩm đã bán khớp với nhau, thì tổng giá trị mà bạn kiếm được từ doanh số bán những sản phẩm này sẽ được đưa vào mục doanh thu của sản phẩm được quảng cáo. Ví dụ: Một người dùng nhấp vào quảng cáo Mua sắm về một chiếc mũ. Sau đó, họ mua chiếc mũ đó và một chiếc áo sơ mi. Chiếc mũ có giá 10 đô la và áo sơ mi có giá 20 đô la. Doanh thu của sản phẩm được quảng cáo trong đơn đặt hàng này là 10 đô la. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng.
leadUnitsSold

number

Số lượng sản phẩm được quảng cáo đã bán là tổng số sản phẩm đã bán nhờ quảng cáo về sản phẩm đó. Cách hoạt động: Bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng cho các giao dịch mua hàng đã hoàn tất trên trang web của mình. Nếu người dùng tương tác với quảng cáo trước khi mua sản phẩm được liên kết (xem quảng cáo Mua sắm), thì sản phẩm này được coi là sản phẩm được quảng cáo. Mọi sản phẩm có trong đơn đặt hàng của khách hàng đều là sản phẩm đã bán. Nếu sản phẩm được quảng cáo và sản phẩm đã bán khớp với nhau, thì tổng số lượng những sản phẩm đã bán này sẽ được đưa vào mục số lượng sản phẩm được quảng cáo đã bán. Ví dụ: Một người dùng nhấp vào quảng cáo Mua sắm về một chiếc mũ, rồi mua chiếc mũ đó, một chiếc áo sơ mi và một chiếc áo khoác. Số lượng sản phẩm được quảng cáo đã bán trong đơn đặt hàng này là 1. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng.
uniqueUsers

string (int64 format)

Số lượng người dùng duy nhất đã xem quảng cáo của bạn trong khoảng thời gian được yêu cầu. Không thể tổng hợp chỉ số này và bạn chỉ có thể yêu cầu chỉ số này trong phạm vi ngày từ 92 ngày trở xuống. Bạn có thể xem chỉ số này cho các loại chiến dịch sau: chiến dịch Hiển thị, chiến dịch Video, chiến dịch Khám phá và chiến dịch Quảng cáo ứng dụng.
averageImpressionFrequencyPerUser

number

Số lần trung bình một người dùng duy nhất thấy quảng cáo của bạn trong khoảng thời gian được yêu cầu. Không thể tổng hợp chỉ số này và bạn chỉ có thể yêu cầu chỉ số này trong phạm vi ngày từ 92 ngày trở xuống. Bạn có thể xem chỉ số này cho các loại chiến dịch sau: chiến dịch Hiển thị, chiến dịch Video, chiến dịch Khám phá và chiến dịch Quảng cáo ứng dụng.

InteractionEventType

Enum mô tả các loại giao dịch có thể thanh toán và miễn phí.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
CLICK Nhấp vào trang web. Trong hầu hết các trường hợp, lượt tương tác này điều hướng đến một vị trí bên ngoài, thường là trang đích của nhà quảng cáo. Đây cũng là InteropEventType mặc định cho sự kiện nhấp chuột.
ENGAGEMENT Ý định rõ ràng của người dùng về việc tương tác với quảng cáo tại chỗ.
VIDEO_VIEW Người dùng đã xem một quảng cáo dạng video.
NONE SubscriptionEventType mặc định cho các sự kiện chuyển đổi quảng cáo. Lựa chọn này được sử dụng khi hàng lượt chuyển đổi quảng cáo KHÔNG cho biết rằng lượt tương tác miễn phí (ví dụ: lượt chuyển đổi quảng cáo) phải được "quảng cáo" và được báo cáo như một phần của các chỉ số chính. Đây đơn giản là các lượt chuyển đổi (quảng cáo) khác.

SearchVolumeRange

Phạm vi lượng tìm kiếm. Số lượng tìm kiếm thực tế nằm trong phạm vi này.

Biểu diễn dưới dạng JSON 
{
  "min": string,
  "max": string
}
Trường
min

string (int64 format)

Giới hạn dưới của lượng tìm kiếm.
max

string (int64 format)

Giới hạn trên của lượng tìm kiếm.

Phân đoạn

Các trường chỉ dành cho phân đoạn.

Biểu diễn dưới dạng JSON 
{
  "adDestinationType": enum (AdDestinationType),
  "adNetworkType": enum (AdNetworkType),
  "budgetCampaignAssociationStatus": {
    object (BudgetCampaignAssociationStatus)
  },
  "clickType": enum (ClickType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionAttributionEventType": enum (ConversionAttributionEventType),
  "conversionLagBucket": enum (ConversionLagBucket),
  "conversionOrAdjustmentLagBucket": enum (ConversionOrAdjustmentLagBucket),
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "externalConversionSource": enum (ExternalConversionSource),
  "hotelCheckInDayOfWeek": enum (DayOfWeek),
  "hotelDateSelectionType": enum (HotelDateSelectionType),
  "hotelRateType": enum (HotelRateType),
  "hotelPriceBucket": enum (HotelPriceBucket),
  "keyword": {
    object (Keyword)
  },
  "monthOfYear": enum (MonthOfYear),
  "placeholderType": enum (PlaceholderType),
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "recommendationType": enum (RecommendationType),
  "searchEngineResultsPageType": enum (SearchEngineResultsPageType),
  "searchTermMatchType": enum (SearchTermMatchType),
  "slot": enum (Slot),
  "conversionValueRulePrimaryDimension": enum (ConversionValueRulePrimaryDimension),
  "skAdNetworkUserType": enum (SkAdNetworkUserType),
  "skAdNetworkAdEventType": enum (SkAdNetworkAdEventType),
  "skAdNetworkAttributionCredit": enum (SkAdNetworkAttributionCredit),
  "skAdNetworkCoarseConversionValue": enum (SkAdNetworkCoarseConversionValue),
  "skAdNetworkSourceType": enum (SkAdNetworkSourceType),
  "newVersusReturningCustomers": enum (ConvertingUserPriorEngagementTypeAndLtvBucket),
  "activityAccountId": string,
  "activityCity": string,
  "activityCountry": string,
  "activityRating": string,
  "activityState": string,
  "externalActivityId": string,
  "adGroup": string,
  "assetGroup": string,
  "auctionInsightDomain": string,
  "campaign": string,
  "conversionAction": string,
  "conversionActionName": string,
  "conversionAdjustment": boolean,
  "date": string,
  "geoTargetAirport": string,
  "geoTargetCanton": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetCounty": string,
  "geoTargetDistrict": string,
  "geoTargetMetro": string,
  "geoTargetMostSpecificLocation": string,
  "geoTargetPostalCode": string,
  "geoTargetProvince": string,
  "geoTargetRegion": string,
  "geoTargetState": string,
  "hotelBookingWindowDays": string,
  "hotelCenterId": string,
  "hotelCheckInDate": string,
  "hotelCity": string,
  "hotelClass": integer,
  "hotelCountry": string,
  "hotelLengthOfStay": integer,
  "hotelRateRuleId": string,
  "hotelState": string,
  "hour": integer,
  "interactionOnThisExtension": boolean,
  "month": string,
  "partnerHotelId": string,
  "productAggregatorId": string,
  "productCategoryLevel1": string,
  "productCategoryLevel2": string,
  "productCategoryLevel3": string,
  "productCategoryLevel4": string,
  "productCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productFeedLabel": string,
  "productItemId": string,
  "productLanguage": string,
  "productMerchantId": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "searchSubcategory": string,
  "searchTerm": string,
  "webpage": string,
  "week": string,
  "year": integer,
  "skAdNetworkConversionValue": string,
  "skAdNetworkSourceApp": {
    object (SkAdNetworkSourceApp)
  },
  "skAdNetworkSourceDomain": string,
  "skAdNetworkPostbackSequenceIndex": string,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
Trường
adDestinationType

enum (AdDestinationType)

Loại đích đến của quảng cáo.
adNetworkType

enum (AdNetworkType)

Loại mạng quảng cáo.
budgetCampaignAssociationStatus

object (BudgetCampaignAssociationStatus)

Trạng thái liên kết chiến dịch ngân sách.
clickType

enum (ClickType)

Loại nhấp chuột.
conversionActionCategory

enum (ConversionActionCategory)

Danh mục hành động chuyển đổi.
conversionAttributionEventType

enum (ConversionAttributionEventType)

Loại sự kiện phân bổ lượt chuyển đổi.
conversionLagBucket

enum (ConversionLagBucket)

Một giá trị enum thể hiện số ngày giữa lượt hiển thị và lượt chuyển đổi.
conversionOrAdjustmentLagBucket

enum (ConversionOrAdjustmentLagBucket)

Một giá trị enum thể hiện số ngày giữa lượt hiển thị và lượt chuyển đổi hoặc giữa lượt hiển thị và mức điều chỉnh đối với lượt chuyển đổi.
dayOfWeek

enum (DayOfWeek)

Ngày trong tuần, ví dụ: MONDAY.
device

enum (Device)

Thiết bị áp dụng chỉ số.
externalConversionSource

enum (ExternalConversionSource)

Nguồn chuyển đổi bên ngoài.
hotelCheckInDayOfWeek

enum (DayOfWeek)

Ngày nhận phòng khách sạn trong tuần.
hotelDateSelectionType

enum (HotelDateSelectionType)

Loại lựa chọn ngày khi đặt khách sạn.
hotelRateType

enum (HotelRateType)

Loại giá khách sạn.
hotelPriceBucket

enum (HotelPriceBucket)

Gói giá khách sạn.
keyword

object (Keyword)

Tiêu chí từ khoá.
monthOfYear

enum (MonthOfYear)

Tháng trong năm, ví dụ: Tháng 1.
placeholderType

enum (PlaceholderType)

Loại phần giữ chỗ. Thuộc tính này chỉ được dùng với các chỉ số về mục nguồn cấp dữ liệu.
productChannel

enum (ProductChannel)

Kênh của sản phẩm.
productChannelExclusivity

enum (ProductChannelExclusivity)

Kênh độc quyền cho sản phẩm.
productCondition

enum (ProductCondition)

Tình trạng của sản phẩm.
recommendationType

enum (RecommendationType)

Loại đề xuất.
searchEngineResultsPageType

enum (SearchEngineResultsPageType)

Loại trang kết quả của công cụ tìm kiếm.
searchTermMatchType

enum (SearchTermMatchType)

Loại đối sánh của từ khóa đã kích hoạt quảng cáo, bao gồm cả các biến thể.
slot

enum (Slot)

Vị trí quảng cáo.
conversionValueRulePrimaryDimension

enum (ConversionValueRulePrimaryDimension)

Phương diện chính của những quy tắc về giá trị lượt chuyển đổi đã áp dụng. NO_Quy_PAYMENTS hiển thị tổng giá trị được ghi lại của các chuyển đổi không áp dụng quy tắc giá trị. ORIGINAL cho biết giá trị ban đầu của các lượt chuyển đổi đã áp dụng quy tắc giá trị. GEO_LOCATION, THIẾT BỊ, KHÁN GIẢ cho thấy mức điều chỉnh ròng sau khi áp dụng quy tắc giá trị.
skAdNetworkUserType

enum (SkAdNetworkUserType)

Loại người dùng mạng quảng cáo của Bộ công cụ iOS Store.
skAdNetworkAdEventType

enum (SkAdNetworkAdEventType)

Loại sự kiện quảng cáo trên Mạng quảng cáo của Bộ công cụ dành cho iOS Store.
skAdNetworkAttributionCredit

enum (SkAdNetworkAttributionCredit)

Tín dụng phân bổ trên Mạng quảng cáo của Bộ công cụ iOS Store
skAdNetworkCoarseConversionValue

enum (SkAdNetworkCoarseConversionValue)

Giá trị chuyển đổi tương đối của Mạng quảng cáo Bộ công cụ dành cho iOS Store.
skAdNetworkSourceType

enum (SkAdNetworkSourceType)

Loại nguồn mà quảng cáo thúc đẩy lượt cài đặt Mạng quảng cáo Bộ công cụ dành cho iOS đã hiển thị. Giá trị rỗng có nghĩa là không thể áp dụng phân khúc này (ví dụ: chiến dịch không phải iOS hoặc miền nguồn hay ứng dụng nguồn) không có trong bất kỳ hệ thống đăng lại nào do Apple gửi.
newVersusReturningCustomers

enum (ConvertingUserPriorEngagementTypeAndLtvBucket)

Chỉ số này để phân đoạn lượt chuyển đổi theo xem người dùng là khách hàng mới hay khách hàng cũ. Phân đoạn này thường dùng để đo lường mức tác động của mục tiêu thu nạp khách hàng.
activityAccountId

string (int64 format)

Mã tài khoản hoạt động.
activityCity

string

Thành phố có hoạt động du lịch.
activityCountry

string

Quốc gia có hoạt động du lịch.
activityRating

string (int64 format)

Xếp hạng hoạt động.
activityState

string

Tiểu bang có hoạt động đi lại.
externalActivityId

string

Mã hoạt động do nhà quảng cáo cung cấp.
adGroup

string

Tên tài nguyên của nhóm quảng cáo.
assetGroup

string

Tên tài nguyên của nhóm thành phần.
auctionInsightDomain

string

Miền (URL hiển thị) của người tham gia trong báo cáo Thông tin chi tiết về phiên đấu giá.
campaign

string

Tên tài nguyên của chiến dịch.
conversionAction

string

Tên tài nguyên của hành động chuyển đổi.
conversionActionName

string

Tên hành động chuyển đổi.
conversionAdjustment

boolean

Việc này sẽ phân đoạn các cột lượt chuyển đổi theo lượt chuyển đổi và giá trị lượt chuyển đổi ban đầu so với giá trị delta nếu lượt chuyển đổi đã được điều chỉnh. Hàng False có dữ liệu như đã nêu ban đầu; Mặc dù hàng true có giá trị delta giữa dữ liệu hiện tại và dữ liệu như đã nêu ban đầu. Tổng hợp cả hai dữ liệu sau khi điều chỉnh.
date

string

Ngày áp dụng các chỉ số. Định dạng yyyy-MM-dd, ví dụ: 2018-04-17.
geoTargetAirport

string

Tên tài nguyên của hằng số mục tiêu địa lý đại diện cho một sân bay.
geoTargetCanton

string

Tên tài nguyên của hằng số mục tiêu địa lý đại diện cho một bang.
geoTargetCity

string

Tên tài nguyên của hằng số mục tiêu địa lý đại diện cho một thành phố.
geoTargetCountry

string

Tên tài nguyên của hằng số mục tiêu địa lý đại diện cho một quốc gia.
geoTargetCounty

string

Tên tài nguyên của hằng số mục tiêu địa lý đại diện cho một hạt.
geoTargetDistrict

string

Tên tài nguyên của hằng số mục tiêu địa lý đại diện cho một quận.
geoTargetMetro

string

Tên tài nguyên của hằng số mục tiêu địa lý đại diện cho một thành phố lớn.
geoTargetMostSpecificLocation

string

Tên tài nguyên của hằng số mục tiêu địa lý biểu thị vị trí cụ thể nhất.
geoTargetPostalCode

string

Tên tài nguyên của hằng số mục tiêu địa lý biểu thị một mã bưu chính.
geoTargetProvince

string

Tên tài nguyên của hằng số mục tiêu địa lý đại diện cho một tỉnh.
geoTargetRegion

string

Tên tài nguyên của hằng số mục tiêu địa lý đại diện cho một khu vực.
geoTargetState

string

Tên tài nguyên của hằng số mục tiêu địa lý biểu thị một trạng thái.
hotelBookingWindowDays

string (int64 format)

Thời hạn đặt phòng khách sạn tính theo ngày.
hotelCenterId

string (int64 format)

Mã Hotel Center.
hotelCheckInDate

string

Ngày nhận phòng khách sạn. Được định dạng là yyyy-MM-dd.
hotelCity

string

Thành phố của khách sạn.
hotelClass

integer

Hạng khách sạn.
hotelCountry

string

Quốc gia của khách sạn.
hotelLengthOfStay

integer

Thời gian lưu trú tại khách sạn.
hotelRateRuleId

string

Mã quy tắc giá khách sạn.
hotelState

string

Tiểu bang của khách sạn.
hour

integer

Giờ trong ngày dưới dạng số từ 0 đến 23.
interactionOnThisExtension

boolean

Chỉ được dùng với các chỉ số về mục nguồn cấp dữ liệu. Cho biết liệu chỉ số tương tác xảy ra trên chính mục nguồn cấp dữ liệu hay một tiện ích hoặc đơn vị quảng cáo khác.
month

string

Tháng được thể hiện bằng ngày của ngày đầu tiên trong tháng. Được định dạng là yyyy-MM-dd.
partnerHotelId

string

Mã khách sạn đối tác.
productAggregatorId

string (int64 format)

Mã đơn vị tập hợp của sản phẩm.
productCategoryLevel1

string

Danh mục (cấp 1) của sản phẩm.
productCategoryLevel2

string

Danh mục (cấp 2) của sản phẩm.
productCategoryLevel3

string

Danh mục (cấp 3) của sản phẩm.
productCategoryLevel4

string

Danh mục (cấp 4) của sản phẩm.
productCategoryLevel5

string

Danh mục (cấp 5) của sản phẩm.
productBrand

string

Thương hiệu của sản phẩm.
productCountry

string

Tên tài nguyên của hằng số mục tiêu địa lý cho quốc gia bán của sản phẩm.
productCustomAttribute0

string

Thuộc tính tuỳ chỉnh 0 của sản phẩm.
productCustomAttribute1

string

Thuộc tính tuỳ chỉnh 1 của sản phẩm.
productCustomAttribute2

string

Thuộc tính tuỳ chỉnh 2 của sản phẩm.
productCustomAttribute3

string

Thuộc tính tuỳ chỉnh 3 của sản phẩm.
productCustomAttribute4

string

Thuộc tính tuỳ chỉnh 4 của sản phẩm.
productFeedLabel

string

Nhãn nguồn cấp dữ liệu của sản phẩm.
productItemId

string

Mã mặt hàng của sản phẩm.
productLanguage

string

Tên tài nguyên của hằng số ngôn ngữ cho ngôn ngữ của sản phẩm.
productMerchantId

string (int64 format)

Mã người bán của sản phẩm.
productStoreId

string

Mã cửa hàng của sản phẩm.
productTitle

string

Tiêu đề của sản phẩm.
productTypeL1

string

Loại (cấp 1) của sản phẩm.
productTypeL2

string

Loại (cấp 2) của sản phẩm.
productTypeL3

string

Loại (cấp 3) của sản phẩm.
productTypeL4

string

Loại (cấp 4) của sản phẩm.
productTypeL5

string

Loại (cấp 5) của sản phẩm.
quarter

string

Một quý được thể hiện bằng ngày đầu tiên của một quý. Sử dụng năm dương lịch cho các quý, ví dụ: quý 2 năm 2018 bắt đầu vào 2018-04-01. Được định dạng là yyyy-MM-dd.
searchSubcategory

string

Danh mục phụ cụm từ tìm kiếm. Một chuỗi trống biểu thị danh mục phụ tổng hợp cho các cụm từ tìm kiếm không phù hợp với một danh mục phụ khác.
searchTerm

string

Cụm từ tìm kiếm.
webpage

string

Tên tài nguyên của tiêu chí nhóm quảng cáo đại diện cho tiêu chí trang web.
week

string

Tuần được định nghĩa là thứ Hai đến Chủ Nhật và được biểu thị bằng ngày thứ Hai. Được định dạng là yyyy-MM-dd.
year

integer

Năm, có định dạng là yyyy.
skAdNetworkConversionValue

string (int64 format)

Giá trị chuyển đổi trên Mạng quảng cáo Bộ công cụ dành cho iOS Store. Giá trị rỗng có nghĩa là không thể áp dụng phân khúc này, ví dụ như chiến dịch không chạy trên iOS.
skAdNetworkSourceApp

object (SkAdNetworkSourceApp)

Ứng dụng mà quảng cáo thúc đẩy lượt cài đặt Mạng quảng cáo Bộ công cụ dành cho iOS Store được hiển thị. Giá trị rỗng có nghĩa là phân khúc này không thể áp dụng (chẳng hạn như chiến dịch không dành cho iOS) hoặc không có trong bất kỳ hệ thống đăng lại nào do Apple gửi.
skAdNetworkSourceDomain

string

Trang web nơi quảng cáo thúc đẩy lượt cài đặt Mạng quảng cáo Bộ công cụ iOS Store được hiển thị. Giá trị rỗng có nghĩa là phân khúc này không thể áp dụng (chẳng hạn như chiến dịch không dành cho iOS) hoặc không có trong bất kỳ hệ thống đăng lại nào do Apple gửi.
skAdNetworkPostbackSequenceIndex

string (int64 format)

Chỉ mục trình tự đăng lại trên Mạng quảng cáo của Bộ công cụ dành cho iOS Store.
assetInteractionTarget

object (AssetInteractionTarget)

Chỉ được sử dụng với các chỉ số CustomerAsset, CampaignAsset và AdGroupAsset. Cho biết liệu chỉ số về lượt tương tác xảy ra trên chính thành phần đó hay trên một thành phần hay đơn vị quảng cáo khác. Lượt tương tác (ví dụ: lượt nhấp) được tính trên tất cả các phần của quảng cáo được phân phát (ví dụ: chính Quảng cáo và các thành phần khác như Đường liên kết của trang web) khi các thành phần đó được phân phát cùng nhau. Khi engagementOnThisAsset là true, có nghĩa là các lượt tương tác diễn ra trên thành phần cụ thể này và khi engagementOnThisAsset là false, điều này có nghĩa là các lượt tương tác không xuất hiện trên thành phần cụ thể này mà trên các phần khác của quảng cáo được phân phát cùng với thành phần này.

AdDestinationType

Liệt kê các loại đích đến trên Google Ads

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Phiên bản này không xác định được giá trị.
NOT_APPLICABLE Quảng cáo không có ý định thúc đẩy người dùng rời khỏi quảng cáo đến các đích đến khác
WEBSITE Trang web
APP_STORE Cửa hàng ứng dụng iOS hoặc Cửa hàng Play
PHONE_CALL Trình quay số cuộc gọi
MAP_DIRECTIONS Ứng dụng bản đồ
LOCATION_LISTING Trang dành riêng cho từng vị trí
MESSAGE Tin nhắn văn bản
LEAD_FORM Biểu mẫu tạo khách hàng tiềm năng
YOUTUBE YouTube
UNMODELED_FOR_CONVERSIONS Đích đến của quảng cáo cho Lượt chuyển đổi có khoá không xác định

AdNetworkType

Liệt kê các loại mạng Google Ads.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Phiên bản này không xác định được giá trị.
SEARCH Tìm kiếm Google.
SEARCH_PARTNERS Đối tác tìm kiếm.
CONTENT Mạng hiển thị
MIXED Nhiều mạng.
YOUTUBE YouTube
GOOGLE_TV Google TV

BudgetCampaignAssociationStatus

Phân đoạn Ngân sáchCampaignAssociationStatus.

Biểu diễn dưới dạng JSON 
{
  "status": enum (BudgetCampaignAssociationStatus),
  "campaign": string
}
Trường
status

enum (BudgetCampaignAssociationStatus)

Trạng thái liên kết chiến dịch ngân sách.
campaign

string

Tên tài nguyên chiến dịch.

BudgetCampaignAssociationStatus

Trạng thái liên kết giữa Ngân sách và Chiến dịch có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
ENABLED Chiến dịch hiện đang sử dụng ngân sách.
REMOVED Chiến dịch không còn sử dụng ngân sách.

ClickType

Liệt kê các loại lượt nhấp trên Google Ads.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Phiên bản này không xác định được giá trị.
BREADCRUMBS Đường dẫn.
BROADBAND_PLAN Kế hoạch băng thông rộng.
CALL_TRACKING Đã gọi điện thoại theo cách thủ công.
CALLS Cuộc gọi điện thoại.
CLICK_ON_ENGAGEMENT_AD Nhấp vào quảng cáo tương tác.
GET_DIRECTIONS Hướng dẫn lái xe.
LOCATION_EXPANSION Nhận thông tin chi tiết về vị trí.
LOCATION_FORMAT_CALL Gọi.
LOCATION_FORMAT_DIRECTIONS Chỉ đường.
LOCATION_FORMAT_IMAGE Hình ảnh.
LOCATION_FORMAT_LANDING_PAGE Chuyển đến trang đích.
LOCATION_FORMAT_MAP Bản đồ.
LOCATION_FORMAT_STORE_INFO Chuyển đến thông tin cửa hàng.
LOCATION_FORMAT_TEXT Văn bản.
MOBILE_CALL_TRACKING Cuộc gọi điện thoại di động.
OFFER_PRINTS Cung cấp bản in.
OTHER Khác.
PRODUCT_EXTENSION_CLICKS Cung cấp plusbox sản phẩm.
PRODUCT_LISTING_AD_CLICKS Mua sắm – Sản phẩm – Trực tuyến.
STORE_LOCATOR Hiển thị vị trí lân cận.
URL_CLICKS Dòng tiêu đề.
VIDEO_APP_STORE_CLICKS Cửa hàng ứng dụng.
VIDEO_CALL_TO_ACTION_CLICKS Lớp phủ Gọi hành động.
VIDEO_CARD_ACTION_HEADLINE_CLICKS Thẻ.
VIDEO_END_CAP_CLICKS Hình tĩnh.
VIDEO_WEBSITE_CLICKS Trang web.
WIRELESS_PLAN Gói không dây.
PRODUCT_LISTING_AD_LOCAL Mua sắm – Sản phẩm – Địa phương.
PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL Mua sắm - Sản phẩm - Đa kênh địa phương.
PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE Mua sắm - Sản phẩm - Đa kênh trực tuyến.
PRODUCT_LISTING_ADS_COUPON Mua sắm - Sản phẩm - Phiếu giảm giá.
PRODUCT_LISTING_AD_TRANSACTABLE Mua sắm - Sản phẩm - Bán trên Google.
PROMOTION_EXTENSION Phần mở rộng về khuyến mại.
HOTEL_PRICE Giá khách sạn.
PRICE_EXTENSION Phần mở rộng về giá.
HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION Lựa chọn phòng trong giao diện Đặt phòng khách sạn trên Google.
SHOPPING_COMPARISON_LISTING Mua sắm - Danh sách so sánh.
CROSS_NETWORK Nhiều mạng. Trong chiến dịch Tối đa hoá hiệu suất và chiến dịch Khám phá.

ConversionAttributionEventType

Loại sự kiện của lượt chuyển đổi được phân bổ giá trị đóng góp.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Biểu thị giá trị không xác định trong phiên bản này.
IMPRESSION Lượt chuyển đổi được phân bổ cho một lượt hiển thị.
INTERACTION Lượt chuyển đổi được phân bổ cho một lượt tương tác.

ConversionLagBucket

Enum thể hiện số ngày tính từ lúc hiển thị đến lúc chuyển đổi.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
LESS_THAN_ONE_DAY Nhóm độ trễ của lượt chuyển đổi từ 0 đến 1 ngày. 0 ngày được bao gồm, 1 ngày không được bao gồm.
ONE_TO_TWO_DAYS Nhóm độ trễ của lượt chuyển đổi từ 1 đến 2 ngày. 1 ngày được bao gồm, 2 ngày thì không.
TWO_TO_THREE_DAYS Nhóm độ trễ của lượt chuyển đổi từ 2 đến 3 ngày. Giá trị này được tính trong 2 ngày, nhưng không áp dụng cho 3 ngày.
THREE_TO_FOUR_DAYS Nhóm độ trễ của lượt chuyển đổi từ 3 đến 4 ngày. Chỉ bao gồm 3 ngày, nhưng không tính 4 ngày.
FOUR_TO_FIVE_DAYS Nhóm độ trễ của lượt chuyển đổi từ 4 đến 5 ngày. Chỉ bao gồm 4 ngày, nhưng không tính 5 ngày.
FIVE_TO_SIX_DAYS Nhóm độ trễ của lượt chuyển đổi từ 5 đến 6 ngày. Bao gồm 5 ngày, nhưng không tính 6 ngày.
SIX_TO_SEVEN_DAYS Nhóm độ trễ của lượt chuyển đổi từ 6 đến 7 ngày. Chỉ bao gồm 6 ngày, 7 ngày thì không.
SEVEN_TO_EIGHT_DAYS Nhóm độ trễ của lượt chuyển đổi từ 7 đến 8 ngày. Chỉ bao gồm 7 ngày, nhưng không tính 8 ngày.
EIGHT_TO_NINE_DAYS Nhóm độ trễ của lượt chuyển đổi từ 8 đến 9 ngày. Chỉ bao gồm 8 ngày, nhưng không tính 9 ngày.
NINE_TO_TEN_DAYS Nhóm độ trễ của lượt chuyển đổi từ 9 đến 10 ngày. Giá trị này bao gồm 9 ngày, nhưng không tính 10 ngày.
TEN_TO_ELEVEN_DAYS Nhóm độ trễ của lượt chuyển đổi từ 10 đến 11 ngày. Chỉ bao gồm 10 ngày, nhưng không tính 11 ngày.
ELEVEN_TO_TWELVE_DAYS Nhóm độ trễ của lượt chuyển đổi từ 11 đến 12 ngày. 11 ngày là bao gồm, 12 ngày không phải là.
TWELVE_TO_THIRTEEN_DAYS Nhóm độ trễ của lượt chuyển đổi từ 12 đến 13 ngày. 12 ngày là bao gồm, 13 ngày không phải là.
THIRTEEN_TO_FOURTEEN_DAYS Nhóm độ trễ của lượt chuyển đổi từ 13 đến 14 ngày. 13 ngày là bao gồm, 14 ngày không phải là.
FOURTEEN_TO_TWENTY_ONE_DAYS Nhóm độ trễ của lượt chuyển đổi từ 14 đến 21 ngày. Chỉ bao gồm 14 ngày, nhưng không tính 21 ngày.
TWENTY_ONE_TO_THIRTY_DAYS Nhóm độ trễ của lượt chuyển đổi từ 21 đến 30 ngày. 21 ngày được bao gồm, 30 ngày không được bao gồm.
THIRTY_TO_FORTY_FIVE_DAYS Nhóm độ trễ của lượt chuyển đổi từ 30 đến 45 ngày. Bao gồm 30 ngày, nhưng không bao gồm 45 ngày.
FORTY_FIVE_TO_SIXTY_DAYS Nhóm độ trễ của lượt chuyển đổi từ 45 đến 60 ngày. 45 ngày thì được tính, 60 ngày thì không.
SIXTY_TO_NINETY_DAYS Nhóm độ trễ của lượt chuyển đổi từ 60 đến 90 ngày. Bao gồm 60 ngày, nhưng không bao gồm 90 ngày.

ConversionOrAdjustmentLagBucket

Enum thể hiện số ngày giữa lượt hiển thị và lượt chuyển đổi hoặc giữa lượt hiển thị và mức điều chỉnh đối với lượt chuyển đổi.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
CONVERSION_LESS_THAN_ONE_DAY Nhóm độ trễ của lượt chuyển đổi từ 0 đến 1 ngày. 0 ngày được bao gồm, 1 ngày không được bao gồm.
CONVERSION_ONE_TO_TWO_DAYS Nhóm độ trễ của lượt chuyển đổi từ 1 đến 2 ngày. 1 ngày được bao gồm, 2 ngày thì không.
CONVERSION_TWO_TO_THREE_DAYS Nhóm độ trễ của lượt chuyển đổi từ 2 đến 3 ngày. Giá trị này được tính trong 2 ngày, nhưng không áp dụng cho 3 ngày.
CONVERSION_THREE_TO_FOUR_DAYS Nhóm độ trễ của lượt chuyển đổi từ 3 đến 4 ngày. Chỉ bao gồm 3 ngày, nhưng không tính 4 ngày.
CONVERSION_FOUR_TO_FIVE_DAYS Nhóm độ trễ của lượt chuyển đổi từ 4 đến 5 ngày. Chỉ bao gồm 4 ngày, nhưng không tính 5 ngày.
CONVERSION_FIVE_TO_SIX_DAYS Nhóm độ trễ của lượt chuyển đổi từ 5 đến 6 ngày. Bao gồm 5 ngày, nhưng không tính 6 ngày.
CONVERSION_SIX_TO_SEVEN_DAYS Nhóm độ trễ của lượt chuyển đổi từ 6 đến 7 ngày. Chỉ bao gồm 6 ngày, 7 ngày thì không.
CONVERSION_SEVEN_TO_EIGHT_DAYS Nhóm độ trễ của lượt chuyển đổi từ 7 đến 8 ngày. Chỉ bao gồm 7 ngày, nhưng không tính 8 ngày.
CONVERSION_EIGHT_TO_NINE_DAYS Nhóm độ trễ của lượt chuyển đổi từ 8 đến 9 ngày. Chỉ bao gồm 8 ngày, nhưng không tính 9 ngày.
CONVERSION_NINE_TO_TEN_DAYS Nhóm độ trễ của lượt chuyển đổi từ 9 đến 10 ngày. Giá trị này bao gồm 9 ngày, nhưng không tính 10 ngày.
CONVERSION_TEN_TO_ELEVEN_DAYS Nhóm độ trễ của lượt chuyển đổi từ 10 đến 11 ngày. Chỉ bao gồm 10 ngày, nhưng không tính 11 ngày.
CONVERSION_ELEVEN_TO_TWELVE_DAYS Nhóm độ trễ của lượt chuyển đổi từ 11 đến 12 ngày. 11 ngày là bao gồm, 12 ngày không phải là.
CONVERSION_TWELVE_TO_THIRTEEN_DAYS Nhóm độ trễ của lượt chuyển đổi từ 12 đến 13 ngày. 12 ngày là bao gồm, 13 ngày không phải là.
CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS Nhóm độ trễ của lượt chuyển đổi từ 13 đến 14 ngày. 13 ngày là bao gồm, 14 ngày không phải là.
CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS Nhóm độ trễ của lượt chuyển đổi từ 14 đến 21 ngày. Chỉ bao gồm 14 ngày, nhưng không tính 21 ngày.
CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS Nhóm độ trễ của lượt chuyển đổi từ 21 đến 30 ngày. 21 ngày được bao gồm, 30 ngày không được bao gồm.
CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS Nhóm độ trễ của lượt chuyển đổi từ 30 đến 45 ngày. Bao gồm 30 ngày, nhưng không bao gồm 45 ngày.
CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS Nhóm độ trễ của lượt chuyển đổi từ 45 đến 60 ngày. 45 ngày thì được tính, 60 ngày thì không.
CONVERSION_SIXTY_TO_NINETY_DAYS Nhóm độ trễ của lượt chuyển đổi từ 60 đến 90 ngày. Bao gồm 60 ngày, nhưng không bao gồm 90 ngày.
ADJUSTMENT_LESS_THAN_ONE_DAY Nhóm độ trễ điều chỉnh lượt chuyển đổi từ 0 đến 1 ngày. 0 ngày được bao gồm, 1 ngày không được bao gồm.
ADJUSTMENT_ONE_TO_TWO_DAYS Nhóm độ trễ điều chỉnh lượt chuyển đổi từ 1 đến 2 ngày. 1 ngày được bao gồm, 2 ngày thì không.
ADJUSTMENT_TWO_TO_THREE_DAYS Nhóm độ trễ điều chỉnh lượt chuyển đổi từ 2 đến 3 ngày. Giá trị này được tính trong 2 ngày, nhưng không áp dụng cho 3 ngày.
ADJUSTMENT_THREE_TO_FOUR_DAYS Nhóm độ trễ điều chỉnh lượt chuyển đổi từ 3 đến 4 ngày. Chỉ bao gồm 3 ngày, nhưng không tính 4 ngày.
ADJUSTMENT_FOUR_TO_FIVE_DAYS Nhóm độ trễ điều chỉnh lượt chuyển đổi từ 4 đến 5 ngày. Chỉ bao gồm 4 ngày, nhưng không tính 5 ngày.
ADJUSTMENT_FIVE_TO_SIX_DAYS Nhóm độ trễ điều chỉnh lượt chuyển đổi từ 5 đến 6 ngày. Bao gồm 5 ngày, nhưng không tính 6 ngày.
ADJUSTMENT_SIX_TO_SEVEN_DAYS Nhóm độ trễ điều chỉnh lượt chuyển đổi từ 6 đến 7 ngày. Chỉ bao gồm 6 ngày, nhưng không tính 7 ngày.
ADJUSTMENT_SEVEN_TO_EIGHT_DAYS Nhóm độ trễ điều chỉnh lượt chuyển đổi từ 7 đến 8 ngày. Chỉ bao gồm 7 ngày, nhưng không tính 8 ngày.
ADJUSTMENT_EIGHT_TO_NINE_DAYS Nhóm độ trễ điều chỉnh lượt chuyển đổi từ 8 đến 9 ngày. Chỉ bao gồm 8 ngày, nhưng không tính 9 ngày.
ADJUSTMENT_NINE_TO_TEN_DAYS Nhóm độ trễ điều chỉnh lượt chuyển đổi từ 9 đến 10 ngày. Giá trị này bao gồm 9 ngày, nhưng không tính 10 ngày.
ADJUSTMENT_TEN_TO_ELEVEN_DAYS Nhóm độ trễ điều chỉnh lượt chuyển đổi từ 10 đến 11 ngày. Chỉ bao gồm 10 ngày, nhưng không tính 11 ngày.
ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS Nhóm độ trễ điều chỉnh lượt chuyển đổi từ 11 đến 12 ngày. 11 ngày là bao gồm, 12 ngày không phải là.
ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS Nhóm độ trễ điều chỉnh lượt chuyển đổi từ 12 đến 13 ngày. 12 ngày là bao gồm, 13 ngày không phải là.
ADJUSTMENT_THIRTEEN_TO_FOURTEEN_DAYS Nhóm độ trễ điều chỉnh lượt chuyển đổi từ 13 đến 14 ngày. 13 ngày là bao gồm, 14 ngày không phải là.
ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS Nhóm độ trễ điều chỉnh lượt chuyển đổi từ 14 đến 21 ngày. Chỉ bao gồm 14 ngày, nhưng không tính 21 ngày.
ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS Nhóm độ trễ điều chỉnh lượt chuyển đổi từ 21 đến 30 ngày. Bao gồm 21 ngày nhưng không bao gồm 30 ngày.
ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS Nhóm độ trễ điều chỉnh lượt chuyển đổi từ 30 đến 45 ngày. Bao gồm 30 ngày, nhưng không bao gồm 45 ngày.
ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS Nhóm độ trễ điều chỉnh lượt chuyển đổi từ 45 đến 60 ngày. Bao gồm 45 ngày, nhưng không bao gồm 60 ngày.
ADJUSTMENT_SIXTY_TO_NINETY_DAYS Nhóm độ trễ điều chỉnh lượt chuyển đổi từ 60 đến 90 ngày. Bao gồm 60 ngày, nhưng không bao gồm 90 ngày.
ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS Nhóm độ trễ điều chỉnh lượt chuyển đổi từ 90 đến 145 ngày. 90 ngày là bao gồm, 145 ngày thì không.
CONVERSION_UNKNOWN Nhóm độ trễ của lượt chuyển đổi KHÔNG XÁC ĐỊNH. Đây là giá trị cho những ngày trước khi có nhóm độ trễ của lượt chuyển đổi trong Google Ads.
ADJUSTMENT_UNKNOWN Nhóm độ trễ điều chỉnh lượt chuyển đổi KHÔNG XÁC ĐỊNH. Đây là dữ liệu cho những ngày trước khi có nhóm độ trễ điều chỉnh lượt chuyển đổi trong Google Ads.

ExternalConversionSource

Nguồn chuyển đổi bên ngoài được liên kết với một ConversionAction.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Biểu thị giá trị không xác định trong phiên bản này.
WEBPAGE Lượt chuyển đổi xảy ra khi người dùng chuyển đến một trang web cụ thể sau khi xem quảng cáo; Được hiển thị trong giao diện người dùng Google Ads dưới dạng "Trang web".
ANALYTICS Lượt chuyển đổi đến từ mục tiêu hoặc giao dịch Google Analytics được liên kết; Được hiển thị trong giao diện người dùng Google Ads dưới dạng "Analytics".
UPLOAD Lượt chuyển đổi trên trang web được tải lên thông qua ConversionUploadService; Được hiển thị trong giao diện người dùng Google Ads dưới dạng "Nhập từ lượt nhấp".
AD_CALL_METRICS Lượt chuyển đổi xảy ra khi người dùng nhấp trực tiếp vào phần mở rộng về cuộc gọi trên quảng cáo; Được hiển thị trong giao diện người dùng Google Ads dưới dạng "Cuộc gọi từ quảng cáo".
WEBSITE_CALL_METRICS Lượt chuyển đổi xảy ra khi người dùng gọi đến một số điện thoại được tạo tự động (bằng JavaScript đã cài đặt) từ trang web của nhà quảng cáo sau khi nhấp vào quảng cáo; Được hiển thị trong giao diện người dùng Google Ads dưới dạng "Cuộc gọi từ trang web".
STORE_VISITS Lượt chuyển đổi xảy ra khi người dùng ghé thăm cửa hàng bán lẻ của một nhà quảng cáo sau khi nhấp vào một quảng cáo của Google; Được hiển thị trong giao diện người dùng Google Ads dưới dạng "Lượt ghé thăm cửa hàng thực tế".
ANDROID_IN_APP Lượt chuyển đổi xảy ra khi người dùng thực hiện một hành động trong ứng dụng, chẳng hạn như mua hàng trong một ứng dụng Android; Được hiển thị trong giao diện người dùng Google Ads dưới dạng "Hành động trong ứng dụng Android".
IOS_IN_APP Lượt chuyển đổi xảy ra khi người dùng thực hiện một hành động trong ứng dụng, chẳng hạn như mua hàng trong một ứng dụng iOS; Được hiển thị trong giao diện người dùng Google Ads dưới dạng "Hành động trong ứng dụng iOS".
IOS_FIRST_OPEN Lượt chuyển đổi xảy ra khi người dùng mở một ứng dụng iOS lần đầu tiên; Hiển thị trong giao diện người dùng Google Ads dưới dạng "Lượt cài đặt ứng dụng iOS (mở lần đầu)".
APP_UNSPECIFIED Lượt chuyển đổi ứng dụng cũ không được cung cấp AppPlatform; Được hiển thị trong giao diện người dùng Google Ads dưới dạng "Ứng dụng dành cho thiết bị di động".
ANDROID_FIRST_OPEN Lượt chuyển đổi xảy ra khi người dùng mở một ứng dụng Android lần đầu tiên; Hiển thị trong giao diện người dùng Google Ads dưới dạng "Lượt cài đặt ứng dụng Android (mở lần đầu)".
UPLOAD_CALLS Lượt chuyển đổi cuộc gọi được tải lên thông qua ConversionUploadService; Được hiển thị trong giao diện người dùng Google Ads dưới dạng "Nhập từ cuộc gọi".
FIREBASE Lượt chuyển đổi đến từ một sự kiện Firebase được liên kết; Được hiển thị trong giao diện người dùng Google Ads dưới dạng "Firebase".
CLICK_TO_CALL Lượt chuyển đổi xảy ra khi người dùng nhấp vào một số điện thoại di động; Được hiển thị trong giao diện người dùng Google Ads dưới dạng "Lượt nhấp vào số điện thoại".
SALESFORCE Lượt chuyển đổi đến từ Salesforce; Được hiển thị trong giao diện người dùng Google Ads là "Salesforce.com".
STORE_SALES_CRM Lượt chuyển đổi đến từ các lượt mua hàng tại cửa hàng thực tế do CRM ghi lại; Được hiển thị trong giao diện người dùng Google Ads dưới dạng "Lượt bán hàng tại cửa hàng thực tế (đối tác dữ liệu)".
STORE_SALES_PAYMENT_NETWORK Lượt chuyển đổi đến từ các giao dịch mua hàng tại cửa hàng từ mạng thanh toán; Được hiển thị trong giao diện người dùng Google Ads dưới dạng "Lượt bán hàng tại cửa hàng thực tế (mạng thanh toán)".
GOOGLE_PLAY Chuyển đổi trên Google Play không dùng mã; Được hiển thị trong giao diện người dùng Google Ads là "Google Play".
THIRD_PARTY_APP_ANALYTICS Lượt chuyển đổi đến từ một sự kiện phân tích ứng dụng bên thứ ba được liên kết; Được hiển thị trong giao diện người dùng Google Ads dưới dạng "Phân tích ứng dụng bên thứ ba".
GOOGLE_ATTRIBUTION Lượt chuyển đổi do Google Attribution kiểm soát.
STORE_SALES_DIRECT_UPLOAD Lượt chuyển đổi dẫn đến lượt bán hàng tại cửa hàng thực tế dựa trên dữ liệu người bán của bên thứ nhất hoặc bên thứ ba mà bạn tải lên. Được hiển thị trong giao diện người dùng Google Ads dưới dạng "Lượt bán hàng tại cửa hàng thực tế (tải lên trực tiếp)".
STORE_SALES Lượt chuyển đổi dẫn đến lượt bán hàng tại cửa hàng thực tế dựa trên dữ liệu người bán của bên thứ nhất hoặc bên thứ ba được tải lên và/hoặc từ các lượt mua hàng tại cửa hàng thực tế bằng thẻ từ các mạng thanh toán. Được hiển thị trong giao diện người dùng Google Ads dưới dạng "Lượt bán hàng tại cửa hàng thực tế".
SEARCH_ADS_360 Lượt chuyển đổi được nhập từ dữ liệu Floodlight của Search Ads 360.
GOOGLE_HOSTED Lượt chuyển đổi theo dõi hành động liên quan đến địa điểm thực tế từ các sản phẩm và dịch vụ của Google sau khi tương tác với quảng cáo.
FLOODLIGHT Lượt chuyển đổi do thẻ Floodlight báo cáo.
ANALYTICS_SEARCH_ADS_360 Lượt chuyển đổi đến từ Google Analytics dành riêng cho Search Ads 360. Được hiển thị trong giao diện người dùng Google Ads dưới dạng Analytics (SA360).
FIREBASE_SEARCH_ADS_360 Lượt chuyển đổi đến từ một sự kiện Firebase được liên kết cho Search Ads 360.
DISPLAY_AND_VIDEO_360_FLOODLIGHT Lượt chuyển đổi do Floodlight báo cáo cho DV360.

HotelRateType

Enum mô tả các loại giá khách sạn có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Phiên bản này không xác định được giá trị.
UNAVAILABLE Không có thông tin về loại giá.
PUBLIC_RATE Mức giá áp dụng cho mọi người.
QUALIFIED_RATE Giá tham gia chương trình thành viên được áp dụng và đáp ứng các yêu cầu cơ bản như đăng mức giá công khai. Nội dung trong giao diện người dùng sẽ bỏ qua mức giá công khai và cho biết có chiết khấu cho người dùng. Để biết thêm thông tin về Mức giá đủ điều kiện, hãy truy cập vào https://developers.google.com/hotels/hotel-ads/dev-guide/qualified-rates
PRIVATE_RATE Mức giá được cung cấp cho những người dùng đáp ứng một số tiêu chí, ví dụ: tất cả người dùng đã đăng nhập, 20% người dùng thiết bị di động, tất cả người dùng thiết bị di động ở Canada, v.v.

HotelPriceBucket

Enum mô tả nhóm giá khách sạn có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Phiên bản này không xác định được giá trị.
LOWEST_UNIQUE Giá thấp nhất duy nhất. Đối tác có giá thấp nhất và không có đối tác nào khác có mức giá chênh lệch nhỏ.
LOWEST_TIED Trong phạm vi mức giá thấp nhất. Đối tác nằm trong khoảng chênh lệch nhỏ về mức giá thấp nhất.
NOT_LOWEST Không phải giá thấp nhất. Đối tác không thuộc những khu vực có mức giá thấp nhất.
ONLY_PARTNER_SHOWN Đối tác là đối tác duy nhất được hiển thị.

Từ khóa

Phân đoạn theo Tiêu chí từ khoá.

Biểu diễn dưới dạng JSON 
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
Trường
info

object (KeywordInfo)

Thông tin về từ khoá.
adGroupCriterion

string

Tên tài nguyên Tiêu chí nhóm quảng cáo.

SearchEngineResultsPageType

Loại trang kết quả của công cụ tìm kiếm.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
ADS_ONLY Chỉ quảng cáo được chứa trong trang kết quả của công cụ tìm kiếm.
ORGANIC_ONLY Chỉ các kết quả không phải trả tiền mới được đưa vào trang kết quả của công cụ tìm kiếm.
ADS_AND_ORGANIC Cả quảng cáo và kết quả tự nhiên đều được đưa vào trang kết quả của công cụ tìm kiếm.

SearchTermMatchType

Các kiểu khớp có thể có cho một từ khoá đang kích hoạt quảng cáo, bao gồm cả các biến thể.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
BROAD Kiểu khớp mở rộng.
EXACT Kiểu khớp chính xác.
PHRASE Đối sánh cụm từ.
NEAR_EXACT Đối sánh chính xác (biến thể gần đúng).
NEAR_PHRASE Đối sánh cụm từ (biến thể gần đúng).

Vùng

Liệt kê các vị trí có thể có của Quảng cáo.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Phiên bản này không xác định được giá trị.
SEARCH_SIDE Tìm kiếm của Google: Bên cạnh.
SEARCH_TOP Tìm kiếm của Google: Trên cùng.
SEARCH_OTHER Google Tìm kiếm: Khác.
CONTENT Mạng Hiển thị của Google.
SEARCH_PARTNER_TOP Đối tác tìm kiếm: Trên cùng.
SEARCH_PARTNER_OTHER Đối tác tìm kiếm: Khác.
MIXED Nhiều mạng.

ConversionValueRulePrimaryDimension

Xác định phương diện chính cho số liệu thống kê về quy tắc giá trị chuyển đổi.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
NO_RULE_APPLIED Đối với những lượt chuyển đổi không có quy tắc giá trị áp dụng sau khi bật quy tắc giá trị.
ORIGINAL Dưới đây là các lượt chuyển đổi được áp dụng theo quy tắc giá trị: Số liệu thống kê ban đầu.
NEW_VS_RETURNING_USER Khi khách hàng đáp ứng điều kiện mới hoặc khách hàng cũ.
GEO_LOCATION Khi điều kiện Vị trí địa lý tại thời điểm truy vấn được đáp ứng.
DEVICE Khi điều kiện của thiết bị duyệt tại thời điểm truy vấn được đáp ứng.
AUDIENCE Khi điều kiện về đối tượng tại thời điểm truy vấn được đáp ứng.
MULTIPLE Khi áp dụng nhiều quy tắc.

SkAdNetworkUserType

Liệt kê các kiểu người dùng SkAdNetwork

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Phiên bản này không xác định được giá trị.
UNAVAILABLE Giá trị không có trong hệ thống đăng lại hoặc chúng tôi không có dữ liệu này vì lý do khác.
NEW_INSTALLER Người dùng cài đặt ứng dụng lần đầu tiên.
REINSTALLER Người dùng đã cài đặt ứng dụng này trước đó.

SkAdNetworkAdEventType

Liệt kê các loại sự kiện quảng cáo SkAdNetwork

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Phiên bản này không xác định được giá trị.
UNAVAILABLE Giá trị không có trong hệ thống đăng lại hoặc chúng tôi không có dữ liệu này vì lý do khác.
INTERACTION Người dùng đã tương tác với quảng cáo.
VIEW Người dùng đã xem quảng cáo.

SkAdNetworkSourceApp

Phân khúc SkAdNetworkSourceApp.

Biểu diễn dưới dạng JSON 
{
  "skAdNetworkSourceAppId": string
}
Trường
skAdNetworkSourceAppId

string

Mã ứng dụng mà quảng cáo thúc đẩy lượt cài đặt Mạng quảng cáo Bộ công cụ iOS Store đã hiển thị.

SkAdNetworkAttributionCredit

Liệt kê tín dụng phân bổ SkAdNetwork.

Enum
UNSPECIFIED Giá trị mặc định. Giá trị này tương đương với giá trị rỗng.
UNKNOWN Không xác định được giá trị trong phiên bản API này. Hệ thống không thể trả về giá trị enum đúng trong phiên bản API này hoặc giá trị này chưa được hỗ trợ.
UNAVAILABLE Giá trị không có trong hệ thống đăng lại hoặc chúng tôi không có dữ liệu này vì lý do khác.
WON Google là mạng quảng cáo đã giành được phân bổ quảng cáo.
CONTRIBUTED Google đủ điều kiện tham gia phân bổ nhưng không giành chiến thắng.

SkAdNetworkSourceType

Liệt kê các loại nguồn SkAdNetwork

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Phiên bản này không xác định được giá trị.
UNAVAILABLE Mã ứng dụng nguồn hoặc miền nguồn không có trong hệ thống đăng lại hoặc chúng tôi không có dữ liệu này vì lý do khác.
WEBSITE Quảng cáo được hiển thị trên một trang web.
MOBILE_APPLICATION Quảng cáo đã xuất hiện trong một ứng dụng.

AssetInteractionTarget

Phân đoạn Assettương đối mục tiêu.

Biểu diễn dưới dạng JSON 
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
Trường
asset

string

Tên tài nguyên thành phần.
interactionOnThisAsset

boolean

Chỉ được sử dụng với các chỉ số CustomerAsset, CampaignAsset và AdGroupAsset. Cho biết liệu chỉ số về lượt tương tác xảy ra trên chính thành phần đó hay trên một thành phần/đơn vị quảng cáo khác.

ConvertingUserPriorEngagementTypeAndLtvBucket

Liệt kê các loại tương tác trước đây của người dùng chuyển đổi và nhóm giá trị vòng đời

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Phiên bản này không xác định được giá trị.
NEW Việc chuyển đổi người dùng là một điều mới mẻ đối với nhà quảng cáo.
RETURNING Khi người dùng chuyển đổi, người dùng quay lại nhà quảng cáo. Định nghĩa về khách hàng quay lại sẽ khác nhau giữa các loại chuyển đổi, chẳng hạn như lượt ghé thăm cửa hàng thực tế thứ hai so với lượt mua hàng trực tuyến thứ hai.
NEW_AND_HIGH_LTV Việc chuyển đổi người dùng là một hành động mới đối với nhà quảng cáo và có giá trị vòng đời cao.