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)
  },
  "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)
  },
  "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)
  },
  "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)
  },
  "mobileAppCategoryConstant": {
    object (MobileAppCategoryConstant)
  },
  "mobileDeviceConstant": {
    object (MobileDeviceConstant)
  },
  "offlineUserDataJob": {
    object (OfflineUserDataJob)
  },
  "operatingSystemVersionConstant": {
    object (OperatingSystemVersionConstant)
  },
  "paidOrganicSearchTermView": {
    object (PaidOrganicSearchTermView)
  },
  "qualifyingQuestion": {
    object (QualifyingQuestion)
  },
  "parentalStatusView": {
    object (ParentalStatusView)
  },
  "perStoreView": {
    object (PerStoreView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "productLink": {
    object (ProductLink)
  },
  "recommendation": {
    object (Recommendation)
  },
  "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)
  },
  "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 kiểu kết hợp thành phần quảng cáo của nhóm quảng cáo trong truy vấn.

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)

Nhóm thành phần 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 tham chiếu trong truy vấn.

adGroupBidModifier

object (AdGroupBidModifier)

Hệ số 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í 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 phần mở rộng cấp 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 thành phầ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 tham chiếu 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 bộ thành phần được tham chiếu trong truy vấn.

assetSet

object (AssetSet)

Nhóm 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 tham chiếu trong truy vấn.

biddingSeasonalityAdjustment

object (BiddingSeasonalityAdjustment)

Mức điều chỉnh theo thời vụ đặt giá thầu được tham chiếu 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)

Mô phỏng chiến lược đặt giá thầu được tham chiếu trong truy vấn.

billingSetup

object (BillingSetup)

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

callView

object (CallView)

Khung hiển thị 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)

Nhóm 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 tham chiếu trong truy vấn.

campaignBidModifier

object (CampaignBidModifier)

Hệ số sửa đổi giá thầu của chiến dịch được tham chiếu trong truy vấn.

campaignConversionGoal

object (CampaignConversionGoal)

CampaignChuyển đổimụ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)

Tùy biến chiến dịch được tham chiếu trong truy vấn.

campaignDraft

object (CampaignDraft)

Bản dự thảo chiến dịch được tham chiếu trong truy vấn.

campaignExtensionSetting

object (CampaignExtensionSetting)

Chế độ cài đặt phần mở rộng cấp 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.

campaignSearchTermInsight

object (CampaignSearchTermInsight)

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

campaignSharedSet

object (CampaignSharedSet)

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

campaignSimulation

object (CampaignSimulation)

Phần 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 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)

CustomconversionTarget đượ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 nhắc đến 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)

Nhóm thành phần 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)

Khách hàngChuyển đổi mục tiêu được tham chiếu trong truy vấn.

customerExtensionSetting

object (CustomerExtensionSetting)

Cài đặt tiện ích 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.

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 dẫn 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 tùy biến quảng cáo đượ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 chi tiết về nhân khẩu học được tham chiếu 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 phần mở rộng đượ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 của mục nguồn cấp dữ liệu được tham chiếu trong truy vấn.

feedMapping

object (FeedMapping)

Mối liên kết nguồn cấp dữ liệu được tham chiếu trong truy vấn.

feedPlaceholderView

object (FeedPlaceholderView)

Khung hiển thị 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 tham chiếu 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)

Chế độ xem 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 tham chiếu trong truy vấn.

keywordPlanCampaignKeyword

object (KeywordPlanCampaignKeyword)

Từ khoá chiến dịch kế hoạch từ khoá được tham chiếu 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 số 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.

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.

offlineUserDataJob

object (OfflineUserDataJob)

Công việc 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 dẫn chiếu trong truy vấn.

qualifyingQuestion

object (QualifyingQuestion)

Câu hỏi định lượng được tham chiếu 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 mỗi cửa hàng được tham chiếu trong truy vấn.

productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

Danh mục Đặt giá thầu sản phẩm được tham chiếu trong truy vấn.

productGroupView

object (ProductGroupView)

Chế độ xem nhóm sản phẩm được tham chiếu trong truy vấn.

recommendation

object (Recommendation)

Đề 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)

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

sharedSet

object (SharedSet)

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

smartCampaignSetting

object (SmartCampaignSetting)

Chế độ cài đặt Chiến dịch thông minh được tham chiếu 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 dẫn chiếu 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 du lịch được tham chiếu trong truy vấn.

travelActivityPerformanceView

object (TravelActivityPerformanceView)

Chế độ xem hiệu suất của hoạt động du lịch đượ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 tham chiếu 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 tái tiếp thị được tham chiếu 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 biểu mẫu khách hàng tiềm năng đượ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. Bảng này chứa thông tin về ngân sách, cũng như những thay đổi được phê duyệt gần đây nhất đối với ngân sách và những thay đổi được đề xuất đang chờ phê duyệt. Những thay đổi được đề xuất đang chờ phê duyệt (nếu có) nằm trong phần 'Đang chờ đề xuất'. Bạn có thể xem thông tin chi tiết về ngân sách hiệu quả trong các trường có tiền tố là " approved_", "adjusted_" và các trường không có tiền tố. Vì một số thông tin chi tiết mang lại hiệu quả có thể khác với yêu cầu ban đầu của người dùng (ví dụ: hạn mức chi tiêu), những điểm khác biệt này được xếp cạnh nhau thông qua các trường "proposed_", "Approved_" và có thể là "adjusted_".

Tài nguyên này được thay đổi bằng cách sử dụng AccountBudget{/6} 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 một thời điểm bất kỳ. Câu trả lời này được đọc từ mục Đề xuất đang chờ xử lý.

Sau khi được phê duyệt, ngân sách có thể chịu sự điều chỉnh, chẳng hạn như mức đ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 các trường "đã phê duyệt" và "đã điều chỉnh", những trường này sẽ giống hệt 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ề sự điều chỉnh là 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 micrô giây.

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

pendingProposal

object (PendingAccountBudgetProposal)

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

id

string (int64 format)

Chỉ có đầu ra. Mã của 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 của 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 ở định dạng yyyy-MM-dd HH:mm:ss. Nếu loại thời gian bắt đầu là NOW đề xuất, thì đây là thời gian 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 ở đị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 sẽ là thời gian 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 chiếu 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 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:
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 được đề xuất dưới dạng loại được xác định rõ, ví dụ: VĨNH VIỄN.

Trường 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 của 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 sẽ là thời gian phê duyệt. approved_end_time chỉ có thể là một trong những trạng thái sau:

approvedEndDateTime

string

Chỉ có đầu ra. Thời gian kết thúc được phê duyệt ở đị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 dưới dạng một loại được xác định rõ, ví dụ: VĨNH VIỄN.

Trường 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:
proposedSpendingLimitMicros

string (int64 format)

Chỉ có đầu ra. Hạn mức chi tiêu đề xuất tính theo phần cực nhỏ. 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 dưới dạng một loại được xác định rõ ràng. Ví dụ: INFINITE.

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

Ví dụ: nếu số tiền mà 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:

approvedSpendingLimitMicros

string (int64 format)

Chỉ có đầu ra. Hạn mức chi tiêu được phê duyệt theo cực nhỏ. Một triệu tương đương với một đơn vị. Ngân sách này sẽ chỉ được điền nếu hạn mức chi tiêu đề xuất là hữu 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. Hạn mức chi tiêu được phê duyệt dưới dạng một loại được xác định rõ, ví dụ: INFINITE. Thông tin này sẽ chỉ được điền nếu hạn mức chi tiêu được phê duyệt là INFINITE.

Trường 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 trong total_adjusts_micros.

Giá trị này là quyết định cuối cùng về số tiền mà 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:

adjustedSpendingLimitMicros

string (int64 format)

Chỉ có đầu ra. Hạn mức chi tiêu được điều chỉnh theo phần cực nhỏ. 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à hữu hạn, thì hạn mức chi tiêu được điều chỉnh có thể thay đổi tuỳ thuộc vào các loại nội dung điều chỉnh áp dụng cho ngân sách này, nếu có.

Các loại điều chỉnh khác nhau được mô tả tại đây: https://support.google.com/google-ads/answer/1704323

Ví dụ: điều chỉnh ghi nợ sẽ làm 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 dưới dạng một loại được xác định rõ ràng. Ví dụ: INFINITE. Ngân sách này sẽ chỉ được điền sẵn nếu hạn mức chi tiêu được điều chỉnh là INFINITE. Hạn mức chi tiêu này được đảm bảo 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 một Ngân sách tài khoản.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho 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 đã hủy ngân sách tài khoản.

PendingAccountBudgetProposal

Một đề xuất đang chờ xử lý liên kết với ngân sách cấp tài khoản đi kèm, 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 được 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 AccountNgân sách đề xuất có dạng:

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 ở đị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 chiếu ngân sách này trong hoá đơn hằng tháng của họ.

notes

string

Chỉ có đầu ra. 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 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:
endDateTime

string

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

endTimeType

enum (TimeType)

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

Trường 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:
spendingLimitMicros

string (int64 format)

Chỉ có đầu ra. Hạn mức chi tiêu cực nhỏ. 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 dưới dạng 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ợ Mạng AdAssetAssetView cho Quảng cáo tìm kiếm thích ứng (theo kế hoạch cho nhiều loại quảng cáo hơn 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 kết hợp thành phần quảng cáo của 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_hợp_id_high và mã 64 bit dưới được lưu trữ trong asset_ valid_id_low. Tên tài nguyên chế độ xem Kết hợp Thành phần quảng cáo 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. Nội dung đượ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, kiểu kế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 giá trị là sai, điều đó có nghĩa 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 của 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 tài sản.

servedAssetFieldType

enum (ServedAssetFieldType)

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

AdGroupAdAssetView

Đường liên kết giữa Nhóm quảng cáo và Thành phần. Hiện tại, chúng tôi chỉ hỗ trợ nhóm Nhóm quảng cáoAdAssetView 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),
  "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 của 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 (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 về chính sách của 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.

adGroupAd

string

Chỉ có đầu ra. Quảng cáo trong nhóm quảng cáo mà thành phầ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 của 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 đó sẽ được liên kết với phiên bản mới nhất của quảng cáo. Nếu giá trị là sai, điều đó có nghĩa 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 của 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 liên quan đến chính sách đối với 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 của nhóm quảng cáo này trong quy 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 nhóm quảng cáo. Bao gồm dữ liệu hiệu suất từ sở thích và danh sách tiếp thị lại cho quảng cáo trên Mạng hiển thị và Mạng YouTube cũng như danh sách tiếp thị lại 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 của 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í của 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 lần lượt được trình bày chi tiết bên dưới. Hoạt động mô phỏng Tiêu chí nhóm quảng cáo khách sạn bắt đầu từ phiên bản 5.

  1. DISPLAY - KEY - CPC_BID - UNIFORM
  2. TÌM KIẾM - TỪ khóa - 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í của nhóm quảng cáo có dạng:

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

type

enum (SimulationType)

Chỉ có đầu ra. Trường mà hoạt động 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 này.

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 dùng để mô phỏng, có định dạng YYYY-MM-DD.

endDate

string

Chỉ có đầu ra. Ngày cuối cùng mà mô phỏng dựa trên, có định dạng YYYY-MM-DD.

Trường 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:
cpcBidPointList

object (CpcBidSimulationPointList)

Chỉ có đầu ra. Các đ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ô phỏng sẽ sửa đổi.

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

SimulationModificationMethod

Enum mô tả phương thức mà quá trình 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ề. Đại diện cho giá trị không xác định trong phiên bản này.
UNIFORM Các giá trị trong một hoạt động mô phỏng được áp dụng thống nhất cho tất cả thành phần con của một tài nguyên nhất định. Cơ chế ghi đè tài nguyên con không được tuân thủ.
DEFAULT Các giá trị trong quá trình mô phỏng được áp dụng cho tài nguyên đã cho. Cơ chế ghi đè đối với tài nguyên con được áp dụng, đồng thời 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 quá trình 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 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 chia tỷ lệ theo hệ số X.

CpcBidSimulationPointList

Vùng chứa cho các điểm mô phỏng để mô phỏng 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

Chỉ số dự kiến cho một 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 bằng phần triệu đơ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 tính bằng micrô giây.

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ùng 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 hợp cpc_simulation_key_value. Khi SimulateModifiedMethod = UNIFORM hoặc DEFAULT, thì cpc_bid_micros sẽ được đặt. Khi SimulateModifyMethod = SCALING ( quy mô lớn ), cpc_bid_scaling_modifier được đặt. cpc_simulation_key_value chỉ có thể là một trong những trạng thái sau:
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 có liên quan đến thực thể được mô phỏng đều được đối tượng sửa đổi này điều chỉnh theo tỷ lệ.

PercentCpcBidSimulationPointList

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

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

object (PercentCpcBidSimulationPoint)

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

PercentCpcBidSimulationPoint

Chỉ số dự kiến cho một số tiền 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. Tỷ lệ phần trăm 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 hoá hoặc dịch vụ. Giá trị được lưu trữ tại đâ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 bằng nội tệ.

clicks

string (int64 format)

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

costMicros

string (int64 format)

Chi phí dự kiến tính bằng micrô giây.

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ùng hàng đầu.

AdGroupSimulation

Mô phỏng 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 mô phỏng và phương pháp sửa đổi mô phỏng được trình bày chi tiết 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. DISPLAY - 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 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:

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

type

enum (SimulationType)

Chỉ có đầu ra. Trường mà hoạt động 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 này.

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 dùng để mô phỏng, có định dạng YYYY-MM-DD.

endDate

string

Chỉ có đầu ra. Ngày cuối cùng mà mô phỏng dựa trên, có dạng YYYY-MM-DD

Trường 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:
cpcBidPointList

object (CpcBidSimulationPointList)

Chỉ có đầu ra. Các đ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. Các điểm mô phỏng nếu loại mô phỏng là TARGET_ROAS.

CpvBidSimulationPointList

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

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

object (CpvBidSimulationPoint)

Chỉ số dự kiến cho một loạt số tiền 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 tính bằng micrô giây.

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 cho các điểm mô phỏng cho mô phỏng loại TARGET_CPA.

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

object (TargetCpaSimulationPoint)

Các chỉ số dự kiến cho một loạt số tiền 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,

  // 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 bằng phần triệu đơ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 tính bằng micrô giây.

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ùng 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 hợp target_cpa_simulation_key_value. Khi SimulateInterstitialMethod = UNIFORM hoặc DEFAULT, thì target_cpa_micros sẽ được đặt. Khi SimulateModifiedMethod = SCALING ( quy mô lớn), 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:
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ả các mục tiêu CPA liên quan đến thực thể được mô phỏng đều được đối tượng sửa đổi này điều chỉnh theo tỷ lệ.

TargetRoasSimulationPointList

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

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

object (TargetRoasSimulationPoint)

Các chỉ số dự kiến cho một loạt số tiền theo lợi tức mục tiêu trên chi tiêu quảng cáo.

TargetRoasSimulationPoint

Các chỉ số dự kiến cho một số tiền 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 bằng phần triệu đơ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 tính bằng micrô giây.

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ùng 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 chế độ xem độ tuổi có dạng:

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

AdScheduleView

Chế độ xem lịch quảng cáo tóm tắt hiệu suất của các chiến dịch theo tiêu chí 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 miền. Nếu chiến dịch sử dụng DynamicSearchAdsSettings, thì danh mục miền sẽ được tạo cho miền đó. Có thể nhắm mục tiêu các danh mục này bằng cách sử dụng WebpageConditionInfo. Hãy xem: 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 của danh mục miền có dạng:

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

campaign

string

Chỉ có đầu ra. Chiến dịch mà danh mục này được đề xuất.

category

string

Chỉ có đầu ra. Danh mục được đề xuất cho miền trang web, ví dụ: nếu bạn có một trang web về đồ điện tử, 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 mục DynamicSearchAdsAds cần thiết cho quảng cáo tìm kiếm động. Đây là ngôn ngữ của các trang trên trang web mà bạn muốn Google Ads tìm, tạo quảng cáo và so khớp với 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 mục DynamicSearchAdsSettings bắt buộc cho 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ố thấp hơn biểu thị miền phù hợp hơn, còn giá trị rỗng có nghĩa là không nên sử dụng.

hasChildren

boolean

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

recommendedCpcBidMicros

string (int64 format)

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

AssetFieldTypeView

Chế độ xem loại trường 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 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 tài sản. Tên tài nguyên chế độ xem loại trường tài sản có dạng:

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 theo 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 của 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:

