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)

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

audience

object (Audience)

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

conversionAction

object (ConversionAction)

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

conversionCustomVariable

object (ConversionCustomVariable)

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

conversionGoalCampaignConfig

object (ConversionGoalCampaignConfig)

ה-ConversionGoalCampaignConfig בשאילתה.

conversionValueRule

object (ConversionValueRule)

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

conversionValueRuleSet

object (ConversionValueRuleSet)

כלל ערך ההמרה שהוגדר בשאילתה.

clickView

object (ClickView)

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

currencyConstant

object (CurrencyConstant)

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

customAudience

object (CustomAudience)

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

customConversionGoal

object (CustomConversionGoal)

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

customInterest

object (CustomInterest)

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

customer

object (Customer)

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

customerAsset

object (CustomerAsset)

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

customerAssetSet

object (CustomerAssetSet)

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

accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

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

customerCustomizer

object (CustomerCustomizer)

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

customerClient

object (CustomerClient)

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

customerConversionGoal

object (CustomerConversionGoal)

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)

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

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)

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

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)

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

androidPrivacySharedKeyGoogleAdGroup

object (AndroidPrivacySharedKeyGoogleAdGroup)

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

androidPrivacySharedKeyGoogleCampaign

object (AndroidPrivacySharedKeyGoogleCampaign)

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

androidPrivacySharedKeyGoogleNetworkType

object (AndroidPrivacySharedKeyGoogleNetworkType)

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

metrics

object (Metrics)

המדדים.

segments

object (Segments)

הפלחים.

AccountBudget

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

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

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

ייצוג 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)

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

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

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

approvedEndDateTime

string

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

approvedEndTimeType

enum (TimeType)

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

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

string (int64 format)

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

proposedSpendingLimitType

enum (SpendingLimitType)

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

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

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

approvedSpendingLimitMicros

string (int64 format)

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

approvedSpendingLimitType

enum (SpendingLimitType)

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

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

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

adjustedSpendingLimitMicros

string (int64 format)

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

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

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

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

adjustedSpendingLimitType

enum (SpendingLimitType)

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

AccountBudgetStatus

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

טיפוסים בני מנייה (enums)
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

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

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

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

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

string

פלט בלבד. שם המשאב של תצוגת השילוב של נכסים שמצורפים למודעות בקבוצת המודעות. מזהה השילוב הוא באורך של 128 ביט, כאשר 64 הביטים העליונים מאוחסנים בערך asset_combination_id_high ו-64 הביטים התחתונים מאוחסנים בערך asset_combination_id_low. שמות המשאבים של תצוגות מפורטות מסוג 'שילוב מודעות של קבוצת מודעות' מופיעים בפורמט הבא: 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

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

ייצוג 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}

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

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, ורשימות רימרקטינג עבור מודעות לרשת החיפוש (RLSA), שנצברו ברמת הקהל.

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

string

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

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

AdGroupCriterionSimulation

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

  1. DISPLAY - מילת מפתח - מחיר לקליק - UNIFORM
  2. חיפוש - מילת מפתח - מחיר לקליק - UNIFORM
  3. SHOPPING – LISTING_GROUP – CPC_Bid – UNIFORM
  4. בית מלון - LISTING_GROUP - מחיר לקליק - מחיר - UNIFORM
  5. בית מלון - 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

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

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

SimulationModificationMethod

טיפוסים בני מנייה (enum) שמתאר את השיטה שבה סימולציה משנה שדה.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
UNIFORM הערכים בסימולציה יושמו על כל הצאצאים של משאב נתון באופן אחיד. השינויים במשאבי הצאצא לא נלקחו בחשבון.
DEFAULT הערכים בסימולציה הוחלו על המשאב הנתון. השינויים במשאבי הצאצא נכללו, ואומדני התנועה לא כוללים את המשאבים האלה.
SCALING כל הערכים בסימולציה נמדדים לפי אותו גורם. לדוגמה, בקמפיין סימולציה של יעד עלות להמרה (TargetCpa), יעד הקמפיין וכל היעדים של קבוצות המודעות הוגדלו בפקטור של 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)

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

impressions

string (int64 format)

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

topSlotImpressions

string (int64 format)

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

שדה איחוד cpc_simulation_key_value. כשהשימוש ב-SimulationModifyMethod = UNIFORM או DEFAULT, הערך cpc_bid_micros מוגדר. כאשר SimulationModifyMethod = SCALING, מוגדר cpc_bid_scale_modifier. cpc_simulation_key_value יכול להיות רק אחד מהבאים:
cpcBidMicros

string (int64 format)

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

cpcBidScalingModifier

number

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

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 * [שבר].

biddableConversions

number

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

biddableConversionsValue

number

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

clicks

string (int64 format)

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

costMicros

string (int64 format)

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

impressions

string (int64 format)

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

topSlotImpressions

string (int64 format)

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

AdGroupSimulation

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

  1. חיפוש - CPC_bid - ברירת מחדל
  2. חיפוש - מחיר לקליק - UNIFORM
  3. חיפוש - TARGET_CPA – UNIFORM
  4. חיפוש - TARGET_ROAS - UNIFORM
  5. DISPLAY - CPC_bid - ברירת מחדל
  6. DISPLAY - CPC_Bid - UNIFORM
  7. DISPLAY - 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)

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

impressions

string (int64 format)

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

topSlotImpressions

string (int64 format)

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

interactions

string (int64 format)

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

