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)

هدف الإحالة الناجحة للحملة المشار إليه في طلب البحث.
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)

حدث التغيير المُشار إليه في طلب البحث.
changeStatus

object (ChangeStatus)

حالة التغيير المُشار إليها في طلب البحث.
combinedAudience

object (CombinedAudience)

Audience segmentation المشار إليها في طلب البحث.
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)

Custom Audience (الجمهور المخصّص) المُشار إليه في طلب البحث.
customConversionGoal

object (CustomConversionGoal)

هدف الإحالة الناجحة المخصّص المُشار إليه في طلب البحث
customInterest

object (CustomInterest)

الاهتمام المخصّص المُشار إليه في طلب البحث
customer

object (Customer)

العميل المُشار إليه في طلب البحث
customerAsset

object (CustomerAsset)

مادة عرض العميل المُشار إليها في طلب البحث
customerAssetSet

object (CustomerAssetSet)

مجموعة مواد العرض للعميل المشار إليها في طلب البحث.
accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

استراتيجية عروض الأسعار التي يمكن الوصول إليها والمُشار إليها في الطلب
customerCustomizer

object (CustomerCustomizer)

أداة تخصيص العملاء المشار إليها في طلب البحث.
customerClient

object (CustomerClient)

عنصر CustomerClient المُشار إليه في طلب البحث
customerConversionGoal

object (CustomerConversionGoal)

هدف الإحالة الناجحة للعميل المُشار إليه في طلب البحث
customerExtensionSetting

object (CustomerExtensionSetting)

إعداد إضافة العميل المُشار إليه في الطلب.
customerFeed

object (CustomerFeed)

خلاصة العملاء المُشار إليها في طلب البحث.
customerLabel

object (CustomerLabel)

تصنيف العميل المُشار إليه في الطلب
customerLifecycleGoal

object (CustomerLifecycleGoal)

هدف دورة حياة العميل المشار إليه في طلب البحث.
customerNegativeCriterion

object (CustomerNegativeCriterion)

المعيار السلبي للعميل المُشار إليه في طلب البحث.
customerSearchTermInsight

object (CustomerSearchTermInsight)

إحصاءات عبارات بحث العملاء المُشار إليها في طلب البحث
customerUserAccess

object (CustomerUserAccess)

CustomerUserAccess المُشار إليه في طلب البحث
customerUserAccessInvitation

object (CustomerUserAccessInvitation)

CustomerUserAccessدعوة المشار إليها في طلب البحث.
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)

عرض العنصر النائب للخلاصة المُشار إليه في طلب البحث
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)

طريقة عرض مجموعة المنتجات المشار إليها في طلب البحث.
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)

العميل المحتمل للخدمات المحلّية المشار إليه في طلب البحث.
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

ميزانية على مستوى الحساب يحتوي هذا التقرير على معلومات عن الميزانية نفسها، بالإضافة إلى التغييرات التي تمت الموافقة عليها مؤخرًا في الميزانية والتغييرات المقترَحة التي في انتظار الموافقة. يمكن العثور على التغييرات المقترَحة التي في انتظار الموافقة، إن توفّرت، في pendingProposal. يمكن العثور على التفاصيل السارية عن الميزانية في الحقول التي تحتوي على البادئة ‎"approved_" أو ‎"adjusted_" أو الحقول التي لا تحتوي على بادئة. بما أنّ بعض التفاصيل السارية قد تختلف عن ما طلبه المستخدم في الأصل (على سبيل المثال، حدّ الإنفاق)، يتمّ عرض هذه الاختلافات من خلال الحقلَين proposed_ وapproved_ وربما الحقل adjusted_.

يتم تغيير هذا المورد باستخدام AccountBudget Offer ولا يمكن تغييره مباشرةً. يمكن أن تتضمّن الميزانية اقتراحًا واحدًا في انتظار المراجعة بحد أقصى في أي وقت. ويتم قراءته من خلال pendingProposal.

بعد الموافقة على الميزانية، قد تخضع الميزانية للتعديلات، مثل تسويات الرصيد. تؤدّي التسويات إلى ظهور اختلافات بين الحقلَين "تمت الموافقة" و"تم التعديل"، لأنّهما كانا متطابقين في هذه الحالة.

تمثيل 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

النتائج فقط. اسم المورد للميزانية على مستوى الحساب. تكون أسماء موارد "ميزانية الحساب" على النحو التالي:

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

enum (AccountBudgetStatus)

النتائج فقط. حالة هذه الميزانية على مستوى الحساب.
totalAdjustmentsMicros

string (int64 format)

النتائج فقط. إجمالي مبلغ التسويات

ومن الأمثلة على التسوية الأرصدة التشجيعية.
amountServedMicros

string (int64 format)

النتائج فقط. قيمة الإعلانات التي تم عرضها بالمايكرو.

ويشمل هذا تكاليف العرض الزائد، وفي هذه الحالة قد يتم تطبيق الرصيد تلقائيًا على الميزانية (يُرجى الاطّلاع على "totalAdjustsMicros").
pendingProposal

object (PendingAccountBudgetProposal)

النتائج فقط. الاقتراح المعلّق لتعديل هذه الميزانية، إن وُجد
id

string (int64 format)

النتائج فقط. رقم تعريف الميزانية على مستوى الحساب.
billingSetup

string

النتائج فقط. اسم المورد لإعداد الفوترة المرتبط بهذه الميزانية على مستوى الحساب. تكون أسماء موارد BillingSetup على النحو التالي:

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

string

النتائج فقط. اسم الميزانية على مستوى الحساب.
proposedStartDateTime

string

النتائج فقط. وقت البدء المقترَح للميزانية على مستوى الحساب بالتنسيق yyyy-MM-dd HH:mm:ss إذا تم اقتراح نوع وقت بدء "NOW"، هذا هو وقت الطلب.
approvedStartDateTime

string

النتائج فقط. وقت البدء الموافق عليه للميزانية على مستوى الحساب بالتنسيق yyyy-MM-dd HH:mm:ss.

على سبيل المثال، إذا تمت الموافقة على ميزانية جديدة بعد وقت البدء المقترَح، يكون وقت البدء الموافَق عليه هو وقت الموافقة.
purchaseOrderNumber

string

النتائج فقط. رقم طلب الشراء هو قيمة تساعد المستخدمين في الإشارة إلى هذه الميزانية في فواتيرهم الشهرية.
notes

string

النتائج فقط. ملاحظات مرتبطة بالميزانية
حقل الربط proposed_end_time وقت الانتهاء المقترَح للميزانية على مستوى الحساب. يمكن أن يكون proposed_end_time واحدًا فقط مما يلي:
proposedEndDateTime

string

النتائج فقط. وقت الانتهاء المقترَح بالتنسيق yyyy-MM-dd HH:mm:ss.
proposedEndTimeType

enum (TimeType)

النتائج فقط. وقت الانتهاء المقترَح كنوع محدّد جيدًا، على سبيل المثال، FOREVER.

حقل الاتحاد approved_end_time. وقت الانتهاء الموافَق عليه للميزانية على مستوى الحساب.

على سبيل المثال، إذا تم تعديل وقت انتهاء الميزانية وتمّت الموافقة على الاقتراح بعد وقت الانتهاء المقترَح، يكون وقت الانتهاء الموافَق عليه هو وقت الموافقة. يمكن أن يكون approved_end_time واحدًا فقط مما يلي:
approvedEndDateTime

string

النتائج فقط. وقت الانتهاء الموافَق عليه بالتنسيق yyyy-MM-dd HH:mm:ss
approvedEndTimeType

enum (TimeType)

النتائج فقط. وقت الانتهاء الموافَق عليه كنوع محدّد جيدًا، مثل FOREVER
حقل الربط proposed_spending_limit حد الإنفاق المقترَح. يمكن أن يكون proposed_spending_limit واحدًا فقط مما يلي:
proposedSpendingLimitMicros

string (int64 format)

النتائج فقط. حدّ الإنفاق المقترَح بالمايكرو مليون واحد يساوي وحدة واحدة.
proposedSpendingLimitType

enum (SpendingLimitType)

النتائج فقط. حدّ الإنفاق المقترَح كنوع محدّد جيدًا، على سبيل المثال، INFINITE

حقل الاتحاد approved_spending_limit. الحدّ الأقصى للإنفاق الذي تمت الموافقة عليه.

على سبيل المثال، إذا كان المبلغ الذي أنفقه الحساب يتجاوز حدّ الإنفاق المقترَح في وقت الموافقة على الاقتراح، يتمّ ضبط حدّ الإنفاق الموافَق عليه على المبلغ الذي تمّ إنفاقه. يمكن أن يكون approved_spending_limit واحدًا فقط مما يلي:
approvedSpendingLimitMicros

string (int64 format)

النتائج فقط. حد الإنفاق الموافَق عليه بالمايكرو. مليون واحد يساوي وحدة واحدة. لن يتمّ تعبئة هذا الحقل إلّا إذا كان حدّ الإنفاق المقترَح محدودًا، وسيكون دائمًا أكبر من حدّ الإنفاق المقترَح أو يساويه.
approvedSpendingLimitType

enum (SpendingLimitType)

النتائج فقط. حدّ الإنفاق الموافَق عليه كنوع محدّد جيدًا، على سبيل المثال، INFINITE لن تتم تعبئة هذا الحقل إلا إذا كان حدّ الإنفاق الموافَق عليه هو "غير محدود".

حقل الاتحاد adjusted_spending_limit. حدّ الإنفاق بعد تطبيق التعديلات يتم تخزين التعديلات في total_adjustments_micros.

ولهذه القيمة الكلمة الأخيرة في المبلغ المسموح للحساب بإنفاقه. يمكن أن يكون adjusted_spending_limit واحدًا فقط مما يلي:
adjustedSpendingLimitMicros

string (int64 format)

النتائج فقط. حدّ الإنفاق المعدَّل بالمايكرو مليون واحد يساوي وحدة واحدة.

إذا كان حد الإنفاق الموافَق عليه محدودًا، قد يختلف حدّ الإنفاق المعدَّل حسب أنواع التسويات المطبَّقة على هذه الميزانية، إذا كان ذلك منطبقًا.

يمكن الاطّلاع على أنواع التعديلات المختلفة هنا: https://support.google.com/google-ads/answer/1704323

على سبيل المثال، يؤدي تعديل الخصم إلى تقليل المبلغ المسموح للحساب بإنفاقه.
adjustedSpendingLimitType

enum (SpendingLimitType)

النتائج فقط. حدّ الإنفاق المعدَّل كنوع محدّد جيدًا، على سبيل المثال، INFINITE لن تتم تعبئة هذا الحقل إلا إذا كان حد الإنفاق المعدَّل INFINITE، وهو مضمون مضمونًا إذا كان حد الإنفاق الذي تمت الموافقة عليه INFINITE.

AccountBudgetStatus

الحالات المحتملة لميزانية الحساب.

عمليات التعداد
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

النتائج فقط. اسم مورد الاقتراح. وتكون أسماء موارد AccountBudgetSuggested على النحو التالي:

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

string

النتائج فقط. الاسم الذي سيتمّ تعيينه للميزانية على مستوى الحساب.
startDateTime

string

النتائج فقط. وقت البدء بالتنسيق yyyy-MM-dd HH:mm:ss
purchaseOrderNumber

string

النتائج فقط. رقم طلب الشراء هو قيمة تساعد المستخدمين في الإشارة إلى هذه الميزانية في فواتيرهم الشهرية.
notes

string

النتائج فقط. الملاحظات المرتبطة بهذه الميزانية
creationDateTime

string

النتائج فقط. الوقت الذي تم فيه إنشاء اقتراح الميزانية على مستوى الحساب. تم التنسيق كـ yyyy-MM-dd HH:mm:ss.
حقل الربط end_time وقت انتهاء الميزانية على مستوى الحساب. يمكن أن يكون end_time واحدًا فقط مما يلي:
endDateTime

string

النتائج فقط. وقت الانتهاء بالتنسيق yyyy-MM-dd HH:mm:ss
endTimeType

enum (TimeType)

النتائج فقط. وقت الانتهاء كنوع محدّد جيدًا، على سبيل المثال، FOREVER
حقل الربط spending_limit حد الإنفاق. يمكن أن يكون spending_limit واحدًا فقط مما يلي:
spendingLimitMicros

string (int64 format)

النتائج فقط. حدّ الإنفاق بوحدات المايكرو مليون واحد يساوي وحدة واحدة.
spendingLimitType

enum (SpendingLimitType)

النتائج فقط. حدّ الإنفاق كنوع محدّد جيدًا، على سبيل المثال، INFINITE

AdGroupAdAssetCombinationView

عرض حول استخدام تركيبة مواد عرض الإعلانات للمجموعة الإعلانية ونوفّر الآن منتجات AdGroupAdAssetCombinationView فقط في "الإعلانات المتجاوبة على شبكة البحث"، ونخطّط لإجراء المزيد من أنواع الإعلانات في المستقبل.

تمثيل JSON 
{
  "resourceName": string,
  "servedAssets": [
    {
      object (AssetUsage)
    }
  ],
  "enabled": boolean
}
الحقول
resourceName

string

النتائج فقط. اسم المورد لعرض "مجموعة مواد عرض الإعلان على مستوى المجموعة الإعلانية". يبلغ طول معرف المجموعة 128 بت، حيث يتم تخزين أعلى 64 بت في asset_combination_id_high، بينما يتم تخزين القيم الأقل 64 بت في asset_combination_id_low. تكون أسماء موارد عرض مجموعة مواد العرض الإعلانية في المجموعة الإعلانية على النحو التالي: 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

النتائج فقط. الحالة بين مجموعة مواد العرض وأحدث نسخة من الإعلان. إذا كانت القيمة صحيحة، تكون مجموعة مواد العرض مرتبطة بأحدث إصدار من الإعلان. إذا كان القيمة خطأ، يعني ذلك أنّ الرابط كان متوفّرًا في السابق ولكن تمت إزالته ولم يعُد متوفّرًا في أحدث إصدار من الإعلان.

AssetUsage

تحتوي على معلومات استخدام مادة العرض.

تمثيل JSON 
{
  "asset": string,
  "servedAssetFieldType": enum (ServedAssetFieldType)
}
الحقول
asset

string

اسم المورِد الخاص بمادة العرض
servedAssetFieldType

enum (ServedAssetFieldType)

نوع حقل العرض لمادة العرض.

AdGroupAdAssetView

رابط بين إعلان مجموعة إعلانية ومادة عرض. لا نتيح حاليًا إلا AdGroupAdAssetView لكل من 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

النتائج فقط. الحالة بين مادة العرض وأحدث إصدار من الإعلان إذا كانت هذه القيمة صحيحة، يعني ذلك أنّ مادة العرض مرتبطة بأحدث نسخة من الإعلان. إذا كانت القيمة "خطأ"، يعني ذلك أنّ الرابط كان متوفرًا ولكن تمّت إزالته ولم يعُد متوفّرًا في أحدث إصدار من الإعلان.

AdGroupAdAssetPolicySummary

يحتوي على معلومات السياسة لمادة عرض إعلان مجموعة إعلانية.

تمثيل JSON 
{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}
الحقول
policyTopicEntries[]

object (PolicyTopicEntry)

النتائج فقط. قائمة نتائج السياسة الخاصة بمادة عرض إعلان المجموعة الإعلانية.
reviewStatus

enum (PolicyReviewStatus)

النتائج فقط. المرحلة التي وصلت إليها مادة عرض الإعلان في هذه المجموعة الإعلانية من عملية المراجعة
approvalStatus

enum (PolicyApprovalStatus)

النتائج فقط. حالة الموافقة العامة على مادة عرض الإعلان في المجموعة الإعلانية هذه، يتم احتسابها استنادًا إلى حالة إدخالات موضوع السياسة الفردية.

AdGroupAudienceView

طريقة عرض جمهور المجموعة الإعلانية. يتضمن بيانات الأداء من قوائم الاهتمامات وقوائم تجديد النشاط التسويقي للإعلانات على الشبكة الإعلانية وشبكة YouTube وقوائم تجديد النشاط التسويقي للإعلانات على شبكة البحث، المجمّعة على مستوى الجمهور.

تمثيل JSON 
{
  "resourceName": string
}
الحقول
resourceName

string

النتائج فقط. اسم المورد لعرض الجمهور على مستوى المجموعة الإعلانية. يكون شكل أسماء موارد عرض الجمهور على مستوى المجموعة الإعلانية على النحو التالي:

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

AdGroupCriterionSimulation

محاكاة معيار مجموعة إعلانية في ما يلي بالتفصيل التركيبات المسموح بها لنوع القناة الإعلانية ونوع المعيار ونوع المحاكاة وطريقة تعديل المحاكاة على التوالي. عمليات محاكاة HotelAdGroupCriterion بدءًا من الإصدار 5

  1. الشبكة الإعلانية - الكلمة الرئيسية - تكلفة النقرة (CPC_BID) - التوحيد
  2. شبكة البحث - الكلمة الرئيسية - CPC_BID - UNIFORM
  3. ‫SHOPPING - LISTING_GROUP - CPC_BID - UNIFORM
  4. HOTEL - LISTING_GROUP - CPM_BID - UNIFORM
  5. HOTEL - LISTING_GROUP - PERCENT_CPC_BID - UNIFORM
تمثيل JSON 
{
  "resourceName": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "adGroupId": string,
  "criterionId": string,
  "startDate": string,
  "endDate": string,

  // Union field point_list can be only one of the following:
  "cpcBidPointList": {
    object (CpcBidSimulationPointList)
  },
  "percentCpcBidPointList": {
    object (PercentCpcBidSimulationPointList)
  }
  // End of list of possible types for union field point_list.
}
الحقول
resourceName

string

النتائج فقط. اسم المورد لمحاكاة معيار المجموعة الإعلانية. تكون أسماء موارد محاكاة معايير المجموعة الإعلانية على النحو التالي:

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

enum (SimulationType)

النتائج فقط. الحقل الذي تعدّله المحاكاة.
modificationMethod

enum (SimulationModificationMethod)

النتائج فقط. كيفية تعديل المحاكاة للحقل
adGroupId

string (int64 format)

النتائج فقط. رقم تعريف المجموعة الإعلانية للمحاكاة.
criterionId

string (int64 format)

النتائج فقط. رقم تعريف المعيار للمحاكاة.
startDate

string

النتائج فقط. اليوم الأول الذي تستند إليه المحاكاة، بالتنسيق YYYY-MM-DD
endDate

string

النتائج فقط. آخر يوم تستند إليه المحاكاة، بالتنسيق YYYY-MM-DD
حقل الربط point_list قائمة بنقاط المحاكاة. يمكن أن يكون point_list واحدًا فقط مما يلي:
cpcBidPointList

object (CpcBidSimulationPointList)

النتائج فقط. نقاط المحاكاة إذا كان نوع المحاكاة هو CPC_BID
percentCpcBidPointList

object (PercentCpcBidSimulationPointList)

النتائج فقط. نقاط المحاكاة إذا كان نوع المحاكاة هو PERCENT_CPC_BID

SimulationType

يصف التعداد الحقل الذي تعدِّله المحاكاة.

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لأغراض القيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
CPC_BID هذه المحاكاة لعرض سعر النقرة.
CPV_BID هذه المحاكاة لعرض سعر تكلفة المشاهدة.
TARGET_CPA ترتبط المحاكاة بالتكلفة المستهدفة للإجراء.
BID_MODIFIER المحاكاة مخصّصة لمعدِّل عرض أسعار.
TARGET_ROAS تكون المحاكاة مخصّصة لهدف عائد الإنفاق الإعلاني.
PERCENT_CPC_BID تعتمد المحاكاة على عرض سعر النقرة بالنسبة المئوية.
TARGET_IMPRESSION_SHARE ترتبط المحاكاة باستهداف نسبة ظهور إعلان.
BUDGET المحاكاة مخصّصة لميزانية.

SimulationModificationMethod

مصنّف يصف الطريقة التي تعدّل بها المحاكاة حقلًا.

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لأغراض القيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
UNIFORM تم تطبيق القيم في المحاكاة على جميع العناصر الثانوية لمورد معين بشكل موحد. ولم تتم مراعاة عمليات الإلغاء على الموارد الفرعية.
DEFAULT تم تطبيق القيم في المحاكاة على المورد المحدّد. تمّت مراعاة عمليات الاستبدال في مصادر التطبيقات الفرعية، ولا تشمل تقديرات الزيارات هذه المصادر.
SCALING تمّ توسيع نطاق جميع القيم في المحاكاة باستخدام العامل نفسه. على سبيل المثال، في حملة محاكاة TargetCpa، تمّ تغيير نطاق استهداف الحملة وجميع استهدافات المجموعات الإعلانية بمقدار X.

CpcBidSimulationPointList

حاوية لنقاط المحاكاة المتعلقة بعمليات المحاكاة من النوع تكلفة النقرة (CPC_BID).