customers/{customerId}/assetGroupProductGroupViews/{asset_group_id}~{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.

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. 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 loại nhóm thành phần có dạng:

customers/{customerId}/assetSetTypeViews/{assetSetType}

assetSetType

enum (AssetSetType)

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

BiddingStrategySimulation

Mô phỏng chiến lược đặt giá thầu. Các cách kết hợp được hỗ trợ giữa loại mô phỏng và phương pháp sửa đổi mô phỏng được trình bày chi tiết 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:

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

biddingStrategyId

string (int64 format)

Chỉ có đầu ra. Mã nhóm chia sẻ của chiến lược đặt giá thầu của phiên mô phỏng.

type

enum (SimulationType)

Chỉ có đầu ra. Trường mà hoạt động 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 này.

startDate

string

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

endDate

string

Chỉ có đầu ra. Ngày cuối cùng mà mô phỏng dựa trên, có dạng YYYY-MM-DD

Trường 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:
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. Các đ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 thành phần hiển thị cuộc gọi. Tên tài nguyên khung hiển thị cuộc 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. Thời gian bắt đầu cuộc gọi do nhà quảng cáo cung cấp.

endCallDateTime

string

Chỉ có đầu ra. Thời gian 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ị 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

Vị trí có thể hiển thị tính năng theo dõi cuộc gọi.

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

CallType

Các loại tài sản có thể có từ nơi cuộc gọi được thực hiện.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho 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

Trạng thái có thể có của một cuộc gọi thoại qua Google.

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

CampaignAudienceView

Chế độ xem đối tượng của chiến dịch. Bao gồm dữ liệu hiệu suất từ sở thích và danh sách tiếp thị lại cho quảng cáo trên Mạng hiển thị và Mạng YouTube cũng như danh sách tiếp thị lại 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à đối tượng. Chế độ xem này chỉ bao gồm những đố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 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 của 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 thông tin chi tiết về cụm từ tìm kiếm ở cấp chiến dịch có dạng:

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 những 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 kiểu 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 trình bày chi tiết bên dưới.

  • TÌM KIẾM - CPC_BID - UNIFORM
  • TÌM KIẾM - CPC_BID - QUY MÔ
  • TÌM KIẾM - TARGET_CPA - UNIFORM
  • TÌM KIẾM - TARGET_CPA - QUY MÔ
  • TÌM KIẾM - TARGET_ROAS - UNIFORM
  • TÌM KIẾM - TARGET_impression_SHARE - UNIFORM
  • TÌM KIẾM - NGÂN SÁCH - ĐỒNG THỜI
  • MUA SẮM – NGÂN SÁCH – ĐỒNG THỜI
  • 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 – BUDGET – 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 phiên mô phỏng.

type

enum (SimulationType)

Chỉ có đầu ra. Trường mà hoạt động 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 này.

startDate

string

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

endDate

string

Chỉ có đầu ra. Ngày cuối cùng mà mô phỏng dựa trên, có dạng YYYY-MM-DD

Trường 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:
cpcBidPointList

object (CpcBidSimulationPointList)

Chỉ có đầu ra. Các đ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. Các điểm mô phỏng nếu loại mô phỏng là TARGET_ROAS.

targetImpressionSharePointList

object (TargetImpressionShareSimulationPointList)

Chỉ có đầu ra. Các điểm mô phỏng nếu loại mô phỏng là TARGET_ cắm_SHARE.

budgetPointList

object (BudgetSimulationPointList)

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

TargetImpressionShareSimulationPointList

Vùng chứa cho các điểm mô phỏng cho mô phỏng thuộc loại TARGET_impression_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ô) để làm cơ sở cho các chỉ số dự kiến. Ví dụ: 10% tỷ lệ hiển thị, tương đương với 0, 1, được lưu trữ dưới dạng 100_000. Giá trị này đã được xác thực và sẽ 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 bắt buộc dự kiến mà nhà quảng cáo phải đặt để thực hiện mô phỏng này, tính bằng phần triệu đơ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 bằng phần triệu đơ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 tính bằng micrô giây.

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ùng 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ị hàng đầu tuyệt đối 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 cho các điểm mô phỏng để mô phỏng loại BUDGET.

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

object (BudgetSimulationPoint)

Các 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 số tiền 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
}
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 bắt buộc dự kiến mà nhà quảng cáo phải đặt để thực hiện mô phỏng này, tính bằng phần triệu đơ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 tính bằng micrô giây.

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ùng hàng đầu. Chỉ loại kênh quảng cáo tìm kiếm 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í nhà mạng. Tên tài nguyên của tiêu chí nhà mạng có dạng:

carrierConstants/{criterionId}

id

string (int64 format)

Chỉ có đầu ra. Mã của tiêu chí nhà mạng.

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 nơi nhà cung cấp dịch vụ toạ lạc, ví dụ: "AR", "FR", v.v.

ChangeEvent

Mô tả sự thay đổi chi tiết của các tài nguyên được trả về thuộc một số loại tài nguyên. Những 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 tính. Giá trị trước đó và giá trị mới của các trường đã thay đổi sẽ hiển thị. ChangeEvent có thể trì hoãn tối đa 3 phút để phản ánh một 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. Tên tài nguyên sự kiện thay đổi có dạng:

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

changeDateTime

string

Chỉ có đầu ra. Thời điểm áp dụng thay đổi đối với tài nguyên này.

changeResourceType

enum (ChangeEventResourceType)

Chỉ có đầu ra. Loại tài nguyên được thay đổi. Thao tác này sẽ cho biết tài nguyên nào sẽ được thiết lập trong oldResource và newResource.

changeResourceName

string

Chỉ có đầu ra. Chỉ cần tài nguyên mà thay đổi này xảy ra.

clientType

enum (ChangeClientType)

Chỉ có đầu ra. Nơi 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 mới được điề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 mới được điền.

resourceChangeOperation

enum (ResourceChangeOperation)

Chỉ có đầu ra. Thao tác đối với tài nguyên được 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 hỗ trợ theo tài nguyên ChangeEvent.

Enum
UNSPECIFIED Bạn chưa chỉ định giá trị nào.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho tài nguyên chưa được phân loại không xác định trong phiên bản này.
AD Thay đổi 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 về tài nguyên InitiativeBidModifier.
CAMPAIGN_CRITERION Thay đổi tài nguyên Tiêu chí chiến dịch.
FEED Thay đổi về 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 AdvertisingFeed.
AD_GROUP_AD Thay đổi tài nguyên Nhóm quảng cáo.
ASSET Thay đổi tài nguyên Tài sả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 Nhóm quảng cáo.
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 tạo thông qua.

Enum
UNSPECIFIED Bạn chưa chỉ định giá trị nào.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho một loại ứng dụng chưa được 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ụ: những thay đổi được thực hiện thông qua hoạt động quản lý chiến dịch.
GOOGLE_ADS_AUTOMATED_RULE Những 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 được thực hiện thông qua tập lệnh Google Ads.
GOOGLE_ADS_BULK_UPLOAD Các thay đổi được thực hiện bằng tính năng tải lên hàng loạt của Google Ads.
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 được thực hiện thông qua các đề xuất của Google Ads.
SEARCH_ADS_360_SYNC Các thay đổi được 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 Các 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 gói bằng URL máy chủ lượt nhấp SA360.
OTHER Các loại thay đổi không được phân loại (ví dụ: thay đổi khi sử dụng phiếu giảm giá thông qua Google Ads).

ChangedResource

Một proto bao bọc hiển thị tất cả các tài nguyên được hỗ trợ. Chỉ có tài nguyên của changeResourceType sẽ đượ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_ coi

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_ xoá.

campaignCriterion

object (CampaignCriterion)

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

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 được thay đổi trong tài nguyên changeEvent.

Enum
UNSPECIFIED Bạn chưa chỉ định giá trị nào.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho một hoạt động chưa được phân loại không xác định trong phiên bản này.
CREATE Tài nguyên đã được tạo.
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ó độ trễ tối đa 3 phút để phản ánh một 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 thay đổi trạng thái có dạng:

customers/{customerId}/changeStatus/{change_status_id}

resourceType

enum (ChangeStatusResourceType)

Chỉ có đầu ra. Đại diện cho loại tài nguyên được thay đổi. Thao tác này sẽ chỉ ra những trường sẽ được đặt. Ví dụ: đối với AD_GROUP, các 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 được 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 chịu ảnh hưởng của thay đổi này.

campaignAsset

string

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

adGroupAsset

string

Chỉ có đầu ra. Tài sản nhóm quảng cáo 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 điểm xảy ra thay đổi gần đây nhất đối với 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 bị ảnh hưởng bởi thay đổi này.

campaignFeed

string

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

adGroupBidModifier

string

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

ChangeStatusResourceType

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

Enum
UNSPECIFIED Bạn chưa chỉ định giá trị nào.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho tài nguyên chưa được 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 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 về 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 AdvertisingFeed.
CAMPAIGN_FEED Thay đổi tài nguyên CampaignFeed.
AD_GROUP_BID_MODIFIER Thay đổi về tài nguyên InitiativeBidModifier.
SHARED_SET Thay đổi tài nguyên SharedSet.
CAMPAIGN_SHARED_SET Thay đổi tài nguyên CampaignSharedSet.
ASSET Thay đổi tài nguyên Tài sả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 Nhóm quảng cáo.
COMBINED_AUDIENCE Thay đổi tài nguyên Kết hợp.

ChangeStatusOperation

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

Enum
UNSPECIFIED Bạn chưa chỉ định giá trị nào.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho tài nguyên chưa được phân loại không xác định trong phiên bản này.
ADDED Tài nguyên đã được tạo.
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 khác nhau.

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 kết hợp có dạng:

customers/{customerId}/combinedAudience/{combined_audience_id}

id

string (int64 format)

Chỉ có đầu ra. Mã nhận dạng 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 bị xoá.

name

string

Chỉ có đầu ra. Tên của đối tượng kết hợp. Giá trị này phải là duy nhất 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 đố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ề. Đại diện cho giá trị không xác định trong phiên bản này.
ENABLED Trạng thái đang bật – đối tượng kết hợp đang bật và có thể được 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 ở mỗi 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 chiến dịch không phải chiến dịch Tìm kiếm, metric.clicks 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 những ngày diễn ra cách thời điểm yêu cầu 90 ngày.

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 lượt xem có dạng:

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 kết với lượt 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 liên quan đến lượt hiển thị.

keyword

string

Chỉ có đầu ra. Từ khoá được liên kết, nếu có 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ị 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í theo 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í vùng đượ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:

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. Ký hiệ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ể thanh toán cho đơn vị tiền tệ này. Số tiền được lập hoá đơn phải là bội số của giá trị này.

AccessibleBiddingStrategy

Thể hiện chế độ xem Đấu thầu chiến lược thuộc sở hữu và được 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 thuộc sở hữu của người quản lý của khách hàng và được chia sẻ với khách hàng này, ngoài các chiến lược thuộc sở hữu của khách hàng này. Tài nguyên này không cung cấp các chỉ số và chỉ hiển thị một số ít các thuộc tính BiddingStrategy.

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 hỗ trợ tiếp cận. Tên tài nguyên AccessibleBiddingStrategy 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ó kết quả. descriptionName của Khách hàng sở hữu chiến lược đặt giá thầu.

Trường hợp scheme. Lược đồ đặt giá thầu.

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

maximizeConversionValue

object (MaximizeConversionValue)

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

maximizeConversions

object (MaximizeConversions)

