GoogleAdsRow

שורה שהוחזרה מהשאילתה.

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

object (AccountBudget)

תקציב החשבון בשאילתה.

accountBudgetProposal

object (AccountBudgetProposal)

ההצעה לתקציב החשבון שאליה מפנה השאילתה.

adGroup

object (AdGroup)

קבוצת המודעות שצוינה בשאילתה.

adGroupAd

object (AdGroupAd)

המודעה שצוינה בשאילתה.

adGroupAdAssetCombinationView

object (AdGroupAdAssetCombinationView)

תצוגת השילוב של הנכסים שמצורפים למודעות בקבוצת המודעות בשאילתה.

adGroupAdAssetView

object (AdGroupAdAssetView)

התצוגה המפורטת של הנכס שמצורף למודעה בקבוצת המודעות בשאילתה.

adGroupAdLabel

object (AdGroupAdLabel)

תווית המודעה של קבוצת המודעות שצוינה בשאילתה.

adGroupAsset

object (AdGroupAsset)

הנכס של קבוצת המודעות שהוזכר בשאילתה.

adGroupAssetSet

object (AdGroupAssetSet)

קבוצת הנכסים של קבוצת המודעות שאליה מפנה השאילתה.

adGroupAudienceView

object (AdGroupAudienceView)

תצוגת הקהל של קבוצת המודעות שצוינה בשאילתה.

adGroupBidModifier

object (AdGroupBidModifier)

רכיב ההתאמה של הצעת המחיר שמוזכר בשאילתה.

adGroupCriterion

object (AdGroupCriterion)

הקריטריון שהוזכר בשאילתה.

adGroupCriterionCustomizer

object (AdGroupCriterionCustomizer)

הפרמטר להתאמה אישית של קריטריון של קבוצת מודעות שיש אליו הפניה בשאילתה.

adGroupCriterionLabel

object (AdGroupCriterionLabel)

תווית הקריטריון של קבוצת המודעות שצוינה בשאילתה.

adGroupCriterionSimulation

object (AdGroupCriterionSimulation)

הסימולציה של הקריטריון של קבוצת המודעות שאליה מפנה השאילתה.

adGroupCustomizer

object (AdGroupCustomizer)

הפרמטר להתאמה אישית של קבוצת המודעות שיש אליו הפניה בשאילתה.

adGroupExtensionSetting

object (AdGroupExtensionSetting)

ההגדרה של תוסף קבוצת המודעות שאליה מפנה השאילתה.

adGroupFeed

object (AdGroupFeed)

הפיד של קבוצת המודעות שיש אליו הפניה בשאילתה.

adGroupLabel

object (AdGroupLabel)

תווית קבוצת המודעות שצוינה בשאילתה.

adGroupSimulation

object (AdGroupSimulation)

סימולציית קבוצת המודעות שצוינה בשאילתה.

adParameter

object (AdParameter)

פרמטר המודעה שאליו יש הפניה בשאילתה.

ageRangeView

object (AgeRangeView)

תצוגת טווח הגילאים שאליה מפנה השאילתה.

adScheduleView

object (AdScheduleView)

התצוגה של תזמון הצגת המודעות שאליה מפנה השאילתה.

domainCategory

object (DomainCategory)

קטגוריית הדומיין שצוינה בשאילתה.

asset

object (Asset)

הנכס שאליו מתייחסת השאילתה.

assetFieldTypeView

object (AssetFieldTypeView)

תצוגת סוג השדה של הנכס שאליה מפנה השאילתה.

assetGroupAsset

object (AssetGroupAsset)

הנכס של קבוצת הנכסים שהוזכר בשאילתה.

assetGroupSignal

object (AssetGroupSignal)

האות של קבוצת הנכסים שהוזכר בשאילתה.

assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

מסנן קבוצות של כרטיסי מוצר בנכסים דיגיטליים שצוין בשאילתה.

assetGroupProductGroupView

object (AssetGroupProductGroupView)

התצוגה המפורטת של קבוצת הנכסים שאליה מפנה השאילתה.

assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

תצוגת השילוב העליון של קבוצת הנכסים שאליה מפנה השאילתה.

assetGroup

object (AssetGroup)

קבוצת הנכסים שאליה מפנה השאילתה.

assetSetAsset

object (AssetSetAsset)

הנכס של קבוצת הנכסים שהוזכר בשאילתה.

assetSet

object (AssetSet)

קבוצת הנכסים שצוינה בשאילתה.

assetSetTypeView

object (AssetSetTypeView)

תצוגת סוג קבוצת הנכסים שצוינה בשאילתה.

batchJob

object (BatchJob)

המשימה באצווה שמוזכרת בשאילתה.

biddingDataExclusion

object (BiddingDataExclusion)

החרגת נתוני הבידינג שאליה מפנה השאילתה.

biddingSeasonalityAdjustment

object (BiddingSeasonalityAdjustment)

ההתאמה העונתית של הבידינג שאליה מתבצעת הפניה בשאילתה.

biddingStrategy

object (BiddingStrategy)

שיטת הבידינג שצוינה בשאילתה.

biddingStrategySimulation

object (BiddingStrategySimulation)

סימולציית שיטת הבידינג שצוינה בשאילתה.

billingSetup

object (BillingSetup)

הגדרת החיוב שאליה מפנה השאילתה.

callView

object (CallView)

תצוגת השיחה שאליה מפנה השאילתה.

campaignBudget

object (CampaignBudget)

תקציב הקמפיין שמוזכר בשאילתה.

campaign

object (Campaign)

הקמפיין שאליו מתייחסת השאילתה.

campaignAsset

object (CampaignAsset)

נכס הקמפיין שאליו מתייחסת השאילתה.

campaignAssetSet

object (CampaignAssetSet)

קבוצת הנכסים בקמפיין שאליה מפנה השאילתה.

campaignAudienceView

object (CampaignAudienceView)

תצוגת הקהל של הקמפיין שצוינה בשאילתה.

campaignBidModifier

object (CampaignBidModifier)

רכיב ההתאמה של הצעת המחיר בקמפיין שאליו הפנייה מתייחסת.

campaignConversionGoal

object (CampaignConversionGoal)

CampaignConversionGoal שמצוין בשאילתה.

campaignCriterion

object (CampaignCriterion)

הקריטריון של הקמפיין שאליו מפנה השאילתה.

campaignCustomizer

object (CampaignCustomizer)

הפרמטר להתאמה אישית של הקמפיין שיש אליו הפניה בשאילתה.

campaignDraft

object (CampaignDraft)

טיוטת הקמפיין שאליה מפנה השאילתה.

campaignExtensionSetting

object (CampaignExtensionSetting)

ההגדרה של תוסף הקמפיין שצוינה בשאילתה.

campaignFeed

object (CampaignFeed)

פיד הקמפיין שאליו מפנה השאילתה.

campaignGroup

object (CampaignGroup)

קבוצת הקמפיינים שאליה מפנה שאילתת ה-AWQL.

campaignLabel

object (CampaignLabel)

תווית הקמפיין שאליה מפנה השאילתה.

campaignLifecycleGoal

object (CampaignLifecycleGoal)

היעד במחזור החיים של הקמפיין שמוזכר בשאילתה.

campaignSearchTermInsight

object (CampaignSearchTermInsight)

התובנה לגבי מונח החיפוש בקמפיין שצוינה בשאילתה.

campaignSharedSet

object (CampaignSharedSet)

קבוצה משותפת בקמפיין שצוינה בשאילתת AWQL.

campaignSimulation

object (CampaignSimulation)

סימולציית הקמפיין שאליה מפנה השאילתה.

carrierConstant

object (CarrierConstant)

הקבוע של הספק שאליו מפנה השאילתה.

changeEvent

object (ChangeEvent)

ה-ChangeEvent שמוזכר בשאילתה.

changeStatus

object (ChangeStatus)

השינוי (ChangeStatus) שאליו מפנה השאילתה.

combinedAudience

object (CombinedAudience)

הקבוצה המשולבת (CombinedAudience) שאליה יש הפניה בשאילתה.

audience

object (Audience)

הקהל שאליו מתייחסת השאילתה.

conversionAction

object (ConversionAction)

פעולת ההמרה שצוינה בשאילתה.

conversionCustomVariable

object (ConversionCustomVariable)

משתנה ההמרה המותאם אישית שאליו מתייחס השאילתה.

conversionGoalCampaignConfig

object (ConversionGoalCampaignConfig)

ערך ConversionDestinationCampaignConfig שיש אליו הפניה בשאילתה.

conversionValueRule

object (ConversionValueRule)

הכלל לקביעת ערך המרה שיש אליו הפניה בשאילתה.

conversionValueRuleSet

object (ConversionValueRuleSet)

קבוצת הכללים לקביעת ערך המרה שאליה מפנה השאילתה.

clickView

object (ClickView)

ה-ClickView שצוין בשאילתה.

currencyConstant

object (CurrencyConstant)

קבוע המטבע שאליו מפנה השאילתה.

customAudience

object (CustomAudience)

הקהל בהתאמה אישית שמוזכר בשאילתה.

customConversionGoal

object (CustomConversionGoal)

יעד ההמרה בהתאמה אישית שאליו הפנייה מפנה.

customInterest

object (CustomInterest)

ה-CustomInterest שצוין בשאילתה.

customer

object (Customer)

הלקוח שאליו מפנה השאילתה.

customerAsset

object (CustomerAsset)

נכס הלקוח שאליו מתייחסת השאילתה.

customerAssetSet

object (CustomerAssetSet)

קבוצת הנכסים של הלקוח שאליה מפנה השאילתה.

accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

שיטת הבידינג הנגישה שצוינה בשאילתה.

customerCustomizer

object (CustomerCustomizer)

הפרמטר להתאמה אישית של הלקוח שיש אליו הפניה בשאילתה.

customerClient

object (CustomerClient)

לקוח הלקוח שאליו מפנה השאילתה.

customerConversionGoal

object (CustomerConversionGoal)

יעד ההמרה של הלקוח שהוזכר בשאילתה.

customerExtensionSetting

object (CustomerExtensionSetting)

ההגדרה של תוסף הלקוח שאליה מפנה השאילתה.

customerFeed

object (CustomerFeed)

פיד הלקוחות שמוזכר בשאילתה.

customerLabel

object (CustomerLabel)

תווית הלקוח שצוינה בשאילתה.

customerLifecycleGoal

object (CustomerLifecycleGoal)

היעד במחזור החיים של הלקוח שאליו מתייחסת השאילתה.

customerNegativeCriterion

object (CustomerNegativeCriterion)

הקריטריון השלילי של הלקוח שאליו מתייחסת השאילתה.

customerSearchTermInsight

object (CustomerSearchTermInsight)

התובנה לגבי מונח החיפוש של הלקוח שצוינה בשאילתה.

customerUserAccess

object (CustomerUserAccess)

השדה CustomerUserAccess שאליו מפנה השאילתה.

customerUserAccessInvitation

object (CustomerUserAccessInvitation)

ה-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)

קבוצת הפריטים בפיד שאליה מפנה השאילתה.

feedItemTarget

object (FeedItemTarget)

יעד הפריט בפיד שמוזכר בשאילתה.

feedMapping

object (FeedMapping)

מיפוי הפיד שצוין בשאילתה.

feedPlaceholderView

object (FeedPlaceholderView)

תצוגת ה-Placeholder של הפיד שצוינה בשאילתה.

genderView

object (GenderView)

תצוגת המגדר שצוינה בשאילתה.

geoTargetConstant

object (GeoTargetConstant)

קבוע הטירגוט הגיאוגרפי שמוזכר בשאילתה.

geographicView

object (GeographicView)

התצוגה הגיאוגרפית שאליה מפנה השאילתה.

groupPlacementView

object (GroupPlacementView)

התצוגה המפורטת של מיקום הקבוצה שאליה מפנה השאילתה.

hotelGroupView

object (HotelGroupView)

תצוגת קבוצת המלונות שצוינה בשאילתה.

hotelPerformanceView

object (HotelPerformanceView)

תצוגת ביצועי המלון שצוינה בשאילתה.

hotelReconciliation

object (HotelReconciliation)

התאמת המלון שאליה מפנה השאילתה.

incomeRangeView

object (IncomeRangeView)

תצוגת טווח ההכנסה שאליה מפנה השאילתה.

keywordView

object (KeywordView)

תצוגת מילות המפתח שצוינה בשאילתה.

keywordPlan

object (KeywordPlan)

תוכנית מילות המפתח שצוינה בשאילתה.

keywordPlanCampaign

object (KeywordPlanCampaign)

הקמפיין של תוכנית מילות המפתח שצוין בשאילתה.

keywordPlanCampaignKeyword

object (KeywordPlanCampaignKeyword)

מילת המפתח בקמפיין של תוכנית מילות המפתח שצוינה בשאילתה.

keywordPlanAdGroup

object (KeywordPlanAdGroup)

קבוצת המודעות של תוכנית מילות המפתח שאליה מפנה השאילתה.

keywordPlanAdGroupKeyword

object (KeywordPlanAdGroupKeyword)

קבוצת המודעות של תוכנית מילות המפתח שאליה מפנה השאילתה.

keywordThemeConstant

object (KeywordThemeConstant)

הקבוע של נושא מילות המפתח שאליו יש הפניה בשאילתה.

label

object (Label)

התווית שאליה מפנה השאילתה.

landingPageView

object (LandingPageView)

תצוגת דף הנחיתה שאליה מפנה השאילתה.

languageConstant

object (LanguageConstant)

קבוע השפה שיש אליו הפניה בשאילתה.

locationView

object (LocationView)

תצוגת המיקום שאליה מפנה השאילתה.

managedPlacementView

object (ManagedPlacementView)

התצוגה המפורטת של מיקומי המודעות המנוהלים שאליה מפנה השאילתה.

mediaFile

object (MediaFile)

קובץ המדיה שמוזכר בשאילתה.

localServicesEmployee

object (LocalServicesEmployee)

העובד ב-'Google בעלי מקצוע' שהוזכר בשאילתה.

localServicesVerificationArtifact

object (LocalServicesVerificationArtifact)

פריט המידע שנוצר בתהליך האימות (Artifact) של אימות 'Google בעלי מקצוע', שמוזכר בשאילתה.

mobileAppCategoryConstant

object (MobileAppCategoryConstant)

הקטגוריה של האפליקציה לנייד שאליה מפנה השאילתה מתבצעת.

mobileDeviceConstant

object (MobileDeviceConstant)

הקבוע של המכשיר הנייד שאליו מתייחסת השאילתה.

offlineConversionUploadClientSummary

object (OfflineConversionUploadClientSummary)

סיכום של העלאות של המרות אופליין ברמת הלקוח.

offlineUserDataJob

object (OfflineUserDataJob)

המשימה של נתוני המשתמשים אופליין שאליה מפנה השאילתה.

operatingSystemVersionConstant

object (OperatingSystemVersionConstant)

גרסת מערכת ההפעלה קבועה בשאילתה.

paidOrganicSearchTermView

object (PaidOrganicSearchTermView)

תצוגת מונח החיפוש האורגני בתשלום שצוינה בשאילתה.

qualifyingQuestion

object (QualifyingQuestion)

שאלת ההתאמה שצוינה בשאילתה.

parentalStatusView

object (ParentalStatusView)

תצוגת סטטוס ההורה שצוינה בשאילתה.

perStoreView

object (PerStoreView)

התצוגה 'לכל חנות' שצוינה בשאילתה.

productCategoryConstant

object (ProductCategoryConstant)

קטגוריית המוצר שצוינה בשאילתה.

productGroupView

object (ProductGroupView)

תצוגת קבוצת המוצרים שצוינה בשאילתה.

recommendation

object (Recommendation)

ההמלצה שהוזכרה בשאילתה.

recommendationSubscription

object (RecommendationSubscription)

המינוי להמלצות שצוין בשאילתה.

searchTermView

object (SearchTermView)

תצוגת מונחי החיפוש שהוזכרה בשאילתה.

sharedCriterion

object (SharedCriterion)

הקבוצה המשותפת שאליה מפנה השאילתה.

sharedSet

object (SharedSet)

הקבוצה המשותפת שאליה מפנה השאילתה.

smartCampaignSetting

object (SmartCampaignSetting)

ההגדרה של הקמפיין החכם שצוינה בשאילתה.

shoppingPerformanceView

object (ShoppingPerformanceView)

תצוגת הביצועים של שופינג שצוינה בשאילתה.

smartCampaignSearchTermView

object (SmartCampaignSearchTermView)

תצוגת מונחי החיפוש בקמפיין החכם שצוינה בשאילתה.

topicView

object (TopicView)

תצוגת הנושא שצוינה בשאילתה.

travelActivityGroupView

object (TravelActivityGroupView)

התצוגה של קבוצת פעילויות הנסיעות שאליה מפנה השאילתה.

travelActivityPerformanceView

object (TravelActivityPerformanceView)

תצוגת הביצועים של הפעילות בענף התיירות והאירוח שהוזכרה בשאילתה.

experiment

object (Experiment)

הניסוי שהוזכר בשאילתה.

experimentArm

object (ExperimentArm)

זרוע הניסוי שהוזכרה בשאילתה.

userInterest

object (UserInterest)

תחום העניין של המשתמש שהוזכר בשאילתה.

lifeEvent

object (LifeEvent)

האירוע המשמעותי בחיים שאליו מתייחסת השאילתה.

userList

object (UserList)

רשימת המשתמשים שאליה בוצעה הפניה בשאילתה.

userLocationView

object (UserLocationView)

תצוגת המיקום של המשתמש שצוינה בשאילתה.

remarketingAction

object (RemarketingAction)

פעולת הרימרקטינג שאליה מפנה השאילתה.

topicConstant

object (TopicConstant)

קבוע הנושא בשאילתה.

video

object (Video)

הסרטון שאליו מתייחסת השאילתה.

webpageView

object (WebpageView)

תצוגת דף האינטרנט שצוינה בשאילתה.

leadFormSubmissionData

object (LeadFormSubmissionData)

שליחת הטופס להשארת פרטים שהמשתמש מפנה אליו בשאילתה.

localServicesLead

object (LocalServicesLead)

הליד של 'Google בעלי מקצוע' שאליו מפנה השאילתה.

localServicesLeadConversation

object (LocalServicesLeadConversation)

השיחה עם הליד ב-'Google בעלי מקצוע' שצוינה בשאילתה.

androidPrivacySharedKeyGoogleAdGroup

object (AndroidPrivacySharedKeyGoogleAdGroup)

קבוצת המודעות ב-Google של מפתח הפרטיות המשותף ב-Android שאליה מפנה השאילתה.

androidPrivacySharedKeyGoogleCampaign

object (AndroidPrivacySharedKeyGoogleCampaign)

הקמפיין של מפתח הפרטיות המשותף ב-Android שאליו מפנה השאילתה.

androidPrivacySharedKeyGoogleNetworkType

object (AndroidPrivacySharedKeyGoogleNetworkType)

סוג הרשת של Google שמתייחס למפתח הפרטי המשותף של Android שמוזכר בשאילתה.

metrics

object (Metrics)

המדדים.

segments

object (Segments)

הפלחים.

AccountBudget

תקציב ברמת החשבון. הדוח כולל מידע על התקציב עצמו, וגם את השינויים האחרונים שאושרו בתקציב ואת השינויים המוצעים שממתינים לאישור. השינויים המוצעים הממתינים לאישור, אם יש כאלה, מופיעים בקטע 'Pendingהצעה'. אפשר למצוא פרטים רלוונטיים על התקציב בשדות עם התחילית 'Approved_', 'Adjustmented_' ו'שדות ללא קידומת'. מאחר שחלק מהפרטים בפועל עשויים להיות שונים מאלה שהמשתמש ביקש במקור (לדוגמה, תקרת הוצאות), ההבדלים האלה מוצמדים זה לזה באמצעות השדות 'proposed_', 'Approved_' ואולי גם באמצעות השדות 'Adjusted_'.

השינוי של המשאב הזה מתבצע באמצעות AccountBudgetהצעה ולא ניתן לשנות אותו באופן ישיר. בכל רגע נתון, יכולה להיות הצעה אחת לכל היותר בהמתנה לכל תקציב. היא נקראת 'בהמתנה להצעה'.

אחרי שהתקציב יאושר, יכול להיות שהוא יהיה כפוף להתאמות, כמו התאמות של זיכויים. ההתאמות יוצרות הבדלים בין השדות 'אושר' ו'מותאם', שהיו זהים אחרת.

ייצוג 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.
}
שדות
resourceName

string

פלט בלבד. שם המשאב של התקציב ברמת החשבון. שמות המשאבים של AccountBudget מופיעים בתבנית:

customers/{customerId}/accountBudgets/{account_budget_id}

status

enum (AccountBudgetStatus)

פלט בלבד. הסטטוס של התקציב הזה ברמת החשבון.

totalAdjustmentsMicros

string (int64 format)

פלט בלבד. הסכום הכולל של ההתאמות.

דוגמה להתאמה היא זיכויים עקב טעות.

amountServedMicros

string (int64 format)

פלט בלבד. הערך של מודעות שהוצגו, במיליוניות השנייה.

נתון זה כולל עלויות הצגת יתר של מודעות, ובמקרה כזה ייתכן שזיכוי יחול באופן אוטומטי על התקציב (ראו totalAdjustmentsMicros).

pendingProposal

object (PendingAccountBudgetProposal)

פלט בלבד. ההצעה הממתינה לשינוי התקציב הזה, אם רלוונטי.

id

string (int64 format)

פלט בלבד. המזהה של התקציב ברמת החשבון.

billingSetup

string

פלט בלבד. שם המשאב של הגדרת החיוב שמשויכת לתקציב ברמת החשבון. שמות המשאבים של BillingSetup הם בפורמט:

customers/{customerId}/billingSetups/{billing_setup_id}

name

string

פלט בלבד. שם התקציב ברמת החשבון.

proposedStartDateTime

string

פלט בלבד. שעת ההתחלה המוצעת של התקציב ברמת החשבון בפורמט yyyy-MM-dd HH:mm:ss. אם הוצעה שעת התחלה מסוג NOW, זוהי שעת הבקשה.

approvedStartDateTime

string

פלט בלבד. שעת ההתחלה שאושרה של התקציב ברמת החשבון בפורמט yyyy-MM-dd HH:mm:ss.

לדוגמה, אם תקציב חדש יאושר אחרי שעת ההתחלה המוצעת, שעת ההתחלה המאושרת היא מועד האישור.

purchaseOrderNumber

string

פלט בלבד. מספר הזמנת רכש הוא ערך שעוזר למשתמשים להתייחס לתקציב הזה בחשבוניות החודשיות שלהם.

notes

string

פלט בלבד. הערות שמשויכות לתקציב.

שדה איחוד proposed_end_time. שעת הסיום המוצעת של התקציב ברמת החשבון. proposed_end_time יכול להיות רק אחת מהאפשרויות הבאות:
proposedEndDateTime

string

פלט בלבד. שעת הסיום המוצעת בפורמט yyyy-MM-dd HH:mm:ss.

proposedEndTimeType

enum (TimeType)

פלט בלבד. שעת הסיום המוצעת כטיפוס מוגדר היטב, לדוגמה, FOREVER.

שדה האיחוד approved_end_time. שעת הסיום שאושרה לתקציב ברמת החשבון.

לדוגמה, אם עדכון שעת הסיום של תקציב וההצעה אושרה לאחר שעת הסיום המוצעת, שעת הסיום המאושרת היא מועד האישור. approved_end_time יכול להיות רק אחת מהאפשרויות הבאות:

approvedEndDateTime

string

פלט בלבד. שעת הסיום שאושרה בפורמט yyyy-MM-dd HH:mm:ss.

approvedEndTimeType

enum (TimeType)

פלט בלבד. שעת הסיום המאושרת לסוג מוגדר היטב, לדוגמה, FOREVER (תמיד).

שדה איחוד proposed_spending_limit. תקרת ההוצאות המוצעת. proposed_spending_limit יכול להיות רק אחת מהאפשרויות הבאות:
proposedSpendingLimitMicros

string (int64 format)

פלט בלבד. תקרת ההוצאה המוצעת במיקרו-שניות. מיליון שווה ליחידה אחת.

proposedSpendingLimitType

enum (SpendingLimitType)

פלט בלבד. מגבלת ההוצאה המוצעת כסוג מוגדר היטב, למשל INFINITE.

שדה איחוד approved_spending_limit. תקרת ההוצאות שאושרה.

לדוגמה, אם הסכום שכבר הוצאתם בחשבון יחרוג מתקרת ההוצאות המוצעת בזמן שההצעה תאושר, תקרת ההוצאה המאושרת תוגדר לסכום שכבר הוצאתם. הערך של approved_spending_limit יכול להיות רק אחת מהאפשרויות הבאות:

approvedSpendingLimitMicros

string (int64 format)

פלט בלבד. תקרת ההוצאות שאושרה ב-Micros. מיליון שווה ליחידה אחת. השדה הזה יאוכלס רק אם תקרת ההוצאה המוצעת היא סופית, ותמיד תהיה גדולה מתקרת ההוצאה המוצעת או שווה לה.

approvedSpendingLimitType

enum (SpendingLimitType)

פלט בלבד. תקרת ההוצאה המאושרת בפורמט מוגדר היטב, לדוגמה, INFINITE. השדה הזה יאוכלס רק אם מגבלת ההוצאה שאושרה היא INFINITE.

שדה האיחוד adjusted_spending_limit. תקרת ההוצאות אחרי החלת ההתאמות. ההתאמות נשמרות ב-total_adjustments_micros.

הערך הזה הוא ההחלטה הסופית לגבי הסכום שמותר להוציא בחשבון. הערך של adjusted_spending_limit יכול להיות רק אחת מהאפשרויות הבאות:

adjustedSpendingLimitMicros

string (int64 format)

פלט בלבד. תקרת ההוצאות המותאמת ב-Micros. מיליון שווה ליחידה אחת.

אם תקרת ההוצאות שאושרה היא סופית, תקרת ההוצאה המותאמת עשויה להשתנות בהתאם לסוגי ההתאמות שהוחלו על התקציב הזה, אם רלוונטי.

הסוגים השונים של התאמות מתוארים כאן: https://support.google.com/google-ads/answer/1704323

לדוגמה, התאמה של חיוב מקטינה את סכום ההוצאה המותרת בחשבון.

adjustedSpendingLimitType

enum (SpendingLimitType)

פלט בלבד. תקרת ההוצאה המותאמת לפי סוג מוגדר היטב, לדוגמה, INFINITE. השדה הזה מאוכלס רק אם מגבלת ההוצאה המשוקללת היא INFINITE, וזה תמיד נכון אם מגבלת ההוצאה שאושרה היא INFINITE.

AccountBudgetStatus

הסטטוסים האפשריים של AccountBudget.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
PENDING תקציב החשבון ממתין לאישור.
APPROVED תקציב החשבון אושר.
CANCELLED תקציב החשבון בוטל על ידי המשתמש.

PendingAccountBudgetProposal

הצעה בהמתנה המשויכת לתקציב ברמת החשבון, אם רלוונטי.

ייצוג ב-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.
}
שדות
proposalType

enum (AccountBudgetProposalType)

פלט בלבד. סוג ההצעה הזו, לדוגמה, END כדי לסיים את התקציב שמשויך להצעה הזו.

accountBudgetProposal

string

פלט בלבד. שם המשאב של ההצעה. שמות המשאבים מסוג AccountBudgetProposal הם בפורמט:

customers/{customerId}/accountBudgetProposals/{account_budget_proposal_id}

name

string

פלט בלבד. השם שרוצים להקצות לתקציב ברמת החשבון.

startDateTime

string

פלט בלבד. שעת ההתחלה בפורמט yyyy-MM-dd HH:mm:ss.

purchaseOrderNumber

string

פלט בלבד. מספר הזמנת רכש הוא ערך שעוזר למשתמשים להתייחס לתקציב הזה בחשבוניות החודשיות שלהם.

notes

string

פלט בלבד. הערות שמשויכות לתקציב הזה.

creationDateTime

string

פלט בלבד. השעה שבה נוצרה הצעת התקציב ברמת החשבון. הפורמט הוא yyyy-MM-dd HH:mm:ss.

שדה איחוד end_time. שעת הסיום של התקציב ברמת החשבון. end_time יכול להיות רק אחת מהאפשרויות הבאות:
endDateTime

string

פלט בלבד. שעת הסיום בפורמט yyyy-MM-dd HH:mm:ss.

endTimeType

enum (TimeType)

פלט בלבד. שעת הסיום בפורמט מוגדר היטב, לדוגמה, FOREVER.

שדה איחוד spending_limit. תקרת ההוצאות. הערך של spending_limit יכול להיות רק אחת מהאפשרויות הבאות:
spendingLimitMicros

string (int64 format)

פלט בלבד. תקרת ההוצאה במיליוניות השנייה. מיליון שווה ליחידה אחת.

spendingLimitType

enum (SpendingLimitType)

פלט בלבד. תקרת ההוצאה מוגדרת לסוג מוגדר היטב, לדוגמה, INFINITE.

AdGroupAdAssetCombinationView

תצוגה של השימוש בשילוב של נכסי המודעות בקבוצת המודעות. בשלב הזה אנחנו תומכים ב-AdGroupAdAssetCombinationView רק במודעות רספונסיביות לרשת החיפוש, ואנחנו מתכננים להוסיף תמיכה בסוגי מודעות נוספים בעתיד.

ייצוג JSON
{
  "resourceName": string,
  "servedAssets": [
    {
      object (AssetUsage)
    }
  ],
  "enabled": boolean
}
שדות
resourceName

string

פלט בלבד. שם המשאב של תצוגת השילוב של נכסי המודעות בקבוצת המודעות. מזהה השילוב הוא באורך של 128 ביט, כאשר 64 הביטים העליונים מאוחסנים ב-Asset_combination_id_high ו-64 הביטים התחתונים מאוחסנים ב-Asset_combination_id_low. שמות המשאבים בתצוגה AdGroupAd Asset Combination הם בפורמט: customers/{customerId}/adGroupAdAssetCombinationViews/{AdGroupAd.ad_group_id}~{AdGroupAd.ad.ad_id}~{AssetCombination.asset_combination_id_low}~{AssetCombination.asset_combination_id_high}

servedAssets[]

object (AssetUsage)

פלט בלבד. נכסים שמוצגים.

enabled

boolean

פלט בלבד. הסטטוס בין שילוב הנכסים לבין הגרסה האחרונה של המודעה. אם הערך הוא True, שילוב הנכסים מקושר לגרסה האחרונה של המודעה. אם הערך הוא false, המשמעות היא שהקישור היה קיים בעבר אבל הוסר ולא נמצא יותר בגרסה האחרונה של המודעה.

AssetUsage

מכיל את נתוני השימוש בנכס.

ייצוג ב-JSON
{
  "asset": string,
  "servedAssetFieldType": enum (ServedAssetFieldType)
}
שדות
asset

string

שם המשאב של הנכס.

servedAssetFieldType

enum (ServedAssetFieldType)

סוג השדה המוצג של הנכס.

AdGroupAdAssetView

קישור בין קבוצת מודעות לבין נכס. בשלב הזה, אנחנו תומכים רק ב- AdGroupAdAssetView למודעות לקידום אפליקציות ובמודעות רספונסיביות לרשת החיפוש.

ייצוג JSON
{
  "resourceName": string,
  "fieldType": enum (AssetFieldType),
  "policySummary": {
    object (AdGroupAdAssetPolicySummary)
  },
  "performanceLabel": enum (AssetPerformanceLabel),
  "pinnedField": enum (ServedAssetFieldType),
  "source": enum (AssetSource),
  "adGroupAd": string,
  "asset": string,
  "enabled": boolean
}
שדות
resourceName

string

פלט בלבד. שם המשאב בתצוגת הנכסים של המודעה בקבוצת המודעות. שמות המשאבים בתצוגת נכסי המודעות של קבוצת המודעות הם בפורמט הבא (לפני גרסה 4):

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

שמות המשאבים של תצוגות נכסים למודעות ברמת קבוצת המודעות מופיעים בפורמט הבא (החל מ-V4):

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

fieldType

enum (AssetFieldType)

פלט בלבד. התפקיד שהנכס מקבל במודעה.

policySummary

object (AdGroupAdAssetPolicySummary)

פלט בלבד. פרטי המדיניות של נכס שמצורף למודעה בקבוצת המודעות.

performanceLabel

enum (AssetPerformanceLabel)

פלט בלבד. הביצועים של קישור נכס.

pinnedField

enum (ServedAssetFieldType)

פלט בלבד. שדה מוצמד.

source

enum (AssetSource)

פלט בלבד. המקור של נכס המודעות בקבוצת המודעות.

adGroupAd

string

פלט בלבד. המודעה בקבוצת המודעות שאליה הנכס מקושר.

asset

string

פלט בלבד. הנכס שמקושר למודעה בקבוצת המודעות.

enabled

boolean

פלט בלבד. הסטטוס בין הנכס לגרסה האחרונה של המודעה. אם הערך הוא true, הנכס מקושר לגרסה העדכנית ביותר של המודעה. אם הערך הוא False, המשמעות היא שהקישור היה קיים בעבר, אבל הוסר ולא קיים יותר בגרסה האחרונה של המודעה.

AdGroupAdAssetPolicySummary

מכיל מידע על המדיניות של נכס מודעה בקבוצת מודעות.

ייצוג JSON
{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}
שדות
policyTopicEntries[]

object (PolicyTopicEntry)

פלט בלבד. רשימת הממצאים של המדיניות בנושא נכס שמצורף למודעה בקבוצת המודעות.

reviewStatus

enum (PolicyReviewStatus)

פלט בלבד. המיקום של הנכס הזה שמצורף למודעה בקבוצת המודעות בתהליך הבדיקה.

approvalStatus

enum (PolicyApprovalStatus)

פלט בלבד. סטטוס האישור הכולל של נכס המודעה בקבוצת המודעות הזו, שמחושב על סמך הסטטוס של הרשומות הנפרדות בנושאי המדיניות.

AdGroupAudienceView

תצוגת קהל של קבוצת מודעות. כולל נתוני ביצועים מתחומי עניין ורשימות רימרקטינג למודעות ברשת המדיה וב-YouTube Network, ורשימות רימרקטינג למודעות לרשת החיפוש (RLSA), שמצטברים ברמת הקהל.

ייצוג JSON
{
  "resourceName": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב בתצוגת הקהל של קבוצת המודעות. שמות המשאבים לתצוגת קהל של קבוצות מודעות מופיעים בפורמט:

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

AdGroupCriterionSimulation

סימולציה של קריטריון של קבוצת מודעות. בהמשך מפורטים השילובים הנתמכים של סוג ערוץ הפרסום, סוג הקריטריון, סוג הסימולציה ושיטת השינוי של הסימולציה. פעולות סימולציה של Hotel AdGroupCriterion מתחילות ב-V5.

  1. DISPLAY - KEYWORD - CPC_BID - UNIFORM
  2. חיפוש – מילת מפתח – CPC_BID – UNIFORM
  3. שופינג – LISTING_GROUP – CPC_BID – UNIFORM
  4. בית מלון - LISTING_GROUP - CPC_BID - UNIFORM
  5. HOTEL - LISTING_GROUP - PERCENT_CPC_BID - UNIFORM
ייצוג 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.
}
שדות
resourceName

string

פלט בלבד. שם המשאב של הדמיית הקריטריון של קבוצת המודעות. שמות המשאבים של סימולציות של קריטריונים של קבוצות מודעות הם בפורמט:

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

type

enum (SimulationType)

פלט בלבד. השדה שהסימולציה משנה.

modificationMethod

enum (SimulationModificationMethod)

פלט בלבד. איך הסימולציה משנה את השדה.

adGroupId

string (int64 format)

פלט בלבד. מזהה קבוצת המודעות של הסימולציה.

criterionId

string (int64 format)

פלט בלבד. מזהה הקריטריון של הסימולציה.

startDate

string

פלט בלבד. היום הראשון שבו מבוססת ההדמיה, בפורמט YYYY-MM-DD.

endDate

string

פלט בלבד. היום האחרון שבו הסימולציה מבוססת, בפורמט YYYY-MM-DD.

שדה איחוד point_list. רשימה של נקודות סימולציה. point_list יכול להיות רק אחת מהאפשרויות הבאות:
cpcBidPointList

object (CpcBidSimulationPointList)

פלט בלבד. נקודות הסימולציה אם סוג הסימולציה הוא CPC_BID.

percentCpcBidPointList

object (PercentCpcBidSimulationPointList)

פלט בלבד. נקודות סימולציה אם סוג הסימולציה הוא PERCENT_CPC_BID.

SimulationType

Enum שמתאר את השדה שהסימולציה משנה.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
CPC_BID הסימולציה היא של הצעת מחיר לקליק.
CPV_BID הסימולציה היא להצעת מחיר לפי עלות לצפייה (CPV).
TARGET_CPA הסימולציה היא עבור יעד עלות להמרה.
BID_MODIFIER הסימולציה היא של התאמת הצעת מחיר.
TARGET_ROAS הסימולציה מיועדת ליעד החזר על הוצאות פרסום.
PERCENT_CPC_BID הסימולציה היא של הצעת מחיר לפי אחוז מסוים של עלות לקליק.
TARGET_IMPRESSION_SHARE הסימולציה מיועדת ליעד של נתח חשיפות.
BUDGET הסימולציה היא לתקציב.

SimulationModificationMethod

Enum שמתאר את השיטה שבה סימולציה משנה שדה.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
UNIFORM הערכים בסימולציה הוחלו באופן אחיד על כל הצאצאים של משאב נתון. לא בוצעו שינויים בערכים שהוגדרו מראש במשאבים הצאצאים.
DEFAULT הערכים בסימולציה הוחלו על המשאב הנתון. השינויים לגבי משאבים צאצאים נלקחו בחשבון, ואומדני התנועה לא כוללים את המשאבים האלה.
SCALING כל הערכים בסימולציה שונו באותו גורם. לדוגמה, בקמפיין הדמיה עם יעד עלות להמרה, יעד הקמפיין וכל יעדי הקבוצות של המודעות שונו לפי גורם X.

CpcBidSimulationPointList

מאגר של נקודות סימולציה עבור סימולציות מסוג CPC_BID.

ייצוג JSON
{
  "points": [
    {
      object (CpcBidSimulationPoint)
    }
  ]
}
שדות
points[]

object (CpcBidSimulationPoint)

מדדים צפויים לסדרה של סכומי הצעות מחיר לקליק.

CpcBidSimulationPoint

מדדים צפויים עבור סכום ספציפי של הצעת מחיר לקליק.

ייצוג ב-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.
}
שדות
requiredBudgetAmountMicros

string (int64 format)

התקציב היומי הנדרש הצפוי שהמפרסם צריך להגדיר כדי לקבל את התנועה המשוערת, במיקרו-מטבע של המפרסם.

biddableConversions

number

מספר ההמרות הצפוי שאפשר להגיש עבורן הצעות מחיר.

biddableConversionsValue

number

הערך הכולל הצפוי של המרות שניתן להגיש עליהן הצעות מחיר.

clicks

string (int64 format)