שדה איחוד target_cpa_simulation_key_value. כשהשימוש ב-SimulationModifyMethod = UNIFORM או DEFAULT, target_cpa_micros מוגדרת. כשהסימולציה = SCALING מוגדרת, target_cpa_scale_modifier. target_cpa_simulation_key_value יכול להיות רק אחד מהבאים:
targetCpaMicros

string (int64 format)

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

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)

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

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/{asset_group_id}~{listing_group_filter_id}

assetGroup

string

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

assetGroupListingGroupFilter

string

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

AssetGroupTopCombinationView

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

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

string

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

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

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

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

CallType

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

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

GoogleVoiceCallStatus

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

טיפוסים בני מנייה (enums)
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

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

  • חיפוש - מחיר לקליק - UNIFORM
  • חיפוש - מחיר לקליק - SCALING
  • חיפוש - TARGET_CPA – UNIFORM
  • חיפוש - 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 – ברירת מחדל
  • DISPLAY - TARGET_CPA – UNIFORM
  • PERFORMANCE_MAX - TARGET_CPA – UNIFORM
  • PERFORMANCE_MAX - TARGET_ROAS - UNIFORM
  • PERFORMANCE_MAX - תקציב - 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)

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

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)

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

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

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

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.

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

ChangeClientType

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

טיפוסים בני מנייה (enums)
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

Proto 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_CURRENCY.

campaign

object (Campaign)

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

campaignBudget

object (CampaignBudget)

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

adGroupBidModifier

object (AdGroupBidModifier)

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

campaignCriterion

object (CampaignCriterion)

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

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.

טיפוסים בני מנייה (enums)
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, יוגדרו השדות campaign (קמפיין) ו-adGroup.

resourceStatus

enum (ChangeStatusOperation)

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

sharedSet

string

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

campaignSharedSet

string

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

asset

string

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

customerAsset

string

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

campaignAsset

string

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

adGroupAsset

string

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

combinedAudience

string

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

lastChangeDateTime

string

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

campaign

string

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

adGroup

string

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

adGroupAd

string

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

adGroupCriterion

string

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

campaignCriterion

string

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

feed

string

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

feedItem

string

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

adGroupFeed

string

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

campaignFeed

string

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

adGroupBidModifier

string

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

ChangeStatusResourceType

רשימה של סוגי המשאבים שנתמכים במשאב ChangeStatus.

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

ChangeStatusOperation

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

טיפוסים בני מנייה (enums)
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

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

טיפוסים בני מנייה (enums)
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

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

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

ייצוג 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

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

שדה איחוד 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

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

MaximizeConversions

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

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

string (int64 format)

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

TargetCpa

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

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

string (int64 format)

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

TargetImpressionShare

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

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

enum (TargetImpressionShareLocation)

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

locationFractionMicros

string (int64 format)

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

cpcBidCeilingMicros

string (int64 format)

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

TargetRoas

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

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

number

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

TargetSpend

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

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

string (int64 format)

פלט בלבד. יעד ההוצאות שבו יש לקבל מקסימום קליקים. מגיש הצעות מחיר מסוג TargetSpend ינסה להוציא את הסכום הקטן יותר מהערך הזה או את סכום ההוצאות הטבעי של ויסות נתונים. אם לא מגדירים תקציב, היעד ישמש כיעד להוצאות. השדה הזה הוצא משימוש ולא ניתן להשתמש בו יותר. אפשר לקרוא פרטים נוספים בכתובת 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

פלט בלבד. ייצוג של מחרוזת נתוני Locale Data Repository (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

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

displayName

string

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

groupPlacementTargetUrl

string

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

targetUrl

string

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

PlacementType

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

טיפוסים בני מנייה (enums)
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 ו-includeDefaultChannelSubType מוגדר כ-False, הקמפיין לרשת המדיה שמוגדר כברירת מחדל שבו לא הוגדר סוג משנה של ערוץ, לא נכלל בהגדרת הזמינות הזו.

CriterionCategoryChannelAvailabilityMode

מספר ה-Enum שמכיל את הערך האפשרי criteriaCategoryChannelAvailabilityMode.

טיפוסים בני מנייה (enums)
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 המכיל את הקריטריון האפשריCategoryLocaleAvailabilityMode.

טיפוסים בני מנייה (enums)
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

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

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

string

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

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

distanceBucket

enum (DistanceBucket)

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

metricSystem

boolean

פלט בלבד. True אם מרחקBucket משתמש במערכת המטרית. אחרת, FALSE.

DistanceBucket

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

טיפוסים בני מנייה (enums)
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 המשתמש היה במרחק של ק"מ אחד מהמיקום.
WITHIN_1MILE המשתמש היה במרחק 1.6 ק"מ מהמיקום.
WITHIN_5MILES המשתמש היה במרחק של עד 8 ק"מ מהמיקום.
WITHIN_10MILES המשתמש היה במרחק 16 ק"מ מהמיקום.
WITHIN_15MILES המשתמש היה במרחק 24 ק"מ מהמיקום.
WITHIN_20MILES המשתמש היה במרחק 32 ק"מ מהמיקום.
WITHIN_25MILES המשתמש היה במרחק 40 ק"מ מהמיקום.
WITHIN_30MILES המשתמש היה במרחק 50 ק"מ מהמיקום.
WITHIN_35MILES המשתמש היה במרחק של 55 ק"מ מהמיקום.
WITHIN_40MILES המשתמש היה במרחק 60 ק"מ מהמיקום.
BEYOND_40MILES המשתמש היה במרחק של יותר מ-60 ק"מ מהמיקום.

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

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

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

string

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

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

GeographicView

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

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

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

string

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

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

locationType

enum (GeoTargetingType)

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

countryCriterionId

string (int64 format)

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

GeoTargetingType

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

טיפוסים בני מנייה (enums)
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

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

טיפוסים בני מנייה (enums)
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

פלט בלבד. השם המלא של השפה באנגלית, לדוגמה, "אנגלית (ארה"ב)", "ספרדית" וכו'.

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