تمثيل JSON 
{
  "points": [
    {
      object (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. عندما يكون SimulationModificationMethod = UNIFORM أو DEFAULT، يتمّ ضبط cpc_bid_micros. عندما يتم SimulationModificationMethod = SCALING، يتم ضبط تكلفة النقرة_bid_scaling_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. شبكة البحث - CPM_BID - DEFAULT
  2. شبكة البحث -CPC_BID - UNIFORM
  3. شبكة البحث - TARGET_CPA - UNIFORM
  4. شبكة البحث - TARGET_ROAS - UNIFORM
  5. DISPLAY - CPC_BID - DEFAULT
  6. DISPLAY - CPC_BID - UNIFORM
  7. الشبكة الإعلانية - TARGET_CPA - موحدة
تمثيل 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)

العدد المتوقع للتفاعلات. لا يتوافق هذا الحقل إلا مع نوع قناة إعلانية أثناء التصفّح.
حقل الاتحاد target_cpa_simulation_key_value. عندما يكون SimulationModificationMethod = UNIFORM أو DEFAULT، يتم ضبط target_cpa_micros. عندما يكون SimulationModificationMethod = SCALING، يتمّ ضبط target_cpa_scaling_modifier. يمكن أن يكون target_cpa_simulation_key_value واحدًا فقط مما يلي:
targetCpaMicros

string (int64 format)

التكلفة المستهدفة للاكتساب التي تمّت محاكاتها والتي تستند إليها المقاييس المتوقّعة
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

النتائج فقط. اسم المورد لعرض جدول عرض الإعلانات. يكون شكل أسماء موارد عرض "جدول عرض الإعلانات" على النحو التالي:

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" وتنشئ إعلانات لها وتطابق عمليات البحث معها.
domain

string

النتائج فقط. نطاق الموقع الإلكتروني. يمكن تحديد النطاق في إعداد DynamicSearchAdsSettings المطلوب للإعلانات الديناميكية على شبكة البحث.
coverageFraction

number

النتائج فقط. جزء من صفحات موقعك التي تتطابق معها هذه الفئة.
categoryRank

string (int64 format)

النتائج فقط. موضع هذه الفئة في مجموعة الفئات. تشير الأرقام الأصغر إلى تطابق أفضل للنطاق. تشير القيمة null إلى عدم اقتراح ذلك.
hasChildren

boolean

النتائج فقط. تشير إلى ما إذا كانت هذه الفئة تتضمّن فئات فرعية.
recommendedCpcBidMicros

string (int64 format)

النتائج فقط. تمثّل هذه السمة تكلفة النقرة المقترَحة للفئة.

AssetFieldTypeView

عرض نوع حقل مادة العرض تُبلغ طريقة العرض هذه عن المقاييس غير المحسوبة لكل نوع من حقول مادة العرض عند استخدام مادة العرض كإضافة.

تمثيل JSON 
{
  "resourceName": string,
  "fieldType": enum (AssetFieldType)
}
الحقول
resourceName

string

النتائج فقط. اسم المورد لعرض نوع حقل مادة العرض يكون شكل أسماء الموارد في عرض نوع حقل مادة العرض على النحو التالي:

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

enum (AssetFieldType)

النتائج فقط. نوع حقل مادة العرض لعرض نوع حقل مادة العرض.

AssetGroupProductGroupView

طريقة عرض لمجموعة منتجات في مجموعة مواد العرض

تمثيل JSON 
{
  "resourceName": string,
  "assetGroup": string,
  "assetGroupListingGroupFilter": string
}
الحقول
resourceName

string

النتائج فقط. اسم المورد لطريقة عرض مجموعة المنتجات ضمن مجموعة مواد العرض تكون أسماء موارد عرض مجموعة المنتجات في مجموعة مواد العرض على النحو التالي:

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

string

النتائج فقط. مجموعة مواد العرض المرتبطة بفلتر مجموعة البيانات.
assetGroupListingGroupFilter

string

النتائج فقط. اسم المرجع لفلترة مجموعة بيانات مجموعة مواد العرض

AssetGroupTopCombinationView

عرض حول استخدام تركيبة مواد عرض الإعلانات للمجموعة الإعلانية

تمثيل JSON 
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
الحقول
resourceName

string

النتائج فقط. اسم المورد لعرض تركيبة من أعلى مجموعة مواد العرض وتكون أسماء موارد عرض "المجموعة الأفضل" في مجموعة مواد العرض على الشكل التالي: ""customers/{customerId}/assetGroupTopCombinationViews/{assetGroupId}~{asset_combination_category}""
assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

النتائج فقط. أهم مجموعات مواد العرض التي تم عرضها معًا

AssetGroupAssetCombinationData

بيانات تركيبات مواد العرض على مستوى مجموعة مواد العرض

تمثيل JSON 
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
الحقول
assetCombinationServedAssets[]

object (AssetUsage)

النتائج فقط. مواد العرض المعروضة

AssetSetTypeView

طريقة عرض نوع مجموعة مواد العرض تسجِّل طريقة العرض هذه المقاييس غير التي تم احتسابها بشكل زائد لكل نوع من أنواع مجموعات مواد العرض. لا يتم تضمين أنواع مجموعات مواد العرض الفرعية في هذا التقرير. ويتم تجميع إحصاءاتهم ضمن نوع مجموعة مواد العرض الرئيسية.

تمثيل JSON 
{
  "resourceName": string,
  "assetSetType": enum (AssetSetType)
}
الحقول
resourceName

string

النتائج فقط. اسم المورد لعرض نوع مجموعة مواد العرض يكون تنسيق أسماء الموارد في عرض نوع مجموعة مواد العرض على النحو التالي:

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

enum (AssetSetType)

النتائج فقط. نوع مجموعة مواد العرض لعرض نوع مجموعة مواد العرض

BiddingStrategySimulation

محاكاة استراتيجية عروض الأسعار في ما يلي تفاصيل المجموعات المتوافقة من نوع المحاكاة وطريقة تعديل المحاكاة على التوالي.

  1. TARGET_CPA - UNIFORM
  2. TARGET_ROAS - UNIFORM
تمثيل JSON 
{
  "resourceName": string,
  "biddingStrategyId": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "startDate": string,
  "endDate": string,

  // Union field point_list can be only one of the following:
  "targetCpaPointList": {
    object (TargetCpaSimulationPointList)
  },
  "targetRoasPointList": {
    object (TargetRoasSimulationPointList)
  }
  // End of list of possible types for union field point_list.
}
الحقول
resourceName

string

النتائج فقط. اسم المورد لمحاكاة استراتيجية عروض الأسعار. تكون أسماء موارد محاكاة استراتيجية عروض الأسعار على النحو التالي:

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

string (int64 format)

النتائج فقط. معرّف المجموعة المشترك للمحاكاة لاستراتيجية عروض الأسعار.
type

enum (SimulationType)

النتائج فقط. الحقل الذي تعدّله المحاكاة
modificationMethod

enum (SimulationModificationMethod)

النتائج فقط. كيفية تعديل المحاكاة للحقل
startDate

string

النتائج فقط. اليوم الأول الذي تستند إليه المحاكاة، بالتنسيق YYYY-MM-DD
endDate

string

النتائج فقط. آخر يوم تستند إليه المحاكاة، بالتنسيق YYYY-MM-DD
حقل الاتحاد point_list. قائمة بنقاط المحاكاة يمكن أن يكون point_list واحدًا فقط مما يلي:
targetCpaPointList

object (TargetCpaSimulationPointList)

النتائج فقط. نقاط المحاكاة إذا كان نوع المحاكاة هو TARGET_CPA
targetRoasPointList

object (TargetRoasSimulationPointList)

النتائج فقط. نقاط المحاكاة إذا كان نوع المحاكاة هو TARGET_ROAS

CallView

عرض مكالمات يتضمّن بيانات لتتبُّع المكالمات من الإعلانات المخصّصة للاتصال فقط أو إضافات المكالمات

تمثيل JSON 
{
  "resourceName": string,
  "callerCountryCode": string,
  "callerAreaCode": string,
  "callDurationSeconds": string,
  "startCallDateTime": string,
  "endCallDateTime": string,
  "callTrackingDisplayLocation": enum (CallTrackingDisplayLocation),
  "type": enum (CallType),
  "callStatus": enum (GoogleVoiceCallStatus)
}
الحقول
resourceName

string

النتائج فقط. اسم المورد لعرض المكالمة. تكون أسماء موارد عرض المكالمات على النحو التالي:

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

string

النتائج فقط. رمز بلد المتصل.
callerAreaCode

string

النتائج فقط. رمز منطقة المتصل قيمة فارغة إذا كانت مدة المكالمة أقصر من 15 ثانية
callDurationSeconds

string (int64 format)

النتائج فقط. مدة المكالمة التي يقدّمها المعلِن بالثواني.
startCallDateTime

string

النتائج فقط. وقت تاريخ بدء المكالمة الذي قدّمه المعلِن.
endCallDateTime

string

النتائج فقط. وقت تاريخ انتهاء المكالمة التي قدّمها المعلِن
callTrackingDisplayLocation

enum (CallTrackingDisplayLocation)

النتائج فقط. الموقع الجغرافي لعرض تتبُّع المكالمات
type

enum (CallType)

النتائج فقط. نوع المكالمة
callStatus

enum (GoogleVoiceCallStatus)

النتائج فقط. حالة المكالمة.

CallTrackingDisplayLocation

المواقع الجغرافية المحتملة لعرض ميزة "تتبُّع المكالمات"

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لأغراض القيمة المعروضة فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
AD المكالمة الهاتفية التي تم إجراؤها من الإعلان.
LANDING_PAGE المكالمة الهاتفية التي يتم إجراؤها من الإعلان على الصفحة المقصودة

CallType

أنواع المواقع المحتملة التي تم إجراء المكالمة منها

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لأغراض القيمة المعروضة فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
MANUALLY_DIALED تم طلب المكالمة الهاتفية يدويًا.

GoogleVoiceCallStatus

الحالات المحتمَلة لمكالمة على Google Voice

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
MISSED لم يتم الرد على المكالمة.
RECEIVED تم استلام المكالمة.

CampaignAudienceView

طريقة عرض جمهور الحملة يتضمن بيانات الأداء من قوائم الاهتمامات وقوائم تجديد النشاط التسويقي للإعلانات على الشبكة الإعلانية وشبكة YouTube، وقوائم تجديد النشاط التسويقي للإعلانات على شبكة البحث، المجمّعة حسب معيار الحملة والجمهور. لا تتضمّن طريقة العرض هذه سوى شرائح الجمهور المرفقة على مستوى الحملة.

تمثيل JSON 
{
  "resourceName": string
}
الحقول
resourceName

string

النتائج فقط. اسم المورد لطريقة عرض الجمهور للحملة. تكون أسماء موارد عرض الجمهور للحملة على النحو التالي:

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

CampaignSearchTermInsight

عرض عبارات البحث في الحملة تتوفّر البيانات السابقة اعتبارًا من آذار (مارس) 2023.

تمثيل JSON 
{
  "resourceName": string,
  "categoryLabel": string,
  "id": string,
  "campaignId": string
}
الحقول
resourceName

string

النتائج فقط. اسم المرجع لإحصاءات عبارات البحث على مستوى الحملة. تكون أسماء موارد إحصاءات عبارات البحث على مستوى الحملة على النحو التالي:

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

string

النتائج فقط. تسمية فئة البحث. تشير السلسلة الفارغة إلى فئة "غير محدّد" لعبارات البحث التي لا تندرج ضمن فئة أخرى.
id

string (int64 format)

النتائج فقط. رقم تعريف الإحصاءات.
campaignId

string (int64 format)

النتائج فقط. رقم تعريف الحملة.

CampaignSimulation

محاكاة الحملات في ما يلي توضيح تفصيلي للمجموعات المتوافقة من نوع القناة الإعلانية ونوع المحاكاة وطريقة تعديل المحاكاة على التوالي.

  • شبكة البحث -CPC_BID - UNIFORM
  • شبكة البحث - CPC_BID - التصعيد
  • شبكة البحث - TARGET_CPA - UNIFORM
  • شبكة البحث - التكلفة المستهدَفة للإجراء - التوسّع
  • شبكة البحث - TARGET_ROAS - UNIFORM
  • شبكة البحث - TARGET_IMPRESSION_SHARE - UNIFORM
  • بحث - الميزانية - زي موحَّد
  • ‫SHOPPING - BUDGET - UNIFORM
  • ‫SHOPPING - TARGET_ROAS - UNIFORM
  • MULTI_CHANNEL - TARGET_CPA - UNIFORM
  • MULTI_CHANNEL - TARGET_ROAS - UNIFORM
  • أثناء التصفّح - TARGET_CPA - تلقائي
  • DISPLAY - TARGET_CPA - UNIFORM
  • ‫PERFORMANCE_MAX - TARGET_CPA - UNIFORM
  • PERFORMANCE_MAX - TARGET_ROAS - UNIFORM
  • PERFORMANCE_MAX - الميزانية - زي موحد
تمثيل 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)

العدد المتوقّع للتفاعلات لا يتيح هذا الحقل إلا لنوع قناة الإعلانات أثناء التصفّح.

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

تصف هذه السمة التغيير الدقيق للموارد التي يتم عرضها لأنواع معيّنة من الموارد. ويتم تضمين التغييرات التي تم إجراؤها من خلال واجهة المستخدم أو واجهة برمجة التطبيقات في آخر 30 يومًا. تظهر القيم السابقة والجديدة للحقول التي تم تغييرها. قد يتأخّر ظهور التغيير الجديد في ChangeEvent لمدة تصل إلى 3 دقائق.

تمثيل 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

النتائج فقط. مورد Simply الذي حدث فيه هذا التغيير.
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.

عمليات التعداد
UNSPECIFIED لم يتم تحديد أي قيمة.
UNKNOWN تُستخدَم لأغراض القيمة المعروضة فقط. يمثل موردًا غير مصنف غير معروف في هذا الإصدار.
AD تغيير في موارد الإعلانات
AD_GROUP تغيير في موارد المجموعة الإعلانية
AD_GROUP_CRITERION تغيير في مورد AdGroupCriterion
CAMPAIGN تغيير في موارد الحملة
CAMPAIGN_BUDGET تغيير في مورد CampaignBudget
AD_GROUP_BID_MODIFIER تغيير في مورد AdGroupBidModifier
CAMPAIGN_CRITERION تغيير مورد معيار الحملة.
FEED تغيير في مورد الخلاصة
FEED_ITEM تغيير في مورد FeedItem
CAMPAIGN_FEED تغيير في مورد CampaignFeed
AD_GROUP_FEED تغيير في مورد AdGroupFeed
AD_GROUP_AD تغيير في مورد AdGroupAd
ASSET تغيير في مورد مادة العرض
CUSTOMER_ASSET تغيير في مورد CustomerAsset
CAMPAIGN_ASSET تغيير في مورد CampaignAsset
AD_GROUP_ASSET تغيير في مورد AdGroupAsset
ASSET_SET تغيير في مورد مجموعة مواد العرض
ASSET_SET_ASSET تغيير في مورد AssetSetAsset
CAMPAIGN_ASSET_SET تغيير في مورد CampaignAssetSet

ChangeClientType

المصدر الذي تم إنشاء مورد changeEvent من خلاله.

عمليات التعداد
UNSPECIFIED لم يتم تحديد أي قيمة.
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثل نوع عميل غير مصنف غير معروف في هذا الإصدار.
GOOGLE_ADS_WEB_CLIENT التغييرات التي تم إجراؤها من خلال "ads.google.com". على سبيل المثال، التغييرات التي تم إجراؤها من خلال إدارة الحملة.
GOOGLE_ADS_AUTOMATED_RULE التغييرات التي تم إجراؤها من خلال القواعد المبرمَجة في "إعلانات Google"
GOOGLE_ADS_SCRIPTS التغييرات التي تم إجراؤها من خلال نصوص "إعلانات Google" البرمجية
GOOGLE_ADS_BULK_UPLOAD التغييرات التي أجراها التحميل المجمّع في "إعلانات Google"
GOOGLE_ADS_API التغييرات التي تم إجراؤها بواسطة Google Ads API:
GOOGLE_ADS_EDITOR التغييرات التي أجراها "محرّر إعلانات Google" هذه القيمة هي عنصر نائب. لا تعرض واجهة برمجة التطبيقات هذه التغييرات.
GOOGLE_ADS_MOBILE_APP التغييرات التي أجراها تطبيق "إعلانات Google" المتوافق مع الأجهزة الجوّالة
GOOGLE_ADS_RECOMMENDATIONS التغييرات التي تم إجراؤها من خلال اقتراحات "إعلانات Google"
SEARCH_ADS_360_SYNC التغييرات التي تمّ إجراؤها من خلال مزامنة "إعلانات شبكة البحث 360"
SEARCH_ADS_360_POST التغييرات التي تمّ إجراؤها من خلال نشر "إعلانات شبكة البحث 360".
INTERNAL_TOOL التغييرات التي تم إجراؤها من خلال الأدوات الداخلية على سبيل المثال، عندما يضبط مستخدِم نموذج عنوان URL على عنصر مثل حملة، يتم أن يتم تضمينه تلقائيًا مع عنوان URL لخادم النقرات في "إعلانات شبكة البحث 360".
OTHER أنواع التغييرات غير المصنَّفة، مثل التغييرات التي يتم إجراؤها من خلال تحصيل قيمة القسائم من خلال "إعلانات Google"
GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION التغييرات التي تم إجراؤها من خلال الاشتراك في اقتراحات "إعلانات Google"

ChangedResource

ملف proto ملف تعريف يعرض جميع الموارد المتوافقة سيتمّ ضبط مورد 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_OLD.
campaign

object (Campaign)

النتائج فقط. اضبط إذا كان changeResourceType == CAMPAIGN.
campaignBudget

object (CampaignBudget)

النتائج فقط. اضبط ما إذا كان changeResourceType == CAMPAIGN_BUDGET.
adGroupBidModifier

object (AdGroupBidModifier)

النتائج فقط. اضبط ما إذا كان changeResourceType == AD_GROUP_BID_MODIFIER.
campaignCriterion

object (CampaignCriterion)

النتائج فقط. اضبط القيمة إذا كان changeResourceType == CAMPAIGN_CRITERION.
feed

object (Feed)

النتائج فقط. اضبط ما إذا كان changeResourceType == FEED.
feedItem

object (FeedItem)

النتائج فقط. يمكنك تعيين ما إذا كان changeResourceType == FEED_ITEM.
campaignFeed

object (CampaignFeed)

النتائج فقط. اضبط ما إذا كان changeResourceType == CAMPAIGN_FEED.
adGroupFeed

object (AdGroupFeed)

النتائج فقط. اضبط ما إذا كان changeResourceType == AD_GROUP_FEED.
adGroupAd

object (AdGroupAd)

النتائج فقط. يمكنك الضبط إذا كان changeResourceType == AD_GROUP_AD.
asset

object (Asset)

النتائج فقط. اضبط ما إذا كان changeResourceType == ASSET.
customerAsset

object (CustomerAsset)

النتائج فقط. يمكنك الضبط إذا كان changeResourceType == CUSTOMER_ASSET.
campaignAsset

object (CampaignAsset)

النتائج فقط. يمكنك ضبط إذا كان changeResourceType == CAMPAIGN_ASSET.
adGroupAsset

object (AdGroupAsset)

النتائج فقط. اضبط ما إذا كان changeResourceType == AD_GROUP_ASSET.
assetSet

object (AssetSet)

النتائج فقط. اضبط هذا الخيار إذا كانت قيمة changeResourceType هي ASSET_SET.
assetSetAsset

object (AssetSetAsset)

النتائج فقط. يمكنك ضبط إذا كان changeResourceType == ASSET_SET_ASSET.
campaignAssetSet

object (CampaignAssetSet)

النتائج فقط. يمكنك الضبط إذا كان changeResourceType == CAMPAIGN_ASSET_SET.

ResourceChangeOperation

العملية التي تم إجراؤها على المورد الذي تم تغييره في مورد changeEvent

عمليات التعداد
UNSPECIFIED لم يتم تحديد أي قيمة.
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثّل عملية غير مصنّفة غير معروفة في هذا الإصدار.
CREATE تم إنشاء المورد.
UPDATE تم تعديل المورد.
REMOVE تمت إزالة المرجع.

ChangeStatus

يصف حالة المورد الذي تم إرجاعه. قد يتأخّر ظهور التغيير الجديد في ChangeStatus لمدة تصل إلى 3 دقائق.

تمثيل 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

النتائج فقط. مادة عرض الحملة المتأثّرة بهذا التغيير.
adGroupAsset

string

النتائج فقط. مادة عرض المجموعة الإعلانية المتأثرة بهذا التغيير.
combinedAudience

string

النتائج فقط. شريحة الجمهور المجمّعة المتأثرة بهذا التغيير
lastChangeDateTime

string

النتائج فقط. الوقت الذي حدث فيه آخر تغيير على هذا المورد
campaign

string

النتائج فقط. الحملة المتأثرة بهذا التغيير
adGroup

string

النتائج فقط. المجموعة الإعلانية المتأثرة بهذا التغيير.
adGroupAd

string

النتائج فقط. AdGroupAd المتأثِّر بهذا التغيير.
adGroupCriterion

string

النتائج فقط. معيار جمهور المجموعة الإعلانية المتأثّر بهذا التغيير
campaignCriterion

string

النتائج فقط. مقياس CampaignCriterion المتأثّر بهذا التغيير
feed

string

النتائج فقط. الخلاصة المتأثرة بهذا التغيير
feedItem

string

النتائج فقط. عنصر الخلاصة المتأثر بهذا التغيير
adGroupFeed

string

النتائج فقط. خلاصة المجموعة الإعلانية المتأثرة بهذا التغيير.
campaignFeed

string

النتائج فقط. خلاصة الحملة المتأثّرة بهذا التغيير
adGroupBidModifier

string

النتائج فقط. يتأثّر مُعدِّل عروض أسعار المجموعة الإعلانية بهذا التغيير.

ChangeStatusResourceType

قائمة بالأنواع المسموح بها لمورد ChangeStatus

عمليات التعداد
UNSPECIFIED لم يتم تحديد أي قيمة.
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثل موردًا غير مصنف غير معروف في هذا الإصدار.
AD_GROUP تغيير في مورد المجموعة الإعلانية
AD_GROUP_AD تغيير في مورد AdGroupAd
AD_GROUP_CRITERION تغيير في مورد AdGroupCriterion
CAMPAIGN تغيير في مورد الحملة
CAMPAIGN_CRITERION تغيير مورد معيار الحملة.
FEED تغيير في مورد الخلاصة
FEED_ITEM تغيير في مورد FeedItem
AD_GROUP_FEED تغيير في مورد AdGroupFeed
CAMPAIGN_FEED تغيير في مورد CampaignFeed
AD_GROUP_BID_MODIFIER تغيير في مورد AdGroupBidModifier.
SHARED_SET تغيير في مورد SharedSet
CAMPAIGN_SHARED_SET تغيير في مورد CampaignSharedSet
ASSET تغيير في مورد مادة العرض
CUSTOMER_ASSET تغيير في مورد CustomerAsset
CAMPAIGN_ASSET تغيير في مورد CampaignAsset
AD_GROUP_ASSET تغيير في مورد AdGroupAsset
COMBINED_AUDIENCE تغيير في مورد CombinedAudience

ChangeStatusOperation

حالة المورد الذي تم تغييره

عمليات التعداد
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

قائمة أرقام تحتوي على أنواع حالة الجمهور المجمَّع المحتملة

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لأغراض القيمة المعروضة فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
ENABLED الحالة "مفعّلة": تم تفعيل شريحة الجمهور المجمّعة ويمكن استهدافها.
REMOVED الحالة "تمت الإزالة": تتم إزالة شريحة الجمهور المجمّعة ولا يمكن استخدامها لاستهداف الجمهور.

ClickView

عرض نقرة بمقاييس مجمّعة على كل مستوى نقرة، بما في ذلك النقرات الصالحة وغير الصالحة. بالنسبة إلى الحملات غير "الحملات على شبكة البحث"، تمثّل metrics.clicks عدد التفاعلات الصالحة وغير الصالحة. يجب أن تتضمّن طلبات البحث التي تتضمّن ClickView فلترًا يحدّ من النتائج إلى يوم واحد، ويمكن طلبها لتواريخ تعود إلى 90 يومًا قبل وقت الطلب.

تمثيل JSON 
{
  "resourceName": string,
  "areaOfInterest": {
    object (ClickLocation)
  },
  "locationOfPresence": {
    object (ClickLocation)
  },
  "keyword": string,
  "keywordInfo": {
    object (KeywordInfo)
  },
  "gclid": string,
  "pageNumber": string,
  "adGroupAd": string,
  "campaignLocationTarget": string,
  "userList": string
}
الحقول
resourceName

string

النتائج فقط. اسم المورد لعرض النقرة. انقر على عرض أسماء الموارد التي يكون شكلها على النحو التالي:

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

object (ClickLocation)

النتائج فقط. معايير الموقع الجغرافي التي تتطابق مع منطقة الاهتمام المرتبطة بمرة الظهور
locationOfPresence

object (ClickLocation)

النتائج فقط. معايير الموقع الجغرافي التي تتطابق مع موقع التواجد المرتبط بمرة الظهور
keyword

string

النتائج فقط. الكلمة الرئيسية المرتبطة، إن وجدت، وكانت النقرة تتطابق مع قناة شبكة البحث.
keywordInfo

object (KeywordInfo)

النتائج فقط. معلومات أساسية عن الكلمة الرئيسية المرتبطة، إذا كانت متوفّرة
gclid

string

النتائج فقط. رقم تعريف نقرة Google.
pageNumber

string (int64 format)

النتائج فقط. رقم الصفحة في نتائج البحث حيث تم عرض الإعلان.
adGroupAd

string

النتائج فقط. الإعلان المرتبط
campaignLocationTarget

string

النتائج فقط. الموقع الجغرافي المستهدف المرتبط بالحملة، إن توفّر.
userList

string

النتائج فقط. قائمة المستخدمين المرتبطين، إن توفّرت

ClickLocation

معايير الموقع الجغرافي المرتبطة بنقرة

تمثيل JSON 
{
  "city": string,
  "country": string,
  "metro": string,
  "mostSpecific": string,
  "region": string
}
الحقول
city

string

معيار موقع المدينة المرتبط بمرّة الظهور.
country

string

معيار الموقع الجغرافي للبلد المرتبط بمرّة الظهور.
metro

string

معيار الموقع الجغرافي الرئيسي المرتبط بمرّة الظهور.
mostSpecific

string

معيار الموقع الأكثر تحديدًا المرتبط بمرة الظهور.
region

string

معيار الموقع الجغرافي للمنطقة المرتبط بمرّة الظهور.

CurrencyConstant

ثابت عملة.

تمثيل JSON 
{
  "resourceName": string,
  "code": string,
  "name": string,
  "symbol": string,
  "billableUnitMicros": string
}
الحقول
resourceName

string

النتائج فقط. اسم المورد لسمة العملة الثابتة وتكون أسماء الموارد الثابتة للعملة على النحو التالي:

currencyConstants/{code}
code

string

النتائج فقط. رمز العملة المكوّن من ثلاثة أحرف وفقًا لمعيار ISO 4217، مثل "USD"
name

string

النتائج فقط. الاسم الكامل باللغة الإنجليزية للعملة.
symbol

string

النتائج فقط. الرمز العادي لوصف هذه العملة، على سبيل المثال، "$" للدولار الأمريكي
billableUnitMicros

string (int64 format)

النتائج فقط. الوحدة القابلة للفوترة لهذه العملة. يجب أن تكون المبالغ المُحصَّلة مضاعفات لهذه القيمة.

AccessibleBiddingStrategy

تمثّل عرضًا لـ "استراتيجيات عروض الأسعار" التي يملكها العميل ويشاركها معه.

على عكس BiddingStrategy، يتضمّن هذا المرجع الاستراتيجيات التي يملكها مدراء العميل ويشاركونها معه، بالإضافة إلى الاستراتيجيات التي يملكها هذا العميل. لا يوفّر هذا المرجع مقاييس، ولا يعرض سوى مجموعة فرعية محدودة من سمات "استراتيجية عروض الأسعار".

تمثيل JSON 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

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

string

النتائج فقط. اسم المورد لاستراتيجية عروض الأسعار التي يمكن الوصول إليها. تكون أسماء موارد AccessibleBiddingStrategy على النحو التالي:

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

string (int64 format)

النتائج فقط. رقم تعريف استراتيجية عروض الأسعار.
name

string

النتائج فقط. اسم استراتيجية عروض الأسعار.
type

enum (BiddingStrategyType)

النتائج فقط. نوع استراتيجية عروض الأسعار.
ownerCustomerId

string (int64 format)

النتائج فقط. الرقم التعريفي للعميل الذي يملك استراتيجية عروض الأسعار.
ownerDescriptiveName

string

الناتج فقط. اسم وصفي للعميل الذي يملك استراتيجية عروض الأسعار.

حقل الربط scheme نظام عروض الأسعار.

لا يمكن ضبط أكثر من قيمة واحدة. يمكن أن يكون scheme واحدًا فقط مما يلي:
maximizeConversionValue

object (MaximizeConversionValue)

النتائج فقط. استراتيجية عروض أسعار مبرمَجة للمساعدة في الحصول على أقصى قيمة للإحالة الناجحة لحملاتك في حدود ميزانيتك.
maximizeConversions

object (MaximizeConversions)

النتائج فقط. استراتيجية عروض أسعار مبرمَجة للمساعدة في الحصول على أكبر عدد ممكن من الإحالات الناجحة لحملاتك في حدود ميزانيتك.
targetCpa

object (TargetCpa)

النتائج فقط. استراتيجية عروض أسعار يتم من خلالها ضبط عروض الأسعار لمساعدتك في الحصول على أكبر عدد ممكن من الإحالات الناجحة بالتكلفة المستهدفة للإجراء التي تحدِّدها.
targetImpressionShare

object (TargetImpressionShare)

النتائج فقط. استراتيجية عروض أسعار يتم تحسينها تلقائيًا لزيادة نسبة محدّدة من مرات الظهور.
targetRoas

object (TargetRoas)

النتائج فقط. استراتيجية عروض أسعار تساعدك على زيادة الأرباح إلى أقصى حد مع تحقيق متوسط عائد إنفاق إعلاني مستهدَف محدّد.
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

استراتيجية عروض أسعار مبرمَجة تساعدك على تحقيق الحد الأقصى من الأرباح مع احتساب متوسط عائد إنفاق إعلاني مستهدف محدّد.

تمثيل JSON 
{
  "targetRoas": number
}
الحقول
targetRoas

number

النتائج فقط. الأرباح المحدّدة (استنادًا إلى بيانات الإحالات الناجحة) لكل وحدة إنفاق

TargetSpend

استراتيجية عروض أسعار مبرمَجة تحدّد عروض أسعارك لمساعدتك في الحصول على أكبر عدد ممكن من النقرات في حدود ميزانيتك.

تمثيل JSON 
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
الحقول
targetSpendMicros
(deprecated)

string (int64 format)

النتائج فقط. الإنفاق المستهدف المطلوب بموجبه الحصول على الحد الأقصى من النقرات. سيحاول نظام عروض أسعار "الإنفاق الهدف" إنفاق مبلغ أقل من هذه القيمة أو مبلغ الإنفاق المقيَّد الطبيعي. في حال عدم تحديدها، يتم استخدام الميزانية كمستهدف الإنفاق. تم إيقاف هذا الحقل نهائيًا ويجب عدم استخدامه. يمكنك الاطّلاع على https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html لمعرفة التفاصيل.
cpcBidCeilingMicros

string (int64 format)

النتائج فقط. الحد الأقصى لعروض الأسعار الذي يمكن ضبطه من خلال استراتيجية عروض الأسعار. وينطبق الحدّ على جميع الكلمات الرئيسية التي تُديرها الاستراتيجية.

CustomerClient

يشير ذلك المصطلح إلى رابط بين العميل المحدَّد والعميل المحتمل. لا تتوفّر ميزة "العملاء" إلا للعملاء الإداريين. يشمل ذلك جميع العملاء المباشرين وغير المباشرين، بالإضافة إلى المدير نفسه.

تمثيل JSON 
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
الحقول
resourceName

string

النتائج فقط. اسم المورد للعميل العميل. تكون أسماء موارد العميل على النحو التالي: customers/{customerId}/customerClients/{client_customer_id}
appliedLabels[]

string

النتائج فقط. أسماء مصادر التصنيفات التي يملكها العميل المُقدّم للطلب والتي يتم تطبيقها على العميل. تكون أسماء موارد التصنيفات على النحو التالي:

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

enum (CustomerStatus)

النتائج فقط. حالة العميل. للقراءة فقط.
clientCustomer

string

النتائج فقط. اسم المورد للعميل المرتبط بالعميل المحدد. للقراءة فقط.
hidden

boolean

النتائج فقط. تحدِّد هذه السياسة ما إذا كان هذا حسابًا مخفيًا. للقراءة فقط.
level

string (int64 format)

النتائج فقط. المسافة بين عميل معيّن وعميل آخر بالنسبة إلى الرابط الذاتي، ستكون قيمة المستوى 0. للقراءة فقط.
timeZone

string

النتائج فقط. تمثيل سلسلة مستودع بيانات اللغة المشتركة (CLDR) للمنطقة الزمنية للعميل، على سبيل المثال، America/Los_Angeles. للقراءة فقط.
testAccount

boolean

النتائج فقط. لتحديد ما إذا كان العميل حسابًا اختباريًا. للقراءة فقط.
manager

boolean

النتائج فقط. يحدّد ما إذا كان العميل مديرًا. للقراءة فقط.
descriptiveName

string

النتائج فقط. اسم وصفي للعميل للقراءة فقط.
currencyCode

string

النتائج فقط. رمز العملة (على سبيل المثال، "USD" و"EUR") للعميل. للقراءة فقط.
id

string (int64 format)

النتائج فقط. رقم تعريف عميل العميل. للقراءة فقط.

CustomerSearchTermInsight

طريقة عرض لمصطلح بحث العميل. تتوفّر البيانات السابقة اعتبارًا من آذار (مارس) 2023.

تمثيل JSON 
{
  "resourceName": string,
  "categoryLabel": string,
  "id": string
}
الحقول
resourceName

string

النتائج فقط. اسم مورد إحصاءات عبارة البحث على مستوى العميل تكون أسماء مَراجع إحصاءات عبارات البحث على مستوى العملاء على النحو التالي:

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

string

النتائج فقط. تصنيف فئة البحث تشير السلسلة الفارغة إلى فئة استقبال الرسائل الخاطئة لعبارات البحث التي لا تندرج ضمن فئة أخرى.
id

string (int64 format)

النتائج فقط. رقم تعريف الإحصاءات

DetailPlacementView

عرض يتضمّن مقاييس مجمّعة حسب المجموعة الإعلانية وعنوان URL أو فيديو YouTube

تمثيل JSON 
{
  "resourceName": string,
  "placementType": enum (PlacementType),
  "placement": string,
  "displayName": string,
  "groupPlacementTargetUrl": string,
  "targetUrl": string
}
الحقول
resourceName

string

النتائج فقط. اسم المورد لعرض موضع التفاصيل. وتكون أسماء موارد عرض موضع التفاصيل على النحو التالي:

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

enum (PlacementType)

النتائج فقط. نوع موضع الإعلان، مثل موقع إلكتروني وفيديو YouTube وتطبيق الأجهزة الجوّالة.
placement

string

النتائج فقط. سلسلة موضع الإعلان التلقائي على مستوى التفاصيل، مثل عنوان URL للموقع الإلكتروني أو رقم تعريف تطبيق متوافق مع الأجهزة الجوّالة أو معرّف فيديو على YouTube
displayName

string

النتائج فقط. الاسم المعروض هو اسم عنوان URL للمواقع الإلكترونية واسم فيديو YouTube للفيديوهات على YouTube واسم التطبيق المتوافق مع الأجهزة الجوّالة المترجَم للتطبيقات المتوافقة مع الأجهزة الجوّالة.
groupPlacementTargetUrl

string

النتائج فقط. عنوان URL لموضع إعلان المجموعة، مثل نطاق، أو رابط إلى تطبيق للأجهزة الجوّالة في متجر التطبيقات أو عنوان URL لقناة على YouTube.
targetUrl

string

النتائج فقط. عنوان URL للموضع، مثل الموقع الإلكتروني، أو رابط إلى تطبيق للأجهزة الجوّالة في متجر التطبيقات، أو عنوان URL لفيديو على YouTube.

PlacementType

أنواع مواضع الإعلانات المحتملة لعملية ربط الخلاصة.

عمليات التعداد
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

النتائج فقط. صحيح إذا تم إطلاق الفئة الديمغرافية المفصّلة لجميع القنوات واللغات.
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" (خطأ)، يعني ذلك أنّ إعدادات مدى التوفّر التلقائية هذه لا تشمل الحملة على الشبكة الإعلانية التلقائية التي لم يتم ضبط النوع الفرعي للقناة فيها.

CriterionCategoryChannelAvailabilityMode

رقم تعداد يحتوي على criterionCategoryChannelAvailabilityMode المحتمل.

عمليات التعداد
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

رقم تعداد يحتوي على criterionCategoryLocaleAvailabilityMode المحتمل.

عمليات التعداد
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

عرض المسافة مع المقاييس المجمّعة حسب المسافة بين المستخدِم وموقع المعلِن الجغرافي. يتضمّن كلّ DistanceBucket جميع مرّات الظهور التي تقع ضمن مسافته، وستساهم مرّة ظهور واحدة في مقاييس جميع DistanceBuckets التي تتضمّن مسافة المستخدِم.

تمثيل JSON 
{
  "resourceName": string,
  "distanceBucket": enum (DistanceBucket),
  "metricSystem": boolean
}
الحقول
resourceName

string

النتائج فقط. اسم المورد لعرض المسافة وتكون أسماء موارد "عرض المسافة" على النحو التالي:

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

enum (DistanceBucket)

النتائج فقط. تجميع المسافة بين المستخدِم وإضافة الموقع الجغرافي
metricSystem

boolean

النتائج فقط. صحيح إذا كان DistanceBucket يستخدم النظام المتري، أو خطأ بخلاف ذلك.

DistanceBucket

حزمة المسافة لحجم المستخدم من إضافة الموقع الجغرافي للمعلِن.

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
WITHIN_700M كان المستخدم على بُعد 700 متر من الموقع الجغرافي.
WITHIN_1KM كان المستخدم على بُعد كيلومتر واحد من الموقع الجغرافي.
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 كان المستخدم في نطاق 0.1 ميل من الموقع.
WITHIN_1MILE كان المستخدم في نطاق ميل واحد من الموقع الجغرافي.
WITHIN_5MILES كان المستخدم على بُعد 8 كيلومتر من الموقع الجغرافي.
WITHIN_10MILES كان المستخدم في نطاق 10 أميال من الموقع.
WITHIN_15MILES كان المستخدم على بُعد 24 كيلومتر من الموقع الجغرافي.
WITHIN_20MILES كان المستخدم في نطاق 20 ميلاً من الموقع.
WITHIN_25MILES كان المستخدم في نطاق 25 ميلاً من الموقع.
WITHIN_30MILES كان المستخدم على بُعد 30 ميلًا من الموقع الجغرافي.
WITHIN_35MILES كان المستخدم على بُعد 56 كيلومترًا من الموقع الجغرافي.
WITHIN_40MILES كان المستخدم على بُعد 64 كيلومتر من الموقع الجغرافي.
BEYOND_40MILES كان المستخدم على بُعد أكثر من 64 كيلومترًا من الموقع الجغرافي.

DynamicSearchAdsSearchTermView

عرض عبارات البحث للإعلانات الديناميكية على شبكة البحث

تمثيل JSON 
{
  "resourceName": string,
  "searchTerm": string,
  "headline": string,
  "landingPage": string,
  "pageUrl": string,
  "hasNegativeKeyword": boolean,
  "hasMatchingKeyword": boolean,
  "hasNegativeUrl": boolean
}
الحقول
resourceName

string

النتائج فقط. اسم المرجع لعرض عبارات البحث للإعلانات الديناميكية على شبكة البحث. يكون شكل أسماء موارد عرض عبارات البحث في الإعلانات الديناميكية على شبكة البحث على النحو التالي:

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

string

النتائج فقط. عبارة البحث

هذا الحقل للقراءة فقط.
headline

string

النتائج فقط. العنوان الذي تم إنشاؤه ديناميكيًا للإعلان الديناميكي على شبكة البحث

هذا الحقل للقراءة فقط.
landingPage

string

النتائج فقط. عنوان URL للصفحة المقصودة المحددة ديناميكيًا لمرة الظهور.

هذا الحقل للقراءة فقط.
pageUrl

string

النتائج فقط. عنوان URL لعنصر خلاصة الصفحة الذي تم عرضه للظهور.

هذا الحقل للقراءة فقط.
hasNegativeKeyword

boolean

النتائج فقط. صحيح إذا كانت الطلب تتطابق مع كلمة رئيسية سلبية.

هذا الحقل للقراءة فقط.
hasMatchingKeyword

boolean

النتائج فقط. صحيح إذا تمت إضافة طلب البحث إلى الكلمات الرئيسية المستهدَفة.

هذا الحقل للقراءة فقط.
hasNegativeUrl

boolean

النتائج فقط. True إذا كان طلب البحث يطابق عنوان URL سلبيًا.

هذا الحقل للقراءة فقط.

ExpandedLandingPageView

مشاهدة صفحة مقصودة بمقاييس مجمّعة على مستوى عنوان URL النهائي الموسَّع

تمثيل JSON 
{
  "resourceName": string,
  "expandedFinalUrl": string
}
الحقول
resourceName

string

النتائج فقط. اسم المورد لطريقة عرض الصفحة المقصودة الموسّعة. وتكون أسماء موارد عرض الصفحة المقصودة الموسّعة على النحو التالي:

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

string

النتائج فقط. عنوان URL النهائي الذي يتم توجيه النقرات إليه.

FeedPlaceholderView

عرض عنصر نائب للخلاصة

تمثيل JSON 
{
  "resourceName": string,
  "placeholderType": enum (PlaceholderType)
}
الحقول
resourceName

string

النتائج فقط. اسم المورد لعرض العنصر النائب للخلاصة تكون أسماء موارد عرض العنصر النائب للخلاصة على النحو التالي:

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

enum (PlaceholderType)

النتائج فقط. نوع العنصر النائب لعرض العنصر النائب للخلاصة

GenderView

عرض الجنس يعرض مورد genderView حالة العرض الفعّالة، وليس المعايير التي تمت إضافتها. تظهر المجموعة الإعلانية التي لا تتضمّن معايير جنس بشكل تلقائي لجميع الجنسين، لذا تظهر جميع الجنسين في genderView مع الإحصاءات.

تمثيل JSON 
{
  "resourceName": string
}
الحقول
resourceName

string

النتائج فقط. اسم المورد لعرض الجنس. يكون شكل أسماء موارد عرض الجنس على النحو التالي:

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

GeographicView

عرض جغرافي

تشمل طريقة العرض الجغرافية جميع المقاييس المجمّعة على مستوى البلد، صفًا واحدًا لكل بلد. وهو يسجِّل المقاييس إما في الموقع الفعلي الفعلي للمستخدم أو منطقة الاهتمام. وفي حال استخدام حقول أقسام أخرى، قد تحصل على أكثر من صف واحد لكل بلد.

تمثيل JSON 
{
  "resourceName": string,
  "locationType": enum (GeoTargetingType),
  "countryCriterionId": string
}
الحقول
resourceName

string

النتائج فقط. اسم المورد لطريقة العرض الجغرافية. تكون أسماء موارد العرض الجغرافي على النحو التالي:

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

enum (GeoTargetingType)

النتائج فقط. نوع الاستهداف الجغرافي للحملة.
countryCriterionId

string (int64 format)

النتائج فقط. رقم تعريف المعيار للبلد.

GeoTargetingType

أنواع الاستهداف الجغرافي المحتملة.

عمليات التعداد
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

حالة تسوية حجوزات الفنادق

عمليات التعداد
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

تلخّص طريقة عرض الموقع الجغرافي أداء الحملات حسب معيار الموقع الجغرافي. إذا لم يتم ضبط معيار الموقع الجغرافي، لن يتم عرض أيّ نتائج. وبدلاً من ذلك، استخدِم عرضًا جغرافيًا أو 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

نوع الوسائط

عمليات التعداد
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

غير قابل للتغيير. اسم المورد لإكمال عملية التحقّق من أهلية المعلنين للإعلان عن "الخدمات المحلّية". تكون أسماء مراجع التحقّق من "الخدمات المحلّية" على النحو التالي:

customers/{customerId}/localServicesEmployees/{gls_employee_id}
creationDateTime

string

النتائج فقط. الطابع الزمني لإنشاء الموظف يكون التنسيق "YYYY-MM-DD HH:MM:SS" في المنطقة الزمنية لحساب "إعلانات Google". أمثلة: "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

النتائج فقط. فئة الموظف. يمكن العثور على قائمة بأرقام تعريف فئات الخدمات المحلّية على الرابط 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

تعداد يصف حالات موظف الخدمات المحلية

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لأغراض القيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
ENABLED لا تتم إزالة الموظف، وتكون حالة الموظف نشطة.
REMOVED تمت إزالة الموظف. يُستخدَم لحذف موظف من النشاط التجاري.

LocalServicesEmployeeType

يشير التعداد إلى أنواع موظفي الخدمات المحلية.

عمليات التعداد
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

غير قابل للتغيير. اسم المورد لإكمال عملية التحقّق من أهلية المعلنين للإعلان عن "الخدمات المحلّية". تكون أسماء مراجع التحقّق من "الخدمات المحلّية" على النحو التالي:

customers/{customerId}/localServicesVerificationArtifacts/{verification_artifact_id}
creationDateTime

string

النتائج فقط. الطابع الزمني لوقت إنشاء عنصر إثبات الملكية هذا. يكون التنسيق "YYYY-MM-DD HH:MM:SS" في المنطقة الزمنية لحساب "إعلانات Google". أمثلة: "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)

النتائج فقط. عنصر إثبات صحة الفحص الأمني
insuranceVerificationArtifact

object (InsuranceVerificationArtifact)

النتائج فقط. عنصر التحقّق من التأمين
licenseVerificationArtifact

object (LicenseVerificationArtifact)

النتائج فقط. عنصر إثبات صحة الترخيص
businessRegistrationCheckVerificationArtifact

object (BusinessRegistrationCheckVerificationArtifact)

النتائج فقط. عنصر لإثبات صحة بيانات تسجيل النشاط التجاري

LocalServicesVerificationArtifactStatus

فئتان توضّحان حالات عنصر التحقّق من الخدمات المحلّية

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
PASSED اجتازت القطعة عملية التحقّق.
FAILED تعذّر إثبات ملكية العنصر.
PENDING العنصر قيد إثبات الملكية.
NO_SUBMISSION يجب أن يحمّل المستخدم المعلومات قبل إثبات ملكيتها.
CANCELLED ألغى المستخدم العنصر.

LocalServicesVerificationArtifactType

فهارس تصِف الأنواع المحتمَلة لعنصر التحقّق من الخدمات المحلّية

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
BACKGROUND_CHECK عنصر التحقّق من البيانات بإجراء الفحص الأمني
INSURANCE عنصر التحقّق من التأمين
LICENSE عنصر التحقّق من الترخيص
BUSINESS_REGISTRATION_CHECK عنصر التحقّق من فحص تسجيل النشاط التجاري

BackgroundCheckVerificationArtifact

نموذج أوّلي يحتوي على معلومات خاصة بالفحص الأمني للخدمات المحلّية

تمثيل JSON 
{
  "caseUrl": string,
  "finalAdjudicationDateTime": string
}
الحقول
caseUrl

string

النتائج فقط. عنوان URL للوصول إلى طلب الحصول على إذن بالوصول إلى البيانات في الخلفية
finalAdjudicationDateTime

string

النتائج فقط. الطابع الزمني الذي تم فيه إصدار قرار بشأن نتيجة طلب الفحص الأمني هذا يكون التنسيق "YYYY-MM-DD HH:MM:SS" في المنطقة الزمنية لحساب "إعلانات Google". أمثلة: "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

تشير التعدادات إلى الأسباب المحتملة للرفض لعنصر معيّن لإثبات صحة بيانات التأمين على الخدمات المحلّية.

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لأغراض القيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
BUSINESS_NAME_MISMATCH لا يتطابق اسم النشاط التجاري مع اسم النشاط التجاري في "إعلان الخدمات المحلّية".
INSURANCE_AMOUNT_INSUFFICIENT لا يستوفي مبلغ التأمين المتطلبات الواردة في مستندات الملخّصات القانونية الخاصة بتركيبة معرّف الموقع الجغرافي والفئة.
EXPIRED مستند التأمين منتهي الصلاحية.
NO_SIGNATURE لا يتضمّن مستند التأمين توقيعًا.
NO_POLICY_NUMBER لا يتضمّن مستند التأمين رقم بوليصة.
NO_COMMERCIAL_GENERAL_LIABILITY لم يتم وضع علامة في مربّع التأمينات التجارية العامة(CGL) في مستند التأمين.
EDITABLE_FORMAT أن يكون مستند التأمين بتنسيق قابل للتعديل
CATEGORY_MISMATCH لا يشمل مستند التأمين تغطية تأمينية لفئة معيّنة.
MISSING_EXPIRATION_DATE لا يتضمّن مستند التأمين تاريخ انتهاء صلاحية.
POOR_QUALITY جودة مستند التأمين رديئة، فالصور مموهة أو غير مقروءة أو غير ذلك
POTENTIALLY_EDITED تم الاشتباه في تعديل مستند التأمين.
WRONG_DOCUMENT_TYPE لم يتم قبول مستند التأمين. على سبيل المثال، مستندات عروض التأمين، ولكن لا يتم قبول التغطية غير المتوفّرة.
NON_FINAL مستند التأمين ليس نهائيًا.
OTHER يتضمّن مستند التأمين عيبًا آخر غير مذكور صراحةً.

LocalServicesDocumentReadOnly

مستند "الخدمات المحلّية" يتضمّن بيانات يمكن الوصول إليها للقراءة فقط

تمثيل JSON 
{
  "documentUrl": string
}
الحقول
documentUrl

string

عنوان URL للوصول إلى مستند "الخدمات المحلّية" الذي سبق تحميله.

LicenseVerificationArtifact

ملف proto يحتوي على معلومات خاصة بترخيص الخدمات المحلية

تمثيل 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

تشير التعدادات إلى الأسباب المحتملة لرفض عنصر لإثبات صحة ترخيص الخدمات المحلّية.

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لأغراض القيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
BUSINESS_NAME_MISMATCH لا يتطابق اسم النشاط التجاري مع اسم النشاط التجاري في "إعلان الخدمات المحلّية".
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

فئات متسلسلة تصف أنواع التسجيل المحتمَلة لعنصر التحقّق من تسجيل النشاط التجاري في الخدمات المحلّية

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
NUMBER نوع التحقّق من رقم التسجيل
DOCUMENT نوع فحص مستند التسجيل

LocalServicesBusinessRegistrationCheckRejectionReason

تعدادات تشرح الأسباب المحتملة للرفض لعنصر للتحقق من عملية التحقق من تسجيل نشاط تجاري في الخدمات المحلّية.

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لأغراض القيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
BUSINESS_NAME_MISMATCH لا يتطابق اسم النشاط التجاري مع اسم النشاط التجاري في "إعلان الخدمات المحلّية".
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

نوع الجهاز الجوّال

عمليات التعداد
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".
dailySummaries[]

object (OfflineConversionSummary)

النتائج فقط. ملخص إحصائيات السجل حسب آخر N من الأيام.
jobSummaries[]

object (OfflineConversionSummary)

النتائج فقط. ملخّص إحصاءات السجلّ حسب آخر N مهمة
alerts[]

object (OfflineConversionAlert)

النتائج فقط. تفاصيل كل رمز خطأ يتم إنشاء التنبيهات من آخر يوم تقويمي مع إحصاءات التحميل.

OfflineEventUploadClient

نوع العميل

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لأغراض القيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
GOOGLE_ADS_API Google Ads API
GOOGLE_ADS_WEB_CLIENT برنامج ويب "إعلانات Google"، الذي يمكن أن يتضمّن مصادر متعدّدة مثل واجهة مستخدم "إعلانات Google" وSFTP وما إلى ذلك
ADS_DATA_CONNECTOR منصة الاتصال.

OfflineConversionDiagnosticStatus

الحالات المحتمَلة لإعداد نقل البيانات بلا إنترنت

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لأغراض القيمة المعروضة فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
EXCELLENT إعداد نقل البيانات المتوفّرة بلا إنترنت مفعّل ومثالي لمعالجة بيانات ما بعد بيع المنتج.
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

يصف التعداد الأخطاء المحتملة في حجم المجموعة.

عمليات التعداد
UNSPECIFIED لم يتم تحديد قيمة التعداد.
UNKNOWN رمز الخطأ الذي تم تلقّيه غير معروف في هذا الإصدار.
TOO_FEW عدد قليل جدًا.
TOO_MANY عدد كبير جدًا.

ConversionAdjustmentUploadError

يصف التعداد أخطاء التحميل المحتملة لتعديل الإحالة الناجحة.

عمليات التعداد
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 يُرجى محاولة تحميل أقل من 2001 تعديل في أي طلب بيانات واحد من واجهة برمجة التطبيقات.
TOO_MANY_ADJUSTMENTS سبق أن تم تعديل الإحالة الناجحة الحد الأقصى لعدد المرات. تأكَّد من إجراء التعديلات الضرورية فقط على الإحالة الناجحة الحالية.
RESTATEMENT_ALREADY_EXISTS تمت إعادة صياغة الإحالة الناجحة مسبقًا باستخدام adjustmentDateTime نفسها. تأكّد من أنّ عملية التعديل تتضمّن قيمة adjustmentDateTime الصحيحة والفريدة وأعِد المحاولة.
DUPLICATE_ADJUSTMENT_IN_REQUEST يحتوي التعديل المستورَد على تعديل إحالة ناجحة مكرّر باستخدام adjustmentDateTime نفسه. تأكَّد من أنّ adjustmentDateTime في التعديل صحيح وأعد المحاولة.
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS يُرجى التأكّد من موافقتك على أحكام معالجة بيانات العملاء في إعدادات الإحالة الناجحة، ثم إعادة المحاولة.
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT لا يمكن استخدام الإحالات الناجحة المحسّنة مع إجراء الإحالة الناجحة المحدّد.
INVALID_USER_IDENTIFIER تأكَّد من تجزئة البيانات المقدَّمة من المستخدِم باستخدام خوارزمية SHA-256 وتأكَّد من تسويتها وفقًا للإرشادات.
UNSUPPORTED_USER_IDENTIFIER استخدِم البيانات المقدَّمة من المستخدِم، مثل عناوين البريد الإلكتروني أو أرقام الهواتف المجزّأة باستخدام خوارزمية SHA-256 وأعِد المحاولة.
GCLID_DATE_TIME_PAIR_AND_ORDER_ID_BOTH_SET لا يمكن ضبط كلٍّ من gclidDateTimePair وorderId. يُرجى استخدام نوع واحد فقط وإعادة المحاولة.
CONVERSION_ALREADY_ENHANCED سبق أن تم تحسين الإحالة الناجحة باستخدام مُعرّف الطلب وإجراء الإحالة الناجحة نفسَيهما. تأكّد من ضبط بياناتك بشكل صحيح وأعِد المحاولة.
DUPLICATE_ENHANCEMENT_IN_REQUEST تتضمّن تحسينات متعددة إجراء الإحالة الناجحة ومُعرّف الطلب نفسَيهما. تأكّد من ضبط بياناتك بشكل صحيح وأعِد المحاولة.
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCEMENT لا يمكن استخدام ميزة الإحالات الناجحة المحسّنة لهذا الحساب بسبب سياسات بيانات العميل في Google. يُرجى التواصل مع ممثّل Google الذي تتعامل معه.
MISSING_ORDER_ID_FOR_WEBPAGE إنّ تعديل الإحالة الناجحة للموقع الإلكتروني يتطلّب معرّف الطلب (أي معرّف المعاملة). تأكّد من أنّ علامات موقعك الإلكتروني تسجِّل معرّفات الطلبات ومن أنّك ترسل معرّفات الطلبات نفسها مع تعديلاتك.
ORDER_ID_CONTAINS_PII لا يمكن استخدام التعديلات التي تتضمن معرّفات طلبات تحتوي على معلومات تحديد الهوية الشخصية.
INVALID_JOB_ID معرّف الوظيفة المُقدم في الطلب ليس ضمن النطاق المسموح به. يجب أن يكون معرّف الوظيفة عددًا صحيحًا موجبًا ضمن النطاق [1, 2^31 ).
NO_CONVERSION_ACTION_FOUND يتعذر العثور على إجراء الإحالة الناجحة المحدّد في طلب التسوية. يُرجى التأكّد من توفّر الإجراء في هذا الحساب.
INVALID_CONVERSION_ACTION_TYPE نوع إجراء الإحالة الناجحة المحدّد في طلب التسوية غير متوافق مع تحميل عمليات التسوية. لا يُسمح بتعديل قيمة الإحالة الناجحة من النوع RETRACTION أو RESTATEMENT إلا لإجراءات الإحالات الناجحة من النوع SALESFORCE أو UPLOAD_CLICK أو WEBPAGE. لا يُسمح بتعديل قيمة إحالة ناجحة من النوع ENHANCEMENT إلا لإجراءات الإحالات الناجحة من النوع WEBPAGE.

ConversionUploadError

مصنّف يصف أخطاء تحميل الإحالات الناجحة المحتمَلة

عمليات التعداد
UNSPECIFIED لم يتم تحديد التعداد.
UNKNOWN تُستخدَم لأغراض القيمة المعروضة فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
TOO_MANY_CONVERSIONS_IN_REQUEST يمكنك تحميل أقل من 2001 حدث في طلب واحد.
UNPARSEABLE_GCLID تعذّر فك ترميز معلّمة gclid التي تم استيرادها. تأكّد من عدم تعديل أرقام تعريف النقرات.
CONVERSION_PRECEDES_EVENT يحتوي الحدث المستورَد على conversionDateTime قبل النقرة. تأكَّد من صحة conversionDateTime وأعِد المحاولة.
EXPIRED_EVENT لا يمكن تسجيل الحدث الذي تم استيراده لأنّ النقرة حدثت قبل وقت اكتمال هذه الإحالة الناجحة الناتجة عن النقر. تأكَّد من استيراد أحدث البيانات.
TOO_RECENT_EVENT تم تسجيل النقرة المرتبطة بالمعرِّف أو معلّمة عنوان URL لنظام التشغيل iOS قبل أقل من 6 ساعات. يُرجى إعادة المحاولة بعد مرور 6 ساعات.
EVENT_NOT_FOUND تعذّر تحديد مصدر الحدث المستورَد بالاستناد إلى إحدى النقرات. قد يرجع السبب في ذلك إلى أنّ الحدث لم ينتج عن حملة على "إعلانات Google".
UNAUTHORIZED_CUSTOMER يرتبط معرّف النقرة أو المكالمة بحساب على "إعلانات Google" لا تملك إذن الوصول إليه. تأكَّد من استيراد الإحالات الناجحة للحسابات التي يديرها حسابك الإداري.
TOO_RECENT_CONVERSION_ACTION لا يمكن استيراد الأحداث إلى إجراء إحالة ناجحة تم إنشاؤه للتو. جرِّب الاستيراد مرة أخرى بعد 6 ساعات.
CONVERSION_TRACKING_NOT_ENABLED_AT_IMPRESSION_TIME في وقت النقرة، لم تكن ميزة تتبُّع الإحالات الناجحة مفعّلة في حساب الإحالات الناجحة الفعّال لحساب "إعلانات Google" الذي يخصّ النقرة.
EXTERNAL_ATTRIBUTION_DATA_SET_FOR_NON_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION يتضمّن الحدث المستورَد بيانات تحديد مصدر خارجي، ولكن لم يتم إعداد إجراء الإحالة الناجحة لاستخدام نموذج تحديد مصدر خارجي. تأكّد من ضبط إجراء الإحالة الناجحة بشكلٍ صحيح وأعِد المحاولة.
EXTERNAL_ATTRIBUTION_DATA_NOT_SET_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION تم إعداد إجراء الإحالة الناجحة لاستخدام نموذج تحديد مصدر خارجي، ولكن لا يحتوي الحدث المستورَد على بيانات. تأكّد من أن الأحداث المستورَدة تتضمّن نسبة الإسهام في تحديد المصدر الخارجي وجميع الحقول اللازمة.
ORDER_ID_NOT_PERMITTED_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION لا يمكن استخدام مُعرّفات الطلبات لإحالة ناجحة تم قياسها باستخدام نموذج تحديد مصدر خارجي. تأكَّد من ضبط الإحالة الناجحة بشكلٍ صحيح وأنّ الأحداث المستورَدة لا تتضمّن سوى البيانات الضرورية، ثم أعِد المحاولة.
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".
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 لا يمكن استيراد الأحداث التي تتضمن متغيّرات مخصّصة تحتوي على معلومات تحديد الهوية الشخصية. يُرجى إزالة هذه المتغيّرات وإعادة المحاولة.
INVALID_CUSTOMER_FOR_CLICK ترتبط النقرة الواردة من الحدث المستورَد بحساب آخر على "إعلانات Google". تأكّد من استيراد الحدث إلى الحساب الصحيح.
INVALID_CUSTOMER_FOR_CALL ترتبط النقرة الواردة من المكالمة بحساب آخر على "إعلانات Google". تأكّد من استيراد الحدث إلى الحساب الصحيح. أرسِل طلبًا إلى ConversionTrackingSettings.google_ads_conversion_customer على "العميل" لتحديد الحساب الصحيح.
CONVERSION_NOT_COMPLIANT_WITH_ATT_POLICY لا يمكن استيراد الإحالة الناجحة لأنّ مصدر الإحالة الناجحة لم يلتزم بسياسات تتبُّع الشفافية لتطبيقات Apple (ATT) أو بسبب عدم موافقة العميل على التتبُّع.
CLICK_NOT_FOUND تتعذّر مطابقة عنوان البريد الإلكتروني أو رقم الهاتف الخاص بهذا الحدث مع إحدى النقرات. قد يرجع ذلك إلى أنّ هذه النقرة ليست واردة من حملة على "إعلانات Google"، وبالتالي يمكنك تجاهل هذا التحذير بشكلٍ آمن. إذا كان هذا الموقف يتضمن ظهور عدد من الأحداث المستورَدة أكبر من المتوقّع، قد تحتاج إلى إلقاء نظرة على إعداداتك.
INVALID_USER_IDENTIFIER تأكَّد من تجزئة البيانات المقدَّمة من المستخدِم باستخدام خوارزمية SHA-256 وتأكَّد من تسويتها وفقًا للإرشادات.
EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION_NOT_PERMITTED_WITH_USER_IDENTIFIER لا يمكن استخدام البيانات المقدَّمة من المستخدِم مع نماذج تحديد المصدر الخارجي. استخدِم نموذج تحديد مصدر مختلفًا أو احذف معرّفات المستخدِمين وجرِّب مرة أخرى.
UNSUPPORTED_USER_IDENTIFIER معرّفات المستخدِمين المقدَّمة غير متوافقة. استخدِم رقم هاتف أو عنوان بريد إلكتروني مجزّأ فقط وأعِد المحاولة.
GBRAID_WBRAID_BOTH_SET لا يمكن استخدام gbraid وwbraid. يُرجى استخدام معلمة واحدة فقط وإعادة المحاولة.
UNPARSEABLE_WBRAID لا يمكن تحليل بيانات استيراد الحدث. تأكَّد من أنّه لم يتم تعديل مَعلمة wbraid وأعِد المحاولة.
UNPARSEABLE_GBRAID لا يمكن تحليل بيانات استيراد الحدث. تأكّد ممّا إذا لم يتمّ تعديل المَعلمة gbraid وأعِد المحاولة.
ONE_PER_CLICK_CONVERSION_ACTION_NOT_PERMITTED_WITH_BRAID لا يمكن استخدام الإجراءات التي تَعدّ إحالة ناجحة واحدة بعد النقر مع المَعلمتين gbraid أو brbrid.
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS لا يمكن استخدام ميزة الإحالات الناجحة المحسّنة لهذا الحساب بسبب سياسات بيانات العميل في Google. يُرجى التواصل مع ممثّل Google الذي تتعامل معه.
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS يُرجى التأكّد من موافقتك على أحكام معالجة بيانات العملاء في إعدادات الإحالة الناجحة، ثم إعادة المحاولة. يمكنك التحقّق من إعداداتك عن طريق إرسال طلب البحث إلى conversionTrackingsetting.accepted_customer_data_terms على "العميل".
ORDER_ID_CONTAINS_PII لا يمكن استيراد الأحداث التي تتضمّن معرّفات طلبات تحتوي على معلومات تحديد الهوية الشخصية.
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS تأكّد من تفعيل ميزة الإحالات الناجحة المحسّنة للعملاء المحتملين في إعدادات الإحالة الناجحة وأعِد المحاولة. يمكنك التحقّق من إعدادك من خلال طلب البحث conversionTrackingSetting.enhanced_conversions_for_leads_enabled في Customer.
INVALID_JOB_ID معرّف الوظيفة المقدَّم في الطلب ليس ضمن النطاق المسموح به. يجب أن يكون معرّف الوظيفة عددًا صحيحًا موجبًا ضمن النطاق [1, 2^31 ).
NO_CONVERSION_ACTION_FOUND يتعذّر العثور على إجراء الإحالة الناجحة المحدّد في طلب التحميل. يُرجى التأكّد من توفّر الإجراء في هذا الحساب.
INVALID_CONVERSION_ACTION_TYPE لم يتم إعداد إجراء الإحالة الناجحة المحدّد في الطلب لتحميل الإحالات الناجحة.

DateError

يصف التعداد أخطاء التاريخ المحتملة.

عمليات التعداد
UNSPECIFIED لم يتم تحديد قيمة التعداد.
UNKNOWN رمز الخطأ الذي تم تلقّيه غير معروف في هذا الإصدار.
INVALID_FIELD_VALUES_IN_DATE لا تتوافق قيم الحقول المحدّدة مع تاريخ صالح.
INVALID_FIELD_VALUES_IN_DATE_TIME لا تتوافق قيم الحقول المحدّدة مع وقت تاريخ صالح.
INVALID_STRING_DATE يجب أن يكون تنسيق تاريخ السلسلة yyyy-mm-dd.
INVALID_STRING_DATE_TIME_MICROS يجب أن يكون تنسيق تاريخ السلسلة هو yyyy-mm-dd hh:mm:ss.ssssss.
INVALID_STRING_DATE_TIME_SECONDS يجب أن يكون تنسيق تاريخ السلسلة بالتنسيق yyyy-mm-dd hh:mm:ss.
INVALID_STRING_DATE_TIME_SECONDS_WITH_OFFSET يجب أن يكون تنسيق التاريخ والوقت في السلسلة yyyy-mm-dd hh:mm:ss+|-hh:mm.
EARLIER_THAN_MINIMUM_DATE التاريخ قبل الحد الأدنى المسموح به.
LATER_THAN_MAXIMUM_DATE التاريخ يقع بعد الحد الأقصى المسموح به.
DATE_RANGE_MINIMUM_DATE_LATER_THAN_MAXIMUM_DATE حدود النطاق الزمني غير مرتبة.
DATE_RANGE_MINIMUM_AND_MAXIMUM_DATES_BOTH_NULL كلا التاريخَين في النطاق غير صالحَين.

DistinctError

مصنّف يصف الأخطاء الواضحة المحتمَلة

عمليات التعداد
UNSPECIFIED لم يتم تحديد قيمة التعداد.
UNKNOWN رمز الخطأ الذي تم تلقّيه غير معروف في هذا الإصدار.
DUPLICATE_ELEMENT العنصر مكرّر.
DUPLICATE_TYPE نوع متكرر.

FieldError

يصف التعداد أخطاء الحقل المحتملة.

عمليات التعداد
UNSPECIFIED لم يتم تحديد قيمة التعداد.
UNKNOWN رمز الخطأ الذي تم تلقّيه غير معروف في هذا الإصدار.
REQUIRED لم يكن الحقل المطلوب متوفرًا.
IMMUTABLE_FIELD الحقل الذي تمّت محاولة تغييره غير قابل للتغيير.
INVALID_VALUE قيمة الحقل غير صالحة.
VALUE_MUST_BE_UNSET لا يمكن ضبط الحقل.
REQUIRED_NONEMPTY_LIST الحقل المتكرّر المطلوب فارغ.
FIELD_CANNOT_BE_CLEARED لا يمكن محو الحقل.
BLOCKED_VALUE قيمة الحقل مُدرَجة في قائمة الرفض لهذا الحقل.
FIELD_CAN_ONLY_BE_CLEARED لا يمكن تعديل قيمة الحقل، باستثناء محوها.

MutateError

يصف التعداد أخطاء التغيير المحتملة.

عمليات التعداد
UNSPECIFIED لم يتم تحديد قيمة التعداد.
UNKNOWN رمز الخطأ الذي تم تلقّيه غير معروف في هذا الإصدار.
RESOURCE_NOT_FOUND لم يتم العثور على المورد المطلوب.
ID_EXISTS_IN_MULTIPLE_MUTATES لا يمكن تغيير المورد نفسه مرّتين في طلب واحد.
INCONSISTENT_FIELD_VALUES لا تتطابق محتويات الحقل مع حقل آخر يمثّل البيانات نفسها.
MUTATE_NOT_ALLOWED لا يُسمح بإجراء عمليات التعديل على المورد المطلوب.
RESOURCE_NOT_IN_GOOGLE_ADS المرجع غير متوفّر في "إعلانات Google". ينتمي إلى نظام إعلانات آخر.
RESOURCE_ALREADY_EXISTS المورد الذي يتم إنشاؤه متوفّر حاليًا.
RESOURCE_DOES_NOT_SUPPORT_VALIDATE_ONLY لا يمكن استخدام هذا المورد مع "VerifyateOnly".
OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE لا يمكن استخدام هذه العملية مع "partialFailure".
RESOURCE_READ_ONLY محاولة الكتابة في الحقول للقراءة فقط

NotAllowlistedError

تسرد هذه القائمة المنظَّمة الأخطاء المحتمَلة التي تؤدي إلى عدم إدراج التطبيق في القائمة المسموح بها.

عمليات التعداد
UNSPECIFIED لم يتم تحديد قيمة التعداد.
UNKNOWN رمز الخطأ الذي تم تلقّيه غير معروف في هذا الإصدار.
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE العميل غير مُدرَج في القائمة المسموح بها للوصول إلى هذه الميزة.

StringFormatError

يصف التعداد الأخطاء المحتملة في تنسيق السلسلة.

عمليات التعداد
UNSPECIFIED لم يتم تحديد قيمة التعداد.
UNKNOWN رمز الخطأ الذي تم تلقّيه غير معروف في هذا الإصدار.
ILLEGAL_CHARS تحتوي قيمة سلسلة الإدخال على أحرف غير مسموح بها.
INVALID_FORMAT قيمة سلسلة الإدخال غير صالحة للحقل المرتبط.

StringLengthError

تسرد هذه السمة الأخطاء المحتمَلة في طول السلسلة.

عمليات التعداد
UNSPECIFIED لم يتم تحديد قيمة التعداد.
UNKNOWN رمز الخطأ الذي تم تلقّيه غير معروف في هذا الإصدار.
EMPTY يجب أن يحتوي الحقل المحدّد على حرف واحد بدون مسافات بيضاء على الأقل.
TOO_SHORT المحتوى قصير جدًا.
TOO_LONG طويل جدًا

OperatingSystemVersionConstant

إصدار نظام تشغيل للأجهزة الجوّالة أو مجموعة من الإصدارات، استنادًا إلى operatorType قائمة بأنظمة الأجهزة الجوّالة المتاحة على https://developers.google.com/google-ads/api/reference/data/codes-formats#mobile-platforms

تمثيل JSON 
{
  "resourceName": string,
  "operatorType": enum (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

نوع إصدار نظام التشغيل

عمليات التعداد
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

النتائج فقط. اسم المورد للسؤال المؤهِّل.

'qualifyingQuestions/{qualifyingQuestionId}'
qualifyingQuestionId

string (int64 format)

النتائج فقط. رقم تعريف السؤال المؤهِّل.
locale

string

النتائج فقط. لغة السؤال المؤهِّل.
text

string

النتائج فقط. السؤال المؤهِّل.

ParentalStatusView

عرض الحالة الأبوية

تمثيل JSON 
{
  "resourceName": string
}
الحقول
resourceName

string

النتائج فقط. اسم المورد لعرض الحالة الأبوية يكون شكل أسماء الموارد في عرض "الحالة الأبوية" على النحو التالي:

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

PerStoreView

عرض حسب المتجر توفِّر طريقة العرض هذه إحصاءات حول الإحالات الناجحة للإجراءات المحلية ومدى الوصول حسب مرات الظهور في المتجر للمعلِنين.

تمثيل JSON 
{
  "resourceName": string,
  "placeId": string
}
الحقول
resourceName

string

النتائج فقط. اسم المورد لعرض "حسب المتجر" تكون أسماء الموارد لكل عرض متجر على النحو التالي:

customers/{customerId}/perStoreViews/{placeId}
placeId

string

النتائج فقط. معرّف المكان لعرض "حسب المتجر"

ProductCategoryConstant

فئة المنتج.

تمثيل JSON 
{
  "resourceName": string,
  "categoryId": string,
  "level": enum (ProductCategoryLevel),
  "state": enum (ProductCategoryState),
  "localizations": [
    {
      object (ProductCategoryLocalization)
    }
  ],
  "productCategoryConstantParent": string
}
الحقول
resourceName

string

النتائج فقط. اسم المورد لفئة المنتج. تكون أسماء موارد فئات المنتجات على النحو التالي:

productCategoryConstants/{level}~{categoryId}
categoryId

string (int64 format)

النتائج فقط. معرّف فئة المنتج.

هذا المعرّف مكافئ لمعرّف google_product_category كما هو موضّح في هذه المقالة: https://support.google.com/merchants/answer/6324436.
level

enum (ProductCategoryLevel)

النتائج فقط. مستوى فئة المنتج.
state

enum (ProductCategoryState)

النتائج فقط. حالة فئة المنتج
localizations[]

object (ProductCategoryLocalization)

النتائج فقط. قائمة بجميع الترجمات المتاحة لفئة المنتج
productCategoryConstantParent

string

النتائج فقط. اسم المورد لفئة المنتج الرئيسية

ProductCategoryState

يصف التعداد حالة فئة المنتج.

عمليات التعداد
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

يشير إلى ما إذا كانت عبارة البحث هي إحدى الكلمات الرئيسية المستهدَفة أو المستبعدة.

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
ADDED تتم إضافة عبارة البحث إلى الكلمات الرئيسية المستهدَفة.
EXCLUDED تتطابق عبارة البحث مع كلمة رئيسية سلبية.
ADDED_EXCLUDED تمت إضافة عبارة البحث واستبعادها في الوقت نفسه.
NONE عبارة البحث غير مستهدفة أو مستبعدة.

ShoppingPerformanceView

عرض أداء التسوّق. يوفّر إحصاءات حملات Shopping مجمّعة على عدة مستويات لسمات المنتجات. ستعكس قيم سمات المنتج من Merchant Center، مثل العلامة التجارية والفئة والسمات المخصّصة وحالة المنتج ونوع المنتج، حالة كل سمة اعتبارًا من التاريخ والوقت اللذَين تم تسجيل الحدث المقابل فيهما.

تمثيل JSON 
{
  "resourceName": string
}
الحقول
resourceName

string

النتائج فقط. اسم المورد لعرض أداء Shopping. تكون أسماء المراجع لعرض أداء التسوّق على النحو التالي: 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

اهتمام المستخدم

اهتمام المستخدِم: مجال معيّن يستند إلى الاهتمامات المطلوب استهدافه

تمثيل 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

النتائج فقط. صحيح إذا بدأ اهتمام المستخدم بجميع القنوات واللغات.

UserInterestTaxonomyType

التعداد الذي يحتوي على أنواع UserinterestTaxonomyTypes المحتملة

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
AFFINITY التقارب لاهتمام المستخدم هذا.
IN_MARKET السوق الذي يستقطب اهتمام المستخدم
MOBILE_APP_INSTALL_USER المستخدمون الذين يُعرف أنّهم ثبَّتوا تطبيقات في الفئات المحدّدة
VERTICAL_GEO الموقع الجغرافي للقطاع المستنِد إلى الاهتمامات
NEW_SMART_PHONE_USER معايير اهتمام المستخدمين لمستخدمي الهواتف الذكية الجدد.

LifeEvent

حدث في الحياة: مجال معيّن يستند إلى الاهتمامات يتم استهدافه للوصول إلى المستخدِمين خلال محطّات مهمة في الحياة.

تمثيل JSON 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "parent": string,
  "launchedToAll": boolean,
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ]
}
الحقول
resourceName

string

النتائج فقط. اسم مورد الحدث في الحياة تكون أسماء موارد الأحداث في الحياة على النحو التالي:

customers/{customerId}/lifeEvents/{lifeEventId}
id

string (int64 format)

النتائج فقط. رقم تعريف الحدث في الحياة
name

string

النتائج فقط. اسم حدث الحياة، على سبيل المثال، "نقل مؤخرًا"
parent

string

النتائج فقط. العنصر الرئيسي لـ lifeEvent.
launchedToAll

boolean

النتائج فقط. صحيح إذا تم إطلاق الحدث المباشر على جميع القنوات واللغات.
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

النتائج فقط. AdGroupAd المرتبط بنموذج العملاء المحتملين الذي تم إرساله
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

البيانات من عميل محتمل على "الخدمات المحلّية" تحتوي على تفاصيل العميل المحتمل التي يتم إنشاؤها عندما يتصل المستخدم أو يرسِل رسائل أو يحجز خدمة معيّنة في خدمة من المعلن. مزيد من المعلومات: 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

النتائج فقط. اسم المورد لبيانات العملاء المحتملين في الخدمات المحلّية. يظهر اسم مورد العميل المحتمل في "الخدمات المحلّية" على النحو التالي:

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)

النتائج فقط. نوع العميل المحتمل في "الخدمات المحلّية": الهاتف أو الرسالة أو الحجز أو غير ذلك
leadStatus

enum (LeadStatus)

النتائج فقط. الحالة الحالية لعميل محتمل.
creationDateTime

string

النتائج فقط. التاريخ والوقت الذي تم فيه إنشاء العميل المحتمل بواسطة "إعلانات الخدمات المحلّية". يكون التنسيق هو "YYYY-MM-DD HH:MM:SS" في المنطقة الزمنية لحساب "إعلانات Google". أمثلة: "2018-03-05 09:15:00" أو "2018-02-01 14:34:30"
locale

string

النتائج فقط. اللغة التي يستخدمها مقدِّم "الخدمات المحلّية" المرتبط بالعميل المحتمل. راجِع https://developers.google.com/google-ads/api/data/codes-formats#locales.
leadCharged

boolean

النتائج فقط. صحيح إذا تم تحصيل رسوم من المعلِن مقابل العميل المحتمل.
note

object (Note)

النتائج فقط. أضاف المعلِن ملاحظة عن العميل المحتمل.
creditDetails

object (CreditDetails)

النتائج فقط. تفاصيل الائتمان الخاصة بالعميل المحتمل

ContactDetails

الحقول التي تحتوي على تفاصيل الاتصال بالمستهلك

تمثيل JSON 
{
  "phoneNumber": string,
  "email": string,
  "consumerName": string
}
الحقول
phoneNumber

string

النتائج فقط. رقم هاتف المستهلك بتنسيق E164
email

string

النتائج فقط. عنوان البريد الإلكتروني للمستهلك.
consumerName

string

النتائج فقط. اسم المستهلك إذا قدّم المستهلك الاسم من الرسالة أو نموذج الحجز على google.com

LeadType

الأنواع المحتملة من العملاء المحتملين.

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لأغراض القيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
MESSAGE رسالة العميل المحتمل
PHONE_CALL تم إنشاء العميل المحتمل من خلال مكالمة هاتفية.
BOOKING عميل محتمل للحجز

LeadStatus

الحالات المحتملة للعميل المحتمل

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لأغراض القيمة المعروضة فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
NEW عميل محتمل جديد لم يظهر للمعلِن حتى الآن.
ACTIVE العميل المحتمل الذي تفاعل معه المعلن.
BOOKED تم حجز العميل المحتمل.
DECLINED رفض المعلِن العميل المحتمل.
EXPIRED انتهت صلاحية العميل المحتمل بسبب عدم نشاطه.
DISABLED تم إيقافها بسبب محتوى غير مرغوب فيه أو نزاع.
CONSUMER_DECLINED رفض المستهلك العميل المحتمل.
WIPED_OUT يتم محو معلومات تحديد الهوية الشخصية للعميل المحتمل.

ملاحظة

يمثّل هذا الحقل ملاحظة أضافها المعلِن إلى عميل محتمل. يمكن للمعلنين تعديل الملاحظات، ما سيؤدي إلى إعادة ضبط وقت التعديل وتغيير الوصف.

تمثيل JSON 
{
  "editDateTime": string,
  "description": string
}
الحقول
editDateTime

string

النتائج فقط. التاريخ والوقت اللذان تم فيهما تعديل ملاحظة العميل المحتمل يكون التنسيق هو "YYYY-MM-DD HH:MM:SS" في المنطقة الزمنية لحساب "إعلانات Google". أمثلة: "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". أمثلة: "2018-03-05 09:15:00" أو "2018-02-01 14:34:30"

CreditState

حالات الائتمان المحتمَلة للعميل المحتمل

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
PENDING تم تقديم رصيد وجارٍ معالجته بواسطة الواجهة الخلفية لـ "إعلانات Google"، ولكن لم يتم تطبيقه على الحساب بعد.
CREDITED تم إصدار الرصيد إلى حساب "إعلانات Google".

LocalServicesLeadConversation

البيانات من محادثة العميل المحتمل في "الخدمات المحلّية" يحتوي على تفاصيل "محادثة العميل المحتمل" التي يتم إنشاؤها عند اتّصال المستخدم أو إرسال رسائل أو حجز خدمة من المعلِن. ويتم إلحاقها ببيانات العميل المحتمل. مزيد من المعلومات: 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

النتائج فقط. اسم مورد بيانات المحادثة للعملاء المحتملين في "الخدمات المحلّية". يكون اسم مورد محادثة العميل المحتمل في "الخدمات المحلّية" بالشكل التالي:

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

النتائج فقط. التاريخ والوقت الذي تم فيه إنشاء محادثة العميل المحتمل بواسطة "إعلانات الخدمات المحلّية". يكون التنسيق هو "YYYY-MM-DD HH:MM:SS" في المنطقة الزمنية لحساب "إعلانات Google". أمثلة: "2018-03-05 09:15:00" أو "2018-02-01 14:34:30"
phoneCallDetails

object (PhoneCallDetails)

النتائج فقط. تفاصيل محادثة المكالمة الهاتفية في حال PHONE_CALL
messageDetails

object (MessageDetails)

النتائج فقط. تفاصيل محادثة الرسائل في حالة EMAIL أو MESSAGE أو SMS.

ConversationType

الأنواع المحتملة لمحادثات العملاء المحتملين

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لأغراض القيمة المعروضة فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
EMAIL محادثة مع عميل محتمل عبر البريد الإلكتروني
MESSAGE محادثة مع عميل محتمل عبر الرسائل
PHONE_CALL محادثة مع عميل محتمل من مكالمة هاتفية
SMS محادثة عميل محتمل عبر الرسائل القصيرة SMS.
BOOKING حجز محادثة العميل المحتمل

ParticipantType

الأنواع المحتملة للمشاركين في المحادثة الرئيسية.

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
ADVERTISER مقدّم خدمة مشارك في "إعلانات الخدمات المحلّية"
CONSUMER مشارك مستهلك في "إعلانات الخدمات المحلّية"

PhoneCallDetails

لتمثيل تفاصيل محادثة مكالمة هاتفية.

تمثيل JSON 
{
  "callDurationMillis": string,
  "callRecordingUrl": string
}
الحقول
callDurationMillis

string (int64 format)

النتائج فقط. مدة المكالمة الهاتفية (بالمللي ثانية) (من النهاية إلى النهاية).
callRecordingUrl

string

النتائج فقط. عنوان URL للملف الصوتي لتسجيل المكالمات.

MessageDetails

يمثّل تفاصيل الرسالة النصية في حال البريد الإلكتروني أو الرسالة أو الرسالة القصيرة.

تمثيل JSON 
{
  "text": string,
  "attachmentUrls": [
    string
  ]
}
الحقول
text

string

النتائج فقط. المحتوى النصي للرسالة.
attachmentUrls[]

string

النتائج فقط. عنوان URL لمرفقات الرسائل القصيرة أو الرسائل الإلكترونية يمكن استخدام عناوين 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)