Chỉ có đầu ra. 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á cho 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 hóa doanh thu trong khi tính trung bình Lợi tức 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 đặ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 nhận được giá trị chuyển đổi cao 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
{
  "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 với mức lợi tức mục tiêu trên chi tiêu quảng cáo trung bình. Nếu ROAS mục tiêu cao, chiến lược giá thầu có thể không chi tiêu hết ngân sách. Nếu bạn không đặt ROAS mục tiêu, chiến lược giá thầu sẽ hướng đến việc đạt được ROAS cao nhất có thể trong phạm vi ngân sách.

MaximizeConversions

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. Chi phí mục tiêu để 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 chuyển đổi.

TargetCpa

Chiến lược đặt giá thầu tự động giúp đặ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ị phải thanh toán tối thiểu dựa trên đơn vị tiền tệ của tài khoản.

TargetImpressionShare

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

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ệ quảng cáo đã chọn sẽ được hiển thị ở vị trí được nhắm mục tiêu theo cực nhỏ. Ví dụ: 1% tương đương với 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 để đặt mức trần và được chỉ định theo đơn vị cực nhỏ cục bộ.

TargetRoas

Chiến lược đặt giá thầu tự động giúp bạn tối đa hóa doanh thu trong khi tính trung bình lợi tức 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 giá thầu tự động đặ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 để tối đa hoá số lượt nhấp. Bên đặt giá thầu TargetSpend sẽ cố gắng chi tiêu ít hơn giá trị này hoặc mức 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à sẽ không được sử dụng nữa. Hãy tham khảo 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. Giới hạn 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 một khách hàng cụ thể và một khách hàng của khách hà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, cũng như chính người quản lý đều được đưa vào.

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 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 các 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 khách hàng đó. Chỉ có thể đọc.

hidden

boolean

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

level

string (int64 format)

Chỉ có đầu ra. Khoảng cách giữa một khách hàng nhất định và khách hàng đó. Đối với chế độ tự 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ữ chung (CLDR) thể hiện 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à người quản lý hay không. Chỉ có thể đọc.

descriptiveName

string

Chỉ có đầu ra. Tên mô tả cho 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 của 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 thông tin chi tiết về cụm từ tìm kiếm ở cấp khách hàng có dạng:

customers/{customerId}/customerSearchTermInsights/{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 những 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

Một lượt xem với 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 chi tiết về vị trí. Tên tài nguyên 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, ví dụ: URL 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 cho trang web, tên video trên YouTube cho video trên YouTube và tên ứng dụng di động được dịch cho ứng dụng di động.

groupPlacementTargetUrl

string

Chỉ có đầu ra. URL của vị trí của 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, đường liên kết đến ứng dụng di động trong cửa hàng ứng dụng hoặc URL của video trên YouTube.

PlacementType

Các loại vị trí có thể sử dụng để 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ề. Đại diện cho giá trị không xác định trong phiên bản này.
WEBSITE Trang web(ví dụ: "www.hoa4sale.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ụ: 'AQUO::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 Những nền tảng do Google sở hữu và điều hành(ví dụ: "tv.google.com").

DetailedDemographic

Đối tượng nhân khẩu học chi tiết: một ngành dọc dựa trên mối quan tâm cụ thể được nhắm mục tiêu để 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 tài nguyê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 đối tượng nhân khẩu học chi tiết.

name

string

Chỉ có đầu ra. Tên của đối tượng nhân khẩu học chi tiết. Ví dụ: "Trình độ học vấn cao nhất đã đạt được"

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 dữ liệu nhân khẩu học chi tiết được ra mắt ở 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 nhân khẩu học chi tiết.

CriterionCategoryAvailability

Thông tin về tính sẵn có của danh mục, theo 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 kênh phụ có trong danh mục đó.

locale[]

object (CriterionCategoryLocaleAvailability)

Ngôn ngữ được cung cấp trong danh mục của kênh.

CriterionCategoryChannelAvailability

Thông tin về loại kênh quảng cáo và các loại phụ có 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 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 khả dụng cho tất cả các loại phụ trong nó) hoặc CHANNEL_TYPE_AND_SUBTYPES (advertisingChannelType, advertisingChannelSubType và includeDefaultChannelSubType đều sẽ được đặt).

advertisingChannelType

enum (AdvertisingChannelType)

Loại kênh có danh mục đó.

advertisingChannelSubType[]

enum (AdvertisingChannelSubType)

Các loại kênh phụ trong loại kênh có danh mục đó.

includeDefaultChannelSubType

boolean

Có bao gồm loại kênh phụ mặc định hay không. Ví dụ:

CriterionCategoryChannelAvailabilityMode

Enum chứa tiêu chí CriterionCategoryChannelAvailabilityMode.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
ALL_CHANNELS Danh mục này có sẵn 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 kênh phụ.
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 kênh phụ cụ thể.

CriterionCategoryLocaleAvailability

Thông tin về các ngôn ngữ được cung cấp cho 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 ngôn ngữ được cung cấp. Có thể là LAUNCHED_TO_ALL (cả quốc gia và ngôn ngữ đều sẽ trống), COUNTRY (chỉ quốc gia sẽ được đặt), LANGUAGE (chỉ ngôn ngữ sẽ được đặt), COUNTRY_AND_LANGUAGE (sẽ đặt cả quốc gia và ngôn ngữ).

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ữ liên kết với danh mục.

CriterionCategoryLocaleAvailabilityMode

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

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho 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 ở tất cả cá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 áp dụng cho các chiến dịch thuộc một 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 chế độ xem từ khoá hiển thị. Tên tài nguyên chế độ xem Từ khóa hiển thị có dạng:

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ần hiển thị nằm trong khoảng cách của nó và một lần hiển thị duy nhất sẽ đóng góp vào chỉ số cho tất cả Nhóm khoảng cách 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 chế độ xem 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 từ phần mở rộng về địa điểm.

metricSystem

boolean

Chỉ có đầu ra. "True" nếu Nhóm khoảng cách đang sử dụng hệ thống chỉ số, nếu không thì "false".

DistanceBucket

Nhóm khoảng cách cho 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.

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

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 cho quảng cáo tìm kiếm động. Tên tài nguyên chế độ xem cụm từ tìm kiếm của quảng cáo tìm kiếm động có dạng:

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ỉ để đọ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ỉ để đọ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ỉ để đọc.

pageUrl

string

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

Trường này 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ỉ để đọ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ỉ để đọ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ỉ để đọc.

ExpandedLandingPageView

Lượt xem trang đích với 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 lượt 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 đưa đến.

FeedPlaceholderView

Chế độ xem phần giữ chỗ của 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 chế độ xem phần giữ chỗ của nguồn cấp dữ liệu. Tên tài nguyên khung hiển thị phần giữ chỗ cho nguồn cấp dữ liệu có dạng:

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ỗ của nguồn cấp dữ liệu.

GenderView

Chế độ xem theo giới tính. Tài nguyên giới tính phản ánh trạng thái phân phát hiệu quả, chứ không phải là tiêu chí nào được thêm. Một nhóm quảng cáo không có tiêu chí về giới tính theo mặc định hiển thị cho tất cả các giới tính, do đó, tất cả giới tính 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 giới tính. Tên tài nguyên chế độ xem theo giới tính có dạng:

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

GeographicView

Chế độ xem theo vị trí địa lý.

Chế độ xem theo đị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. Tính năng này báo cáo các chỉ số theo vị trí thực tế 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 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 vị trí địa lý có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Giá trị không xác định trong phiên bản này.
AREA_OF_INTEREST Vị trí mà người dùng quan tâm khi tìm kiếm.
LOCATION_OF_PRESENCE Vị trí của người dùng gửi 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 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, ví dụ: miền web, mã ứng dụng dành cho thiết bị di động hoặc mã nhận dạng kênh YouTube.

displayName

string

Chỉ có đầu ra. Tên miền cho các trang web và tên kênh YouTube cho các kênh YouTube.

targetUrl

string

Chỉ có đầu ra. URL của vị trí của 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:

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

HotelPerformanceView

Chế độ xem hiệu suất của 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 của 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:

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 từ 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. Các hàng này có thể được cập nhật hoặc bị hủ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 dữ liệu đ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:

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 cho yêu cầu đặt chỗ này, được cung cấp trong thông số "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. Mã nhận dạng của tài khoản Hotel Center, nơi 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ó trong nguồn cấp dữ liệu Hotel Center. Mã khách sạn được lấy từ thông số "ID" 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 nhận khi có lượt đặ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 một phần triệu của đơn vị tiền tệ cơ sở. Ví dụ: $12, 35 sẽ được biểu diễn là 12350000. Đơn vị tiền tệ có đơ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 cụ thể đã được lập hoá đơn hay chưa. 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 số lượt đặt phòng khách sạn.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Giá trị 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 chế độ xem phạm vi thu nhập có dạng:

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 chế độ xem từ khoá. Tên tài nguyên chế độ xem từ khoá có dạng:

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

LandingPageView

Chế độ xem trang đích với các chỉ số được tổng hợp ở cấp URL cuối cùng chưa được 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:

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

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 các 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}

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 dành cho thiết bị 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ã nhận dạng hằng số của 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ố của thiết bị di động có dạng:

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ề. Đại diện cho 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.

OperatingSystemVersionConstant

Một 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 hằng số của phiên bản hệ điều hành có dạng:

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 duy nhất hay một loạt các phiên bản.

id

string (int64 format)

Chỉ có đầu ra. Mã 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 chính 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ề. Đại diện cho 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 đã chỉ định.

PaidOrganicSearchTermView

Chế độ xem cụm từ tìm kiếm tự nhiên có trả phí cho phép bạn xem số liệu thống kê về hoạt động 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 chế độ xem cụm từ tìm kiếm có dạng:

customers/{customerId}/paidOrganicSearchTermViews/{campaignId}~ {adGroupId}~{URL-base64 search term}

searchTerm

string

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

QualifyingQuestion

Câu hỏi đánh giá 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 định lượng.

" đủ điều kiện"

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 sàng lọc.

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 trạng thái là phụ huynh. Tên tài nguyên chế độ xem Trạng thái là phụ huynh có dạng:

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

PerStoreView

Lượt xem mỗi cửa hàng. Chế độ xem này cung cấp số liệu thống kê về lượt chuyển đổi theo hành động liên quan đến hành động liên quan đến địa điểm thực tế và phạm vi tiếp cận theo lượt hiển thị tạ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 cửa hàng. Tên tài nguyên mỗi lượt xem cửa hàng có dạng:

customers/{customerId}/perStoreViews/{placeId}

placeId

string

Chỉ có đầu ra. Mã địa điểm của lượt xem theo cửa hàng.

ProductBiddingCategoryConstant

Danh mục Đặt giá thầu sản phẩm.

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của danh mục đặt giá thầu sản phẩm. Tên tài nguyên danh mục đặt giá thầu sản phẩm có dạng:

productBiddingCategoryConstants/{countryCode}~{level}~{id}

level

enum (ProductBiddingCategoryLevel)

Chỉ có đầu ra. Cấp của danh mục đặt giá thầu sản phẩm.

status

enum (ProductBiddingCategoryStatus)

Chỉ có đầu ra. Trạng thái của danh mục đặt giá thầu sản phẩm.

id

string (int64 format)

Chỉ có đầu ra. Mã của danh mục đặt giá thầu sản phẩm.

Mã này tương đương với mã google_product_category như mô tả trong bài viết này: https://support.google.com/merchants/answer/6324436.

countryCode

string

Chỉ có đầu ra. Mã quốc gia viết hoa gồm hai chữ cái của danh mục đặt giá thầu sản phẩm.

productBiddingCategoryConstantParent

string

Chỉ có đầu ra. Tên tài nguyên của danh mục đặt giá thầu sản phẩm chính.

languageCode

string

Chỉ có đầu ra. Mã ngôn ngữ của danh mục đặt giá thầu sản phẩm.

localizedName

string

Chỉ có đầu ra. Giá trị hiển thị của danh mục đặt giá thầu sản phẩm được bản địa hoá theo languageCode.

ProductBiddingCategoryStatus

Enum mô tả trạng thái của danh mục đặt giá thầu sản phẩm.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
ACTIVE Danh mục này đang hoạt động và có thể dùng để đặt giá thầu.
OBSOLETE Danh mục này đã lỗi thời. Chỉ dùng cho mục đích báo cáo.

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 chế độ xem nhóm sản phẩm có dạng:

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

Nội dung đề xuất

Một đề xuất.

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "type": enum (RecommendationType),
  "impact": {
    object (RecommendationImpact)
  },
  "campaigns": [
    string
  ],
  "campaignBudget": string,
  "campaign": string,
  "adGroup": string,
  "dismissed": boolean,

  // Union field recommendation can be only one of the following:
  "campaignBudgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "forecastingCampaignBudgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "keywordRecommendation": {
    object (KeywordRecommendation)
  },
  "textAdRecommendation": {
    object (TextAdRecommendation)
  },
  "targetCpaOptInRecommendation": {
    object (TargetCpaOptInRecommendation)
  },
  "maximizeConversionsOptInRecommendation": {
    object (MaximizeConversionsOptInRecommendation)
  },
  "enhancedCpcOptInRecommendation": {
    object (EnhancedCpcOptInRecommendation)
  },
  "searchPartnersOptInRecommendation": {
    object (SearchPartnersOptInRecommendation)
  },
  "maximizeClicksOptInRecommendation": {
    object (MaximizeClicksOptInRecommendation)
  },
  "optimizeAdRotationRecommendation": {
    object (OptimizeAdRotationRecommendation)
  },
  "keywordMatchTypeRecommendation": {
    object (KeywordMatchTypeRecommendation)
  },
  "moveUnusedBudgetRecommendation": {
    object (MoveUnusedBudgetRecommendation)
  },
  "targetRoasOptInRecommendation": {
    object (TargetRoasOptInRecommendation)
  },
  "responsiveSearchAdRecommendation": {
    object (ResponsiveSearchAdRecommendation)
  },
  "marginalRoiCampaignBudgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "useBroadMatchKeywordRecommendation": {
    object (UseBroadMatchKeywordRecommendation)
  },
  "responsiveSearchAdAssetRecommendation": {
    object (ResponsiveSearchAdAssetRecommendation)
  },
  "upgradeSmartShoppingCampaignToPerformanceMaxRecommendation": {
    object (UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation)
  },
  "responsiveSearchAdImproveAdStrengthRecommendation": {
    object (ResponsiveSearchAdImproveAdStrengthRecommendation)
  },
  "displayExpansionOptInRecommendation": {
    object (DisplayExpansionOptInRecommendation)
  },
  "upgradeLocalCampaignToPerformanceMaxRecommendation": {
    object (UpgradeLocalCampaignToPerformanceMaxRecommendation)
  },
  "raiseTargetCpaBidTooLowRecommendation": {
    object (RaiseTargetCpaBidTooLowRecommendation)
  },
  "forecastingSetTargetRoasRecommendation": {
    object (ForecastingSetTargetRoasRecommendation)
  },
  "calloutAssetRecommendation": {
    object (CalloutAssetRecommendation)
  },
  "sitelinkAssetRecommendation": {
    object (SitelinkAssetRecommendation)
  },
  "callAssetRecommendation": {
    object (CallAssetRecommendation)
  },
  "shoppingAddAgeGroupRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddColorRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddGenderRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddGtinRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddMoreIdentifiersRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddSizeRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddProductsToCampaignRecommendation": {
    object (ShoppingAddProductsToCampaignRecommendation)
  },
  "shoppingFixDisapprovedProductsRecommendation": {
    object (ShoppingFixDisapprovedProductsRecommendation)
  },
  "shoppingTargetAllOffersRecommendation": {
    object (ShoppingTargetAllOffersRecommendation)
  },
  "shoppingFixSuspendedMerchantCenterAccountRecommendation": {
    object (ShoppingMerchantCenterAccountSuspensionRecommendation)
  },
  "shoppingFixMerchantCenterAccountSuspensionWarningRecommendation": {
    object (ShoppingMerchantCenterAccountSuspensionRecommendation)
  },
  "shoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation": {
    object (ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation)
  },
  "dynamicImageExtensionOptInRecommendation": {
    object (DynamicImageExtensionOptInRecommendation)
  },
  "raiseTargetCpaRecommendation": {
    object (RaiseTargetCpaRecommendation)
  },
  "lowerTargetRoasRecommendation": {
    object (LowerTargetRoasRecommendation)
  },
  "performanceMaxOptInRecommendation": {
    object (PerformanceMaxOptInRecommendation)
  },
  "improvePerformanceMaxAdStrengthRecommendation": {
    object (ImprovePerformanceMaxAdStrengthRecommendation)
  },
  "migrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation": {
    object (MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation)
  }
  // End of list of possible types for union field recommendation.
}
Trường
resourceName

string

Không thể thay đổi. Tên tài nguyên của đề xuất.

customers/{customerId}/recommendations/{recommendation_id}

type

enum (RecommendationType)

Chỉ có đầu ra. Loại nội dung đề xuất.

impact

object (RecommendationImpact)

Chỉ có đầu ra. Tác động đến hiệu suất của tài khoản do việc áp dụng đề xuất.

campaigns[]

string

Chỉ có đầu ra. Các chiến dịch mà đề xuất này nhắm đến.

Trường này sẽ được đặt cho các loại đề xuất sau: CAMPAIGN_BUDGET, ForecastING_CAMPAIGN_BUDGET, MARGINAL_ROI_CAMPAIGN_BUDGET và MOVE_UNUSED_BUDGET

campaignBudget

string

Chỉ có đầu ra. Ngân sách mà đề xuất này nhắm đến. Bạn chỉ nên thiết lập chế độ này khi đề xuất ảnh hưởng đến ngân sách của một chiến dịch.

Trường này sẽ được đặt cho các loại đề xuất sau: CAMPAIGN_BUDGET, ForecastING_CAMPAIGN_BUDGET, MARGINAL_ROI_CAMPAIGN_BUDGET, MOVE_UNUSED_BUDGET

campaign

string

Chỉ có đầu ra. Chiến dịch mà đề xuất này nhắm đến.

Giá trị của trường này sẽ được đặt cho các loại đề xuất sau: CALL_MAX_SEARCH_SEARCH_V mức giá

adGroup

string

Chỉ có đầu ra. Nhóm quảng cáo mà đề xuất này nhắm đến. Thuộc tính này sẽ chỉ được đặt khi đề xuất ảnh hưởng đến một nhóm quảng cáo.

Trường này sẽ được đặt cho các loại đề xuất sau: KEY, OPTIMIZE_AD_ROTATION, RESPONSIVE_SEARCH_AD, RESPONSIVE_SEARCH_AD_ASSET, TEXT_AD

dismissed

boolean

Chỉ có đầu ra. Liệu đề xuất có bị loại bỏ hay không.

Trường hợp recommendation. Thông tin chi tiết về nội dung đề xuất. recommendation chỉ có thể là một trong những trạng thái sau:
campaignBudgetRecommendation

object (CampaignBudgetRecommendation)

Chỉ có đầu ra. Đề xuất về ngân sách chiến dịch.

forecastingCampaignBudgetRecommendation

object (CampaignBudgetRecommendation)

Chỉ có đầu ra. Nội dung đề xuất về ngân sách dự đoán cho chiến dịch.

keywordRecommendation

object (KeywordRecommendation)

Chỉ có đầu ra. Đề xuất từ khoá.

textAdRecommendation

object (TextAdRecommendation)

Chỉ có đầu ra. Thêm đề xuất về quảng cáo dạng văn bản mở rộng.

targetCpaOptInRecommendation

object (TargetCpaOptInRecommendation)

Chỉ có đầu ra. Đề xuất chọn sử dụng chiến lược CPA mục tiêu.

maximizeConversionsOptInRecommendation

object (MaximizeConversionsOptInRecommendation)

Chỉ có đầu ra. Đề xuất chọn sử dụng chiến lược Tối đa hoá lượt chuyển đổi.

enhancedCpcOptInRecommendation

object (EnhancedCpcOptInRecommendation)

Chỉ có đầu ra. Đề xuất chọn sử dụng chi phí mỗi lượt nhấp nâng cao.

searchPartnersOptInRecommendation

object (SearchPartnersOptInRecommendation)

Chỉ có đầu ra. Đề xuất Chọn tham gia Đối tác tìm kiếm.

maximizeClicksOptInRecommendation

object (MaximizeClicksOptInRecommendation)

Chỉ có đầu ra. Đề xuất chọn sử dụng chiến lược Tối đa hóa số lượt nhấp.

optimizeAdRotationRecommendation

object (OptimizeAdRotationRecommendation)

Chỉ có đầu ra. Đề xuất Tối ưu hóa xoay vòng quảng cáo.

keywordMatchTypeRecommendation

object (KeywordMatchTypeRecommendation)

Chỉ có đầu ra. Đề xuất về kiểu khớp từ khoá.

moveUnusedBudgetRecommendation

object (MoveUnusedBudgetRecommendation)

Chỉ có đầu ra. Đề xuất chuyển ngân sách chưa sử dụng.

targetRoasOptInRecommendation

object (TargetRoasOptInRecommendation)

Chỉ có đầu ra. Đề xuất chọn sử dụng lợi tức mục tiêu trên chi tiêu quảng cáo.

responsiveSearchAdRecommendation

object (ResponsiveSearchAdRecommendation)

Chỉ có đầu ra. Đề xuất thêm quảng cáo tìm kiếm thích ứng.

marginalRoiCampaignBudgetRecommendation

object (CampaignBudgetRecommendation)

Chỉ có đầu ra. Đề xuất về ngân sách chiến dịch ROI biên.

useBroadMatchKeywordRecommendation

object (UseBroadMatchKeywordRecommendation)

Chỉ có đầu ra. Đề xuất sử dụng từ khoá khớp mở rộng.

responsiveSearchAdAssetRecommendation

object (ResponsiveSearchAdAssetRecommendation)

Chỉ có đầu ra. Đề xuất về thành phần của quảng cáo tìm kiếm thích ứng.