מספר הקליקים הצפוי.

costMicros

string (int64 format)

העלות הצפויה ב-micros.

impressions

string (int64 format)

מספר החשיפות הצפוי.

topSlotImpressions

string (int64 format)

מספר החשיפות הצפוי במשבצת העליונה. השדה הזה תומך רק בסוג ערוץ פרסום ברשת החיפוש.

שדה איחוד cpc_simulation_key_value. כשהערך של SimulationModificationMethod הוא UNIFORM או DEFAULT, המערכת מגדירה את cpc_bid_micros. כשהערך של SimulationModificationMethod הוא SCALING, השדה cpc_bid_scaling_modifier מוגדר. הערך של cpc_simulation_key_value יכול להיות רק אחת מהאפשרויות הבאות:
cpcBidMicros

string (int64 format)

הצעת המחיר המשוכפלת לקליק שעל בסיסה מבוססים המדדים הצפויים.

cpcBidScalingModifier

number

מאפיין הסימולציה של ההתאמה לעומס (scaling) שעליו מבוססים המדדים החזויים. ההתאמה הזו מחושבת לפי כל הצעות המחיר לקליק שרלוונטיות לישות שבסימולציה.

PercentCpcBidSimulationPointList

מאגר של נקודות סימולציה עבור סימולציות מסוג PERCENT_CPC_BID.

ייצוג ב-JSON
{
  "points": [
    {
      object (PercentCpcBidSimulationPoint)
    }
  ]
}
שדות
points[]

object (PercentCpcBidSimulationPoint)

מדדים חזויים לסדרת הצעות מחיר של עלות לקליק באחוזים.

PercentCpcBidSimulationPoint

מדדים חזויים לסכום ספציפי של עלות לקליק. השדה הזה תומך רק בסוג ערוץ פרסום של מלונות.

ייצוג JSON
{
  "percentCpcBidMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string
}
שדות
percentCpcBidMicros

string (int64 format)

הסימולציה של העלות לקליק באחוזים שעליה מבוססים המדדים החזויים. עלות לקליק באחוזים, שמתוארת כחלק מהמחיר המפורסם של מוצר או שירות כלשהו. הערך שמאוחסן כאן הוא 1,000,000 * [fraction].

biddableConversions

number

המספר הצפוי של ההמרות שניתן להגיש עליהן הצעות מחיר.

biddableConversionsValue

number

הערך הכולל הצפוי של ההמרות שניתן להגיש עליהן הצעות מחיר במטבע מקומי.

clicks

string (int64 format)

מספר הקליקים הצפוי.

costMicros

string (int64 format)

העלות הצפויה ב-micros.

impressions

string (int64 format)

מספר החשיפות הצפוי.

topSlotImpressions

string (int64 format)

מספר החשיפות הצפוי במשבצת העליונה.

AdGroupSimulation

סימולציה של קבוצת מודעות. השילובים הנתמכים של סוג ערוץ הפרסום, סוג הסימולציה ושיטת שינוי הסימולציה מפורטים למטה, בהתאמה.

  1. SEARCH - CPC_BID - DEFAULT
  2. חיפוש – CPC_BID – UNIFORM
  3. חיפוש - TARGET_CPA – UNIFORM
  4. חיפוש – TARGET_ROAS – UNIFORM
  5. רשת המדיה - CPC_BID - ברירת מחדל
  6. רשת המדיה – CPC_BID – UNIFORM
  7. רשת המדיה – TARGET_CPA – UNIFORM
ייצוג 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.
}
שדות
resourceName

string

פלט בלבד. שם המשאב בסימולציה של קבוצת המודעות. שמות המשאבים של סימולציות של קבוצות מודעות הם בפורמט:

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

type

enum (SimulationType)

פלט בלבד. השדה שהסימולציה משנה.

modificationMethod

enum (SimulationModificationMethod)

פלט בלבד. איך הסימולציה משנה את השדה.

adGroupId

string (int64 format)

פלט בלבד. מזהה קבוצת המודעות של הסימולציה.

startDate

string

פלט בלבד. היום הראשון שבו מבוססת ההדמיה, בפורמט YYYY-MM-DD.

endDate

string

פלט בלבד. היום האחרון שבו הסימולציה מבוססת, בפורמט YYYY-MM-DD

שדה איחוד point_list. רשימה של נקודות סימולציה. point_list יכול להיות רק אחת מהאפשרויות הבאות:
cpcBidPointList

object (CpcBidSimulationPointList)

פלט בלבד. נקודות הסימולציה אם סוג הסימולציה הוא CPC_BID.

cpvBidPointList

object (CpvBidSimulationPointList)

פלט בלבד. נקודות סימולציה אם סוג הסימולציה הוא CPV_BID.

targetCpaPointList

object (TargetCpaSimulationPointList)

פלט בלבד. נקודות סימולציה אם סוג הסימולציה הוא TARGET_CPA.

targetRoasPointList

object (TargetRoasSimulationPointList)

פלט בלבד. נקודות סימולציה אם סוג הסימולציה הוא TARGET_ROAS.

CpvBidSimulationPointList

מאגר של נקודות סימולציה עבור סימולציות מסוג CPV_BID.

ייצוג JSON
{
  "points": [
    {
      object (CpvBidSimulationPoint)
    }
  ]
}
שדות
points[]

object (CpvBidSimulationPoint)

מדדים חזויים לסדרה של סכומי הצעות מחיר לצפייה.

CpvBidSimulationPoint

מדדים חזויים של הצעת מחיר ספציפית לצפייה.

ייצוג JSON
{
  "cpvBidMicros": string,
  "costMicros": string,
  "impressions": string,
  "views": string
}
שדות
cpvBidMicros

string (int64 format)

הסימולציה של הצעת המחיר לצפייה שעליה מבוססים המדדים החזויים.

costMicros

string (int64 format)

העלות הצפויה במיקרו-שניות.

impressions

string (int64 format)

מספר חשיפות צפוי.

views

string (int64 format)

מספר הצפיות הצפוי.

TargetCpaSimulationPointList

מאגר לנקודות הדמיה עבור סימולציות מסוג TARGET_CPA.

ייצוג ב-JSON
{
  "points": [
    {
      object (TargetCpaSimulationPoint)
    }
  ]
}
שדות
points[]

object (TargetCpaSimulationPoint)

מדדים צפויים עבור סדרה של סכומי יעד עלות להמרה.

TargetCpaSimulationPoint

מדדים צפויים עבור סכום ספציפי של יעד עלות להמרה.

ייצוג JSON
{
  "requiredBudgetAmountMicros": string,
  "appInstalls": number,
  "inAppActions": number,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,
  "interactions": string,

  // Union field target_cpa_simulation_key_value can be only one of the
  // following:
  "targetCpaMicros": string,
  "targetCpaScalingModifier": number
  // End of list of possible types for union field
  // target_cpa_simulation_key_value.
}
שדות
requiredBudgetAmountMicros

string (int64 format)

התקציב היומי הצפוי שהמפרסם צריך להגדיר כדי לקבל את נפח התנועה המשוער, במיקרו של המטבע של המפרסם.

appInstalls

number

המספר הצפוי של התקנות האפליקציה.

inAppActions

number

המספר הצפוי של פעולות בתוך האפליקציה.

biddableConversions

number

המספר הצפוי של ההמרות שניתן להגיש עליהן הצעות מחיר.

biddableConversionsValue

number

הערך הכולל הצפוי של המרות שניתן להגיש עליהן הצעות מחיר.

clicks

string (int64 format)

מספר הקליקים הצפוי.

costMicros

string (int64 format)

העלות הצפויה ב-micros.

impressions

string (int64 format)

מספר החשיפות הצפוי.

topSlotImpressions

string (int64 format)

מספר החשיפות הצפוי במשבצת העליונה. השדה הזה תומך רק בסוג ערוץ פרסום ברשת החיפוש.

interactions

string (int64 format)

המספר הצפוי של אינטראקציות. רק סוג הערוץ 'מודעות Discovery' תומך בשדה הזה.

שדה האיחוד target_cpa_simulation_key_value. כשהערך של SimulationModificationMethod = UNIFORM או DEFAULT, הערך של target_cpa_micros מוגדר. כשהערך של SimulationModificationMethod = SCALING, הערך של target_cpa_scaling_modifier מוגדר. target_cpa_simulation_key_value יכול להיות רק אחת מהאפשרויות הבאות:
targetCpaMicros

string (int64 format)

הסימולציה של יעד העלות להמרה (CPA) שעליו מבוססים המדדים החזויים.

targetCpaScalingModifier

number

המשתנה של ההתאמה לעומס המדומה שעליו מבוססים המדדים הצפויים. כל יעדי העלות להמרה שרלוונטיים לישות המדומה מותאמים לפי המכפיל הזה.

TargetRoasSimulationPointList

מאגר של נקודות סימולציה לסימולציות מסוג TARGET_ROAS.

ייצוג JSON
{
  "points": [
    {
      object (TargetRoasSimulationPoint)
    }
  ]
}
שדות
points[]

object (TargetRoasSimulationPoint)

מדדים חזויים לסדרה של סכומים של יעד החזר על הוצאות פרסום.

TargetRoasSimulationPoint

המדדים הצפויים לפי סכום ספציפי של יעד החזר על הוצאות פרסום.

ייצוג JSON
{
  "requiredBudgetAmountMicros": string,
  "targetRoas": number,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string
}
שדות
requiredBudgetAmountMicros

string (int64 format)

התקציב היומי הנדרש הצפוי שהמפרסם צריך להגדיר כדי לקבל את התנועה המשוערת, במיקרו-מטבע של המפרסם.

targetRoas

number

יעד הסימולציה של ההחזר על הוצאות הפרסום, שעליו מבוססים המדדים החזויים.

biddableConversions

number

מספר ההמרות הצפוי שאפשר להגיש עבורן הצעות מחיר.

biddableConversionsValue

number

הערך הכולל הצפוי של המרות שניתן להגיש עליהן הצעות מחיר.

clicks

string (int64 format)

מספר הקליקים הצפוי.

costMicros

string (int64 format)

העלות הצפויה ב-micros.

impressions

string (int64 format)

מספר החשיפות הצפוי.

topSlotImpressions

string (int64 format)

מספר החשיפות הצפוי במשבצת העליונה. השדה הזה תומך רק בסוג ערוץ פרסום ברשת החיפוש.

AgeRangeView

תצוגה של טווח הגילאים.