סוג המדיה.

טיפוסים בני מנייה (enums)
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)

בלתי משתנה. נתונים גולמיים דחוסים.

מחרוזת בקידוד 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

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

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

LocalServicesEmployeeType

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

טיפוסים בני מנייה (enums)
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

משאב לאימות של שירותים מקומיים.

ייצוג 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

פלט בלבד. חותמת הזמן של מועד היצירה של פריט המידע שנוצר בתהליך האימות (Artifact). הפורמט הוא '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)

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

id

string (int64 format)

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

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

object (BackgroundCheckVerificationArtifact)

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

insuranceVerificationArtifact

object (InsuranceVerificationArtifact)

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

licenseVerificationArtifact

object (LicenseVerificationArtifact)

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

businessRegistrationCheckVerificationArtifact

object (BusinessRegistrationCheckVerificationArtifact)

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

LocalServicesVerificationArtifactStatus

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
PASSED האימות של פריט המידע שנוצר בתהליך הפיתוח (Artifact) עבר את האימות.
FAILED האימות של פריט המידע שנוצר בתהליך הפיתוח (Artifact) נכשל.
PENDING פריט המידע שנוצר בתהליך פיתוח (Artifact) נמצא בתהליך אימות.
NO_SUBMISSION ל-Artifact נדרשת העלאה של מידע לפני האימות.
CANCELLED פריט המידע שנוצר בתהליך הפיתוח (Artifact) בוטל על ידי המשתמש.

LocalServicesVerificationArtifactType

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
BACKGROUND_CHECK פריט מידע שנוצר בתהליך הפיתוח (Artifact) לאימות של בדיקת רקע.
INSURANCE פריט מידע שנוצר בתהליך אימות (Artifact) של אימות הביטוח.
LICENSE פריט מידע שנוצר בתהליך פיתוח (Artifact) לאימות רישיון.
BUSINESS_REGISTRATION_CHECK פריט מידע שנוצר בתהליך הפיתוח (Artifact) של אימות בדיקת רישום העסק.

BackgroundCheckVerificationArtifact

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

ייצוג 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

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

ייצוג JSON
{
  "amountMicros": string,
  "rejectionReason": enum (LocalServicesInsuranceRejectionReason),
  "insuranceDocumentReadonly": {
    object (LocalServicesDocumentReadOnly)
  }
}
שדות
amountMicros

string (int64 format)

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

rejectionReason

enum (LocalServicesInsuranceRejectionReason)

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

insuranceDocumentReadonly

object (LocalServicesDocumentReadOnly)

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