النتائج فقط. قائمة بأنواع التفاعلات المستخدَمة في ترميز مفتاح المشاركة
androidPrivacyInteractionDate

string

النتائج فقط. تاريخ التفاعل المستخدَم في ترميز المفتاح المشترك بالتنسيق "YYYY-MM-DD" في المنطقة الزمنية حسب التوقيت العالمي المنسَّق (UTC).
androidPrivacyNetworkType

enum (AndroidPrivacyNetworkType)

النتائج فقط. تعداد نوع الشبكة المُستخدَم في ترميز مفتاح المشاركة.
adGroupId

string (int64 format)

النتائج فقط. رقم تعريف المجموعة الإعلانية المستخدَم في ترميز مفتاح المشاركة.
sharedAdGroupKey

string

النتائج فقط. سلسلة سداسية عشرية بسعة 128 بت لمفتاح المجموعة الإعلانية المشترَك المشفَّر، بما في ذلك البادئة ‎0x يمكن استخدام هذا المفتاح لإجراء عامل تشغيل OR على مستوى الوحدات بتية مع مفتاح الإحالة الناجحة المجمّعة لإنشاء مفتاح تجميع كامل لاسترداد تقرير Aggregate API في "مبادرة حماية الخصوصية" من Android.

AndroidPrivacyInteractionType