upgradeSmartShoppingCampaignToPerformanceMaxRecommendation

object (UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation)

Chỉ có đầu ra. Đề xuất nâng cấp chiến dịch Mua sắm thông minh lên chiến dịch Tối đa hoá hiệu suất.

responsiveSearchAdImproveAdStrengthRecommendation

object (ResponsiveSearchAdImproveAdStrengthRecommendation)

Chỉ có đầu ra. Quảng cáo tìm kiếm thích ứng giúp cải thiện đề xuất về độ mạnh của quảng cáo.

displayExpansionOptInRecommendation

object (DisplayExpansionOptInRecommendation)

Chỉ có đầu ra. Đề xuất chọn sử dụng tính năng Mở rộng hiển thị.

upgradeLocalCampaignToPerformanceMaxRecommendation

object (UpgradeLocalCampaignToPerformanceMaxRecommendation)

Chỉ có đầu ra. Đề xuất nâng cấp chiến dịch Địa phương lên chiến dịch Tối đa hoá hiệu suất.

raiseTargetCpaBidTooLowRecommendation

object (RaiseTargetCpaBidTooLowRecommendation)

Chỉ có đầu ra. Đề xuất tăng giá thầu CPA mục tiêu quá thấp.

forecastingSetTargetRoasRecommendation

object (ForecastingSetTargetRoasRecommendation)

Chỉ có đầu ra. Tính năng dự báo giúp thiết lập đề xuất về lợi tức mục tiêu trên chi tiêu quảng cáo.

calloutAssetRecommendation

object (CalloutAssetRecommendation)

Chỉ có đầu ra. Đề xuất về thành phần chú thích.

callAssetRecommendation

object (CallAssetRecommendation)

Chỉ có đầu ra. Đề xuất về thành phần cuộc gọi.

shoppingAddAgeGroupRecommendation

object (ShoppingOfferAttributeRecommendation)

Chỉ có đầu ra. Đề xuất nhóm tuổi thêm mua sắm.

shoppingAddColorRecommendation

object (ShoppingOfferAttributeRecommendation)

Chỉ có đầu ra. Đề xuất thêm màu sắc cho quảng cáo mua sắm.

shoppingAddGenderRecommendation

object (ShoppingOfferAttributeRecommendation)

Chỉ có đầu ra. Đề xuất thêm giới tính trong quảng cáo mua sắm.

shoppingAddGtinRecommendation

object (ShoppingOfferAttributeRecommendation)

Chỉ có đầu ra. Đề xuất thêm GTIN (Mã số sản phẩm thương mại toàn cầu) cho quảng cáo mua sắm.

shoppingAddMoreIdentifiersRecommendation

object (ShoppingOfferAttributeRecommendation)

Chỉ có đầu ra. Mua sắm đề xuất thêm nhiều giá trị nhận dạng khác.

shoppingAddSizeRecommendation

object (ShoppingOfferAttributeRecommendation)

Chỉ có đầu ra. Đề xuất thêm kích thước cho quảng cáo mua sắm.

shoppingAddProductsToCampaignRecommendation

object (ShoppingAddProductsToCampaignRecommendation)

Chỉ có đầu ra. Tính năng mua sắm thêm sản phẩm vào đề xuất về chiến dịch.

shoppingFixDisapprovedProductsRecommendation

object (ShoppingFixDisapprovedProductsRecommendation)

Chỉ có đầu ra. Đề xuất chỉnh sửa sản phẩm bị từ chối trong chiến dịch Mua sắm.

shoppingTargetAllOffersRecommendation

object (ShoppingTargetAllOffersRecommendation)

Chỉ có đầu ra. Mục tiêu mua sắm tất cả đề xuất đều đưa ra đề xuất.

shoppingFixSuspendedMerchantCenterAccountRecommendation

object (ShoppingMerchantCenterAccountSuspensionRecommendation)

Chỉ có đầu ra. Đề xuất về việc khắc phục vấn đề mua sắm bị tạm ngưng đối với tài khoản Merchant Center.

shoppingFixMerchantCenterAccountSuspensionWarningRecommendation

object (ShoppingMerchantCenterAccountSuspensionRecommendation)

Chỉ có đầu ra. Đề xuất về cảnh báo tạm ngưng tài khoản Merchant Center khi mua sắm.

shoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

object (ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation)

Chỉ có đầu ra. Hoạt động mua sắm di chuyển các mặt hàng trong chiến dịch Mua sắm thông thường sang đề xuất Tối đa hoá hiệu suất.

dynamicImageExtensionOptInRecommendation

object (DynamicImageExtensionOptInRecommendation)

Chỉ có đầu ra. Đề xuất bật phần mở rộng về hình ảnh linh hoạt trên tài khoản, giúp Google tìm những hình ảnh phù hợp nhất trên trang đích của quảng cáo và bổ sung cho quảng cáo dạng văn bản.

raiseTargetCpaRecommendation

object (RaiseTargetCpaRecommendation)

Chỉ có đầu ra. Nội dung đề xuất tăng CPA mục tiêu.

lowerTargetRoasRecommendation

object (LowerTargetRoasRecommendation)

Chỉ có đầu ra. Đề xuất giảm lợi tức mục tiêu trên chi tiêu quảng cáo.

performanceMaxOptInRecommendation

object (PerformanceMaxOptInRecommendation)

Chỉ có đầu ra. Đề xuất chọn tham gia chiến dịch Tối đa hoá hiệu suất.

improvePerformanceMaxAdStrengthRecommendation

object (ImprovePerformanceMaxAdStrengthRecommendation)

Chỉ có đầu ra. Đề xuất cải thiện độ mạnh của quảng cáo cho chiến dịch Tối đa hoá hiệu suất.

migrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

object (MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation)

Chỉ có đầu ra. Đề xuất di chuyển từ chiến dịch Quảng cáo tìm kiếm động sang chiến dịch Tối đa hoá hiệu suất.

RecommendationType

Các loại đề xuất.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
CAMPAIGN_BUDGET Đề xuất ngân sách cho các chiến dịch hiện bị ràng buộc ngân sách (trái ngược với đề xuất ForecastING_CAMPAIGN_BUDGET, đề xuất này áp dụng cho các chiến dịch dự kiến sẽ bị ràng buộc ngân sách trong tương lai).
KEYWORD Đề xuất từ khoá.
TEXT_AD Đề xuất thêm một quảng cáo dạng văn bản mới.
TARGET_CPA_OPT_IN Nội dung đề xuất cập nhật một chiến dịch để sử dụng chiến lược đặt giá thầu CPA mục tiêu.
MAXIMIZE_CONVERSIONS_OPT_IN Đề xuất cập nhật một chiến dịch để sử dụng chiến lược đặt giá thầu Tối đa hoá lượt chuyển đổi.
ENHANCED_CPC_OPT_IN Đề xuất bật Chi phí mỗi lượt nhấp nâng cao cho chiến dịch.
SEARCH_PARTNERS_OPT_IN Đề xuất để bắt đầu hiển thị quảng cáo của chiến dịch trên trang web Đối tác tìm kiếm của Google.
MAXIMIZE_CLICKS_OPT_IN Nội dung đề xuất cập nhật một chiến dịch để sử dụng chiến lược đặt giá thầu Tối đa hoá số lượt nhấp.
OPTIMIZE_AD_ROTATION Đề xuất để bắt đầu sử dụng chế độ cài đặt xoay vòng quảng cáo "Tối ưu hoá" cho nhóm quảng cáo nhất định.
KEYWORD_MATCH_TYPE Bạn nên thay đổi từ khoá hiện tại từ một kiểu khớp thành kiểu khớp rộng hơn.
MOVE_UNUSED_BUDGET Bạn nên chuyển ngân sách chưa sử dụng từ một ngân sách sang ngân sách bị ràng buộc.
FORECASTING_CAMPAIGN_BUDGET Đề xuất về ngân sách cho các chiến dịch dự kiến sẽ bị ràng buộc ngân sách trong tương lai (trái ngược với đề xuấtCAMPAIGN_BUDGET, áp dụng cho các chiến dịch hiện bị ràng buộc ngân sách).
TARGET_ROAS_OPT_IN Nội dung đề xuất cập nhật một chiến dịch để sử dụng chiến lược đặt giá thầu theo lợi tức mục tiêu trên chi tiêu quảng cáo.
RESPONSIVE_SEARCH_AD Nội dung đề xuất thêm một quảng cáo tìm kiếm thích ứng mới.
MARGINAL_ROI_CAMPAIGN_BUDGET Đề xuất về ngân sách cho các chiến dịch có ROI được dự đoán sẽ tăng khi điều chỉnh ngân sách.
USE_BROAD_MATCH_KEYWORD Đề xuất thêm các phiên bản từ khoá khớp mở rộng cho những chiến dịch đặt giá thầu dựa trên lượt chuyển đổi hoàn toàn tự động.
RESPONSIVE_SEARCH_AD_ASSET Nội dung đề xuất thêm các thành phần mới của quảng cáo tìm kiếm thích ứng.
UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX Nội dung đề xuất nâng cấp chiến dịch Mua sắm thông minh lên chiến dịch Tối đa hoá hiệu suất.
RESPONSIVE_SEARCH_AD_IMPROVE_AD_STRENGTH Nội dung đề xuất để cải thiện độ mạnh của quảng cáo tìm kiếm thích ứng.
DISPLAY_EXPANSION_OPT_IN Nội dung đề xuất cập nhật chiến dịch để sử dụng tính năng Mở rộng hiển thị.
UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX Nội dung đề xuất nâng cấp chiến dịch Địa phương lên chiến dịch Tối đa hoá hiệu suất.
RAISE_TARGET_CPA_BID_TOO_LOW Bạn nên tăng CPA mục tiêu khi mức CPA mục tiêu quá thấp và có rất ít hoặc không có lượt chuyển đổi nào. Chiến lược này được áp dụng không đồng bộ và có thể mất vài phút tuỳ thuộc vào số lượng nhóm quảng cáo có trong chiến dịch liên quan.
FORECASTING_SET_TARGET_ROAS Đề xuất tăng ngân sách trước khi xảy ra một sự kiện theo mùa được dự đoán sẽ tăng lưu lượng truy cập và thay đổi chiến lược đặt giá thầu từ Tối đa hoá giá trị lượt chuyển đổi thành ROAS mục tiêu.
CALLOUT_ASSET Đề xuất thêm thành phần chú thích vào cấp chiến dịch hoặc khách hàng.
CALL_ASSET Đề xuất thêm thành phần cuộc gọi vào cấp chiến dịch hoặc khách hàng.
SHOPPING_ADD_AGE_GROUP Đề xuất thêm thuộc tính nhóm tuổi cho các mặt hàng bị giảm hạng do thiếu nhóm tuổi.
SHOPPING_ADD_COLOR Bạn nên thêm màu sắc cho những mặt hàng bị giảm hạng do thiếu màu sắc.
SHOPPING_ADD_GENDER Đề xuất thêm giới tính vào những mặt hàng bị giảm hạng do thiếu giới tính.
SHOPPING_ADD_GTIN Đề xuất thêm GTIN (Mã số sản phẩm thương mại toàn cầu) cho các mặt hàng bị giảm hạng do thiếu GTIN.
SHOPPING_ADD_MORE_IDENTIFIERS Đề xuất thêm nhiều giá trị nhận dạng hơn cho các mặt hàng bị giảm hạng do thiếu giá trị nhận dạng.
SHOPPING_ADD_SIZE Đề xuất thêm kích thước vào những mặt hàng bị giảm hạng do thiếu kích thước.
SHOPPING_ADD_PRODUCTS_TO_CAMPAIGN Đề xuất thông báo cho khách hàng về một chiến dịch không thể phân phát vì không có sản phẩm nào đang được nhắm đến.
SHOPPING_FIX_DISAPPROVED_PRODUCTS Đề xuất mua sắm thông báo cho khách hàng về chiến dịch có nhiều sản phẩm bị từ chối.
SHOPPING_TARGET_ALL_OFFERS Nội dung đề xuất tạo một chiến dịch toàn diện nhắm đến tất cả ưu đãi.
SHOPPING_FIX_SUSPENDED_MERCHANT_CENTER_ACCOUNT Nội dung đề xuất khắc phục các vấn đề về việc tạm ngưng tài khoản Merchant Center.
SHOPPING_FIX_MERCHANT_CENTER_ACCOUNT_SUSPENSION_WARNING Nội dung đề xuất khắc phục các vấn đề về cảnh báo tạm ngưng tài khoản Merchant Center.
SHOPPING_MIGRATE_REGULAR_SHOPPING_CAMPAIGN_OFFERS_TO_PERFORMANCE_MAX Bạn nên di chuyển những ưu đãi mà chiến dịch Mua sắm thông thường nhắm đến sang chiến dịch Tối đa hoá hiệu suất hiện có.
DYNAMIC_IMAGE_EXTENSION_OPT_IN Đề xuất bật phần mở rộng về hình ảnh linh hoạt trên tài khoản, giúp Google tìm những hình ảnh phù hợp nhất trên trang đích của quảng cáo và bổ sung cho quảng cáo dạng văn bản.
RAISE_TARGET_CPA Đề xuất tăng CPA mục tiêu dựa trên thông tin dự đoán của Google được mô hình hoá từ các lượt chuyển đổi trước đây. Chiến lược này được áp dụng không đồng bộ và có thể mất vài phút tuỳ thuộc vào số lượng nhóm quảng cáo có trong chiến dịch liên quan.
LOWER_TARGET_ROAS Đề xuất giảm lợi tức mục tiêu trên chi tiêu quảng cáo.
PERFORMANCE_MAX_OPT_IN Nội dung đề xuất chọn sử dụng chiến dịch Tối đa hoá hiệu suất.
IMPROVE_PERFORMANCE_MAX_AD_STRENGTH Nội dung đề xuất cải thiện độ mạnh của nhóm thành phần của chiến dịch Tối đa hoá hiệu suất lên điểm xếp hạng "Rất tốt".
MIGRATE_DYNAMIC_SEARCH_ADS_CAMPAIGN_TO_PERFORMANCE_MAX Đề xuất di chuyển quảng cáo Tìm kiếm động sang chiến dịch Tối đa hoá hiệu suất.

RecommendationImpact

Tác động của việc thực hiện thay đổi như mô tả trong nội dung đề xuất. Một số loại đề xuất có thể không có tác động đến thông tin.

Biểu diễn dưới dạng JSON
{
  "baseMetrics": {
    object (RecommendationMetrics)
  },
  "potentialMetrics": {
    object (RecommendationMetrics)
  }
}
Trường
baseMetrics

object (RecommendationMetrics)

Chỉ có đầu ra. Các chỉ số cơ sở tại thời điểm tạo đề xuất.

potentialMetrics

object (RecommendationMetrics)

Chỉ có đầu ra. Chỉ số ước tính nếu áp dụng đề xuất.

RecommendationMetrics

Chỉ số hiệu suất hằng tuần của tài khoản. Đối với một số loại đề xuất, những đề xuất này được tính trung bình trong khoảng thời gian 90 ngày qua nên có thể là phân số.

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

number

Chỉ có đầu ra. Số lần hiển thị quảng cáo.

clicks

number

Chỉ có đầu ra. Số lượt nhấp vào quảng cáo.

costMicros

string (int64 format)

Chỉ có đầu ra. Chi phí (tính theo micrô giây) cho quảng cáo, bằng nội tệ cho tài khoản.

conversions

number

Chỉ có đầu ra. Số lượt chuyển đổi.

videoViews

number

Chỉ có đầu ra. Số lượt xem video cho chiến dịch quảng cáo video.

CampaignBudgetRecommendation

Nội dung đề xuất về ngân sách cho các chiến dịch bị ràng buộc ngân sách.

Biểu diễn dưới dạng JSON
{
  "budgetOptions": [
    {
      object (CampaignBudgetRecommendationOption)
    }
  ],
  "currentBudgetAmountMicros": string,
  "recommendedBudgetAmountMicros": string
}
Trường
budgetOptions[]

object (CampaignBudgetRecommendationOption)

Chỉ có đầu ra. Số tiền ngân sách và số liệu ước tính liên quan đến mức độ tác động đối với một vài giá trị của số tiền ngân sách có thể xảy ra.

currentBudgetAmountMicros

string (int64 format)

Chỉ có đầu ra. Số tiền ngân sách hiện tại tính theo phần triệu.

recommendedBudgetAmountMicros

string (int64 format)

Chỉ có đầu ra. Số tiền ngân sách đề xuất tính theo phần triệu.

CampaignBudgetRecommendationOption

Mức tác động ước tính đối với một số tiền ngân sách nhất định.