LocalServicesInsuranceRejectionReason

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
BUSINESS_NAME_MISMATCH שם העסק לא תואם לשם העסק במודעה של 'Google בעלי מקצוע'.
INSURANCE_AMOUNT_INSUFFICIENT סכום הביטוח לא עומד בדרישה הרשומה במסמכי הסיכומים המשפטיים לגבי השילוב הגיאוגרפי ומזהה הקטגוריה.
EXPIRED מסמך הביטוח לא בתוקף.
NO_SIGNATURE חסרה חתימה במסמך הביטוח.
NO_POLICY_NUMBER חסר מספר פוליסה במסמך הביטוח.
NO_COMMERCIAL_GENERAL_LIABILITY התיבה Commercial General Liability (CGL) (חבות מסחרית (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 כדי לגשת למסמך שכבר הועלה ב-'Google בעלי מקצוע'.

LicenseVerificationArtifact

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

ייצוג 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

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
BUSINESS_NAME_MISMATCH שם העסק לא תואם לשם העסק במודעה של 'Google בעלי מקצוע'.
UNAUTHORIZED הרישיון לא מורשה או בוטל.
EXPIRED פג תוקף הרישיון.
POOR_QUALITY הרישיון באיכות נמוכה - תמונות מטושטשות, לא קריאות וכו'...
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

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

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

LocalServicesBusinessRegistrationCheckRejectionReason

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

טיפוסים בני מנייה (enums)
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

סוג המכשיר הנייד.

טיפוסים בני מנייה (enums)
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

סוג הלקוח.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
GOOGLE_ADS_API ב-Google Ads API
GOOGLE_ADS_WEB_CLIENT לקוח אינטרנט של Google Ads, שיכול לכלול כמה מקורות, כמו ממשק המשתמש של Google Ads, SFTP וכו'.
ADS_DATA_CONNECTOR פלטפורמת החיבור.

OfflineConversionDiagnosticStatus

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

טיפוסים בני מנייה (enums)
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) שמתארים שגיאות אפשריות בגודל אוסף.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין Enum.
UNKNOWN קוד השגיאה שהתקבל אינו ידוע בגרסה הזו.
TOO_FEW מעט מדי.
TOO_MANY יותר מדי.

ConversionAdjustmentUploadError

מספר ה-Enum המתאר שגיאות העלאה אפשריות של התאמות המרה.

טיפוסים בני מנייה (enums)
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 צריך להשתמש בנתונים שהמשתמשים סיפקו, כמו כתובות אימייל או מספרי טלפון שעברו גיבוב (hash) באמצעות אלגוריתם 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

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין Enum.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
TOO_MANY_CONVERSIONS_IN_REQUEST מעלים פחות מ-2,001 אירועים בבקשה אחת.
UNPARSEABLE_GCLID לא ניתן לפענח את ה-GCLID שיובא. חשוב לוודא שלא שינית את מזהי הקליקים.
CONVERSION_PRECEDES_EVENT לאירוע המיובא יש conversionDateTime שלפני הקליק. צריך לוודא שהשדה conversionDateTime תקין ולנסות שוב.
EXPIRED_EVENT אי אפשר לתעד את האירוע שיובא כי הקליק שהוביל אליו התרחש לפני חלון ההמרות מהקליקים. צריך לייבא את הנתונים העדכניים ביותר.
TOO_RECENT_EVENT הקליק המשויך למזהה הנתון או לפרמטר של כתובת האתר ב-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 מוגדר כראוי ולנסות שוב.
DUPLICATE_CLICK_CONVERSION_IN_REQUEST לכמה אירועים יש את אותו קליק ואותו conversionDateTime. צריך לוודא שהconversionDateTime מוגדר בצורה נכונה ולנסות שוב.
DUPLICATE_CALL_CONVERSION_IN_REQUEST למספר אירועים יש את אותה שיחה ו-conversionDateTime. צריך לוודא שהconversionDateTime מוגדר בצורה נכונה ולנסות שוב.
CUSTOM_VARIABLE_NOT_ENABLED צריך להפעיל את המשתנה המותאם אישית בהגדרות ההמרה ולנסות שוב.
CUSTOM_VARIABLE_VALUE_CONTAINS_PII אי אפשר לייבא אירועים עם משתנים מותאמים אישית שמכילים פרטים אישיים מזהים (PII). צריך להסיר את המשתנים האלה ולנסות שוב.
INVALID_CUSTOMER_FOR_CLICK הקליק מהאירוע המיובא משויך לחשבון Google Ads אחר. צריך לוודא שהייבוא מתבצע לחשבון הנכון.
INVALID_CUSTOMER_FOR_CALL הקליק מהשיחה משויך לחשבון Google Ads אחר. צריך לוודא שהייבוא מתבצע לחשבון הנכון. צריך להריץ שאילתה על conversionTrackingSetting.google_ads_conversion_customer בחשבון הלקוח כדי לזהות את החשבון הנכון.
CONVERSION_NOT_COMPLIANT_WITH_ATT_POLICY אי אפשר לייבא את ההמרה כי מקור ההמרה לא עמד בדרישות של מדיניות Apple App Transparency Tracking (ATT) או כי הלקוח לא הסכים למעקב.
CLICK_NOT_FOUND לא ניתן להתאים את כתובת האימייל או את מספר הטלפון של האירוע הזה לקליק. יכול להיות שהנתונים האלה לא הגיעו מקמפיין שלGoogle Ads. במצב כזה, אפשר להתעלם מהאזהרה הזו. אם באזהרה מופיעים יותר אירועים מיובאים מהצפוי, כדאי לבדוק את ההגדרה.
INVALID_USER_IDENTIFIER צריך לוודא שהנתונים שהמשתמשים סיפקו באמצעות SHA-256 ולבצע נירמול בהתאם להנחיות.
EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION_NOT_PERMITTED_WITH_USER_IDENTIFIER אי אפשר להשתמש בנתונים שסופקו על ידי משתמשים במודלים חיצוניים של שיוך. צריך להשתמש במודל שיוך אחר או להשמיט את מזהי המשתמשים ולנסות שוב.
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 ב'לקוח'.
INVALID_JOB_ID מזהה המשימה שצוין בבקשה הוא לא בטווח המותר. מזהה משימה חייב להיות מספר שלם חיובי בטווח [1, 2^31).
NO_CONVERSION_ACTION_FOUND פעולת ההמרה שצוינה בבקשה ההעלאה לא נמצאה. צריך לוודא שהיא זמינה בחשבון הזה.
INVALID_CONVERSION_ACTION_TYPE פעולת ההמרה שצוינה בבקשת ההעלאה לא מוגדרת להעלאה של המרות.

DateError

טיפוסים בני מנייה (enum) שמתארים שגיאות תאריך אפשריות.

טיפוסים בני מנייה (enums)
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.sssss.
INVALID_STRING_DATE_TIME_SECONDS פורמט התאריך של המחרוזת צריך להיות yyyy-mm-dd hh:mm:ss.
INVALID_STRING_DATE_TIME_SECONDS_WITH_OFFSET פורמט התאריך של המחרוזת צריך להיות yyyy-mm-dd hh:mm:ss+|-hh:mm.
EARLIER_THAN_MINIMUM_DATE התאריך חל לפני המינימום המותר.
LATER_THAN_MAXIMUM_DATE התאריך חל אחרי המקסימום המותר.
DATE_RANGE_MINIMUM_DATE_LATER_THAN_MAXIMUM_DATE גבולות טווח התאריכים אינם בסדר.
DATE_RANGE_MINIMUM_AND_MAXIMUM_DATES_BOTH_NULL שני התאריכים בטווח הם null.

DistinctError

טיפוסים בני מנייה (enum) שמתארים שגיאות ייחודיות אפשריות.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין Enum.
UNKNOWN קוד השגיאה שהתקבל אינו ידוע בגרסה הזו.
DUPLICATE_ELEMENT רכיב כפול.
DUPLICATE_TYPE סוג כפול.

FieldError

טיפוסים בני מנייה (enum) שמתארים שגיאות שדה אפשריות.

טיפוסים בני מנייה (enums)
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) שמתאר שגיאות אפשריות בשינוי.