يسرد أنواع التفاعلات

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN القيمة غير معروفة في هذا الإصدار.
CLICK نوع التفاعل الناتج عن النقرة.
ENGAGED_VIEW نوع تفاعل عرض مطوّل للإعلان لمدة 10 ثوانٍ.
VIEW نوع التفاعل مع المشاهدة (مرّة ظهور الإعلان)

AndroidPrivacyNetworkType

يسرد أنواع الشبكات

عمليات التعداد
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)

النتائج فقط. قائمة بأنواع التفاعلات المستخدَمة في ترميز مفتاح المشاركة
androidPrivacyInteractionDate

string

النتائج فقط. تاريخ التفاعل المستخدَم في ترميز المفتاح المشترك بالتنسيق "YYYY-MM-DD" في المنطقة الزمنية حسب التوقيت العالمي المنسَّق (UTC).
sharedCampaignKey

string

النتائج فقط. سلسلة سداسية عشرية 128 بت لمفتاح الحملة المشترك المشفر، بما في ذلك البادئة "0x". ويمكن استخدام هذا المفتاح لإجراء عامل تشغيل OR على مستوى البت باستخدام مفتاح التحويل المجمَّع لإنشاء مفتاح تجميع كامل لاسترداد التقرير المجمّع لواجهة برمجة التطبيقات في "مبادرة حماية الخصوصية على 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)