Biểu diễn dưới dạng JSON
{
  "impact": {
    object (RecommendationImpact)
  },
  "budgetAmountMicros": string
}
Trường
impact

object (RecommendationImpact)

Chỉ có đầu ra. Số liệu ước tính về mức độ tác động nếu bạn thay đổi ngân sách thành số tiền được chỉ định trong lựa chọn này.

budgetAmountMicros

string (int64 format)

Chỉ có đầu ra. Số tiền ngân sách cho lựa chọn này.

KeywordRecommendation

Đề xuất từ khoá.

Biểu diễn dưới dạng JSON
{
  "keyword": {
    object (KeywordInfo)
  },
  "searchTerms": [
    {
      object (SearchTerm)
    }
  ],
  "recommendedCpcBidMicros": string
}
Trường
keyword

object (KeywordInfo)

Chỉ có đầu ra. Từ khoá đề xuất.

searchTerms[]

object (SearchTerm)

Chỉ có đầu ra. Danh sách cụm từ tìm kiếm mà từ khoá này khớp. Cùng một cụm từ tìm kiếm có thể được lặp lại cho nhiều từ khoá.

recommendedCpcBidMicros

string (int64 format)

Chỉ có đầu ra. Giá thầu CPC (chi phí mỗi lượt nhấp) được đề xuất.

SearchTerm

Thông tin về cụm từ tìm kiếm có liên quan đến một đề xuất từ khoá.

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

string

Chỉ có đầu ra. Văn bản của cụm từ tìm kiếm.

estimatedWeeklySearchCount

string (int64 format)

Chỉ có đầu ra. Số lượt tìm kiếm trước đây hằng tuần ước tính cho cụm từ tìm kiếm này.

TextAdRecommendation

Đề xuất về quảng cáo dạng văn bản.

Biểu diễn dưới dạng JSON
{
  "ad": {
    object (Ad)
  },
  "creationDate": string,
  "autoApplyDate": string
}
Trường
ad

object (Ad)

Chỉ có đầu ra. Quảng cáo được đề xuất.

creationDate

string

Chỉ có đầu ra. Ngày tạo quảng cáo được đề xuất. Định dạng YYYY-MM-DD, ví dụ: 2018-04-17.

autoApplyDate

string

Chỉ có đầu ra. Ngày (nếu có) là ngày sớm nhất mà hệ thống sẽ tự động áp dụng đề xuất. Định dạng YYYY-MM-DD, ví dụ: 2018-04-17.

TargetCpaOptInRecommendation

Đề xuất chọn sử dụng CPA mục tiêu.

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

object (TargetCpaOptInRecommendationOption)

Chỉ có đầu ra. Các mục tiêu có sẵn và lựa chọn tương ứng cho chiến lược CPA mục tiêu.

recommendedTargetCpaMicros

string (int64 format)

Chỉ có đầu ra. Mục tiêu CPA trung bình được đề xuất. Xem số tiền ngân sách bắt buộc và tác động của việc sử dụng đề xuất này trong danh sách lựa chọn.

TargetCpaOptInRecommendationOption

Tuỳ chọn chọn sử dụng CPA mục tiêu với số liệu ước tính mức độ tác động.

Biểu diễn dưới dạng JSON
{
  "goal": enum (TargetCpaOptInRecommendationGoal),
  "impact": {
    object (RecommendationImpact)
  },
  "targetCpaMicros": string,
  "requiredCampaignBudgetAmountMicros": string
}
Trường
goal

enum (TargetCpaOptInRecommendationGoal)

Chỉ có đầu ra. Mục tiêu đạt được nhờ tuỳ chọn này.

impact

object (RecommendationImpact)

Chỉ có đầu ra. Số liệu ước tính về mức độ tác động nếu bạn chọn tuỳ chọn này.

targetCpaMicros

string (int64 format)

Chỉ có đầu ra. Mục tiêu CPA trung bình.

requiredCampaignBudgetAmountMicros

string (int64 format)

Chỉ có đầu ra. Ngân sách chiến dịch tối thiểu (bằng nội tệ cho tài khoản) là bắt buộc để đạt được CPA mục tiêu. Số tiền được chỉ định bằng micrô, trong đó một triệu tương đương với một đơn vị tiền tệ.

TargetCpaOptInRecommendationGoal

Mục tiêu của đề xuất TargetCpaOptIn.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
SAME_COST Nội dung đề xuất đặt CPA mục tiêu để duy trì cùng mức chi phí.
SAME_CONVERSIONS Đề xuất đặt CPA mục tiêu để duy trì cùng số lượt chuyển đổi.
SAME_CPA Bạn nên đặt CPA mục tiêu để duy trì cùng một mức CPA.
CLOSEST_CPA Đề xuất đặt CPA mục tiêu thành một giá trị càng gần với CPA thực tế càng tốt nhưng thấp hơn CPA thực tế (được tính trong 28 ngày qua).

MaximizeConversionsOptInRecommendation

Đề xuất chọn sử dụng chiến lược Tối đa hoá lượt chuyển đổi.

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

string (int64 format)

Chỉ có đầu ra. Số tiền ngân sách mới được đề xuất.

EnhancedCpcOptInRecommendation

Loại này không có trường.

Đề xuất chọn sử dụng chi phí mỗi lượt nhấp nâng cao.

SearchPartnersOptInRecommendation

Loại này không có trường.

Đề xuất Chọn tham gia Đối tác tìm kiếm.

MaximizeClicksOptInRecommendation

Đề xuất chọn sử dụng chiến lược Tối đa hoá số lượt nhấp.

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

string (int64 format)

Chỉ có đầu ra. Số tiền ngân sách mới được đề xuất. Chỉ đặt nếu ngân sách hiện tại quá cao.

OptimizeAdRotationRecommendation

Loại này không có trường.

Đề xuất Tối ưu hóa xoay vòng quảng cáo.

KeywordMatchTypeRecommendation

Đề xuất về kiểu khớp từ khoá.

Biểu diễn dưới dạng JSON
{
  "keyword": {
    object (KeywordInfo)
  },
  "recommendedMatchType": enum (KeywordMatchType)
}
Trường
keyword

object (KeywordInfo)

Chỉ có đầu ra. Từ khoá hiện tại mà kiểu khớp phải rộng hơn.

recommendedMatchType

enum (KeywordMatchType)

Chỉ có đầu ra. Kiểu khớp mới được đề xuất.

MoveUnusedBudgetRecommendation

Đề xuất chuyển ngân sách chưa sử dụng.

Biểu diễn dưới dạng JSON
{
  "budgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "excessCampaignBudget": string
}
Trường
budgetRecommendation

object (CampaignBudgetRecommendation)

Chỉ có đầu ra. Nội dung đề xuất tăng ngân sách bị ràng buộc.

excessCampaignBudget

string

Chỉ có đầu ra. ResourceName của ngân sách vượt quá.

TargetRoasOptInRecommendation

Đề xuất chọn sử dụng lợi tức mục tiêu trên chi tiêu quảng cáo.

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

number

Chỉ có đầu ra. Lợi tức mục tiêu trên chi tiêu quảng cáo đề xuất (doanh thu trên mỗi đơn vị chi tiêu). Giá trị nằm trong khoảng từ 0,01 đến 1000,0.

requiredCampaignBudgetAmountMicros

string (int64 format)

Chỉ có đầu ra. Ngân sách chiến dịch tối thiểu (bằng nội tệ cho tài khoản) cần thiết để đạt được ROAS mục tiêu. Số tiền được chỉ định bằng micrô, trong đó một triệu tương đương với một đơn vị tiền tệ.

ResponsiveSearchAdRecommendation

Đề xuất thêm quảng cáo tìm kiếm thích ứng.

Biểu diễn dưới dạng JSON
{
  "ad": {
    object (Ad)
  }
}
Trường
ad

object (Ad)

Chỉ có đầu ra. Quảng cáo được đề xuất.

UseBroadMatchKeywordRecommendation

Đề xuất sử dụng từ khoá khớp mở rộng.

Biểu diễn dưới dạng JSON
{
  "keyword": [
    {
      object (KeywordInfo)
    }
  ],
  "suggestedKeywordsCount": string,
  "campaignKeywordsCount": string,
  "campaignUsesSharedBudget": boolean,
  "requiredCampaignBudgetAmountMicros": string
}
Trường
keyword[]

object (KeywordInfo)

Chỉ có đầu ra. Mẫu từ khoá sẽ được mở rộng thành Kiểu khớp mở rộng.

suggestedKeywordsCount

string (int64 format)

Chỉ có đầu ra. Tổng số từ khoá sẽ được mở rộng sang Kiểu khớp mở rộng trong chiến dịch.

campaignKeywordsCount

string (int64 format)

Chỉ có đầu ra. Tổng số từ khoá trong chiến dịch.

campaignUsesSharedBudget

boolean

Chỉ có đầu ra. Liệu chiến dịch được liên kết có sử dụng ngân sách dùng chung hay không.

requiredCampaignBudgetAmountMicros

string (int64 format)

Chỉ có đầu ra. Bạn nên sử dụng ngân sách để tránh bị ràng buộc ngân sách sau khi áp dụng nội dung đề xuất.

ResponsiveSearchAdAssetRecommendation

Đề xuất thêm thành phần quảng cáo tìm kiếm thích ứng.

Biểu diễn dưới dạng JSON
{
  "currentAd": {
    object (Ad)
  },
  "recommendedAssets": {
    object (Ad)
  }
}
Trường
currentAd

object (Ad)

Chỉ có đầu ra. Quảng cáo hiện tại sẽ được cập nhật.

recommendedAssets

object (Ad)

Chỉ có đầu ra. Các thành phần được đề xuất. Thẻ này chỉ được điền bằng dòng tiêu đề và/hoặc nội dung mô tả mới, nếu không thì để trống.

UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation

Đề xuất nâng cấp chiến dịch Mua sắm thông minh lên chiến dịch Tối đa hoá hiệu suất.

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

string (int64 format)

Chỉ có đầu ra. Mã tài khoản Merchant Center.

salesCountryCode

string

Chỉ có đầu ra. Quốc gia có sản phẩm trong kho hàng của người bán phải được thêm vào.

ResponsiveSearchAdImproveAdStrengthRecommendation

Quảng cáo tìm kiếm thích ứng giúp cải thiện đề xuất về độ mạnh của quảng cáo.

Biểu diễn dưới dạng JSON
{
  "currentAd": {
    object (Ad)
  },
  "recommendedAd": {
    object (Ad)
  }
}
Trường
currentAd

object (Ad)

Chỉ có đầu ra. Quảng cáo hiện tại sẽ được cập nhật.

recommendedAd

object (Ad)

Chỉ có đầu ra. Quảng cáo đã cập nhật.

DisplayExpansionOptInRecommendation

Loại này không có trường.

Đề xuất chọn sử dụng tính năng Mở rộng hiển thị.

UpgradeLocalCampaignToPerformanceMaxRecommendation

Loại này không có trường.

Đề xuất Nâng cấp chiến dịch Địa phương lên chiến dịch Tối đa hoá hiệu suất.

RaiseTargetCpaBidTooLowRecommendation

Đề xuất tăng giá thầu CPA mục tiêu quá thấp.

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

number

Chỉ có đầu ra. Số lớn hơn 1,0 cho biết yếu tố mà chúng tôi đề xuất nên tăng CPA mục tiêu.

averageTargetCpaMicros

string (int64 format)

Chỉ có đầu ra. CPA mục tiêu trung bình hiện tại của chiến dịch, tính bằng phần triệu nội tệ của khách hàng.

ForecastingSetTargetRoasRecommendation

Tính năng dự báo giúp thiết lập đề xuất về lợi tức mục tiêu trên chi tiêu quảng cáo.

Biểu diễn dưới dạng JSON
{
  "recommendedTargetRoas": number,
  "campaignBudget": {
    object (CampaignBudget)
  }
}
Trường
recommendedTargetRoas

number

Chỉ có đầu ra. Lợi tức mục tiêu trên chi tiêu quảng cáo đề xuất (doanh thu trên mỗi đơn vị chi tiêu). Giá trị nằm trong khoảng từ 0,01 đến 1000,0.

campaignBudget

object (CampaignBudget)

Chỉ có đầu ra. Ngân sách chiến dịch.

CampaignBudget

Ngân sách chiến dịch dùng chung cho nhiều loại đề xuất ngân sách.

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

string (int64 format)

Chỉ có đầu ra. Số tiền ngân sách hiện tại.

recommendedNewAmountMicros

string (int64 format)

Chỉ có đầu ra. Số tiền ngân sách đề xuất.

newStartDate

string

Chỉ có đầu ra. Ngày mà ngân sách mới bắt đầu được sử dụng. Trường này sẽ được đặt cho các loại đề xuất sau: BACKUPING_SET_TARGET_ROAS YYYY-MM-DD, ví dụ: 2018-04-17.

CalloutAssetRecommendation

Đề xuất về thành phần chú thích.

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

object (Asset)

Chỉ có đầu ra. Các thành phần mới của phần mở rộng về chú thích được đề xuất ở cấp chiến dịch.

recommendedCustomerCalloutAssets[]

object (Asset)

Chỉ có đầu ra. Các thành phần mới của phần mở rộng về chú thích được đề xuất ở cấp khách hàng.

SitelinkAssetRecommendation

Đề xuất về thành phần đường liên kết của trang web.

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

CallAssetRecommendation

Loại này không có trường.

Đề xuất về thành phần cuộc gọi.

ShoppingOfferAttributeRecommendation

Đề xuất mua sắm thêm một thuộc tính cho những mặt hàng bị giảm hạng do bị thiếu.

Biểu diễn dưới dạng JSON
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "offersCount": string,
  "demotedOffersCount": string
}
Trường
merchant

object (MerchantInfo)

Chỉ có đầu ra. Thông tin chi tiết về tài khoản Merchant Center.

feedLabel

string

Chỉ có đầu ra. Nhãn nguồn cấp dữ liệu của chiến dịch.

offersCount

string (int64 format)

Chỉ có đầu ra. Số lượng mặt hàng có thể phân phát trực tuyến.

demotedOffersCount

string (int64 format)

Chỉ có đầu ra. Số lượng mặt hàng trực tuyến, có thể phân phát bị giảm hạng do thiếu các thuộc tính. Hãy truy cập vào Merchant Center để biết thêm chi tiết.

MerchantInfo

Thông tin chi tiết về tài khoản Merchant Center.

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

string (int64 format)

Chỉ có đầu ra. Mã tài khoản Merchant Center.

name

string

Chỉ có đầu ra. Tên của tài khoản Merchant Center.

multiClient

boolean

Chỉ có đầu ra. Liệu tài khoản Merchant Center đó có phải là tài khoản nhiều khách hàng (MCA) hay không.

ShoppingAddProductsToCampaignRecommendation

Đề xuất mua sắm về việc thêm sản phẩm vào khoảng không quảng cáo của chiến dịch Mua sắm.

Biểu diễn dưới dạng JSON
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "reason": enum (Reason)
}
Trường
merchant

object (MerchantInfo)

Chỉ có đầu ra. Thông tin chi tiết về tài khoản Merchant Center.

feedLabel

string

Chỉ có đầu ra. Nhãn nguồn cấp dữ liệu cho chiến dịch.

reason

enum (Reason)

Chỉ có đầu ra. Lý do không có sản phẩm nào được đính kèm vào chiến dịch.

Lý do

Các vấn đề dẫn đến việc chiến dịch mua sắm nhắm đến 0 sản phẩm.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
MERCHANT_CENTER_ACCOUNT_HAS_NO_SUBMITTED_PRODUCTS Tài khoản Merchant Center chưa có sản phẩm nào đã gửi.
MERCHANT_CENTER_ACCOUNT_HAS_NO_SUBMITTED_PRODUCTS_IN_FEED Tài khoản Merchant Center chưa gửi sản phẩm nào trong nguồn cấp dữ liệu.
ADS_ACCOUNT_EXCLUDES_OFFERS_FROM_CAMPAIGN Tài khoản Google Ads có các bộ lọc chiến dịch đang hoạt động ngăn việc đưa mặt hàng vào chiến dịch.
ALL_PRODUCTS_ARE_EXCLUDED_FROM_CAMPAIGN Tất cả sản phẩm có sẵn đều đã được loại trừ một cách rõ ràng khỏi mục tiêu trong chiến dịch.

ShoppingFixDisapprovedProductsRecommendation

Đề xuất mua sắm để khắc phục các sản phẩm bị từ chối trong khoảng không quảng cáo của chiến dịch Mua sắm.

Biểu diễn dưới dạng JSON
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "productsCount": string,
  "disapprovedProductsCount": string
}
Trường
merchant