טיפוסים בני מנייה (enums)
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 אי אפשר להשתמש במשאב הזה בשילוב עם 'VerifyOnly'.
OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE לא ניתן להשתמש בפעולה זו עם "partialFailure".
RESOURCE_READ_ONLY מנסים לכתוב לשדות לקריאה בלבד.

NotAllowlistedError

טיפוסים בני מנייה (enum) שמתאר שגיאות אפשריות שלא נוספו לרשימת ההיתרים.

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

StringFormatError

Enum המתאר שגיאות אפשריות בפורמט מחרוזת.

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

StringLengthError

טיפוסים בני מנייה (enum) שמתאר שגיאות אפשריות של אורך מחרוזת.

טיפוסים בני מנייה (enums)
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

סוג הגרסה של מערכת ההפעלה.

טיפוסים בני מנייה (enums)
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

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

'qualifyQuestions/{qualificationQuestionId}'

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) שמתארים את המצב של קטגוריית המוצרים.

טיפוסים בני מנייה (enums)
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

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

טיפוסים בני מנייה (enums)
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

מספר הטיפוסים הטיפוסי UserInterestTaxonomyTypes האפשריים.

טיפוסים בני מנייה (enums)
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

פלט בלבד. הקטגוריה לטירגוט או להחרגה. כל רכיב נוסף במערך מתאר קטגוריית משנה ספציפית יותר. לדוגמה, {"חיות מחמד ובעלי חיים", "חיות מחמד", "כלבים"} מייצגים את הקטגוריה "חיות מחמד ובעלי חיים/חיות מחמד/כלבים". רשימת קטגוריות הנושאים הזמינות זמינה בכתובת 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

פלט בלבד. השפה שבה משתמש הספק ב-'Google בעלי מקצוע' שמקושר לליד. מידע נוסף זמין בכתובת 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

פלט בלבד. מספר הטלפון של הצרכן בפורמט E164.

email

string

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

consumerName

string

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

LeadType

סוגים אפשריים של לידים.

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

LeadStatus

סטטוסים אפשריים של ליד.

טיפוסים בני מנייה (enums)
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

מצבי קרדיט אפשריים של ליד.

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

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

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
EMAIL שליחת אימייל לליד.
MESSAGE שיחת ליד מהודעה.
PHONE_CALL שיחת ליד משיחת טלפון.
SMS שיחת SMS עם לידים.
BOOKING שיחת הליד של ההזמנה.

ParticipantType

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

טיפוסים בני מנייה (enums)
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

פלט בלבד. כתובת האתר של הקבצים המצורפים להודעות 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

פירוט של סוגי האינטראקציות

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

AndroidPrivacyNetworkType

פירוט של סוגי רשתות

טיפוסים בני מנייה (enums)
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)

מספר ההמרות ברשת מודעות ב-iOS Store Kit.

skAdNetworkTotalConversions

string (int64 format)

המספר הכולל של המרות ברשת מודעות ב-iOS Store Kit.

publisherPurchasedClicks

string (int64 format)

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

publisherOrganicClicks

string (int64 format)

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

publisherUnknownClicks

string (int64 format)

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

absoluteTopImpressionPercentage

number

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

activeViewCpm

number

מחיר ממוצע של חשיפות שניתנות לצפייה (activeViewImpressions).

activeViewCtr

number

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

ערך זה מדווח ברשת המדיה בלבד.

activeViewImpressions

string (int64 format)

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

activeViewMeasurability

number

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

activeViewMeasurableCostMicros

string (int64 format)

העלות של חשיפות שקיבלת שהיו ניתנות למדידה על ידי Active View.

activeViewMeasurableImpressions

string (int64 format)

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

activeViewViewability

number

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

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

מספר הפעמים שבוצעו קליקים על המודעה או על הרישום של האתר שלך בתוצאות ללא תשלום (CombinedClicks) חלקי שאילתות משולבות. פרטים נוספים זמינים בדף העזרה בכתובת 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

ערך ההמרה לטווח הארוך (CLV) של לקוחות חדשים. אם הגדרתם את היעד 'צירוף לקוחות' ברמת החשבון או ברמת הקמפיין, היעד הזה יכלול את ערך ההמרה הנוסף מלקוחות חדשים עבור המרות שניתן להגיש עליהן הצעות מחיר. אם הגדרתם בקמפיין את היעד 'צירוף לקוחות' ובחרתם באפשרות 'הצעת מחיר גבוהה יותר ללקוחות חדשים', הערכים האלה ייכללו בעמודה '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)

שיעור הצעת המחיר לעמלה במיליוניות השנייה. עמלה של 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)

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

messageImpressions

string (int64 format)

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

messageChatRate

number

מספר הצ'אטים בהודעות שהתחילו (messageChats) חלקי מספר החשיפות של ההודעות (חשיפות מ-message). שיעור המקרים שבהם משתמש יוזם צ'אט בהודעה בעקבות חשיפה של מודעה, כאשר האפשרות לשליחת הודעות והמעקב אחר ההודעות מופעלים. חשוב לזכור שהשיעור הזה יכול להיות גבוה מ-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 לכל שילוב ייחודי (לקוח, סוג המלצה).