ייצוג ב-JSON
{
  "resourceName": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב של תצוגת טווח הגילאים. שמות המשאבים של תצוגת טווח הגילאים מופיעים בצורה הבאה:

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

AdScheduleView

בתצוגה של תזמון הצגת המודעות מוצג סיכום של ביצועי הקמפיינים לפי הקריטריונים של תזמון הצגת המודעות.

ייצוג JSON
{
  "resourceName": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב של תצוגת לוח הזמנים של המודעות. שמות המשאבים בתצוגה AdSchedule הם בפורמט:

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

DomainCategory

קטגוריה שנוצרה באופן אוטומטי על ידי סריקת דומיין. אם בקמפיין נעשה שימוש ב-DynamicSearchAdsSetting, המערכת תיצור קטגוריות דומיין לדומיין הזה. ניתן לטרגט לקטגוריות באמצעות WebpageConditionInfo. מידע נוסף זמין במאמר https://support.google.com/google-ads/answer/2471185

ייצוג ב-JSON
{
  "resourceName": string,
  "campaign": string,
  "category": string,
  "languageCode": string,
  "domain": string,
  "coverageFraction": number,
  "categoryRank": string,
  "hasChildren": boolean,
  "recommendedCpcBidMicros": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב של קטגוריית הדומיין. שמות המשאבים של קטגוריות הדומיינים מופיעים בתבנית:

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

campaign

string

פלט בלבד. הקמפיין שעבורו הקטגוריה הזו מומלצת.

category

string

פלט בלבד. הקטגוריה המומלצת לדומיין האתר. לדוגמה, אם יש לכם אתר שעוסק באלקטרוניקה, הקטגוריות יכולות להיות 'מצלמות', 'טלוויזיות' וכו'.

languageCode

string

פלט בלבד. קוד השפה שמציין את שפת האתר. לדוגמה, 'en' לאנגלית. ניתן לציין את השפה בהגדרה DynamicSearchAdsSetting שנדרשת למודעות דינמיות לרשת החיפוש. זו השפה שבה כתובים הדפים מהאתר שרוצים שמערכת Google Ads תמצא, תיצור עבורם מודעות ותתאים להם חיפושים.

domain

string

פלט בלבד. הדומיין של האתר. אפשר לציין את הדומיין ב-DynamicSearchAdsSetting שנדרש למודעות דינמיות לרשת החיפוש.

coverageFraction

number

פלט בלבד. חלק מהדפים באתר שלך שהקטגוריה הזו תואמת להם.

categoryRank

string (int64 format)

פלט בלבד. המיקום של הקטגוריה הזו בקבוצת הקטגוריות. מספרים נמוכים יותר מציינים התאמה טובה יותר לדומיין. הערך null מציין לא מומלץ.

hasChildren

boolean

פלט בלבד. מציין אם לקטגוריה הזו יש קטגוריות משנה.

recommendedCpcBidMicros

string (int64 format)

פלט בלבד. העלות המומלצת לקליק בקטגוריה.

AssetFieldTypeView

תצוגה של סוג השדה של הנכס. בתצוגה הזו מוצגים מדדים ללא ספירה כפולה לכל סוג שדה של נכס כשהנכס משמש כתוסף.

ייצוג JSON
{
  "resourceName": string,
  "fieldType": enum (AssetFieldType)
}
שדות
resourceName

string

פלט בלבד. שם המשאב בתצוגת סוג השדה של הנכס. שמות משאבים לתצוגה של סוגי שדות נכס נראים כך:

customers/{customerId}/assetFieldTypeViews/{fieldType}

fieldType

enum (AssetFieldType)

פלט בלבד. סוג השדה 'נכס' בתצוגת סוג השדה של הנכס.

AssetGroupProductGroupView

תצוגה של קבוצת מוצרים בקבוצת נכסים.

ייצוג JSON
{
  "resourceName": string,
  "assetGroup": string,
  "assetGroupListingGroupFilter": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב בתצוגת קבוצת המוצרים של קבוצת הנכסים. שמות המשאבים של תצוגת קבוצת נכסים של קבוצות נכסים מופיעים בפורמט:

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

assetGroup

string

פלט בלבד. קבוצת הנכסים שמשויכת למסנן הקבוצות של כרטיסי המוצר.

assetGroupListingGroupFilter

string

פלט בלבד. שם המשאב במסנן הקבוצות של כרטיסי המוצר של קבוצת הנכסים.

AssetGroupTopCombinationView

תצוגה של השימוש בשילוב של נכסי המודעות בקבוצת המודעות.

ייצוג JSON
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
שדות
resourceName

string

פלט בלבד. שם המשאב בתצוגת השילוב העליון של קבוצת הנכסים. שמות המשאבים של תצוגת הנכסים המובילים של AssetGroup מופיעים כך: `"customers/{customerId}/assetGroupTopIntegrationViews/{assetGroupId}~{asset_combination_category}"

assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

פלט בלבד. השילובים המובילים של נכסים שמוצגים יחד.

AssetGroupAssetCombinationData

נתונים על שילובי נכסים בקבוצת נכסים

ייצוג ב-JSON
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
שדות
assetCombinationServedAssets[]

object (AssetUsage)

פלט בלבד. הנכסים המוצגים.

AssetSetTypeView

תצוגה של סוג קבוצת נכסים. בתצוגה המפורטת הזו מופיע דיווח על מדדים שלא נספרו עבור כל סוג של קבוצת נכסים. סוגי קבוצות של נכסים ברמת הצאצא לא נכללים בדוח הזה. הנתונים הסטטיסטיים שלהם נצברים לפי סוג קבוצת הנכסים ברמה העליונה.

ייצוג JSON
{
  "resourceName": string,
  "assetSetType": enum (AssetSetType)
}
שדות
resourceName

string

פלט בלבד. שם המשאב של תצוגת סוג קבוצת הנכסים. שמות המשאבים בתצוגת סוג קבוצת הנכסים הם בפורמט:

customers/{customerId}/assetSetTypeViews/{assetSetType}

assetSetType

enum (AssetSetType)

פלט בלבד. סוג קבוצת הנכסים בתצוגת סוג קבוצת הנכסים.

BiddingStrategySimulation

סימולציה של שיטת בידינג. השילובים הנתמכים של סוג הסימולציה ושיטת השינוי של הסימולציה מפורטים למטה בהתאמה.

  1. TARGET_CPA - UNIFORM
  2. TARGET_ROAS – UNIFORM
ייצוג 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.
}
שדות
resourceName

string

פלט בלבד. שם המשאב בסימולציה של שיטת הבידינג. שמות המשאבים לסימולציה של שיטת בידינג מופיעים בפורמט הבא:

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

biddingStrategyId

string (int64 format)

פלט בלבד. מזהה הקבוצה המשותפת של שיטת הבידינג בסימולציה.

type

enum (SimulationType)

פלט בלבד. השדה שהסימולציה משנה.

modificationMethod

enum (SimulationModificationMethod)

פלט בלבד. איך הסימולציה משנה את השדה.

startDate

string

פלט בלבד. היום הראשון שבו מבוססת ההדמיה, בפורמט YYYY-MM-DD.

endDate

string

פלט בלבד. היום האחרון שבו הסימולציה מבוססת, בפורמט YYYY-MM-DD

שדה איחוד point_list. רשימה של נקודות סימולציה. point_list יכול להיות רק אחת מהאפשרויות הבאות:
targetCpaPointList

object (TargetCpaSimulationPointList)

פלט בלבד. נקודות הדמיה אם סוג הסימולציה הוא TARGET_CPA.

targetRoasPointList

object (TargetRoasSimulationPointList)

פלט בלבד. נקודות סימולציה אם סוג הסימולציה הוא TARGET_ROAS.

CallView

תצוגת שיחות שכוללת נתונים למעקב אחרי שיחות של מודעות לשיחות בלבד או תוספי שיחה.

ייצוג ב-JSON
{
  "resourceName": string,
  "callerCountryCode": string,
  "callerAreaCode": string,
  "callDurationSeconds": string,
  "startCallDateTime": string,
  "endCallDateTime": string,
  "callTrackingDisplayLocation": enum (CallTrackingDisplayLocation),
  "type": enum (CallType),
  "callStatus": enum (GoogleVoiceCallStatus)
}
שדות
resourceName

string

פלט בלבד. שם המשאב של תצוגת השיחה. שמות המשאבים בתצוגת השיחה מופיעים בפורמט:

customers/{customerId}/callViews/{call_detail_id}

callerCountryCode

string

פלט בלבד. קוד המדינה של המתקשר.

callerAreaCode

string

פלט בלבד. קוד האזור של המתקשר. המערכת תציג ערך של null אם משך השיחה קצר מ-15 שניות.

callDurationSeconds

string (int64 format)

פלט בלבד. משך השיחה בשניות שסיפק המפרסם.

startCallDateTime

string

פלט בלבד. התאריך והשעה של תחילת השיחה שסופקו על ידי המפרסם.

endCallDateTime

string

פלט בלבד. תאריך סיום השיחה שסופק על ידי המפרסם.

callTrackingDisplayLocation

enum (CallTrackingDisplayLocation)

פלט בלבד. מיקום התצוגה של המעקב אחר השיחות.

type

enum (CallType)

פלט בלבד. סוג הקריאה.

callStatus

enum (GoogleVoiceCallStatus)

פלט בלבד. הסטטוס של השיחה.

CallTrackingDisplayLocation

מיקומים אפשריים שבהם אפשר לעקוב אחרי שיחות.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
AD שיחת הטלפון שהתקבלה מהמודעה.
LANDING_PAGE שיחת הטלפון שמבוצעת מדף הנחיתה מפנה אל המודעה.

CallType

סוגי הנכסים האפשריים שמהם בוצעה השיחה.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
MANUALLY_DIALED השיחה התבצעה באמצעות חיוג ידני.

GoogleVoiceCallStatus

סטטוסים אפשריים של שיחה קולית ב-Google.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
MISSED השיחה לא נענתה.
RECEIVED השיחה התקבלה.

CampaignAudienceView

תצוגה של קהל בקמפיין. כולל נתוני ביצועים מרשימות תחומי עניין ורשימות רימרקטינג עבור מודעות ברשת המדיה וברשת YouTube, וכן רשימות רימרקטינג עבור מודעות לרשת החיפוש (RLSA), שנצברו לפי קמפיין וקריטריונים של קהלים. התצוגה הזו כוללת רק קהלים שמצורפים ברמת הקמפיין.

ייצוג ב-JSON
{
  "resourceName": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב בתצוגת הקהל של הקמפיין. שמות המשאבים של צפייה בקהל בקמפיין מופיעים בפורמט:

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

CampaignSearchTermInsight

תצוגה של מונחי חיפוש בקמפיין. הנתונים ההיסטוריים זמינים החל ממרץ 2023.

ייצוג ב-JSON
{
  "resourceName": string,
  "categoryLabel": string,
  "id": string,
  "campaignId": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב של התובנה לגבי מונחי החיפוש ברמת הקמפיין. שמות המשאבים של מדדי מונח החיפוש ברמת הקמפיין הם בפורמט:

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

categoryLabel

string

פלט בלבד. התווית של קטגוריית החיפוש. מחרוזת ריקה מציינת את הקטגוריה הכללית של מונחי חיפוש שלא התאימו לקטגוריה אחרת.

id

string (int64 format)

פלט בלבד. המזהה של התובנה.

campaignId

string (int64 format)

פלט בלבד. המזהה של הקמפיין.

CampaignSimulation

סימולציית קמפיין. השילובים הנתמכים של סוג ערוץ הפרסום, סוג הסימולציה ושיטת שינוי הסימולציה מפורטים למטה, בהתאמה.

  • חיפוש – CPC_BID – UNIFORM
  • SEARCH - CPC_BID - SCALING
  • חיפוש - TARGET_CPA – UNIFORM
  • SEARCH - TARGET_CPA - SCALING
  • חיפוש – TARGET_ROAS – UNIFORM
  • חיפוש – TARGET_IMPRESSION_SHARE – UNIFORM
  • חיפוש – תקציב – אוניברסלי
  • שופינג – תקציב – אחיד
  • שופינג - TARGET_ROAS – UNIFORM
  • MULTI_CHANNEL – TARGET_CPA – UNIFORM
  • MULTI_CHANNEL - TARGET_ROAS - UNIFORM
  • DISCOVERY - TARGET_CPA - DEFAULT
  • DISPLAY - TARGET_CPA - UNIFORM
  • PERFORMANCE_MAX - TARGET_CPA - UNIFORM
  • PERFORMANCE_MAX - TARGET_ROAS - UNIFORM
  • PERFORMANCE_MAX - BUDGET - UNIFORM
ייצוג 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.
}
שדות
resourceName

string

פלט בלבד. שם המשאב 'סימולציית הקמפיין'. שמות משאבים של סימולציה של קמפיין מופיעים בתבנית:

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

campaignId

string (int64 format)

פלט בלבד. מזהה הקמפיין של הסימולציה.

type

enum (SimulationType)

פלט בלבד. השדה שהסימולציה משנה.

modificationMethod

enum (SimulationModificationMethod)

פלט בלבד. איך הסימולציה משנה את השדה.

startDate

string

פלט בלבד. היום הראשון שבו מבוססת ההדמיה, בפורמט YYYY-MM-DD.

endDate

string

פלט בלבד. היום האחרון שבו הסימולציה מבוססת, בפורמט YYYY-MM-DD

שדה איחוד point_list. רשימה של נקודות סימולציה. point_list יכול להיות רק אחת מהאפשרויות הבאות:
cpcBidPointList

object (CpcBidSimulationPointList)

פלט בלבד. נקודות הסימולציה אם סוג הסימולציה הוא CPC_BID.

targetCpaPointList

object (TargetCpaSimulationPointList)

פלט בלבד. נקודות הדמיה אם סוג הסימולציה הוא TARGET_CPA.

targetRoasPointList

object (TargetRoasSimulationPointList)

פלט בלבד. נקודות סימולציה אם סוג הסימולציה הוא TARGET_ROAS.

targetImpressionSharePointList

object (TargetImpressionShareSimulationPointList)

פלט בלבד. נקודות סימולציה אם סוג הסימולציה הוא TARGET_IMPRESSION_SHARE.

budgetPointList

object (BudgetSimulationPointList)

פלט בלבד. נקודות הסימולציה אם סוג הסימולציה הוא BUDGET.

TargetImpressionShareSimulationPointList

מאגר לנקודות סימולציה לסימולציות מסוג TARGET_IMPRESSION_SHARE.

ייצוג JSON
{
  "points": [
    {
      object (TargetImpressionShareSimulationPoint)
    }
  ]
}
שדות
points[]

object (TargetImpressionShareSimulationPoint)

מדדים צפויים עבור ערך ספציפי של יעד נתח חשיפות.

TargetImpressionShareSimulationPoint

מדדים צפויים של ערך ספציפי של יעד נתח חשיפות.

ייצוג JSON
{
  "targetImpressionShareMicros": string,
  "requiredCpcBidCeilingMicros": string,
  "requiredBudgetAmountMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,
  "absoluteTopImpressions": string
}
שדות
targetImpressionShareMicros

string (int64 format)

ערך הסימולציה של יעד נתח החשיפות (במיליוניות השנייה) שעליו מבוססים המדדים החזויים. לדוגמה, 10% נתח חשיפות, ששווה ל-0.1, נשמר כ-100_000. הערך הזה אומת ולא יעלה על מיליון (100%).

requiredCpcBidCeilingMicros

string (int64 format)

תקרת הצעות המחיר היומית הצפויה לקליק שהמפרסם צריך להגדיר כדי שההדמיה הזו תתבצע, במיקרו של המטבע של המפרסם.

requiredBudgetAmountMicros

string (int64 format)

התקציב היומי הצפוי שהמפרסם צריך להגדיר כדי לקבל את נפח התנועה המשוער, במיקרו של המטבע של המפרסם.

biddableConversions

number

מספר ההמרות הצפוי שאפשר להגיש עבורן הצעות מחיר.

biddableConversionsValue

number

הערך הכולל הצפוי של המרות שניתן להגיש עליהן הצעות מחיר.

clicks

string (int64 format)

מספר הקליקים הצפוי.

costMicros

string (int64 format)

העלות הצפויה ב-micros.

impressions

string (int64 format)

מספר החשיפות הצפוי.

topSlotImpressions

string (int64 format)

המספר הצפוי של חשיפות במיקום הראשון. רק סוג הערוץ 'פרסום ברשת החיפוש' תומך בשדה הזה.

absoluteTopImpressions

string (int64 format)

המספר הצפוי של חשיפות במיקום הראשון. רק סוג הערוץ 'פרסום ברשת החיפוש' תומך בשדה הזה.

BudgetSimulationPointList

מאגר לנקודות סימולציה לסימולציות מסוג BUDGET.

ייצוג ב-JSON
{
  "points": [
    {
      object (BudgetSimulationPoint)
    }
  ]
}
שדות
points[]

object (BudgetSimulationPoint)

מדדים חזויים לסדרה של סכומי תקציבים.

BudgetSimulationPoint

מדדים צפויים לסכום תקציב ספציפי.

ייצוג ב-JSON
{
  "budgetAmountMicros": string,
  "requiredCpcBidCeilingMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,
  "interactions": string
}
שדות
budgetAmountMicros

string (int64 format)

התקציב המדומה שעליו מבוססים המדדים הצפויים.

requiredCpcBidCeilingMicros

string (int64 format)

תקרת הצעות המחיר היומית המומלצת לקליק שהמפרסם צריך להגדיר כדי לממש את הסימולציה, במיליוניות השנייה של מטבע המפרסם. השדה הזה נתמך רק בקמפיינים עם שיטת הבידינג 'יעד הוצאה'.

biddableConversions

number

מספר ההמרות הצפוי שאפשר להגיש עבורן הצעות מחיר.

biddableConversionsValue

number

הערך הכולל הצפוי של המרות שניתן להגיש עליהן הצעות מחיר.

clicks

string (int64 format)

מספר הקליקים הצפוי.

costMicros

string (int64 format)

העלות הצפויה ב-micros.

impressions

string (int64 format)

מספר החשיפות הצפוי.

topSlotImpressions

string (int64 format)

מספר החשיפות הצפוי במשבצת העליונה. השדה הזה תומך רק בסוג ערוץ פרסום ברשת החיפוש.

interactions

string (int64 format)

מספר האינטראקציות הצפוי. השדה הזה תומך רק בסוג ערוץ פרסום מסוג Discovery.

CarrierConstant

קריטריון ספק שאפשר להשתמש בו בטירגוט של קמפיין.

ייצוג ב-JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "countryCode": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב של הקריטריון של הספק. שמות המשאבים של הקריטריון של הספק מופיעים בפורמט הבא:

carrierConstants/{criterionId}

id

string (int64 format)

פלט בלבד. המזהה של קריטריון הספק.

name

string

פלט בלבד. השם המלא של המוביל באנגלית.

countryCode

string

פלט בלבד. קוד המדינה של המדינה שבה נמצא הספק, למשל 'AR', 'FR' וכו'.

ChangeEvent

מתאר את השינוי המפורט של המשאבים שהוחזרו במסגרת סוגי משאבים מסוימים. הדוח כולל שינויים שבוצעו דרך ממשק המשתמש או ה-API ב-30 הימים האחרונים. יוצגו הערכים הקודמים והחדשים של השדות שהשתנו. יכול להיות עיכוב של עד 3 דקות באירוע ChangeEvent עד שהשינוי החדש יופיע.

ייצוג 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
}
שדות
resourceName

string

פלט בלבד. שם המשאב של אירוע השינוי. שינוי שמות של משאבי אירועים מופיע בתבנית:

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

changeDateTime

string

פלט בלבד. השעה שבה בוצע השינוי במשאב הזה.

changeResourceType

enum (ChangeEventResourceType)

פלט בלבד. הסוג של המשאב שהשתנה. זה קובע איזה משאב יוגדר ב-oldResource וב-newResource.

changeResourceName

string

פלט בלבד. המשאב פשוט שבו התרחש השינוי.

clientType

enum (ChangeClientType)

פלט בלבד. המקום שבו השינוי בוצע.

userEmail

string

פלט בלבד. כתובת האימייל של המשתמש שביצע את השינוי.

oldResource

object (ChangedResource)

פלט בלבד. המשאב הישן לפני השינוי. רק שדות שהשתנו יאוכלסו.

newResource

object (ChangedResource)

פלט בלבד. המשאב החדש אחרי השינוי. רק שדות שהשתנו יאוכלסו.

resourceChangeOperation

enum (ResourceChangeOperation)

פלט בלבד. הפעולה במשאב שהשתנה.

changedFields

string (FieldMask format)

פלט בלבד. רשימת השדות שהשתנו במשאב שהוחזר.

זוהי רשימה מופרדת בפסיקים של שמות שדות מלאים. דוגמה: "user.displayName,photo"

campaign

string

פלט בלבד. הקמפיין מושפע מהשינוי הזה.

adGroup

string

פלט בלבד. קבוצת המודעות שהושפעה מהשינוי הזה.

feed

string

פלט בלבד. הפיד שהושפע מהשינוי הזה.

feedItem

string

פלט בלבד. הפריט בפיד שהושפע מהשינוי הזה.

asset

string

פלט בלבד. הנכס שמושפע מהשינוי הזה.

ChangeEventResourceType

פירוט של סוגי המשאבים שנתמכים על ידי המשאב ChangeEvent.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין ערך.
UNKNOWN משמש רק לערך המוחזר. מייצג משאב לא מסווג שלא ידוע בגרסה הזו.
AD שינוי במשאב של מודעה.
AD_GROUP שינוי במשאב של קבוצת מודעות.
AD_GROUP_CRITERION שינוי במשאב AdGroupCriterion.
CAMPAIGN שינוי במשאב של קמפיין.
CAMPAIGN_BUDGET שינוי במשאב CampaignBudget.
AD_GROUP_BID_MODIFIER שינוי במשאב AdGroupBidModifier.
CAMPAIGN_CRITERION שינוי במשאב CampaignCriterion.
FEED שינוי במשאב של פיד.
FEED_ITEM שינוי במשאב FeedItem.
CAMPAIGN_FEED שינוי במשאב CampaignFeed.
AD_GROUP_FEED שינוי במשאב AdGroupFeed.
AD_GROUP_AD שינוי במשאב AdGroupAd.
ASSET שינוי במשאב של הנכס.
CUSTOMER_ASSET שינוי במשאב של CustomerAsset.
CAMPAIGN_ASSET שינוי במשאב של CampaignAsset.
AD_GROUP_ASSET שינוי במשאב AdGroupAsset.
ASSET_SET שינוי במשאב AssetSet.
ASSET_SET_ASSET שינוי במשאב AssetSetAsset.
CAMPAIGN_ASSET_SET שינוי במשאב CampaignAssetSet.

ChangeClientType

המקור שדרכו נוצר המשאב ChangeEvent.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין ערך.
UNKNOWN משמש רק לערך המוחזר. מייצג סוג לקוח לא מסווג שאינו ידוע בגרסה הזו.
GOOGLE_ADS_WEB_CLIENT שינויים שבוצעו דרך "ads.google.com". לדוגמה, שינויים שבוצעו באמצעות ניהול קמפיין.
GOOGLE_ADS_AUTOMATED_RULE שינויים שבוצעו באמצעות הכללים האוטומטיים של Google Ads.
GOOGLE_ADS_SCRIPTS שינויים שבוצעו באמצעות סקריפטים של Google Ads.
GOOGLE_ADS_BULK_UPLOAD שינויים שבוצעו באמצעות העלאה בכמות גדולה ב-Google Ads.
GOOGLE_ADS_API שינויים שבוצעו על ידי Google Ads API.
GOOGLE_ADS_EDITOR שינויים שבוצעו על ידי Google Ads Editor. הערך הזה הוא placeholder. ה-API לא מחזיר את השינויים האלה.
GOOGLE_ADS_MOBILE_APP שינויים שבוצעו באפליקציה לנייד של Google Ads.
GOOGLE_ADS_RECOMMENDATIONS שינויים שבוצעו באמצעות המלצות של Google Ads.
SEARCH_ADS_360_SYNC שינויים שבוצעו באמצעות סנכרון Search Ads 360.
SEARCH_ADS_360_POST שינויים שבוצעו דרך פוסט ב-Search Ads 360.
INTERNAL_TOOL שינויים שבוצעו באמצעות כלים פנימיים. לדוגמה, כשמשתמש מגדיר תבנית של כתובת URL לישות כמו קמפיין, היא עטופה באופן אוטומטי בכתובת ה-URL של השרת למעקב אחרי קליקים ב-SA360.
OTHER סוגי השינויים שלא מסווגים, למשל, שינויים שבוצעו בעקבות מימוש שוברים דרך Google Ads.
GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION שינויים שבוצעו על ידי הרשמה להמלצות של Google Ads.

ChangedResource

פרוטוקול wrapper שמציג את כל המשאבים הנתמכים. יוגדר רק המשאב של changeResourceType.

ייצוג 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)
  }
}
שדות
ad

object (Ad)

פלט בלבד. הגדרה אם changeResourceType == AD.

adGroup

object (AdGroup)

פלט בלבד. מוגדר אם changeResourceType == AD_GROUP.

adGroupCriterion

object (AdGroupCriterion)

פלט בלבד. מוגדר אם changeResourceType == AD_GROUP_CRITERION.

campaign

object (Campaign)

פלט בלבד. מגדירים אם changeResourceType == CAMPAIGN.

campaignBudget

object (CampaignBudget)

פלט בלבד. מגדירים אם changeResourceType == CAMPAIGN_BUDGET.

adGroupBidModifier

object (AdGroupBidModifier)

פלט בלבד. מוגדר אם changeResourceType == AD_GROUP_BID_MODIFIER.

campaignCriterion

object (CampaignCriterion)

פלט בלבד. מוגדר אם changeResourceType == CAMPAIGN_CRITERION.

feed

object (Feed)

פלט בלבד. יש להגדיר אם changeResourceType == FEED.

feedItem

object (FeedItem)

פלט בלבד. מוגדר אם changeResourceType == FEED_ITEM.

campaignFeed

object (CampaignFeed)

פלט בלבד. יש להגדיר אם changeResourceType == CAMPAIGN_FEED.

adGroupFeed

object (AdGroupFeed)

פלט בלבד. יש להגדיר אם changeResourceType == AD_GROUP_FEED.

adGroupAd

object (AdGroupAd)

פלט בלבד. יש להגדיר אם changeResourceType == AD_GROUP_AD.

asset

object (Asset)

פלט בלבד. מגדירים אם changeResourceType == ASSET.

customerAsset

object (CustomerAsset)

פלט בלבד. מגדירים אם changeResourceType == CUSTOMER_ASSET.

campaignAsset

object (CampaignAsset)

פלט בלבד. מגדירים אם changeResourceType == CAMPAIGN_ASSET.

adGroupAsset

object (AdGroupAsset)

פלט בלבד. מוגדר אם changeResourceType == AD_GROUP_ASSET.

assetSet

object (AssetSet)

פלט בלבד. מגדירים אם changeResourceType == ASSET_SET.

assetSetAsset

object (AssetSetAsset)

פלט בלבד. מגדירים אם changeResourceType == ASSET_SET_ASSET.

campaignAssetSet

object (CampaignAssetSet)

פלט בלבד. מגדירים אם changeResourceType == CAMPAIGN_ASSET_SET.

ResourceChangeOperation

הפעולה במשאב שהשתנה במשאב changeEvent.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין ערך.
UNKNOWN משמש רק לערך המוחזר. מייצג פעולה לא מסווגת שלא ידועה בגרסה הזו.
CREATE המשאב נוצר.
UPDATE המשאב השתנה.
REMOVE המשאב הוסר.

ChangeStatus

תיאור הסטטוס של המשאב המוחזר. ייתכן עיכוב של עד 3 דקות ב-ChangeStatus כדי לשקף שינוי חדש.

ייצוג ב-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
}
שדות
resourceName

string

פלט בלבד. שם המשאב של סטטוס השינוי. שינוי שמות של משאבים בסטטוס:

customers/{customerId}/changeStatus/{change_status_id}

resourceType

enum (ChangeStatusResourceType)

פלט בלבד. מייצג את סוג המשאב שהשתנה. האפשרות הזו קובעת אילו שדות יוגדרו. לדוגמה, עבור AD_GROUP, השדות 'קמפיין' ו'קבוצת מודעות' יוגדרו.

resourceStatus

enum (ChangeStatusOperation)

פלט בלבד. מייצג את הסטטוס של המשאב שהשתנה.

sharedSet

string

פלט בלבד. ה-SharedSet מושפע מהשינוי הזה.

campaignSharedSet

string

פלט בלבד. CampaignSharedSet מושפע מהשינוי הזה.

asset

string

פלט בלבד. הנכס שמושפע מהשינוי הזה.

customerAsset

string

פלט בלבד. הנכס CustomerAsset מושפע מהשינוי הזה.

campaignAsset

string

פלט בלבד. נכס הקמפיין שמושפע מהשינוי הזה.

adGroupAsset

string

פלט בלבד. קבוצת המודעות שהושפעה מהשינוי הזה.

combinedAudience

string

פלט בלבד. הקהל המשולב שהושפע מהשינוי הזה.

lastChangeDateTime

string

פלט בלבד. השעה שבה התרחש השינוי האחרון במשאב הזה.

campaign

string

פלט בלבד. הקמפיין שהושפע מהשינוי.

adGroup

string

פלט בלבד. קבוצת המודעות שהושפעה מהשינוי הזה.

adGroupAd

string

פלט בלבד. קבוצת המודעות שהושפעה מהשינוי הזה.

adGroupCriterion

string

פלט בלבד. קריטריון קבוצת המודעות שהושפע מהשינוי הזה.

campaignCriterion

string

פלט בלבד. ה-CampaignCriterion שהושפע מהשינוי הזה.

feed

string

פלט בלבד. הפיד שהושפע מהשינוי הזה.

feedItem

string

פלט בלבד. הפריט בפיד שהושפע מהשינוי הזה.

adGroupFeed

string

פלט בלבד. The AdGroupFeed שהושפע מהשינוי הזה.

campaignFeed

string

פלט בלבד. ה-CampaignFeed מושפע מהשינוי הזה.

adGroupBidModifier

string

פלט בלבד. The AdGroupBidModifier שמושפע מהשינוי הזה.

ChangeStatusResourceType

Enum שמפרט את סוגי המשאבים שנתמכים על ידי המשאב ChangeStatus.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין ערך.
UNKNOWN משמש רק לערך המוחזר. מייצג משאב לא מסווג שאינו ידוע בגרסה הזו.
AD_GROUP שינוי במשאב של קבוצת מודעות.
AD_GROUP_AD שינוי במשאב AdGroupAd.
AD_GROUP_CRITERION שינוי במשאב AdGroupCriterion.
CAMPAIGN שינוי במשאב של קמפיין.
CAMPAIGN_CRITERION שינוי במשאב CampaignCriterion.
FEED שינוי במשאב של פיד.
FEED_ITEM שינוי במשאב FeedItem.
AD_GROUP_FEED שינוי במשאב AdGroupFeed.
CAMPAIGN_FEED שינוי במשאב CampaignFeed.
AD_GROUP_BID_MODIFIER שינוי במשאב AdGroupBidModifier.
SHARED_SET שינוי במשאב SharedSet.
CAMPAIGN_SHARED_SET שינוי משאב של CampaignSharedSet.
ASSET שינוי במשאב של הנכס.
CUSTOMER_ASSET שינוי במשאב של CustomerAsset.
CAMPAIGN_ASSET שינוי במשאב של CampaignAsset.
AD_GROUP_ASSET שינוי במשאב AdGroupAsset.
COMBINED_AUDIENCE שינוי במשאב של OptionalAudience.

ChangeStatusOperation

הסטטוס של המשאב ששונה

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין ערך.
UNKNOWN משמש רק לערך המוחזר. מייצג משאב לא מסווג שלא ידוע בגרסה הזו.
ADDED המשאב נוצר.
CHANGED המשאב השתנה.
REMOVED המשאב הוסר.

CombinedAudience

תיאור מקור מידע לקהלים משולבים שכוללים קהלים שונים.

ייצוג JSON
{
  "resourceName": string,
  "id": string,
  "status": enum (CombinedAudienceStatus),
  "name": string,
  "description": string
}
שדות
resourceName

string

בלתי ניתן לשינוי. שם המשאב של הקהל המשולב. שמות של קהלים משולבים מופיעים בתבנית:

customers/{customerId}/combinedAudience/{combined_audience_id}

id

string (int64 format)

פלט בלבד. המזהה של הקהל המשולב.

status

enum (CombinedAudienceStatus)

פלט בלבד. הסטטוס של הקהל המשולב הזה. מציין אם הקהל המשולב מופעל או הוסר.

name

string

פלט בלבד. השם של הקהל המשולב. הקהל צריך להיות ייחודי בכל הקהלים המשולבים.

description

string

פלט בלבד. תיאור הקהל המשולב הזה.

CombinedAudienceStatus

Enum מכיל סוגי סטטוסים אפשריים של קהל משולב.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
ENABLED סטטוס מופעל - הקהל המשולב מופעל ואפשר לטרגט אותו.
REMOVED סטטוס 'הוסר' – הקהל המשולב הוסר ואי אפשר להשתמש בו לטירגוט.

ClickView

תצוגת קליקים עם מדדים שנצברו בכל רמת קליק, כולל קליקים תקינים ולא תקינים. בקמפיינים שאינם בקמפיינים לרשת החיפוש, המדד metrics.clicks מייצג את מספר האינטראקציות התקינות והלא חוקיות. בשאילתות שכוללות ClickView צריך להיות מסנן שמגביל את התוצאות ליום אחד, ואפשר לשלוח אותן לתאריכים החל מ-90 יום לפני מועד הבקשה.

ייצוג ב-JSON
{
  "resourceName": string,
  "areaOfInterest": {
    object (ClickLocation)
  },
  "locationOfPresence": {
    object (ClickLocation)
  },
  "keyword": string,
  "keywordInfo": {
    object (KeywordInfo)
  },
  "gclid": string,
  "pageNumber": string,
  "adGroupAd": string,
  "campaignLocationTarget": string,
  "userList": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב בתצוגת הקליקים. שמות המשאבים בתצוגת הקליקים הם בפורמט:

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

areaOfInterest

object (ClickLocation)

פלט בלבד. קריטריוני המיקום שתואמים לאזור העניין המשויך לחשיפה.

locationOfPresence

object (ClickLocation)

פלט בלבד. קריטריונים למיקום שתואמים למיקום הנוכחות שמשויך לחשיפת המודעה.

keyword

string

פלט בלבד. מילת המפתח המשויכת, אם יש כזו והקליק תואם לערוץ 'חיפוש'.

keywordInfo

object (KeywordInfo)

פלט בלבד. מידע בסיסי על מילת המפתח המשויכת, אם יש כזו.

gclid

string

פלט בלבד. מזהה הקליק ב-Google.

pageNumber

string (int64 format)

פלט בלבד. מספר הדף בתוצאות החיפוש שבו הוצגה המודעה.

adGroupAd

string

פלט בלבד. המודעה המשויכת.

campaignLocationTarget

string

פלט בלבד. המיקום הגיאוגרפי לטירגוט שמשויך לקמפיין, אם קיים.

userList

string

פלט בלבד. רשימת המשתמשים המשויכת, אם יש כזו.

ClickLocation

קריטריונים של מיקום שמשויכים לקליק.

ייצוג JSON
{
  "city": string,
  "country": string,
  "metro": string,
  "mostSpecific": string,
  "region": string
}
שדות
city

string

קריטריון המיקום של העיר שמשויך לחשיפה.

country

string

הקריטריון למיקום המדינה שמשויך לחשיפה.

metro

string

קריטריון המיקום במטרופולין שמשויך לחשיפה.

mostSpecific

string

קריטריון המיקום הספציפי ביותר שמשויך לחשיפה.

region

string

קריטריון המיקום של האזור שמשויך לחשיפת המודעות.

CurrencyConstant

קבוע מטבע.

ייצוג ב-JSON
{
  "resourceName": string,
  "code": string,
  "name": string,
  "symbol": string,
  "billableUnitMicros": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב של קבוע המטבע. שמות משאבים קבועים של מטבע מופיעים בפורמט הבא:

currencyConstants/{code}

code

string

פלט בלבד. קוד מטבע בן שלוש אותיות לפי תקן ISO 4217, לדוגמה: USD

name

string

פלט בלבד. השם המלא של המטבע באנגלית.

symbol

string

פלט בלבד. הסמל הסטנדרטי לתיאור המטבע הזה. לדוגמה, '$' לדולר ארה"ב.

billableUnitMicros

string (int64 format)

פלט בלבד. היחידות שניתן לחיוב במטבע הזה. הסכומים לחיוב צריכים להיות כפולות של הערך הזה.

AccessibleBiddingStrategy

מייצגת תצוגה של שיטות בידינג שבבעלות הלקוח וששותפו איתו.

בניגוד ל-BiddingStrategy, המשאב הזה כולל אסטרטגיות שבבעלות מנהלי הלקוח ומשותפות עם הלקוח הזה – בנוסף לאסטרטגיות שבבעלות הלקוח הזה. המשאב הזה לא מספק מדדים, והוא חושף רק קבוצת משנה מוגבלת של המאפיינים של שיטת הבידינג.

ייצוג JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

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

string

פלט בלבד. שם המשאב של שיטת הבידינג הנגישה. שמות של משאבים מסוג AccessibleBiddingStrategy:

customers/{customerId}/accessibleBiddingStrategies/{biddingStrategyId}

id

string (int64 format)

פלט בלבד. המזהה של שיטת הבידינג.

name

string

פלט בלבד. השם של שיטת הבידינג.

type

enum (BiddingStrategyType)

פלט בלבד. הסוג של שיטת הבידינג.

ownerCustomerId

string (int64 format)

פלט בלבד. המזהה של הלקוח שבבעלותו אסטרטגיית הבידינג.

ownerDescriptiveName

string

פלט בלבד. כותרת תיאורית של הלקוח שבבעלותו שיטת הבידינג.

שדה איחוד scheme. סכימת הבידינג.

אפשר להגדיר רק אירוע אחד. הערך של scheme יכול להיות רק אחת מהאפשרויות הבאות:

maximizeConversionValue

object (MaximizeConversionValue)

פלט בלבד. שיטת בידינג אוטומטית שעוזרת לכם להשיג את ערך ההמרה הגבוה ביותר מהקמפיינים שלכם במסגרת התקציב.

maximizeConversions

object (MaximizeConversions)

פלט בלבד. שיטת בידינג אוטומטית שיעזרו לכם להשיג כמה שיותר המרות בקמפיינים במסגרת התקציב.

targetCpa

object (TargetCpa)

פלט בלבד. שיטת בידינג שמגדירה הצעות מחיר כדי לעזור לכם להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שהגדרתם.

targetImpressionShare

object (TargetImpressionShare)

פלט בלבד. שיטת בידינג שמבצעת אופטימיזציה באופן אוטומטי להשגת אחוז החשיפות שנבחר.

targetRoas

object (TargetRoas)

פלט בלבד. שיטת בידינג שעוזרת לכם למקסם את ההכנסות תוך עמידה בערך ממוצע של יעד ספציפי של החזר על הוצאות פרסום (ROAS).

targetSpend

object (TargetSpend)

פלט בלבד. שיטת בידינג שמגדירה הצעות מחיר כדי לעזור לכם לקבל כמה שיותר קליקים במסגרת התקציב.

MaximizeConversionValue

שיטת בידינג אוטומטית שעוזרת לכם להשיג את ערך ההמרה הגבוה ביותר מהקמפיינים שלכם במסגרת התקציב.

ייצוג ב-JSON
{
  "targetRoas": number
}
שדות
targetRoas

number

פלט בלבד. האפשרות 'יעד החזר על הוצאות פרסום (ROAS)'. אם המדיניות מוגדרת, שיטת הבידינג תמקסם את ההכנסות תוך עמידה בערך הממוצע של יעד ההחזר על הוצאות הפרסום. אם יעד ההחזר על הוצאות הפרסום גבוה, יכול להיות ששיטת הבידינג לא תוכל למצות את התקציב במלואו. אם לא מגדירים יעד החזר על הוצאות פרסום, שיטת הבידינג תנסה להשיג את ההחזר הגבוה ביותר על הוצאות הפרסום במסגרת התקציב.

MaximizeConversions

שיטת בידינג אוטומטית שיעזרו לכם להשיג כמה שיותר המרות בקמפיינים במסגרת התקציב.

ייצוג ב-JSON
{
  "targetCpaMicros": string
}
שדות
targetCpaMicros

string (int64 format)

פלט בלבד. האפשרות 'יעד עלות להמרה (CPA)'. זהו הסכום הממוצע שברצונך להוציא על כל רכישה.

TargetCpa

זוהי שיטת בידינג אוטומטית שמגדירה הצעות מחיר כדי לעזור לכם להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שהגדרתם.

ייצוג ב-JSON
{
  "targetCpaMicros": string
}
שדות
targetCpaMicros

string (int64 format)

פלט בלבד. יעד עלות ממוצעת להמרה (CPA). היעד הזה צריך להיות גדול או שווה ליחידת החיוב המינימלית, בהתאם למטבע של החשבון.

TargetImpressionShare

שיטת בידינג אוטומטית שמגדירה הצעות מחיר כך שאחוז מסוים של המודעות לרשת החיפוש יוצג בחלק העליון של הדף הראשון (או מיקום מטורגט אחר).

ייצוג ב-JSON
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
שדות
location

enum (TargetImpressionShareLocation)

פלט בלבד. המיקום המטורגט בדף תוצאות החיפוש.

locationFractionMicros

string (int64 format)

החלק שנבחר מתוך המודעות שיוצגו במיקום הגיאוגרפי הגיאוגרפי המטורגט, ב-micros. לדוגמה, 1% שווה ל-10,000.

cpcBidCeilingMicros

string (int64 format)

פלט בלבד. הצעת המחיר המקסימלית לקליק שמערכת הבידינג האוטומטי מורשית לציין. זהו שדה חובה שהמפרסם מזין. השדה קובע את התקרה ומצוין במיקרו-שניות.

TargetRoas

שיטת בידינג אוטומטית שעוזרת לכם למקסם את ההכנסות תוך השגת ממוצע של יעד החזר ספציפי על הוצאות פרסום (ROAS).

ייצוג JSON
{
  "targetRoas": number
}
שדות
targetRoas

number

פלט בלבד. ההכנסה שנבחרה (על סמך נתוני המרות) לכל יחידת הוצאה.

TargetSpend

'מקסימום קליקים' היא שיטת בידינג אוטומטית שמגדירה הצעות מחיר כדי לעזור לכם לקבל כמה שיותר קליקים במסגרת התקציב.

ייצוג ב-JSON
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
שדות
targetSpendMicros
(deprecated)

string (int64 format)

פלט בלבד. יעד ההוצאות במסגרתו יתבצע מיקסום הקליקים. מגיש הצעות מחיר לפי יעד הוצאות ינסה להוציא את הסכום הנמוך מבין הערך הזה או סכום ההוצאה הטבעי לאחר הצמצום. אם לא צוין יעד, המערכת תשתמש בתקציב כיעד ההוצאה. השדה הזה הוצא משימוש ולא צריך להשתמש בו יותר. פרטים נוספים זמינים בכתובת https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html.

cpcBidCeilingMicros

string (int64 format)

פלט בלבד. תקרת הצעות המחיר ששיטת הבידינג יכולה להגדיר. המגבלה חלה על כל מילות המפתח שמנוהלות על ידי השיטה.

CustomerClient

קישור בין הלקוח הנתון ללקוח של לקוח. לקוחות לקוח קיימים רק עבור לקוחות מנהלים. כל הלקוחות הישירים והעקיפים של הלקוח נכללים, וגם חשבון הניהול עצמו.

ייצוג ב-JSON
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב של לקוח הלקוח. שמות משאבי הלקוח מופיעים בפורמט: customers/{customerId}/customerClients/{client_customer_id}

appliedLabels[]

string

פלט בלבד. שמות המשאבים של התוויות בבעלות הלקוח ששלח את הבקשה שחלות על הלקוח של הלקוח. שמות המשאבים של התוויות מופיעים בפורמט הבא:

customers/{customerId}/labels/{label_id}

status

enum (CustomerStatus)

פלט בלבד. הסטטוס של הלקוח/ה. קריאה בלבד.

clientCustomer

string

פלט בלבד. שם המשאב של לקוח הלקוח שמקושר ללקוח הנתון. קריאה בלבד.

hidden

boolean

פלט בלבד. מציינת אם זהו חשבון מוסתר. קריאה בלבד.

level

string (int64 format)

פלט בלבד. המרחק בין הלקוח הנתון ללקוח. בקישור העצמי, ערך הרמה יהיה 0. קריאה בלבד.

timeZone

string

פלט בלבד. ייצוג מחרוזת נפוץ של נתוני מיקום (CLDR) של אזור הזמן של הלקוח, לדוגמה, America/Los_Angeles. קריאה בלבד.

testAccount

boolean

פלט בלבד. מזהה אם הלקוח הוא חשבון בדיקה. קריאה בלבד.

manager

boolean

פלט בלבד. מזהה אם הלקוח הוא מנהל. קריאה בלבד.

descriptiveName

string

פלט בלבד. שם תיאורי של הלקוח. קריאה בלבד.

currencyCode

string

פלט בלבד. קוד המטבע של הלקוח (לדוגמה, 'USD', 'EUR'). קריאה בלבד.

id

string (int64 format)

פלט בלבד. המזהה של הלקוח של הלקוח. קריאה בלבד.

CustomerSearchTermInsight

צפייה במונחי חיפוש של לקוח. הנתונים ההיסטוריים זמינים החל ממרץ 2023.

ייצוג ב-JSON
{
  "resourceName": string,
  "categoryLabel": string,
  "id": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב של התובנה לגבי מונח החיפוש ברמת הלקוח. שמות המשאבים של תובנות לגבי מונחי חיפוש ברמת הלקוח מופיעים בפורמט:

customers/{customerId}/customerSearchTermInsights/{categoryId}

categoryLabel

string

פלט בלבד. התווית של קטגוריית החיפוש. מחרוזת ריקה מציינת את הקטגוריה הכללית של מונחי חיפוש שלא התאימו לקטגוריה אחרת.

id

string (int64 format)

פלט בלבד. המזהה של התובנה.

DetailPlacementView

תצוגה מפורטת עם מדדים שנצברים לפי קבוצת מודעות וכתובת URL או סרטון ב-YouTube.

ייצוג JSON
{
  "resourceName": string,
  "placementType": enum (PlacementType),
  "placement": string,
  "displayName": string,
  "groupPlacementTargetUrl": string,
  "targetUrl": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב בתצוגת הפרטים של מיקום המודעה. שמות משאבים בתצוגת מיקום מפורטים מופיעים בפורמט:

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

placementType

enum (PlacementType)

פלט בלבד. סוג מיקום המודעה, לדוגמה: אתר, סרטון ב-YouTube ואפליקציה לנייד.

placement

string

פלט בלבד. מחרוזת מיקום המודעה האוטומטי ברמת הפירוט, למשל כתובת ה-URL של האתר, מזהה האפליקציה לנייד או מזהה הסרטון ב-YouTube.

displayName

string

פלט בלבד. השם המוצג הוא שם כתובת ה-URL של אתרים, שם הסרטון ב-YouTube לסרטונים ב-YouTube והשם המתורגם של האפליקציה לנייד לאפליקציות לנייד.

groupPlacementTargetUrl

string

פלט בלבד. כתובת ה-URL של מיקום הקבוצה, לדוגמה: דומיין, קישור לאפליקציה לנייד בחנות האפליקציות או כתובת URL של ערוץ YouTube.

targetUrl

string

פלט בלבד. כתובת ה-URL של מיקום המודעה, לדוגמה, אתר, קישור לאפליקציה לנייד בחנות האפליקציות או כתובת URL של סרטון ב-YouTube.

PlacementType

סוגים של מיקומי מודעות אפשריים למיפוי פיד.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
WEBSITE אתרים (לדוגמה, 'www.flowers4sale.com').
MOBILE_APP_CATEGORY קטגוריות של אפליקציות לנייד (לדוגמה, 'משחקים').
MOBILE_APPLICATION אפליקציות לנייד (לדוגמה, 'mobileapp::2-com.whatsthewordanswers').
YOUTUBE_VIDEO סרטוני YouTube (לדוגמה, 'youtube.com/video/wtLJPvx7-ys').
YOUTUBE_CHANNEL ערוצי YouTube (לדוגמה, 'youtube.com::L8ZULXASCc1I_oaOT0NaOQ').
GOOGLE_PRODUCTS פלטפורמות שנמצאות בבעלות ובהפעלה של Google(לדוגמה, 'tv.google.com').

DetailedDemographic

קבוצה דמוגרפית מפורטת: קטגוריה ספציפית המבוססת על תחומי עניין, שנועדה להגיע למשתמשים על סמך מידע לגביהם שנכון לטווח הארוך.

ייצוג JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "parent": string,
  "launchedToAll": boolean,
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ]
}
שדות
resourceName

string

פלט בלבד. שם המשאב של המידע הדמוגרפי המפורט. שמות המשאבים של המידע הדמוגרפי המפורט מופיעים בתבנית:

customers/{customerId}/detailedDemographics/{detailed_demographic_id}

id

string (int64 format)

פלט בלבד. המזהה של המאפיינים הדמוגרפיים המפורטים.

name

string

פלט בלבד. השם של המאפיין הדמוגרפי המפורט. לדוגמה, "רמת ההשכלה הגבוהה ביותר"

parent

string

פלט בלבד. ההורה של המאפיין הדמוגרפי המפורט.

launchedToAll

boolean

פלט בלבד. הערך הוא True אם המידע הדמוגרפי המפורט מושק לכל הערוצים והלוקאלים.

availabilities[]

object (CriterionCategoryAvailability)

פלט בלבד. מידע על זמינות של קבוצה דמוגרפית מפורטת.

CriterionCategoryAvailability

מידע על זמינות של קטגוריות, לפי ערוץ פרסום.

ייצוג JSON
{
  "channel": {
    object (CriterionCategoryChannelAvailability)
  },
  "locale": [
    {
      object (CriterionCategoryLocaleAvailability)
    }
  ]
}
שדות
channel

object (CriterionCategoryChannelAvailability)

סוגי הערוצים וסוגי המשנה שזמינים לקטגוריה.

locale[]

object (CriterionCategoryLocaleAvailability)

אזורי הפעילות שזמינים לקטגוריה של הערוץ.

CriterionCategoryChannelAvailability

מידע על הסוגים ותתי-הסוג של ערוצי הפרסום הזמינים בקטגוריה.

ייצוג JSON
{
  "availabilityMode": enum (CriterionCategoryChannelAvailabilityMode),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": [
    enum (AdvertisingChannelSubType)
  ],
  "includeDefaultChannelSubType": boolean
}
שדות
availabilityMode

enum (CriterionCategoryChannelAvailabilityMode)

הפורמט של זמינות הערוץ. יכול להיות ALL_CHANNELS (שאר השדות לא יוגדרו), CHANNEL_TYPE (רק סוג AdvertisingChannelType יוגדר, הקטגוריה זמינה לכל סוגי המשנה תחתיה) או CHANNEL_TYPE_AND_SUBTYPES (מערכת הפרסום AdvertisingChannelType, AdvertisingChannelSubType ו-includeDefaultChannelSubType יוגדרו).

advertisingChannelType

enum (AdvertisingChannelType)

סוג הערוץ שאליו הקטגוריה זמינה.

advertisingChannelSubType[]

enum (AdvertisingChannelSubType)

סוגי המשנה של הערוץ, לפי סוג הערוץ שאליו הקטגוריה זמינה.

includeDefaultChannelSubType

boolean

האם נכלל סוג משנה של ערוץ שמוגדר כברירת מחדל. לדוגמה, אם הערך של AdvertisingChannelType הוא DISPLAY, והערך של defaultChannelSubType הוא FALSE, המשמעות היא שהקמפיין לרשת המדיה שמוגדר כברירת מחדל, שבו לא הוגדר סוג משנה של ערוץ, לא ייכלל בהגדרת הזמינות הזו.

CriterionCategoryChannelAvailabilityMode

ה-Enum מכיל את הקריטריון הזמין של criteriaCategoryChannelAvailabilityMode.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
ALL_CHANNELS הקטגוריה זמינה לקמפיינים מכל סוגי הערוצים וסוגי המשנה.
CHANNEL_TYPE_AND_ALL_SUBTYPES הקטגוריה זמינה לקמפיינים מסוג ערוץ ספציפי, כולל כל סוגי המשנה שלו.
CHANNEL_TYPE_AND_SUBSET_SUBTYPES הקטגוריה זמינה לקמפיינים מסוג ערוץ ספציפי וסוגי משנה ספציפיים.

CriterionCategoryLocaleAvailability

מידע על המיקומים הגיאוגרפיים שבהם קטגוריה זמינה.

ייצוג ב-JSON
{
  "availabilityMode": enum (CriterionCategoryLocaleAvailabilityMode),
  "countryCode": string,
  "languageCode": string
}
שדות
availabilityMode

enum (CriterionCategoryLocaleAvailabilityMode)

הפורמט של הזמינות של הלוקאל. הערכים האפשריים הם LAUNCHED_TO_ALL (המדינה והשפה יהיו ריקות), COUNTRY (המדינה בלבד תוגדר), LANGUAGE (השפה בלבד תוגדר), COUNTRY_AND_LANGUAGE (המדינה והשפה יהיו מוגדרות).

countryCode

string

קוד המדינה בתקן ISO-3166-1 alpha-2 שמשויך לקטגוריה.

languageCode

string

קוד ISO 639-1 של השפה המשויכת לקטגוריה.

CriterionCategoryLocaleAvailabilityMode

ה-Enum שמכיל את הקריטריון הזמין של criteriaCategoryLocaleAvailabilityMode.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
ALL_LOCALES הקטגוריה זמינה לקמפיינים בכל הלוקאלים.
COUNTRY_AND_ALL_LANGUAGES הקטגוריה זמינה לקמפיינים ברשימה של מדינות, ללא קשר לשפה.
LANGUAGE_AND_ALL_COUNTRIES הקטגוריה זמינה לקמפיינים ברשימה של שפות, ללא קשר למדינה.
COUNTRY_AND_LANGUAGE הקטגוריה זמינה לקמפיינים בתוך רשימה של צמדי מדינות ושפות.

DisplayKeywordView

תצוגה של מילות מפתח לרשת המדיה.

ייצוג ב-JSON
{
  "resourceName": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב בתצוגת מילות המפתח לרשת המדיה. שמות המשאבים של תצוגות של מילות מפתח לרשת המדיה הם בפורמט:

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

DistanceView

תצוגת מרחק עם מדדים שנצברו לפי המרחק של המשתמש מתוספי מיקום של מפרסם. כל קטגוריית מרחק כוללת את כל החשיפות שנמצאות בטווח שלה, וחשיפה אחת תשפיע על המדדים של כל קטגוריות המרחק שכוללות את המרחק של המשתמש.

ייצוג JSON
{
  "resourceName": string,
  "distanceBucket": enum (DistanceBucket),
  "metricSystem": boolean
}
שדות
resourceName

string

פלט בלבד. שם המשאב של תצוגת המרחק. שמות המשאבים בתצוגת המרחק מופיעים בפורמט:

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

distanceBucket

enum (DistanceBucket)

פלט בלבד. קיבוץ של מרחק המשתמש מתוספי מיקום.

metricSystem

boolean

פלט בלבד. הערך הוא True אם קטגוריית המרחק משתמשת במערכת המטרית. אחרת, False.

DistanceBucket

קטגוריית המרחק של המשתמש מתוסף המיקום של המפרסם.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
WITHIN_700M המשתמש היה בטווח של 700 מטר מהמיקום.
WITHIN_1KM המשתמש היה בטווח של 1 ק"מ מהמיקום.
WITHIN_5KM המשתמש היה בטווח של 5 ק"מ מהמיקום.
WITHIN_10KM המשתמש היה בטווח של 10 ק"מ מהמיקום.
WITHIN_15KM המשתמש היה בטווח של 15 ק"מ מהמיקום.
WITHIN_20KM המשתמש היה בטווח של 20 ק"מ מהמיקום.
WITHIN_25KM המשתמש היה בטווח של 25 ק"מ מהמיקום.
WITHIN_30KM המשתמש היה בטווח של 30 ק"מ מהמיקום.
WITHIN_35KM המשתמש היה בטווח של 35 ק"מ מהמיקום.
WITHIN_40KM המשתמש היה בטווח של 40 ק"מ מהמיקום.
WITHIN_45KM המשתמש היה בטווח של 45 ק"מ מהמיקום.
WITHIN_50KM המשתמש היה בטווח של 50 ק"מ מהמיקום.
WITHIN_55KM המשתמש היה בטווח של 55 ק"מ מהמיקום.
WITHIN_60KM המשתמש היה בטווח של 60 ק"מ מהמיקום.
WITHIN_65KM המשתמש היה בטווח של 65 ק"מ מהמיקום.
BEYOND_65KM המשתמש היה במרחק של יותר מ-65 ק"מ מהמיקום.
WITHIN_0_7MILES המשתמש היה בטווח של 1.1 ק"מ מהמיקום.
WITHIN_1MILE המשתמש היה במרחק של קילומטר אחד מהמיקום.
WITHIN_5MILES המשתמש היה בטווח של 8 ק"מ מהמיקום.
WITHIN_10MILES המשתמש היה בטווח של 16 ק"מ מהמיקום.
WITHIN_15MILES המשתמש היה בטווח של 24 ק"מ מהמיקום.
WITHIN_20MILES המשתמש היה בטווח של 32 ק"מ מהמיקום.
WITHIN_25MILES המשתמש היה בטווח של 40 ק"מ מהמיקום.
WITHIN_30MILES המשתמש היה בטווח של 50 ק"מ מהמיקום.
WITHIN_35MILES המשתמש היה בטווח של 56 ק"מ מהמיקום.
WITHIN_40MILES המשתמש היה בטווח של 64 ק"מ מהמיקום.
BEYOND_40MILES המשתמש היה במרחק של יותר מ-64 ק"מ מהמיקום.

DynamicSearchAdsSearchTermView

תצוגת מונחי חיפוש של מודעות דינמיות לרשת החיפוש.

ייצוג ב-JSON
{
  "resourceName": string,
  "searchTerm": string,
  "headline": string,
  "landingPage": string,
  "pageUrl": string,
  "hasNegativeKeyword": boolean,
  "hasMatchingKeyword": boolean,
  "hasNegativeUrl": boolean
}
שדות
resourceName

string

פלט בלבד. שם המשאב של תצוגת מונחי החיפוש של המודעות הדינמיות לרשת החיפוש. שמות משאבים לצפייה במודעות דינמיות לרשת החיפוש מופיעים בפורמט הבא:

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

searchTerm

string

פלט בלבד. מונח חיפוש

השדה הזה הוא לקריאה בלבד.

headline

string

פלט בלבד. הכותרת שנוצרת באופן דינמי של המודעה הדינמית לרשת החיפוש.

השדה הזה הוא לקריאה בלבד.

landingPage

string

פלט בלבד. כתובת דף הנחיתה של החשיפה שנבחרה באופן דינמי.

השדה הזה הוא לקריאה בלבד.

pageUrl

string

פלט בלבד. כתובת ה-URL של פריט בפיד דפי הנחיתה שהוצג בחשיפה.

השדה הזה הוא לקריאה בלבד.

hasNegativeKeyword

boolean

פלט בלבד. הערך True מוחזר אם השאילתה תואמת למילת מפתח שלילית.

השדה הזה הוא לקריאה בלבד.

hasMatchingKeyword

boolean

פלט בלבד. הערך יהיה True אם השאילתה מתווספת למילות מפתח מטורגטות.

השדה הזה הוא לקריאה בלבד.

hasNegativeUrl

boolean

פלט בלבד. הערך יהיה True אם השאילתה תואמת לכתובת URL שלילית.

השדה הזה הוא לקריאה בלבד.

ExpandedLandingPageView

תצוגה של דף נחיתה עם מדדים שנצברו ברמת כתובת ה-URL הסופית המורחבת.

ייצוג ב-JSON
{
  "resourceName": string,
  "expandedFinalUrl": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב של תצוגת דף הנחיתה המורחב. שמות המשאבים בתצוגה של דף הנחיתה המורחב הם בפורמט:

customers/{customerId}/expandedLandingPageViews/{expanded_final_url_fingerprint}

expandedFinalUrl

string

פלט בלבד. כתובת ה-URL הסופית שאליה מופנים הקליקים.

FeedPlaceholderView

תצוגת placeholder של פיד.

ייצוג JSON
{
  "resourceName": string,
  "placeholderType": enum (PlaceholderType)
}
שדות
resourceName

string

פלט בלבד. שם המשאב בתצוגת ה-placeholder של הפיד. שמות משאבים לתצוגת placeholder של פיד מופיעים בצורה הבאה:

customers/{customerId}/feedPlaceholderViews/{placeholderType}

placeholderType

enum (PlaceholderType)

פלט בלבד. סוג ה-placeholder של תצוגת ה-placeholder של הפיד.

GenderView

תצוגת מגדר המשאב genderView משקף את מצב ההצגה בפועל, ולא את הקריטריונים שנוספו. כברירת מחדל, קבוצת מודעות ללא קריטריונים של מגדר מוצגת לכל המגדרים, כך שכל המגדרים מופיעים בתצוגת מגדר עם נתונים סטטיסטיים.

ייצוג ב-JSON
{
  "resourceName": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב של תצוגת המגדר. שמות המשאבים בתצוגת המגדר מופיעים בפורמט:

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

GeographicView

תצוגה גיאוגרפית.

תצוגה גיאוגרפית כוללת את כל המדדים המצטברים ברמת המדינה, שורה אחת לכל מדינה. המערכת מדווחת על מדדים במיקום הפיזי של המשתמש בפועל או באזור עניין. אם נעשה שימוש בשדות אחרים של פלחים, יכול להיות שיופיעו יותר משורה אחת לכל מדינה.

ייצוג ב-JSON
{
  "resourceName": string,
  "locationType": enum (GeoTargetingType),
  "countryCriterionId": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב של התצוגה הגיאוגרפית. שמות משאבים בתצוגה גיאוגרפית מופיעים בתבנית:

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

locationType

enum (GeoTargetingType)

פלט בלבד. סוג הטירגוט הגיאוגרפי של הקמפיין.

countryCriterionId

string (int64 format)

פלט בלבד. מזהה קריטריון למדינה.

GeoTargetingType

הסוגים האפשריים של טירגוט גיאוגרפי.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא ידוע בגרסה הזו.
AREA_OF_INTEREST המיקום שהמשתמש מעוניין בו בזמן ביצוע השאילתה.
LOCATION_OF_PRESENCE המיקום של המשתמש שהפעיל את השאילתה.

GroupPlacementView

תצוגה של מיקומי מודעות בקבוצה.

ייצוג ב-JSON
{
  "resourceName": string,
  "placementType": enum (PlacementType),
  "placement": string,
  "displayName": string,
  "targetUrl": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב בתצוגת מיקומי המודעות של הקבוצה. שמות משאבים לתצוגת מיקומי מודעות קבוצתיים מופיעים בפורמט:

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

placementType

enum (PlacementType)

פלט בלבד. הסוג של מיקום המודעה, לדוגמה: אתר, ערוץ YouTube, אפליקציה לנייד.

placement

string

פלט בלבד. מחרוזת המיקום האוטומטי ברמת הקבוצה, למשל, דומיין אינטרנט, מזהה אפליקציה לנייד או מזהה ערוץ YouTube.

displayName

string

פלט בלבד. שם הדומיין לאתרים ושם ערוץ YouTube לערוצי YouTube.

targetUrl

string

פלט בלבד. כתובת ה-URL של מיקום המודעה הקבוצתי, למשל דומיין, קישור לאפליקציה לנייד בחנות האפליקציות או כתובת URL של ערוץ YouTube.

HotelGroupView

תצוגה של קבוצת מלונות

ייצוג ב-JSON
{
  "resourceName": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב בתצוגה של קבוצת המלונות. שמות המשאבים בתצוגה של קבוצת המלונות בפורמט:

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

HotelPerformanceView

תצוגה של נתוני הביצועים של המלון.

ייצוג JSON
{
  "resourceName": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב בתצוגת הביצועים של המלון. שמות המשאבים בתצוגת ביצועי המלון הם בפורמט:

customers/{customerId}/hotelPerformanceView

HotelReconciliation

התאמה של מלון. הדוח כולל פרטי המרות מהזמנות של מלונות כדי להתאים אותם לרשומות של המפרסם. יכול להיות שהשורות האלה יעודכנו או יבוטלו לפני החיוב באמצעות 'העלאות בכמות גדולה'.

ייצוג JSON
{
  "resourceName": string,
  "commissionId": string,
  "orderId": string,
  "campaign": string,
  "hotelCenterId": string,
  "hotelId": string,
  "checkInDate": string,
  "checkOutDate": string,
  "reconciledValueMicros": string,
  "billed": boolean,
  "status": enum (HotelReconciliationStatus)
}
שדות
resourceName

string

בלתי ניתן לשינוי. שם המשאב של התאמת המלון. שמות המשאבים של התאמת המלונות מופיעים בפורמט:

customers/{customerId}/hotelReconciliations/{commissionId}

commissionId

string

חובה. פלט בלבד. מזהה העמלה הוא המזהה של Google להזמנה הזו. לכל אירוע הזמנה מוקצה מזהה עמלה שיעזור לכם לשייך אותו לשהות של אורח.

orderId

string

פלט בלבד. מזהה ההזמנה הוא המזהה של ההזמנה הזו, כפי שהוא מופיע בפרמטר 'transaction_id' שבתג מעקב ההמרות.

campaign

string

פלט בלבד. שם המשאב של הקמפיין שמשויך להמרה.

hotelCenterId

string (int64 format)

פלט בלבד. מזהה של חשבון Hotel Center שמספק את התעריפים לקמפיין לקידום מלון.

hotelId

string

פלט בלבד. מזהה ייחודי של הנכס שהוזמן, כפי שצוין בפיד של Hotel Center. מזהה המלון מגיע מהפרמטר ID (מזהה) של תג מעקב ההמרות.

checkInDate

string

פלט בלבד. תאריך הצ'ק-אין מתועד בעת ביצוע ההזמנה. אם תאריך הצ'ק-אין ישתנה בעת ההתאמה, התאריך המתוקן יחליף את התאריך המקורי בעמודה הזו. הפורמט הוא YYYY-MM-DD.

checkOutDate

string

פלט בלבד. תאריך הצ'ק אאוט מתועד בעת ביצוע ההזמנה. אם תאריך הצ'ק-אין ישתנה בעת ההתאמה, התאריך המתוקן יחליף את התאריך המקורי בעמודה הזו. הפורמט הוא YYYY-MM-DD.

reconciledValueMicros

string (int64 format)

חובה. פלט בלבד. ערך מותאם הוא הערך הסופי של הזמנה כפי ששולמה על ידי האורח. אם ערך ההזמנה המקורי משתנה מסיבה כלשהי, כמו שינויים במסלול הנסיעה או מכירת מוצרים או שירותים נוספים עם החדרים, הערך המותאם צריך להיות הסכום הסופי שייגבה. אם ההזמנה בוטלה, הערך המותאם צריך לכלול את הערך של דמי הביטול או של הלילות שלא ניתן לקבל עליהם החזר. הערך הוא במיליוניות של מטבע יחידת הבסיס. לדוגמה, $12.35 מיוצגים כ-12350000. יחידת המטבע היא במטבע ברירת המחדל של הלקוח.

billed

boolean

פלט בלבד. האם חויבה הזמנה מסוימת. לאחר החיוב, לא ניתן לשנות את ההזמנה.

status

enum (HotelReconciliationStatus)

חובה. פלט בלבד. הסטטוס הנוכחי של ההזמנה, בנוגע להתאמות וחיובים. יש להתאים את ההזמנות תוך 45 ימים מתאריך הצ'ק-אאוט. כל הזמנה שלא הותאמה תוך 45 ימים תחויב בערך המקורי שלה.

HotelReconciliationStatus

הסטטוס של התאמת ההזמנה במלון.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא מוכר בגרסה הזו.
RESERVATION_ENABLED תאריך ההזמנות חל בעתיד, או שהשהייה בעיצומה אבל תאריך הצ'ק-אאוט עדיין לא עבר. לא ניתן להתאים הזמנה פעילה.
RECONCILIATION_NEEDED הצ'ק-אאוט בוצע, או שהתאריכים שהוזמנו עברו ללא ביטול. החיוב על הזמנות שלא הותאמו תוך 45 ימים מתאריך הצ'ק-אאוט מבוסס על מחיר ההזמנה המקורי.
RECONCILED ההזמנות האלה הותאמו. החיוב על הזמנות שהותאמו מתבצע 45 ימים אחרי תאריך הצ'ק-אאוט.
CANCELED ההזמנה הזו סומנה כמבוטלת. החיוב על שהיות שבוטלו עם ערך הגדול מאפס (עקב כללים לגבי משך שהייה מינימלי או עמלות ביטול) מתבצע 45 ימים אחרי תאריך הצ'ק-אאוט.

IncomeRangeView

תצוגה של טווח הכנסה

ייצוג JSON
{
  "resourceName": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב של תצוגת טווח ההכנסות. שמות המשאבים בתצוגת טווח ההכנסות הם בפורמט:

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

KeywordView

תצוגה של מילות מפתח.

ייצוג ב-JSON
{
  "resourceName": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב של תצוגת מילות המפתח. שמות המשאבים של תצוגות מילות המפתח מופיעים בתבנית:

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

LandingPageView

צפייה בדף נחיתה עם מדדים שנצברו ברמת כתובת ה-URL הסופית שלא הורחבה.

ייצוג ב-JSON
{
  "resourceName": string,
  "unexpandedFinalUrl": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב של תצוגת דף הנחיתה. שמות המשאבים בתצוגת דף הנחיתה הם בפורמט:

customers/{customerId}/landingPageViews/{unexpanded_final_url_fingerprint}

unexpandedFinalUrl

string

פלט בלבד. כתובת ה-URL הסופית שצוינה על ידי המפרסם.

LanguageConstant

שפה.

ייצוג ב-JSON
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
שדות
resourceName

string

פלט בלבד. שם המשאב של קבוע השפה. שמות משאבים קבועים של שפה מופיעים בתבנית:

languageConstants/{criterionId}

id

string (int64 format)

פלט בלבד. המזהה של קבוע השפה.

code

string

פלט בלבד. קוד השפה, לדוגמה, "en_US" , "en_AU" , "es" , "fr" וכו'.

name

string

פלט בלבד. השם המלא של השפה באנגלית, למשל, 'English (US)', 'Spanish' וכו'.

targetable

boolean

פלט בלבד. אם אפשר לטרגט לפי השפה.

LocationView

בתצוגה לפי מיקום מוצג סיכום של ביצועי הקמפיינים לפי קריטריון מיקום. אם לא הוגדר קריטריון של מיקום, לא מוחזרות תוצאות. במקום זאת, יש להשתמש ב-GeoView או ב-userLocationView של נתוני המיקום של המבקרים.

ייצוג JSON
{
  "resourceName": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב של תצוגת המיקום. שמות המשאבים בתצוגת המיקום מופיעים בפורמט:

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

ManagedPlacementView

תצוגה של מיקומי מודעות מנוהלים.

ייצוג ב-JSON
{
  "resourceName": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב בתצוגה של מיקומי מודעות מנוהלים. שמות משאבים בתצוגה של מיקומי מודעות מנוהלים מופיעים בתבנית:

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

MediaFile

קובץ מדיה.

ייצוג ב-JSON
{
  "resourceName": string,
  "type": enum (MediaType),
  "mimeType": enum (MimeType),
  "id": string,
  "sourceUrl": string,
  "name": string,
  "fileSize": string,

  // Union field mediatype can be only one of the following:
  "image": {
    object (MediaImage)
  },
  "mediaBundle": {
    object (MediaBundle)
  },
  "audio": {
    object (MediaAudio)
  },
  "video": {
    object (MediaVideo)
  }
  // End of list of possible types for union field mediatype.
}
שדות
resourceName

string

בלתי ניתן לשינוי. שם המשאב של קובץ המדיה. שמות המשאבים של קובצי המדיה הם בפורמט:

customers/{customerId}/mediaFiles/{media_file_id}

type

enum (MediaType)

בלתי ניתן לשינוי. הסוג של קובץ המדיה.

mimeType

enum (MimeType)

פלט בלבד. סוג ה-MIME של קובץ המדיה.

id

string (int64 format)

פלט בלבד. המזהה של קובץ המדיה.

sourceUrl

string

בלתי ניתן לשינוי. כתובת ה-URL של המקום שממנו הורדתם את קובץ המדיה המקורי (או שם הקובץ). משמש רק למדיה מסוג AUDIO ו-IMAGE.

name

string

קבוע. השם של קובץ המדיה. הלקוחות יכולים להשתמש בשם כדי לזהות מדיה שהועלו בעבר.

fileSize

string (int64 format)

פלט בלבד. הגודל של קובץ המדיה בבייטים.

שדה איחוד mediatype. הסוג הספציפי של קובץ המדיה. mediatype יכול להיות רק אחת מהאפשרויות הבאות:
image

object (MediaImage)

בלתי ניתן לשינוי. כוללת תמונה.

mediaBundle

object (MediaBundle)

בלתי ניתן לשינוי. קובץ מדיה בארכיון ZIP שהתוכן שלו מכיל נכסי HTML5.

audio

object (MediaAudio)

פלט בלבד. כולל אודיו.

video

object (MediaVideo)

בלתי ניתן לשינוי. רכיב שמכיל סרטון.

MediaType

סוג המדיה.

טיפוסים בני מנייה (enum)
UNSPECIFIED סוג המדיה לא צוין.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתשובה בלבד.

IMAGE תמונה סטטית, המשמשת למודעת תמונה.
ICON תמונה קטנה, המשמשת במודעה במפה.
MEDIA_BUNDLE ZIP, משמש בשדות של מודעות התבנית.
AUDIO קובץ אודיו.
VIDEO קובץ וידאו
DYNAMIC_IMAGE תמונה שמכילה אנימציה, כמו קובץ GIF מונפש.

MediaImage

כוללת תמונה.

ייצוג ב-JSON
{
  "data": string,
  "fullSizeImageUrl": string,
  "previewSizeImageUrl": string
}
שדות
data

string (bytes format)

קבוע. נתוני תמונה גולמיים.

מחרוזת בקידוד Base64.

fullSizeImageUrl

string

פלט בלבד. כתובת ה-URL של גרסה בגודל מלא של התמונה.

previewSizeImageUrl

string

פלט בלבד. כתובת ה-URL לגרסה בגודל התצוגה המקדימה של התמונה.

MediaBundle

מייצג מדיה בארכיון ZIP שהתוכן שלה מכיל נכסי HTML5.

ייצוג ב-JSON
{
  "data": string,
  "url": string
}
שדות
data

string (bytes format)

קבוע. נתונים גולמיים מכווצים (ZIP).

מחרוזת בקידוד base64.

url

string

פלט בלבד. כתובת ה-URL לגישה לנתונים הדחוסים שהועלו. לדוגמה, https://tpc.googlesyndication.com/simgad/123 השדה הזה הוא לקריאה בלבד.

MediaAudio

כולל אודיו.

ייצוג ב-JSON
{
  "adDurationMillis": string
}
שדות
adDurationMillis

string (int64 format)

פלט בלבד. משך הזמן של האודיו באלפיות השנייה.

MediaVideo

רכיב שמכיל סרטון.

ייצוג ב-JSON
{
  "adDurationMillis": string,
  "youtubeVideoId": string,
  "advertisingIdCode": string,
  "isciCode": string
}
שדות
adDurationMillis

string (int64 format)

פלט בלבד. משך הזמן של הסרטון באלפיות השנייה.

youtubeVideoId

string

קבוע. מזהה הווידאו ב-YouTube (כפי שהוא מופיע בכתובות URL ב-YouTube). הוספת הקידומת 'https://www.youtube.com/watch?v=" למזהה הזה תספק את כתובת ה-URL של הסטרימינג ב-YouTube לסרטון הזה.

advertisingIdCode

string

פלט בלבד. הקוד לזיהוי דיגיטלי לצורכי פרסום של הסרטון הזה, כפי שהוגדר על ידי האגודה האמריקאית של סוכנויות הפרסום, משמש בעיקר לפרסומות בטלוויזיה.

isciCode

string

פלט בלבד. קוד המזהה המסחרי המקובל בתחום לסרטון זה, המשמש בעיקר לפרסומות בטלוויזיה.

LocalServicesEmployee

משאב עובדים של שירותים מקומיים.

ייצוג ב-JSON
{
  "resourceName": string,
  "creationDateTime": string,
  "status": enum (LocalServicesEmployeeStatus),
  "type": enum (LocalServicesEmployeeType),
  "universityDegrees": [
    {
      object (UniversityDegree)
    }
  ],
  "residencies": [
    {
      object (Residency)
    }
  ],
  "fellowships": [
    {
      object (Fellowship)
    }
  ],
  "languagesSpoken": [
    string
  ],
  "categoryIds": [
    string
  ],
  "id": string,
  "jobTitle": string,
  "yearStartedPracticing": integer,
  "nationalProviderIdNumber": string,
  "emailAddress": string,
  "firstName": string,
  "middleName": string,
  "lastName": string
}
שדות
resourceName

string

קבוע. שם המשאב בתהליך האימות ב-'Google בעלי מקצוע'. שמות המשאבים לאימות ב-'Google בעלי מקצוע' מופיעים בפורמט הבא:

customers/{customerId}/localServicesEmployees/{gls_employee_id}

creationDateTime

string

פלט בלבד. חותמת הזמן של יצירת העובד. הפורמט הוא 'YYYY-MM-DD HH:MM:SS' באזור הזמן של חשבון Google Ads. דוגמאות: ‎"2018-03-05 09:15:00" או "2018-02-01 14:34:30"‎

status

enum (LocalServicesEmployeeStatus)

פלט בלבד. סטטוס העובד, למשל 'נמחק' או 'מופעל'.

type

enum (LocalServicesEmployeeType)

פלט בלבד. סוג העובד.

universityDegrees[]

object (UniversityDegree)

פלט בלבד. רשימה של התארים שהעובד קיבל והוא רוצה להציג.

residencies[]

object (Residency)

פלט בלבד. המוסדות שבהם העובד השלים את התושבות שלו.

fellowships[]

object (Fellowship)

פלט בלבד. המוסדות שבהם העובד השלים את עבודתו.

languagesSpoken[]

string

פלט בלבד. השפות שהעובד מדבר, מיוצגות כתגי שפה מהכתובת https://developers.google.com/admin-sdk/directory/v1/languages.

categoryIds[]

string

פלט בלבד. הקטגוריה של העובד. רשימה של מזהי קטגוריות של 'Google בעלי מקצוע' זמינה בכתובת https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids.

id

string (int64 format)

פלט בלבד. המזהה של העובד.

jobTitle

string

פלט בלבד. התפקיד של העובד הזה, למשל "שותף בכיר" בענפים משפטיים.

yearStartedPracticing

integer

פלט בלבד. השנה שבה העובד התחיל לעבוד בתחום הזה.

nationalProviderIdNumber

string

פלט בלבד. מזהה NPI שמשויך לעובד.

emailAddress

string

פלט בלבד. כתובת האימייל של העובד.

firstName

string

פלט בלבד. השם הפרטי של העובד.

middleName

string

פלט בלבד. השם האמצעי של העובד.

lastName

string

פלט בלבד. שם המשפחה של העובד.

LocalServicesEmployeeStatus

ערכים שמתארים סטטוסים של עובדים בשירותים מקומיים.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
ENABLED לא נסיר את העובד והסטטוס שלו יהיה פעיל.
REMOVED העובד הוסר. משמש למחיקה של עובד מהעסק.

LocalServicesEmployeeType

דוגמאות שמתארות סוגים של עובדים בשירותים מקומיים.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
BUSINESS_OWNER מייצג את הבעלים של העסק.
EMPLOYEE מייצג עובד של העסק.

UniversityDegree

רשימת תארים שהעובד הזה קיבל והוא רוצה ללמוד בו.

ייצוג JSON
{
  "institutionName": string,
  "degree": string,
  "graduationYear": integer
}
שדות
institutionName

string

פלט בלבד. שם האוניברסיטה שבה התקבל התואר.

degree

string

פלט בלבד. השם של התואר שקיבלת.

graduationYear

integer

פלט בלבד. שנת סיום לימודים.

תושבות

פרטים לגבי התושבות הרפואית של העובד. התמחות היא שלב בהכשרה הרפואית של בוגרי תואר שני, שבו איש מקצוע מוסמך מתחום הרפואה מתאמן בפיקוח של רופא בכיר.

ייצוג JSON
{
  "institutionName": string,
  "completionYear": integer
}
שדות
institutionName

string

פלט בלבד. שם המוסד שבו הושלמה התושבות.

completionYear

integer

פלט בלבד. שנת ההשלמה.

שותפות

פרטים על האגודה הרפואית של העובד. תקופת התמחות היא תקופת הכשרה רפואית שרופאים עוברים אחרי סיום התמחותם.

ייצוג ב-JSON
{
  "institutionName": string,
  "completionYear": integer
}
שדות
institutionName

string

פלט בלבד. שם הסוכנות שבה הושלמה השותפות.

completionYear

integer

פלט בלבד. שנת ההשלמה.

LocalServicesVerificationArtifact

משאב לאימות עסקים ב-'Google בעלי מקצוע'.

ייצוג JSON
{
  "resourceName": string,
  "creationDateTime": string,
  "status": enum (LocalServicesVerificationArtifactStatus),
  "artifactType": enum (LocalServicesVerificationArtifactType),
  "id": string,

  // Union field artifact_data can be only one of the following:
  "backgroundCheckVerificationArtifact": {
    object (BackgroundCheckVerificationArtifact)
  },
  "insuranceVerificationArtifact": {
    object (InsuranceVerificationArtifact)
  },
  "licenseVerificationArtifact": {
    object (LicenseVerificationArtifact)
  },
  "businessRegistrationCheckVerificationArtifact": {
    object (BusinessRegistrationCheckVerificationArtifact)
  }
  // End of list of possible types for union field artifact_data.
}
שדות
resourceName

string

קבוע. שם המשאב בתהליך האימות ב-'Google בעלי מקצוע'. שמות המשאבים לאימות ב-'Google בעלי מקצוע' מופיעים בפורמט הבא:

customers/{customerId}/localServicesVerificationArtifacts/{verification_artifact_id}

creationDateTime

string

פלט בלבד. חותמת הזמן שבה נוצר פריט האימות הזה. הפורמט הוא 'YYYY-MM-DD HH:MM:SS' באזור הזמן של חשבון Google Ads. דוגמאות: ‎"2018-03-05 09:15:00" או "2018-02-01 14:34:30"‎

status

enum (LocalServicesVerificationArtifactStatus)

פלט בלבד. הסטטוס של פריט האימות.

artifactType

enum (LocalServicesVerificationArtifactType)

פלט בלבד. הסוג של פריט המידע שנוצר בתהליך פיתוח (Artifact) לאימות.

id

string (int64 format)

פלט בלבד. המזהה של פריט המידע שנוצר בתהליך האימות (Artifact).

שדה איחוד artifact_data. סוגי פרטי האימות. השדה artifact_data יכול להיות רק אחד מהערכים הבאים:
backgroundCheckVerificationArtifact

object (BackgroundCheckVerificationArtifact)

פלט בלבד. ארטיפקט של אימות בדיקת רקע.

insuranceVerificationArtifact

object (InsuranceVerificationArtifact)

פלט בלבד. ארטיפקט של אימות ביטוח.

licenseVerificationArtifact

object (LicenseVerificationArtifact)

פלט בלבד. ארטיפקט לאימות רישיון.

businessRegistrationCheckVerificationArtifact

object (BusinessRegistrationCheckVerificationArtifact)

פלט בלבד. ארטיפקט לאימות של בדיקת רישום עסק.

LocalServicesVerificationArtifactStatus

ערכים שמתארים סטטוסים של פריט מידע שנוצר בתהליך האימות ב-'Google בעלי מקצוע'

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
PASSED פריט המידע שנוצר בתהליך הפיתוח (Artifact) עבר את האימות.
FAILED האימות של פריט המידע שנוצר בתהליך הפיתוח (Artifact) נכשל.
PENDING פריט המידע שנוצר בתהליך הפיתוח (Artifact) נמצא בתהליך אימות.
NO_SUBMISSION לפני האימות ב-Artifact, המשתמש צריך להעלות מידע.
CANCELLED פריט המידע שנוצר בתהליך הפיתוח (Artifact) בוטל על ידי המשתמש.

LocalServicesVerificationArtifactType

דוגמאות שמתארות סוגים אפשריים של פריט מידע שנוצר בתהליך האימות ב-'Google בעלי מקצוע'.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
BACKGROUND_CHECK פריט מידע שנוצר בתהליך האימות (Artifact) של בדיקת הרקע.
INSURANCE ארטיפקט של אימות ביטוח.
LICENSE פריט מידע שנוצר בתהליך אימות הרישיון.
BUSINESS_REGISTRATION_CHECK ארטיפקט לאימות של בדיקת רישום העסק.

BackgroundCheckVerificationArtifact

פרוטו שמכיל מידע ספציפי לבדיקת הרקע של 'Google בעלי מקצוע'.

ייצוג JSON
{
  "caseUrl": string,
  "finalAdjudicationDateTime": string
}
שדות
caseUrl

string

פלט בלבד. כתובת URL לגישה לאותיות ברקע.

finalAdjudicationDateTime

string

פלט בלבד. חותמת הזמן של מועד ההחלטה על תוצאת בדיקת הרקע. הפורמט הוא 'YYYY-MM-DD HH:MM:SS' באזור הזמן של חשבון Google Ads. לדוגמה: '2018-03-05 09:15:00' או '2018-02-01 14:34:30'

InsuranceVerificationArtifact

אב שמורשה מידע ספציפי לביטוח של 'Google בעלי מקצוע'.

ייצוג ב-JSON
{
  "amountMicros": string,
  "rejectionReason": enum (LocalServicesInsuranceRejectionReason),
  "insuranceDocumentReadonly": {
    object (LocalServicesDocumentReadOnly)
  }
}
שדות
amountMicros

string (int64 format)

פלט בלבד. סכום הביטוח. ההפרש נמדד ב'מיקרו' של המטבע שמוזכר במסמך הביטוח.

rejectionReason

enum (LocalServicesInsuranceRejectionReason)

פלט בלבד. הסיבה לדחייה של מסמך הביטוח.

insuranceDocumentReadonly

object (LocalServicesDocumentReadOnly)

פלט בלבד. השדה לקריאה בלבד שמכיל את המידע של מסמך הביטוח שהועלה.

LocalServicesInsuranceRejectionReason

דוגמאות שמתארות סיבות אפשריות לדחייה של פריט מידע שנוצר בתהליך אימות של ביטוח שירותים מקומיים.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
BUSINESS_NAME_MISMATCH שם העסק לא תואם לשם העסק שצוין במודעה של 'Google בעלי מקצוע'.
INSURANCE_AMOUNT_INSUFFICIENT סכום הביטוח לא עומד בדרישות המפורטות במסמכים של הסיכומים המשפטיים לגבי השילוב הגיאוגרפי ומזהה הקטגוריה.
EXPIRED תוקף מסמך הביטוח פג.
NO_SIGNATURE חסרה חתימה במסמך הביטוח.
NO_POLICY_NUMBER במסמך הביטוח חסר מספר פוליסה.
NO_COMMERCIAL_GENERAL_LIABILITY התיבה 'ביטוח אחריות כללית מסחרי (CGL)' לא מסומנת במסמך הביטוח.
EDITABLE_FORMAT מסמך הביטוח הוא בפורמט שניתן לעריכה.
CATEGORY_MISMATCH מסמך הביטוח לא מכסה ביטוח בקטגוריה מסוימת.
MISSING_EXPIRATION_DATE במסמך הביטוח חסר תאריך תפוגה.
POOR_QUALITY איכות המסמך הביטוח נמוכה – תמונות מטושטשות, טקסט בלתי קריא וכו'
POTENTIALLY_EDITED יש חשד שמסמך הביטוח נערך.
WRONG_DOCUMENT_TYPE מסמך הביטוח לא קביל. לדוגמה, מסמכים של הצעות ביטוח, אבל כיסויים חסרים, לא יתקבלו.
NON_FINAL מסמך הביטוח לא סופי.
OTHER יש פגם אחר במסמך הביטוח שלא צוין במפורש.

LocalServicesDocumentReadOnly

מסמך של 'Google בעלי מקצוע' עם נתונים שנגישים לקריאה בלבד.

ייצוג JSON
{
  "documentUrl": string
}
שדות
documentUrl

string

כתובת URL לגישה למסמך שכבר הועלה ל-Local Services.

LicenseVerificationArtifact

אב שמורשה מידע ספציפי לרישיון 'Google בעלי מקצוע'.

ייצוג ב-JSON
{
  "licenseType": string,
  "licenseNumber": string,
  "licenseeFirstName": string,
  "licenseeLastName": string,
  "rejectionReason": enum (LocalServicesLicenseRejectionReason),
  "licenseDocumentReadonly": {
    object (LocalServicesDocumentReadOnly)
  }
}
שדות
licenseType

string

פלט בלבד. סוג / שם רישיון.

licenseNumber

string

פלט בלבד. מספר הרישיון.

licenseeFirstName

string

פלט בלבד. השם הפרטי של בעל הרישיון.

licenseeLastName

string

פלט בלבד. שם המשפחה של בעל הרישיון.

rejectionReason

enum (LocalServicesLicenseRejectionReason)

פלט בלבד. הסיבה לדחיית הרישיון.

licenseDocumentReadonly

object (LocalServicesDocumentReadOnly)

פלט בלבד. השדה לקריאה בלבד שמכיל את המידע של מסמך הרישיון שהועלף.

LocalServicesLicenseRejectionReason

דוגמאות שמתארות סיבות אפשריות לדחייה של פריט מידע שנוצר בתהליך אימות של רישיון לשירותים מקומיים.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
BUSINESS_NAME_MISMATCH שם העסק לא תואם לשם העסק שצוין במודעה של 'Google בעלי מקצוע'.
UNAUTHORIZED הרישיון לא מורשה או שהוא בוטל.
EXPIRED פג תוקף הרישיון.
POOR_QUALITY License is poor quality - blurry images, illegible, etc...
UNVERIFIABLE אי אפשר לאמת את הרישיון כי התמונה לא תקינה.
WRONG_DOCUMENT_OR_ID הרישיון הוא לא סוג המסמך המבוקש או שהוא מכיל תעודה מזהה לא חוקית.
OTHER יש פגם אחר שלא צוין במפורש ברישיון.

BusinessRegistrationCheckVerificationArtifact

אב שמורשה מידע ספציפי לגבי בדיקת רישום עסק לשירותים מקומיים.

ייצוג ב-JSON
{
  "registrationType": enum (LocalServicesBusinessRegistrationType),
  "checkId": string,
  "rejectionReason": enum (LocalServicesBusinessRegistrationCheckRejectionReason),

  // Union field business_registration can be only one of the following:
  "registrationNumber": {
    object (BusinessRegistrationNumber)
  },
  "registrationDocument": {
    object (BusinessRegistrationDocument)
  }
  // End of list of possible types for union field business_registration.
}
שדות
registrationType

enum (LocalServicesBusinessRegistrationType)

פלט בלבד. סוג הבדיקה של רישום העסק (מספר, מסמך).

checkId

string

פלט בלבד. מזהה הבדיקה, כמו vat_tax_id, שמייצג את הדרישה ל'מזהה מס מע"מ'.

rejectionReason

enum (LocalServicesBusinessRegistrationCheckRejectionReason)

פלט בלבד. הסיבה לדחייה של מסמך הרישום.

שדה האיחוד business_registration. פרטי הרישום של העסק. הטופס יהיה אחד מהטפסים הבאים, בהתאם לדרישה ממדינות שונות. הערך של business_registration יכול להיות רק אחת מהאפשרויות הבאות:
registrationNumber

object (BusinessRegistrationNumber)

פלט בלבד. הודעת שמכילה את המספר הרשמי של העסק.

registrationDocument

object (BusinessRegistrationDocument)

פלט בלבד. הודעה שכוללת את פרטי המסמך של העסק.

LocalServicesBusinessRegistrationType

דוגמאות שמתארות סוגים אפשריים של רישום של פריט מידע שנוצר בתהליך האימות (IDV) של בדיקת רישום עסק שירותים מקומיים.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
NUMBER סוג בדיקה של מספר רישום.
DOCUMENT סוג הבדיקה של מסמך הרישום.

LocalServicesBusinessRegistrationCheckRejectionReason

ערכים מוגדרים מראש שמתארים סיבות אפשריות לדחייה של ארטיפקט אימות של בדיקת רישום עסק ב-Local Services.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
BUSINESS_NAME_MISMATCH שם העסק לא תואם לשם העסק שצוין במודעה של 'Google בעלי מקצוע'.
BUSINESS_DETAILS_MISMATCH אי-התאמה בין פרטי העסק.
ID_NOT_FOUND מזהה הרישום של העסק לא נמצא.
POOR_DOCUMENT_IMAGE_QUALITY המסמך שהועלה לא ברור, מטושטש וכו'.
DOCUMENT_EXPIRED פג התוקף של המסמך שהועלה.
DOCUMENT_INVALID המסמך בוטל או בוטל.
DOCUMENT_TYPE_MISMATCH אי-התאמה בסוג המסמך.
DOCUMENT_UNVERIFIABLE לא ניתן לאמת את המסמך שהועלה כמסמך לגיטימי.
OTHER לא ניתן היה להשלים את תהליך רישום העסק בגלל בעיה. מידע נוסף זמין בכתובת https://support.google.com/localservices.

BusinessRegistrationNumber

אב שמורשה מידע ספציפי לגבי מספר רישום של עסק לשירותים מקומיים.

ייצוג JSON
{
  "number": string
}
שדות
number

string

פלט בלבד. מספר עסקי שהונפק על ידי רשות ממשלתית.

BusinessRegistrationDocument

פרוטו שמכיל מידע ספציפי למסמך רישום של עסק מקומי.

ייצוג ב-JSON
{
  "documentReadonly": {
    object (LocalServicesDocumentReadOnly)
  }
}
שדות
documentReadonly

object (LocalServicesDocumentReadOnly)

פלט בלבד. השדה לקריאה בלבד שמכיל את המידע של מסמך רישום העסק שהועלה.

MobileAppCategoryConstant

קבוע של קטגוריית אפליקציה לנייד.

ייצוג ב-JSON
{
  "resourceName": string,
  "id": integer,
  "name": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב של הקבוע של קטגוריית האפליקציות לנייד. שמות קבועים של משאבים בקטגוריית אפליקציה לנייד נראים כך:

mobileAppCategoryConstants/{mobile_app_category_id}

id

integer

פלט בלבד. המזהה של קבוע הקטגוריה של אפליקציות לנייד.

name

string

פלט בלבד. שם הקטגוריה של האפליקציה לנייד.

MobileDeviceConstant

קבוע של מכשיר נייד.

ייצוג ב-JSON
{
  "resourceName": string,
  "type": enum (MobileDeviceType),
  "id": string,
  "name": string,
  "manufacturerName": string,
  "operatingSystemName": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב של הקבוע של המכשיר הנייד. שמות המשאבים הקבועים של מכשירי ניידים הם בפורמט:

mobileDeviceConstants/{criterionId}

type

enum (MobileDeviceType)

פלט בלבד. סוג המכשיר הנייד.

id

string (int64 format)

פלט בלבד. המזהה של המכשיר הנייד.

name

string

פלט בלבד. שם המכשיר הנייד.

manufacturerName

string

פלט בלבד. היצרן של המכשיר הנייד.

operatingSystemName

string

פלט בלבד. מערכת ההפעלה שמותקנת במכשיר הנייד.

MobileDeviceType

סוג המכשיר הנייד.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
MOBILE טלפונים ניידים.
TABLET טאבלטים.

OfflineConversionUploadClientSummary

סיכום של העלאת המרות אופליין ברמת הלקוח.

ייצוג JSON
{
  "resourceName": string,
  "client": enum (OfflineEventUploadClient),
  "status": enum (OfflineConversionDiagnosticStatus),
  "totalEventCount": string,
  "successfulEventCount": string,
  "successRate": number,
  "lastUploadDateTime": string,
  "dailySummaries": [
    {
      object (OfflineConversionSummary)
    }
  ],
  "jobSummaries": [
    {
      object (OfflineConversionSummary)
    }
  ],
  "alerts": [
    {
      object (OfflineConversionAlert)
    }
  ]
}
שדות
resourceName

string

פלט בלבד. שם המשאב של סיכום ההעלאות של המרות אופליין ברמת הלקוח. שמות משאבי הסיכום של הלקוח להעלאת המרות אופליין מופיעים בפורמט הבא:

customers/{customerId}/offlineConversionUploadClientSummaries/{client}

client

enum (OfflineEventUploadClient)

פלט בלבד. סוג הלקוח של אירוע ההעלאה.

status

enum (OfflineConversionDiagnosticStatus)

פלט בלבד. הסטטוס הכללי של סיכום פרטי הלקוח לגבי המרות אופליין. הסטטוס נוצר מהיום הקלנדרי האחרון עם נתונים סטטיסטיים של העלאות.

totalEventCount

string (int64 format)

פלט בלבד. המספר הכולל של האירועים שהועלו.

successfulEventCount

string (int64 format)

פלט בלבד. המספר הכולל של האירועים שהועלו בהצלחה.

successRate

number

פלט בלבד. שיעור הצלחה.

lastUploadDateTime

string

פלט בלבד. התאריך של קבוצת הקבצים האחרונה להעלאה. הפורמט הוא 'yyyy-mm-dd hh:mm:ss', והוא לפי אזור הזמן של חשבון Google Ads.

dailySummaries[]

object (OfflineConversionSummary)

פלט בלבד. סיכום של נתונים סטטיסטיים של ההיסטוריה לפי N הימים האחרונים.

jobSummaries[]

object (OfflineConversionSummary)

פלט בלבד. סיכום של נתונים סטטיסטיים של ההיסטוריה לפי N המשימות האחרונות.

alerts[]

object (OfflineConversionAlert)

פלט בלבד. הפרטים של כל קוד שגיאה. ההתראות נוצרות מהיום הקלנדרי האחרון עם נתונים סטטיסטיים של העלאות.

OfflineEventUploadClient

סוג הלקוח.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
GOOGLE_ADS_API Google Ads API.
GOOGLE_ADS_WEB_CLIENT לקוח אינטרנט של Google Ads, שיכול לכלול כמה מקורות כמו ממשק המשתמש של Google Ads, SFTP וכו'.
ADS_DATA_CONNECTOR פלטפורמת החיבור.

OfflineConversionDiagnosticStatus

סטטוסים אפשריים של הגדרת הטמעת הנתונים ממקורות אופליין.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
EXCELLENT ההגדרה של הטמעת הנתונים ממקורות אופליין פעילה ואופטימלית לעיבוד נתונים במורד הזרם (downstream).
GOOD ההגדרה של הטמעת הנתונים ממקורות אופליין פעילה, אבל יש שיפורים נוספים שאפשר לבצע. הצגת ההתראות.
NEEDS_ATTENTION ההגדרה של הטמעת הנתונים ממקורות אופליין פעילה, אבל יש שגיאות שדורשות התייחסות. הצגת ההתראות.
NO_RECENT_UPLOAD ב-28 הימים האחרונים לא התקבלו נתונים בהגדרה של הטמעת הנתונים ממקורות אופליין. יכול להיות שמשהו השתבש.

OfflineConversionSummary

סיכום היסטורי של ההעלאות, בקיבוץ לפי תאריך ההעלאה או משימה.

ייצוג ב-JSON
{
  "successfulCount": string,
  "failedCount": string,

  // Union field dimension_key can be only one of the following:
  "jobId": string,
  "uploadDate": string
  // End of list of possible types for union field dimension_key.
}
שדות
successfulCount

string (int64 format)

פלט בלבד. המספר הכולל של אירועים שבוצעו בהצלחה.

failedCount

string (int64 format)

פלט בלבד. המספר הכולל של האירועים שנכשלו.

שדה איחוד dimension_key. מפתח המאפיין לסיכום. הערך של dimension_key יכול להיות רק אחת מהאפשרויות הבאות:
jobId

string (int64 format)

פלט בלבד. מפתח המאפיין של N המשרות האחרונות.

uploadDate

string

פלט בלבד. מפתח המאפיין עבור N הימים האחרונים.

OfflineConversionAlert

התראה על סיכום לקוח מסוג המרות אופליין.

ייצוג JSON
{
  "error": {
    object (OfflineConversionError)
  },
  "errorPercentage": number
}
שדות
error

object (OfflineConversionError)

פלט בלבד. שגיאה בהתראה ללקוח לגבי המרות אופליין.

errorPercentage

number

פלט בלבד. אחוז השגיאה, הטווח בשדה הזה צריך להיות [0, 1.0].

OfflineConversionError

שגיאות אפשריות בסיכום הלקוח של המרות אופליין.

ייצוג ב-JSON
{

  // Union field error_code can be only one of the following:
  "collectionSizeError": enum (CollectionSizeError),
  "conversionAdjustmentUploadError": enum (ConversionAdjustmentUploadError),
  "conversionUploadError": enum (ConversionUploadError),
  "dateError": enum (DateError),
  "distinctError": enum (DistinctError),
  "fieldError": enum (FieldError),
  "mutateError": enum (MutateError),
  "notAllowlistedError": enum (NotAllowlistedError),
  "stringFormatError": enum (StringFormatError),
  "stringLengthError": enum (StringLengthError)
  // End of list of possible types for union field error_code.
}
שדות
שדה איחוד error_code. שגיאה בתיאור. error_code יכול להיות רק אחת מהאפשרויות הבאות:
collectionSizeError

enum (CollectionSizeError)

פלט בלבד. שגיאה בגודל האוסף.

conversionAdjustmentUploadError

enum (ConversionAdjustmentUploadError)

פלט בלבד. אירעה שגיאה בהעלאה של התאמת ההמרה.

conversionUploadError

enum (ConversionUploadError)

פלט בלבד. שגיאה בהעלאת המרה.

dateError

enum (DateError)

פלט בלבד. שגיאה בתאריך.

distinctError

enum (DistinctError)

פלט בלבד. שגיאה ייחודית.

fieldError

enum (FieldError)

פלט בלבד. שגיאה בשדה.

mutateError

enum (MutateError)

פלט בלבד. שגיאת שינוי.

notAllowlistedError

enum (NotAllowlistedError)

פלט בלבד. שגיאה: לא כלול ברשימת ההיתרים.

stringFormatError

enum (StringFormatError)

פלט בלבד. שגיאה בפורמט המחרוזת.

stringLengthError

enum (StringLengthError)

פלט בלבד. שגיאה באורך המחרוזת.

CollectionSizeError

Enum מתאר שגיאות אפשריות בגודל האוסף.

טיפוסים בני מנייה (enum)
UNSPECIFIED טיפוס בן מנייה (enum) לא צוין.
UNKNOWN קוד השגיאה שהתקבל לא ידוע בגרסה הזו.
TOO_FEW מעט מדי.
TOO_MANY יותר מדי.

ConversionAdjustmentUploadError

Enum שמתאר שגיאות אפשריות בהעלאה של התאמות המרות.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
TOO_RECENT_CONVERSION_ACTION אי אפשר לייבא אירועים לפעולת המרה שנוצרה עכשיו. אפשר לנסות לייבא שוב בעוד 6 שעות.
CONVERSION_ALREADY_RETRACTED דיווח ההמרה כבר בוטל. ההתאמה הזו לא עובדה.
CONVERSION_NOT_FOUND לא נמצאה ההמרה המשויכת לפעולת ההמרה הזו ולמזהה ההמרה הזה. צריך לוודא שמזהי ההמרות משויכים לפעולת ההמרה הנכונה ולנסות שוב.
CONVERSION_EXPIRED אי אפשר לבצע התאמה להמרה שהתרחשה לפני יותר מ-54 ימים.
ADJUSTMENT_PRECEDES_CONVERSION ההתאמה כוללת adjustmentDateTime שהתרחש לפני ההמרה המשויכת. צריך לוודא שה-adjustmentDateTime נכון ולנסות שוב.
MORE_RECENT_RESTATEMENT_FOUND כבר דווחה התאמה עדכנית יותר מסוג adjustmentDateTime לגבי ההמרה המשויכת. צריך לוודא שההתאמה adjustmentDateTime נכונה ולנסות שוב.
TOO_RECENT_CONVERSION אי אפשר לתעד התאמה כי ההמרה התרחשה לפני זמן קצר מדי. כדאי לנסות לשנות המרה שהתרחשה לפני 24 שעות לפחות.
CANNOT_RESTATE_CONVERSION_ACTION_THAT_ALWAYS_USES_DEFAULT_CONVERSION_VALUE אי אפשר לבצע שינוי בהמרה שהוגדרה לשימוש בערך ברירת המחדל. צריך לבדוק את ההגדרה של ערך פעולת ההמרה ולנסות שוב.
TOO_MANY_ADJUSTMENTS_IN_REQUEST כדאי לנסות להעלות פחות מ-2,001 התאמות בבקשת API אחת.
TOO_MANY_ADJUSTMENTS ההמרה כבר הותאמה מספר הפעמים המקסימלי. חשוב לבצע את ההתאמות הדרושות רק בהמרות קיימות.
RESTATEMENT_ALREADY_EXISTS יש שינוי דיווח קודם לגבי ההמרה עם אותו adjustmentDateTime. צריך לוודא שהערך של adjustmentDateTime בהתאמה הוא נכון וייחודי ולנסות שוב.
DUPLICATE_ADJUSTMENT_IN_REQUEST בהתאמה שיובאה יש התאמת המרה כפולה עם אותה adjustmentDateTime. צריך לוודא שהערך של adjustmentDateTime בהתאמה נכון ולנסות שוב.
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS צריך לוודא שאישרת את התנאים לעיבוד נתוני לקוחות בהגדרות ההמרות ולנסות שוב.
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT אי אפשר להשתמש בהמרות משופרות עם פעולת ההמרה שצוינה.
INVALID_USER_IDENTIFIER יש להקפיד לבצע גיבוב של הנתונים שהמשתמשים סיפקו באמצעות SHA-256 ולוודא שמתבצע נירמול בהתאם להנחיות.
UNSUPPORTED_USER_IDENTIFIER צריך להשתמש בפרטים שהמשתמשים סיפקו, כמו כתובות אימייל או מספרי טלפון שעברו גיבוב באמצעות SHA-256, ולנסות שוב.
GCLID_DATE_TIME_PAIR_AND_ORDER_ID_BOTH_SET לא ניתן להגדיר גם את gclidDateTimePair וגם את orderId. צריך להשתמש רק בסוג אחד ולנסות שוב.
CONVERSION_ALREADY_ENHANCED להמרה כבר יש שיפורים עם אותו מזהה הזמנה ואותה פעולת המרה. צריך לוודא שהנתונים מוגדרים כראוי ולנסות שוב.
DUPLICATE_ENHANCEMENT_IN_REQUEST פעולת ההמרה ומזהה ההזמנה זהים בכמה שיפורים. צריך לוודא שהנתונים מוגדרים כראוי ולנסות שוב.
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCEMENT אי אפשר להשתמש בהמרות משופרות בחשבון הזה בגלל המדיניות של Google בנושא נתוני לקוחות. אפשר לפנות לנציג Google.
MISSING_ORDER_ID_FOR_WEBPAGE כדי לבצע התאמה להמרה באתר צריך להזין מזהה הזמנה (כלומר, מזהה עסקה). צריך לוודא שתגי האתר מתעדים את מזהי ההזמנות, ושאותם מזהי הזמנות נשלחים יחד עם ההתאמה.
ORDER_ID_CONTAINS_PII אי אפשר להשתמש בהתאמה עם מזהי הזמנות שמכילים פרטים אישיים מזהים (PII).
INVALID_JOB_ID מזהה המשימה שצוין בבקשה הוא לא בטווח המותר. מזהה משימה חייב להיות מספר שלם חיובי בטווח [1, 2^31).
NO_CONVERSION_ACTION_FOUND פעולת ההמרה שצוינה בבקשה לשינוי הערך לא נמצאה. צריך לוודא שהיא זמינה בחשבון הזה.
INVALID_CONVERSION_ACTION_TYPE אי אפשר להעלות שינויים של ערך המרה מהסוג של פעולת ההמרה שצוין בבקשת השינוי. שינוי ערך המרה מסוג RETRACTION או RESTATEMENT מותר רק עבור פעולות המרה מסוג SALESFORCE,‏ UPLOAD_CLICK או WEBPAGE. שינוי ערך המרה מסוג ENHANCEMENT מותר רק עבור פעולות המרה מסוג WEBPAGE.

ConversionUploadError

Enum שמתאר שגיאות אפשריות בהעלאת המרות.

טיפוסים בני מנייה (enum)
UNSPECIFIED המספר לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
TOO_MANY_CONVERSIONS_IN_REQUEST כדאי להעלות פחות מ-2,001 אירועים בבקשה אחת.
UNPARSEABLE_GCLID לא ניתן לפענח את ה-GCLID שיובא. מוודאים שלא שיניתם את מזהי הקליקים.
CONVERSION_PRECEDES_EVENT conversionDateTime של האירוע המיובא קודמת לקליק. צריך לוודא שהשדה conversionDateTime נכון ולנסות שוב.
EXPIRED_EVENT אי אפשר לתעד את האירוע שיובא כי הקליק שהוביל אליו התרחש לפני חלון ההמרות מהקליקים. צריך לייבא את הנתונים העדכניים ביותר.
TOO_RECENT_EVENT הקליק שמשויך למזהה הנתון או לפרמטר של כתובת ה-URL ב-iOS התרחש לפני פחות מ-6 שעות. אפשר לנסות שוב בעוד 6 שעות.
EVENT_NOT_FOUND לא ניתן לשייך את האירוע שיובא לקליק. יכול להיות שהאירוע לא הגיע מקמפיין של Google Ads, ולכן המערכת לא מוצאת אותו.
UNAUTHORIZED_CUSTOMER הקריאה או מזהה הקליק משויכים לחשבון Google Ads שאין לך גישה אליהם. צריך לייבא המרות מחשבונות שמנוהלים על ידי חשבון הניהול שלך.
TOO_RECENT_CONVERSION_ACTION אי אפשר לייבא אירועים לפעולת המרה שנוצרה עכשיו. אפשר לנסות לייבא שוב בעוד 6 שעות.
CONVERSION_TRACKING_NOT_ENABLED_AT_IMPRESSION_TIME במועד הקליק, מעקב ההמרות לא הופעל בחשבון ההמרות בפועל בחשבון Google Ads של הקליק.
EXTERNAL_ATTRIBUTION_DATA_SET_FOR_NON_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION האירוע המיובא כולל נתוני שיוך (Attribution) חיצוניים, אבל פעולת ההמרה לא מוגדרת לשימוש במודל שיוך חיצוני. צריך לוודא שפעולת ההמרה מוגדרת בצורה נכונה ולנסות שוב.
EXTERNAL_ATTRIBUTION_DATA_NOT_SET_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION פעולת ההמרה מוגדרת לשימוש במודל שיוך (Attribution) חיצוני, אבל באירוע המיובא חסרים נתונים. צריך לוודא שהאירועים המיובאים כוללים את הקרדיט על שיוך החיצוני ואת כל השדות הנדרשים.
ORDER_ID_NOT_PERMITTED_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION אי אפשר להשתמש במזהי הזמנות להמרות שנמדדות באמצעות מודל שיוך (Attribution) חיצוני. צריך לוודא שההמרה מוגדרת בצורה תקינה ושהאירועים שיובאו כוללים רק את הנתונים הנדרשים, ולאחר מכן לנסות שוב.
ORDER_ID_ALREADY_IN_USE האירוע המיובא כולל מזהה הזמנה שתועד קודם לכן, כך שהאירוע לא עבר עיבוד.
DUPLICATE_ORDER_ID אירועים מיובאים כוללים כמה המרות עם אותו מזהה הזמנה, והם לא עברו עיבוד. צריך לוודא שמזהי ההזמנות ייחודיים ולנסות שוב.
TOO_RECENT_CALL אי אפשר לייבא שיחות שהתרחשו לפני פחות מ-6 שעות. אפשר לנסות להעלות אותם שוב בעוד 6 שעות.
EXPIRED_CALL אי אפשר לתעד את השיחה כי היא התרחשה לפני חלון המבט לאחור של פעולת ההמרה הזו. צריך לוודא שהייבוא מוגדר כך שיקבל את הנתונים העדכניים ביותר.
CALL_NOT_FOUND לא ניתן למצוא את השיחה או הקליק שמשויכים לאירוע שיובא. צריך לוודא שמקור הנתונים מוגדר כך שיכלול מזהים נכונים.
CONVERSION_PRECEDES_CALL בשיחה יש conversionDateTime שקודם לקליק המשויך. עליך לוודא שהשדה conversionDateTime נכון.
CONVERSION_TRACKING_NOT_ENABLED_AT_CALL_TIME במועד השיחה המיובאת, מעקב ההמרות לא הופעל בחשבון ההמרות בפועל בחשבון Google Ads שבו בוצע הקליק.
UNPARSEABLE_CALLERS_PHONE_NUMBER חשוב לוודא שמספרי הטלפון בפורמט E.164‏ (+16502531234), בינלאומי (+64 3-331 6005) או מספר לאומי בארה"ב (6502531234).
CLICK_CONVERSION_ALREADY_EXISTS האירוע שיובא כולל את אותו קליק ואותו conversionDateTime כמו המרה קיימת. צריך להשתמש ב-conversionDateTime או במזהה הזמנה ייחודי לכל אירוע ייחודי ולנסות שוב.
CALL_CONVERSION_ALREADY_EXISTS השדה conversionDateTime של השיחה שיובאה זהה לשדה conversionDateTime של המרה קיימת. צריך לוודא שהאפשרות conversionDateTime מוגדרת בצורה נכונה ולנסות שוב.
DUPLICATE_CLICK_CONVERSION_IN_REQUEST למספר אירועים יש אותו קליק ואותו conversionDateTime. צריך לוודא ש-conversionDateTime מוגדר בצורה נכונה ולנסות שוב.
DUPLICATE_CALL_CONVERSION_IN_REQUEST למספר אירועים יש את אותה קריאה ו-conversionDateTime. צריך לוודא ש-conversionDateTime מוגדר בצורה נכונה ולנסות שוב.
CUSTOM_VARIABLE_NOT_ENABLED צריך להפעיל את המשתנה המותאם אישית בהגדרות ההמרה ולנסות שוב.
CUSTOM_VARIABLE_VALUE_CONTAINS_PII אי אפשר לייבא אירועים עם משתנים מותאמים אישית שיש בהם פרטים אישיים מזהים (PII). צריך להסיר את המשתנים האלה ולנסות שוב.
INVALID_CUSTOMER_FOR_CLICK הקליק מהאירוע המיובא משויך לחשבון Google Ads אחר. צריך לוודא שמתבצע ייבוא לחשבון הנכון.
INVALID_CUSTOMER_FOR_CALL הקליק מהשיחה משויך לחשבון Google Ads אחר. צריך לוודא שמתבצע ייבוא לחשבון הנכון. שולחים שאילתה ל-conversionTrackingSetting.google_ads_conversion_customer ב-Customer כדי לזהות את החשבון הנכון.
CONVERSION_NOT_COMPLIANT_WITH_ATT_POLICY לא ניתן לייבא את ההמרה כי מקור ההמרה לא עמד בדרישות של מדיניות App Tracking Transparency ‏(ATT) של Apple, או שהלקוח לא הסכים למעקב.
CLICK_NOT_FOUND לא ניתן להתאים את כתובת האימייל או את מספר הטלפון של האירוע הזה לקליק. יכול להיות שהנתונים האלה לא הגיעו מקמפיין שלGoogle Ads. במצב כזה, אפשר להתעלם מהאזהרה הזו. אם באזהרה מופיעים יותר אירועים מיובאים מהצפוי, כדאי לבדוק את ההגדרה.
INVALID_USER_IDENTIFIER יש להקפיד לבצע גיבוב של הנתונים שהמשתמשים סיפקו באמצעות SHA-256 ולוודא שמתבצע נירמול בהתאם להנחיות.
EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION_NOT_PERMITTED_WITH_USER_IDENTIFIER אי אפשר להשתמש בפרטים שהמשתמשים סיפקו עם מודלים חיצוניים של שיוך (Attribution). צריך להשתמש במודל שיוך אחר או להשמיט מזהי משתמשים ולנסות שוב.
UNSUPPORTED_USER_IDENTIFIER אין תמיכה במזהי המשתמשים שסופקו. צריך להשתמש רק בכתובת אימייל או במספר טלפון שעברו גיבוב (hash) ולנסות שוב.
GBRAID_WBRAID_BOTH_SET אי אפשר להשתמש גם בפרמטר gbraid וגם בפרמטר wbraid צריך להשתמש רק באחד מהם ולנסות שוב.
UNPARSEABLE_WBRAID אי אפשר לנתח את הנתונים של ייבוא האירועים. צריך לבדוק אם הפרמטר wbraid לא השתנה ולנסות שוב.
UNPARSEABLE_GBRAID אי אפשר לנתח את הנתונים של ייבוא האירועים. צריך לבדוק אם הפרמטר gbraid לא השתנה ולנסות שוב.
ONE_PER_CLICK_CONVERSION_ACTION_NOT_PERMITTED_WITH_BRAID אי אפשר להשתמש בפעולות המרה שנעשה בהן שימוש בספירה של המרה אחת לקליק עם פרמטרים מסוג gbraid או wbraid.
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS אי אפשר להשתמש בהמרות משופרות בחשבון הזה בגלל המדיניות של Google בנושא נתוני לקוחות. אפשר לפנות לנציג Google.
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS צריך לאשר את התנאים לעיבוד נתוני לקוחות בהגדרות של ההמרות ולנסות שוב. כדי לבדוק את ההגדרה, אפשר להריץ שאילתה על conversionTrackingSetting.accepted_customer_data_terms בחשבון הלקוח.
ORDER_ID_CONTAINS_PII אי אפשר לייבא אירועים עם מזהי הזמנות שיש בהם פרטים אישיים מזהים (PII).
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS צריך לוודא שהפעלת המרות משופרות לצורך שיוך ללידים בהגדרות ההמרה ולנסות שוב. אפשר לבדוק את ההגדרה באמצעות שאילתה על conversionTrackingSetting.enhanced_conversions_for_leads_enabled ב-Customer.
INVALID_JOB_ID מזהה המשימה שצוין בבקשה הוא לא בטווח המותר. מזהה משימה חייב להיות מספר שלם חיובי בטווח [1, 2^31).
NO_CONVERSION_ACTION_FOUND פעולת ההמרה שצוינה בבקשה ההעלאה לא נמצאה. צריך לוודא שהיא זמינה בחשבון הזה.
INVALID_CONVERSION_ACTION_TYPE פעולת ההמרה שצוינה בבקשת ההעלאה לא מוגדרת להעלאה של המרות.

DateError

טיפוסים בני מנייה (enum) שמתאר שגיאות אפשריות בתאריך.

טיפוסים בני מנייה (enum)
UNSPECIFIED טיפוס בן מנייה (enum) לא צוין.
UNKNOWN קוד השגיאה שהתקבל לא ידוע בגרסה הזו.
INVALID_FIELD_VALUES_IN_DATE ערכי השדות שצוינו לא תואמים לתאריך חוקי.
INVALID_FIELD_VALUES_IN_DATE_TIME ערכי השדות שצוינו לא תואמים לתאריך ושעה חוקיים.
INVALID_STRING_DATE הפורמט של התאריך במחרוזת צריך להיות yyyy-mm-dd.
INVALID_STRING_DATE_TIME_MICROS הפורמט של המחרוזת של התאריך והשעה צריך להיות yyyy-mm-dd hh:mm:ss.ssssss.
INVALID_STRING_DATE_TIME_SECONDS הפורמט של תאריך המחרוזת צריך להיות yyyy-mm-dd hh:mm:ss.
INVALID_STRING_DATE_TIME_SECONDS_WITH_OFFSET הפורמט של המחרוזת של התאריך והשעה צריך להיות yyyy-mm-dd hh:mm:ss+|-hh:mm.
EARLIER_THAN_MINIMUM_DATE התאריך קודם למינימום המותר.
LATER_THAN_MAXIMUM_DATE התאריך שצוין מאוחר מהתאריך המאוחר ביותר המותר.
DATE_RANGE_MINIMUM_DATE_LATER_THAN_MAXIMUM_DATE גבולות טווח התאריכים לא מסודרים.
DATE_RANGE_MINIMUM_AND_MAXIMUM_DATES_BOTH_NULL שני התאריכים בטווח ריקים.

DistinctError

טיפוסים בני מנייה (enum) שמתאר שגיאות ייחודיות אפשריות.

טיפוסים בני מנייה (enum)
UNSPECIFIED טיפוס בן מנייה (enum) לא צוין.
UNKNOWN קוד השגיאה שהתקבל לא ידוע בגרסה הזו.
DUPLICATE_ELEMENT רכיב כפול.
DUPLICATE_TYPE סוג כפול.

FieldError

טיפוסים בני מנייה (enum) שמתאר שגיאות אפשריות בשדה.

טיפוסים בני מנייה (enum)
UNSPECIFIED טיפוס בן מנייה (enum) לא צוין.
UNKNOWN קוד השגיאה שהתקבל לא ידוע בגרסה הזו.
REQUIRED שדה החובה לא היה קיים.
IMMUTABLE_FIELD אי אפשר לשנות את השדה שאליו ניסיתם לבצע את השינוי.
INVALID_VALUE הערך בשדה לא חוקי.
VALUE_MUST_BE_UNSET לא ניתן להגדיר את השדה.
REQUIRED_NONEMPTY_LIST השדה החוזר הנדרש היה ריק.
FIELD_CANNOT_BE_CLEARED אי אפשר לנקות את השדה.
BLOCKED_VALUE ערך השדה נמצא ברשימת ישויות שנחסמו בשדה הזה.
FIELD_CAN_ONLY_BE_CLEARED אי אפשר לשנות את הערך של השדה, מלבד ניקוי.

MutateError

Enum שמתאר שגיאות אפשריות של שינוי (mutate).

טיפוסים בני מנייה (enum)
UNSPECIFIED טיפוס בן מנייה (enum) לא צוין.
UNKNOWN קוד השגיאה שהתקבל לא ידוע בגרסה הזו.
RESOURCE_NOT_FOUND המשאב המבוקש לא נמצא.
ID_EXISTS_IN_MULTIPLE_MUTATES לא ניתן לבצע שינויים של אותו משאב פעמיים בבקשה אחת.
INCONSISTENT_FIELD_VALUES התוכן של השדה לא תואם לשדה אחר שמייצג את אותם נתונים.
MUTATE_NOT_ALLOWED לא ניתן לבצע מניפולציות על המשאב המבוקש.
RESOURCE_NOT_IN_GOOGLE_ADS המשאב לא נמצא ב-Google Ads. היא שייכת למערכת מודעות אחרת.
RESOURCE_ALREADY_EXISTS המשאב שנוצר כבר קיים.
RESOURCE_DOES_NOT_SUPPORT_VALIDATE_ONLY לא ניתן להשתמש במשאב הזה עם validateOnly.
OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE לא ניתן להשתמש בפעולה הזו עם 'partialFailure'.
RESOURCE_READ_ONLY ניסיון לכתוב בשדות לקריאה בלבד.

NotAllowlistedError

Enum שמתאר שגיאות אפשריות שלא נכללות ברשימת ההיתרים.

טיפוסים בני מנייה (enum)
UNSPECIFIED טיפוס בן מנייה (enum) לא צוין.
UNKNOWN קוד השגיאה שהתקבל לא ידוע בגרסה הזו.
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE הלקוח לא נכנס לרשימת ההיתרים עבור גישה לתכונה הזו.

StringFormatError

טיפוס enum שמתאר שגיאות אפשריות בפורמט המחרוזת.

טיפוסים בני מנייה (enum)
UNSPECIFIED טיפוס בן מנייה (enum) לא צוין.
UNKNOWN קוד השגיאה שהתקבל לא ידוע בגרסה הזו.
ILLEGAL_CHARS ערך מחרוזת הקלט מכיל תווים אסורים.
INVALID_FORMAT ערך מחרוזת הקלט לא חוקי בשדה המשויך.

StringLengthError

טיפוס enum שמתאר שגיאות אפשריות באורך המחרוזת.

טיפוסים בני מנייה (enum)
UNSPECIFIED טיפוס בן מנייה (enum) לא צוין.
UNKNOWN קוד השגיאה שהתקבל לא ידוע בגרסה הזו.
EMPTY השדה שצוין צריך להכיל לפחות תו אחד שהוא לא רווח לבן.
TOO_SHORT קצר מדי.
TOO_LONG השם ארוך מידי.

OperatingSystemVersionConstant

גרסה של מערכת הפעלה לנייד או מגוון גרסאות, בהתאם ל-operatorType. רשימת הפלטפורמות הזמינות לנייד זמינה בכתובת https://developers.google.com/google-ads/api/reference/data/codes-formats#mobile-platforms.

ייצוג JSON
{
  "resourceName": string,
  "operatorType": enum (OperatingSystemVersionOperatorType),
  "id": string,
  "name": string,
  "osMajorVersion": integer,
  "osMinorVersion": integer
}
שדות
resourceName

string

פלט בלבד. שם המשאב של הגרסה הקבועה של מערכת ההפעלה. שמות המשאבים של ערכי הקבועים של גרסאות מערכת ההפעלה הם בפורמט:

operatingSystemVersionConstants/{criterionId}

operatorType

enum (OperatingSystemVersionOperatorType)

פלט בלבד. קובע אם הקבוע הזה מייצג גרסה יחידה או מגוון של גרסאות.

id

string (int64 format)

פלט בלבד. המזהה של גרסת מערכת ההפעלה.

name

string

פלט בלבד. השם של מערכת ההפעלה.

osMajorVersion

integer

פלט בלבד. המספר של הגרסה הראשית של מערכת ההפעלה.

osMinorVersion

integer

פלט בלבד. מספר הגרסה המשנית של מערכת ההפעלה.

OperatingSystemVersionOperatorType

סוג גרסת מערכת ההפעלה.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
EQUALS_TO שווה לגרסה שצוינה.
GREATER_THAN_EQUALS_TO שווה לגרסה שצוינה או גדול ממנה.

PaidOrganicSearchTermView

תצוגה של מונחי חיפוש אורגני בתשלום שמספקת תצוגה של נתונים סטטיסטיים לגבי חיפוש במודעות וברישומים אורגניים, במצטבר לפי מונח חיפוש ברמת קבוצת המודעות.

ייצוג ב-JSON
{
  "resourceName": string,
  "searchTerm": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב בתצוגת מונחי החיפוש. שמות משאבים של תצוגות מונחי חיפוש מופיעים בתבנית:

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

searchTerm

string

פלט בלבד. מונח החיפוש.

QualifyingQuestion

שאלות שצריך לעמוד בהן כדי לקבל גישה לטופס להשארת פרטים.

ייצוג JSON
{
  "resourceName": string,
  "qualifyingQuestionId": string,
  "locale": string,
  "text": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב של שאלת ההתאמה.

'qualqualizingQuestions/{qualifyingQuestionId} '

qualifyingQuestionId

string (int64 format)

פלט בלבד. המזהה של השאלה לבדיקת התאמה.

locale

string

פלט בלבד. הלוקאל של שאלת ההתאמה.

text

string

פלט בלבד. השאלה לקביעת התאמה.

ParentalStatusView

תצוגה של סטטוס הורה.

ייצוג JSON
{
  "resourceName": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב בתצוגה של סטטוס ההורה. שמות המשאבים בתצוגת סטטוס ההורה הם בפורמט:

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

PerStoreView

תצוגה לכל חנות. התצוגה הזו מספקת למפרסמים נתונים סטטיסטיים לגבי היקף החשיפה של החשיפה בחנות הפיזית ולגבי ההמרות לפעולה מקומית.

ייצוג JSON
{
  "resourceName": string,
  "placeId": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב של התצוגה לכל חנות. שמות המשאבים בתצוגה 'לפי חנות' הם בפורמט:

customers/{customerId}/perStoreViews/{placeId}

placeId

string

פלט בלבד. מזהה המקום של כל תצוגת חנות.

ProductCategoryConstant

קטגוריית מוצר.

ייצוג ב-JSON
{
  "resourceName": string,
  "categoryId": string,
  "level": enum (ProductCategoryLevel),
  "state": enum (ProductCategoryState),
  "localizations": [
    {
      object (ProductCategoryLocalization)
    }
  ],
  "productCategoryConstantParent": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב של קטגוריית המוצרים. שמות המשאבים של קטגוריות מוצרים הם בפורמט:

productCategoryConstants/{level}~{categoryId}

categoryId

string (int64 format)

פלט בלבד. המזהה של קטגוריית המוצר.

המזהה הזה זהה למזהה במאפיין google_product_category, כפי שמתואר במאמר https://support.google.com/merchants/answer/6324436.

level

enum (ProductCategoryLevel)

פלט בלבד. הרמה של קטגוריית המוצרים.

state

enum (ProductCategoryState)

פלט בלבד. הסטטוס של קטגוריית המוצר.

localizations[]

object (ProductCategoryLocalization)

פלט בלבד. רשימת כל ההתאמות הזמינות של קטגוריית המוצרים.

productCategoryConstantParent

string

פלט בלבד. שם המשאב של קטגוריית המוצרים הראשית.

ProductCategoryState

Enum שמתאר את המצב של קטגוריית המוצרים.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
ENABLED הקטגוריה מופעלת.
OBSOLETE הקטגוריה מיושנת. הוא משמש למטרות דיווח בלבד.

ProductCategoryLocalization

התאמה לשוק המקומי של קטגוריית המוצרים.

ייצוג JSON
{
  "regionCode": string,
  "languageCode": string,
  "value": string
}
שדות
regionCode

string

פלט בלבד. קוד מדינה בן שתי אותיות רישיות לפי תקן ISO 3166-1 של הקטגוריה המותאמת לשוק המקומי.

languageCode

string

פלט בלבד. קוד שפה בן שתי אותיות לפי תקן ISO 639-1 של הקטגוריה המותאמת לשוק המקומי.

value

string

פלט בלבד. שם הקטגוריה באזור שצוין.

ProductGroupView

תצוגה של קבוצת מוצרים

ייצוג ב-JSON
{
  "resourceName": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב בתצוגת קבוצת המוצרים. שמות המשאבים בתצוגת קבוצת המוצרים הם בפורמט:

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

SearchTermView

תצוגה של מונחי חיפוש עם מדדים שנצברו לפי מונח חיפוש ברמת קבוצת המודעות.

ייצוג ב-JSON
{
  "resourceName": string,
  "status": enum (SearchTermTargetingStatus),
  "searchTerm": string,
  "adGroup": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב בתצוגת מונחי החיפוש. שמות משאבים של תצוגות מונחי חיפוש מופיעים בתבנית:

customers/{customerId}/searchTermViews/{campaignId}~{adGroupId}~{URL-base64_search_term}

status

enum (SearchTermTargetingStatus)

פלט בלבד. מציין אם מונח החיפוש נכלל כרגע בקבוצת מילות המפתח המטורגטות או החרגות.

searchTerm

string

פלט בלבד. מונח החיפוש.

adGroup

string

פלט בלבד. קבוצת המודעות שבה הוצג מונח החיפוש.

SearchTermTargetingStatus

מציין אם מונח החיפוש הוא אחת ממילות המפתח המטורגטות או שהוחרגו.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
ADDED מונח החיפוש מתווסף למילות המפתח המטורגטות.
EXCLUDED מונח החיפוש תואם למילת מפתח שלילית.
ADDED_EXCLUDED מונח החיפוש נוסף וגם הוחרג.
NONE מונח החיפוש לא ממוקד ולא מוחרג.

ShoppingPerformanceView

תצוגת ביצועים של שופינג. דוח שמספק נתונים סטטיסטיים של קמפיינים של שופינג שנצברו בכמה רמות של מאפייני מוצרים. ערכים של מאפייני מוצר מ-Merchant Center, כמו מותג, קטגוריה, מאפיינים מותאמים אישית, מצב מוצר וסוג מוצר ישקפו את המצב של כל מאפיין נכון לתאריך ולשעה שבהם תועד האירוע המתאים.

ייצוג JSON
{
  "resourceName": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב בתצוגת הביצועים של שופינג. שמות המשאבים בתצוגת הביצועים של קמפיינים של שופינג מופיעים בתבנית: customers/{customerId}/shoppingPerformanceView

SmartCampaignSearchTermView

תצוגה של מונחי חיפוש בקמפיין חכם.

ייצוג ב-JSON
{
  "resourceName": string,
  "searchTerm": string,
  "campaign": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב בתצוגת מונחי החיפוש של הקמפיין החכם. שמות המשאבים בתצוגת מונח החיפוש בקמפיין חכם הם בפורמט הבא:

customers/{customerId}/smartCampaignSearchTermViews/{campaignId}~{URL-base64_search_term}

searchTerm

string

פלט בלבד. מונח החיפוש.

campaign

string

פלט בלבד. הקמפיין החכם שבו הוצג מונח החיפוש.

TopicView

תצוגת נושא.

ייצוג ב-JSON
{
  "resourceName": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב של תצוגת הנושא. שמות המשאבים בתצוגת הנושאים מופיעים בפורמט:

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

TravelActivityGroupView

תצוגה של קבוצת פעילויות של נסיעות.

ייצוג JSON
{
  "resourceName": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב בתצוגת הקבוצות של פעילויות נסיעות. שמות המשאבים של תצוגות קבוצות של פעילויות נסיעות מופיעים בפורמט הבא:

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

TravelActivityPerformanceView

תצוגה של ביצועי פעילות תיירותית.

ייצוג JSON
{
  "resourceName": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב בתצוגת הביצועים של פעילות הנסיעות. שמות המשאבים של תצוגת הביצועים של פעילות נסיעות מופיעים בפורמט הבא:

customers/{customerId}/travelActivityPerformanceView

UserInterest

תחום עניין של משתמש: ענף ספציפי לטירגוט לפי תחומי עניין.

ייצוג ב-JSON
{
  "resourceName": string,
  "taxonomyType": enum (UserInterestTaxonomyType),
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ],
  "userInterestId": string,
  "name": string,
  "userInterestParent": string,
  "launchedToAll": boolean
}
שדות
resourceName

string

פלט בלבד. שם המשאב של תחום העניין של המשתמש. שמות המשאבים של תחומי העניין של המשתמשים הם בפורמט:

customers/{customerId}/userInterests/{userInterestId}

taxonomyType

enum (UserInterestTaxonomyType)

פלט בלבד. סוג הטקסונומיה של תחום העניין של המשתמש.

availabilities[]

object (CriterionCategoryAvailability)

פלט בלבד. פרטי הזמינות של תחום העניין של המשתמש.

userInterestId

string (int64 format)

פלט בלבד. המזהה של תחום העניין של המשתמש.

name

string

פלט בלבד. השם של תחום העניין של המשתמש.

userInterestParent

string

פלט בלבד. ההורה של תחום העניין של המשתמש.

launchedToAll

boolean

פלט בלבד. הערך True מופיע אם העניין של המשתמש מוצג בכל הערוצים והמיקומים.

UserInterestTaxonomyType

טיפוס נתונים מסוג enum שמכיל את הערכים האפשריים של UserInterestTaxonomyTypes.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
AFFINITY תחום העניין הזה של המשתמש.
IN_MARKET השוק של תחום העניין הזה של המשתמש.
MOBILE_APP_INSTALL_USER משתמשים שידוע שהם התקינו אפליקציות בקטגוריות שצוינו.
VERTICAL_GEO המיקום הגיאוגרפי של התחום הרלוונטי לתחומי העניין.
NEW_SMART_PHONE_USER קריטריונים לתחומי העניין של משתמשים חדשים בטלפונים חכמים.

LifeEvent

אירוע משמעותי בחיים: קטגוריה ספציפית של תחום עניין לטירגוט, כדי להגיע למשתמשים במהלך ציוני דרך חשובים בחיים שלהם.

ייצוג ב-JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "parent": string,
  "launchedToAll": boolean,
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ]
}
שדות
resourceName

string

פלט בלבד. שם המשאב של האירוע המשמעותי בחיים. שמות משאבים של אירועים משמעותיים בחיים יכולים להופיע בפורמט הבא:

customers/{customerId}/lifeEvents/{lifeEventId}

id

string (int64 format)

פלט בלבד. המזהה של האירוע המשמעותי בחיים.

name

string

פלט בלבד. שם אירוע החיים, לדוגמה 'עברתי לאחרונה'

parent

string

פלט בלבד. ההורה של LifeEvent.

launchedToAll

boolean

פלט בלבד. הערך הוא True אם האירוע המשמעותי בחיים מופעל בכל הערוצים והלוקאלים.

availabilities[]

object (CriterionCategoryAvailability)

פלט בלבד. פרטי הזמינות של האירוע המשמעותי בחיים.

UserLocationView

תצוגת מיקום של משתמש

התצוגה המפורטת של מיקומי המשתמש כוללת את כל המדדים המצטברים ברמת המדינה, שורה אחת לכל מדינה. הדוח כולל דיווח על מדדים במיקום הפיזי בפועל של המשתמש לפי מיקום גיאוגרפי למיקוד או לפי מיקום גיאוגרפי ללא טירגוט. אם נעשה שימוש בשדות פילוח אחרים, יכול להיות שתופיע יותר משורה אחת לכל מדינה.

ייצוג ב-JSON
{
  "resourceName": string,
  "countryCriterionId": string,
  "targetingLocation": boolean
}
שדות
resourceName

string

פלט בלבד. שם המשאב בתצוגת המיקום של המשתמש. שמות המשאבים בתצוגה UserLocation הם בפורמט:

customers/{customerId}/userLocationViews/{countryCriterionId}~{targetingLocation}

countryCriterionId

string (int64 format)

פלט בלבד. מזהה קריטריון למדינה.

targetingLocation

boolean

פלט בלבד. מציין אם המיקום טורגט או לא.

TopicConstant

אתם יכולים להשתמש בנושאים כדי לטרגט או להחריג מיקומי מודעות ברשת המדיה של Google על סמך הקטגוריה שאליה שייך מיקום המודעה (לדוגמה, 'חיות מחמד ובעלי חיים/חיות מחמד/כלבים').

ייצוג ב-JSON
{
  "resourceName": string,
  "path": [
    string
  ],
  "id": string,
  "topicConstantParent": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב של קבוע הנושא. שמות המשאבים של קבועי הנושאים הם בפורמט:

topicConstants/{topic_id}

path[]

string

פלט בלבד. הקטגוריה לטירגוט או להחרגה. כל רכיב נוסף במערך מתאר קטגוריית משנה ספציפית יותר. לדוגמה, {"Pets & Animals", "Pets", "Dogs"} מייצג את הקטגוריה 'חיות מחמד ובעלי חיים/חיות מחמד/כלבים'. רשימה של קטגוריות הנושאים הזמינות זמינה בכתובת https://developers.google.com/google-ads/api/reference/data/verticals

id

string (int64 format)

פלט בלבד. המזהה של הנושא.

topicConstantParent

string

פלט בלבד. שם המשאב של הורה של קבוע הנושא.

וידאו

סרטון.

ייצוג ב-JSON
{
  "resourceName": string,
  "id": string,
  "channelId": string,
  "durationMillis": string,
  "title": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב של הסרטון. שמות של משאבי וידאו מופיעים בפורמט:

customers/{customerId}/videos/{videoId}

id

string

פלט בלבד. מזהה הסרטון.

channelId

string

פלט בלבד. מזהה הערוץ של הבעלים של הסרטון.

durationMillis

string (int64 format)

פלט בלבד. משך הסרטון באלפיות שנייה.

title

string

פלט בלבד. כותרת הסרטון.

WebpageView

צפייה בדף אינטרנט.

ייצוג JSON
{
  "resourceName": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב של תצוגת דף האינטרנט. שמות של משאבים בתצוגות דפי אינטרנט מופיעים בתבנית:

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

LeadFormSubmissionData

נתונים משליחת טפסים להשארת פרטים.

ייצוג ב-JSON
{
  "resourceName": string,
  "id": string,
  "asset": string,
  "campaign": string,
  "leadFormSubmissionFields": [
    {
      object (LeadFormSubmissionField)
    }
  ],
  "customLeadFormSubmissionFields": [
    {
      object (CustomLeadFormSubmissionField)
    }
  ],
  "adGroup": string,
  "adGroupAd": string,
  "gclid": string,
  "submissionDateTime": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב של הנתונים שנשלחים להשארת פרטים. שמות משאבי הנתונים לשליחת טפסים להשארת פרטים מופיעים בפורמט הבא:

customers/{customerId}/leadFormSubmissionData/{lead_form_submission_data_id}

id

string

פלט בלבד. המזהה של שליחת הטופס להשארת פרטים.

asset

string

פלט בלבד. הנכס שמשויך לטופס השארת הפרטים שנשלח.

campaign

string

פלט בלבד. הקמפיין שמשויך לטופס להשארת הפרטים שנשלח.

leadFormSubmissionFields[]

object (LeadFormSubmissionField)

פלט בלבד. נתוני שליחה שמשויכים לנכס השארת הפרטים.

customLeadFormSubmissionFields[]

object (CustomLeadFormSubmissionField)

פלט בלבד. נתוני שליחה שמשויכים לטופס להשארת פרטים בהתאמה אישית.

adGroup

string

פלט בלבד. קבוצת המודעות שמשויכת לטופס להשארת הפרטים שנשלח.

adGroupAd

string

פלט בלבד. קבוצת מודעות שמשויכת לטופס להשארת פרטים שנשלח.

gclid

string

פלט בלבד. מספר הקליק ב-Google שמשויך לטופס השארת הפרטים שנשלח.

submissionDateTime

string

פלט בלבד. התאריך והשעה שבהם נשלח הטופס להשארת פרטים. הפורמט הוא 'yyyy-mm-dd hh:mm:ss+|-hh:mm', לדוגמה, '2019-01-01 12:32:45-08:00'.

LeadFormSubmissionField

השדות בטופס להשארת פרטים שנשלח.

ייצוג JSON
{
  "fieldType": enum (LeadFormFieldUserInputType),
  "fieldValue": string
}
שדות
fieldType

enum (LeadFormFieldUserInputType)

פלט בלבד. סוג השדה בשדות של נכס השארת הפרטים.

fieldValue

string

פלט בלבד. ערך השדה בשדות של טופס להשארת פרטים.

CustomLeadFormSubmissionField

השדות בשאלה בהתאמה אישית שנשלחה

ייצוג ב-JSON
{
  "questionText": string,
  "fieldValue": string
}
שדות
questionText

string

פלט בלבד. טקסט שאלה לשאלה מותאמת אישית. מספר התווים המקסימלי הוא 300.

fieldValue

string

פלט בלבד. ערך השדה לתשובה לשאלה בהתאמה אישית. מספר התווים המקסימלי הוא 70.

LocalServicesLead

נתונים מליד ב-'Google בעלי מקצוע'. כולל פרטים של ליד שנוצר כשמשתמש מתקשר, שולח הודעות או מקבל שירות מהמפרסם. מידע נוסף זמין בכתובת https://ads.google.com/local-services-ads

ייצוג ב-JSON
{
  "resourceName": string,
  "id": string,
  "categoryId": string,
  "serviceId": string,
  "contactDetails": {
    object (ContactDetails)
  },
  "leadType": enum (LeadType),
  "leadStatus": enum (LeadStatus),
  "creationDateTime": string,
  "locale": string,
  "leadCharged": boolean,
  "note": {
    object (Note)
  },
  "creditDetails": {
    object (CreditDetails)
  }
}
שדות
resourceName

string

פלט בלבד. שם המשאב של נתוני הלידים מ-'Google בעלי מקצוע'. שם המשאב של הליד ב-'Google בעלי מקצוע' כולל טופס

customers/{customerId}/localServicesLead/{local_services_lead_id}

id

string (int64 format)

פלט בלבד. המזהה של הליד הזה.

categoryId

string

פלט בלבד. קטגוריית השירות של הליד. לדוגמה: xcat:service_area_business_hvac, xcat:service_area_business_real_estate_agent וכו'. מידע נוסף זמין בכתובת https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids

serviceId

string

פלט בלבד. שירות לקטגוריה. לדוגמה: buyer_agent,‏ seller_agent לקטגוריה xcat:service_area_business_real_estate_agent.

contactDetails

object (ContactDetails)

פלט בלבד. פרטים ליצירת קשר עם הליד.

leadType

enum (LeadType)

פלט בלבד. סוג הליד ב-'Google בעלי מקצוע': טלפון, הודעה, הזמנה וכו'.

leadStatus

enum (LeadStatus)

פלט בלבד. הסטטוס הנוכחי של הליד.

creationDateTime

string

פלט בלבד. התאריך שבו נוצר הליד על ידי המודעות של 'Google בעלי מקצוע'. הפורמט הוא 'YYYY-MM-DD HH:MM:SS' באזור הזמן של חשבון Google Ads. דוגמאות: ‎"2018-03-05 09:15:00" או "2018-02-01 14:34:30"‎

locale

string

פלט בלבד. השפה שבה משתמש ספק השירות המקומי שמקושר ללידים. מידע נוסף זמין בכתובת https://developers.google.com/google-ads/api/data/codes-formats#locales

leadCharged

boolean

פלט בלבד. הערך הוא True אם המפרסם חויב על הליד.

note

object (Note)

פלט בלבד. הערה שנוספה על ידי המפרסם ללידים.

creditDetails

object (CreditDetails)

פלט בלבד. פרטי הזיכוי של הליד.

ContactDetails

שדות שמכילים פרטים ליצירת קשר עם הצרכנים.

ייצוג ב-JSON
{
  "phoneNumber": string,
  "email": string,
  "consumerName": string
}
שדות
phoneNumber

string

פלט בלבד. מספר הטלפון של הצרכן בפורמט E.164.

email

string

פלט בלבד. כתובת אימייל של צרכנים.

consumerName

string

פלט בלבד. שם הצרכן אם שם הצרכן סופק מהודעה או מטופס הזמנה ב-google.com

LeadType

סוגים אפשריים של לידים.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
MESSAGE ליד מהודעה.
PHONE_CALL ליד שנוצר משיחת טלפון.
BOOKING ליד מסוג הזמנה.

LeadStatus

סטטוסים אפשריים של ליד.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
NEW ליד חדש שעדיין לא ראה המפרסם.
ACTIVE ליד שהמפרסם קיים איתו אינטראקציה.
BOOKED נקבעה פגישה עם הליד.
DECLINED הלידים נדחו על ידי המפרסם.
EXPIRED התוקף של הליד פג עקב חוסר פעילות.
DISABLED הושבת בגלל ספאם או התנגדות.
CONSUMER_DECLINED הצרכן דחה את הליד.
WIPED_OUT הפרטים האישיים המזהים של הליד נמחקים.

הערה

הערה שנוספה ללידים על ידי המפרסם. מפרסמים יכולים לערוך את ההערות, וכך לאפס את זמן העריכה ולשנות את התיאור.

ייצוג JSON
{
  "editDateTime": string,
  "description": string
}
שדות
editDateTime

string

פלט בלבד. התאריך שבו בוצעה העריכה של הערת הליד. הפורמט הוא 'YYYY-MM-DD HH:MM:SS' באזור הזמן של חשבון Google Ads. דוגמאות: ‎"2018-03-05 09:15:00" או "2018-02-01 14:34:30"‎

description

string

פלט בלבד. התוכן של הערה ללידים.

CreditDetails

מייצג את פרטי הקרדיט של ליד.

ייצוג JSON
{
  "creditState": enum (CreditState),
  "creditStateLastUpdateDateTime": string
}
שדות
creditState

enum (CreditState)

פלט בלבד. מצב הקרדיט של הליד.

creditStateLastUpdateDateTime

string

פלט בלבד. התאריך והשעה שבהם סטטוס הזיכוי של הליד עודכן לאחרונה. הפורמט הוא 'YYYY-MM-DD HH:MM:SS' באזור הזמן של חשבון Google Ads. דוגמאות: ‎"2018-03-05 09:15:00" או "2018-02-01 14:34:30"‎

CreditState

מצבי זיכוי אפשריים של ליד.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
PENDING נשלח זיכוי לפרסום עתידי והוא מעובד על ידי מערכת Google Ads בקצה העורפי, אבל הוא עוד לא הוחל בחשבון.
CREDITED הזיכוי הועבר לחשבון הפרסום ב-Google Ads.

LocalServicesLeadConversation

נתונים משיחה של ליד ב-'Google בעלי מקצוע'. כולל פרטים של שיחה ממודעה שנוצרת כשמשתמש מתקשר, שולח הודעות או מקבל שירות מהמפרסם. הם מצורפים לליד. מידע נוסף זמין בכתובת https://ads.google.com/local-services-ads

ייצוג JSON
{
  "resourceName": string,
  "id": string,
  "conversationChannel": enum (ConversationType),
  "participantType": enum (ParticipantType),
  "lead": string,
  "eventDateTime": string,
  "phoneCallDetails": {
    object (PhoneCallDetails)
  },
  "messageDetails": {
    object (MessageDetails)
  }
}
שדות
resourceName

string

פלט בלבד. שם המשאב של נתוני השיחות של הליד ב-'Google בעלי מקצוע'. שם משאב השיחה של ליד ב-'Google בעלי מקצוע' כולל טופס

customers/{customerId}/localServicesLeadConversation/{local_services_lead_conversation_id}

id

string (int64 format)

פלט בלבד. המזהה של השיחה הראשית הזו.

conversationChannel

enum (ConversationType)

פלט בלבד. סוג השיחה של לידים ב-GLS, EMAIL, MESSAGE, PHONE_CALL, SMS וכו'.

participantType

enum (ParticipantType)

פלט בלבד. סוג המשתתף בשיחת הליד: ADVERTISER או CONSUMER.

lead

string

פלט בלבד. שם המשאב של הליד שמשויך לשיחה הראשית.

eventDateTime

string

פלט בלבד. התאריך והשעה שבהם שיחת הליד נוצרה על ידי מודעות 'Google בעלי מקצוע'. הפורמט הוא 'YYYY-MM-DD HH:MM:SS' באזור הזמן של חשבון Google Ads. דוגמאות: ‎"2018-03-05 09:15:00" או "2018-02-01 14:34:30"‎

phoneCallDetails

object (PhoneCallDetails)

פלט בלבד. פרטים על שיחת הטלפון במקרה של PHONE_CALL.

messageDetails

object (MessageDetails)

פלט בלבד. פרטים של שיחות הודעה במקרה של EMAIL, MESSAGE או SMS.

ConversationType

סוגים אפשריים של שיחות להשארת פרטים.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
EMAIL שליחת שיחה באימייל.
MESSAGE שיחה של ליד מהודעה.
PHONE_CALL שיחה עם ליד משיחת טלפון.
SMS שיחה עם ליד מ-SMS.
BOOKING שיחה של לידים לקביעת פגישות.

ParticipantType

סוגי המשתתפים האפשריים בשיחה עם ליד.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
ADVERTISER משתתף בספק מודעות 'Google בעלי מקצוע'.
CONSUMER משתתף בתוכנית המודעות של 'Google בעלי מקצוע'.

PhoneCallDetails

מייצג את הפרטים של שיחת טלפון.

ייצוג JSON
{
  "callDurationMillis": string,
  "callRecordingUrl": string
}
שדות
callDurationMillis

string (int64 format)

פלט בלבד. משך הזמן (באלפיות שנייה) של שיחת הטלפון (מקצה לקצה).

callRecordingUrl

string

פלט בלבד. כתובת ה-URL לקובץ האודיו של הקלטת השיחות.

MessageDetails

מייצג פרטים של הודעת טקסט במקרה של אימייל, הודעה או SMS.

ייצוג JSON
{
  "text": string,
  "attachmentUrls": [
    string
  ]
}
שדות
text

string

פלט בלבד. תוכן הטקסט של ההודעה.

attachmentUrls[]

string

פלט בלבד. כתובת ה-URL של הקבצים המצורפים להודעת ה-SMS או לאימייל. ניתן להשתמש בכתובות ה-URL האלה כדי להוריד את תוכן הקובץ המצורף באמצעות קוד המפתח.

AndroidPrivacySharedKeyGoogleAdGroup

תצוגה של מפתח פרטיות משותף ב-Android למפתח של קבוצת מודעות ב-Google.

ייצוג JSON
{
  "resourceName": string,
  "campaignId": string,
  "androidPrivacyInteractionType": enum (AndroidPrivacyInteractionType),
  "androidPrivacyInteractionDate": string,
  "androidPrivacyNetworkType": enum (AndroidPrivacyNetworkType),
  "adGroupId": string,
  "sharedAdGroupKey": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב של מפתח הפרטיות המשותף של Android. שמות של משאבי מפתח משותפים לפרטיות ב-Android מופיעים בפורמט:

customers/{customerId}/androidPrivacySharedKeyGoogleAdGroups/{campaignId}~{adGroupId}~{androidPrivacyInteractionType}~{androidPrivacyNetworkType}~{androidPrivacyInteractionDate(yyyy-mm-dd)}

campaignId

string (int64 format)

פלט בלבד. מזהה הקמפיין שמשמש לקידוד של מפתח השיתוף.

androidPrivacyInteractionType

enum (AndroidPrivacyInteractionType)

פלט בלבד. סוג האינטראקציה 'טיפוסים בני מנייה (enum)' שמשמש בקידוד של מפתח שיתוף.

androidPrivacyInteractionDate

string

פלט בלבד. תאריך האינטראקציה שנעשה בו שימוש בקידוד המפתח המשותף בפורמט 'YYYY-MM-DD' באזור הזמן UTC.

androidPrivacyNetworkType

enum (AndroidPrivacyNetworkType)

פלט בלבד. המאפיין enum של סוג הרשת שמשמש בקידוד של מפתח השיתוף.

adGroupId

string (int64 format)

פלט בלבד. מזהה קבוצת המודעות שמשמש לקידוד של מפתח השיתוף.

sharedAdGroupKey

string

פלט בלבד. מחרוזת הקסדצימלית של 128 ביט של המפתח המשותף המקודד של קבוצת המודעות, כולל קידומת '0x'. אפשר להשתמש במפתח הזה כדי לבצע אופרטור OR בייטבי עם מפתח ההמרות המצטבר, כדי ליצור מפתח צביר מלא לאחזור דוח ה-API המצטבר בארגז החול לפרטיות של Android.

AndroidPrivacyInteractionType

פירוט של סוגי האינטראקציות

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא מוכר בגרסה הזו.
CLICK סוג האינטראקציה בעקבות קליק פיזי.
ENGAGED_VIEW סוג האינטראקציה לאחר צפייה פעילה באורך 10 שניות.
VIEW סוג האינטראקציה של צפייה (חשיפה של מודעה).

AndroidPrivacyNetworkType

הצגת סוגי הרשתות

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא מוכר בגרסה הזו.
SEARCH רשת החיפוש.
DISPLAY רשת המדיה.
YOUTUBE רשת YouTube.

AndroidPrivacySharedKeyGoogleCampaign

תצוגה של מפתח משותף לפרטיות ב-Android למפתח קמפיין של Google.

ייצוג JSON
{
  "resourceName": string,
  "campaignId": string,
  "androidPrivacyInteractionType": enum (AndroidPrivacyInteractionType),
  "androidPrivacyInteractionDate": string,
  "sharedCampaignKey": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב של מפתח הפרטיות המשותף של Android. שמות של משאבי מפתח משותפים לפרטיות ב-Android מופיעים בפורמט:

customers/{customerId}/androidPrivacySharedKeyGoogleCampaigns/{campaignId}~{androidPrivacyInteractionType}~{androidPrivacyInteractionDate(yyyy-mm-dd)}

campaignId

string (int64 format)

פלט בלבד. מזהה הקמפיין שמשמש לקידוד של מפתח השיתוף.

androidPrivacyInteractionType

enum (AndroidPrivacyInteractionType)

פלט בלבד. סוג האינטראקציה 'טיפוסים בני מנייה (enum)' שמשמש בקידוד של מפתח שיתוף.

androidPrivacyInteractionDate

string

פלט בלבד. תאריך האינטראקציה שנעשה בו שימוש בקידוד המפתח המשותף בפורמט 'YYYY-MM-DD' באזור הזמן UTC.

sharedCampaignKey

string

פלט בלבד. מחרוזת הקסדצימלית בת 128 ביט של מפתח הקמפיין המשותף המקודד, כולל הקידומת '0x'. אפשר להשתמש במפתח הזה כדי לבצע אופרטור OR ברמת סיביות עם מפתח ההמרה הנצבר, כדי ליצור מפתח צבירה מלא לאחזור של דוח ה-API המצטבר בארגז החול לפרטיות ב-Android.

AndroidPrivacySharedKeyGoogleNetworkType

תצוגה של מפתח משותף לפרטיות ב-Android למפתח מסוג רשת Google.

ייצוג JSON
{
  "resourceName": string,
  "campaignId": string,
  "androidPrivacyInteractionType": enum (AndroidPrivacyInteractionType),
  "androidPrivacyInteractionDate": string,
  "androidPrivacyNetworkType": enum (AndroidPrivacyNetworkType),
  "sharedNetworkTypeKey": string
}
שדות
resourceName

string

פלט בלבד. שם המשאב של מפתח הפרטיות המשותף של Android. שמות של משאבי מפתח משותפים לפרטיות ב-Android מופיעים בפורמט:

customers/{customerId}/androidPrivacySharedKeyGoogleNetworkTypes/{campaignId}~{androidPrivacyInteractionType}~{androidPrivacyNetworkType}~{androidPrivacyInteractionDate(yyyy-mm-dd)}

campaignId

string (int64 format)

פלט בלבד. מזהה הקמפיין שמשמש לקידוד של מפתח השיתוף.

androidPrivacyInteractionType

enum (AndroidPrivacyInteractionType)

פלט בלבד. סוג האינטראקציה 'טיפוסים בני מנייה (enum)' שמשמש בקידוד של מפתח שיתוף.

androidPrivacyInteractionDate

string

פלט בלבד. תאריך האינטראקציה שנעשה בו שימוש בקידוד המפתח המשותף בפורמט 'YYYY-MM-DD' באזור הזמן UTC.

androidPrivacyNetworkType

enum (AndroidPrivacyNetworkType)

פלט בלבד. המאפיין enum של סוג הרשת שמשמש בקידוד של מפתח השיתוף.

sharedNetworkTypeKey

string

פלט בלבד. מחרוזת הקסדצימלית באורך 128 ביט של המפתח המקודד מסוג רשת משותפת, כולל קידומת '0x'. אפשר להשתמש במפתח הזה כדי לבצע אופרטור OR בייטבי עם מפתח ההמרות המצטבר, כדי ליצור מפתח צביר מלא לאחזור דוח ה-API המצטבר בארגז החול לפרטיות של Android.

מדדים

נתוני מדדים.

ייצוג ב-JSON
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "skAdNetworkInstalls": string,
  "skAdNetworkTotalConversions": string,
  "publisherPurchasedClicks": string,
  "publisherOrganicClicks": string,
  "publisherUnknownClicks": string,
  "absoluteTopImpressionPercentage": number,
  "activeViewCpm": number,
  "activeViewCtr": number,
  "activeViewImpressions": string,
  "activeViewMeasurability": number,
  "activeViewMeasurableCostMicros": string,
  "activeViewMeasurableImpressions": string,
  "activeViewViewability": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allNewCustomerLifetimeValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "allConversionsFromStoreWebsite": number,
  "auctionInsightSearchAbsoluteTopImpressionPercentage": number,
  "auctionInsightSearchImpressionShare": number,
  "auctionInsightSearchOutrankingShare": number,
  "auctionInsightSearchOverlapRate": number,
  "auctionInsightSearchPositionAboveRate": number,
  "auctionInsightSearchTopImpressionPercentage": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpe": number,
  "averageCpm": number,
  "averageCpv": number,
  "averagePageViews": number,
  "averageTimeOnSite": number,
  "benchmarkAverageMaxCpc": number,
  "biddableAppInstallConversions": number,
  "biddableAppPostInstallConversions": number,
  "benchmarkCtr": number,
  "bounceRate": number,
  "clicks": string,
  "combinedClicks": string,
  "combinedClicksPerQuery": number,
  "combinedQueries": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "conversionLastReceivedRequestDateTime": string,
  "conversionLastConversionDate": string,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "conversionsValue": number,
  "newCustomerLifetimeValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "conversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsValueMicros": string,
  "ctr": number,
  "currentModelAttributedConversions": number,
  "currentModelAttributedConversionsFromInteractionsRate": number,
  "currentModelAttributedConversionsFromInteractionsValuePerInteraction": number,
  "currentModelAttributedConversionsValue": number,
  "currentModelAttributedConversionsValuePerCost": number,
  "engagementRate": number,
  "engagements": string,
  "hotelAverageLeadValueMicros": number,
  "hotelCommissionRateMicros": string,
  "hotelExpectedCommissionCost": number,
  "hotelPriceDifferencePercentage": number,
  "hotelEligibleImpressions": string,
  "historicalQualityScore": string,
  "gmailForwards": string,
  "gmailSaves": string,
  "gmailSecondaryClicks": string,
  "impressionsFromStoreReach": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "messageChats": string,
  "messageImpressions": string,
  "messageChatRate": number,
  "mobileFriendlyClicksPercentage": number,
  "optimizationScoreUplift": number,
  "optimizationScoreUrl": string,
  "organicClicks": string,
  "organicClicksPerQuery": number,
  "organicImpressions": string,
  "organicImpressionsPerQuery": number,
  "organicQueries": string,
  "percentNewVisitors": number,
  "phoneCalls": string,
  "phoneImpressions": string,
  "phoneThroughRate": number,
  "relativeCtr": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "searchVolume": {
    object (SearchVolumeRange)
  },
  "speedScore": string,
  "averageTargetCpaMicros": string,
  "averageTargetRoas": number,
  "topImpressionPercentage": number,
  "validAcceleratedMobilePagesClicksPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "valuePerCurrentModelAttributedConversion": number,
  "videoQuartileP100Rate": number,
  "videoQuartileP25Rate": number,
  "videoQuartileP50Rate": number,
  "videoQuartileP75Rate": number,
  "videoViewRate": number,
  "videoViews": string,
  "viewThroughConversions": string,
  "allConversionsFromLocationAssetClickToCall": number,
  "allConversionsFromLocationAssetDirections": number,
  "allConversionsFromLocationAssetMenu": number,
  "allConversionsFromLocationAssetOrder": number,
  "allConversionsFromLocationAssetOtherEngagement": number,
  "allConversionsFromLocationAssetStoreVisits": number,
  "allConversionsFromLocationAssetWebsite": number,
  "eligibleImpressionsFromLocationAssetStoreReach": string,
  "viewThroughConversionsFromLocationAssetClickToCall": number,
  "viewThroughConversionsFromLocationAssetDirections": number,
  "viewThroughConversionsFromLocationAssetMenu": number,
  "viewThroughConversionsFromLocationAssetOrder": number,
  "viewThroughConversionsFromLocationAssetOtherEngagement": number,
  "viewThroughConversionsFromLocationAssetStoreVisits": number,
  "viewThroughConversionsFromLocationAssetWebsite": number,
  "orders": number,
  "averageOrderValueMicros": string,
  "averageCartSize": number,
  "costOfGoodsSoldMicros": string,
  "grossProfitMicros": string,
  "grossProfitMargin": number,
  "revenueMicros": string,
  "unitsSold": number,
  "crossSellCostOfGoodsSoldMicros": string,
  "crossSellGrossProfitMicros": string,
  "crossSellRevenueMicros": string,
  "crossSellUnitsSold": number,
  "leadCostOfGoodsSoldMicros": string,
  "leadGrossProfitMicros": string,
  "leadRevenueMicros": string,
  "leadUnitsSold": number,
  "uniqueUsers": string,
  "averageImpressionFrequencyPerUser": number
}
שדות
allConversionsValueByConversionDate

number

הערך של כל ההמרות. אם בוחרים בעמודה הזו עם תאריך, הערכים בעמודה 'תאריך' מציינים את תאריך ההמרה. פרטים על העמודות by_conversion_date זמינים בכתובת https://support.google.com/google-ads/answer/9549009.

allConversionsByConversionDate

number

המספר הכולל של המרות. זה כולל את כל ההמרות, ללא קשר לערך של IncludeInConversionsMetric. כשהעמודה הזו מסומנת עם תאריך, הערכים בעמודת התאריך מייצגים את תאריך ההמרה. פרטים על העמודות by_conversion_date זמינים בכתובת https://support.google.com/google-ads/answer/9549009.

conversionsValueByConversionDate

number

הערך של ההמרות. המדד הזה כולל רק פעולות המרה שהמאפיין includeInConversionsMetric מוגדר עבורן כ-true. אם משתמשים בבידינג מבוסס המרות, המערכת תבצע אופטימיזציה להשגת ההמרות האלה. כשהעמודה הזו מסומנת עם תאריך, הערכים בעמודת התאריך מייצגים את תאריך ההמרה. פרטים על העמודות by_conversion_date זמינים בכתובת https://support.google.com/google-ads/answer/9549009.

conversionsByConversionDate

number

מספר ההמרות. המדד הזה כולל רק פעולות המרה שהמאפיין includeInConversionsMetric מוגדר עבורן כ-true. אם משתמשים בבידינג מבוסס המרות, המערכת תבצע אופטימיזציה להשגת ההמרות האלה. אם בוחרים בעמודה הזו עם תאריך, הערכים בעמודה 'תאריך' מציינים את תאריך ההמרה. פרטים על העמודות by_conversion_date זמינים בכתובת https://support.google.com/google-ads/answer/9549009.

historicalCreativeQualityScore

enum (QualityScoreBucket)

ציון האיכות ההיסטורי של הקריאייטיב.

historicalLandingPageQualityScore

enum (QualityScoreBucket)

האיכות של חוויית המשתמש בדף הנחיתה בעבר.

historicalSearchPredictedCtr

enum (QualityScoreBucket)

שיעור הקליקים (CTR) הצפוי של החיפוש ההיסטורי.

interactionEventTypes[]

enum (InteractionEventType)

סוגי האינטראקציות בתשלום והאינטראקציות בחינם.

skAdNetworkInstalls

string (int64 format)

מספר ההמרות ברשת המודעות של Store Kit ל-iOS.

skAdNetworkTotalConversions

string (int64 format)

המספר הכולל של המרות מרשת המודעות של Store Kit ל-iOS.

publisherPurchasedClicks

string (int64 format)

קליקים מנכסים שאינם בבעלות בעל התוכן הדיגיטלי, ששילם על התנועה אליהם או השיג אותה דרך פעילות שמלווה בתמריצים

publisherOrganicClicks

string (int64 format)

קליקים מנכסים שעבורם בעל התוכן הדיגיטלי לא שילם על התנועה או לא השיג אותה דרך פעילות שמלווה בתמריצים

publisherUnknownClicks

string (int64 format)

קליקים מתנועה שלא מזוהה כ'נרכש על ידי בעל התוכן הדיגיטלי' או 'אורגני של בעל התוכן הדיגיטלי'

absoluteTopImpressionPercentage

number

נתח החשיפות במיקום הבולט ביותר בחיפוש הוא אחוז החשיפות של המודעות לרשת החיפוש שהופיעו במיקום הבולט ביותר בחיפוש Google.

activeViewCpm

number

העלות הממוצעת לחשיפות שניתנות לצפייה (activeViewImpressions).

activeViewCtr

number

מספר הקליקים שניתנות למדידה ב-Active View חלקי מספר החשיפות שניתנות לצפייה בתצוגה פעילה.

המדד הזה מדווח רק לגבי רשת המדיה.

activeViewImpressions

string (int64 format)

מדד שבודק את התדירות שבה המודעה ניתנת לצפייה באתר ברשת המדיה.

activeViewMeasurability

number

יחס החשיפות שניתן היה למדוד על ידי Active View לבין מספר החשיפות שהוצגו.

activeViewMeasurableCostMicros

string (int64 format)

העלות של החשיפות שקיבלת שניתן היה למדוד באמצעות Active View.

activeViewMeasurableImpressions

string (int64 format)

מספר הפעמים שהמודעות שלכם מוצגות במיקומים במיקומים שבהם ניתן לראות אותן.

activeViewViewability

number

אחוז הפעמים שבהן המודעה שלך הופיעה באתר שבו הופעל Active View (חשיפות שניתנות למדידה) והיתה ניתנת לצפייה (חשיפות הניתנות לצפייה).

allConversionsFromInteractionsRate

number

כל ההמרות מאינטראקציות (בניגוד להמרות בעקבות צפייה) חלקי מספר האינטראקציות עם המודעות.

allConversionsValue

number

הערך של כל ההמרות.

allNewCustomerLifetimeValue

number

ערך ההמרות של כל הלקוחות החדשים לטווח הארוך (CLV). אם הגדרתם יעד של צירוף לקוחות ברמת החשבון או ברמת הקמפיין, הוא יכלול את ערך ההמרה הנוסף מלקוחות חדשים עבור המרות שניתן להגיש עליהן הצעות מחיר וגם עבור המרות שלא ניתן להגיש עליהן הצעות מחיר. אם הקמפיין שלכם הגדיר את היעד 'צירוף לקוחות' ובחרתם באפשרות 'הצעת מחיר גבוהה יותר ללקוחות חדשים', הערכים האלה ייכללו ב-'allConversionsValue'. פרטים נוספים זמינים בכתובת https://support.google.com/google-ads/answer/12080169.

allConversions

number

המספר הכולל של המרות. הנתון הזה כולל את כל ההמרות, ללא קשר לערך של includeInConversionsMetric.

allConversionsValuePerCost

number

הערך של כל ההמרות חלקי העלות הכוללת של אינטראקציות עם מודעות (כמו קליקים במודעות טקסט או צפיות במודעות וידאו).

allConversionsFromClickToCall

number

מספר הפעמים שאנשים לחצו על הלחצן 'שיחה' כדי להתקשר לחנות במהלך הלחיצה על המודעה או לאחר מכן. המספר הזה כולל גם שיחות שלא הועברו, ואין בחישוב של המדד הזה התייחסות למשך השיחה.

המדד הזה רלוונטי רק לפריטים בפיד.

allConversionsFromDirections

number

מספר הפעמים שבהן אנשים לחצו על הלחצן 'מסלול הגעה' כדי לנווט לחנות אחרי לחיצה על מודעה.

המדד הזה רלוונטי רק לפריטי פיד.

allConversionsFromInteractionsValuePerInteraction

number

הערך של כל ההמרות מאינטראקציות חלקי המספר הכולל של האינטראקציות.

allConversionsFromMenu

number

מספר הפעמים שאנשים לחצו על קישור כדי להציג את התפריט של החנות לאחר לחיצה על מודעה.

המדד הזה רלוונטי רק לפריטים בפיד.

allConversionsFromOrder

number

מספר הפעמים שאנשים ביצעו הזמנה בחנות לאחר לחיצה על מודעה.

המדד הזה רלוונטי רק לפריטי פיד.

allConversionsFromOtherEngagement

number

מספר ההמרות האחרות (למשל, פרסום ביקורת או שמירת מיקום החנות) שאירעו לאחר שאנשים לחצו על מודעה.

המדד הזה רלוונטי רק לפריטי פיד.

allConversionsFromStoreVisit

number

מספר הפעמים המשוער שאנשים ביקרו בחנות לאחר לחיצה על מודעה.

המדד הזה רלוונטי רק לפריטים בפיד.

allConversionsFromStoreWebsite

number

מספר הפעמים שאנשים הועברו אל כתובת URL של חנות לאחר לחיצה על מודעה.

המדד הזה רלוונטי רק לפריטי פיד.

auctionInsightSearchAbsoluteTopImpressionPercentage

number

המדד הזה הוא חלק מדוח המכרזים, והוא מציין את התדירות שבה המודעות של משתתף אחר הוצגו במיקום הבולט ביותר בדף תוצאות החיפוש. האחוז הזה מחושב רק לגבי המכרזים שבהם הוצגו בדף.

המדד הזה לא זמין לכולם.

auctionInsightSearchImpressionShare

number

המדד הזה הוא חלק מדוח המכרזים והוא מייצג את אחוז החשיפות שמשתתף אחר קיבל מתוך המספר הכולל של החשיפות שהמודעות שלכם היו כשירות לקבל. כל ערך נמוך מ-0.1 ידווח כ-0.0999.

המדד הזה לא זמין לציבור.

auctionInsightSearchOutrankingShare

number

המדד הזה הוא חלק מדוח המכרזים והוא מציג את אחוז החשיפות שבהן המודעות שלכם קיבלו דירוג גבוה יותר מהדירוג של משתתף אחר במכרז, בהשוואה למספר החשיפות הכולל שהמודעות היו כשירות לקבל. כל ערך נמוך מ-0.1 מדווח כ-0.0999.

המדד הזה לא זמין לציבור.

auctionInsightSearchOverlapRate

number

המדד הזה הוא חלק מהדוח 'תובנות לגבי מכרזים', והוא מציין את התדירות שבה מודעה של משתתף אחר קיבלה חשיפה, כאשר גם המודעה שלכם קיבלה חשיפה.

המדד הזה לא זמין לכולם.

auctionInsightSearchPositionAboveRate

number

המדד הזה הוא חלק מדוח המכרזים, והוא מציין את התדירות שבה מודעה של משתתף אחר הוצגה במיקום גבוה יותר מאשר זה של המודעה שלכם, במקרים שבהם המודעות שלכם הוצגו באותו דף.

המדד הזה לא זמין לציבור.

auctionInsightSearchTopImpressionPercentage

number

המדד הזה הוא חלק מדוח המכרזים, והוא מציין את התדירות שבה המודעות של משתתף אחר הוצגו בסמוך לחלק העליון של תוצאות החיפוש האורגני. האחוז הזה מחושב רק על סמך המכרזים שבהם המודעות שלכם הוצגו בדף.

המדד הזה לא זמין לכולם.

averageCost

number

הסכום הממוצע שמשלמים על כל אינטראקציה. סכום זה מייצג את העלות הכוללת של המודעות לחלק למספר הכולל של האינטראקציות.

averageCpc

number

העלות הכוללת של כל הקליקים חלקי המספר הכולל של הקליקים שהתקבלו.

averageCpe

number

הסכום הממוצע ששילמתם על אינטראקציה עם מודעה. הסכום הזה מייצג את העלות הכוללת של כל האינטראקציות עם מודעות חלקי המספר הכולל של האינטראקציות עם המודעות.

averageCpm

number

עלות ממוצעת לאלף חשיפות (CPM).

averageCpv

number

הסכום הממוצע שאתה משלם בכל פעם שמישהו צופה במודעה שלך. המחיר הממוצע לצפייה מוגדר לפי המחיר הכולל של כל הצפיות במודעות חלקי מספר הצפיות.

averagePageViews

number

המספר הממוצע של דפים שנצפו בכל סשן.

averageTimeOnSite

number

משך הזמן הכולל של כל הסשנים (בשניות) חלקי מספר הסשנים. מיובאים מ-Google Analytics.

benchmarkAverageMaxCpc

number

אינדיקציה לאופן שבו מפרסמים אחרים מגישים הצעות מחיר על מוצרים דומים.

biddableAppInstallConversions

number

מספר ההתקנות של אפליקציות.

biddableAppPostInstallConversions

number

מספר הפעולות בתוך האפליקציה.

benchmarkCtr

number

אינדיקציה לגבי הביצועים של מודעות שופינג של מפרסמים אחרים למוצרים דומים, על סמך התדירות שבה אנשים שרואים את המודעה לוחצים עליה.

bounceRate

number

אחוז הקליקים שבהם משתמש ביקר בדף אחד בלבד באתר. מיובאים מ-Google Analytics.

clicks

string (int64 format)

מספר הקליקים.

combinedClicks

string (int64 format)

מספר הפעמים שלחצו על המודעה או על הרישום של האתר בתוצאות החיפוש ללא תשלום. פרטים נוספים זמינים בדף העזרה בכתובת https://support.google.com/google-ads/answer/3097241.

combinedClicksPerQuery

number

מספר הפעמים שבהן לחצו על המודעה או על כרטיס המוצר שלכם בתוצאות החיפוש ללא תשלום חלקי מספר השאילתות המשולבות. פרטים נוספים זמינים בדף העזרה בכתובת https://support.google.com/google-ads/answer/3097241.

combinedQueries

string (int64 format)

מספר החיפושים שהחזירו דפים מהאתר שלכם בתוצאות החיפוש ללא תשלום או שהציגו אחת ממודעות הטקסט שלכם. פרטים נוספים זמינים בדף העזרה בכתובת https://support.google.com/google-ads/answer/3097241.

contentBudgetLostImpressionShare

number

אחוז הפעמים המשוער שהמודעה הייתה כשירה להצגה ברשת המדיה, אבל לא הוצגה כי התקציב היה נמוך מדי. הערה: המדד 'נתח החשיפות שהוחמצו מתקציב התוכן' מדווח בטווח שבין 0 ל-0.9. כל ערך מעל 0.9 ידווח כ-0.9001.

contentImpressionShare

number

מספר החשיפות שקיבלתם ברשת המדיה חלקי המספר המשוער של החשיפות שהייתם יכולים לקבל. הערה: נתח החשיפות ברשת התוכן מדווח בטווח של 0.1 עד 1. כל ערך נמוך מ-0.1 ידווח כ-0.0999.

conversionLastReceivedRequestDateTime

string

התאריך והשעה האחרונים שבהם תג המרה עבור פעולת ההמרה הזו הופעל בהצלחה ונצפה על ידי Google Ads. יכול להיות שאירוע ההפעלה הזה לא היה תוצאה של המרה שניתן לשייך אותה (לדוגמה, כי התג הופעל מדפדפן שלא בוצע בו בעבר קליק על מודעה של מפרסם מתאים). התאריך/השעה מוצגים לפי אזור הזמן של הלקוח.

conversionLastConversionDate

string

התאריך של ההמרה האחרונה ביותר של פעולת ההמרה הזו. התאריך הוא באזור הזמן של הלקוח.

contentRankLostImpressionShare

number

האחוז המשוער של חשיפות ברשת המדיה שהמודעות שלכם לא קיבלו בגלל דירוג מודעה נמוך. הערה: נתח החשיפות שהוחמצו לפי דירוג תוכן מדווח בטווח של 0 עד 0.9. כל ערך מעל 0.9 ידווח כ-0.9001.

conversionsFromInteractionsRate

number

מספר ההמרות מאינטראקציות חלקי מספר האינטראקציות עם המודעות (למשל, קליקים על מודעות טקסט או צפיות במודעות וידאו). המדד הזה כולל רק פעולות המרה שהמאפיין includeInConversionsMetric מוגדר עבורן כ-true. אם אתם משתמשים בבידינג מבוסס-המרות, שיטות הבידינג יבצעו אופטימיזציה להשגת ההמרות האלה.

conversionsValue

number

הערך של ההמרות. המדד הזה כולל רק פעולות המרה שהמאפיין includeInConversionsMetric מוגדר עבורן כ-true. אם משתמשים בבידינג מבוסס המרות, המערכת תבצע אופטימיזציה להשגת ההמרות האלה.

newCustomerLifetimeValue

number

ערך ההמרה של לקוחות חדשים לטווח הארוך. אם הגדרתם יעד צירוף לקוחות ברמת החשבון או ברמת הקמפיין, הוא יכלול את ערך ההמרה הנוסף מלקוחות חדשים עבור המרות שניתן להגיש עליהן הצעות מחיר. אם לקמפיין שלכם מוגדר היעד 'צירוף לקוחות' ובחרתם באפשרות 'הגשת הצעות מחיר גבוהות יותר ללקוחות חדשים', הערכים האלה ייכללו ב-'conversionsValue' לצורך אופטימיזציה. פרטים נוספים זמינים בכתובת https://support.google.com/google-ads/answer/12080169.

conversionsValuePerCost

number

ערך ההמרות מחולק בעלות של האינטראקציות עם המודעות. המדד הזה כולל רק פעולות המרה שהמאפיין includeInConversionsMetric מוגדר עבורן כ-true. אם משתמשים בבידינג מבוסס המרות, המערכת תבצע אופטימיזציה להשגת ההמרות האלה.

conversionsFromInteractionsValuePerInteraction

number

הערך של ההמרות מאינטראקציות חלקי מספר האינטראקציות עם המודעה. המדד הזה כולל רק פעולות המרה שהמאפיין includeInConversionsMetric מוגדר עבורן כ-true. אם אתם משתמשים בבידינג מבוסס-המרות, שיטות הבידינג יבצעו אופטימיזציה להשגת ההמרות האלה.

conversions

number

מספר ההמרות. המדד הזה כולל רק פעולות המרה שהמאפיין includeInConversionsMetric מוגדר עבורן כ-true. אם משתמשים בבידינג מבוסס המרות, המערכת תבצע אופטימיזציה להשגת ההמרות האלה.

costMicros

string (int64 format)

סך העלויות לקליק (CPC) והעלות לאלף חשיפות (CPM) במהלך התקופה הזו.

costPerAllConversions

number

העלות של האינטראקציות עם המודעות מחולקת במספר ההמרות.

costPerConversion

number

עלות האינטראקציות עם המודעה חלקי ההמרות. המדד הזה כולל רק פעולות המרה שהמאפיין includeInConversionsMetric מוגדר עבורן כ-true. אם אתם משתמשים בבידינג מבוסס-המרות, שיטות הבידינג יבצעו אופטימיזציה להשגת ההמרות האלה.

costPerCurrentModelAttributedConversion

number

עלות האינטראקציות עם המודעה חלקי ההמרות המשויכות למודל הנוכחי. המדד הזה כולל רק פעולות המרה שהמאפיין includeInConversionsMetric מוגדר עבורן כ-true. אם משתמשים בבידינג מבוסס המרות, המערכת תבצע אופטימיזציה להשגת ההמרות האלה.

crossDeviceConversions

number

המרות מהרגע שבו לקוח לוחץ על מודעת Google Ads במכשיר אחד, ואז משלים המרה במכשיר או בדפדפן אחר. המרות חוצות-מכשירים נכללות כבר בעמודה 'כל ההמרות'.

crossDeviceConversionsValueMicros

string (int64 format)

סכום הערך של המרות חוצות-מכשירים, במיליוניות השנייה.

ctr

number

מספר הקליקים שהמודעה מקבלת (קליקים) חלקי מספר הפעמים שהמודעה מוצגת (חשיפות).

currentModelAttributedConversions

number

מראה איך נתוני ההמרות ההיסטוריים ייראו עם מודל השיוך (Attribution) שבחרתם כרגע. המדד הזה כולל רק פעולות המרה שהמאפיין includeInConversionsMetric מוגדר עבורן כ-true. אם משתמשים בבידינג מבוסס המרות, המערכת תבצע אופטימיזציה להשגת ההמרות האלה.

currentModelAttributedConversionsFromInteractionsRate

number

המודל הנוכחי: המרות משויכות מאינטראקציות חלקי מספר האינטראקציות עם מודעות (למשל קליקים במודעות טקסט או צפיות במודעות וידאו). הנתון הזה כולל רק פעולות המרה שהמאפיין IncludeInConversionsMetric מוגדר כ-True. אם אתם משתמשים בבידינג מבוסס-המרות, שיטות הבידינג יבצעו אופטימיזציה להשגת ההמרות האלה.

currentModelAttributedConversionsFromInteractionsValuePerInteraction

number

הערך של המודל הנוכחי המרות שמשויכות לאינטראקציות חלקי מספר האינטראקציות עם מודעות. הנתון הזה כולל רק פעולות המרה שהמאפיין IncludeInConversionsMetric מוגדר כ-True. אם משתמשים בבידינג מבוסס המרות, המערכת תבצע אופטימיזציה להשגת ההמרות האלה.

currentModelAttributedConversionsValue

number

הערך של ההמרות המשויכות למודל הנוכחי. הנתון הזה כולל רק פעולות המרה שהמאפיין IncludeInConversionsMetric מוגדר כ-True. אם אתם משתמשים בבידינג מבוסס-המרות, שיטות הבידינג יבצעו אופטימיזציה להשגת ההמרות האלה.

currentModelAttributedConversionsValuePerCost

number

הערך של ההמרות המשויכות למודל הנוכחי חלקי העלות של האינטראקציות עם המודעות. המדד הזה כולל רק פעולות המרה שהמאפיין includeInConversionsMetric מוגדר עבורן כ-true. אם אתם משתמשים בבידינג מבוסס-המרות, שיטות הבידינג יבצעו אופטימיזציה להשגת ההמרות האלה.

engagementRate

number

התדירות שבה אנשים מקיימים אינטראקציה עם המודעה אחרי שהיא מוצגת להם. הערך הזה מייצג את מספר ההרחבות של המודעה חלקי מספר הפעמים שהמודעה מוצגת.

engagements

string (int64 format)

מספר האינטראקציות. מעורבות מתרחשת כאשר צופה מרחיב מודעת Lightbox שלך. בעתיד ייתכן שסוגי מודעות אחרים יתמכו גם הם בערכי מעורבות.

hotelAverageLeadValueMicros

number

הערך הממוצע של הלידים על סמך קליקים.

hotelCommissionRateMicros

string (int64 format)

שיעור הצעת המחיר בעמלה ב-micros. עמלה בשיעור של 20% מיוצגת כ-200,000.

hotelExpectedCommissionCost

number

עלות עמלה צפויה. התוצאה של הכפלת ערך העמלה כפול שיעור ה-Hotel_commission_rate במטבע של המפרסם.

hotelPriceDifferencePercentage

number

ההפרש במחיר הממוצע בין המחיר שמוצע על ידי מפרסם המלון המדווח לבין המחיר הנמוך ביותר שמוצע על ידי המפרסם המתחרה.

hotelEligibleImpressions

string (int64 format)

מספר החשיפות ששותפי מלונות היו יכולים לקבל את ביצועי הפיד שלהם.

historicalQualityScore

string (int64 format)

ציון האיכות בעבר.

gmailForwards

string (int64 format)

מספר הפעמים שהמודעה הועברה למישהו אחר כהודעה.

gmailSaves

string (int64 format)

מספר הפעמים שמשתמש שמר את מודעת Gmail שלכם בתיבת הדואר הנכנס שלו כהודעה.

gmailSecondaryClicks

string (int64 format)

מספר הקליקים שהובילו לדף הנחיתה במצב המורחב של מודעות Gmail.

impressionsFromStoreReach

string (int64 format)

מספר הפעמים שהוצגה מודעה המבוססת על מיקום גיאוגרפי של חנות.

המדד הזה רלוונטי רק לפריטים בפיד.

impressions

string (int64 format)

מספר הפעמים שהמודעה שלכם הופיעה בדף תוצאות חיפוש או באתר ברשת Google.

interactionRate

number

התדירות שבה אנשים יוצרים אינטראקציה עם המודעה אחרי שהיא הוצגה להם. המדד הזה מייצג את מספר האינטראקציות חלקי מספר הפעמים שהמודעה הוצגה.

interactions

string (int64 format)

מספר האינטראקציות. אינטראקציה היא הפעולה העיקרית של המשתמש המשויכת לקליקים על פורמט מודעה במודעות טקסט ובמודעות שופינג, צפיות במודעות וידאו וכן הלאה.

invalidClickRate

number

אחוז הקליקים שסוננו מתוך המספר הכולל של הקליקים (קליקים שסוננו + קליקים שלא סוננו) במהלך תקופת הדיווח.

invalidClicks

string (int64 format)

מספר הקליקים ש-Google מחשיבה כלא חוקיים ולא מחייבת אותך בגינם.

messageChats

string (int64 format)

מספר הצ'אטים שהתחילו בהודעות בעקבות חשיפות של נכסים לשליחת הודעות שעמדו בדרישות למעקב אחר הודעות.

messageImpressions

string (int64 format)

מספר החשיפות של מודעות מסוג 'קליק לשליחת SMS' שעמדו בדרישות למעקב אחר שליחת הודעות.

messageChatRate

number

מספר הצ'אטים שהתקיימו בעקבות שליחת הודעה (messageChats) חלקי מספר החשיפות של הנכס לשליחת הודעות (messageImpressions). שיעור המקרים שבהם משתמש מתחיל צ'אט להעברת הודעות מחשיפת מודעה עם אפשרות להעברת הודעות ומעקב אחר הודעות מופעל. לתשומת ליבכם: שיעור ההמרה הזה יכול להיות גבוה מ-1.0 עבור חשיפה של הודעה נתונה.

mobileFriendlyClicksPercentage

number

אחוז הקליקים בניידים שהובילו לדף שמותאם לנייד.

optimizationScoreUplift

number

העלייה הכוללת בציון האופטימיזציה של כל ההמלצות.

optimizationScoreUrl

string

כתובת ה-URL של הדף של ציון האופטימיזציה בממשק האינטרנט של Google Ads. אפשר לבחור את המדד הזה מתוך customer או campaign ואפשר לפלח אותו לפי segments.recommendation_type. לדוגמה, הפונקציה SELECT metrics.optimization_score_url, segments.recommendation_type FROM customer תחזיר כתובת URL לכל שילוב ייחודי (לקוח, המלצהType).

organicClicks

string (int64 format)

מספר הפעמים שמשתמש לחץ על הרישום של האתר שלכם בתוצאות החיפוש ללא תשלום בתגובה לשאילתה מסוימת. פרטים נוספים זמינים בדף העזרה בכתובת https://support.google.com/google-ads/answer/3097241.

organicClicksPerQuery

number

מספר הפעמים שמשתמש לחץ על כרטיס המוצר של האתר שלכם בתוצאות החיפוש ללא תשלום (organicClicks) חלקי המספר הכולל של החיפושים שהחזירו דפים מהאתר שלכם (organicQueries). פרטים נוספים זמינים בדף העזרה בכתובת https://support.google.com/google-ads/answer/3097241.

organicImpressions

string (int64 format)

מספר הרישומים של האתר שלכם בתוצאות החיפוש ללא תשלום. פרטים נוספים זמינים בדף העזרה בכתובת https://support.google.com/google-ads/answer/3097241.

organicImpressionsPerQuery

number

מספר הפעמים שדף מהאתר שלכם הופיע בתוצאות חיפוש ללא תשלום (חשיפות אורגניות), חלקי מספר החיפושים שהחזירו את רישום האתר שלכם בתוצאות ללא תשלום (שאילתות רגילות). פרטים נוספים זמינים בדף העזרה בכתובת https://support.google.com/google-ads/answer/3097241.

organicQueries

string (int64 format)

המספר הכולל של חיפושים שהחזירו את רישום האתר שלכם בתוצאות החיפוש ללא תשלום. פרטים נוספים זמינים בדף העזרה בכתובת https://support.google.com/google-ads/answer/3097241.

percentNewVisitors

number

אחוז הסשנים בפעם הראשונה (מאנשים שלא ביקרו באתר לפני כן). מיובאים מ-Google Analytics.

phoneCalls

string (int64 format)

מספר שיחות הטלפון אופליין.

phoneImpressions

string (int64 format)

מספר החשיפות של מספר הטלפון אופליין.

phoneThroughRate

number

מספר שיחות הטלפון שהתקבלו (שיחות טלפון) חלקי מספר הפעמים שמספר הטלפון שלכם הוצג (חשיפות של מספר טלפון).

relativeCtr

number

שיעור הקליקים (CTR) שלכם חלקי שיעור הקליקים הממוצע של כל המפרסמים באתרים שבהם המודעות שלכם מוצגות. המדד הזה מודד את ביצועי המודעות שלכם באתרים של רשת המדיה בהשוואה למודעות אחרות באותם אתרים.

searchAbsoluteTopImpressionShare

number

אחוז החשיפות של מודעות שופינג או מודעות לרשת החיפוש של הלקוח שהופיעו במיקום הבולט ביותר בקמפיין שופינג. פרטים נוספים זמינים בכתובת https://support.google.com/google-ads/answer/7501826. כל ערך נמוך מ-0.1 מדווח כ-0.0999.

searchBudgetLostAbsoluteTopImpressionShare

number

המספר הזה מייצג את התדירות המשוערת שבה המודעה לא הייתה המודעה הראשונה בין המודעות שהוצגו בראש הדף בתוצאות החיפוש, בגלל תקציב נמוך. הערה: המדד 'נתח החשיפות במיקום הראשון בחיפוש שהוחמצו (תקציב)' מדווח בטווח שבין 0 ל-0.9. כל ערך מעל 0.9 ידווח כ-0.9001.

searchBudgetLostImpressionShare

number

אחוז הפעמים המשוער שבהן המודעה הייתה כשירה להופיע ברשת החיפוש, אבל לא הוצגה כי התקציב היה נמוך מדי. הערה: נתח החשיפות שהוחמצו בתקציב החיפוש מדווח בטווח של 0 עד 0.9. כל ערך מעל 0.9 ידווח כ-0.9001.

searchBudgetLostTopImpressionShare

number

המספר המשוער של התדירות שבה המודעה לא הופיעה סמוך לחלק העליון של תוצאות החיפוש האורגני בגלל תקציב נמוך. הערה: נתח החשיפות בראש הדף שהוחמצו בתקציב החיפוש מדווח בטווח של 0 עד 0.9. כל ערך מעל 0.9 ידווח כ-0.9001.

searchClickShare

number

מספר הקליקים שקיבלתם ברשת החיפוש, חלקי המספר המשוער של הקליקים שהייתם זכאים לקבל. הערה: המדד 'נתח קליקים בחיפוש' מדווח בטווח של 0.1 עד 1. כל ערך נמוך מ-0.1 מדווח כ-0.0999.

searchExactMatchImpressionShare

number

מספר החשיפות שקיבלתם חלקי המספר המשוער של חשיפות שהייתם יכולים לקבל ברשת החיפוש, עבור מונחי חיפוש שתאמו למילות המפתח שלכם במדויק (או שהיו גרסאות קרובות של מילת המפתח), בלי קשר לסוגי ההתאמה למילות המפתח. הערה: נתח החשיפות בהתאמה מדויקת ברשת החיפוש מדווח בטווח שבין 0.1 ל-1. כל ערך נמוך מ-0.1 ידווח כ-0.0999.

searchImpressionShare

number

מספר החשיפות שקיבלתם ברשת החיפוש חלקי המספר המשוער של החשיפות שהייתם יכולים לקבל. הערה: נתח החשיפות ברשת החיפוש מדווח בטווח של 0.1 עד 1. כל ערך נמוך מ-0.1 ידווח כ-0.0999.

searchRankLostAbsoluteTopImpressionShare

number

המספר שמשמש לביצוע הערכה של התדירות שבה המודעה לא הייתה המודעה הראשונה בין המודעות שהוצגו בראש תוצאות החיפוש בגלל דירוג מודעה נמוך. הערה: המדד 'נתח החשיפות במיקום הראשון בחיפוש שהוחמצו' מדווח בטווח של 0 עד 0.9. כל ערך מעל 0.9 מדווח כ-0.9001.

searchRankLostImpressionShare

number

האחוז המשוער של החשיפות ברשת החיפוש שהמודעות שלכם לא קיבלו עקב דירוג מודעה נמוך. הערה: נתח החשיפות שהוחמצו בדירוג החיפוש מדווח בטווח של 0 עד 0.9. כל ערך מעל 0.9 מדווח כ-0.9001.

searchRankLostTopImpressionShare

number

המספר המשוער של התדירות שבה המודעה לא הופיעה סמוך לחלק העליון של תוצאות החיפוש האורגני בגלל דירוג מודעה נמוך. הערה: המדד 'נתח החשיפות בראש הדף בחיפוש שהוחמצו' מדווח בטווח של 0 עד 0.9. כל ערך מעל 0.9 מדווח כ-0.9001.

searchTopImpressionShare

number

מספר החשיפות שהמודעות קיבלו כשהופיעו בין המודעות העליונות, בהשוואה למספר המשוער של החשיפות שהן היו כשירות לקבל בין המודעות העליונות. הערה: נתח החשיפות בראש הדף בחיפוש מדווח בטווח שבין 0.1 ל-1. כל ערך נמוך מ-0.1 מדווח כ-0.0999.

מודעות עליונות בדרך כלל מופיעות מעל התוצאות הרגילות העליונות, אבל בשאילתות חיפוש מסוימות, המודעות האלה יכולות להופיע גם מתחת להן.

searchVolume

object (SearchVolumeRange)

טווח נפח החיפושים בקטגוריה של מדדי התובנות לגבי מונח חיפוש.

speedScore

string (int64 format)

מדד שבודק את מהירות הטעינה של הדף שאליו מפנות המודעות לנייד, אחרי שמישהו לוחץ עליהן. הציון נע בסולם של 1 עד 10, כאשר 10 היא המהירות הגבוהה ביותר.

averageTargetCpaMicros

string (int64 format)

יעד העלות הממוצעת להמרה, או לא מוגדר אם הוא לא זמין (לדוגמה, בקמפיינים שהייתה בהם תנועה משיטות בידינג כוללות או מיעד עלות להמרה ללא יעד עלות להמרה).

averageTargetRoas

number

יעד ההחזר הממוצע על הוצאות הפרסום, או לא מוגדר אם הוא לא זמין (לדוגמה, בקמפיינים שהתקבלה בהם תנועה משיטות בידינג כוללות או משיטות בידינג שאינן 'יעד החזר על הוצאות פרסום').

topImpressionPercentage

number

אחוז החשיפות של המודעות שמוצגות סמוך לחלק העליון של תוצאות החיפוש האורגניות.

validAcceleratedMobilePagesClicksPercentage

number

אחוז הקליקים על מודעות שהובילו לדפי נחיתה מסוג Accelerated Mobile Pages‏ (AMP) ושמגיעים לדף AMP תקף.

valuePerAllConversions

number

הערך של כל ההמרות חלקי מספר כל ההמרות.

valuePerAllConversionsByConversionDate

number

הערך של כל ההמרות חלקי מספר כל ההמרות. אם בוחרים בעמודה הזו עם תאריך, הערכים בעמודה 'תאריך' מציינים את תאריך ההמרה. פרטים על העמודות by_conversion_date זמינים בכתובת https://support.google.com/google-ads/answer/9549009.

valuePerConversion

number

ערך ההמרות חלקי מספר ההמרות. המדד הזה כולל רק פעולות המרה שהמאפיין includeInConversionsMetric מוגדר עבורן כ-true. אם אתם משתמשים בבידינג מבוסס-המרות, שיטות הבידינג יבצעו אופטימיזציה להשגת ההמרות האלה.

valuePerConversionsByConversionDate

number

ערך ההמרות מחולק במספר ההמרות. המדד הזה כולל רק פעולות המרה שהמאפיין includeInConversionsMetric מוגדר עבורן כ-true. אם משתמשים בבידינג מבוסס המרות, המערכת תבצע אופטימיזציה להשגת ההמרות האלה. כשהעמודה הזו מסומנת עם תאריך, הערכים בעמודת התאריך מייצגים את תאריך ההמרה. פרטים על העמודות by_conversion_date זמינים בכתובת https://support.google.com/google-ads/answer/9549009.

valuePerCurrentModelAttributedConversion

number

הערך של ההמרות שמשויכות למודל הנוכחי חלקי מספר ההמרות. הנתון הזה כולל רק פעולות המרה שהמאפיין IncludeInConversionsMetric מוגדר כ-True. אם אתם משתמשים בבידינג מבוסס-המרות, שיטות הבידינג יבצעו אופטימיזציה להשגת ההמרות האלה.

videoQuartileP100Rate

number

אחוז החשיפות שבהן הצופה צפה בכל הסרטון.

videoQuartileP25Rate

number

אחוז החשיפות שבהן הצופה צפה ב-25% מהסרטון.

videoQuartileP50Rate

number

אחוז החשיפות שבהן הצופה צפה ב-50% מהסרטון.

videoQuartileP75Rate

number

אחוז החשיפות שבהן הצופה צפה ב-75% מהסרטון.

videoViewRate

number

מספר הצפיות שמודעת וידאו מסוג TrueView מקבלת חלקי מספר החשיפות שלה, כולל חשיפות של תמונות ממוזערות של מודעות TrueView ברשת המדיה.

videoViews

string (int64 format)

מספר הפעמים שאנשים צפו במודעות הווידאו שלכם.

viewThroughConversions

string (int64 format)

המספר הכולל של המרות בעקבות צפייה. המרות כאלה מתרחשות כשלקוח רואה מודעה של תמונה או מודעה של מדיה עשירה, ולאחר מכן משלים המרה באתר בלי ליצור אינטראקציה עם מודעה אחרת (למשל, לחיצה עליה).

allConversionsFromLocationAssetClickToCall

number

מספר הקליקים על לחצן השיחה בכל פלטפורמה של מיקום אחרי אירוע של מודעה לחיוב (קליק או חשיפה). המדד הזה מגיע מ'מיקום מבוסס-נכס'.

allConversionsFromLocationAssetDirections

number

מספר הקליקים על מסלול נסיעה בכל פלטפורמה של מיקום אחרי אירוע של מודעה לחיוב (קליק או חשיפה). המדד הזה מגיע מ'מיקום מבוסס-נכס'.

allConversionsFromLocationAssetMenu

number

מספר הקליקים על הקישור לתפריט בכל מיקום גיאוגרפי אחרי אירוע מודעה שכרוך בתשלום (קליק או חשיפה). המדד הזה מגיע מ'מיקום מבוסס-נכס'.

allConversionsFromLocationAssetOrder

number

מספר הקליקים על הזמנה בכל פלטפורמה של מיקום אחרי אירוע של מודעה לחיוב (קליק או חשיפה). המדד הזה מגיע מ'מיקום מבוסס-נכס'.

allConversionsFromLocationAssetOtherEngagement

number

מספר הסוגים האחרים של קליקים על פעולות מקומיות בכל פלטפורמה של מיקום אחרי אירוע של מודעה לחיוב (קליק או חשיפה). המדד הזה מגיע ממיקום מבוסס-נכס.

allConversionsFromLocationAssetStoreVisits

number

מספר משוער של ביקורים בחנות אחרי אירוע מודעה שכרוך בתשלום (קליק או חשיפה). המדד הזה מגיע ממיקום מבוסס-נכס.

allConversionsFromLocationAssetWebsite

number

מספר הקליקים על כתובת ה-URL של האתר בכל מיקום שבו מוצגת מודעה אחרי אירוע של מודעה שכרוך בתשלום (קליק או חשיפה). המדד הזה מגיע מ'מיקום מבוסס-נכס'.

eligibleImpressionsFromLocationAssetStoreReach

string (int64 format)

מספר החשיפות שבהן מיקום החנות הוצג או שהמיקום הזה שימש לטירגוט. המדד הזה מגיע מ'מיקום מבוסס-נכס'.

viewThroughConversionsFromLocationAssetClickToCall

number

מספר הקליקים על לחצן השיחה בכל פלטפורמה של מיקום אחרי חשיפה. המדד הזה מגיע מ'מיקום מבוסס-נכס'.

viewThroughConversionsFromLocationAssetDirections

number

מספר הקליקים על מסלול נסיעה בכל פלטפורמה של מיקום לאחר חשיפה. המדד הזה מגיע ממיקום מבוסס-נכס.

viewThroughConversionsFromLocationAssetMenu

number

מספר הקליקים על קישור לתפריט בכל פלטפורמה של מיקום אחרי חשיפה. המדד הזה מגיע מ'מיקום מבוסס-נכס'.

viewThroughConversionsFromLocationAssetOrder

number

מספר הקליקים על הזמנה בכל פלטפורמה של מיקום אחרי חשיפה. המדד הזה מגיע מ'מיקום מבוסס-נכס'.

viewThroughConversionsFromLocationAssetOtherEngagement

number

מספר הסוגים האחרים של קליקים על פעולות מקומיות בכל פלטפורמה של מיקום אחרי חשיפה. המדד הזה מגיע ממיקום מבוסס-נכס.

viewThroughConversionsFromLocationAssetStoreVisits

number

המספר המשוער של ביקורים בחנות לאחר חשיפה. המדד הזה מגיע מ'מיקום מבוסס-נכס'.

viewThroughConversionsFromLocationAssetWebsite

number

מספר הקליקים על כתובת האתר בכל פלטפורמה של מיקום אחרי חשיפה. המדד הזה מגיע מ'מיקום מבוסס-נכס'.

orders

number

המדד 'הזמנות' מייצג את המספר הכולל של המרות מסוג רכישה שקיבלתם, שמשויכות למודעות שלכם. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם המרה משויכת לאינטראקציות קודמות עם המודעות שלכם (קליקים עבור מודעות טקסט או מודעות שופינג, צפיות במודעות וידאו וכו') היא נספרת כהזמנה. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע וגם חולצה בהזמנה מהאתר. גם אם נרכשו 2 מוצרים, הדבר ייחשב להזמנה אחת. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות.

averageOrderValueMicros

string (int64 format)

המדד 'ערך הזמנה ממוצע' מייצג את ההכנסה הממוצעת מכל הזמנה שמשויכת למודעות שלכם. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. ערך ההזמנה הממוצע הוא ההכנסה הכוללת מההזמנות שלכם חלקי המספר הכולל של ההזמנות. דוגמה: קיבלתם 3 הזמנות שהניבו הכנסה בשווי 40 ש"ח, 60 ש"ח ו-80 ש"ח. ערך ההזמנה הממוצע הוא $‏15 = ($‏10 + $‏15 + $‏20)/3. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות.

averageCartSize

number

המדד 'גודל ממוצע של עגלת קניות' מייצג את מספר המוצרים הממוצע בכל הזמנה שמשויכת למודעות שלכם. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. הגודל הממוצע של עגלת הקניות הוא המספר הכולל של המוצרים שנמכרו חלקי המספר הכולל של ההזמנות שקיבלתם. דוגמה: קיבלתם 2 הזמנות, הראשונה כללה 3 מוצרים והשנייה כללה 2. הגודל הממוצע של עגלת הקניות הוא 2.5 מוצרים = (3 ועוד 2) חלקי 2. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות.

costOfGoodsSoldMicros

string (int64 format)

עלות המכר (COGS) היא העלות הכוללת של המוצרים שמכרתם בהזמנות שמשויכות למודעות שלכם. איך זה עובד: אתם יכולים להוסיף ערך של עלות המכר לכל מוצר ב-Merchant Center. אם תדווחו על המרות עם נתונים מעגלות קניות (CwCD), המערכת תשייך את המוצרים שמכרתם לערך עלות המכר שלהם, ותוכלו לחשב סכום הרווח ברוטו מכל הזמנה. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. ערך עלות המכר של הכובע הוא 12 ש"ח וערך עלות המכר של החולצה הוא 20 ש"ח. עלות המכר בהזמנה הזו היא 32 ש"ח = 12 ש"ח ועוד 20 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות.

grossProfitMicros

string (int64 format)

המדד 'רווח ברוטו' מייצג את הרווח מהזמנות שמשויכות למודעות שלכם, בניכוי עלות המכר (COGS). איך זה עובד: הרווח ברוטו מייצג את ההכנסה ממכירות שמשויכות למודעות שלכם, בניכוי עלות המכר. בחישוב של הרווח ברוטו נכללים רק מוצרים שיש להם ערך עלות מכר ב-Merchant Center. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע וגם חולצה בהזמנה מהאתר. מחיר הכובע הוא 40 ש"ח ומחיר החולצה הוא 80 ש"ח. ערך עלות המכר של הכובע הוא 12 ש"ח, אבל לחולצה אין ערך עלות מכר. רק הכובע ייכלל בחישוב של הרווח ברוטו של ההזמנה הזו. לכן, הרווח ברוטו הוא 28 ש"ח = (40 ש"ח פחות 12 ש"ח). המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות.

grossProfitMargin

number

המדד 'שולי רווח גולמי' מייצג את אחוז הרווח הגולמי מהזמנות שמשויכות למודעות שלכם, בניכוי עלות המכר (COGS). איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. כך מחשבים את שולי הרווח הגולמי: הרווח הגולמי חלקי ההכנסה הכוללת כפול 100%. בחישוב של שולי הרווח הגולמי נכללים רק מוצרים שיש להם ערך עלות מכר ב-Merchant Center. דוגמה: משתמש קנה כובע וחולצה בהזמנה באתר. מחיר הכובע הוא 40 ש"ח וערך עלות המכר שלו הוא 12 ש"ח. מחיר החולצה הוא 80 ש"ח, אבל אין לה ערך עלות מכר. רק הכובע ייכלל בחישוב שולי הרווח הגולמי של ההזמנה הזו, כי לכובע יש ערך עלות מכר. לכן, שולי הרווח הגולמי הוא 70% = (40 ש"ח פחות 12 ש"ח) חלקי 40 ש"ח כפול 100%. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות.

revenueMicros

string (int64 format)

המדד 'הכנסה' מייצג את הסכום הכולל שהרווחתם מהזמנות שמשויכות למודעות שלכם. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. ההכנסה מייצגת את הערך הכולל של כל ההזמנות שמשויכות למודעות שלכם, בניכוי כל ההנחות. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע וגם חולצה בהזמנה מהאתר. מחיר הכובע הוא 40 ש"ח ומחיר החולצה הוא 80 ש"ח. הנחה של 20 ש"ח חלה על ההזמנה כולה. ההכנסה מההזמנה הזו היא 100 ש"ח = (40 ש"ח ועוד 80 ש"ח) פחות 20 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות.

unitsSold

number

המדד 'יחידות שנמכרו' מייצג את המספר הכולל של המוצרים שנמכרו בהזמנות שמשויכות למודעות שלך. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. המדד 'יחידות שנמכרו' מייצג את המספר הכולל של המוצרים שנמכרו בכל ההזמנות שמשויכות למודעות שלך. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה וז'קט. מספר היחידות שנמכרו בהזמנה הזו הוא 3. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות.

crossSellCostOfGoodsSoldMicros

string (int64 format)

המדד 'עלות המכר של מכירת מוצר או שירות לא קשור (cross-sell)' מייצג את העלות הכוללת של המוצרים שנמכרו כתוצאה מפרסום של מוצר שונה. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא זהים, המכירה נחשבת כמכירת מוצר או שירות לא קשור. עלות המכר של מכירת מוצר או שירות לא קשור מייצגת את העלות הכוללת של המוצרים שנמכרו אבל לא פורסמו. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. ערך עלות המכר של הכובע הוא 12 ש"ח וערך עלות המכר של החולצה הוא 20 ש"ח. עלות המכר של מכירת מוצר או שירות לא קשור (cross-sell) של ההזמנה היא $5. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות.

crossSellGrossProfitMicros

string (int64 format)

המדד 'רווח ברוטו ממכירת מוצר או שירות לא קשור (cross-sell)' מייצג את הרווח ממוצרים שנמכרו כתוצאה מפרסום של מוצר שונה, בניכוי עלות המכר (COGS). איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול ברכישה הוא מוצר שנמכר. אם המוצרים האלה לא זהים, המכירה נחשבת כמכירת מוצר או שירות לא קשור. הרווח ברוטו ממכירת מוצר או שירות לא קשור מייצג את ההכנסה ממכירת מוצר או שירות לא קשור שמשויכת למודעות שלכם, בניכוי עלות המכר. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע וגם חולצה. מחיר החולצה הוא 80 ש"ח וערך עלות המכר שלה הוא 20 ש"ח. הרווח ברוטו ממכירת מוצר או שירות לא קשור (cross-sell) הוא 60 ש"ח = 80 ש"ח פחות 20 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות.

crossSellRevenueMicros

string (int64 format)

המדד 'הכנסה ממכירת מוצר או שירות לא קשור (cross-sell)' מייצג את הסכום הכולל שהרווחתם ממוצרים שנמכרו כתוצאה מפרסום של מוצר שונה. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא זהים, המכירה נחשבת כמכירת מוצר או שירות לא קשור. ההכנסה ממכירת מוצר או שירות לא קשור מייצגת את הערך הכולל שהרווחתם ממכירת מוצר או שירות לא קשור, שמשויכת למודעות שלכם. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. מחיר הכובע הוא 40 ש"ח ומחיר החולצה הוא 80 ש"ח. ההכנסה ממכירת מוצר או שירות לא קשור היא 80 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות.

crossSellUnitsSold

number

המדד 'מספר היחידות שנמכרו במסגרת מכירת מוצר או שירות לא קשור (cross sell)' מייצג את המספר הכולל של המוצרים שנמכרו כתוצאה מפרסום של מוצר שונה. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא זהים, המכירה נחשבת כמכירת מוצר או שירות לא קשור. מספר היחידות שנמכרו במסגרת מכירת מוצר או שירות לא קשור מייצג את המספר הכולל של המוצרים שנמכרו במסגרת מכירת מוצר או שירות לא קשור בכל ההזמנות שמשויכות למודעות שלכם. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה וז'קט. מספר היחידות שנמכרו במסגרת מכירת המוצר הלא קשור בהזמנה הזו הוא 2. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות.

leadCostOfGoodsSoldMicros

string (int64 format)

המדד 'עלות המכר בעקבות לידים' מייצג את העלות הכוללת של המוצרים שנמכרו כתוצאה מפרסום של אותם המוצרים. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה הוצג מוצר קשור (ראו מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, עלות המוצרים האלה תיכלל במדד 'עלות המכר בעקבות לידים'. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. ערך עלות המכר של הכובע הוא 12 ש"ח וערך עלות המכר של החולצה הוא 20 ש"ח. עלות המכר בעקבות לידים בהזמנה הזו היא 12 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות.

leadGrossProfitMicros

string (int64 format)

המדד 'רווח ברוטו מלידים' מייצג את הרווח ממוצרים שנמכרו כתוצאה מפרסום של אותם המוצרים, בניכוי עלות המכר (COGS). איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, אז ההכנסות מהמכירות האלה, בניכוי עלות המכר הן הרווח ברוטו מלידים. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע וגם חולצה. מחיר הכובע הוא 40 ש"ח וערך עלות המכר שלו הוא 12 ש"ח. הרווח ברוטו מלידים בהזמנה הזו הוא 28 ש"ח = 40 ש"ח פחות 12 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות.

leadRevenueMicros

string (int64 format)

המדד 'הכנסה מלידים' מייצג את הסכום הכולל שהרווחתם ממוצרים שנמכרו כתוצאה מפרסום של אותם המוצרים. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, הערך הכולל שהרווחת מהמכירות של המוצרים האלה יוצג בעמודה 'הכנסה מלידים'. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. מחיר הכובע הוא 40 ש"ח ומחיר החולצה הוא 80 ש"ח. ההכנסה מלידים בהזמנה הזו היא 40 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות.

leadUnitsSold

number

המדד 'יחידות לידים – נמכר' מייצג את המספר הכולל של המוצרים שנמכרו כתוצאה מפרסום של אותם המוצרים. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, המספר הכולל של המוצרים שנמכרו יוצג בעמודה 'יחידות לידים – נמכר'. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה וז'קט. המספר שיופיע בעמודה 'יחידות לידים – נמכר' לגבי ההזמנה הזו הוא 1. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות.

uniqueUsers

string (int64 format)

מספר המשתמשים הייחודיים שראו את המודעה במהלך תקופת הזמן המבוקשת. לא ניתן לצבור את המדד הזה, ואפשר לבקש אותו רק לטווחי תאריכים של 92 ימים או פחות. המדד הזה זמין עבור סוגי הקמפיינים הבאים: קמפיינים לרשת המדיה, קמפיינים של מודעות וידאו, קמפיינים מסוג Discovery וקמפיינים לקידום אפליקציות.

averageImpressionFrequencyPerUser

number

מספר הפעמים הממוצע שהמודעה שלך הוצגה למשתמש ייחודי במהלך פרק הזמן המבוקש. לא ניתן לצבור את המדד הזה, ואפשר לבקש אותו רק לטווח תאריכים של 92 ימים או פחות. המדד הזה זמין עבור סוגי הקמפיינים הבאים: קמפיינים לרשת המדיה, קמפיינים של מודעות וידאו, קמפיינים מסוג Discovery וקמפיינים לקידום אפליקציות.

InteractionEventType

Enum מתאר סוגים אפשריים של אינטראקציות בתשלום ואינטראקציות בחינם.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
CLICK לוחצים על 'אתר'. ברוב המקרים, האינטראקציה הזו מובילה למיקום חיצוני, בדרך כלל לדף הנחיתה של המפרסם. זהו גם ערך ברירת המחדל InteractionEventType לאירועי קליק.
ENGAGEMENT הכוונה המוצהרת של המשתמש ליצור אינטראקציה עם המודעה באתר.
VIDEO_VIEW המשתמש צפה במודעת וידאו.
NONE ברירת המחדל של InteractionEventType לאירועי המרה של מודעה. האפשרות הזו משמשת כששורה של המרה ממודעה לא מציינת שצריך 'להעלות' את האינטראקציות בחינם (לדוגמה, ההמרות ממודעות) ולדווח עליהן כחלק מהמדדים המרכזיים. אלו פשוט המרות אחרות (ממודעות).

SearchVolumeRange

טווח נפח החיפושים. נפח החיפושים בפועל נמצא בטווח הזה.

ייצוג ב-JSON
{
  "min": string,
  "max": string
}
שדות
min

string (int64 format)

הגבול התחתון של נפח החיפושים.

max

string (int64 format)

גבול עליון של נפח חיפוש.

פלחים

שדות של פלחים בלבד.

ייצוג JSON
{
  "adDestinationType": enum (AdDestinationType),
  "adNetworkType": enum (AdNetworkType),
  "budgetCampaignAssociationStatus": {
    object (BudgetCampaignAssociationStatus)
  },
  "clickType": enum (ClickType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionAttributionEventType": enum (ConversionAttributionEventType),
  "conversionLagBucket": enum (ConversionLagBucket),
  "conversionOrAdjustmentLagBucket": enum (ConversionOrAdjustmentLagBucket),
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "externalConversionSource": enum (ExternalConversionSource),
  "hotelCheckInDayOfWeek": enum (DayOfWeek),
  "hotelDateSelectionType": enum (HotelDateSelectionType),
  "hotelRateType": enum (HotelRateType),
  "hotelPriceBucket": enum (HotelPriceBucket),
  "keyword": {
    object (Keyword)
  },
  "monthOfYear": enum (MonthOfYear),
  "placeholderType": enum (PlaceholderType),
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "recommendationType": enum (RecommendationType),
  "searchEngineResultsPageType": enum (SearchEngineResultsPageType),
  "searchTermMatchType": enum (SearchTermMatchType),
  "slot": enum (Slot),
  "conversionValueRulePrimaryDimension": enum (ConversionValueRulePrimaryDimension),
  "skAdNetworkUserType": enum (SkAdNetworkUserType),
  "skAdNetworkAdEventType": enum (SkAdNetworkAdEventType),
  "skAdNetworkAttributionCredit": enum (SkAdNetworkAttributionCredit),
  "skAdNetworkCoarseConversionValue": enum (SkAdNetworkCoarseConversionValue),
  "skAdNetworkSourceType": enum (SkAdNetworkSourceType),
  "newVersusReturningCustomers": enum (ConvertingUserPriorEngagementTypeAndLtvBucket),
  "activityAccountId": string,
  "activityCity": string,
  "activityCountry": string,
  "activityRating": string,
  "activityState": string,
  "externalActivityId": string,
  "adGroup": string,
  "assetGroup": string,
  "auctionInsightDomain": string,
  "campaign": string,
  "conversionAction": string,
  "conversionActionName": string,
  "conversionAdjustment": boolean,
  "date": string,
  "geoTargetAirport": string,
  "geoTargetCanton": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetCounty": string,
  "geoTargetDistrict": string,
  "geoTargetMetro": string,
  "geoTargetMostSpecificLocation": string,
  "geoTargetPostalCode": string,
  "geoTargetProvince": string,
  "geoTargetRegion": string,
  "geoTargetState": string,
  "hotelBookingWindowDays": string,
  "hotelCenterId": string,
  "hotelCheckInDate": string,
  "hotelCity": string,
  "hotelClass": integer,
  "hotelCountry": string,
  "hotelLengthOfStay": integer,
  "hotelRateRuleId": string,
  "hotelState": string,
  "hour": integer,
  "interactionOnThisExtension": boolean,
  "month": string,
  "partnerHotelId": string,
  "productAggregatorId": string,
  "productCategoryLevel1": string,
  "productCategoryLevel2": string,
  "productCategoryLevel3": string,
  "productCategoryLevel4": string,
  "productCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productFeedLabel": string,
  "productItemId": string,
  "productLanguage": string,
  "productMerchantId": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "searchSubcategory": string,
  "searchTerm": string,
  "webpage": string,
  "week": string,
  "year": integer,
  "skAdNetworkConversionValue": string,
  "skAdNetworkSourceApp": {
    object (SkAdNetworkSourceApp)
  },
  "skAdNetworkSourceDomain": string,
  "skAdNetworkPostbackSequenceIndex": string,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
שדות
adDestinationType

enum (AdDestinationType)

סוג יעד המודעה.

adNetworkType

enum (AdNetworkType)

סוג רשת המודעות.

budgetCampaignAssociationStatus

object (BudgetCampaignAssociationStatus)

סטטוס השיוך של קמפיין התקציב.

clickType

enum (ClickType)

סוג קליק.

conversionActionCategory

enum (ConversionActionCategory)

קטגוריית פעולת ההמרה.

conversionAttributionEventType

enum (ConversionAttributionEventType)

סוג האירוע של שיוך ההמרות.

conversionLagBucket

enum (ConversionLagBucket)

ערך enum שמייצג את מספר הימים שחלפו בין החשיפה להמרה.

conversionOrAdjustmentLagBucket

enum (ConversionOrAdjustmentLagBucket)

ערך enum שמייצג את מספר הימים שחלפו מהחשיפה ועד להמרה או מהחשיפה ועד להתאמות של ההמרה.

dayOfWeek

enum (DayOfWeek)

יום בשבוע, למשל, MONDAY.

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)

סוג placeholder. ניתן להשתמש באפשרות הזו רק עם מדדים של פריטים בפיד.

productChannel

enum (ProductChannel)

הערוץ של המוצר.

productChannelExclusivity

enum (ProductChannelExclusivity)

בלעדיות בערוץ של המוצר.

productCondition

enum (ProductCondition)

מצב המוצר.

recommendationType

enum (RecommendationType)

סוג ההמלצה.

searchEngineResultsPageType

enum (SearchEngineResultsPageType)

הסוג של דף תוצאות החיפוש במנוע החיפוש.

searchTermMatchType

enum (SearchTermMatchType)

סוג ההתאמה של מילת המפתח שהפעילה את המודעה, כולל וריאציות.

slot

enum (Slot)

המיקום של המודעה.

conversionValueRulePrimaryDimension

enum (ConversionValueRulePrimaryDimension)

המאפיין הראשי של כללים לקביעת ערכי המרות שהוחלו. בעמודה NO_PARAM_APPLIED מוצג הערך הכולל המתועד של המרות שלא הוחל עליהן כלל לקביעת ערך. בעמודה ORIGINAL מוצג הערך המקורי של המרות שהופעל עליהן כלל לקביעת ערך. המאפיינים geo_LOCATION, DEVICE, AUDIENCE מציג את ההתאמה נטו אחרי החלת הכללים לקביעת ערך.

skAdNetworkUserType

enum (SkAdNetworkUserType)

סוג המשתמש של רשת המודעות ל-iOS Store Kit.

skAdNetworkAdEventType

enum (SkAdNetworkAdEventType)

אירוע מסוג 'רשת מודעות' של iOS Store Kit.

skAdNetworkAttributionCredit

enum (SkAdNetworkAttributionCredit)

קרדיט על שיוך (Attribution) ברשת המודעות של iOS Store Kit

skAdNetworkCoarseConversionValue

enum (SkAdNetworkCoarseConversionValue)

ערך המרה גס של רשת המודעות של iOS Store Kit.

skAdNetworkSourceType

enum (SkAdNetworkSourceType)

סוג המקור שבו הוצגה המודעה שהובילה להתקנה של iOS Store Kit Ad Network. המשמעות של ערך ריק היא שהפלח הזה לא רלוונטי. לדוגמה, קמפיין שאינו ל-iOS. אפשרות נוספת היא שדומיין המקור או אפליקציית המקור לא נכללו בדיווחים חוזרים על המרות (PostBack) שנשלחו על ידי Apple.

newVersusReturningCustomers

enum (ConvertingUserPriorEngagementTypeAndLtvBucket)

השיטה הזו מיועדת לפילוח המרות לפי לקוח חדש או לקוח חוזר. בדרך כלל משתמשים בפלח הזה כדי למדוד את ההשפעה של יעד צירוף לקוחות.

activityAccountId

string (int64 format)

מספר חשבון הפעילות.

activityCity

string

העיר שבה פעילות הנסיעות זמינה.

activityCountry

string

המדינה שבה פעילות הנסיעה זמינה.

activityRating

string (int64 format)

דירוג הפעילות.

activityState

string

המדינה שבה פעילות הנסיעה זמינה.

externalActivityId

string

מזהה הפעילות שסופק על ידי המפרסם.

adGroup

string

שם המשאב של קבוצת המודעות.

assetGroup

string

שם המשאב של קבוצת הנכסים.

auctionInsightDomain

string

הדומיין (כתובת ה-URL שמוצגת) של משתתף בדוח 'תובנות לגבי מכרזים'.

campaign

string

שם המשאב של הקמפיין.

conversionAction

string

שם המשאב של פעולת ההמרה.

conversionActionName

string

שם פעולת המרה.

conversionAdjustment

boolean

הפעולה הזו תפלח את עמודות ההמרות לפי ערך ההמרה וערך ההמרה המקוריים, לעומת השינויים שהתרחשו בעקבות שינוי ההמרות. שורה False מכילה את הנתונים כפי שצוין במקור; בעוד שבשורה True יש את הדלתא בין הנתונים עכשיו לנתונים כפי שצוין במקור. סיכום של שתי התוצאות לאחר ההתאמה.

date

string

התאריך שבו המדדים חלים. הפורמט הוא yyyy-MM-dd, לדוגמה, 2018-04-17.

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 (int64 format)

חלון ההזמנה של המלון בימים.

hotelCenterId

string (int64 format)

מזהה Hotel Center.

hotelCheckInDate

string

תאריך הצ'ק-אין במלון. הפורמט הוא yyyy-MM-dd.

hotelCity

string

העיר של בית המלון.

hotelClass

integer

דירוג המלון.

hotelCountry

string

המדינה של בית המלון.

hotelLengthOfStay

integer

משך השהייה במלון.

hotelRateRuleId

string

מזהה כלל של תעריף מלון.

hotelState

string

מדינת המלון.

hour

integer

השעה ביום כמספר בין 0 ל-23, כולל.

interactionOnThisExtension

boolean

בשימוש רק עם מדדים של פריטים בפיד. מציין אם מדדי האינטראקציה הופיעו בפריט בפיד עצמו, או בתוסף אחר או ביחידת מודעות אחרת.

month

string

חודש מיוצג על ידי התאריך של היום הראשון בחודש. בפורמט: yyyy-MM-dd.

partnerHotelId

string

מזהה מלון של שותף.

productAggregatorId

string (int64 format)

מזהה אתר האגרגטור של המוצר.

productCategoryLevel1

string

הקטגוריה (רמה 1) של המוצר.

productCategoryLevel2

string

הקטגוריה (רמה 2) של המוצר.

productCategoryLevel3

string

הקטגוריה (רמה 3) של המוצר.

productCategoryLevel4

string

הקטגוריה (רמה 4) של המוצר.

productCategoryLevel5

string

הקטגוריה (רמה 5) של המוצר.

productBrand

string

המותג של המוצר.

productCountry

string

שם המשאב של קבוע הטירגוט הגיאוגרפי למדינת המכירה של המוצר.

productCustomAttribute0

string

מאפיין מותאם אישית 0 של המוצר.

productCustomAttribute1

string

מאפיין מותאם אישית 1 של המוצר.

productCustomAttribute2

string

מאפיין מותאם אישית 2 של המוצר.

productCustomAttribute3

string

מאפיין מותאם אישית 3 של המוצר.

productCustomAttribute4

string

מאפיין מותאם אישית 4 של המוצר.

productFeedLabel

string

תווית הפיד של המוצר.

productItemId

string

מזהה הפריט של המוצר.

productLanguage

string

שם המשאב של קבוע השפה של שפת המוצר.

productMerchantId

string (int64 format)

מספר חשבון Merchant של המוצר.

productStoreId

string

מזהה החנות של המוצר.

productTitle

string

שם המוצר.

productTypeL1

string

סוג המוצר (רמה 1).

productTypeL2

string

הסוג (רמה 2) של המוצר.

productTypeL3

string

סוג (רמה 3) של המוצר.

productTypeL4

string

הסוג (רמה 4) של המוצר.

productTypeL5

string

הסוג (רמה 5) של המוצר.

quarter

string

הרבעון מיוצג על ידי התאריך של היום הראשון ברבעון. הרבעונים מבוססים על השנה הקלנדרית. לדוגמה, הרבעון השני של 2018 מתחיל ב-1 באפריל 2018. בפורמט: yyyy-MM-dd.

searchSubcategory

string

קטגוריית משנה של מונח חיפוש. מחרוזת ריקה מציינת את קטגוריית המשנה של כל מונחי החיפוש שלא התאימו לקטגוריית משנה אחרת.

searchTerm

string

מונח חיפוש.

webpage

string

שם המשאב של קריטריון קבוצת המודעות שמייצג קריטריון דף אינטרנט.

week

string

שבוע שמוגדר מיום שני עד ראשון, ומיוצג על ידי התאריך של יום שני. בפורמט: yyyy-MM-dd.

year

integer

שנה, בפורמט yyyy.

skAdNetworkConversionValue

string (int64 format)

ערך המרה של רשת המודעות של Store Kit ל-iOS. המשמעות היא שהפלח הזה לא רלוונטי, למשל, קמפיין שהוא לא ל-iOS.

skAdNetworkSourceApp

object (SkAdNetworkSourceApp)

האפליקציה שבה הוצגה המודעה שהובילה להתקנה של iOS Store Kit Ad Network. ערך Null מציין שהפלח הזה לא רלוונטי, למשל קמפיין ללא iOS, או שהוא לא היה נוכח בדוחות הדיווח החוזר שנשלחו על ידי Apple.

skAdNetworkSourceDomain

string

האתר שבו הוצגה המודעה שהובילה להתקנה של iOS Store Kit Ad Network. המשמעות של ערך ריק היא שהפלח הזה לא רלוונטי. לדוגמה, קמפיין שאינו ל-iOS או שהוא לא היה קיים בדיווחים חוזרים על המרות שנשלחו על ידי Apple.

skAdNetworkPostbackSequenceIndex

string (int64 format)

אינדקס רצף לדיווח חוזר על המרה (PostBack) ברשת המודעות של iOS Store Kit.

assetInteractionTarget

object (AssetInteractionTarget)

משמש רק עם המדדים CustomerAsset,‏ CampaignAsset ו-AdGroupAsset. מציין אם מדדי האינטראקציה התרחשו בנכס עצמו או בנכס אחר או ביחידת מודעות אחרת. אינטראקציות (למשל, קליקים) נספרות בכל החלקים של המודעה שמוצגת (למשל, המודעה עצמה ורכיבים אחרים כמו קישורי Sitelink) כשהם מוצגים יחד. כשהערך של interactionOnThisAsset הוא true, המשמעות היא שהאינטראקציות מתרחשות בנכס הספציפי הזה. כשהערך של interactionOnThisAsset הוא false, המשמעות היא שהאינטראקציות לא מתרחשות בנכס הספציפי הזה, אלא בחלקים אחרים של המודעה המוצגת שבה הנכס הזה מוצג.

AdDestinationType

מציגה את סוגי היעדים ב-Google Ads

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא ידוע בגרסה הזו.
NOT_APPLICABLE מודעות שלא נועדו להרחיק משתמשים ממודעות ליעדים אחרים
WEBSITE אתר
APP_STORE חנות האפליקציות של iOS או חנות Play
PHONE_CALL חייגן לשיחות
MAP_DIRECTIONS אפליקציית מפה
LOCATION_LISTING דף ייעודי למיקום
MESSAGE הודעת טקסט
LEAD_FORM טופס ליצירת לידים
YOUTUBE YouTube
UNMODELED_FOR_CONVERSIONS יעד מודעה להמרות עם מפתחות לא ידועים

AdNetworkType

פירוט של סוגי הרשתות ב-Google Ads.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא ידוע בגרסה הזו.
SEARCH חיפוש Google.
SEARCH_PARTNERS שותפי חיפוש.
CONTENT רשת המדיה.
MIXED כל הרשתות.
YOUTUBE YouTube
GOOGLE_TV Google TV

BudgetCampaignAssociationStatus

פלח BudgetCampaignAssociationStatus.

ייצוג JSON
{
  "status": enum (BudgetCampaignAssociationStatus),
  "campaign": string
}
שדות
status

enum (BudgetCampaignAssociationStatus)

סטטוס השיוך של התקציב לקמפיין.

campaign

string

שם המשאב של הקמפיין.

BudgetCampaignAssociationStatus

הסטטוסים האפשריים של השיוך בין התקציב לקמפיין.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
ENABLED הקמפיין משתמש כרגע בתקציב.
REMOVED הקמפיין כבר לא משתמש בתקציב.

ClickType

פירוט של סוגי הקליקים ב-Google Ads.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא מוכר בגרסה הזו.
BREADCRUMBS נתיבי ניווט.
BROADBAND_PLAN תוכנית פס רחב.
CALL_TRACKING שיחות טלפון שחויגו באופן ידני.
CALLS שיחות טלפון.
CLICK_ON_ENGAGEMENT_AD לוחצים על מודעה אינטראקטיבית מתרחבת.
GET_DIRECTIONS כיוון הנסיעה.
LOCATION_EXPANSION קבלת פרטי מיקום.
LOCATION_FORMAT_CALL התקשרו.
LOCATION_FORMAT_DIRECTIONS מסלול.
LOCATION_FORMAT_IMAGE תמונות.
LOCATION_FORMAT_LANDING_PAGE עוברים לדף הנחיתה.
LOCATION_FORMAT_MAP מפה
LOCATION_FORMAT_STORE_INFO מעבר אל מידע על החנות.
LOCATION_FORMAT_TEXT טקסט.
MOBILE_CALL_TRACKING שיחות טלפון לנייד.
OFFER_PRINTS הדפס הצעה.
OTHER אחר.
PRODUCT_EXTENSION_CLICKS הצעה של תיבת הרחבה למוצר.
PRODUCT_LISTING_AD_CLICKS שופינג – מוצר – אונליין.
STORE_LOCATOR הצגת מיקומים קרובים.
URL_CLICKS כותרת.
VIDEO_APP_STORE_CLICKS חנות אפליקציות.
VIDEO_CALL_TO_ACTION_CLICKS שכבת קריאה לפעולה.
VIDEO_CARD_ACTION_HEADLINE_CLICKS כרטיסים.
VIDEO_END_CAP_CLICKS מודעת סגירה לסרטון.
VIDEO_WEBSITE_CLICKS אתר.
WIRELESS_PLAN תוכנית אלחוטית.
PRODUCT_LISTING_AD_LOCAL שופינג – מוצר – מקומי.
PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL שופינג – מוצר – מקומי בריבוי ערוצים.
PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE שופינג - מוצר - אנליין בריבוי ערוצים.
PRODUCT_LISTING_ADS_COUPON שופינג – מוצר – שובר.
PRODUCT_LISTING_AD_TRANSACTABLE שופינג – מוצר – מכירה ב-Google.
PROMOTION_EXTENSION תוסף קידום מכירות.
HOTEL_PRICE מחיר המלון.
PRICE_EXTENSION תוסף מחיר.
HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION בחירת חדר במלון ב-Google.
SHOPPING_COMPARISON_LISTING שופינג – שירות השוואת מחירים.
CROSS_NETWORK ברשתות שונות. בקמפיינים למיקסום הביצועים ובקמפיינים מסוג Discovery.

ConversionAttributionEventType

סוג האירוע של ההמרות שמשויכות אליהן.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN מייצג ערך לא ידוע בגרסה הזו.
IMPRESSION ההמרה משויכת לחשיפה.
INTERACTION ההמרה משויכת לאינטראקציה.

ConversionLagBucket

הטיפוס הזה מייצג את מספר הימים שחלפו בין החשיפה להמרה.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
LESS_THAN_ONE_DAY קטגוריה של פרק הזמן מחשיפה להמרה: 0 עד יום אחד. הערך כולל 0 ימים, והערך לא של יום אחד.
ONE_TO_TWO_DAYS פרק הזמן מחשיפה להמרה של יום אחד עד יומיים. המחיר כולל יום אחד, ולא יומיים.
TWO_TO_THREE_DAYS פרק הזמן מחשיפה להמרה של יומיים עד 3 ימים. בטווח של יומיים נכללים, 3 ימים לא כלולים.
THREE_TO_FOUR_DAYS פרק הזמן מחשיפה להמרה מ-3 עד 4 ימים. 3 ימים כלולים, 4 ימים לא כלולים.
FOUR_TO_FIVE_DAYS פרק הזמן מחשיפה להמרה מ-4 עד 5 ימים. כולל 4 ימים, ולא 5 ימים.
FIVE_TO_SIX_DAYS פרק הזמן מחשיפה להמרה מ-5 עד 6 ימים. המחיר כולל 5 ימים, ולא 6 ימים.
SIX_TO_SEVEN_DAYS פרק הזמן מחשיפה להמרה מ-6 עד 7 ימים. כולל 6 ימים, ולא 7 ימים.
SEVEN_TO_EIGHT_DAYS פרק הזמן מחשיפה להמרה מ-7 עד 8 ימים. 7 ימים כלולים, 8 ימים לא כלולים.
EIGHT_TO_NINE_DAYS פרק הזמן מחשיפה להמרה מ-8 עד 9 ימים. 8 ימים נכללים, 9 ימים לא נכללים.
NINE_TO_TEN_DAYS חלוקה לפי חלון זמן מחשיפה להמרה של 9 עד 10 ימים. אפשר להזין 9 ימים, ולא 10 ימים.
TEN_TO_ELEVEN_DAYS קטגוריית זמן ההשהיה להמרה מ-10 ל-11 ימים. 10 ימים נכללים, 11 ימים לא נכללים.
ELEVEN_TO_TWELVE_DAYS קטגוריית זמן ההשהיה להמרה מ-11 ל-12 ימים. 11 ימים נכללים, 12 ימים לא נכללים.
TWELVE_TO_THIRTEEN_DAYS חלוקה של פרק הזמן מחשיפה להמרה ל-12 עד 13 ימים. 12 ימים נכללים, 13 ימים לא נכללים.
THIRTEEN_TO_FOURTEEN_DAYS פרק הזמן מחשיפה להמרה מ-13 עד 14 ימים. 13 ימים נכללים, 14 ימים לא נכללים.
FOURTEEN_TO_TWENTY_ONE_DAYS פרק הזמן מחשיפה להמרה מ-14 עד 21 ימים. החישוב כולל 14 ימים, ולא 21 יום.
TWENTY_ONE_TO_THIRTY_DAYS קטגוריה של פרק הזמן מחשיפה להמרה: 21 עד 30 ימים. החישוב כולל 21 יום, ולא 30 יום.
THIRTY_TO_FORTY_FIVE_DAYS חלוקה לפי חלון זמן מחשיפה להמרה של 30 עד 45 ימים. 30 ימים נכללים, 45 ימים לא נכללים.
FORTY_FIVE_TO_SIXTY_DAYS קטגוריה של פרק הזמן מחשיפה להמרה: 45 עד 60 ימים. 45 ימים כלולים, 60 ימים לא כלולים.
SIXTY_TO_NINETY_DAYS קטגוריה של פרק הזמן מחשיפה להמרה: 60 עד 90 ימים. 60 ימים כלולים, 90 ימים לא כלולים.

ConversionOrAdjustmentLagBucket

Enum שמייצג את מספר הימים שחלפו בין החשיפה להמרה או בין החשיפה להתאמות של ההמרה.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
CONVERSION_LESS_THAN_ONE_DAY קטגוריה של פרק הזמן מחשיפה להמרה: 0 עד יום אחד. הערך כולל 0 ימים, והערך לא של יום אחד.
CONVERSION_ONE_TO_TWO_DAYS פרק הזמן מחשיפה להמרה של יום אחד עד יומיים. המחיר כולל יום אחד, ולא יומיים.
CONVERSION_TWO_TO_THREE_DAYS פרק הזמן מחשיפה להמרה של יומיים עד 3 ימים. בטווח של יומיים נכללים, 3 ימים לא כלולים.
CONVERSION_THREE_TO_FOUR_DAYS פרק הזמן מחשיפה להמרה מ-3 עד 4 ימים. 3 ימים כלולים, 4 ימים לא כלולים.
CONVERSION_FOUR_TO_FIVE_DAYS פרק הזמן מחשיפה להמרה מ-4 עד 5 ימים. כולל 4 ימים, ולא 5 ימים.
CONVERSION_FIVE_TO_SIX_DAYS פרק הזמן מחשיפה להמרה מ-5 עד 6 ימים. המחיר כולל 5 ימים, ולא 6 ימים.
CONVERSION_SIX_TO_SEVEN_DAYS פרק הזמן מחשיפה להמרה מ-6 עד 7 ימים. כולל 6 ימים, ולא 7 ימים.
CONVERSION_SEVEN_TO_EIGHT_DAYS פרק הזמן מחשיפה להמרה מ-7 עד 8 ימים. 7 ימים כלולים, 8 ימים לא כלולים.
CONVERSION_EIGHT_TO_NINE_DAYS פרק הזמן מחשיפה להמרה מ-8 עד 9 ימים. 8 ימים נכללים, 9 ימים לא נכללים.
CONVERSION_NINE_TO_TEN_DAYS חלוקה לפי חלון זמן מחשיפה להמרה של 9 עד 10 ימים. אפשר להזין 9 ימים, ולא 10 ימים.
CONVERSION_TEN_TO_ELEVEN_DAYS קטגוריית זמן ההשהיה להמרה מ-10 ל-11 ימים. 10 ימים נכללים, 11 ימים לא נכללים.
CONVERSION_ELEVEN_TO_TWELVE_DAYS קטגוריית זמן ההשהיה להמרה מ-11 ל-12 ימים. 11 ימים נכללים, 12 ימים לא נכללים.
CONVERSION_TWELVE_TO_THIRTEEN_DAYS חלוקה של פרק הזמן מחשיפה להמרה ל-12 עד 13 ימים. 12 ימים נכללים, 13 ימים לא נכללים.
CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS פרק הזמן מחשיפה להמרה מ-13 עד 14 ימים. 13 ימים נכללים, 14 ימים לא נכללים.
CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS פרק הזמן מחשיפה להמרה מ-14 עד 21 ימים. החישוב כולל 14 ימים, ולא 21 יום.
CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS קטגוריה של פרק הזמן מחשיפה להמרה: 21 עד 30 ימים. החישוב כולל 21 יום, ולא 30 יום.
CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS חלוקה לפי חלון זמן מחשיפה להמרה של 30 עד 45 ימים. 30 ימים נכללים, 45 ימים לא נכללים.
CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS קטגוריה של פרק הזמן מחשיפה להמרה: 45 עד 60 ימים. 45 ימים כלולים, 60 ימים לא כלולים.
CONVERSION_SIXTY_TO_NINETY_DAYS פרק הזמן מחשיפה להמרה מ-60 עד 90 ימים. המחיר כולל 60 יום, ולא 90 יום.
ADJUSTMENT_LESS_THAN_ONE_DAY קטגוריית זמן ההשהיה של התאמת ההמרה מ-0 ליום אחד. 0 ימים נכללים, 1 יום לא נכלל.
ADJUSTMENT_ONE_TO_TWO_DAYS פרק הזמן מקליק להתאמה של המרה מיום אחד עד יומיים. יום אחד כלול, 2 ימים לא כלולים.
ADJUSTMENT_TWO_TO_THREE_DAYS חלוקה של עיכוב ההמרות להתאמה לקטגוריות של 2 עד 3 ימים. 2 ימים כלולים, 3 ימים לא כלולים.
ADJUSTMENT_THREE_TO_FOUR_DAYS פרק הזמן מחשיפה להמרה מ-3 עד 4 ימים. 3 ימים כלולים, 4 ימים לא כלולים.
ADJUSTMENT_FOUR_TO_FIVE_DAYS חלוקה של עיכוב ההמרות להתאמה לקטגוריות של 4 עד 5 ימים. כולל 4 ימים, ולא 5 ימים.
ADJUSTMENT_FIVE_TO_SIX_DAYS קטגוריית הזמן של השהיה בהתאמת המרות השתנתה מ-5 ל-6 ימים. המחיר כולל 5 ימים, ולא 6 ימים.
ADJUSTMENT_SIX_TO_SEVEN_DAYS קטגוריית הזמן של השהיה בהתאמת המרות השתנתה מ-6 ל-7 ימים. כולל 6 ימים, ולא 7 ימים.
ADJUSTMENT_SEVEN_TO_EIGHT_DAYS פרק הזמן מחשיפה להמרה מ-7 עד 8 ימים. 7 ימים נכללים, 8 ימים לא נכללים.
ADJUSTMENT_EIGHT_TO_NINE_DAYS חלוקת הזמן מחשיפה להמרה לצורך התאמת המרות השתנתה מ-8 ל-9 ימים. 8 ימים נכללים, 9 ימים לא נכללים.
ADJUSTMENT_NINE_TO_TEN_DAYS פרק הזמן מחשיפה להמרה מ-9 עד 10 ימים. אפשר להזין 9 ימים, ולא 10 ימים.
ADJUSTMENT_TEN_TO_ELEVEN_DAYS חלוקת ההמרות לפי חלון זמן מושהה של התאמות מ-10 ל-11 ימים. אפשר להזין 10 ימים, ולא 11 ימים.
ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS פרק הזמן מחשיפה להמרה מ-11 עד 12 ימים. 11 ימים נכללים, 12 ימים לא נכללים.
ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS פרק הזמן מחשיפה להמרה מ-12 עד 13 ימים. הערך כולל 12 ימים, ולא 13 ימים.
ADJUSTMENT_THIRTEEN_TO_FOURTEEN_DAYS פרק הזמן מחשיפה להמרה מ-13 עד 14 ימים. 13 ימים נכללים, 14 ימים לא נכללים.
ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS חלוקת ההמרות לפי חלון זמן מושהה של התאמות מ-14 ל-21 ימים. 14 ימים נכללים, 21 ימים לא נכללים.
ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS קטגוריית זמן ההשהיה של התאמות ההמרות השתנתה מ-21 ל-30 ימים. החישוב כולל 21 יום, ולא 30 יום.
ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS פרק הזמן מחשיפה להמרה מ-30 עד 45 ימים. החישוב כולל 30 יום, ולא 45 ימים.
ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS פרק הזמן מחשיפה להמרה מ-45 עד 60 ימים. 45 ימים כלולים, 60 ימים לא כלולים.
ADJUSTMENT_SIXTY_TO_NINETY_DAYS חלוקה של עיכוב ההמרה להתאמה ל-60 עד 90 ימים. 60 ימים כלולים, 90 ימים לא כלולים.
ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS פרק הזמן מחשיפה להמרה מ-90 עד 145 ימים. 90 ימים נכללים, 145 ימים לא נכללים.
CONVERSION_UNKNOWN קטגוריית פרק הזמן מחשיפה להמרה: UNKNOWN. הערך הזה רלוונטי לתאריכים לפני שקטגוריית פרק הזמן מחשיפה להמרה הייתה זמינה ב-Google Ads.
ADJUSTMENT_UNKNOWN קטגוריית זמן האחזור של התאמת ההמרה היא UNKNOWN. הערך הזה רלוונטי לתאריכים לפני שקטגוריית פרק הזמן מחשיפה להמרה הייתה זמינה ב-Google Ads.

ExternalConversionSource

מקור ההמרות החיצוני שמשויך ל-ConversionAction.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN מייצג ערך לא ידוע בגרסה הזו.
WEBPAGE המרה שמתרחשת כשמשתמש מנווט לדף אינטרנט מסוים אחרי צפייה במודעה. ההמרה מוצגת בממשק המשתמש של Google Ads בתור 'אתר'.
ANALYTICS המרה שמגיעה מיעד עסקי או מעסקה מקושרים ב-Google Analytics. ההמרה מוצגת בממשק המשתמש של Google Ads בתור 'Analytics'.
UPLOAD המרה באתר שמועלה דרך ConversionUploadService. ההמרה מוצגת בממשק המשתמש של Google Ads בתור 'ייבוא מקליקים'.
AD_CALL_METRICS המרה שמתרחשת כשמשתמש לוחץ על תוסף שיחה ישירות במודעה. ההמרה מוצגת בממשק המשתמש של Google Ads בתור 'שיחות ממודעות'.
WEBSITE_CALL_METRICS המרה שמתרחשת כשמשתמש מתקשר למספר טלפון שנוצר באופן דינמי (על ידי JavaScript מותקן) מאתר של מפרסם אחרי שלוחץ על מודעה. ההמרה מוצגת בממשק המשתמש של Google Ads בתור 'שיחות מהאתר'.
STORE_VISITS המרות שמתרחשות כשמשתמש מבקר בחנות קמעונאית של מפרסם אחרי לחיצה על מודעת Google. המרות מוצגות בממשק המשתמש של Google Ads בתור 'ביקורים בחנות פיזית'.
ANDROID_IN_APP המרות שמתרחשות כשמשתמש מבצע פעולה בתוך האפליקציה, כמו רכישה באפליקציה ל-Android. מוצגת בממשק המשתמש של Google Ads בתור 'פעולה בתוך האפליקציה ל-Android'.
IOS_IN_APP המרה שמתרחשת כשמשתמש מבצע פעולה בתוך האפליקציה, כמו רכישה באפליקציה ל-iOS. ההמרה מוצגת בממשק המשתמש של Google Ads בתור 'פעולה בתוך אפליקציה ל-iOS'.
IOS_FIRST_OPEN המרה שמתרחשת כשמשתמש פותח אפליקציה ל-iOS בפעם הראשונה. מוצגת בממשק המשתמש של Google Ads בתור 'התקנה של אפליקציה ל-iOS (פתיחה ראשונה)'.
APP_UNSPECIFIED המרות מדור קודם של אפליקציות שלא צוינה עבורן פלטפורמת אפליקציה. ההמרות האלה מוצגות בממשק המשתמש של Google Ads בתור 'אפליקציה לנייד'.
ANDROID_FIRST_OPEN המרה שמתרחשת כשמשתמש פותח אפליקציה ל-Android בפעם הראשונה. ההמרה מוצגת בממשק המשתמש של Google Ads בתור 'התקנת אפליקציה ל-Android (פתיחה ראשונה)'.
UPLOAD_CALLS המרה מסוג שיחה שהועלתה באמצעות ConversionUploadService. המרות מסוג שיחה מוצגות בממשק המשתמש של Google Ads בתור 'ייבוא משיחות'.
FIREBASE המרה שמגיעה מאירוע מקושר ב-Firebase. ההמרה מוצגת בממשק המשתמש של Google Ads בתור 'Firebase'.
CLICK_TO_CALL המרה שמתרחשת כשמשתמש לוחץ על מספר טלפון נייד, מוצגת בממשק המשתמש של Google Ads כ'קליקים על מספר טלפון'.
SALESFORCE המרה שמגיעה מ-Salesforce. מוצגת בממשק המשתמש של Google Ads בתור 'Salesforce.com'.
STORE_SALES_CRM המרה שמקורה ברכישות בחנות הפיזית שתועדו במערכת לניהול קשרי לקוחות (CRM). ההמרה מוצגת בממשק המשתמש של Google Ads בתור 'מכירות בחנות הפיזית (שותף נתונים)'.
STORE_SALES_PAYMENT_NETWORK המרה שמגיעה מרכישות בחנות הפיזית מרשת תשלומים. מוצגת בממשק המשתמש של Google Ads בתור 'מכירות בחנות (רשת תשלומים)'.
GOOGLE_PLAY המרה ב-Google Play ללא קוד; מוצגת בממשק המשתמש של Google Ads בתור 'Google Play'.
THIRD_PARTY_APP_ANALYTICS המרה שמגיעה מאירוע מקושר של ניתוח נתוני אפליקציות של צד שלישי. האירוע מוצג בממשק המשתמש של Google Ads בתור 'ניתוח נתוני אפליקציות של צד שלישי'.
GOOGLE_ATTRIBUTION המרה שנשלטת על ידי Google Attribution.
STORE_SALES_DIRECT_UPLOAD המרה למכירות בחנות הפיזית על סמך העלאות של נתוני מוכרים מאינטראקציה ישירה או מצד שלישי. מוצגים בממשק המשתמש של Google Ads בתור 'מכירות בחנות (העלאה ישירה)'.
STORE_SALES המרה מסוג מכירות בחנות פיזית שמבוססת על העלאות של נתוני מוכרים מאינטראקציה ישירה או מצד שלישי, ו/או על רכישות בחנות פיזית באמצעות כרטיסים מרשתות תשלומים. מוצג בממשק המשתמש של Google Ads בתור 'מכירות בחנות הפיזית'.
SEARCH_ADS_360 המרות שיובאו מנתוני Floodlight ב-Search Ads 360.
GOOGLE_HOSTED המרות שמתעדות פעולות מקומיות במוצרים ובשירותים של Google אחרי אינטראקציה עם מודעה.
FLOODLIGHT המרות שדוּוחו על ידי תגי Floodlight.
ANALYTICS_SEARCH_ADS_360 המרות שמגיעות מ-Google Analytics במיוחד עבור Search Ads 360. מוצג בממשק המשתמש של Google Ads בתור Analytics‏ (SA360).
FIREBASE_SEARCH_ADS_360 המרה שמגיעה מאירוע Firebase מקושר ב-Search Ads 360.
DISPLAY_AND_VIDEO_360_FLOODLIGHT המרה שדווחה על ידי Floodlight ל-DV360.

HotelRateType

דוגמאות לתעריפים אפשריים של מלונות.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא מוכר בגרסה הזו.
UNAVAILABLE פרטי סוג התעריף לא זמינים.
PUBLIC_RATE התעריפים זמינים לכולם.
QUALIFIED_RATE תעריף מועדון לקוחות זמין והוא עומד בדרישות בסיסיות, למשל תעריף ציבורי זמין. טיפול בממשק המשתמש יסומן בקו חוצה את התעריף הציבורי ויציין שיש הנחה למשתמש. מידע נוסף על תעריפים מוסמכים זמין בכתובת https://developers.google.com/hotels/hotel-ads/dev-guide/qualified-rates
PRIVATE_RATE תעריפים הזמינים למשתמשים שעומדים בקריטריונים מסוימים לזכאות, למשל, כל המשתמשים המחוברים, 20% מהמשתמשים בנייד, כל המשתמשים בנייד בקנדה וכו'.

HotelPriceBucket

Enum מתאר קטגוריות אפשריות של מחירי מלונות.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא מוכר בגרסה הזו.
LOWEST_UNIQUE המחיר הנמוך ביותר באופן בלעדי. השותף מציע את המחיר הנמוך ביותר, ואין שותפים אחרים שהמחיר שלהם נמצא בטווח סטייה קטן מהמחיר הזה.
LOWEST_TIED בין הנמוכים ביותר שהגיעו לשוויון. יש הבדל קטן בין המחיר של השותף לבין המחיר הנמוך ביותר.
NOT_LOWEST לא המחיר הנמוך ביותר. יש הבדל קטן בין המחירים של השותפים לבין המחיר הנמוך ביותר.
ONLY_PARTNER_SHOWN השותף היה היחיד שהוצג.

מילת מפתח

פלח של קריטריון של מילת מפתח.

ייצוג ב-JSON
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
שדות
info

object (KeywordInfo)

פרטי מילת המפתח.

adGroupCriterion

string

שם המשאב AdGroupCriterion.

SearchEngineResultsPageType

הסוג של דף תוצאות החיפוש במנוע החיפוש.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
ADS_ONLY בדף התוצאות של מנוע החיפוש נכללו רק מודעות.
ORGANIC_ONLY בדף התוצאות של מנוע החיפוש נכללו רק תוצאות רגילות.
ADS_AND_ORGANIC בדף תוצאות החיפוש של מנוע החיפוש נכללו גם מודעות וגם תוצאות אורגניות.

SearchTermMatchType

סוגי ההתאמה האפשריים של מילת מפתח שמפעילה מודעה, כולל וריאציות.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
BROAD התאמה רחבה.
EXACT התאמה מדויקת.
PHRASE התאמה לביטוי.
NEAR_EXACT התאמה מדויקת (גרסה קרובה).
NEAR_PHRASE התאמה לביטוי (גרסה קרובה).

משבצת

מציג את המיקומים האפשריים של המודעה.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא מוכר בגרסה הזו.
SEARCH_SIDE חיפוש Google: צד.
SEARCH_TOP חיפוש Google: עליון.
SEARCH_OTHER חיפוש Google: אחר.
CONTENT רשת המדיה של Google.
SEARCH_PARTNER_TOP שותפי חיפוש: עליון.
SEARCH_PARTNER_OTHER שותפי חיפוש: אחר.
MIXED ברשתות שונות.

ConversionValueRulePrimaryDimension

מזהה את המאפיין הראשי של נתונים סטטיסטיים של כללים לקביעת ערך המרות.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
NO_RULE_APPLIED להמרות שהוחלו ללא ערך-כלל אחרי הפעלה של כלל לקביעת ערך.
ORIGINAL בהמשך מפורטות נתונים סטטיסטיים מקוריים של המרות שהוחלה עליהן כלל לקביעת ערך.
NEW_VS_RETURNING_USER כשמתקיים תנאי של לקוח חדש או חוזר.
GEO_LOCATION כאשר התנאי של המיקום הגיאוגרפי מתקיים בזמן השאילתה.
DEVICE כשמתקיים תנאי של מכשיר לגלישה בזמן שאילתה.
AUDIENCE כשמתקיים תנאי קהל בזמן שאילתה.
MULTIPLE כשמפעילים כמה כללים.

SkAdNetworkUserType

מציגה את סוגי המשתמשים ב-SKAdNetwork

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא ידוע בגרסה הזו.
UNAVAILABLE הערך לא היה קיים בדיווח החוזר על ההמרה, או שאין לנו את הנתונים האלה מסיבות אחרות.
NEW_INSTALLER המשתמש התקין את האפליקציה בפעם הראשונה.
REINSTALLER המשתמש התקין את האפליקציה בעבר.

SkAdNetworkAdEventType

פירוט של סוגי האירועים של מודעות ב-SkAdNetwork

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא ידוע בגרסה הזו.
UNAVAILABLE הערך לא היה קיים בדיווח החוזר על ההמרה, או שאין לנו את הנתונים האלה מסיבות אחרות.
INTERACTION המשתמש יצר אינטראקציה עם המודעה.
VIEW המשתמש צפה במודעה.

SkAdNetworkSourceApp

פלח SkAdNetworkSourceApp.

ייצוג JSON
{
  "skAdNetworkSourceAppId": string
}
שדות
skAdNetworkSourceAppId

string

מזהה האפליקציה שבו הוצגה המודעה שהובילה להתקנה של iOS Store Kit Ad Network.

SkAdNetworkAttributionCredit

חישוב קרדיטים על שיוך ל-SkAdNetwork.

טיפוסים בני מנייה (enum)
UNSPECIFIED ערך ברירת המחדל. הערך הזה שווה ל-null.
UNKNOWN הערך לא ידוע בגרסת ה-API הזו. לא ניתן להחזיר את הערך האמיתי של enum בגרסת ה-API הזו או שהוא עדיין לא נתמך.
UNAVAILABLE הערך לא היה קיים בדיווח החוזר על ההמרה, או שאין לנו את הנתונים האלה מסיבות אחרות.
WON Google הייתה רשת המודעות שזכתה בייחוס מודעות.
CONTRIBUTED Google עמדה בדרישות לשיוך, אבל לא זכתה.

SkAdNetworkSourceType

מציגה את סוגי המקורות ב-SKAdNetwork

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא מוכר בגרסה הזו.
UNAVAILABLE מזהה האפליקציה המקורית או הדומיין המקור לא היו בדיווח החוזר, או שאין לנו את הנתונים האלה מסיבות אחרות.
WEBSITE המודעה הוצגה בדף אינטרנט.
MOBILE_APPLICATION המודעה הוצגה באפליקציה.

AssetInteractionTarget

פלח AssetInteractionTarget.

ייצוג JSON
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
שדות
asset

string

שם המשאב של הנכס.

interactionOnThisAsset

boolean

משמש רק עם המדדים CustomerAsset,‏ CampaignAsset ו-AdGroupAsset. מציין אם מדדי האינטראקציה התרחשו בנכס עצמו או בנכס אחר או ביחידת מודעות אחרת.

ConvertingUserPriorEngagementTypeAndLtvBucket

סיכום של סוגי האינטראקציות הקודמות של המשתמשים והקטגוריה של ערך חיי המשתמש שמשלימים המרות

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא ידוע בגרסה הזו.
NEW המשתמש שמשלים המרה הוא חדש למפרסם.
RETURNING המשתמש שמשלים המרה חוזר למפרסם. ההגדרה של 'חוזר' משתנה בהתאם לסוג ההמרה, למשל ביקור שני בחנות לעומת רכישה שנייה באינטרנט.
NEW_AND_HIGH_LTV המשתמש שהשלים המרה הוא משתמש חדש של המפרסם, ויש לו ערך גבוה של חיי משתמש.