object (MerchantInfo)

Chỉ có đầu ra. Thông tin chi tiết về tài khoản Merchant Center.

feedLabel

string

Chỉ có đầu ra. Nhãn nguồn cấp dữ liệu cho chiến dịch.

productsCount

string (int64 format)

Chỉ có đầu ra. Số lượng sản phẩm của chiến dịch.

disapprovedProductsCount

string (int64 format)

Chỉ có đầu ra. Số lượng sản phẩm của chiến dịch bị từ chối.

ShoppingTargetAllOffersRecommendation

Đề xuất mua sắm để tạo một chiến dịch tổng hợp nhắm đến tất cả ưu đãi.

Biểu diễn dưới dạng JSON
{
  "merchant": {
    object (MerchantInfo)
  },
  "untargetedOffersCount": string,
  "feedLabel": string
}
Trường
merchant

object (MerchantInfo)

Chỉ có đầu ra. Thông tin chi tiết về tài khoản Merchant Center.

untargetedOffersCount

string (int64 format)

Chỉ có đầu ra. Số lượng ưu đãi không được nhắm mục tiêu.

feedLabel

string

Chỉ có đầu ra. Nhãn nguồn cấp dữ liệu mặt hàng.

ShoppingMerchantCenterAccountSuspensionRecommendation

Đề xuất về mua sắm để khắc phục các vấn đề về việc tạm ngưng tài khoản Merchant Center.

Biểu diễn dưới dạng JSON
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
Trường
merchant

object (MerchantInfo)

Chỉ có đầu ra. Thông tin chi tiết về tài khoản Merchant Center.

feedLabel

string

Chỉ có đầu ra. Nhãn nguồn cấp dữ liệu của chiến dịch bị tạm ngưng.

ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

Bạn nên di chuyển các ưu đãi được nhắm đến của chiến dịch Mua sắm thông thường sang chiến dịch Tối đa hoá hiệu suất.

Biểu diễn dưới dạng JSON
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
Trường
merchant

object (MerchantInfo)

Chỉ có đầu ra. Thông tin chi tiết về tài khoản Merchant Center.

feedLabel

string

Chỉ có đầu ra. Nhãn nguồn cấp dữ liệu của các mặt hàng mà chiến dịch chia sẻ đề xuất này nhắm đến.

DynamicImageExtensionOptInRecommendation

Loại này không có trường.

Đề xuất bật phần mở rộng về hình ảnh linh hoạt trên tài khoản, giúp Google tìm những hình ảnh phù hợp nhất trên trang đích của quảng cáo và bổ sung cho quảng cáo dạng văn bản.

RaiseTargetCpaRecommendation

Nội dung đề xuất tăng CPA mục tiêu.

Biểu diễn dưới dạng JSON
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  },
  "appBiddingGoal": enum (AppBiddingGoal)
}
Trường
targetAdjustment

object (TargetAdjustmentInfo)

Chỉ có đầu ra. Thông tin liên quan mô tả mức điều chỉnh mục tiêu được đề xuất.

appBiddingGoal

enum (AppBiddingGoal)

Chỉ có đầu ra. Thể hiện mục tiêu mà chiến lược đặt giá thầu sẽ tối ưu hoá. Chỉ được điền sẵn cho chiến dịch Quảng cáo ứng dụng.

TargetAdjustmentInfo

Thông tin về đề xuất điều chỉnh mục tiêu.

Biểu diễn dưới dạng JSON
{
  "recommendedTargetMultiplier": number,
  "currentAverageTargetMicros": string,
  "sharedSet": string
}
Trường
recommendedTargetMultiplier

number

Chỉ có đầu ra. Đây là hệ số mà bạn nên dùng để điều chỉnh mục tiêu.

currentAverageTargetMicros

string (int64 format)

Chỉ có đầu ra. Mục tiêu trung bình hiện tại của chiến dịch hoặc danh mục đầu tư mà đề xuất này nhắm đến.

sharedSet

string

Chỉ có đầu ra. Tên tài nguyên nhóm dùng chung của chiến lược giá thầu danh mục đầu tư mà tại đó mục tiêu được xác định. Chỉ được điền nếu đề xuất ở cấp danh mục đầu tư.

AppBiddingGoal

Thể hiện mục tiêu mà chiến lược đặt giá thầu của một chiến dịch quảng cáo ứng dụng sẽ tối ưu hoá.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Biểu thị giá trị không xác định trong phiên bản API này.
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME Chiến lược đặt giá thầu của chiến dịch quảng cáo ứng dụng nên nhằm tối đa hoá số lượt cài đặt ứng dụng.
OPTIMIZE_FOR_IN_APP_CONVERSION_VOLUME Chiến lược đặt giá thầu của chiến dịch quảng cáo ứng dụng nên nhắm đến việc tối đa hoá số lượt chuyển đổi trong ứng dụng đã chọn.
OPTIMIZE_FOR_TOTAL_CONVERSION_VALUE Chiến lược đặt giá thầu của chiến dịch quảng cáo ứng dụng nên hướng đến việc tối đa hoá giá trị của tất cả lượt chuyển đổi, tức là lượt cài đặt và lượt chuyển đổi trong ứng dụng được chọn.
OPTIMIZE_FOR_TARGET_IN_APP_CONVERSION Chiến lược đặt giá thầu của chiến dịch quảng cáo ứng dụng nên nhắm đến việc chỉ tối đa hoá số lượt chuyển đổi trong ứng dụng đã chọn, đồng thời đạt được hoặc vượt mức chi phí mục tiêu cho mỗi lượt chuyển đổi trong ứng dụng.
OPTIMIZE_FOR_RETURN_ON_ADVERTISING_SPEND Chiến lược đặt giá thầu của chiến dịch quảng cáo ứng dụng nên hướng đến việc tối đa hoá giá trị của tất cả lượt chuyển đổi, tức là lượt cài đặt và lượt chuyển đổi trong ứng dụng được chọn, đồng thời đạt hoặc vượt mức lợi tức mục tiêu trên chi tiêu quảng cáo.
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME_WITHOUT_TARGET_CPI Chiến lược đặt giá thầu này của chiến dịch quảng cáo ứng dụng nên nhằm tối đa hoá số lượt cài đặt ứng dụng mà không cần chi phí mục tiêu cho mỗi lượt cài đặt do nhà quảng cáo cung cấp.
OPTIMIZE_FOR_PRE_REGISTRATION_CONVERSION_VOLUME Chiến lược đặt giá thầu này của chiến dịch quảng cáo ứng dụng nên nhằm tối đa hoá số lượt đăng ký trước ứng dụng.

LowerTargetRoasRecommendation

Đề xuất giảm lợi tức mục tiêu trên chi tiêu quảng cáo.

Biểu diễn dưới dạng JSON
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  }
}
Trường
targetAdjustment

object (TargetAdjustmentInfo)

Chỉ có đầu ra. Thông tin liên quan mô tả mức điều chỉnh mục tiêu được đề xuất.

PerformanceMaxOptInRecommendation

Loại này không có trường.

Đề xuất chọn tham gia chiến dịch Tối đa hoá hiệu suất.

ImprovePerformanceMaxAdStrengthRecommendation

Nội dung đề xuất cải thiện độ mạnh của nhóm thành phần của chiến dịch Tối đa hoá hiệu suất lên điểm xếp hạng "Rất tốt".

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

string

Chỉ có đầu ra. Tên tài nguyên của nhóm thành phần.

MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

Đề xuất di chuyển từ chiến dịch Quảng cáo tìm kiếm động sang chiến dịch Tối đa hoá hiệu suất.

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

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 chế độ xem cụm từ tìm kiếm có dạng:

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 những từ khoá được nhắm mục tiêu hay bị loại trừ của bạn 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 nơi 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 những từ khoá được nhắm mục tiêu hay bị loại trừ của bạn.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
ADDED Cụm từ tìm kiếm sẽ được thêm vào danh sách 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ừa bị loại trừ.
NONE Cụm từ tìm kiếm không được nhắm mục tiêu cũng như không bị loại trừ.

ShoppingPerformanceView

Chế độ xem hiệu suất mua sắm. Cung cấp số liệu thống kê về chiến dịch Mua sắm được tổng hợp ở nhiều 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 (chẳng hạn 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ẽ phản ánh trạng thái của từng phương diện kể từ ngày và giờ khi sự kiện tương ứng được ghi 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 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:

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 nơi cụm từ tìm kiếm 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 chế độ xem chủ đề. Tên tài nguyên chế độ xem theo chủ đề có dạng:

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

TravelActivityGroupView

Chế độ xem theo nhóm hoạt động du lị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 nhóm hoạt động du lịch. Tên tài nguyên của chế độ xem Nhóm hoạt động du lịch có dạng:

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

TravelActivityPerformanceView

Chế độ xem hiệu suất hoạt động du lị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 hiệu suất hoạt động du lịch. Tên tài nguyên chế độ xem hiệu suất Hoạt động du lịch có dạng:

customers/{customerId}/travelActivityPerformanceView

UserInterest

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 về mối quan tâm của người dùng. Tên tài nguyên mối quan tâm của người dùng có dạng:

customers/{customerId}/userInterests/{userInterestId}

taxonomyType

enum (UserInterestTaxonomyType)

Chỉ có đầu ra. Loại phân loại về mối quan tâm của người dùng.

availabilities[]

object (CriterionCategoryAvailability)

Chỉ có đầu ra. Thông tin về khả năng đáp ứng liên quan đến mối quan tâm của người dùng.

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 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 người dùng quan tâm đến 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ề. Đại diện cho giá trị không xác định trong phiên bản này.
AFFINITY Đối tượng chung sở thích liên quan đến mối quan tâm của người dùng này.
IN_MARKET Thị trường đáp ứng mối quan tâm này của người dùng.
MOBILE_APP_INSTALL_USER Người dùng được biết là đã cài đặt ứng dụng thuộ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 cho người mới dùng điện thoại thông minh.

LifeEvent

Sự kiện trong đời: một ngành dọc dựa trên mối quan tâm cụ thể được nhắm mục tiêu để 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:

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ụ: "Đã di chuyển gần đây"

parent

string

Chỉ có đầu ra. Cấp độ gốc của sự kiện trong cuộc sống.

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ề phạm vi cung cấp 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ố được tổng hợp ở cấp quốc gia, một hàng cho mỗi quốc gia. Tính năng này 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 đến. 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,
  "countryCriterionId": string,
  "targetingLocation": boolean
}
Trường
resourceName

string

Chỉ có đầu ra. Tên tài nguyên của chế độ xem vị trí 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 liệu 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ó vị trí (ví dụ: "Thú cưng và Độ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 danh mục "Thú cưng & Động vật/Thú cưng/Chó". Danh sách các danh mục chủ đề hiện có 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ấp độ gốc của hằng số chủ đề.

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ã nhận dạng 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

Lượt 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 chế độ xem 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ừ 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 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:

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 đượ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 đã nhận được.

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 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. Văn bản 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 cho câu trả lời cho câu hỏi tuỳ chỉnh, số ký tự tối đa là 70.

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)
  ],
  "skAdNetworkConversions": 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,
  "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
}
Trường
allConversionsValueByConversionDate

number

Giá trị của tất cả lượt chuyển đổi. Khi cột này được chọn cùng với ngày, thì 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 cột này được chọn cùng với ngày, thì 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. Giá trị 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 cột này được chọn cùng với ngày, thì 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. Giá trị 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 cột này được chọn cùng với ngày, thì 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 trước đây của mẫu quảng cáo.

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 được dự đoán (CTR) trong quá khứ tìm kiếm.

interactionEventTypes[]

enum (InteractionEventType)

Các loại tương tác có thể thanh toán và tương tác miễn phí.

skAdNetworkConversions

string (int64 format)

Số lượt chuyển đổi trên Mạng quảng cáo của Bộ công cụ cửa hàng trên iOS.

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 từ những tài sản mà nhà xuất bản không trả phí hoặc không nhận được lưu lượng truy cập thông qua hoạt động khuyến khích

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 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ể được xem trên trang web Mạng hiển thị.

activeViewMeasurability

number

Tỷ lệ hiển thị có thể được Chế độ xem đang kích hoạt đo lường trên số lần hiển thị đã phân phát.

activeViewMeasurableCostMicros

string (int64 format)

Chi phí của 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 nhìn thấy.

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 (ngược chiều 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ả giá trị chuyển đổi lâu dài của khách hàng mới. 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ì mục tiêu này sẽ bao gồm giá trị lượt chuyển đổi bổ sung từ khách hàng mới cho 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ì những giá trị này sẽ được đưa vào "allConversionsValue". Hãy tham khảo 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. 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.

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 người dùng nhấp vào nút "Gọi" để gọi đến một 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" để tìm đường đến 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.

allConversionsFromInteractionsValuePerInteraction

number

Giá trị của tất cả chuyển đổi từ các lần tương tác chia cho tổng số lần 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 người dùng đặ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á. Chỉ số này 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 trên những phiên đấu giá mà bạn đã xuất hiện trên trang.

Chỉ số này không có sẵn 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á và cho biết tỷ lệ phần trăm số lần hiển thị mà một người tham gia khác đã nhận được trên tổng số lần hiển thị mà quảng cáo của bạn đủ điều kiện nhận được. Bất kỳ giá trị nào nhỏ hơn 0,1 đều được báo cáo là 0,0999.

Chỉ số này không có sẵn 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ó thứ 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ượt hiển thị mà quảng cáo của bạn đủ điều kiện nhận được. Bất kỳ giá trị nào nhỏ hơn 0,1 đều được báo cáo là 0,0999.

Chỉ số này không có sẵn công khai.

auctionInsightSearchOverlapRate

number

Chỉ số này nằm trong báo cáo Thông tin chi tiết về phiên đấu giá. Chỉ số này cho biết tần suất quảng cáo của một người tham gia khác đã nhận được lượt hiển thị khi quảng cáo của bạn cũng nhận được lượt hiển thị.

Chỉ số này không có sẵn 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á. Chỉ số này 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í cao hơn quảng cáo của bạn, khi cả hai quảng cáo của bạn hiển thị ở cùng một trang.

Chỉ số này không có sẵn công khai.

auctionInsightSearchTopImpressionPercentage

number

Chỉ số này nằm trong báo cáo Thông tin chi tiết về phiên đấu giá. Chỉ số này cho biết tần suất quảng cáo của một người tham gia khác xuất hiện bên cạnh các 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 trên những phiên đấu giá mà bạn đã xuất hiện trên trang.

Chỉ số này không có sẵn 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ượt 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ả các lần tương tác quảng cáo chia cho tổng số lần tương tác 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ượt 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 cho biết cách những nhà quảng cáo khác đang đặt giá thầu trên 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

Một chỉ báo về hiệu suất của quảng cáo Mua sắm cho những sản phẩm tương tự của các nhà quảng cáo khác dựa trên tần suất những người 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 số 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 quảng cáo hoặc danh sách trang web của bạn trong kết quả không trả phí được nhấp. 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 quảng cáo hoặc danh sách trang web của bạn trong kết quả không tính phí được nhấp (combinedGB) chia cho các Cụm từ tìm kiếm kết hợp. 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ần tìm kiếm đã trả về các trang từ trang web của bạn trong kết quả không trả phí hoặc hiển thị một trong các quảng cáo 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

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 do ngân sách quá thấp. Lưu ý: Tỷ lệ hiển thị bị mất của 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 đượ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 từ 0,1 đến 1. Bất kỳ giá trị nào nhỏ hơn 0,1 đều được báo cáo là 0,0999.

conversionLastReceivedRequestDateTime

string

Ngày/giờ gần đây nhất mà thẻ chuyển đổi cho hành động chuyển đổi này đã được kích hoạt thành công và đã được Google Ads nhìn thấy. Sự kiện kích hoạt này có thể không phải là kết quả của một chuyển đổi có thể phân bổ (ví dụ: do thẻ được kích hoạt từ một trình duyệt mà trước đó khô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ờ 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 theo múi giờ của khách hàng.

contentRankLostImpressionShare

number

Tỷ lệ phần trăm số lượt 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 Thứ hạng quảng cáo thấp. Lưu ý: Tỷ lệ hiển thị bị mất của 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 được báo cáo là 0,9001.

conversionsFromInteractionsRate

number

Số lượt chuyển đổi từ số 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ư 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). Giá trị 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.

conversionsValue

number

Giá trị của lượt chuyển đổi. Giá trị 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.

newCustomerLifetimeValue

number

Giá trị chuyển đổi lâu dài của khách hàng mới. 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ì mục tiêu 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 tham khảo https://support.google.com/google-ads/answer/12080169 để biết thêm chi tiết.

conversionsValuePerCost

number

Giá trị của các 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. Giá trị 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.

conversionsFromInteractionsValuePerInteraction

number

Giá trị của các lượt chuyển đổ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. Giá trị 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. Giá trị 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.

costMicros

string (int64 format)

Tổng chi phí mỗi lượt nhấp (CPC) và giá mỗi nghìn lượt hiển thị (CPM) của bạn 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ả lượt chuyển đổi.

costPerConversion

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. Giá trị 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.

costPerCurrentModelAttributedConversion

number

Chi phí của lượt tương tác với quảng cáo chia cho số lượt chuyển đổi được phân bổ theo mô hình hiện tại. Giá trị 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.

crossDeviceConversions

number

Lượt chuyển đổi từ việc 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ả các Lượt chuyển đổi.

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 đã chọn. Giá trị 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.

currentModelAttributedConversionsFromInteractionsRate

number

Mô hình hiện tại có mô hình hiện tại về 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ư 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). Giá trị 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.