organicClicks

string (int64 format)

מספר הפעמים שמשתמש לחץ על הרישום של האתר שלכם בתוצאות החיפוש ללא תשלום בתגובה לשאילתה מסוימת. פרטים נוספים זמינים בדף העזרה בכתובת https://support.google.com/google-ads/answer/3097241.

organicClicksPerQuery

number

מספר הפעמים שמשתמש לחץ על הרישום של האתר שלכם בתוצאות החיפוש ללא תשלום (organicClicks) חלקי המספר הכולל של חיפושים שהחזירו דפים מהאתר (organicQuery). פרטים נוספים זמינים בדף העזרה בכתובת 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

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

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

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

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)' מייצג את העלות הכוללת של המוצרים שנמכרו כתוצאה מפרסום של מוצר שונה. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר שלכם. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). עלות המכר של מכירת מוצר או שירות לא קשור מייצגת את העלות הכוללת של המוצרים שנמכרו אבל לא פורסמו. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. ערך עלות המכר של הכובע הוא 12 ש"ח וערך עלות המכר של החולצה הוא 20 ש"ח. עלות המכר של מכירת מוצר או שירות לא קשור בהזמנה הזו הוא 20 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות.

crossSellGrossProfitMicros

string (int64 format)

המדד 'רווח ברוטו ממכירת מוצר או שירות לא קשור (cross-sell)' מייצג את הרווח ממוצרים שנמכרו כתוצאה מפרסום של מוצר שונה, בניכוי עלות המכר (COGS). איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר שלכם. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול ברכישה הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). הרווח ברוטו ממכירת מוצר או שירות לא קשור מייצג את ההכנסה ממכירת מוצר או שירות לא קשור שמשויכת למודעות שלכם, בניכוי עלות המכר. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. מחיר החולצה הוא 80 ש"ח וערך עלות המכר שלה הוא 20 ש"ח. הרווח ברוטו ממכירת מוצר או שירות לא קשור (cross-sell) הוא 60 ש"ח = 80 ש"ח פחות 20 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות.

crossSellRevenueMicros

string (int64 format)

המדד 'הכנסה ממכירת מוצר או שירות לא קשור (cross-sell)' מייצג את הסכום הכולל שהרווחתם ממוצרים שנמכרו כתוצאה מפרסום של מוצר שונה. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר שלכם. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). ההכנסה ממכירת מוצר או שירות לא קשור מייצגת את הערך הכולל שהרווחתם ממכירת מוצר או שירות לא קשור, שמשויכת למודעות שלכם. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. מחיר הכובע הוא 40 ש"ח ומחיר החולצה הוא 80 ש"ח. ההכנסה ממכירת מוצר או שירות לא קשור היא 80 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות.

crossSellUnitsSold

number

המדד 'מספר היחידות שנמכרו במסגרת מכירת מוצר או שירות לא קשור (cross sell)' מייצג את המספר הכולל של המוצרים שנמכרו כתוצאה מפרסום של מוצר שונה. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר שלכם. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (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

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

טיפוסים בני מנייה (enums)
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)

סוג אירוע שיוך (Attribution) המרה.

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_BLOCK_APPLIED מציג את הערך המתועד הכולל של המרות שלא הוחל עליהן כלל לקביעת ערך. בעמודה 'מקורי' מוצג הערך המקורי של ההמרות שעליהם הוחל כלל לקביעת ערך. ב-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)

סוג המקור שבו הוצגה המודעה שהובילה להתקנה של Store Kit Ad Network. המשמעות של ערך null היא שהפלח הזה לא רלוונטי. לדוגמה, קמפיין שאינו ל-iOS, דומיין המקור או אפליקציית המקור לא היו קיימים בדיווחים חוזרים על המרות שנשלחו על ידי 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)

ערך ההמרה ברשת המודעות של iOS Store Kit. המשמעות של ערך null היא שהפלח הזה לא רלוונטי, למשל קמפיין שאינו ל-iOS.

skAdNetworkSourceApp

object (SkAdNetworkSourceApp)

האפליקציה שבה הוצגה המודעה שהובילה להתקנה של Store Kit Ad Network. המשמעות של ערך null היא שהפלח הזה לא רלוונטי, למשל קמפיין שאינו ל-iOS, או שהוא לא היה קיים בדיווחים חוזרים על המרות שנשלחו על ידי Apple.

skAdNetworkSourceDomain

string

האתר שבו הוצגה המודעה שהובילה להתקנה של Store Kit Ad Network. המשמעות של ערך null היא שהפלח הזה לא רלוונטי, למשל קמפיין שאינו ל-iOS, או שהוא לא היה קיים בדיווחים חוזרים על המרות שנשלחו על ידי Apple.

skAdNetworkPostbackSequenceIndex

string (int64 format)

אינדקס רצף לדיווח חוזר על המרה (PostBack) ב-iOS Store Kit Ad Network.

assetInteractionTarget

object (AssetInteractionTarget)

בשימוש רק עם המדדים CustomerAsset, CampaignAsset ו-GroupAsset. שדה זה מציין אם מדדי האינטראקציה התרחשו בנכס עצמו או בנכס אחר או ביחידת מודעות אחרת. אינטראקציות (לדוגמה, קליקים) נספרות בכל החלקים של המודעה שהוצגה (לדוגמה, המודעה עצמה ורכיבים אחרים כמו קישורי Sitelink) כשהן מוצגות יחד. כשהערך של InterThisAsset הוא TRUE, האינטראקציות הן בנכס הספציפי הזה. כאשר engagementOnThisAsset הוא FALSE, המשמעות היא שהאינטראקציות לא נכללות בנכס הספציפי הזה, אלא בחלקים אחרים של המודעה המוצגת שהנכס הזה מוצג איתה.