النتائج فقط. قائمة بأنواع التفاعلات المستخدَمة في ترميز مفتاح المشاركة
androidPrivacyInteractionDate

string

النتائج فقط. تاريخ التفاعل المستخدَم في ترميز المفتاح المشترك بالتنسيق "YYYY-MM-DD" في المنطقة الزمنية حسب التوقيت العالمي المنسَّق (UTC).
androidPrivacyNetworkType

enum (AndroidPrivacyNetworkType)

النتائج فقط. تعداد نوع الشبكة المُستخدَم في ترميز مفتاح المشاركة.
sharedNetworkTypeKey

string

النتائج فقط. سلسلة سداسية عشرية 128 بت لمفتاح نوع الشبكة المشتركة المشفر، بما في ذلك البادئة "0x". يمكن استخدام هذا المفتاح لإجراء عملية OR على مستوى الوحدات بتية مع مفتاح الإحالة الناجحة المجمّعة لإنشاء مفتاح تجميع كامل لاسترداد تقرير Aggregate 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

قيمة الإحالات الناجحة. ولا يشمل ذلك سوى إجراءات الإحالات الناجحة التي تم ضبط سمة "Inالإحالات الناجحة" عليها على "صحيح". إذا كنت تستخدِم عروض أسعار مستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين الأداء لتحقيق هذه الإحالات الناجحة. عند اختيار هذا العمود مع التاريخ، تشير القيم في عمود التاريخ إلى تاريخ الإحالة الناجحة. تتوفّر تفاصيل أعمدة by_conversion_date على الرابط https://support.google.com/google-ads/answer/9549009.
conversionsByConversionDate

number

عدد الإحالات الناجحة. ولا يشمل ذلك سوى إجراءات الإحالات الناجحة التي تم ضبط سمة "Inالإحالات الناجحة" عليها على "صحيح". إذا كنت تستخدِم عروض أسعار مستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين الأداء لتحقيق هذه الإحالات الناجحة. عند اختيار هذا العمود مع التاريخ، تشير القيم في عمود التاريخ إلى تاريخ الإحالة الناجحة. تتوفّر تفاصيل أعمدة by_conversion_date على الرابط https://support.google.com/google-ads/answer/9549009.
historicalCreativeQualityScore

enum (QualityScoreBucket)

نقاط الجودة للفترات السابقة لتصميم الإعلان
historicalLandingPageQualityScore

enum (QualityScoreBucket)

جودة تجربة الصفحة المقصودة السابقة
historicalSearchPredictedCtr

enum (QualityScoreBucket)

نسبة النقر إلى الظهور المتوقّعة في نتائج البحث السابقة
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

"نسبة ظهور الإعلان في صدارة الصفحة على شبكة البحث" هي النسبة المئوية لمرات ظهور إعلانك في أبرز موضع على "شبكة البحث".
activeViewCpm

number

متوسط تكلفة مرات الظهور القابلة للعرض (activeViewImpressions).
activeViewCtr

number

عدد النقرات القابلة للقياس للعرض النشط مقسومًا على مرات الظهور القابلة للعرض في العرض النشط

يتم الإبلاغ عن هذا المقياس للشبكة الإعلانية فقط.
activeViewImpressions

string (int64 format)

مقياس لعدد المرات التي يصبح فيها إعلانك قابلاً للعرض على موقع في الشبكة الإعلانية.
activeViewMeasurability

number

نسبة مرات الظهور التي يمكن قياسها باستخدام ميزة "العرض النشط" إلى عدد مرات الظهور التي تم عرضها.
activeViewMeasurableCostMicros

string (int64 format)

تكلفة مرات الظهور التي تلقّيتها والتي كانت قابلة للقياس عن طريق العرض النشط.
activeViewMeasurableImpressions

string (int64 format)

عدد مرّات ظهور إعلاناتك في مواضع الإعلانات في مواضع يمكن رؤيتها.
activeViewViewability

number

هي النسبة المئوية لعدد المرات التي ظهر فيها إعلانك على موقع إلكتروني مفعَّل فيه العرض النشط (مرّات الظهور القابلة للقياس) وكان قابلاً للعرض (مرّات الظهور القابلة للعرض).
allConversionsFromInteractionsRate

number

كل الإحالات الناجحة من التفاعلات (بهدف العرض من خلال الإحالات الناجحة) مقسومةً على عدد التفاعلات مع الإعلان.
allConversionsValue

number

قيمة كل الإحالات الناجحة.
allNewCustomerLifetimeValue

number

جميع قيم الإحالات الناجحة الدائمة للعملاء الجدد إذا كنت قد أعددت هدف اكتساب العملاء على مستوى الحساب أو على مستوى الحملة، سيتضمّن ذلك قيمة الإحالة الناجحة الإضافية من العملاء الجدد لكلّ من الإحالات الناجحة التي يمكن تقديم عروض أسعار لها وغير القابلة لتقديم عروض أسعار لها. إذا اعتمدت حملتك هدف اكتساب العملاء واختَرت "ضبط عروض أسعار أعلى للعملاء الجدد"، سيتم تضمين هذه القيم في "allconversionValue". يمكنك الاطّلاع على 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".
benchmarkAverageMaxCpc

number

مؤشر على عروض أسعار المعلِنين الآخرين على منتجات مشابهة
biddableAppInstallConversions

number

عدد عمليات تثبيت التطبيق.
biddableAppPostInstallConversions

number

عدد الإجراءات داخل التطبيق
benchmarkCtr

number

مؤشر على مستوى أداء إعلانات Shopping الخاصة بالمعلِنين الآخرين للمنتجات المشابهة استنادًا إلى عدد المرات التي ينقر فيها المستخدمون الذين يطّلعون على إعلاناتهم عليه.
bounceRate

number

النسبة المئوية للنقرات التي زار فيها المستخدِم صفحة واحدة فقط على موقعك الإلكتروني. تم الاستيراد من "إحصاءات Google".
clicks

string (int64 format)

عدد النقرات
combinedClicks

string (int64 format)

عدد المرّات التي تم فيها النقر على إعلانك أو موقعك الإلكتروني في النتائج غير المدفوعة. يمكنك الاطّلاع على صفحة المساعدة على https://support.google.com/google-ads/answer/3097241 لمعرفة التفاصيل.
combinedClicksPerQuery

number

عدد المرات التي تم فيها النقر على إعلانك أو موقعك الإلكتروني في النتائج غير المدفوعة (النقرات المجمّعة) مقسومًا على عدد طلبات البحث المجمّعة. راجع صفحة المساعدة على https://support.google.com/google-ads/answer/3097241 للحصول على التفاصيل.
combinedQueries

string (int64 format)

عدد عمليات البحث التي أدّت إلى عرض صفحات من موقعك الإلكتروني في النتائج غير المدفوعة أو عرض أحد إعلاناتك النصية. يمكنك الاطّلاع على صفحة المساعدة على https://support.google.com/google-ads/answer/3097241 لمعرفة التفاصيل.
contentBudgetLostImpressionShare

number