currentModelAttributedConversionsFromInteractionsValuePerInteraction

number

Giá trị của các lượt chuyển đổi phân bổ theo 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. Giá trị 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.

currentModelAttributedConversionsValue

number

Giá trị của các lượt chuyển đổi phân bổ theo mô hình hiện tại. Giá trị 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.

currentModelAttributedConversionsValuePerCost

number

Giá trị của các lượt chuyển đổi 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. Giá trị 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.

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ần 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ị trung bình của khách hàng tiềm năng dựa trên số lượt nhấp.

hotelCommissionRateMicros

string (int64 format)

Tỷ lệ giá thầu phí hoa hồng cực nhỏ. Phí hoa hồng 20% tương ứng với 200.000.

hotelExpectedCommissionCost

number

Chi phí phí hoa hồng dự kiến. Kết quả của việc nhân giá trị phí hoa hồng với tỷ lệ Hotel_commission_rate 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á rẻ 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 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 thông báo.

gmailSaves

string (int64 format)

Số lần người nào đó đã 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)

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ượt tương tác chia cho số lần quảng cáo của bạn hiển thị.

interactions

string (int64 format)

Số lần 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 không đượ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 được tính cho bạn.

messageChats

string (int64 format)

Số cuộc trò chuyện bằng tin nhắn đã bắt đầu cho số lần hiển thị Nhấp để nhắn tin đủ điều kiện theo dõi tin nhắn.

messageImpressions

string (int64 format)

Số lần 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 qua tin nhắn đã thực hiện (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 qua tin nhắn từ một lượt hiển thị quảng cáo có bật lựa chọn nhắn tin và theo dõi tin nhắn. 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ả đề 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ể được 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 từng tổ hợp riêng biệt (customer, recommendationsType).

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 kết quả không phải trả tiền (Bao gồm các lượt nhấp không phải trả tiền) chia cho tổng số lượt tìm kiếm mà các trang đã trả về từ trang web của bạn (Truy vấn hữu cơ). 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 từ 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ần tìm kiếm trả lại danh sách trang web của bạn trong kết quả không phải trả tiền (Truy vấ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.

organicQueries

string (int64 format)

Tổng số tìm kiếm đã trả lại danh sách trang web của bạn trong các kết quả 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.

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ần hiển thị cuộc gọ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 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 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 hiển thị tại vị trí Mua sắm nổi bật nhất. Hãy tham khảo https://support.google.com/google-ads/answer/7501826 để biết thông tin chi tiết. Bất kỳ giá trị nào nhỏ hơn 0,1 đều được báo cáo là 0,0999.

searchBudgetLostAbsoluteTopImpressionShare

number

Con số ướ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ị hàng đầu tuyệt đối bị mất của 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 được báo cáo là 0,9001.

searchBudgetLostImpressionShare

number

Phần trăm số lần quảng cáo đủ điều kiện hiển thị trên Mạng tìm kiếm ước tính nhưng đã không do ngân sách quá thấp. Lưu ý: Tỷ lệ hiển thị bị mất của 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 được báo cáo là 0,9001.

searchBudgetLostTopImpressionShare

number

Con số ướ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 các 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ị hàng đầu bị mất của 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 đượ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 được. Lưu ý: Tỷ lệ nhấp chuột tìm kiếm được báo cáo trong khoảng từ 0,1 đến 1. Bất kỳ giá trị nào nhỏ hơn 0,1 đều được báo cáo là 0,0999.

searchExactMatchImpressionShare

number

Số lần hiển thị bạn đã nhận được chia cho số lần hiển thị ước tính mà bạn đủ điều kiện nhận được 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ừ khóa của bạn (hoặc là các biến thể gần giống của từ khóa), bất kể kiểu so khớp từ khóa của bạn là gì. Lưu ý: Tỷ lệ hiển thị khớp chính xác 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 nhỏ hơn 0,1 đều đượ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 nhỏ hơn 0,1 đều được báo cáo là 0,0999.

searchRankLostAbsoluteTopImpressionShare

number

Con số ướ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 xuất hiện đầ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 nhất bị mất của 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 được báo cáo là 0,9001.

searchRankLostImpressionShare

number

Tỷ lệ 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 của 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 được báo cáo là 0,9001.

searchRankLostTopImpressionShare

number

Con số ướ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ị hàng đầu bị mất của 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 được báo cáo là 0,9001.

searchTopImpressionShare

number

Số lượt hiển thị mà bạn nhận được trong số các 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 những quảng cáo hàng đầu. Lưu ý: Tỷ lệ hiển thị hàng đầu 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 nhỏ hơn 0,1 đều đượ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)

Chỉ số đo lường tốc độ tải trang sau khi người dùng nhấp vào quảng cáo trên thiết bị di động. Phạm vi điểm số 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ó giá trị này (ví dụ: đối với 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 chiến lượ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ụ: đối với 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 chiến lược không phải ROAS mục tiêu).

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 các kết quả tìm kiếm tự nhiên hàng đầu.

validAcceleratedMobilePagesClicksPercentage

number

Tỷ lệ phần trăm số lượt nhấp vào quảng cáo vào trang đích Accelerated Mobile Pages (AMP) để truy cập một trang AMP hợp lệ.

valuePerAllConversions

number

Giá trị của tất cả lượt chuyển đổi chia cho tổng số lượt chuyển đổi.

valuePerAllConversionsByConversionDate

number

Giá trị của tất cả lượt chuyển đổi chia cho tổng số lượt chuyển đổi. Khi cột này được chọn cùng với ngày, thì 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.

valuePerConversion

number

Giá trị chuyển đổi chia cho số lượt chuyển đổi. Giá trị 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.

valuePerConversionsByConversionDate

number

Giá trị chuyển đổi chia cho số lượt chuyển đổi. Giá trị 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 cột này được chọn cùng với ngày, thì 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 phân bổ theo mô hình hiện tại chia cho số lượt chuyển đổi. Giá trị 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.

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ị mà khán giả đã xem 25% video của bạn.

videoQuartileP50Rate

number

Tỷ lệ phần trăm số lượt hiển thị mà khán giả đã xem 50% video của bạn.

videoQuartileP75Rate

number

Tỷ lệ phần trăm số lượt hiển thị mà khán giả đã 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ả 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 hành động này xảy ra khi khách hàng nhìn thấy quảng cáo dạng hình ảnh hoặc quảng cáo đa phương tiện, sau đó hoàn tất lượt chuyển đổi trên trang web của bạn mà không tương tác với (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 mọi nền tảng vị trí sau một sự kiện quảng cáo có thể tính phí (lượt nhấp hoặc lượt hiển thị). Chỉ số này được lấy từ vị trí dựa trên thành phần.

allConversionsFromLocationAssetDirections

number

Số lượt nhấp vào đường lái xe trên mọi nền tảng vị trí sau một sự kiện quảng cáo có thể tính phí (lượt nhấp hoặc lượt hiển thị). Chỉ số 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 trình đơn trên mọi nền tảng vị trí sau một sự kiện quảng cáo có thể tính phí (lượt nhấp hoặc lượt hiển thị). Chỉ số 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 nền tảng vị trí bất kỳ sau một sự kiện quảng cáo có thể tính phí (lượt nhấp hoặc lượt hiển thị). Chỉ số này được lấy từ vị trí dựa trên thành phần.

allConversionsFromLocationAssetOtherEngagement

number

Số các loại lượt nhấp khác vào hành động liên quan đến địa điểm thực tế trên mọi nền tảng vị trí sau một sự kiện quảng cáo có thể tính phí (lượt nhấp hoặc lượt hiển thị). Chỉ số 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ó thể tính phí (lượt nhấp hoặc lượt hiển thị). Chỉ số 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ọi nền tảng vị trí sau một sự kiện quảng cáo có thể tính phí (lượt nhấp hoặc lượt hiển thị). Chỉ số 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à trong đó vị trí cửa hàng được hiển thị hoặc vị trí được dùng để nhắm mục tiêu. Chỉ số 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 mọi nền tảng vị trí sau một lượt hiển thị. Chỉ số này được lấy từ vị trí dựa trên thành phần.

viewThroughConversionsFromLocationAssetDirections

number

Số lượt nhấp vào đường lái xe trên mọi nền tảng vị trí sau một lượt hiển thị. Chỉ số này được lấy 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 mọi nền tảng vị trí sau một lượt hiển thị. Chỉ số 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 nền tảng vị trí bất kỳ sau khi quảng cáo hiển thị. Chỉ số này được lấy từ vị trí dựa trên thành phần.

viewThroughConversionsFromLocationAssetOtherEngagement

number

Số lượt nhấp vào hành động liên quan đến địa điểm thực tế khác trên mọi nền tảng vị trí sau một lượt hiển thị. Chỉ số 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ế ước tính sau khi quảng cáo hiển thị. Chỉ số 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 mọi nền tảng vị trí sau một lượt hiển thị. Chỉ số này được lấy từ vị trí dựa trên thành phần.

InteractionEventType

Enum mô tả các loại tương tác có thể trả và miễn phí.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho 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à InteractionEventType mặc định cho các sự kiện nhấp chuột.
ENGAGEMENT Ý định đã thể hiện của người dùng để 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 EngageEventType mặc định cho các sự kiện chuyển đổi quảng cáo. Tính năng 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 các lượt tương tác miễn phí (ví dụ: lượt chuyển đổi quảng cáo) cần được "quảng bá" và được báo cáo trong các chỉ số chính. Đây chỉ đơn giản là các chuyển đổi (quảng cáo) khác.

SearchVolumeRange

Phạm vi lượng tìm kiếm. 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ỉ 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),
  "newVersusReturningCustomers": enum (ConvertingUserPriorEngagementTypeAndLtvBucket),
  "activityAccountId": string,
  "activityRating": 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,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": 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)
  },
  "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)

Giá trị enum biểu thị số ngày từ lúc hiển thị đến lúc chuyển đổi.

conversionOrAdjustmentLagBucket

enum (ConversionOrAdjustmentLagBucket)

Giá trị enum biểu thị số ngày giữa lượt hiển thị và lượt chuyển đổi, hoặc từ lượt hiển thị đến lúc có 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)

Nhóm giá khách sạn.

keyword

object (Keyword)

Tiêu chí từ khóa.

monthOfYear

enum (MonthOfYear)

Tháng trong năm, ví dụ: tháng 1.

placeholderType

enum (PlaceholderType)

Loại phần giữ chỗ. Thông số này chỉ được dùng với các chỉ số mục trong 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 của 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)

Kiểu khớp của từ khoá đã kích hoạt quảng cáo, bao gồm cả các biến thể.

slot

enum (Slot)

Vị trí của quảng cáo.

conversionValueRulePrimaryDimension

enum (ConversionValueRulePrimaryDimension)

Phương diện chính của các quy tắc về giá trị lượt chuyển đổi được áp dụng. NO_RULE_APPLICABLE hiển thị tổng giá trị được ghi lại của những lượt 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ị. ĐỊA LÝ ĐỊA LÝ, THIẾT BỊ, KHÁN GIẢ hiển thị 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 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ụ iOS Store.

skAdNetworkAttributionCredit

enum (SkAdNetworkAttributionCredit)

Tín dụng phân bổ Mạng quảng cáo của Bộ công cụ iOS Store

newVersusReturningCustomers

enum (ConvertingUserPriorEngagementTypeAndLtvBucket)

Thao tác này dùng để phân đoạn các lượt chuyển đổi theo tiêu chí 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 được dùng để đo lường 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.

activityRating

string (int64 format)

Điểm xếp hạng hoạt động.

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

Tên 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 chia 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 delta nếu các lượt chuyển đổi đã được điều chỉnh. Hàng False có dữ liệu như đã mô tả ban đầu; Trong khi hàng true có delta giữa dữ liệu hiện tại và dữ liệu như đã nêu ban đầu. Tổng hợp dữ liệu sau khi điều chỉnh cho cả hai kết quả.

date

string

Ngày áp dụng các chỉ số. định dạng yyyy-MM-dd, ví dụ: 17-04-2018.

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ý đại diện cho 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ý đại diện cho 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ý đại diện cho 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ạng số từ 0 đến 23.

interactionOnThisExtension

boolean

Chỉ được dùng với các chỉ số mục trong nguồn cấp dữ liệu. Cho biết liệu chỉ số lượt tương tác xảy ra trên chính mục nguồn cấp dữ liệu hay trên một phần mở rộng hoặc đơn vị quảng cáo khác.

month

string

Tháng được biểu thị bằng ngày của ngày đầu tiên của 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.

productBiddingCategoryLevel1

string

Danh mục đặt giá thầu (cấp 1) của sản phẩm.

productBiddingCategoryLevel2

string

Danh mục đặt giá thầu (cấp 2) của sản phẩm.

productBiddingCategoryLevel3

string

Danh mục đặt giá thầu (cấp 3) của sản phẩm.

productBiddingCategoryLevel4

string

Danh mục đặt giá thầu (cấp 4) của sản phẩm.

productBiddingCategoryLevel5

string