AdDestinationType

פירוט של סוגי היעדים ב-Google Ads

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא ידוע בגרסה הזו.
NOT_APPLICABLE מודעות שלא נועדו להערים על משתמשים ממודעות ליעדים אחרים
WEBSITE אתר
APP_STORE iOS App Store או חנות Play
PHONE_CALL חייגן לשיחות
MAP_DIRECTIONS אפליקציית מפות Google
LOCATION_LISTING דף ייעודי למיקום
MESSAGE הודעת טקסט
LEAD_FORM טופס ליצירת לידים
YOUTUBE YouTube
UNMODELED_FOR_CONVERSIONS יעד המודעה להמרות עם מפתחות לא ידועים

AdNetworkType

פירוט של סוגי הרשתות ב-Google Ads.

טיפוסים בני מנייה (enums)
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

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

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

ClickType

מפרט את סוגי הקליקים ב-Google Ads.

טיפוסים בני מנייה (enums)
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

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

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

ConversionLagBucket

טיפוסים בני מנייה (enum) שמייצג את מספר הימים בין החשיפה לבין ההמרה.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
LESS_THAN_ONE_DAY הקטגוריה של פרק הזמן מחשיפה להמרה מ-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

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
CONVERSION_LESS_THAN_ONE_DAY הקטגוריה של פרק הזמן מחשיפה להמרה מ-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 טווח הזמן שחלף מהקליק להמרה עד יום אחד. יום אחד לא נכלל, יום אחד לא נכלל.
ADJUSTMENT_ONE_TO_TWO_DAYS טווח הזמן שחלף מהקליק להמרה ביום אחד עד יומיים. יום אחד כלול, יומיים לא.
ADJUSTMENT_TWO_TO_THREE_DAYS טווח הזמן שחלף מהקליק להמרה ב-2 עד 3 ימים. יומיים כלולים, 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

מקור ההמרה החיצוני שמשויך לפעולת המרה.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN מייצג ערך לא ידוע בגרסה הזו.
WEBPAGE המרה שמתרחשת כשמשתמש מנווט לדף אינטרנט מסוים לאחר צפייה במודעה. המרה מוצגת בממשק המשתמש של Google Ads בתור 'אתר'.
ANALYTICS המרה שמגיעה מיעד או מעסקה מקושרים ב-Google Analytics. מוצגת בממשק המשתמש של Google Ads בתור 'Analytics'.
UPLOAD המרות באתר שהועלו דרך ConversionUploadService. המרה מוצגת בממשק המשתמש של Google Ads בתור 'ייבוא מקליקים'.
AD_CALL_METRICS המרה מתרחשת כאשר משתמש לוחץ על תוסף שיחה ישירות במודעה; מוצגת בממשק המשתמש של Google Ads בתור 'שיחות ממודעות'.
WEBSITE_CALL_METRICS המרה מתרחשת כאשר משתמש מתקשר למספר טלפון שנוצר באופן דינמי (על ידי JavaScript מותקן) מאתר של מפרסם אחרי לחיצה על מודעה. מוצגת בממשק המשתמש של Google Ads בתור 'שיחות מהאתר'.
STORE_VISITS המרה שמתרחשת כשמשתמש מבקר בחנות קמעונאית של המפרסם אחרי שלחץ על מודעת Google. המרה מוצגת בממשק המשתמש של Google Ads בתור 'ביקורים בחנות פיזית'.
ANDROID_IN_APP המרה מתרחשת כשמשתמש מבצע פעולה בתוך האפליקציה, כמו רכישה באפליקציה ל-Android, מוצגת בממשק המשתמש של Google Ads בתור 'פעולה בתוך אפליקציית Android'.
IOS_IN_APP המרה מתרחשת כשמשתמש מבצע פעולה בתוך האפליקציה, כמו רכישה באפליקציה ל-iOS, מוצגת בממשק המשתמש של Google Ads בתור 'פעולה בתוך אפליקציית iOS'.
IOS_FIRST_OPEN המרה שמתרחשת כשמשתמש פותח אפליקציה ל-iOS בפעם הראשונה; מוצגת בממשק המשתמש של Google Ads בתור 'התקנה של אפליקציה ל-iOS (פתיחה ראשונה)'.
APP_UNSPECIFIED המרות באפליקציה מדור קודם שלא סופקה עבורן פלטפורמת AppPlatform. מוצגות בממשק המשתמש של Google Ads כ 'אפליקציה לנייד'.
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) שמתארים סוגים אפשריים של תעריפי מלונות.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא ידוע בגרסה הזו.
UNAVAILABLE מידע על סוג התעריף לא זמין.
PUBLIC_RATE התעריפים זמינים לכולם.
QUALIFIED_RATE מחיר מועדון החברים זמין ועומד בדרישות בסיסיות, למשל תעריף ציבורי. המנגנון של ממשק המשתמש יסומן בקו חוצה את התעריף הציבורי, ויציין שיש הנחה למשתמש. מידע נוסף על תעריפים כשירים זמין בכתובת https://developers.google.com/hotels/hotel-ads/dev-guide/qualified-rates
PRIVATE_RATE תעריפים זמינים למשתמשים שעומדים בקריטריונים מסוימים לזכאות. לדוגמה: כל המשתמשים שמחוברים לחשבון, 20% מהמשתמשים בנייד, כל המשתמשים בנייד בקנדה וכו'.