النسبة المئوية المقدَّرة لعدد المرّات التي كان فيها إعلانك مؤهّلاً للظهور على "الشبكة الإعلانية" ولكنّه لم يظهر لأنّ ميزانيتك كانت منخفضة جدًا. ملاحظة: يتم تسجيل نسبة ظهور الإعلان المفقودة في ميزانية المحتوى في نطاق يتراوح بين 0 و0.9. يتم تسجيل أي قيمة أعلى من 0.9 على أنّها 0.9001.
contentImpressionShare

number

عدد مرات الظهور التي تلقاها إعلانك على الشبكة الإعلانية مقسومًا على العدد المقدَّر لمرات الظهور التي كنت مؤهَّلاً للحصول عليها. ملاحظة: يتم تسجيل نسبة ظهور الإعلانات على المحتوى في النطاق من 0.1 إلى 1. أي قيمة أقل من 0.1 يتم تسجيلها كـ 0.0999.
conversionLastReceivedRequestDateTime

string

آخر تاريخ/وقت تم فيه تنشيط علامة إحالة ناجحة لإجراء الإحالة الناجحة هذا بنجاح ورصدها من قِبل "إعلانات Google". قد لا يكون حدث التفعيل هذا نتيجة إحالة ناجحة يمكن تحديد مصدرها (على سبيل المثال، لأنّه تم تنشيط العلامة من متصفّح لم ينقر سابقًا على إعلان من معلِن مناسب). التاريخ/الوقت في المنطقة الزمنية للعميل.
conversionLastConversionDate

string

تاريخ آخر إحالة ناجحة لإجراء الإحالة الناجحة هذا. يتم عرض التاريخ حسب المنطقة الزمنية للعميل.
contentRankLostImpressionShare

number

النسبة المئوية المقدَّرة لمرات الظهور على الشبكة الإعلانية التي لم تتلقَّها إعلاناتك بسبب انخفاض ترتيب الإعلان. ملاحظة: تظهر نسبة ظهور الإعلان المفقودة في ترتيب المحتوى في النطاق بين 0 و0.9. ويتم الإبلاغ عن أي قيمة أعلى من 0.9 كـ 0.9001.
conversionsFromInteractionsRate

number

الإحالات الناجحة من التفاعلات مقسومةً على عدد التفاعلات مع الإعلانات (مثل النقرات على الإعلانات النصية أو مرّات المشاهدة لإعلانات الفيديو). ولا يشمل ذلك سوى إجراءات الإحالات الناجحة التي تم ضبط سمة "Inالإحالات الناجحة" عليها على "صحيح". وإذا كنت تستخدم عروض الأسعار المستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين هذه الإحالات الناجحة.
conversionsValue

number

قيمة الإحالات الناجحة. لا يشمل ذلك سوى إجراءات الإحالات الناجحة التي تم ضبط السمة includeInConversionsMetric عليها على true. إذا كنت تستخدِم عروض أسعار مستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين الأداء لتحقيق هذه الإحالات الناجحة.
newCustomerLifetimeValue

number

قيمة الإحالة الناجحة الدائمة للعملاء الجدد. في حال إعداد هدف اكتساب العملاء على مستوى الحساب أو على مستوى الحملة، سيتضمّن ذلك قيمة الإحالة الناجحة الإضافية التي يحقّقها العملاء الجدد للإحالات الناجحة التي يمكن تقديم عروض أسعار لها. إذا اعتمدت حملتك هدف اكتساب العملاء واخترت "رفع عروض الأسعار للعملاء الجدد"، سيتم تضمين هذه القيم في "conversionsValue" للتحسين. يمكنك الاطّلاع على https://support.google.com/google-ads/answer/12080169 للحصول على مزيد من التفاصيل.
conversionsValuePerCost

number

قيمة الإحالات الناجحة مقسومة على تكلفة التفاعلات مع الإعلانات. ولا يشمل ذلك سوى إجراءات الإحالات الناجحة التي تم ضبط سمة "Inالإحالات الناجحة" عليها على "صحيح". إذا كنت تستخدِم عروض أسعار مستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين الأداء لتحقيق هذه الإحالات الناجحة.
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" على جهاز معيّن، ثمّ إجرائه لإحالة ناجحة على جهاز أو متصفّح آخر. يتم تضمين الإحالات الناجحة باستخدام أكثر من جهاز واحد في كل الإحالات الناجحة مسبقًا.
crossDeviceConversionsValueMicros

string (int64 format)

مجموع قيمة الإحالات الناجحة باستخدام أكثر من جهاز واحد بوحدات المايكرو.
ctr

number

عدد النقرات التي يتلقّاها إعلانك (النقرات) مقسومًا على عدد مرّات ظهور إعلانك (مرّات الظهور).
currentModelAttributedConversions

number

تعرِض هذه السمة الشكل الذي ستظهر به بيانات الإحالات الناجحة السابقة بموجب نموذج تحديد المصدر الذي اخترته حاليًا. ولا يشمل ذلك سوى إجراءات الإحالات الناجحة التي تم ضبط سمة "Inالإحالات الناجحة" عليها على "صحيح". وإذا كنت تستخدم عروض الأسعار المستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين هذه الإحالات الناجحة.
currentModelAttributedConversionsFromInteractionsRate

number

الإحالات الناجحة المنسوبة للنموذج الحالي مقسومة على عدد التفاعلات مع الإعلانات (مثل النقرات على الإعلانات النصية أو مرات المشاهدة لإعلانات الفيديو). لا يشمل ذلك سوى إجراءات الإحالات الناجحة التي تم ضبط السمة includeInConversionsMetric عليها على true. وإذا كنت تستخدم عروض الأسعار المستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين هذه الإحالات الناجحة.
currentModelAttributedConversionsFromInteractionsValuePerInteraction

number

قيمة الإحالات الناجحة المنسوبة للنموذج الحالي من التفاعلات مقسومةً على عدد التفاعلات مع الإعلانات. ولا يشمل ذلك سوى إجراءات الإحالات الناجحة التي تم ضبط سمة "Inالإحالات الناجحة" عليها على "صحيح". إذا كنت تستخدِم عروض أسعار مستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين الأداء لتحقيق هذه الإحالات الناجحة.
currentModelAttributedConversionsValue

number

قيمة الإحالات الناجحة التي تمّ تحديد مصدرها باستخدام النموذج الحالي. لا يشمل ذلك سوى إجراءات الإحالات الناجحة التي تم ضبط السمة includeInConversionsMetric عليها على true. وإذا كنت تستخدم عروض الأسعار المستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين هذه الإحالات الناجحة.
currentModelAttributedConversionsValuePerCost

number

قيمة الإحالات الناجحة التي تمّ تحديد مصدرها باستخدام النموذج الحالي مقسومةً على تكلفة التفاعلات مع الإعلانات. ولا يشمل ذلك سوى إجراءات الإحالات الناجحة التي تم ضبط سمة "Inالإحالات الناجحة" عليها على "صحيح". إذا كنت تستخدِم عروض أسعار مستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين الأداء لتحقيق هذه الإحالات الناجحة.
engagementRate

number

عدد مرات تفاعل المستخدمين مع إعلانك بعد ظهوره لهم. يشير ذلك إلى عدد معلومات الإعلان الإضافية مقسومًا على عدد مرّات عرض إعلانك.
engagements

string (int64 format)

عدد التفاعلات تحدث المشاركة عندما يُوسع مشاهد إعلان مربع تكبير الصورة. وفي المستقبل أيضًا، قد تدعم أنواع إعلانات أخرى مقاييس المشاركة.
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)

عدد التفاعلات التفاعل هو الإجراء الأساسي الذي يتخذه المستخدم والمرتبط بالنقرات على شكل إعلان في الإعلانات النصية وإعلانات Shopping، ومرات مشاهدة إعلانات الفيديو، وما إلى ذلك.
invalidClickRate

number

النسبة المئوية للنقرات التي تم استبعادها من إجمالي عدد النقرات (النقرات التي تمّت فلترتها + النقرات التي لم تتمّ فلترتها) خلال فترة إعداد التقارير.
invalidClicks

string (int64 format)

عدد النقرات التي تعتبرها Google غير مشروعة ولا تحصّل رسومًا منك مقابلها.
messageChats

string (int64 format)

عدد محادثات الرسائل التي بدأت لمرات ظهور النقر للمراسلة التي كانت مؤهلة لتتبع الرسائل.
messageImpressions

string (int64 format)

عدد مرات ظهور ميزة "انقر للمراسلة" التي كانت مؤهَّلة لتتبُّع الرسائل.
messageChatRate

number

عدد محادثات الرسائل التي تمّ بدؤها (messageChats) مقسومًا على عدد مرّات ظهور الرسائل (messageImpressions). هو معدّل بدء المستخدم لمحادثة الرسائل استنادًا إلى مرّة ظهور للإعلان مع تفعيل خيار المراسلة وميزة تتبُّع الرسائل. تجدر الإشارة إلى أنّ هذا المعدّل قد يكون أعلى من 1.0 مرّة ظهور معيّنة للرسالة.
mobileFriendlyClicksPercentage

number

النسبة المئوية للنقرات على الأجهزة الجوّالة التي تذهب إلى صفحة متوافقة مع الأجهزة الجوّالة.
optimizationScoreUplift

number

رفع إجمالي نتيجة التحسين لجميع الاقتراحات
optimizationScoreUrl

string

عنوان URL لصفحة نتيجة التحسين في واجهة "إعلانات Google" على الويب. يمكن اختيار هذا المقياس من customer أو campaign، ويمكن تقسيمه حسب segments.recommendation_type. على سبيل المثال، ستعرض الدالة SELECT metrics.optimization_score_url, segments.recommendation_type FROM customer عنوان URL لكل مجموعة فريدة (customer, recommendationsType) فريدة.
organicClicks

string (int64 format)

عدد مرات نقر أحد الأشخاص على موقعك في نتائج البحث المجانية لطلب بحث معين. راجع صفحة المساعدة على https://support.google.com/google-ads/answer/3097241 للحصول على التفاصيل.
organicClicksPerQuery

number

عدد المرّات التي نقر فيها أحد الأشخاص على بطاقة بيانات موقعك الإلكتروني في النتائج غير المدفوعة (النقرات المجانية) مقسومًا على إجمالي عدد عمليات البحث التي أدّت إلى عرض صفحات من موقعك الإلكتروني (طلبات البحث المجانية). يمكنك الاطّلاع على صفحة المساعدة على 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".
phoneCalls

string (int64 format)

عدد المكالمات الهاتفية بلا إنترنت
phoneImpressions

string (int64 format)

عدد مرات ظهور رقم الهاتف بلا اتصال بالإنترنت
phoneThroughRate

number

عدد المكالمات الهاتفية التي تم تلقيها (phoneCalls) مقسومًا على عدد مرّات ظهور رقم هاتفك (phoneImpressions).
relativeCtr

number

نسبة النقر إلى الظهور مقسومةً على متوسّط نسبة النقر إلى الظهور لجميع المعلِنين على المواقع الإلكترونية التي تعرِض إعلاناتك. يقيس مستوى أداء إعلاناتك على مواقع "شبكة Google الإعلانية" مقارنةً بالإعلانات الأخرى على المواقع نفسها.
searchAbsoluteTopImpressionShare

number

النسبة المئوية لمرات ظهور الإعلان على شبكة البحث أو Shopping للعميل التي تظهر في أبرز مواضع Shopping. اطّلِع على 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

النسبة المئوية للنقرات على الإعلانات المؤدية إلى صفحات AMP المقصودة التي تصل إلى صفحة AMP صالحة.
valuePerAllConversions

number

قيمة كل الإحالات الناجحة مقسومة على عدد كل الإحالات الناجحة.
valuePerAllConversionsByConversionDate

number

قيمة كل الإحالات الناجحة مقسومة على عدد كل الإحالات الناجحة. عند اختيار هذا العمود مع التاريخ، تشير القيم في عمود التاريخ إلى تاريخ الإحالة الناجحة. تتوفّر تفاصيل أعمدة by_conversion_date على الرابط https://support.google.com/google-ads/answer/9549009.
valuePerConversion

number

قيمة الإحالات الناجحة مقسومةً على عدد الإحالات الناجحة لا يشمل ذلك سوى إجراءات الإحالات الناجحة التي تم ضبط السمة includeInConversionsMetric عليها على true. إذا كنت تستخدِم عروض أسعار مستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين الأداء لتحقيق هذه الإحالات الناجحة.
valuePerConversionsByConversionDate

number

قيمة الإحالات الناجحة مقسومةً على عدد الإحالات الناجحة ولا يشمل ذلك سوى إجراءات الإحالات الناجحة التي تم ضبط سمة "Inالإحالات الناجحة" عليها على "صحيح". إذا كنت تستخدِم عروض أسعار مستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين الأداء لتحقيق هذه الإحالات الناجحة. عند اختيار هذا العمود مع التاريخ، تشير القيم في عمود التاريخ إلى تاريخ الإحالة الناجحة. تتوفّر تفاصيل أعمدة by_conversion_date على الرابط https://support.google.com/google-ads/answer/9549009.
valuePerCurrentModelAttributedConversion

number

قيمة الإحالات الناجحة التي تمّ تحديد مصدرها باستخدام النموذج الحالي مقسومةً على عدد الإحالات الناجحة. لا يشمل ذلك سوى إجراءات الإحالات الناجحة التي تم ضبط السمة includeInConversionsMetric عليها على true. وإذا كنت تستخدم عروض الأسعار المستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين هذه الإحالات الناجحة.
videoQuartileP100Rate

number

النسبة المئوية لمرّات الظهور التي شاهد فيها المستخدم الفيديو بالكامل
videoQuartileP25Rate

number

النسبة المئوية لمرّات الظهور التي شاهد فيها المستخدم 25% من الفيديو
videoQuartileP50Rate

number

النسبة المئوية لمرّات الظهور التي شاهد فيها المستخدم 50% من الفيديو
videoQuartileP75Rate

number

النسبة المئوية لمرات الظهور التي شاهد فيها المشاهد ‎75% من الفيديو
videoViewRate

number

عدد المشاهدات التي يتلقاها إعلان فيديو TrueView مقسومًا على عدد مرات ظهوره، بما في ذلك مرات ظهور الصورة المصغَّرة لإعلانات TrueView ضمن العرض.
videoViews

string (int64 format)

عدد مرّات مشاهدة إعلاناتك على الفيديو
viewThroughConversions

string (int64 format)

إجمالي عدد الإحالات الناجحة بعد رؤية الإعلان فقط. تحدث هذه الإحالات الناجحة عندما يرى عميل صورة أو إعلانًا بالوسائط الغنية، ثم يُكمل لاحقًا إحالة ناجحة على موقعك الإلكتروني بدون التفاعل مع إعلان آخر (مثلاً، النقر عليه).
allConversionsFromLocationAssetClickToCall

number

عدد النقرات على زر الاتصال في أيّ مساحة عرض للموقع الجغرافي بعد حدث إعلان خاضع للرسوم (نقرة أو مرّة ظهور). يأتي هذا المقياس من موقع جغرافي مستند إلى مواد العرض.
allConversionsFromLocationAssetDirections

number

عدد النقرات على اتجاهات القيادة على أي مساحة عرض للموقع الجغرافي بعد حدث إعلان قابل لتحصيل الرسوم (نقرة أو مرّة ظهور). يأتي هذا المقياس من الموقع الجغرافي المستنِد إلى مادة العرض.
allConversionsFromLocationAssetMenu

number

عدد النقرات على رابط القوائم على مساحة عرض موقع جغرافي بعد حدث إعلان قابل لتحصيل الرسوم (نقرة أو مرّة ظهور) يأتي هذا المقياس من موقع جغرافي مستند إلى مواد العرض.
allConversionsFromLocationAssetOrder

number

عدد النقرات على الطلبات في أيّ مساحة عرض للموقع الجغرافي بعد حدث إعلان خاضع للرسوم (نقرة أو مرّة ظهور). يأتي هذا المقياس من موقع جغرافي مستند إلى مواد العرض.
allConversionsFromLocationAssetOtherEngagement

number

عدد الأنواع الأخرى من النقرات على الإجراءات المحلية على أيّ مساحة عرض للموقع الجغرافي بعد حدث إعلان قابل لتحصيل الرسوم (نقرة أو مرّة ظهور) يأتي هذا المقياس من موقع جغرافي مستند إلى مواد العرض.
allConversionsFromLocationAssetStoreVisits

number

العدد المقدّر للزيارات إلى المتجر بعد حدث إعلان قابل لتحصيل الرسوم (نقرة أو مرة ظهور). يأتي هذا المقياس من موقع جغرافي مستند إلى مواد العرض.
allConversionsFromLocationAssetWebsite

number

عدد النقرات على عنوان URL للموقع الإلكتروني على أي مساحة عرض للمكان بعد حدث إعلان قابل لتحصيل الرسوم (نقرة أو مرة ظهور). يأتي هذا المقياس من موقع جغرافي مستند إلى مواد العرض.
eligibleImpressionsFromLocationAssetStoreReach

string (int64 format)

عدد مرّات الظهور التي تمّ فيها عرض الموقع الجغرافي للمتجر أو تمّ استخدامه للاستهداف. يأتي هذا المقياس من الموقع الجغرافي المستنِد إلى مادة العرض.
viewThroughConversionsFromLocationAssetClickToCall

number

عدد النقرات على زر الاتصال على أي مساحة عرض للموقع الجغرافي بعد مرة ظهور. يأتي هذا المقياس من الموقع الجغرافي المستنِد إلى مادة العرض.
viewThroughConversionsFromLocationAssetDirections

number

عدد النقرات على اتجاهات القيادة في أيّ موقع جغرافي يظهر بعد مرّة ظهور يأتي هذا المقياس من الموقع الجغرافي المستنِد إلى مادة العرض.
viewThroughConversionsFromLocationAssetMenu

number

عدد النقرات على رابط القائمة في أيّ عرض موقع جغرافي بعد مرّة ظهور يأتي هذا المقياس من الموقع الجغرافي المستنِد إلى مادة العرض.
viewThroughConversionsFromLocationAssetOrder

number

عدد النقرات على طلبات الشراء على مساحة عرض معيّنة بعد مرّة ظهور للإعلان يأتي هذا المقياس من موقع جغرافي مستند إلى مواد العرض.
viewThroughConversionsFromLocationAssetOtherEngagement

number

عدد الأنواع الأخرى من النقرات على الإجراءات المحلية على أيّ مساحة عرض موقع جغرافي بعد مرّة ظهور يأتي هذا المقياس من موقع جغرافي مستند إلى مواد العرض.
viewThroughConversionsFromLocationAssetStoreVisits

number

العدد المقدّر لزيارات المتجر بعد مرّة ظهور. يأتي هذا المقياس من الموقع الجغرافي المستنِد إلى مادة العرض.
viewThroughConversionsFromLocationAssetWebsite

number

عدد النقرات على عنوان URL للموقع الإلكتروني في أيّ عرض موقع جغرافي بعد مرّة ظهور يأتي هذا المقياس من الموقع الجغرافي المستنِد إلى مادة العرض.
orders

number

تشير "الطلبات" إلى إجمالي عدد إحالاتك الناجحة المتمثّلة بعملية شراء، والتي يعود مصدرها إلى إعلاناتك. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. ويتم احتساب الإحالة الناجحة كطلب، إذا كان مصدرها يعود إلى التفاعلات السابقة مع إعلاناتك (النقرات على الإعلانات النصية أو إعلانات Shopping، ومرات مشاهدة إعلانات الفيديو، وما إلى ذلك). مثال: نقر شخص ما على إعلان Shopping يعرض قبّعة، ثم اشترى هذا الشخص القبّعة نفسها مع قميص من خلال طلب على موقعك الإلكتروني. مع أنّه اشترى منتجَين، سيتم احتساب هذه الإحالة الناجحة كطلب واحد. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.
averageOrderValueMicros

string (int64 format)

متوسّط قيمة طلب الشراء هو متوسّط الإيرادات التي حقّقتها لكلّ طلب منسوب إلى إعلاناتك. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. متوسّط قيمة طلب الشراء هو إجمالي الإيرادات من طلباتك مقسومًا على إجمالي عدد الطلبات. مثال: تلقّيت 3 طلبات حقّقت إيرادات بقيمة 10 دولار أمريكي و15 دولار أمريكي و20 دولار أمريكي. متوسّط قيمة طلب الشراء هو 15 دولارًا أمريكيًا = (10 دولارات أمريكية + 15 دولارًا أمريكيًا + 20 دولارًا أمريكيًا)/3. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.
averageCartSize

number

متوسّط حجم سلّة التسوّق هو متوسّط عدد المنتجات في كلّ طلب منسوب إلى إعلاناتك. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. متوسّط حجم سلّة التسوّق هو إجمالي عدد المنتجات المُباعة مقسومًا على إجمالي عدد الطلبات التي تلقّيتها. مثال: تلقّيت طلبَين، تضمّن الطلب الأوّل 3 منتجات والطلب الثاني منتجَين. يبلغ متوسّط حجم سلّة التسوّق 2.5 منتج = (3+2)/2. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.
costOfGoodsSoldMicros

string (int64 format)

تكلفة السلع المُباعة هي إجمالي تكلفة المنتجات التي بِعتها في الطلبات المنسوبة إلى إعلاناتك. طريقة العمل: يمكنك إضافة تكلفة السلع المُباعة إلى كلّ منتج في Merchant Center. وفي حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق، ستتمّ مطابقة المنتجات التي تم بيعها مع قيمة تكلفة السلع المُباعة، ومن ثمَّ يمكن احتساب الأرباح الإجمالية التي حقّقتها لكلّ طلب. على سبيل المثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة تكلفة السلع المُباعة للقميص 5 دولار أمريكي. تبلغ تكلفة السلع المُباعة لهذا الطلب 8 دولار أمريكي = 3 دولار أمريكي + 5 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.
grossProfitMicros

string (int64 format)

الأرباح الإجمالية هي الربح الذي تحقّقه من الطلبات المنسوبة إلى إعلاناتك بعد طرح تكلفة السلع المُباعة منه. آلية العمل: الأرباح الإجمالية هي الأرباح التي تحقّقها من المبيعات التي يعود مصدرها إلى إعلاناتك بعد طرح تكلفة السلع المُباعة منها. لا تتضمّن العمليات الحسابية للأرباح الإجمالية سوى المنتجات التي يكون لها قيمة تكلفة سلع مُباعة في Merchant Center. مثال: نقر شخص ما على إعلان Shopping يعرض قبّعة، ثم اشترى هذا الشخص القبّعة نفسها مع قميص من خلال طلب على موقعك الإلكتروني. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ قيمة تكلفة السلع المُباعة للقبّعة ‏$3، لكنّ القميص ليس له أيّ قيمة تكلفة للسلع المُباعة. ولن تأخذ الأرباح الإجمالية لهذا الطلب في الاعتبار سوى القبّعة، لذا سيكون المبلغ 7 دولار أمريكي = 10 دولار أمريكي - 3 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.
grossProfitMargin

number