Danh mục đặt giá thầu (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 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

Quý được biểu thị bằng ngày của ngày đầu tiên của quý. Sử dụng năm dương lịch cho các quý, ví dụ: quý hai của năm 2018 bắt đầu vào ngày 1/4/2018. Được định dạng là yyyy-MM-dd.

searchSubcategory

string

Danh mục phụ cụm từ tìm kiếm. Chuỗi trống biểu thị danh mục phụ tổng hợp cho những cụm từ tìm kiếm không phù hợp với 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ị lượt chuyển đổi trên Mạng quảng cáo của Bộ công cụ iOS Store. Giá trị rỗng có nghĩa là không áp dụng được phân khúc này, ví dụ: chiến dịch không dành cho iOS.

skAdNetworkSourceApp

object (SkAdNetworkSourceApp)

Ứng dụng 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 đoạn này không áp dụng được (ví dụ: 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.

assetInteractionTarget

object (AssetInteractionTarget)

Chỉ được sử dụng với các chỉ số CustomerAsset, CampaignAsset và nhóm Nhóm quảng cáo. 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 hoặc đơ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ụ: Bản thân quảng cáo và các thành phần khác như Đường liên kết của trang web) khi chúng được phân phát cùng nhau. Khi engagementOnThisAsset là đúng, có nghĩa là các lượt tương tác có trên thành phần cụ thể này và khi engagementOnThisAsset là sai, có nghĩa là lượt tương tác không có trên thành phần này mà trên những phần khác của quảng cáo được phân phát cùng 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 Giá trị không xác định trong phiên bản này.
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 tới 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ố Gọi điện
MAP_DIRECTIONS Ứng dụng bản đồ
LOCATION_LISTING Trang dành riêng cho 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 Giá trị không xác định trong phiên bản này.
SEARCH Tìm kiếm Google.
SEARCH_PARTNERS Các đối tác tìm kiếm.
CONTENT Mạng hiển thị
YOUTUBE_WATCH Video trên YouTube
MIXED Nhiều mạng.

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 của chiến dịch.

BudgetCampaignAssociationStatus

Các trạng thái có thể có của mối liên kết giữa Ngân sách và Chiến dịch.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho 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 này.

ClickType

Liệt kê các loại lượt nhấp trên Google Ads.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Giá trị không xác định trong phiên bản này.
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 Chỉ đường lái xe.
LOCATION_EXPANSION Nhận chi tiết 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 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 dịch vụ 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 các lượt chuyển đổi được phân bổ.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Đại diện cho giá trị không xác định trong phiên bản này.
IMPRESSION Lượt chuyển đổi này được phân bổ cho một lượt hiển thị.
INTERACTION Lượt chuyển đổi này được phân bổ cho một lượt tương tác.

ConversionLagBucket

Enum biểu thị số ngày giữa lượt hiển thị và lượt chuyển đổi.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho 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.
ONE_TO_TWO_DAYS Nhóm độ trễ của lượt chuyển đổi từ 1 đến 2 ngày. Bao gồm 1 ngày, 2 ngày không được tính.
TWO_TO_THREE_DAYS Nhóm độ trễ của lượt chuyển đổi từ 2 đến 3 ngày. Bao gồm 2 ngày, không bao gồm 3 ngày.
THREE_TO_FOUR_DAYS Nhóm độ trễ của lượt chuyển đổi từ 3 đến 4 ngày. Bao gồm 3 ngày, không có 4 ngày.
FOUR_TO_FIVE_DAYS Nhóm độ trễ của lượt chuyển đổi từ 4 đến 5 ngày. Có 4 ngày, không có 5 ngày.
FIVE_TO_SIX_DAYS Nhóm độ trễ của lượt chuyển đổi từ 5 đến 6 ngày. 5 ngày được tính, 6 ngày không phải.
SIX_TO_SEVEN_DAYS Nhóm độ trễ của lượt chuyển đổi từ 6 đến 7 ngày. Có 6 ngày, không có 7 ngày.
SEVEN_TO_EIGHT_DAYS Nhóm độ trễ của lượt chuyển đổi từ 7 đến 8 ngày. Có 7 ngày, không có 8 ngày.
EIGHT_TO_NINE_DAYS Nhóm độ trễ của lượt chuyển đổi từ 8 đến 9 ngày. Có 8 ngày, không có 9 ngày.
NINE_TO_TEN_DAYS Nhóm độ trễ của lượt chuyển đổi từ 9 đến 10 ngày. 9 ngày được tính, 10 ngày không được tính.
TEN_TO_ELEVEN_DAYS Nhóm độ trễ của lượt chuyển đổi từ 10 đến 11 ngày. 10 ngày được tính, 11 ngày không được tính.
ELEVEN_TO_TWELVE_DAYS Nhóm độ trễ của lượt chuyển đổi từ 11 đến 12 ngày. 11 ngày được tính, 12 ngày không được tính.
TWELVE_TO_THIRTEEN_DAYS Nhóm độ trễ của lượt chuyển đổi từ 12 đến 13 ngày. 12 ngày được tính, 13 ngày không có.
THIRTEEN_TO_FOURTEEN_DAYS Nhóm độ trễ của lượt chuyển đổi từ 13 đến 14 ngày. 13 ngày được tính, 14 ngày không được tính.
FOURTEEN_TO_TWENTY_ONE_DAYS Nhóm độ trễ của lượt chuyển đổi từ 14 đến 21 ngày. 14 ngày được tính, 21 ngày không được tính.
TWENTY_ONE_TO_THIRTY_DAYS Nhóm độ trễ của lượt chuyển đổi từ 21 đến 30 ngày. Có 21 ngày, 30 ngày thì không.
THIRTY_TO_FORTY_FIVE_DAYS Nhóm độ trễ của lượt chuyển đổi từ 30 đến 45 ngày. Có 30 ngày, 45 ngày thì không.
FORTY_FIVE_TO_SIXTY_DAYS Nhóm độ trễ của lượt chuyển đổi từ 45 đến 60 ngày. Có 45 ngày, 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. Có 60 ngày, 90 ngày thì không.

ConversionOrAdjustmentLagBucket

Enum biểu thị số ngày giữa lượt hiển thị và lượt chuyển đổi, hoặc từ lượt hiển thị đến lúc có mức điều chỉnh cho lượt chuyển đổi.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho 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.
CONVERSION_ONE_TO_TWO_DAYS Nhóm độ trễ của lượt chuyển đổi từ 1 đến 2 ngày. Bao gồm 1 ngày, 2 ngày không được tính.
CONVERSION_TWO_TO_THREE_DAYS Nhóm độ trễ của lượt chuyển đổi từ 2 đến 3 ngày. Bao gồm 2 ngày, không bao gồm 3 ngày.
CONVERSION_THREE_TO_FOUR_DAYS Nhóm độ trễ của lượt chuyển đổi từ 3 đến 4 ngày. Bao gồm 3 ngày, không có 4 ngày.
CONVERSION_FOUR_TO_FIVE_DAYS Nhóm độ trễ của lượt chuyển đổi từ 4 đến 5 ngày. Có 4 ngày, không có 5 ngày.
CONVERSION_FIVE_TO_SIX_DAYS Nhóm độ trễ của lượt chuyển đổi từ 5 đến 6 ngày. 5 ngày được tính, 6 ngày không phải.
CONVERSION_SIX_TO_SEVEN_DAYS Nhóm độ trễ của lượt chuyển đổi từ 6 đến 7 ngày. Có 6 ngày, không có 7 ngày.
CONVERSION_SEVEN_TO_EIGHT_DAYS Nhóm độ trễ của lượt chuyển đổi từ 7 đến 8 ngày. Có 7 ngày, không có 8 ngày.
CONVERSION_EIGHT_TO_NINE_DAYS Nhóm độ trễ của lượt chuyển đổi từ 8 đến 9 ngày. Có 8 ngày, không có 9 ngày.
CONVERSION_NINE_TO_TEN_DAYS Nhóm độ trễ của lượt chuyển đổi từ 9 đến 10 ngày. 9 ngày được tính, 10 ngày không được tính.
CONVERSION_TEN_TO_ELEVEN_DAYS Nhóm độ trễ của lượt chuyển đổi từ 10 đến 11 ngày. 10 ngày được tính, 11 ngày không được tính.
CONVERSION_ELEVEN_TO_TWELVE_DAYS Nhóm độ trễ của lượt chuyển đổi từ 11 đến 12 ngày. 11 ngày được tính, 12 ngày không được tính.
CONVERSION_TWELVE_TO_THIRTEEN_DAYS Nhóm độ trễ của lượt chuyển đổi từ 12 đến 13 ngày. 12 ngày được tính, 13 ngày không có.
CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS Nhóm độ trễ của lượt chuyển đổi từ 13 đến 14 ngày. 13 ngày được tính, 14 ngày không được tính.
CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS Nhóm độ trễ của lượt chuyển đổi từ 14 đến 21 ngày. 14 ngày được tính, 21 ngày không được tính.
CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS Nhóm độ trễ của lượt chuyển đổi từ 21 đến 30 ngày. Có 21 ngày, 30 ngày thì không.
CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS Nhóm độ trễ của lượt chuyển đổi từ 30 đến 45 ngày. Có 30 ngày, 45 ngày thì không.
CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS Nhóm độ trễ của lượt chuyển đổi từ 45 đến 60 ngày. Có 45 ngày, 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. Có 60 ngày, 90 ngày thì không.
ADJUSTMENT_LESS_THAN_ONE_DAY Nhóm độ trễ của tính năng đ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.
ADJUSTMENT_ONE_TO_TWO_DAYS Nhóm độ trễ của tính năng điều chỉnh lượt chuyển đổi từ 1 đến 2 ngày. Bao gồm 1 ngày, 2 ngày không được tính.
ADJUSTMENT_TWO_TO_THREE_DAYS Nhóm độ trễ của tính năng điều chỉnh lượt chuyển đổi từ 2 đến 3 ngày. Bao gồm 2 ngày, không bao gồm 3 ngày.
ADJUSTMENT_THREE_TO_FOUR_DAYS Nhóm độ trễ của tính năng điều chỉnh lượt chuyển đổi từ 3 đến 4 ngày. Bao gồm 3 ngày, không có 4 ngày.
ADJUSTMENT_FOUR_TO_FIVE_DAYS Nhóm độ trễ của tính năng điều chỉnh lượt chuyển đổi từ 4 đến 5 ngày. Có 4 ngày, không có 5 ngày.
ADJUSTMENT_FIVE_TO_SIX_DAYS Nhóm độ trễ của tính năng điều chỉnh lượt chuyển đổi từ 5 đến 6 ngày. 5 ngày được tính, 6 ngày không phải.
ADJUSTMENT_SIX_TO_SEVEN_DAYS Nhóm độ trễ của tính năng điều chỉnh lượt chuyển đổi từ 6 đến 7 ngày. Có 6 ngày, không có 7 ngày.
ADJUSTMENT_SEVEN_TO_EIGHT_DAYS Nhóm độ trễ của tính năng điều chỉnh lượt chuyển đổi từ 7 đến 8 ngày. Có 7 ngày, không có 8 ngày.
ADJUSTMENT_EIGHT_TO_NINE_DAYS Nhóm độ trễ của tính năng điều chỉnh lượt chuyển đổi từ 8 đến 9 ngày. Có 8 ngày, không có 9 ngày.
ADJUSTMENT_NINE_TO_TEN_DAYS Nhóm độ trễ của tính năng điều chỉnh lượt chuyển đổi từ 9 đến 10 ngày. 9 ngày được tính, 10 ngày không được tính.
ADJUSTMENT_TEN_TO_ELEVEN_DAYS Nhóm độ trễ của tính năng điều chỉnh lượt chuyển đổi từ 10 đến 11 ngày. 10 ngày được tính, 11 ngày không được tính.
ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS Nhóm độ trễ của tính năng điều chỉnh lượt chuyển đổi từ 11 đến 12 ngày. 11 ngày được tính, 12 ngày không được tính.
ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS Nhóm độ trễ của tính năng điều chỉnh lượt chuyển đổi từ 12 đến 13 ngày. 12 ngày được tính, 13 ngày không có.
ADJUSTMENT_THIRTEEN_TO_FOURTEEN_DAYS Nhóm độ trễ của tính năng điều chỉnh lượt chuyển đổi từ 13 đến 14 ngày. 13 ngày được tính, 14 ngày không được tính.
ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS Nhóm độ trễ của tính năng điều chỉnh lượt chuyển đổi từ 14 đến 21 ngày. 14 ngày được tính, 21 ngày không được tính.
ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS Nhóm độ trễ của tính năng điều chỉnh lượt chuyển đổi từ 21 đến 30 ngày. Có 21 ngày, 30 ngày thì không.
ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS Nhóm độ trễ của tính năng điều chỉnh lượt chuyển đổi từ 30 đến 45 ngày. Có 30 ngày, 45 ngày thì không.
ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS Nhóm độ trễ của tính năng điều chỉnh lượt chuyển đổi từ 45 đến 60 ngày. Có 45 ngày, 60 ngày thì không.
ADJUSTMENT_SIXTY_TO_NINETY_DAYS Nhóm độ trễ của tính năng điều chỉnh lượt chuyển đổi từ 60 đến 90 ngày. Có 60 ngày, 90 ngày thì không.
ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS Nhóm độ trễ của tính năng điều chỉnh lượt chuyển đổi từ 90 đến 145 ngày. 90 ngày thì không có, 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 nhóm độ trễ của lượt chuyển đổi xuất hiện trong Google Ads.
ADJUSTMENT_UNKNOWN Nhóm độ trễ của tính năng điều chỉnh lượt chuyển đổi KHÔNG XÁC ĐỊNH. Đây là các ngày trước khi nhóm độ trễ của mức điều chỉnh của lượt chuyển đổi có 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 Đại diện cho 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; Lượt chuyển đổi xuất hiện 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; 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; 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 cài đặt) trên trang web của nhà quảng cáo sau khi nhấp vào quảng cáo. Lượt chuyển đổi này xuất hiện 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 nhà quảng cáo sau khi nhấp vào quảng cáo của Google; Lượt chuyển đổi xuất hiện 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 ứ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 trên 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 ứng dụng iOS. Lượt chuyển đổi đượ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; Lượt chuyển đổi được hiển thị trong giao diện người dùng Google Ads là "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; 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; lượt chuyển đổi này được 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; 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; 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; Lượt chuyển đổi xuất hiện 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; 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; Lượt chuyển đổi xuất hiện 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 lượt mua hàng tại cửa hàng thực tế từ mạng thanh toán; Xuất hiện 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 Lượt chuyển đổi trên Google Play không dùng mã; Hiển thị trong giao diện người dùng Google Ads dưới dạng "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 của 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 do bên thứ nhất hoặc bên thứ ba của người bán tải lên. 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 do bên thứ nhất hoặc bên thứ ba tải lên của người bán và/hoặc từ các giao dịch mua hàng tại cửa hàng thực tế bằng thẻ của các mạng thanh toán. 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 giúp 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. 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 bắt nguồ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 Giá trị không xác định trong phiên bản này.
UNAVAILABLE Không có thông tin về loại giá.
PUBLIC_RATE Giá dành cho mọi người.
QUALIFIED_RATE Mức giá của 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ư việc cung cấp mức giá công khai. Nội dung trong giao diện người dùng sẽ gạch ngang mức giá công khai và cho biết rằng người dùng có thể chiết khấu. Để biết thêm thông tin về Mức giá đủ tiêu chuẩn, hãy truy cập vào https://developers.google.com/hotels/hotel-ads/dev-guide/qualified-rates
PRIVATE_RATE Mức giá dành cho 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ả các nhóm giá khách sạn có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Giá trị không xác định trong phiên bản này.
LOWEST_UNIQUE Giá thấp nhất duy nhất. Đối tác có mức giá thấp nhất và không có đối tác nào khác nằm trong khoảng chênh lệch nhỏ so với mức giá đó.
LOWEST_TIED Trong phạm vi giá thấp nhất. Đối tác chỉ nằm trong khoảng chênh lệch nhỏ giữa giá thấp nhất.
NOT_LOWEST Không phải giá thấp nhất. Đối tác không nằm trong một khoảng chênh lệch nhỏ giữa giá thấp nhất.
ONLY_PARTNER_SHOWN Đối tác là người duy nhất xuất hiện.

Từ khoá

Phân đoạn Tiêu chí từ khóa.

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ề. Đại diện cho giá trị không xác định trong phiên bản này.
ADS_ONLY Chỉ quảng cáo mới có trong trang kết quả của công cụ tìm kiếm.
ORGANIC_ONLY Chỉ kết quả không phải trả tiền mới có trong 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ó trong trang kết quả của công cụ tìm kiếm.

SearchTermMatchType

Các kiểu khớp có thể có cho từ khoá 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ề. Đại diện cho giá trị không xác định trong phiên bản này.
BROAD Khớp mở rộng.
EXACT Khớp chính xác.
PHRASE Khớp cụm từ.
NEAR_EXACT Khớp chính xác (biến thể gần đúng).
NEAR_PHRASE Khớp cụm từ (biến thể gần đúng).

Vùng

Liệt kê các vị trí có thể của Quảng cáo.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Giá trị không xác định trong phiên bản này.
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 Tìm kiếm của Google: Khác.
CONTENT Mạng Hiển thị của Google.
SEARCH_PARTNER_TOP Đối tác tìm kiếm: Hàng đầu.
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 về giá trị lượt chuyển đổi.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho 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 áp dụng quy tắc giá trị sau khi bật quy tắc giá trị.
ORIGINAL Dưới đây là những lượt chuyển đổi áp dụng quy tắc giá trị: Số liệu thống kê gốc.
NEW_VS_RETURNING_USER Khi đáp ứng một điều kiện về khách hàng mới hoặc 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 web 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

Enumerates kiểu người dùng SkAdNetwork

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Giá trị không xác định trong phiên bản này.
UNAVAILABLE Giá trị không xuất hiện 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 lần đầu cài đặt ứng dụng.
REINSTALLER Người dùng đã cài đặt ứng dụng này trước đó.

SkAdNetworkAdEventType

Các loại sự kiện quảng cáo SkAdNetwork trong Enumerates

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Giá trị không xác định trong phiên bản này.
UNAVAILABLE Giá trị không xuất hiện 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 đoạn SkAdNetworkSourceApp.

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

string

Mã ứng dụng 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ị.

SkAdNetworkAttributionCredit

Tín dụng phân bổ SkAdNetwork của Enumerates.

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. Không thể trả về giá trị enum đúng trong phiên bản API này hoặc chưa được hỗ trợ.
UNAVAILABLE Giá trị không xuất hiện 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 mô hình phân bổ quảng cáo.
CONTRIBUTED Google đủ điều kiện để phân bổ, nhưng không giành chiến thắng.

AssetInteractionTarget

Phân đoạn AssetinterfaceTarget.

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à nhóm Nhóm quảng cáo. 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 hoặc đơ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 và nhóm giá trị vòng đời

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Giá trị không xác định trong phiên bản này.
NEW Tính năng chuyển đổi người dùng mới đối với nhà quảng cáo.
RETURNING Người dùng chuyển đổi sẽ quay lại nhà quảng cáo. Định nghĩa về lượt 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 Người dùng chuyển đổi mới đối với nhà quảng cáo và có giá trị vòng đời cao.