HotelPriceBucket

טיפוסים בני מנייה (enum) שמתארים קטגוריות אפשריות של מחירי מלונות.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא ידוע בגרסה הזו.
LOWEST_UNIQUE המחיר הנמוך ביותר באופן בלעדי. המחיר של השותף הוא הנמוך ביותר, ואין שותפים אחרים שהמחיר שלהם שונה מעט.
LOWEST_TIED בין המחיר הנמוך ביותר. יש הבדל קטן בין השותף לבין המחיר הנמוך ביותר.
NOT_LOWEST לא המחיר הנמוך ביותר. אין הבדל קטן בין השותף לבין המחיר הנמוך ביותר.
ONLY_PARTNER_SHOWN השותף היה היחיד שהוצג.

מילת מפתח

פלח של קריטריון של מילת מפתח.

ייצוג JSON
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
שדות
info

object (KeywordInfo)

מידע על מילת מפתח.

adGroupCriterion

string

שם המשאב של GroupCriterion.

SearchEngineResultsPageType

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

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

SearchTermMatchType

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
BROAD התאמה רחבה.
EXACT התאמה מדויקת.
PHRASE התאמה לביטוי.
NEAR_EXACT התאמה מדויקת (גרסה קרובה).
NEAR_PHRASE התאמה לביטוי (גרסה קרובה).

משבצת

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא ידוע בגרסה הזו.
SEARCH_SIDE חיפוש Google: צד.
SEARCH_TOP חיפוש Google: עליון.
SEARCH_OTHER חיפוש Google: אחר.
CONTENT רשת המדיה של Google.
SEARCH_PARTNER_TOP שותפי חיפוש: עליון.
SEARCH_PARTNER_OTHER שותפי חיפוש: אחר.
MIXED ברשת אחרת.

ConversionValueRulePrimaryDimension

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
NO_RULE_APPLIED להמרות שלא הוחלו על כלל-ערך לאחר הפעלת הכלל לקביעת ערך.
ORIGINAL בהמשך מופיעים נתונים לגבי המרות שהוחלו על-כלל-ערך: הנתונים הסטטיסטיים המקוריים.
NEW_VS_RETURNING_USER כשמתקיים תנאי של לקוח חדש או חוזר.
GEO_LOCATION כאשר מתקיים תנאי של מיקום גיאוגרפי בזמן שאילתה.
DEVICE כשתנאי המכשיר לגלישה בזמן שאילתה מתקיים.
AUDIENCE כאשר מתקיים תנאי של קהל בזמן שאילתה.
MULTIPLE אם מחילים כמה כללים.

SkAdNetworkUserType

פירוט של סוגי המשתמשים ב-SkAdNetwork

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

SkAdNetworkAdEventType

פירוט של סוגי אירועי המודעות ב-SkAdNetwork

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

SkAdNetworkSourceApp

פלח של SkAdNetworkSourceApp.

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

string

מזהה האפליקציה שבה הוצגה המודעה שהובילה להתקנה של Store Kit Ad Network.

SkAdNetworkAttributionCredit

מציין את הקרדיטים לייחוס ב-SkAdNetwork.

טיפוסים בני מנייה (enums)
UNSPECIFIED ערך ברירת המחדל. הערך הזה שווה ל-null.
UNKNOWN הערך לא ידוע בגרסת ה-API הזו. אי אפשר להחזיר את הערך האמיתי של ה-enum בגרסת ה-API הזו, או שהוא עדיין לא נתמך.
UNAVAILABLE הערך לא הופיע בדיווח החוזר על ההמרה, או שאין לנו את הנתונים האלה מסיבות אחרות.
WON Google הייתה רשת המודעות שזכתה בייחוס המודעה.
CONTRIBUTED Google התאימה לשיוך, אבל לא זכתה.

SkAdNetworkSourceType

פירוט של סוגי המקורות של SkAdNetwork

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא ידוע בגרסה הזו.
UNAVAILABLE מזהה אפליקציית המקור או דומיין המקור לא היו בדיווח החוזר על ההמרה, או שאין לנו את הנתונים האלה מסיבות אחרות.
WEBSITE המודעה הוצגה בדף אינטרנט.
MOBILE_APPLICATION המודעה הוצגה באפליקציה.

AssetInteractionTarget

פלח AssetInteractionTarget.

ייצוג JSON
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
שדות
asset

string

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

interactionOnThisAsset

boolean

בשימוש רק עם המדדים CustomerAsset, CampaignAsset ו-GroupAsset. שדה זה מציין אם מדדי האינטראקציה התרחשו בנכס עצמו או בנכס אחר או ביחידת מודעות אחרת.

ConvertingUserPriorEngagementTypeAndLtvBucket

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא ידוע בגרסה הזו.
NEW המשתמש שמשלים המרה הוא חדש עבור המפרסם.
RETURNING משתמש שמבצע המרה חוזר למפרסם. ההגדרה של החזרה משתנה בין סוגי ההמרות, למשל ביקור שני בחנות לעומת רכישה שנייה באינטרנט.
NEW_AND_HIGH_LTV המשתמש שמשלים המרה הוא חדש עבור המפרסם, וערך חיי המשתמש שלו גבוה.