هامش الربح الإجمالي هو النسبة المئوية لإجمالي الربح الذي حقّقته من الطلبات المنسوبة إلى إعلاناتك، بعد خصم تكلفة السلع المُباعة. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. هامش الربح الإجمالي هو إجمالي الأرباح التي حقّقتها بعد قسمته على إجمالي الإيرادات وضربه في %100. لا تتضمّن العمليات الحسابية لهوامش الربح الإجمالية سوى المنتجات التي يكون لها قيمة تكلفة سلع مُباعة في Merchant Center. مثال: اشترى شخص ما قبّعة وقميصًا من خلال طلب على موقعك الإلكتروني. يبلغ سعر القبّعة 10 دولار أمريكي، ولها قيمة تكلفة سلع مُباعة تبلغ 3 دولار أمريكي. ويبلغ سعر القميص 20 دولار أمريكي، ولكن ليس له قيمة تكلفة سلع مُباعة. لن يأخذ هامش الربح الإجمالي لهذا الطلب في الاعتبار سوى القبّعة لأنّ لها قيمة تكلفة سلع مُباعة، وبذلك تكون النسبة% 70 = (10 دولار أمريكي - 3 دولار أمريكي)/10 دولار أمريكي × %100. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.
revenueMicros

string (int64 format)

الأرباح هي إجمالي المبلغ الذي تكسبه من الطلبات التي يكون مصدرها إعلاناتك. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. الأرباح هي القيمة الإجمالية لجميع الطلبات التي تلقّيتها والتي يكون مصدرها إعلاناتك، بعد طرح أيّ خصم. مثال: نقر شخص ما على إعلان Shopping يعرض قبّعة، ثم اشترى هذا الشخص القبّعة نفسها مع قميص من خلال طلب على موقعك الإلكتروني. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. يتم تطبيق خصم بقيمة 5 دولار أمريكي على الطلب بكامله. تبلغ الأرباح من هذا الطلب 25 دولار أمريكي = 10 دولار أمريكي + 20 دولار أمريكي - 5 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.
unitsSold

number

الوحدات المُباعة هي إجمالي عدد المنتجات المُباعة من الطلبات التي يعود مصدرها إلى إعلاناتك. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. الوحدات المُباعة هي إجمالي عدد المنتجات المُباعة من جميع الطلبات التي يعود مصدرها إلى إعلاناتك. مثال: نقر شخص ما على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا وسُترة. الوحدات المُباعة في هذا الطلب هي 3. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.
crossSellCostOfGoodsSoldMicros

string (int64 format)

تكلفة السلع المُباعة من خلال بيع منتجات إضافية (COGS) هي إجمالي تكلفة المنتجات التي تم بيعها نتيجةً لإعلان عن منتج مختلف. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. وتكلفة السلع المُباعة من خلال بيع منتجات إضافية هي إجمالي تكلفة المنتجات التي تم بيعها بدون الإعلان عنها. مثال: نقر شخص ما على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة تكلفة السلع المُباعة للقميص 5 دولار أمريكي. تبلغ تكلفة السلع المُباعة من خلال بيع منتجات إضافية لهذا الطلب 5 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.
crossSellGrossProfitMicros

string (int64 format)

الأرباح الإجمالية من بيع منتجات إضافية هي الأرباح التي تحقّقها من المنتجات المُباعة نتيجة للإعلان عن منتج مختلف، بعد طرح تكلفة السلع المُباعة منها. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في عملية الشراء هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الأرباح الإجمالية من بيع منتجات إضافية هي الأرباح التي يتمّ تحقيقها من خلال بيع منتجات إضافية منسوبة إلى إعلاناتك بعد طرح تكلفة السلع المُباعة منها. مثال: نقر شخص ما على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القميص ‏$20، وله قيمة تكلفة سلع مُباعة تبلغ ‏$5. تبلغ الأرباح الإجمالية من بيع منتجات إضافية لهذا الطلب ‏$15 = ‏$20 - ‏$5. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.
crossSellRevenueMicros

string (int64 format)

الأرباح من بيع المنتجات الإضافية هي إجمالي المبلغ الذي تحقّقه من المنتجات المُباعة نتيجة للإعلان عن منتج آخر. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الأرباح من بيع المنتجات الإضافية هي القيمة الإجمالية التي حقّقتها من خلال بيع منتجات إضافية منسوبة إلى إعلاناتك. على سبيل المثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ الأرباح من بيع منتجات إضافية لهذا الطلب 20 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.
crossSellUnitsSold

number

الوحدات المُباعة من خلال بيع منتجات إضافية هي إجمالي عدد المنتجات التي يتمّ بيعها نتيجة الإعلان عن منتج آخر. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الوحدات المُباعة من خلال بيع منتجات إضافية هي إجمالي عدد المنتجات التي تمّ بيعها من خلال جميع الطلبات المنسوبة إلى إعلاناتك. على سبيل المثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا وسُترة. عدد الوحدات المُباعة من خلال بيع منتجات إضافية في هذا الطلب هو وحدتان. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.
leadCostOfGoodsSoldMicros

string (int64 format)

تكلفة السلع المُباعة للعملاء المحتملِين هي إجمالي تكلفة المنتجات المُباعة نتيجة للإعلان عن المنتج نفسه. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمُباعة، يتمّ احتساب تكلفة هذه السلع ضمن تكلفة السلع المُباعة للعملاء المحتملِين. على سبيل المثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة تكلفة السلع المُباعة للقميص 5 دولار أمريكي. تبلغ تكلفة السلع المُباعة للعملاء المحتملِين لهذا الطلب 3 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.
leadGrossProfitMicros

string (int64 format)

الأرباح الإجمالية من العملاء المحتملِين هي الأرباح التي تحقِقّها من المنتجات المُباعة نتيجة للإعلان عن المنتج نفسه، بعد طرح تكلفة السلع المُباعة منها. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت كلٌّ من المنتجات المعلَن عنها والمنتجات المُباعة، تكون الأرباح التي تحقّقها من هذه المبيعات بعد طرح تكلفة السلع المُباعة منها هي الأرباح الإجمالية من العملاء المحتملِين. مثال: نقر شخص ما على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ولها قيمة تكلفة سلع مُباعة تبلغ 3 دولار أمريكي. ستكون الأرباح الإجمالية من العملاء المحتملِين لهذا الطلب هي 7 دولار أمريكي = 10 دولار أمريكي - 3 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.
leadRevenueMicros

string (int64 format)

الأرباح من العملاء المحتملِين هي إجمالي المبلغ الذي حقّقته من منتجات تمّ بيعها نتيجة الإعلان عن المنتج نفسه. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمُباعة، يتمّ عرض القيمة الإجمالية التي حقّقتها من مبيعات هذه المنتجات ضمن الأرباح من العملاء المحتملِين. على سبيل المثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ الأرباح من العملاء المحتملِين لهذا الطلب 10 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.
leadUnitsSold

number

الوحدات المُباعة للعملاء المحتملِين هي إجمالي عدد المنتجات التي يتمّ بيعها نتيجة للإعلان عن المنتج نفسه. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمنتجات المُباعة، يظهر إجمالي عدد هذه المنتجات المُباعة ضمن "الوحدات المُباعة للعملاء المحتملِين". على سبيل المثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا وسُترة. الوحدات المُباعة للعملاء المحتملِين في هذا الطلب هي 1. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.
uniqueUsers

string (int64 format)

عدد المستخدمين الفريدين الذين شاهدوا إعلانك خلال الفترة الزمنية المطلوبة. لا يمكن تجميع هذا المقياس، ولا يمكن طلبه إلا لنطاقات زمنية تبلغ 92 يومًا أو أقل. يتوفّر هذا المقياس لأنواع الحملات التالية: "الحملات على الشبكة الإعلانية" و"حملات الفيديو" و"الحملات أثناء التصفّح" و"حملات التطبيقات".
averageImpressionFrequencyPerUser

number

متوسط عدد المرات التي شاهد فيها مستخدِم فريد إعلانك خلال الفترة الزمنية المطلوبة. لا يمكن تجميع هذا المقياس، ولا يمكن طلبه إلا لنطاقات زمنية تبلغ 92 يومًا أو أقل. يتوفّر هذا المقياس لأنواع الحملات التالية: "الحملات على الشبكة الإعلانية" و"حملات الفيديو" و"الحملات أثناء التصفّح" و"حملات التطبيقات".

InteractionEventType

يصف التعداد الأنواع المحتملة من التفاعلات المستحقة الدفع والمجانية.

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
CLICK انقر للانتقال إلى الموقع الإلكتروني. وفي معظم الحالات، يؤدي هذا التفاعل إلى الانتقال إلى موقع إلكتروني خارجي، وعادةً ما يكون الصفحة المقصودة للمعلِن. وهذا هو أيضًا InteractionEventType التلقائي لأحداث النقر.
ENGAGEMENT نية المستخدم الواضحة في التفاعل مع الإعلان المعروض
VIDEO_VIEW شاهد المستخدِم إعلان فيديو.
NONE InteractionEventType التلقائي لأحداث الإحالات الناجحة للإعلانات وتُستخدَم هذه السمة عندما لا يشير أحد صفوف الإحالات الناجحة للإعلانات إلى أنّه يجب "الترويج" للتفاعلات المجانية (على سبيل المثال، الإحالات الناجحة للإعلان) وتسجيلها كجزء من المقاييس الأساسية. هذه ببساطة إحالات ناجحة (إعلانية) أخرى.

SearchVolumeRange

نطاق حجم البحث يندرج حجم البحث الفعلي ضمن هذا النطاق.

تمثيل JSON 
{
  "min": string,
  "max": string
}
الحقول
min

string (int64 format)

الحدّ الأدنى لحجم البحث
max

string (int64 format)

الحدّ الأقصى لحجم البحث

الشرائح

حقول الشرائح فقط

تمثيل JSON 
{
  "adDestinationType": enum (AdDestinationType),
  "adNetworkType": enum (AdNetworkType),
  "budgetCampaignAssociationStatus": {
    object (BudgetCampaignAssociationStatus)
  },
  "clickType": enum (ClickType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionAttributionEventType": enum (ConversionAttributionEventType),
  "conversionLagBucket": enum (ConversionLagBucket),
  "conversionOrAdjustmentLagBucket": enum (ConversionOrAdjustmentLagBucket),
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "externalConversionSource": enum (ExternalConversionSource),
  "hotelCheckInDayOfWeek": enum (DayOfWeek),
  "hotelDateSelectionType": enum (HotelDateSelectionType),
  "hotelRateType": enum (HotelRateType),
  "hotelPriceBucket": enum (HotelPriceBucket),
  "keyword": {
    object (Keyword)
  },
  "monthOfYear": enum (MonthOfYear),
  "placeholderType": enum (PlaceholderType),
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "recommendationType": enum (RecommendationType),
  "searchEngineResultsPageType": enum (SearchEngineResultsPageType),
  "searchTermMatchType": enum (SearchTermMatchType),
  "slot": enum (Slot),
  "conversionValueRulePrimaryDimension": enum (ConversionValueRulePrimaryDimension),
  "skAdNetworkUserType": enum (SkAdNetworkUserType),
  "skAdNetworkAdEventType": enum (SkAdNetworkAdEventType),
  "skAdNetworkAttributionCredit": enum (SkAdNetworkAttributionCredit),
  "skAdNetworkCoarseConversionValue": enum (SkAdNetworkCoarseConversionValue),
  "skAdNetworkSourceType": enum (SkAdNetworkSourceType),
  "newVersusReturningCustomers": enum (ConvertingUserPriorEngagementTypeAndLtvBucket),
  "activityAccountId": string,
  "activityCity": string,
  "activityCountry": string,
  "activityRating": string,
  "activityState": string,
  "externalActivityId": string,
  "adGroup": string,
  "assetGroup": string,
  "auctionInsightDomain": string,
  "campaign": string,
  "conversionAction": string,
  "conversionActionName": string,
  "conversionAdjustment": boolean,
  "date": string,
  "geoTargetAirport": string,
  "geoTargetCanton": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetCounty": string,
  "geoTargetDistrict": string,
  "geoTargetMetro": string,
  "geoTargetMostSpecificLocation": string,
  "geoTargetPostalCode": string,
  "geoTargetProvince": string,
  "geoTargetRegion": string,
  "geoTargetState": string,
  "hotelBookingWindowDays": string,
  "hotelCenterId": string,
  "hotelCheckInDate": string,
  "hotelCity": string,
  "hotelClass": integer,
  "hotelCountry": string,
  "hotelLengthOfStay": integer,
  "hotelRateRuleId": string,
  "hotelState": string,
  "hour": integer,
  "interactionOnThisExtension": boolean,
  "month": string,
  "partnerHotelId": string,
  "productAggregatorId": string,
  "productCategoryLevel1": string,
  "productCategoryLevel2": string,
  "productCategoryLevel3": string,
  "productCategoryLevel4": string,
  "productCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productFeedLabel": string,
  "productItemId": string,
  "productLanguage": string,
  "productMerchantId": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "searchSubcategory": string,
  "searchTerm": string,
  "webpage": string,
  "week": string,
  "year": integer,
  "skAdNetworkConversionValue": string,
  "skAdNetworkSourceApp": {
    object (SkAdNetworkSourceApp)
  },
  "skAdNetworkSourceDomain": string,
  "skAdNetworkPostbackSequenceIndex": string,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
الحقول
adDestinationType

enum (AdDestinationType)

نوع وجهة الإعلان.
adNetworkType

enum (AdNetworkType)

نوع شبكة المواقع الإعلانية
budgetCampaignAssociationStatus

object (BudgetCampaignAssociationStatus)

حالة ربط الميزانية بالحملة
clickType

enum (ClickType)

نوع النقر.
conversionActionCategory

enum (ConversionActionCategory)

فئة إجراء الإحالة الناجحة.
conversionAttributionEventType

enum (ConversionAttributionEventType)

نوع حدث تحديد مصدر الإحالة الناجحة
conversionLagBucket

enum (ConversionLagBucket)

قيمة تعداد تمثّل عدد الأيام بين الظهور والإحالة الناجحة.
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)

السمة الأساسية لقواعد قيم الإحالات الناجحة المطبّقة. تعرِض السمة NO_RULE_APPLIED إجمالي قيمة الإحالات الناجحة المسجّلة التي لم تُطبَّق عليها قاعدة قيمة. تعرِض السمة ORIGINAL القيمة الأصلية للإحالات الناجحة التي تم تطبيق قاعدة قيمة عليها. Geo_LOCATION، DEVICE، AUDIENCE يعرض صافي التعديل بعد تطبيق قواعد القيمة.
skAdNetworkUserType

enum (SkAdNetworkUserType)

نوع مستخدم شبكة الإعلانات في iOS Store Kit
skAdNetworkAdEventType

enum (SkAdNetworkAdEventType)

نوع حدث الإعلان في شبكة المواقع الإعلانية في iOS Store Kit
skAdNetworkAttributionCredit

enum (SkAdNetworkAttributionCredit)

نسبة المساهمة في إحالة شبكة الإعلانات في iOS Store Kit
skAdNetworkCoarseConversionValue

enum (SkAdNetworkCoarseConversionValue)

قيمة الإحالة الناجحة التقريبية لشبكة إعلانات iOS StoreK
skAdNetworkSourceType

enum (SkAdNetworkSourceType)

نوع المصدر الذي تمّ عرض الإعلان الذي أدّى إلى تثبيت شبكة إعلانات iOS StoreKit عليه. وتعني القيمة الفارغة أنّ هذه الشريحة غير سارية، على سبيل المثال، الحملة التي لا تعمل على نظام التشغيل 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

يؤدّي ذلك إلى تقسيم أعمدة الإحالات الناجحة حسب الإحالة الناجحة الأصلية وقيمة الإحالة الناجحة مقارنةً بالفرق في حال تم تعديل الإحالات الناجحة. يحتوي الصفّ "غير صحيح" على البيانات كما وردت في الأصل، في حين يحتوي الصفّ "صحيح" على الفرق بين البيانات الآن والبيانات كما وردت في الأصل. يؤدّي جمع الاثنين معًا إلى ظهور بيانات ما بعد التعديل.
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)

رقم تعريف مركز إدارة معلومات الفنادق.
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)

معرّف التاجر للمنتج
productStoreId

string

معرّف المتجر للمنتج
productTitle

string

عنوان المنتج.
productTypeL1

string

نوع (المستوى 1) للمنتج.
productTypeL2

string

نوع المنتج (المستوى 2)
productTypeL3

string

نوع (المستوى 3) للمنتج.
productTypeL4

string

نوع المنتج (المستوى 4)
productTypeL5

string

نوع (المستوى 5) للمنتج.
quarter

string

الربع كما يمثّله تاريخ اليوم الأول من الربع. يستخدم السنة التقويمية للربعات، على سبيل المثال، يبدأ الربع الثاني من عام 2018 في 01‏-04‏-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 وتعني القيمة الخالية أنّ هذه الشريحة غير قابلة للتطبيق، مثل حملة لا تعمل على نظام التشغيل iOS.
skAdNetworkSourceApp

object (SkAdNetworkSourceApp)

التطبيق الذي ظهر فيه الإعلان الذي أدّى إلى تثبيت شبكة إعلانات iOS Store Kit. تعني القيمة الخالية أن هذه الشريحة غير قابلة للتطبيق، مثل حملة لا تعمل على نظام التشغيل iOS، أو لم تكن موجودة في أي عمليات تسجيل إحالات ناجحة أرسلتها Apple.
skAdNetworkSourceDomain

string

الموقع الإلكتروني الذي ظهر فيه الإعلان الذي أدّى إلى تثبيت شبكة إعلانات iOS Store Kit. تعني القيمة الخالية أن هذه الشريحة غير قابلة للتطبيق، مثل حملة لا تعمل على نظام التشغيل iOS، أو لم تكن موجودة في أي عمليات تسجيل إحالات ناجحة أرسلتها Apple.
skAdNetworkPostbackSequenceIndex

string (int64 format)

فهرس تسلسل تسجيل الإحالات الناجحة في شبكة المواقع الإعلانية على iOS Store Kit
assetInteractionTarget

object (AssetInteractionTarget)

لا يتمّ استخدامها إلا مع مقاييس CustomerAsset وCampaignAsset وAdGroupAsset. يشير إلى ما إذا كانت مقاييس التفاعل قد حدثت على مادة العرض نفسها أو على مادة عرض أو وحدة إعلانية مختلفة. يتم احتساب التفاعلات (مثل النقرات) في جميع أجزاء الإعلان المعروض (مثل الإعلان نفسه والمكوّنات الأخرى، مثل روابط أقسام الموقع) عند عرضها معًا. عندما تكون معلمة InteractiveOnThisAsset صحيحة، هذا يعني أن التفاعلات تتم على مادة العرض المحددة هذه، وعندما تكون قيمةInteractOnThisAsset غير صحيحة، هذا يعني أن التفاعلات لا تتم في مادة العرض المحددة هذه ولكن في أجزاء أخرى من الإعلان المعروض الذي يتم عرض مادة العرض هذه معه.

AdDestinationType

تعداد أنواع الوجهات في "إعلانات Google"

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN القيمة غير معروفة في هذا الإصدار.
NOT_APPLICABLE الإعلانات التي لا تهدف إلى توجيه المستخدمين من الإعلانات إلى وجهات أخرى
WEBSITE الموقع الإلكتروني
APP_STORE App Store لنظام التشغيل iOS أو "متجر Play"
PHONE_CALL اتصال هاتفي
MAP_DIRECTIONS تطبيق "خرائط Google"
LOCATION_LISTING الصفحة المخصصة للموقع الجغرافي
MESSAGE رسالة نصية
LEAD_FORM نموذج إنشاء قوائم العملاء المحتملين
YOUTUBE YouTube
UNMODELED_FOR_CONVERSIONS وجهة الإعلان للإحالات الناجحة التي لا تتضمّن مفاتيح معروفة

AdNetworkType

يُدرِج أنواع شبكات "إعلانات Google".

عمليات التعداد
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

الحالات المحتمَلة للربط بين الميزانية والحملة

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
ENABLED تستخدِم الحملة الميزانية حاليًا.
REMOVED لم تعُد الحملة تستخدِم الميزانية.

ClickType

يُدرِج أنواع النقرات في "إعلانات Google".

عمليات التعداد
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 Shopping - المنتج - محلي.
PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL ‫Shopping - المنتج - محلي في قنوات متعددة
PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE Shopping - المنتج - قنوات متعددة على الإنترنت.
PRODUCT_LISTING_ADS_COUPON Shopping - المنتج - قسيمة.
PRODUCT_LISTING_AD_TRANSACTABLE Shopping - المنتج - بيع على Google.
PROMOTION_EXTENSION إضافة عروض ترويجية.
HOTEL_PRICE سعر الفندق
PRICE_EXTENSION معلومات السعر الإضافية.
HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION اختيار غرفة فندقية من الحجز على Google
SHOPPING_COMPARISON_LISTING Shopping - بيانات المقارنة.
CROSS_NETWORK على جميع الشبكات من "حملات الأداء الأفضل" و"الحملات أثناء التصفّح"

ConversionAttributionEventType

نوع حدث الإحالات الناجحة التي مصدرها.

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN يمثّل قيمة غير معروفة في هذا الإصدار.
IMPRESSION تُنسب الإحالة الناجحة إلى مرّة ظهور.
INTERACTION يتمّ تحديد مصدر الإحالة الناجحة على أنّه تفاعل.

ConversionLagBucket

عنصر مصنّف يمثّل عدد الأيام بين مرّة الظهور والإحالة الناجحة.

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لأغراض القيمة المعروضة فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
LESS_THAN_ONE_DAY مجموعة تأخُّر اكتمال الإحالة الناجحة من 0 إلى يوم واحد يشمل السعر 0 يوم، ولا يشمل اليوم يومًا واحدًا.
ONE_TO_TWO_DAYS حزمة تأخُّر اكتمال الإحالة الناجحة من يوم واحد إلى يومَين يتم تضمين يوم واحد، ولا يتم تضمين يومَين.
TWO_TO_THREE_DAYS مجموعة تأخُّر اكتمال الإحالة الناجحة من يومَين إلى 3 أيام يشمل السعر يومَين، ولا يشمل ذلك أيام 3 أيام.
THREE_TO_FOUR_DAYS حزمة تأخُّر الإحالة الناجحة من 3 إلى 4 أيام يتم تضمين 3 أيام، ولا يتم تضمين 4 أيام.
FOUR_TO_FIVE_DAYS مجموعة تأخُّر اكتمال الإحالة الناجحة من 4 إلى 5 أيام يشمل السعر 4 أيام، ولا يشمل 5 أيام.
FIVE_TO_SIX_DAYS مجموعة تأخُّر اكتمال الإحالة الناجحة من 5 إلى 6 أيام يتم تضمين 5 أيام، ولا يتم تضمين 6 أيام.
SIX_TO_SEVEN_DAYS مجموعة تأخُّر اكتمال الإحالة الناجحة من 6 إلى 7 أيام يشمل السعر 6 أيام، ولا يشمل الأيام 7 أيام.
SEVEN_TO_EIGHT_DAYS مجموعة تأخُّر اكتمال الإحالة الناجحة من 7 إلى 8 أيام يشمل السعر 7 أيام، في حين لا يشمل ذلك 8 أيام.
EIGHT_TO_NINE_DAYS مجموعة تأخُّر اكتمال الإحالة الناجحة من 8 إلى 9 أيام يتم تضمين 8 أيام، ولا يتم تضمين 9 أيام.
NINE_TO_TEN_DAYS حزمة تأخُّر الإحالة الناجحة من 9 إلى 10 أيام يتم تضمين 9 أيام، ولا يتم تضمين 10 أيام.
TEN_TO_ELEVEN_DAYS حزمة تأخُّر الإحالة الناجحة من 10 أيام إلى 11 يومًا يشمل السعر 10 أيام، في حين لا يشمل ذلك 11 يومًا.
ELEVEN_TO_TWELVE_DAYS مجموعة تأخُّر اكتمال الإحالة الناجحة من 11 إلى 12 يومًا يتم تضمين 11 يومًا، ولا يتم تضمين 12 يومًا.
TWELVE_TO_THIRTEEN_DAYS مجموعة تأخُّر اكتمال الإحالة الناجحة من 12 إلى 13 يومًا يشمل السعر 12 يومًا، في حين لا يشمل ذلك 13 يومًا.
THIRTEEN_TO_FOURTEEN_DAYS مجموعة تأخُّر اكتمال الإحالة الناجحة من 13 إلى 14 يومًا يشمل السعر 13 يومًا، في حين لا يشمل ذلك 14 يومًا.
FOURTEEN_TO_TWENTY_ONE_DAYS مجموعة تأخُّر اكتمال الإحالة الناجحة من 14 إلى 21 يومًا يشمل السعر 14 يومًا، في حين لا يشمل ذلك 21 يومًا.
TWENTY_ONE_TO_THIRTY_DAYS حزمة تأخُّر الإحالة الناجحة من 21 إلى 30 يومًا يشمل السعر 21 يومًا، في حين لا يشمل ذلك 30 يومًا.
THIRTY_TO_FORTY_FIVE_DAYS حزمة تأخُّر الإحالة الناجحة من 30 إلى 45 يومًا يشمل السعر 30 يومًا، في حين لا يشمل ذلك 45 يومًا.
FORTY_FIVE_TO_SIXTY_DAYS مجموعة تأخُّر اكتمال الإحالة الناجحة من 45 إلى 60 يومًا يتم تضمين 45 يومًا، ولا يتم تضمين 60 يومًا.
SIXTY_TO_NINETY_DAYS مجموعة تأخُّر اكتمال الإحالة الناجحة من 60 إلى 90 يومًا يتم تضمين 60 يومًا، ولا يتم تضمين 90 يومًا.

ConversionOrAdjustmentLagBucket

عنصر مصنّف يمثّل عدد الأيام بين مرّة الظهور والإحالة الناجحة أو بين مرّة الظهور والتعديلات التي تمّ إجراؤها على الإحالة الناجحة.

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لأغراض القيمة المعروضة فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
CONVERSION_LESS_THAN_ONE_DAY مجموعة تأخُّر اكتمال الإحالة الناجحة من 0 إلى يوم واحد يشمل السعر 0 يوم، ولا يشمل اليوم يومًا واحدًا.
CONVERSION_ONE_TO_TWO_DAYS حزمة تأخُّر اكتمال الإحالة الناجحة من يوم واحد إلى يومَين يتم تضمين يوم واحد، ولا يتم تضمين يومَين.
CONVERSION_TWO_TO_THREE_DAYS مجموعة تأخُّر اكتمال الإحالة الناجحة من يومَين إلى 3 أيام يشمل السعر يومَين، ولا يشمل ذلك أيام 3 أيام.
CONVERSION_THREE_TO_FOUR_DAYS حزمة تأخُّر الإحالة الناجحة من 3 إلى 4 أيام يتم تضمين 3 أيام، ولا يتم تضمين 4 أيام.
CONVERSION_FOUR_TO_FIVE_DAYS مجموعة تأخُّر اكتمال الإحالة الناجحة من 4 إلى 5 أيام يشمل السعر 4 أيام، ولا يشمل 5 أيام.
CONVERSION_FIVE_TO_SIX_DAYS مجموعة تأخُّر اكتمال الإحالة الناجحة من 5 إلى 6 أيام يتم تضمين 5 أيام، ولا يتم تضمين 6 أيام.
CONVERSION_SIX_TO_SEVEN_DAYS مجموعة تأخُّر اكتمال الإحالة الناجحة من 6 إلى 7 أيام يشمل السعر 6 أيام، ولا يشمل الأيام 7 أيام.
CONVERSION_SEVEN_TO_EIGHT_DAYS مجموعة تأخُّر اكتمال الإحالة الناجحة من 7 إلى 8 أيام يشمل السعر 7 أيام، في حين لا يشمل ذلك 8 أيام.
CONVERSION_EIGHT_TO_NINE_DAYS مجموعة تأخُّر اكتمال الإحالة الناجحة من 8 إلى 9 أيام يتم تضمين 8 أيام، ولا يتم تضمين 9 أيام.
CONVERSION_NINE_TO_TEN_DAYS حزمة تأخُّر الإحالة الناجحة من 9 إلى 10 أيام يتم تضمين 9 أيام، ولا يتم تضمين 10 أيام.
CONVERSION_TEN_TO_ELEVEN_DAYS حزمة تأخُّر الإحالة الناجحة من 10 أيام إلى 11 يومًا يشمل السعر 10 أيام، في حين لا يشمل ذلك 11 يومًا.
CONVERSION_ELEVEN_TO_TWELVE_DAYS مجموعة تأخُّر اكتمال الإحالة الناجحة من 11 إلى 12 يومًا يتم تضمين 11 يومًا، ولا يتم تضمين 12 يومًا.
CONVERSION_TWELVE_TO_THIRTEEN_DAYS مجموعة تأخُّر اكتمال الإحالة الناجحة من 12 إلى 13 يومًا يشمل السعر 12 يومًا، في حين لا يشمل ذلك 13 يومًا.
CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS مجموعة تأخُّر اكتمال الإحالة الناجحة من 13 إلى 14 يومًا يشمل السعر 13 يومًا، في حين لا يشمل ذلك 14 يومًا.
CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS مجموعة تأخُّر اكتمال الإحالة الناجحة من 14 إلى 21 يومًا يشمل السعر 14 يومًا، في حين لا يشمل ذلك 21 يومًا.
CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS حزمة تأخُّر الإحالة الناجحة من 21 إلى 30 يومًا يشمل السعر 21 يومًا، في حين لا يشمل ذلك 30 يومًا.
CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS حزمة تأخُّر الإحالة الناجحة من 30 إلى 45 يومًا يشمل السعر 30 يومًا، في حين لا يشمل ذلك 45 يومًا.
CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS مجموعة تأخُّر اكتمال الإحالة الناجحة من 45 إلى 60 يومًا يتم تضمين 45 يومًا، ولا يتم تضمين 60 يومًا.
CONVERSION_SIXTY_TO_NINETY_DAYS حزمة تأخُّر الإحالة الناجحة من 60 إلى 90 يومًا يشمل السعر 60 يومًا، في حين لا يشمل ذلك 90 يومًا.
ADJUSTMENT_LESS_THAN_ONE_DAY مجموعة تأخُّر تعديل الإحالة الناجحة من 0 إلى يوم واحد يتم تضمين 0 يوم، ولا يتم تضمين يوم واحد.
ADJUSTMENT_ONE_TO_TWO_DAYS مجموعة تأخُّر تعديل الإحالات الناجحة من يوم إلى يومَين يشمل السعر يومًا واحدًا، ولا يشمل ذلك يومين.
ADJUSTMENT_TWO_TO_THREE_DAYS مجموعة تأخُّر تعديل الإحالة الناجحة من يومَين إلى 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 حزمة تأخُّر الإحالة الناجحة غير معروفة. يُرجى العِلم أنّ هذه البيانات تخصّ التواريخ التي سبقت توفّر مجموعة تأخّر الإحالات الناجحة في "إعلانات Google".
ADJUSTMENT_UNKNOWN مجموعة تأخُّر تسوية الإحالة الناجحة غير معروفة. يعود ذلك إلى التواريخ التي تسبق توفّر حزمة تأخُّر تعديل الإحالة الناجحة في "إعلانات Google".

ExternalConversionSource

مصدر الإحالة الناجحة الخارجي المرتبط بإجراء الإحالة الناجحة.

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
WEBPAGE الإحالة الناجحة التي تحدث عندما ينتقل المستخدِم إلى صفحة ويب معيّنة بعد مشاهدة إعلان، ويتم عرضها في واجهة مستخدِم "إعلانات Google" على أنّها "الموقع الإلكتروني".
ANALYTICS الإحالة الناجحة التي تأتي من هدف أو معاملة مرتبطَين في "إحصاءات Google"، ويتم عرضها في واجهة مستخدِم "إعلانات Google" باسم "إحصاءات Google".
UPLOAD إحالة ناجحة لموقع إلكتروني يتم تحميلها من خلال ConversionUploadService، ويتم عرضها في واجهة مستخدِم "إعلانات Google" باسم "الاستيراد من النقرات".
AD_CALL_METRICS الإحالة الناجحة التي تحدث عندما ينقر المستخدم على إضافة مكالمة مباشرةً في أحد الإعلانات، ويتم عرضها في واجهة مستخدم "إعلانات Google" على أنّها "مكالمات من الإعلانات".
WEBSITE_CALL_METRICS إحالة ناجحة تحدث عندما يتصل المستخدم برقم هاتف تم إنشاؤه ديناميكيًا (عن طريق تثبيت JavaScript) من الموقع الإلكتروني لأحد المعلنين بعد النقر على أحد الإعلانات، ويتم عرضه في واجهة مستخدم "إعلانات Google" على أنه "مكالمات من الموقع الإلكتروني".
STORE_VISITS الإحالة الناجحة التي تحدث عندما يزور أحد المستخدِمين متجر البيع بالتجزئة الخاص بالمعلِن بعد النقر على إعلان على Google، ويتم عرضها في واجهة مستخدِم "إعلانات Google" باسم "زيارات المتجر".
ANDROID_IN_APP الإحالة الناجحة التي تحدث عندما يتّخذ المستخدِم إجراءً داخل التطبيق، مثل إجراء عملية شراء في تطبيق Android، ويتم عرضها في واجهة مستخدِم "إعلانات Google" باسم "إجراء داخل تطبيق Android".
IOS_IN_APP الإحالة الناجحة التي تحدث عندما يتّخذ المستخدِم إجراءً داخل التطبيق، مثل عملية شراء في تطبيق iOS، ويظهر في واجهة مستخدم "إعلانات Google" على أنّه "إجراء داخل تطبيق iOS".
IOS_FIRST_OPEN الإحالة الناجحة التي تحدث عندما يفتح المستخدِم تطبيق iOS لأول مرّة، ويتم عرضها في واجهة مستخدِم "إعلانات Google" على أنّها "تثبيت تطبيق iOS (التشغيل لأول مرّة)".
APP_UNSPECIFIED الإحالات الناجحة للتطبيقات القديمة التي لم يتمّ توفير منصّة تطبيق لها، ويتمّ عرضها في واجهة مستخدِم "إعلانات Google" على أنّها "تطبيق للأجهزة الجوّالة".
ANDROID_FIRST_OPEN الإحالة الناجحة التي تحدث عندما يفتح المستخدِم تطبيق Android للمرّة الأولى، ويتم عرضها في واجهة مستخدِم "إعلانات Google" على أنّها "تثبيت تطبيق Android (التشغيل الأوّل)".
UPLOAD_CALLS الإحالة الناجحة عبر الاتصال الهاتفي التي يتم تحميلها من خلال ConversionUploadService، ويتم عرضها في واجهة مستخدِم "إعلانات Google" باسم "الاستيراد من المكالمات".
FIREBASE الإحالة الناجحة التي تأتي من حدث Firebase مرتبط، ويتم عرضها في واجهة مستخدم "إعلانات Google" باسم "Firebase".
CLICK_TO_CALL الإحالة الناجحة التي تحدث عندما ينقر المستخدم على رقم هاتف جوّال، ويتم عرضه في واجهة مستخدم "إعلانات Google" على أنّه "نقرات على رقم الهاتف".
SALESFORCE الإحالة الناجحة الواردة من Salesforce، ويتم عرضها في واجهة مستخدِم "إعلانات Google" باسم "Salesforce.com".
STORE_SALES_CRM الإحالة الناجحة الناتجة عن عمليات الشراء داخل المتجر التي سجّلها نظام إدارة علاقات العملاء، ويتم عرضها في واجهة مستخدم "إعلانات Google" باسم "المبيعات في المتاجر (شريك البيانات)".
STORE_SALES_PAYMENT_NETWORK الإحالة الناجحة الناتجة عن عمليات شراء داخل المتجر من شبكة الدفع، ويتم عرضها في واجهة مستخدِم "إعلانات Google" باسم "مبيعات المتجر (شبكة الدفع)".
GOOGLE_PLAY إحالة ناجحة في Google Play بلا رموز، ويظهر في واجهة مستخدم "إعلانات Google" باسم "Google Play".
THIRD_PARTY_APP_ANALYTICS الإحالة الناجحة التي تأتي من حدث مرتبط لإحصاءات تطبيقات تابعة لجهة خارجية، ويتم عرضها في واجهة مستخدِم "إعلانات Google" باسم "إحصاءات التطبيقات التابعة لجهات خارجية".
GOOGLE_ATTRIBUTION الإحالة الناجحة التي تتحكّم فيها ميزة "تحديد المصدر من Google"
STORE_SALES_DIRECT_UPLOAD الإحالة الناجحة للمبيعات في المتاجر استنادًا إلى عمليات تحميل بيانات التاجر الخاصة بالطرف الأول أو التابع لجهة خارجية. يظهر في واجهة مستخدم "إعلانات Google" باسم "المبيعات في المتاجر (تحميل مباشر)".
STORE_SALES الإحالة الناجحة للمبيعات في المتاجر استنادًا إلى عمليات تحميل بيانات التاجر الخاصة بالطرف الأول أو التابع لطرف ثالث و/أو من عمليات الشراء في المتاجر باستخدام بطاقات من شبكات الدفع. يظهر في واجهة مستخدم "إعلانات Google" على أنّه "المبيعات في المتاجر".
SEARCH_ADS_360 الإحالات الناجحة التي تم استيرادها من بيانات Floodlight في "إعلانات شبكة البحث 360"
GOOGLE_HOSTED الإحالات الناجحة التي تتتبّع الإجراءات المحلية من منتجات Google وخدماتها بعد التفاعل مع إعلان
FLOODLIGHT الإحالات الناجحة التي تسجّلها علامات Floodlight
ANALYTICS_SEARCH_ADS_360 الإحالات الناجحة التي تأتي من "إحصاءات Google" خصيصًا لخدمة "إعلانات شبكة البحث 360" يظهر في واجهة مستخدم "إعلانات Google" باسم "إحصاءات Google" (SA360).
FIREBASE_SEARCH_ADS_360 الإحالة الناجحة التي تأتي من حدث Firebase مرتبط بخدمة "إعلانات شبكة البحث 360".
DISPLAY_AND_VIDEO_360_FLOODLIGHT الإحالة الناجحة التي يتم الإبلاغ عنها من خلال Floodlight في "مساحة العرض والفيديو 360"

HotelRateType

قائمة أرقام تصف أنواع الأسعار المحتملة للفنادق

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN القيمة غير معروفة في هذا الإصدار.
UNAVAILABLE لا تتوفّر معلومات حول نوع السعر.
PUBLIC_RATE الأسعار متاحة للجميع.
QUALIFIED_RATE يتوفر سعر في برنامج العضوية يستوفي متطلبات أساسية، مثل توفير سعر علني. ستتم إزالة السعر العلني في واجهة المستخدم للإشارة إلى توفّر خصم للمستخدم. لمزيد من المعلومات عن الأسعار المؤهَّلة، يُرجى الانتقال إلى https://developers.google.com/hotels/hotel-ads/dev-guide/qualified-rates.
PRIVATE_RATE الأسعار المتاحة للمستخدمين الذين يستوفون بعض معايير الأهلية، على سبيل المثال، جميع المستخدمين الذين سجّلوا الدخول، و20% من مستخدمي الأجهزة الجوّالة، وجميع مستخدمي الأجهزة الجوّالة في كندا، إلخ.

HotelPriceBucket

يصف التعداد مجموعات أسعار الفنادق المحتملة.

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN القيمة غير معروفة في هذا الإصدار.
LOWEST_UNIQUE سعر لا مثيل له. يقدّم الشريك السعر الأدنى، ولا يوجد شركاء آخرون ضمن نطاق صغير بهذا السعر.
LOWEST_TIED مُطابَق مع أدنى سعر. يتوفر الشريك بنطاق صغير من السعر الأدنى.
NOT_LOWEST ليس السعر الأدنى. الشريك ليس ضمن نطاق صغير من السعر الأدنى.
ONLY_PARTNER_SHOWN وكان الشريك هو الشريك الوحيد الذي يظهر.

الكلمة الرئيسية

شريحة معيار الكلمة الرئيسية

تمثيل JSON 
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
الحقول
info

object (KeywordInfo)

معلومات الكلمة الرئيسية.
adGroupCriterion

string

اسم مورد AdGroupCriterion.

SearchEngineResultsPageType

تمثّل هذه السمة نوع صفحة نتائج محرك البحث.

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
ADS_ONLY كانت صفحة نتائج محرّك البحث تتضمّن إعلانات فقط.
ORGANIC_ONLY ولم يتم تضمين سوى النتائج الأساسية في صفحة نتائج محرك البحث.
ADS_AND_ORGANIC وكان يتم تضمين كلّ من الإعلانات والنتائج المجانية في صفحة نتائج محرك البحث.

SearchTermMatchType

أنواع المطابقة المحتملة لكلمة رئيسية تؤدي إلى ظهور إعلان، بما في ذلك الصيغ المختلفة.

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لأغراض القيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
BROAD المطابقة التقريبية.
EXACT مطابقة تامة.
PHRASE مطابقة العبارة
NEAR_EXACT مطابقة تامة (صيغة قريبة)
NEAR_PHRASE مطابقة العبارة (صيغة قريبة)

الحيز

لتعداد المواضع المحتملة للإعلان.

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN القيمة غير معروفة في هذا الإصدار.
SEARCH_SIDE بحث Google: جانب الصفحة
SEARCH_TOP بحث Google: أعلى الصفحة
SEARCH_OTHER بحث Google: أخرى
CONTENT "شبكة Google الإعلانية"
SEARCH_PARTNER_TOP شركاء البحث: الجزء العلوي
SEARCH_PARTNER_OTHER شركاء البحث: غير ذلك
MIXED على جميع الشبكات

ConversionValueRulePrimaryDimension

لتحديد السمة الأساسية لإحصاءات قواعد قيمة الإحالة الناجحة

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
NO_RULE_APPLIED بالنسبة إلى الإحالات الناجحة التي لا يتم تطبيق قواعد عليها بأي قيمة بعد تفعيل قاعدة القيمة.
ORIGINAL في ما يلي الإحالات الناجحة التي تم تطبيق قاعدة قيمة عليها: الإحصاءات الأصلية.
NEW_VS_RETURNING_USER عند استيفاء شرط عميل جديد أو عميل متكرر
GEO_LOCATION عند استيفاء شرط الموقع الجغرافي في وقت طلب البحث
DEVICE عند استيفاء شرط جهاز التصفح في وقت طلب البحث
AUDIENCE عند استيفاء شرط جمهور وقت الطلب
MULTIPLE عند تطبيق قواعد متعددة

SkAdNetworkUserType

يُدرِج أنواع مستخدمي SKAdNetwork

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN القيمة غير معروفة في هذا الإصدار.
UNAVAILABLE لم تكن القيمة معروضة في عملية تسجيل الإحالات الناجحة أو لا تتوفّر لدينا هذه البيانات لأسباب أخرى.
NEW_INSTALLER ثبَّت المستخدم التطبيق لأول مرة.
REINSTALLER ثبَّت المستخدم التطبيق من قبل.

SkAdNetworkAdEventType

يُدرِج أنواع أحداث الإعلانات على SKAdNetwork

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN القيمة غير معروفة في هذا الإصدار.
UNAVAILABLE لم تكن القيمة معروضة في عملية تسجيل الإحالات الناجحة أو لا تتوفّر لدينا هذه البيانات لأسباب أخرى.
INTERACTION تفاعل المستخدِم مع الإعلان.
VIEW شاهَد المستخدِم الإعلان.

SkAdNetworkSourceApp

شريحة SkAdNetworkSourceApp

تمثيل JSON 
{
  "skAdNetworkSourceAppId": string
}
الحقول
skAdNetworkSourceAppId

string

رقم تعريف التطبيق حيث تم عرض الإعلان الذي أدّى إلى تثبيت شبكة إعلانات iOS Store Kit.

SkAdNetworkAttributionCredit

لتعداد نِسب المساهمة في تحديد المصدر في SkAdNetwork

عمليات التعداد
UNSPECIFIED القيمة التلقائية. هذه القيمة مكافئة للقيمة null.
UNKNOWN القيمة غير معروفة في هذا الإصدار من واجهة برمجة التطبيقات. لا يمكن عرض قيمة التعداد الحقيقية في إصدار واجهة برمجة التطبيقات هذا أو أنّها غير متاحة حتى الآن.
UNAVAILABLE لم تكن القيمة متوفّرة في عملية تسجيل الإحالات الناجحة أو لا تتوفّر لدينا هذه البيانات لأسباب أخرى.
WON كانت Google هي شبكة الإعلانات التي حصلت على عملية تحديد مصدر الإعلان.
CONTRIBUTED كان محرّك بحث Google مؤهّلاً لتحديد المصدر، ولكنّه لم يحصل على النتيجة.

SkAdNetworkSourceType

يُدرِج أنواع مصادر SKAdNetwork

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN القيمة غير معروفة في هذا الإصدار.
UNAVAILABLE لم يكن رقم تعريف التطبيق المصدر أو نطاق المصدر متوفّرًا في عملية تسجيل الإحالات الناجحة أو لا تتوفّر لدينا هذه البيانات لأسباب أخرى.
WEBSITE تم عرض الإعلان على صفحة ويب.
MOBILE_APPLICATION تم عرض الإعلان على تطبيق.

AssetInteractionTarget

شريحة AssetInteractionTarget

تمثيل JSON 
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
الحقول
asset

string

اسم مورد مادة العرض
interactionOnThisAsset

boolean

تُستخدَم فقط مع مقاييس CustomerAsset وCampaignAsset وAdGroupAsset. يشير هذا المقياس إلى ما إذا كانت مقاييس التفاعل قد تم تسجيلها في مادة العرض نفسها أو في مادة عرض أو وحدة إعلانية مختلفة.

ConvertingUserPriorEngagementTypeAndLtvBucket

يُدرِج أنواع التفاعل السابقة للمستخدمين الذين أجروا إحالات ناجحة وحزمة القيمة الدائمة.

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN القيمة غير معروفة في هذا الإصدار.
NEW المستخدِم الذي أجرى إحالة ناجحة جديد للمعلِن.
RETURNING يعود المستخدِم الذي أجرى إحالة ناجحة إلى المعلِن. يختلف تعريف تكرار الزيارة بين أنواع الإحالات الناجحة، مثل زيارة ثانية للمتجر مقابل عملية شراء ثانية على الإنترنت.
NEW_AND_HIGH_LTV يكون المستخدِم الذي أجرى إحالة ناجحة جديدًا بالنسبة إلى المعلِن ويتميّز بقيمة دائمة عالية.