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)
  },
  "assetGroup": {
    object (AssetGroup)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "assetSetTypeView": {
    object (AssetSetTypeView)
  },
  "batchJob": {
    object (BatchJob)
  },
  "biddingDataExclusion": {
    object (BiddingDataExclusion)
  },
  "biddingSeasonalityAdjustment": {
    object (BiddingSeasonalityAdjustment)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "biddingStrategySimulation": {
    object (BiddingStrategySimulation)
  },
  "billingSetup": {
    object (BillingSetup)
  },
  "callView": {
    object (CallView)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignBidModifier": {
    object (CampaignBidModifier)
  },
  "campaignConversionGoal": {
    object (CampaignConversionGoal)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignCustomizer": {
    object (CampaignCustomizer)
  },
  "campaignDraft": {
    object (CampaignDraft)
  },
  "campaignExtensionSetting": {
    object (CampaignExtensionSetting)
  },
  "campaignFeed": {
    object (CampaignFeed)
  },
  "campaignGroup": {
    object (CampaignGroup)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "campaignSearchTermInsight": {
    object (CampaignSearchTermInsight)
  },
  "campaignSharedSet": {
    object (CampaignSharedSet)
  },
  "campaignSimulation": {
    object (CampaignSimulation)
  },
  "carrierConstant": {
    object (CarrierConstant)
  },
  "changeEvent": {
    object (ChangeEvent)
  },
  "changeStatus": {
    object (ChangeStatus)
  },
  "combinedAudience": {
    object (CombinedAudience)
  },
  "audience": {
    object (Audience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "conversionGoalCampaignConfig": {
    object (ConversionGoalCampaignConfig)
  },
  "conversionValueRule": {
    object (ConversionValueRule)
  },
  "conversionValueRuleSet": {
    object (ConversionValueRuleSet)
  },
  "clickView": {
    object (ClickView)
  },
  "currencyConstant": {
    object (CurrencyConstant)
  },
  "customAudience": {
    object (CustomAudience)
  },
  "customConversionGoal": {
    object (CustomConversionGoal)
  },
  "customInterest": {
    object (CustomInterest)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerAssetSet": {
    object (CustomerAssetSet)
  },
  "accessibleBiddingStrategy": {
    object (AccessibleBiddingStrategy)
  },
  "customerCustomizer": {
    object (CustomerCustomizer)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClientLink": {
    object (CustomerClientLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "customerConversionGoal": {
    object (CustomerConversionGoal)
  },
  "customerExtensionSetting": {
    object (CustomerExtensionSetting)
  },
  "customerFeed": {
    object (CustomerFeed)
  },
  "customerLabel": {
    object (CustomerLabel)
  },
  "customerNegativeCriterion": {
    object (CustomerNegativeCriterion)
  },
  "customerSearchTermInsight": {
    object (CustomerSearchTermInsight)
  },
  "customerUserAccess": {
    object (CustomerUserAccess)
  },
  "customerUserAccessInvitation": {
    object (CustomerUserAccessInvitation)
  },
  "customizerAttribute": {
    object (CustomizerAttribute)
  },
  "detailPlacementView": {
    object (DetailPlacementView)
  },
  "detailedDemographic": {
    object (DetailedDemographic)
  },
  "displayKeywordView": {
    object (DisplayKeywordView)
  },
  "distanceView": {
    object (DistanceView)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "expandedLandingPageView": {
    object (ExpandedLandingPageView)
  },
  "extensionFeedItem": {
    object (ExtensionFeedItem)
  },
  "feed": {
    object (Feed)
  },
  "feedItem": {
    object (FeedItem)
  },
  "feedItemSet": {
    object (FeedItemSet)
  },
  "feedItemSetLink": {
    object (FeedItemSetLink)
  },
  "feedItemTarget": {
    object (FeedItemTarget)
  },
  "feedMapping": {
    object (FeedMapping)
  },
  "feedPlaceholderView": {
    object (FeedPlaceholderView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "geographicView": {
    object (GeographicView)
  },
  "groupPlacementView": {
    object (GroupPlacementView)
  },
  "hotelGroupView": {
    object (HotelGroupView)
  },
  "hotelPerformanceView": {
    object (HotelPerformanceView)
  },
  "hotelReconciliation": {
    object (HotelReconciliation)
  },
  "incomeRangeView": {
    object (IncomeRangeView)
  },
  "keywordView": {
    object (KeywordView)
  },
  "keywordPlan": {
    object (KeywordPlan)
  },
  "keywordPlanCampaign": {
    object (KeywordPlanCampaign)
  },
  "keywordPlanCampaignKeyword": {
    object (KeywordPlanCampaignKeyword)
  },
  "keywordPlanAdGroup": {
    object (KeywordPlanAdGroup)
  },
  "keywordPlanAdGroupKeyword": {
    object (KeywordPlanAdGroupKeyword)
  },
  "keywordThemeConstant": {
    object (KeywordThemeConstant)
  },
  "label": {
    object (Label)
  },
  "landingPageView": {
    object (LandingPageView)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "managedPlacementView": {
    object (ManagedPlacementView)
  },
  "mediaFile": {
    object (MediaFile)
  },
  "mobileAppCategoryConstant": {
    object (MobileAppCategoryConstant)
  },
  "mobileDeviceConstant": {
    object (MobileDeviceConstant)
  },
  "offlineUserDataJob": {
    object (OfflineUserDataJob)
  },
  "operatingSystemVersionConstant": {
    object (OperatingSystemVersionConstant)
  },
  "paidOrganicSearchTermView": {
    object (PaidOrganicSearchTermView)
  },
  "qualifyingQuestion": {
    object (QualifyingQuestion)
  },
  "parentalStatusView": {
    object (ParentalStatusView)
  },
  "perStoreView": {
    object (PerStoreView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "productLink": {
    object (ProductLink)
  },
  "recommendation": {
    object (Recommendation)
  },
  "searchTermView": {
    object (SearchTermView)
  },
  "sharedCriterion": {
    object (SharedCriterion)
  },
  "sharedSet": {
    object (SharedSet)
  },
  "smartCampaignSetting": {
    object (SmartCampaignSetting)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "smartCampaignSearchTermView": {
    object (SmartCampaignSearchTermView)
  },
  "thirdPartyAppAnalyticsLink": {
    object (ThirdPartyAppAnalyticsLink)
  },
  "topicView": {
    object (TopicView)
  },
  "travelActivityGroupView": {
    object (TravelActivityGroupView)
  },
  "travelActivityPerformanceView": {
    object (TravelActivityPerformanceView)
  },
  "experiment": {
    object (Experiment)
  },
  "experimentArm": {
    object (ExperimentArm)
  },
  "userInterest": {
    object (UserInterest)
  },
  "lifeEvent": {
    object (LifeEvent)
  },
  "userList": {
    object (UserList)
  },
  "userLocationView": {
    object (UserLocationView)
  },
  "remarketingAction": {
    object (RemarketingAction)
  },
  "topicConstant": {
    object (TopicConstant)
  },
  "video": {
    object (Video)
  },
  "webpageView": {
    object (WebpageView)
  },
  "leadFormSubmissionData": {
    object (LeadFormSubmissionData)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  }
}
الحقول
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)

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

تصنيف الحملة المشار إليه في طلب البحث.
campaignSearchTermInsight

object (CampaignSearchTermInsight)

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

object (CampaignSharedSet)

العنصر المشترك للحملة المُشار إليه في طلب بحث AWQL
campaignSimulation

object (CampaignSimulation)

محاكاة الحملة المُشار إليها في طلب البحث.
carrierConstant

object (CarrierConstant)

ثابت مشغّل شبكة الجوّال المُشار إليه في طلب البحث.
changeEvent

object (ChangeEvent)

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

object (ChangeStatus)

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

object (CombinedAudience)

الجمهور المُجمَّع المشار إليه في طلب البحث.
audience

object (Audience)

الجمهور المشار إليه في طلب البحث.
conversionAction

object (ConversionAction)

إجراء الإحالة الناجحة المشار إليه في طلب البحث.
conversionCustomVariable

object (ConversionCustomVariable)

المتغيّر المخصَّص للإحالة الناجحة المشار إليه في طلب البحث.
conversionGoalCampaignConfig

object (ConversionGoalCampaignConfig)

قيمة ConversionGoalCampaignConfig المشار إليها في طلب البحث.
conversionValueRule

object (ConversionValueRule)

قاعدة قيمة الإحالة الناجحة المشار إليها في طلب البحث.
conversionValueRuleSet

object (ConversionValueRuleSet)

مجموعة قواعد قيمة الإحالة الناجحة المُشار إليها في طلب البحث.
clickView

object (ClickView)

ClickView المشار إليها في طلب البحث.
currencyConstant

object (CurrencyConstant)

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

object (CustomAudience)

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

object (CustomConversionGoal)

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

هدف Customerالإحالات الناجحة المشار إليه في طلب البحث.
customerExtensionSetting

object (CustomerExtensionSetting)

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

object (CustomerFeed)

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

object (CustomerLabel)

تصنيف العميل المشار إليه في طلب البحث.
customerNegativeCriterion

object (CustomerNegativeCriterion)

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

object (CustomerSearchTermInsight)

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

object (CustomerUserAccess)

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

object (CustomerUserAccessInvitation)

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

ملف الوسائط المشار إليه في طلب البحث.
mobileAppCategoryConstant

object (MobileAppCategoryConstant)

الثابت لفئة تطبيقات الأجهزة الجوّالة المشار إليها في طلب البحث.
mobileDeviceConstant

object (MobileDeviceConstant)

الثابت الخاص بالجهاز الجوّال المُشار إليه في طلب البحث.
offlineUserDataJob

object (OfflineUserDataJob)

تمثّل هذه السمة مهمة بيانات المستخدمين بلا اتصال بالإنترنت المُشار إليها في طلب البحث.
operatingSystemVersionConstant

object (OperatingSystemVersionConstant)

يشير إلى ثابت إصدار نظام التشغيل المُشار إليه في طلب البحث.
paidOrganicSearchTermView

object (PaidOrganicSearchTermView)

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

object (QualifyingQuestion)

السؤال المؤهِّل المُشار إليه في طلب البحث.
parentalStatusView

object (ParentalStatusView)

عرض الحالة الأبوية المشار إليها في طلب البحث.
perStoreView

object (PerStoreView)

طريقة العرض حسب المتجر المُشار إليها في طلب البحث.
productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

فئة عروض أسعار المنتج المُشار إليها في طلب البحث.
productGroupView

object (ProductGroupView)

عرض مجموعة المنتجات المشار إليها في طلب البحث.
recommendation

object (Recommendation)

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

نموذج العملاء المحتملين الذي أرسله المستخدم المُشار إليه في طلب البحث.
metrics

object (Metrics)

المقاييس
segments

object (Segments)

الشرائح

AccountBudget

ميزانية على مستوى الحساب. وهي تحتوي على معلومات عن الميزانية نفسها، بالإضافة إلى أحدث التغييرات التي تمت الموافقة عليها على الميزانية والتغييرات المقترحة التي لا تزال في انتظار الموافقة. توجد التغييرات المقترحة التي ما زالت في انتظار الموافقة، إن وجدت، في قسم "العرض في انتظار الموافقة". يمكن العثور على تفاصيل فعالة حول الميزانية في الحقول التي تبدأ بـ "الموافقة_ " و"المُعدَّلة_"، والحقول التي لا تحتوي على بادئة. وبما أنّ بعض التفاصيل الفعّالة قد تختلف عما طلبه المستخدم في الأصل (على سبيل المثال، حدّ الإنفاق)، يتم وضع هذه الاختلافات بين الحقول "proposed_" و"Approved_" و"ربما" التي تم تعديلها.

تم تعديل هذا المورد باستخدام AccountBudgetProposal ولا يمكن تبديله مباشرةً. يجوز أن تحتوي الميزانية على عرض معلق واحد على الأكثر في أي وقت محدد. وتتم قراءته من خلال اقتراح في انتظار المراجعة.

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

تمثيل JSON 
{
  "resourceName": string,
  "status": enum (AccountBudgetStatus),
  "totalAdjustmentsMicros": string,
  "amountServedMicros": string,
  "pendingProposal": {
    object (PendingAccountBudgetProposal)
  },
  "id": string,
  "billingSetup": string,
  "name": string,
  "proposedStartDateTime": string,
  "approvedStartDateTime": string,
  "purchaseOrderNumber": string,
  "notes": string,

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

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

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

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

  // Union field adjusted_spending_limit can be only one of the following:
  "adjustedSpendingLimitMicros": string,
  "adjustedSpendingLimitType": enum (SpendingLimitType)
  // End of list of possible types for union field adjusted_spending_limit.
}
الحقول
resourceName

string

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

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

enum (AccountBudgetStatus)

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

string (int64 format)

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

ومن الأمثلة على هذه التسوية الأرصدة الودّية.
amountServedMicros

string (int64 format)

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

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

object (PendingAccountBudgetProposal)

النتائج فقط. الاقتراح في انتظار المراجعة لتعديل هذه الميزانية، إذا كان ذلك منطبقًا.
id

string (int64 format)

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

string

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

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. لن تتم تعبئة هذا الحقل إلا إذا كان حد الإنفاق الموافَق عليه "INFINITE".

حقل الاتحاد adjusted_spending_limit حد الإنفاق بعد تطبيق التسويات. يتم تخزين التعديلات في total_modments_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

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

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

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

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

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

AssetUsage

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

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

string

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

enum (ServedAssetFieldType)

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

AdGroupAdAssetView

رابط بين إعلان مجموعة إعلانية ومادة عرض. لا نتيح حاليًا سوى adAssetView على AppAds والإعلانات المتجاوبة على شبكة البحث.

تمثيل JSON 
{
  "resourceName": string,
  "fieldType": enum (AssetFieldType),
  "policySummary": {
    object (AdGroupAdAssetPolicySummary)
  },
  "performanceLabel": enum (AssetPerformanceLabel),
  "pinnedField": enum (ServedAssetFieldType),
  "adGroupAd": string,
  "asset": string,
  "enabled": boolean
}
الحقول
resourceName

string

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

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

وتكون أسماء موارد مشاهدة مواد عرض الإعلانات في المجموعة الإعلانية على النحو التالي (بدءًا من V4):

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

enum (AssetFieldType)

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

object (AdGroupAdAssetPolicySummary)

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

enum (AssetPerformanceLabel)

النتائج فقط. أداء ربط مواد العرض
pinnedField

enum (ServedAssetFieldType)

النتائج فقط. حقل "التطبيقات المثبّتة"
adGroupAd

string

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

string

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

boolean

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

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

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

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

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

string

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

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

enum (SimulationType)

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

enum (SimulationModificationMethod)

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

string (int64 format)

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

string (int64 format)

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

string

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

string

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

object (CpcBidSimulationPointList)

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

object (PercentCpcBidSimulationPointList)

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

SimulationType

يشير هذا المقياس إلى قيم التعداد التي تصف الحقل الذي تعدّله المحاكاة.

عمليات التعداد
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 تم قياس جميع القيم في إحدى المحاكاة باستخدام نفس العامل. على سبيل المثال، في حملة مستنِدة إلى تكلفة مستهدَفة للإجراء، تمّ قياس استهداف الحملة وجميع استهدافات المجموعات الإعلانية بعامل س.

CpcBidSimulationPointList

تمثّل هذه السمة حاوية لنقاط المحاكاة لعمليات المحاكاة من النوع تكلفة النقرة (CPC)".

تمثيل 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، يتم ضبط cpc_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. شبكة البحث - تكلفة النقرة (CPC) - تلقائي
  2. شبكة البحث - تكلفة النقرة (CPC_bid) - التنسيق الموحّد
  3. شبكة البحث - TARGET_CPA - موحَّد
  4. شبكة البحث - عائد الإنفاق الإعلاني المستهدف TARGET_ROAS - موحَّد
  5. الشبكة الإعلانية - تكلفة النقرة (CPC) - القيمة التلقائية
  6. الشبكة الإعلانية - تكلفة النقرة (CPC) - الاسم الموحّد
  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,

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

العدد المتوقع لمرات ظهور الشريحة العلوية. لا يتيح هذا الحقل سوى نوع القناة الإعلانية على شبكة البحث.
حقل الاتحاد 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

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

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

DomainCategory

فئة يتم إنشاؤها تلقائيًا من خلال الزحف إلى نطاق. إذا كانت حملة تستخدم الإعداد DynamicSearchAdsSettings، سيتم إنشاء فئات النطاق للنطاق. يمكن استهداف الفئات باستخدام 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" للإشارة إلى اللغة الإنجليزية. يمكن تحديد اللغة في إعداد الإعلانات الديناميكية على شبكة البحث المطلوب للإعلانات الديناميكية على شبكة البحث. هذه هي لغة صفحات موقعك الإلكتروني التي تريد أن يعثر برنامج "إعلانات Google" عليها وينشئ إعلانات لها ويطابق عمليات البحث معها.
domain

string

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

number

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

string (int64 format)

النتائج فقط. موضع هذه الفئة في مجموعة الفئات. تشير الأرقام المنخفضة إلى تطابق أفضل للنطاق. تشير الأرقام "فارغ" إلى أنه ليس مستحسن.
hasChildren

boolean

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

string (int64 format)

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

AssetFieldTypeView

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

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

string

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

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

enum (AssetFieldType)

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

AssetGroupProductGroupView

عرض مجموعة منتجات لمواد العرض.

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

string

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

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

string

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

string

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

AssetSetTypeView

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

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

string

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

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

enum (AssetSetType)

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

BiddingStrategySimulation

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

  1. TARGET_CPA - موحَّد
  2. عائد النفقات الإعلانية المستهدف - موحّد
تمثيل 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) - التنسيق الموحّد
  • شبكة البحث - تكلفة النقرة (CPC) - ارتفاع الطلب
  • شبكة البحث - TARGET_CPA - موحَّد
  • شبكة البحث - TARGET_CPA - زيادة كبيرة
  • شبكة البحث - عائد الإنفاق الإعلاني المستهدف TARGET_ROAS - موحَّد
  • بحث - TARGET_IMPRESSION_SHARE - موحّد
  • شبكة البحث - الميزانية - موحَّد
  • التسوّق - الميزانية - الزي الرسمي
  • التسوّق - عائد الإنفاق الإعلاني المستهدف - موحَّد
  • MULTI_CHANNEL - TARGET_CPA - موحَّدة
  • MULTI_CHANNEL - عائد الإنفاق الإعلاني المستهدف - المستهدف - UNIFORM
  • الاستكشاف - TARGET_CPA - تلقائي
  • الشبكة الإعلانية - TARGET_CPA - موحَّد
  • PERFORMANCE_MAX - TARGET_CPA - موحَّد
  • PERFORMANCE_MAX - عائد الإنفاق الإعلاني المستهدف (TARGET_ROAS - موحّد)
  • 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)

النتائج فقط. نقاط المحاكاة إذا كان نوع المحاكاة "الميزانية"

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

حاوية لنقاط المحاكاة لعمليات المحاكاة من النوع "الميزانية"

تمثيل 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
}
الحقول
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)

العدد المتوقع لمرات ظهور الشريحة العلوية. لا يتيح هذا الحقل سوى نوع القناة الإعلانية على شبكة البحث.

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 يومًا. يتم عرض القيم السابقة والجديدة للحقول التي تم تغييرها. قد يكون هناك تأخير لمدة تصل إلى 3 دقائق في ChangeEvent لإظهار تغيير جديد.

تمثيل JSON 
{
  "resourceName": string,
  "changeDateTime": string,
  "changeResourceType": enum (ChangeEventResourceType),
  "changeResourceName": string,
  "clientType": enum (ChangeClientType),
  "userEmail": string,
  "oldResource": {
    object (ChangedResource)
  },
  "newResource": {
    object (ChangedResource)
  },
  "resourceChangeOperation": enum (ResourceChangeOperation),
  "changedFields": string,
  "campaign": string,
  "adGroup": string,
  "feed": string,
  "feedItem": string,
  "asset": string
}
الحقول
resourceName

string

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

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

string

النتائج فقط. وقت إجراء التغيير في هذا المورد
changeResourceType

enum (ChangeEventResourceType)

النتائج فقط. نوع المورد الذي تم تغييره. يحدد هذا المورد الذي سيتم تعيينه في oldResource وnewResource.
changeResourceName

string

النتائج فقط. مرجع "بسيط" الذي حدث عليه هذا التغيير
clientType

enum (ChangeClientType)

النتائج فقط. المكان الذي تم فيه إجراء التغيير.
userEmail

string

النتائج فقط. تمثّل هذه السمة عنوان البريد الإلكتروني للمستخدم الذي أجرى هذا التغيير.
oldResource

object (ChangedResource)

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

object (ChangedResource)

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

enum (ResourceChangeOperation)

النتائج فقط. العملية على المورد الذي تم تغييره.
changedFields

string (FieldMask format)

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

هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: "user.displayName,photo"
campaign

string

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

string

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

string

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

string

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

string

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

ChangeEventResourceType

يسرد هذا التعداد أنواع الموارد التي يدعمها مورد ChangeEvent.

عمليات التعداد
UNSPECIFIED لم يتم تحديد قيمة.
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يمثل موردًا غير مصنَّف غير معروف في هذا الإصدار.
AD تغيير في مورد الإعلانات
AD_GROUP تغيير مورد المجموعة الإعلانية.
AD_GROUP_CRITERION تغيير مورد معيار المجموعة الإعلانية.
CAMPAIGN تغيير في مورد الحملة.
CAMPAIGN_BUDGET تغيير في موارد CampaignBudget
AD_GROUP_BID_MODIFIER تغيير في مورد معدِّل المجموعة الإعلانية
CAMPAIGN_CRITERION تغيير مورد معيار الحملة.
FEED تغيير في مورد الخلاصة
FEED_ITEM تغيير في مورد FeedItem
CAMPAIGN_FEED تغيير في مورد CampaignFeed
AD_GROUP_FEED تغيير مورد SKAdNetworkFeed
AD_GROUP_AD تغيير مورد إعلان المجموعة الإعلانية
ASSET تغيير في مورد مادة العرض.
CUSTOMER_ASSET تغيير في مورد CustomerAsset
CAMPAIGN_ASSET تغيير في مورد CampaignAsset
AD_GROUP_ASSET تغيير في موارد مادة العرض الإبداعية
ASSET_SET تغيير في مورد AssetSet
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".

ChangedResource

نموذج برنامج تضمين يقدم جميع الموارد المدعومة. سيتم ضبط مورد 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_CTRL.
campaign

object (Campaign)

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

object (CampaignBudget)

النتائج فقط. يجب ضبط قيمة changeResourceType == CAMPAIGN_Budget.
adGroupBidModifier

object (AdGroupBidModifier)

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

object (CampaignCriterion)

النتائج فقط. يمكنك ضبط القيمة في حال كان changeResourceType == CAMPAIGN_Organization.
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، سيتم ضبط حقلَي الحملة والمجموعة الإعلانية.
resourceStatus

enum (ChangeStatusOperation)

النتائج فقط. تمثل حالة المورد الذي تم تغييره.
sharedSet

string

النتائج فقط. تأثر SharedSet بهذا التغيير.
campaignSharedSet

string

النتائج فقط. تأثرت CampaignSharedSet بهذا التغيير.
asset

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

ChangeStatusResourceType

يسرد هذا التعداد أنواع الموارد التي يدعمها مورد ChangeStatus.

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

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

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

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

object (KeywordInfo)

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

string

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

string (int64 format)

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

string

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

string

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

string

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

ClickLocation

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

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

string

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

string

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

string

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

string

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

string

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

CurrencyConstant

يشير ذلك المصطلح إلى ثابت العملة.

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

string

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

currencyConstants/{code}
code

string

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

string

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

string

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

string (int64 format)

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

AccessibleBiddingStrategy

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

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

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

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

string

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

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

النتائج فقط. خيار عائد الإنفاق الإعلاني المستهدَف (ROAS). وفي حال تحديدها، ستؤدي استراتيجية عروض الأسعار إلى زيادة الأرباح إلى أقصى حدّ مع احتساب متوسط عائد الإنفاق الإعلاني المستهدَف. إذا كان عائد الإنفاق الإعلاني المستهدف مرتفعًا، قد لا تتمكّن استراتيجية عروض الأسعار من إنفاق الميزانية بالكامل. وفي حال عدم ضبط عائد الإنفاق الإعلاني المستهدَف، ستهدِف استراتيجية عروض الأسعار إلى تحقيق أعلى عائد إنفاق إعلاني ممكن في الميزانية.

MaximizeConversions

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

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

string (int64 format)

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

TargetCpa

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

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

string (int64 format)

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

TargetImpressionShare

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

تمثيل JSON 
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
الحقول
location

enum (TargetImpressionShareLocation)

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

string (int64 format)

الجزء المختار من الإعلانات الذي سيتم عرضه في الموقع الجغرافي المستهدف بالميكرو ثانية. على سبيل المثال، تساوي 1% 10000.
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

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

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

النتائج فقط. اسم المورد للعميل. تكون أسماء موارد CustomerClient على النحو التالي: 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 (سيتم تعيين نوع adsChannelType فقط، وستكون الفئة متاحة لجميع الأنواع الفرعية ضمنه) أو CHANNEL_TYPE_AND_SUBTYPES (advertisingChannelType وadvertisingChannelSubType وincludeDefaultChannelSubType).
advertisingChannelType

enum (AdvertisingChannelType)

نوع القناة التي تتوفّر لها الفئة:
advertisingChannelSubType[]

enum (AdvertisingChannelSubType)

أنواع القنوات الفرعية ضمن نوع القناة التي تتوفّر لها الفئة.
includeDefaultChannelSubType

boolean

ما إذا تم تضمين النوع الفرعي التلقائي للقناة على سبيل المثال، إذا كانت قيمة AdvertisingChannelType هي DISPLAY وincludeDefaultChannelSubType تشير إلى أنّ القيمة false، يعني ذلك أنّ حملة الشبكة الإعلانية التلقائية التي لم يتمّ فيها تحديد النوع الفرعي للقناة لن يتمّ تضمينها في إعدادات مدى التوفّر هذه.

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

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

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

string

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

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

enum (DistanceBucket)

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

boolean

النتائج فقط. True إذا كان SpaceBucket يستخدم النظام المتري، و false في الحالات الأخرى.

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 كان المستخدم في نطاق 1.1 كيلومتر من الموقع الجغرافي.
WITHIN_1MILE كان المستخدم على بُعد 1.6 كيلومتر من الموقع الجغرافي.
WITHIN_5MILES كان المستخدم في نطاق 5 أميال من الموقع.
WITHIN_10MILES كان المستخدم في نطاق 16 أميال من الموقع.
WITHIN_15MILES كان المستخدم في نطاق 15 ميلاً من الموقع.
WITHIN_20MILES كان المستخدم في نطاق 20 ميلاً من الموقع.
WITHIN_25MILES كان المستخدم في نطاق 25 ميلاً من الموقع.
WITHIN_30MILES كان المستخدم في نطاق 30 ميلاً من الموقع.
WITHIN_35MILES كان المستخدم في نطاق 35 ميلاً من الموقع.
WITHIN_40MILES كان المستخدم في نطاق 40 ميلاً من الموقع.
BEYOND_40MILES كان المستخدم يتجاوز 40 ميلاً من الموقع.

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

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

النتائج فقط. معرّف لحساب "مركز إدارة معلومات الفنادق" الذي يوفّر أسعار حملة الفندق.
hotelId

string

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

يلخِّص عرض الموقع الجغرافي أداء الحملات حسب معيار الموقع الجغرافي. إذا لم يتم ضبط أي معيار للموقع الجغرافي، لن يتم عرض أي نتائج. بدلاً من ذلك، يمكنك استخدام geoView أو userLocationView لبيانات الموقع الجغرافي للزائر.

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

string

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

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

ManagedPlacementView

طريقة عرض المواضع المختارة.

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

string

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

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

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 الأجهزة اللوحية

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

النتائج فقط. تمثّل هذه السمة اسم المرجع للسؤال المؤهِّل.

"qualizingQuestions/{qualificationQuestionId}"
qualifyingQuestionId

string (int64 format)

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

string

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

string

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

ParentalStatusView

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

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

string

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

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

PerStoreView

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

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

string

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

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

string

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

ProductBiddingCategoryConstant

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

تمثيل JSON 
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
الحقول
resourceName

string

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

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

enum (ProductBiddingCategoryLevel)

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

enum (ProductBiddingCategoryStatus)

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

string (int64 format)

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

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

string

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

string

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

string

النتائج فقط. رمز اللغة لفئة عروض أسعار المنتج.
localizedName

string

النتائج فقط. القيمة المعروضة لفئة عروض أسعار المنتجات المترجَمة حسب رمز اللغة

ProductBiddingCategoryStatus

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

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
ACTIVE الفئة نشطة ويمكن استخدامها لتقديم عروض الأسعار.
OBSOLETE الفئة قديمة. تُستخدَم لأغراض إعداد التقارير فقط.

ProductGroupView

عرض مجموعة منتجات.

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

string

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

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

الإجراء المقترَح

اقتراح:

تمثيل JSON 
{
  "resourceName": string,
  "type": enum (RecommendationType),
  "impact": {
    object (RecommendationImpact)
  },
  "campaigns": [
    string
  ],
  "campaignBudget": string,
  "campaign": string,
  "adGroup": string,
  "dismissed": boolean,

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

string

غير قابل للتغيير. اسم مورد الاقتراح.

customers/{customerId}/recommendations/{recommendation_id}
type

enum (RecommendationType)

النتائج فقط. نوع الاقتراح.
impact

object (RecommendationImpact)

النتائج فقط. التأثير في أداء الحساب نتيجةً لتطبيق الاقتراح.
campaigns[]

string

النتائج فقط. الحملات التي تستهدفها هذا الاقتراح.

سيتم تعيين هذا الحقل لأنواع الاقتراحات التالية: CAMPAIGN_Budget وFORECASَين يبقى من النوع FORECASَين_CAMPAIGN_Budget وMARGINAL_ROI_CAMPAIGN_ لجميع الميزانية وMOVE_UNUSE_ مجانية.
campaignBudget

string

النتائج فقط. الميزانية التي تستهدفها هذا الاقتراح. سيتم ضبط هذا الإعداد فقط عندما يؤثر الاقتراح في ميزانية حملة واحدة.

سيتم تعيين هذا الحقل لأنواع الاقتراحات التالية: CAMPAIGN_Budget وFORECAS وتشمل_CAMPAIGN_Budget وMARGINAL_ROI_CAMPAIGN_Budget وMOVE_UNUSE_Budget
campaign

string

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

سيتم ضبط هذا الحقل لأنواع الاقتراحات التالية: CALL_extension_DESCRIPTION_ADDINSTRING_LOG، CALLOUT_DESCRIPTION, ENHANCED_CPC_opt_IN, USE_BROAD_MATCH_TYPE, الكلمة الرئيسية، الكلمة الرئيسية، الكلمة الرئيسية، UPPEACH_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX، MAXIMIZE_PERFORMANCE_MAX، MAXIMIZE_SEARCH_DESCRIPTION_LOG_IN, MAXIMIZE_Extension_storage_DESCRIPTION, ENHANCED_CPC_opt_IN, USE_BROAD_MATCH_TYPE, الكلمة الرئيسية، الكلمة الرئيسية، LEFT_MATCH_TYPE.

adGroup

string

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

سيتم ضبط هذا الحقل لأنواع الاقتراحات التالية: الكلمة الرئيسية، وoptIMIZE_AD_ROTATION، وRESPONSIVE_SEARCH_AD، وRESPONSIVE_SEARCH_AD_ASSET، وTEXT_AD
dismissed

boolean

النتائج فقط. ما إذا كان قد تم رفض الاقتراح أم لا.
حقل الاتحاد recommendation تفاصيل الاقتراح. يمكن أن يكون الحقل "recommendation" واحدًا فقط مما يلي:
campaignBudgetRecommendation

object (CampaignBudgetRecommendation)

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

object (CampaignBudgetRecommendation)

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

object (KeywordRecommendation)

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

object (TextAdRecommendation)

النتائج فقط. أضِف توصية إعلان نصي موسَّع.
targetCpaOptInRecommendation

object (TargetCpaOptInRecommendation)

النتائج فقط. اقتراح تفعيل استراتيجية "التكلفة المستهدَفة للإجراء"
maximizeConversionsOptInRecommendation

object (MaximizeConversionsOptInRecommendation)

النتائج فقط. اقتراح تفعيل "تحقيق الحد الأقصى من الإحالات الناجحة"
enhancedCpcOptInRecommendation

object (EnhancedCpcOptInRecommendation)

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

object (SearchPartnersOptInRecommendation)

النتائج فقط. اقتراح تفعيل شركاء البحث
maximizeClicksOptInRecommendation

object (MaximizeClicksOptInRecommendation)

النتائج فقط. اقتراح تفعيل "الحصول على الحد الأقصى من النقرات"
optimizeAdRotationRecommendation

object (OptimizeAdRotationRecommendation)

النتائج فقط. اقتراح "تحسين عرض الإعلانات بالتناوب".
keywordMatchTypeRecommendation

object (KeywordMatchTypeRecommendation)

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

object (MoveUnusedBudgetRecommendation)

النتائج فقط. اقتراح نقل الميزانية غير المستخدَمة
targetRoasOptInRecommendation

object (TargetRoasOptInRecommendation)

النتائج فقط. اقتراح تفعيل عائد الإنفاق الإعلاني المستهدف
responsiveSearchAdRecommendation

object (ResponsiveSearchAdRecommendation)

النتائج فقط. اقتراح إضافة إعلان متجاوب على شبكة البحث
marginalRoiCampaignBudgetRecommendation

object (CampaignBudgetRecommendation)

النتائج فقط. اقتراح ميزانية حملة عائد الاستثمار الهامشي.
useBroadMatchKeywordRecommendation

object (UseBroadMatchKeywordRecommendation)

النتائج فقط. اقتراح استخدام كلمات رئيسية تستخدِم المطابقة التقريبية.
responsiveSearchAdAssetRecommendation

object (ResponsiveSearchAdAssetRecommendation)

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

object (UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation)

النتائج فقط. ترقية "حملة Shopping ذكية" إلى اقتراح "حملة أداء أفضل"
responsiveSearchAdImproveAdStrengthRecommendation

object (ResponsiveSearchAdImproveAdStrengthRecommendation)

النتائج فقط. اقتراح قوة الإعلان المتعلّق بالإعلان المتجاوب على شبكة البحث
displayExpansionOptInRecommendation

object (DisplayExpansionOptInRecommendation)

النتائج فقط. اقتراح تفعيل ميزة "الانتشار على الشبكة الإعلانية".
upgradeLocalCampaignToPerformanceMaxRecommendation

object (UpgradeLocalCampaignToPerformanceMaxRecommendation)

النتائج فقط. ترقية "حملة محلية" إلى اقتراح "حملة أداء أفضل"
raiseTargetCpaBidTooLowRecommendation

object (RaiseTargetCpaBidTooLowRecommendation)

النتائج فقط. اقتراح رفع عرض السعر المستهدف للإجراء منخفض جدًا.
forecastingSetTargetRoasRecommendation

object (ForecastingSetTargetRoasRecommendation)

النتائج فقط. التوقّعات التي تم ضبطها لاقتراح عائد الإنفاق الإعلاني المستهدف.
calloutAssetRecommendation

object (CalloutAssetRecommendation)

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

object (CallAssetRecommendation)

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

object (ShoppingOfferAttributeRecommendation)

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

object (ShoppingOfferAttributeRecommendation)

النتائج فقط. اقتراح لون إضافة التسوق.
shoppingAddGenderRecommendation

object (ShoppingOfferAttributeRecommendation)

النتائج فقط. اقتراحات الجنس لإضافة التسوق
shoppingAddGtinRecommendation

object (ShoppingOfferAttributeRecommendation)

النتائج فقط. اقتراح بشأن إضافة رقم GTIN أثناء التسوّق
shoppingAddMoreIdentifiersRecommendation

object (ShoppingOfferAttributeRecommendation)

النتائج فقط. اقتراح إضافة المزيد من المعرّفات في "حملة التسوّق".
shoppingAddSizeRecommendation

object (ShoppingOfferAttributeRecommendation)

النتائج فقط. اقتراح حجم إضافة التسوّق.
shoppingAddProductsToCampaignRecommendation

object (ShoppingAddProductsToCampaignRecommendation)

النتائج فقط. تضيف حملة Shopping منتجات إلى اقتراح الحملة.
shoppingFixDisapprovedProductsRecommendation

object (ShoppingFixDisapprovedProductsRecommendation)

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

object (ShoppingTargetAllOffersRecommendation)

النتائج فقط. يقدّم هدف التسوق "كل الاقتراحات" اقتراحات.
shoppingFixSuspendedMerchantCenterAccountRecommendation

object (ShoppingMerchantCenterAccountSuspensionRecommendation)

النتائج فقط. اقتراح حساب Merchant Center المعلّق من أجل حل التسوّق.
shoppingFixMerchantCenterAccountSuspensionWarningRecommendation

object (ShoppingMerchantCenterAccountSuspensionRecommendation)

النتائج فقط. اقتراح تحذير بشأن تعليق حساب Merchant Center لإصلاح Shopping.
shoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

object (ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation)

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

object (DynamicImageExtensionOptInRecommendation)

النتائج فقط. اقتراح لتفعيل إضافات الصور الديناميكية في الحساب، ما يسمح لـ Google بالعثور على أفضل الصور من الصفحات المقصودة للإعلانات والإعلانات النصية التكميلية
raiseTargetCpaRecommendation

object (RaiseTargetCpaRecommendation)

النتائج فقط. اقتراح لرفع التكلفة المستهدفة للإجراء.
lowerTargetRoasRecommendation

object (LowerTargetRoasRecommendation)

النتائج فقط. اقتراح لخفض "عائد الإنفاق الإعلاني المستهدف".
performanceMaxOptInRecommendation

object (PerformanceMaxOptInRecommendation)

النتائج فقط. اقتراح تفعيل "حملات الأداء الأفضل"
improvePerformanceMaxAdStrengthRecommendation

object (ImprovePerformanceMaxAdStrengthRecommendation)

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

object (MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation)

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

RecommendationType

أنواع الاقتراحات:

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
CAMPAIGN_BUDGET اقتراح الميزانية للحملات المقيَّدة بميزانية محدودة في الوقت الحالي (على عكس اقتراح FORECASَين)، وهو مقترح ميزانية للحملة الإعلانية، والذي ينطبق على الحملات التي يُتوقّع أن تصبح مقيّدة بميزانية محدودة في المستقبل.
KEYWORD اقتراح الكلمة الرئيسية.
TEXT_AD اقتراح لإضافة إعلان نصي جديد.
TARGET_CPA_OPT_IN اقتراح لتعديل حملة من أجل استخدام استراتيجية عروض أسعار التكلفة المستهدفة للإجراء.
MAXIMIZE_CONVERSIONS_OPT_IN اقتراح لتعديل حملة من أجل استخدام استراتيجية "عروض أسعار تحقيق الحد الأقصى من الإحالات الناجحة".
ENHANCED_CPC_OPT_IN اقتراح لتفعيل تكلفة النقرة المحسّنة لإحدى الحملات.
SEARCH_PARTNERS_OPT_IN اقتراح لبدء عرض إعلانات حملتك على المواقع الإلكترونية لشركاء "بحث Google"
MAXIMIZE_CLICKS_OPT_IN اقتراح لتعديل حملة تستخدم استراتيجية عروض أسعار "الحصول على الحد الأقصى من النقرات".
OPTIMIZE_AD_ROTATION اقتراح ببدء استخدام إعداد "تحسين" عرض الإعلانات بالتناوب للمجموعة الإعلانية المحددة.
KEYWORD_MATCH_TYPE اقتراح لتغيير كلمة رئيسية حالية من نوع مطابقة إلى نوع مطابقة أوسع نطاقًا
MOVE_UNUSED_BUDGET اقتراح لنقل الميزانية غير المستخدَمة من ميزانية واحدة إلى ميزانية محدودة
FORECASTING_CAMPAIGN_BUDGET اقتراح الميزانية للحملات التي يُتوقّع أن تصبح مقيّدة بميزانية محدودة في المستقبل (على عكس اقتراح CAMPAIGN_Budget الذي ينطبق على الحملات المقيَّدة بميزانية محدودة حاليًا).
TARGET_ROAS_OPT_IN اقتراح لتعديل حملة من أجل استخدام استراتيجية عروض أسعار "عائد الإنفاق الإعلاني المستهدف".
RESPONSIVE_SEARCH_AD اقتراح لإضافة إعلان متجاوب جديد على شبكة البحث.
MARGINAL_ROI_CAMPAIGN_BUDGET اقتراح ميزانية للحملات التي من المتوقّع أن يزيد عائد استثمارها عند إجراء تسوية للميزانية.
USE_BROAD_MATCH_KEYWORD اقتراح لإضافة نُسَخ مطابقة تقريبية من الكلمات الرئيسية إلى الحملات التي تستخدِم عروض الأسعار المستنِدة إلى الإحالات الناجحة المبرمَجة بالكامل
RESPONSIVE_SEARCH_AD_ASSET اقتراح لإضافة مواد عرض جديدة للإعلانات المتجاوبة على شبكة البحث
UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX اقتراح بترقية "حملة Shopping ذكية" إلى "حملة أداء أفضل"
RESPONSIVE_SEARCH_AD_IMPROVE_AD_STRENGTH اقتراح لتحسين قوة الإعلان المتجاوب على شبكة البحث
DISPLAY_EXPANSION_OPT_IN اقتراح لتعديل حملة لاستخدام ميزة "الانتشار على الشبكة الإعلانية".
UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX اقتراح بترقية "حملة محلية" إلى "حملة أداء أفضل"
RAISE_TARGET_CPA_BID_TOO_LOW اقتراح لرفع التكلفة المستهدفة للإجراء عندما تكون منخفضة جدًا وكان هناك عدد قليل جدًا من الإحالات الناجحة أو لا تكون هناك أي إحالات ناجحة. يتم تطبيقها بشكل غير متزامن ويمكن أن تستغرق دقائق حسب عدد المجموعات الإعلانية في الحملة ذات الصلة.
FORECASTING_SET_TARGET_ROAS اقتراح رفع الميزانية قبل حدث موسمي من المتوقّع أن يؤدي إلى زيادة عدد الزيارات، وتغيير استراتيجية عروض الأسعار من استراتيجية "تحقيق الحد الأقصى من قيمة الإحالات الناجحة" إلى "عائد الإنفاق الإعلاني المستهدف"
CALLOUT_ASSET اقتراح لإضافة مواد عرض وسائل الشرح إلى مستوى الحملة أو العميل.
CALL_ASSET اقتراح لإضافة مواد عرض المكالمات إلى مستوى الحملة أو العميل.
SHOPPING_ADD_AGE_GROUP اقتراح بإضافة سمة الفئة العمرية إلى العروض التي تم خفض ترتيبها بسبب عدم توفّر فئة عمرية
SHOPPING_ADD_COLOR اقتراح لإضافة لون إلى العروض التي تم خفض ترتيبها بسبب عدم توفّر لون
SHOPPING_ADD_GENDER اقتراح إضافة سمة الجنس إلى العروض التي تم خفض ترتيبها بسبب عدم توفّر سمة الجنس
SHOPPING_ADD_GTIN اقتراح إضافة رقم GTIN (الرقم التجاري العالمي للسلعة) إلى العروض التي تم خفض ترتيبها بسبب عدم توفّر رقم GTIN
SHOPPING_ADD_MORE_IDENTIFIERS اقتراح لإضافة المزيد من المعرّفات إلى العروض التي تم خفض ترتيبها بسبب عدم توفّر معرّفات.
SHOPPING_ADD_SIZE اقتراح إضافة المقاس إلى العروض التي تم خفض ترتيبها بسبب عدم توفّر المقاس.
SHOPPING_ADD_PRODUCTS_TO_CAMPAIGN اقتراح يُعلِم العميل بحملة لا يمكن عرض إعلاناتها بسبب عدم استهداف أيّ منتجات.
SHOPPING_FIX_DISAPPROVED_PRODUCTS اقتراح التسوّق الذي يُعلم العميل بحملة تحتوي على نسبة عالية من المنتجات المرفوضة
SHOPPING_TARGET_ALL_OFFERS اقتراح لإنشاء حملة شاملة تستهدف جميع العروض.
SHOPPING_FIX_SUSPENDED_MERCHANT_CENTER_ACCOUNT اقتراح لحلّ المشاكل في تعليق حساب Merchant Center
SHOPPING_FIX_MERCHANT_CENTER_ACCOUNT_SUSPENSION_WARNING اقتراح لحلّ المشاكل المتعلقة بالتحذيرات بشأن تعليق حساب Merchant Center
SHOPPING_MIGRATE_REGULAR_SHOPPING_CAMPAIGN_OFFERS_TO_PERFORMANCE_MAX اقتراح لنقل العروض التي تستهدفها "حملات Shopping العادية" إلى "حملات الأداء الأفضل" الحالية
DYNAMIC_IMAGE_EXTENSION_OPT_IN اقتراح لتفعيل إضافات الصور الديناميكية في الحساب، ما يسمح لـ Google بالعثور على أفضل الصور من الصفحات المقصودة للإعلانات والإعلانات النصية التكميلية
RAISE_TARGET_CPA اقتراح لرفع التكلفة المستهدفة للإجراء استنادًا إلى توقعات Google المستندة إلى نماذج من الإحالات الناجحة السابقة يتم تطبيقها بشكل غير متزامن ويمكن أن تستغرق دقائق حسب عدد المجموعات الإعلانية في الحملة ذات الصلة.
LOWER_TARGET_ROAS اقتراح لخفض "عائد الإنفاق الإعلاني المستهدف".
PERFORMANCE_MAX_OPT_IN اقتراح لتفعيل "حملات الأداء الأفضل"
IMPROVE_PERFORMANCE_MAX_AD_STRENGTH اقتراح لتحسين قوة مجموعة مواد العرض في "حملة الأداء الأفضل" إلى تقييم "ممتاز"
MIGRATE_DYNAMIC_SEARCH_ADS_CAMPAIGN_TO_PERFORMANCE_MAX اقتراح لنقل الإعلانات الديناميكية على شبكة البحث إلى "حملات الأداء الأفضل".

RecommendationImpact

تأثير إجراء التغيير كما هو موضّح في التوصية. قد لا تتضمّن بعض أنواع الاقتراحات المعلومات المتعلّقة بالتأثير.

تمثيل JSON 
{
  "baseMetrics": {
    object (RecommendationMetrics)
  },
  "potentialMetrics": {
    object (RecommendationMetrics)
  }
}
الحقول
baseMetrics

object (RecommendationMetrics)

النتائج فقط. المقاييس الأساسية في وقت إنشاء الاقتراح.
potentialMetrics

object (RecommendationMetrics)

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

RecommendationMetrics

مقاييس أداء الحساب الأسبوعية يتم احتساب متوسط قيم بعض أنواع الاقتراحات خلال آخر 90 يومًا، وبالتالي يمكن أن تكون قيمة جزئية.

تمثيل JSON 
{
  "impressions": number,
  "clicks": number,
  "costMicros": string,
  "conversions": number,
  "videoViews": number
}
الحقول
impressions

number

النتائج فقط. عدد مرات ظهور الإعلان.
clicks

number

النتائج فقط. عدد النقرات على الإعلان.
costMicros

string (int64 format)

النتائج فقط. تكلفة الإعلان (بالمايكرو) بالعملة المحلية للحساب.
conversions

number

النتائج فقط. عدد الإحالات الناجحة.
videoViews

number

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

CampaignBudgetRecommendation

اقتراح الميزانية للحملات المقيدة بميزانية محدودة.

تمثيل JSON 
{
  "budgetOptions": [
    {
      object (CampaignBudgetRecommendationOption)
    }
  ],
  "currentBudgetAmountMicros": string,
  "recommendedBudgetAmountMicros": string
}
الحقول
budgetOptions[]

object (CampaignBudgetRecommendationOption)

النتائج فقط. مبالغ الميزانيات وتقديرات التأثير المرتبطة بها لبعض قيم مبالغ الميزانية المحتملة
currentBudgetAmountMicros

string (int64 format)

النتائج فقط. مبلغ الميزانية الحالية بالمايكرو.
recommendedBudgetAmountMicros

string (int64 format)

النتائج فقط. مبلغ الميزانية المقترَح بالمايكرو.

CampaignBudgetRecommendationOption

تقديرات التأثير لمبلغ ميزانية معين.

تمثيل JSON 
{
  "impact": {
    object (RecommendationImpact)
  },
  "budgetAmountMicros": string
}
الحقول
impact

object (RecommendationImpact)

النتائج فقط. تقدير التأثير في حال تغيير الميزانية إلى المبلغ المحدد في هذا الخيار.
budgetAmountMicros

string (int64 format)

النتائج فقط. مبلغ الميزانية لهذا الخيار.

KeywordRecommendation

اقتراح الكلمة الرئيسية.

تمثيل JSON 
{
  "keyword": {
    object (KeywordInfo)
  },
  "searchTerms": [
    {
      object (SearchTerm)
    }
  ],
  "recommendedCpcBidMicros": string
}
الحقول
keyword

object (KeywordInfo)

النتائج فقط. الكلمة الرئيسية المقترَحة.
searchTerms[]

object (SearchTerm)

النتائج فقط. قائمة بعبارات البحث التي تتطابق معها هذه الكلمة الرئيسية. قد يتمّ تكرار عبارة البحث نفسها لعدة كلمات رئيسية.
recommendedCpcBidMicros

string (int64 format)

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

SearchTerm

معلومات عن عبارة بحث ذات صلة باقتراح كلمة رئيسية.

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

string

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

string (int64 format)

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

TextAdRecommendation

توصية الإعلان النصي.

تمثيل JSON 
{
  "ad": {
    object (Ad)
  },
  "creationDate": string,
  "autoApplyDate": string
}
الحقول
ad

object (Ad)

النتائج فقط. الإعلان المقترَح.
creationDate

string

النتائج فقط. تاريخ إنشاء الإعلان المقترَح. تنسيق YYYY-MM-DD، على سبيل المثال، 2018-04-17.
autoApplyDate

string

النتائج فقط. التاريخ، إن توفّر، هو أقرب تاريخ سيتم فيه تطبيق الاقتراح تلقائيًا. تنسيق YYYY-MM-DD، على سبيل المثال، 2018-04-17.

TargetCpaOptInRecommendation

اقتراح تفعيل التكلفة المستهدفة للإجراء.

تمثيل JSON 
{
  "options": [
    {
      object (TargetCpaOptInRecommendationOption)
    }
  ],
  "recommendedTargetCpaMicros": string
}
الحقول
options[]

object (TargetCpaOptInRecommendationOption)

النتائج فقط. الأهداف المتاحة والخيارات المقابلة لاستراتيجية التكلفة المستهدفة للإجراء.
recommendedTargetCpaMicros

string (int64 format)

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

TargetCpaOptInRecommendationOption

خيار تفعيل التكلفة المستهدفة للإجراء مع تقدير التأثير.

تمثيل JSON 
{
  "goal": enum (TargetCpaOptInRecommendationGoal),
  "impact": {
    object (RecommendationImpact)
  },
  "targetCpaMicros": string,
  "requiredCampaignBudgetAmountMicros": string
}
الحقول
goal

enum (TargetCpaOptInRecommendationGoal)

النتائج فقط. الهدف الذي تم تحقيقه بواسطة هذا الخيار.
impact

object (RecommendationImpact)

النتائج فقط. تقدير التأثير في حال تحديد هذا الخيار.
targetCpaMicros

string (int64 format)

النتائج فقط. متوسط تكلفة الإجراء المستهدفة.
requiredCampaignBudgetAmountMicros

string (int64 format)

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

TargetCpaOptInRecommendationGoal

هدف اقتراح TargetCpaOptIn.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
SAME_COST اقتراح لضبط التكلفة المستهدفة للإجراء للحفاظ على نفس التكلفة.
SAME_CONVERSIONS اقتراح لضبط التكلفة المستهدفة للإجراء للحفاظ على نفس الإحالات الناجحة.
SAME_CPA اقتراح لضبط التكلفة المستهدفة للإجراء للحفاظ على نفس تكلفة الإجراء.
CLOSEST_CPA اقتراح لضبط التكلفة المستهدفة للإجراء على قيمة أقرب ما يمكن إلى التكلفة الفعلية للإجراء، ولكنها أقل منها (يتم احتسابها على مدار آخر 28 يومًا).

MaximizeConversionsOptInRecommendation

اقتراح تفعيل "تحقيق الحد الأقصى من الإحالات الناجحة"

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

string (int64 format)

النتائج فقط. مبلغ الميزانية الجديد المقترَح.

EnhancedCpcOptInRecommendation

لا يشتمل هذا النوع على أي حقول.

اقتراح تفعيل تكلفة النقرة المحسّنة.

SearchPartnersOptInRecommendation

لا يشتمل هذا النوع على أي حقول.

اقتراح تفعيل شركاء البحث

MaximizeClicksOptInRecommendation

اقتراح تفعيل "الحصول على الحد الأقصى من النقرات"

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

string (int64 format)

النتائج فقط. مبلغ الميزانية الجديد المقترَح. لا يتم ضبطها إلا إذا كانت الميزانية الحالية مرتفعة جدًا.

OptimizeAdRotationRecommendation

لا يشتمل هذا النوع على أي حقول.

اقتراح "تحسين عرض الإعلانات بالتناوب".

KeywordMatchTypeRecommendation

اقتراح نوع مطابقة الكلمة الرئيسية.

تمثيل JSON 
{
  "keyword": {
    object (KeywordInfo)
  },
  "recommendedMatchType": enum (KeywordMatchType)
}
الحقول
keyword

object (KeywordInfo)

النتائج فقط. الكلمة الرئيسية الحالية التي يجب أن يكون نوع المطابقة فيها أكثر شمولاً.
recommendedMatchType

enum (KeywordMatchType)

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

MoveUnusedBudgetRecommendation

اقتراح نقل الميزانية غير المستخدَمة

تمثيل JSON 
{
  "budgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "excessCampaignBudget": string
}
الحقول
budgetRecommendation

object (CampaignBudgetRecommendation)

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

string

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

TargetRoasOptInRecommendation

اقتراح تفعيل عائد الإنفاق الإعلاني المستهدف

تمثيل JSON 
{
  "recommendedTargetRoas": number,
  "requiredCampaignBudgetAmountMicros": string
}
الحقول
recommendedTargetRoas

number

النتائج فقط. عائد الإنفاق الإعلاني المستهدف المقترَح (الإيرادات لكل وحدة إنفاق) وتتراوح القيمة بين 0.01 و1000.0، بشكل شامل.
requiredCampaignBudgetAmountMicros

string (int64 format)

النتائج فقط. الحد الأدنى لميزانية الحملة، بالعملة المحلية للحساب، المطلوب لتحقيق عائد الإنفاق الإعلاني المستهدف. ويتم تحديد المبلغ بالمايكرو، حيث يعادل المليون وحدة عملة واحدة.

ResponsiveSearchAdRecommendation

اقتراح إضافة إعلان متجاوب على شبكة البحث

تمثيل JSON 
{
  "ad": {
    object (Ad)
  }
}
الحقول
ad

object (Ad)

النتائج فقط. الإعلان المقترَح.

UseBroadMatchKeywordRecommendation

اقتراح استخدام كلمات رئيسية تستخدِم المطابقة التقريبية.

تمثيل JSON 
{
  "keyword": [
    {
      object (KeywordInfo)
    }
  ],
  "suggestedKeywordsCount": string,
  "campaignKeywordsCount": string,
  "campaignUsesSharedBudget": boolean,
  "requiredCampaignBudgetAmountMicros": string
}
الحقول
keyword[]

object (KeywordInfo)

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

string (int64 format)

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

string (int64 format)

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

boolean

النتائج فقط. ما إذا كانت الحملة المرتبطة تستخدِم ميزانية مشتركة
requiredCampaignBudgetAmountMicros

string (int64 format)

النتائج فقط. الميزانية المقترَحة لتجنُّب أن تصبح مقيّدة بالميزانية بعد تطبيق الاقتراح.

ResponsiveSearchAdAssetRecommendation

اقتراح إضافة مادة عرض إعلان متجاوب على شبكة البحث

تمثيل JSON 
{
  "currentAd": {
    object (Ad)
  },
  "recommendedAssets": {
    object (Ad)
  }
}
الحقول
currentAd

object (Ad)

النتائج فقط. الإعلان الحالي الذي سيتم تعديله
recommendedAssets

object (Ad)

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

UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation

ترقية "حملة Shopping ذكية" إلى اقتراح "حملة أداء أفضل"

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

string (int64 format)

النتائج فقط. رقم تعريف حساب Merchant Center.
salesCountryCode

string

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

ResponsiveSearchAdImproveAdStrengthRecommendation

اقتراح قوة الإعلان المتعلّق بالإعلان المتجاوب على شبكة البحث

تمثيل JSON 
{
  "currentAd": {
    object (Ad)
  },
  "recommendedAd": {
    object (Ad)
  }
}
الحقول
currentAd

object (Ad)

النتائج فقط. الإعلان الحالي الذي سيتم تعديله
recommendedAd

object (Ad)

النتائج فقط. الإعلان المعدّل.

DisplayExpansionOptInRecommendation

لا يشتمل هذا النوع على أي حقول.

اقتراح تفعيل ميزة "الانتشار على الشبكة الإعلانية".

UpgradeLocalCampaignToPerformanceMaxRecommendation

لا يشتمل هذا النوع على أي حقول.

اقتراح ترقية الحملة المحلية إلى "حملة الأداء الأفضل"

RaiseTargetCpaBidTooLowRecommendation

اقتراح رفع عرض السعر المستهدف للإجراء منخفض جدًا.

تمثيل JSON 
{
  "recommendedTargetMultiplier": number,
  "averageTargetCpaMicros": string
}
الحقول
recommendedTargetMultiplier

number

النتائج فقط. رقم أكبر من 1.0 يشير إلى العامل الذي ننصح من خلاله بزيادة التكلفة المستهدفة للإجراء.
averageTargetCpaMicros

string (int64 format)

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

ForecastingSetTargetRoasRecommendation

التوقّعات التي تم ضبطها لاقتراح عائد الإنفاق الإعلاني المستهدف.

تمثيل JSON 
{
  "recommendedTargetRoas": number,
  "campaignBudget": {
    object (CampaignBudget)
  }
}
الحقول
recommendedTargetRoas

number

النتائج فقط. عائد الإنفاق الإعلاني المستهدف المقترَح (الإيرادات لكل وحدة إنفاق) وتتراوح القيمة بين 0.01 و1000.0، بشكل شامل.
campaignBudget

object (CampaignBudget)

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

CampaignBudget

ميزانية حملة مشترَكة بين مختلف أنواع اقتراحات الميزانية.

تمثيل JSON 
{
  "currentAmountMicros": string,
  "recommendedNewAmountMicros": string,
  "newStartDate": string
}
الحقول
currentAmountMicros

string (int64 format)

النتائج فقط. مبلغ الميزانية الحالية.
recommendedNewAmountMicros

string (int64 format)

النتائج فقط. مبلغ الميزانية المقترَح.
newStartDate

string

النتائج فقط. التاريخ الذي سيبدأ فيه استخدام الميزانية الجديدة. سيتم ضبط هذا الحقل لأنواع الاقتراحات التالية: FORECASَينting_SET_TARGET_ROAS تنسيق YYYY-MM-DD، على سبيل المثال 2018-04-17.

CalloutAssetRecommendation

اقتراح مادة عرض وسيلة الشرح

تمثيل JSON 
{
  "recommendedCampaignCalloutAssets": [
    {
      object (Asset)
    }
  ],
  "recommendedCustomerCalloutAssets": [
    {
      object (Asset)
    }
  ]
}
الحقول
recommendedCampaignCalloutAssets[]

object (Asset)

النتائج فقط. مواد عرض إضافات وسائل الشرح الجديدة التي يُنصَح بها على مستوى الحملة
recommendedCustomerCalloutAssets[]

object (Asset)

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

SitelinkAssetRecommendation

اقتراح مادة عرض رابط أقسام الموقع.

تمثيل JSON 
{
  "recommendedCampaignSitelinkAssets": [
    {
      object (Asset)
    }
  ],
  "recommendedCustomerSitelinkAssets": [
    {
      object (Asset)
    }
  ]
}
الحقول

CallAssetRecommendation

لا يشتمل هذا النوع على أي حقول.

اقتراح مادة عرض المكالمة.

ShoppingOfferAttributeRecommendation

اقتراح التسوّق لإضافة سمة إلى العروض التي تم خفض ترتيبها بسبب عدم توفّرها

تمثيل JSON 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "offersCount": string,
  "demotedOffersCount": string
}
الحقول
merchant

object (MerchantInfo)

النتائج فقط. تفاصيل حساب Merchant Center.
feedLabel

string

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

string (int64 format)

النتائج فقط. عدد العروض على الإنترنت القابلة للعرض.
demotedOffersCount

string (int64 format)

النتائج فقط. عدد العروض القابلة للعرض على الإنترنت التي تم خفض ترتيبها بسبب سمات غير متوفّرة انتقِل إلى Merchant Center للاطّلاع على مزيد من التفاصيل.

MerchantInfo

تفاصيل حساب Merchant Center.

تمثيل JSON 
{
  "id": string,
  "name": string,
  "multiClient": boolean
}
الحقول
id

string (int64 format)

النتائج فقط. رقم تعريف حساب Merchant Center.
name

string

النتائج فقط. اسم حساب Merchant Center
multiClient

boolean

النتائج فقط. ما إذا كان حساب Merchant Center حسابًا متعدّد العملاء (MCA)

ShoppingAddProductsToCampaignRecommendation

اقتراح التسوّق لإضافة منتجات إلى مستودع حملات Shopping.

تمثيل JSON 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "reason": enum (Reason)
}
الحقول
merchant

object (MerchantInfo)

النتائج فقط. تفاصيل حساب Merchant Center.
feedLabel

string

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

enum (Reason)

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

السبب

المشاكل التي تؤدي إلى عدم استهداف أي منتجات في حملة Shopping.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
MERCHANT_CENTER_ACCOUNT_HAS_NO_SUBMITTED_PRODUCTS ما مِن منتجات تم إرسالها في حساب Merchant Center.
MERCHANT_CENTER_ACCOUNT_HAS_NO_SUBMITTED_PRODUCTS_IN_FEED لا يحتوي حساب Merchant Center على أي منتجات تم إرسالها في الخلاصة.
ADS_ACCOUNT_EXCLUDES_OFFERS_FROM_CAMPAIGN يحتوي حساب "إعلانات Google" على فلاتر حملات نشطة تمنع تضمين عروض في الحملة.
ALL_PRODUCTS_ARE_EXCLUDED_FROM_CAMPAIGN تم استبعاد جميع المنتجات المتاحة صراحةً من استهدافها من قِبل الحملة.

ShoppingFixDisapprovedProductsRecommendation

اقتراح التسوّق لإصلاح المنتجات المرفوضة في مستودع حملات Shopping.

تمثيل JSON 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "productsCount": string,
  "disapprovedProductsCount": string
}
الحقول
merchant

object (MerchantInfo)

النتائج فقط. تفاصيل حساب Merchant Center.
feedLabel

string

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

string (int64 format)

النتائج فقط. عدد منتجات الحملة.
disapprovedProductsCount

string (int64 format)

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

ShoppingTargetAllOffersRecommendation

اقتراح التسوّق لإنشاء حملة شاملة تستهدف جميع العروض

تمثيل JSON 
{
  "merchant": {
    object (MerchantInfo)
  },
  "untargetedOffersCount": string,
  "feedLabel": string
}
الحقول
merchant

object (MerchantInfo)

النتائج فقط. تفاصيل حساب Merchant Center.
untargetedOffersCount

string (int64 format)

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

string

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

ShoppingMerchantCenterAccountSuspensionRecommendation

اقتراح التسوّق لحلّ مشاكل تعليق حساب Merchant Center

تمثيل JSON 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
الحقول
merchant

object (MerchantInfo)

النتائج فقط. تفاصيل حساب Merchant Center.
feedLabel

string

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

ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

اقتراح التسوّق لنقل العروض التي تستهدف "حملات Shopping العادية" إلى "حملات الأداء الأفضل"

تمثيل JSON 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
الحقول
merchant

object (MerchantInfo)

النتائج فقط. تفاصيل حساب Merchant Center.
feedLabel

string

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

DynamicImageExtensionOptInRecommendation

لا يشتمل هذا النوع على أي حقول.

اقتراح لتفعيل إضافات الصور الديناميكية في الحساب، ما يسمح لـ Google بالعثور على أفضل الصور من الصفحات المقصودة للإعلانات والإعلانات النصية التكميلية

RaiseTargetCpaRecommendation

اقتراح لرفع التكلفة المستهدفة للإجراء.

تمثيل JSON 
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  },
  "appBiddingGoal": enum (AppBiddingGoal)
}
الحقول
targetAdjustment

object (TargetAdjustmentInfo)

النتائج فقط. المعلومات ذات الصلة التي تصف تعديل الاستهداف المقترَح.
appBiddingGoal

enum (AppBiddingGoal)

النتائج فقط. تمثيل الهدف الذي يجب تحسين استراتيجية عروض الأسعار لتحقيقه تتم تعبئة هذا الحقل فقط لـ "حملات التطبيقات".

TargetAdjustmentInfo

معلومات اقتراح تعديل الاستهداف

تمثيل JSON 
{
  "recommendedTargetMultiplier": number,
  "currentAverageTargetMicros": string,
  "sharedSet": string
}
الحقول
recommendedTargetMultiplier

number

النتائج فقط. العامل الذي ننصح بتعديل الهدف من خلاله.
currentAverageTargetMicros

string (int64 format)

النتائج فقط. متوسط الاستهداف الحالي للحملة أو المحفظة التي يستهدفها هذا الاقتراح.
sharedSet

string

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

AppBiddingGoal

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

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN يمثّل قيمة غير معروفة في هذا الإصدار من واجهة برمجة التطبيقات.
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME يجب أن تهدف استراتيجية عروض الأسعار في "حملة التطبيقات" إلى زيادة عمليات تثبيت التطبيق إلى أقصى حدّ.
OPTIMIZE_FOR_IN_APP_CONVERSION_VOLUME يجب أن تهدف استراتيجية عروض الأسعار في "حملة التطبيقات" إلى زيادة عدد الإحالات الناجحة المحدّدة داخل التطبيق إلى أقصى حدّ.
OPTIMIZE_FOR_TOTAL_CONVERSION_VALUE يجب أن تهدف استراتيجية عروض الأسعار في حملة التطبيقات إلى تحقيق الحد الأقصى من قيمة كل الإحالات الناجحة، أي عمليات التثبيت والإحالات الناجحة داخل التطبيق واختيارها.
OPTIMIZE_FOR_TARGET_IN_APP_CONVERSION يجب أن تهدف استراتيجية عروض الأسعار لحملة التطبيقات إلى زيادة عدد الإحالات الناجحة المحدّدة داخل التطبيق فقط، مع تحقيق التكلفة المستهدفة لكل إحالة ناجحة داخل التطبيق أو تجاوزها.
OPTIMIZE_FOR_RETURN_ON_ADVERTISING_SPEND يجب أن تهدف استراتيجية عروض الأسعار في حملة التطبيقات إلى تحقيق الحد الأقصى من قيمة كل الإحالات الناجحة، أي التثبيت واختيار الإحالات الناجحة داخل التطبيق مع تحقيق عائد الإنفاق الإعلاني المستهدف أو تجاوزه.
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME_WITHOUT_TARGET_CPI يجب أن تهدف استراتيجية عروض الأسعار هذه في حملة التطبيقات إلى زيادة عمليات تثبيت التطبيق إلى أقصى حدّ بدون التكلفة المستهدفة لكل تثبيت التي يقدّمها المعلِن.
OPTIMIZE_FOR_PRE_REGISTRATION_CONVERSION_VOLUME يجب أن تهدف استراتيجية عروض الأسعار هذه في حملة التطبيقات إلى زيادة التسجيل المُسبَق للتطبيق إلى أقصى حدّ.

LowerTargetRoasRecommendation

اقتراح لخفض "عائد الإنفاق الإعلاني المستهدف".

تمثيل JSON 
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  }
}
الحقول
targetAdjustment

object (TargetAdjustmentInfo)

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

PerformanceMaxOptInRecommendation

لا يشتمل هذا النوع على أي حقول.

اقتراح تفعيل "حملات الأداء الأفضل"

ImprovePerformanceMaxAdStrengthRecommendation

اقتراح لتحسين قوة مجموعة مواد العرض في "حملة الأداء الأفضل" إلى تقييم "ممتاز"

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

string

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

MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

اقتراح نقل بيانات الإعلانات الديناميكية على شبكة البحث إلى "حملات الأداء الأفضل"

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

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

UserInterest

اهتمام المستخدم: قطاع معين يستند إلى الاهتمامات المطلوب استهدافه.

تمثيل JSON 
{
  "resourceName": string,
  "taxonomyType": enum (UserInterestTaxonomyType),
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ],
  "userInterestId": string,
  "name": string,
  "userInterestParent": string,
  "launchedToAll": boolean
}
الحقول
resourceName

string

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

customers/{customerId}/userInterests/{userInterestId}
taxonomyType

enum (UserInterestTaxonomyType)

النتائج فقط. تمثّل هذه السمة نوع التصنيف الذي يهتم به المستخدم.
availabilities[]

object (CriterionCategoryAvailability)

النتائج فقط. معلومات التوفّر التي تهم المستخدم
userInterestId

string (int64 format)

النتائج فقط. رقم تعريف اهتمامات المستخدِم.
name

string

النتائج فقط. اسم اهتمام المستخدِم.
userInterestParent

string

النتائج فقط. تمثّل هذه السمة مصدر اهتمام المستخدم.
launchedToAll

boolean

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

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

النتائج فقط. إعلان المجموعة الإعلانية المرتبط بنموذج العملاء المحتملين الذي تم إرساله
gclid

string

النتائج فقط. معرّف النقرة من Google المرتبط بنموذج العملاء المحتمَلين الذي تم إرسال طلبه
submissionDateTime

string

النتائج فقط. تاريخ ووقت إرسال نموذج العملاء المحتملين. التنسيق هو "yyyy-mm-dd hh:mm:ss+|-hh:mm"، على سبيل المثال، "01-01-2019 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 حرفًا.

المقاييس

بيانات المقاييس

تمثيل JSON 
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "skAdNetworkConversions": string,
  "publisherPurchasedClicks": string,
  "publisherOrganicClicks": string,
  "publisherUnknownClicks": string,
  "absoluteTopImpressionPercentage": number,
  "activeViewCpm": number,
  "activeViewCtr": number,
  "activeViewImpressions": string,
  "activeViewMeasurability": number,
  "activeViewMeasurableCostMicros": string,
  "activeViewMeasurableImpressions": string,
  "activeViewViewability": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allNewCustomerLifetimeValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "allConversionsFromStoreWebsite": number,
  "auctionInsightSearchAbsoluteTopImpressionPercentage": number,
  "auctionInsightSearchImpressionShare": number,
  "auctionInsightSearchOutrankingShare": number,
  "auctionInsightSearchOverlapRate": number,
  "auctionInsightSearchPositionAboveRate": number,
  "auctionInsightSearchTopImpressionPercentage": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpe": number,
  "averageCpm": number,
  "averageCpv": number,
  "averagePageViews": number,
  "averageTimeOnSite": number,
  "benchmarkAverageMaxCpc": number,
  "biddableAppInstallConversions": number,
  "biddableAppPostInstallConversions": number,
  "benchmarkCtr": number,
  "bounceRate": number,
  "clicks": string,
  "combinedClicks": string,
  "combinedClicksPerQuery": number,
  "combinedQueries": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "conversionLastReceivedRequestDateTime": string,
  "conversionLastConversionDate": string,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "conversionsValue": number,
  "newCustomerLifetimeValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "conversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "ctr": number,
  "currentModelAttributedConversions": number,
  "currentModelAttributedConversionsFromInteractionsRate": number,
  "currentModelAttributedConversionsFromInteractionsValuePerInteraction": number,
  "currentModelAttributedConversionsValue": number,
  "currentModelAttributedConversionsValuePerCost": number,
  "engagementRate": number,
  "engagements": string,
  "hotelAverageLeadValueMicros": number,
  "hotelCommissionRateMicros": string,
  "hotelExpectedCommissionCost": number,
  "hotelPriceDifferencePercentage": number,
  "hotelEligibleImpressions": string,
  "historicalQualityScore": string,
  "gmailForwards": string,
  "gmailSaves": string,
  "gmailSecondaryClicks": string,
  "impressionsFromStoreReach": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "messageChats": string,
  "messageImpressions": string,
  "messageChatRate": number,
  "mobileFriendlyClicksPercentage": number,
  "optimizationScoreUplift": number,
  "optimizationScoreUrl": string,
  "organicClicks": string,
  "organicClicksPerQuery": number,
  "organicImpressions": string,
  "organicImpressionsPerQuery": number,
  "organicQueries": string,
  "percentNewVisitors": number,
  "phoneCalls": string,
  "phoneImpressions": string,
  "phoneThroughRate": number,
  "relativeCtr": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "searchVolume": {
    object (SearchVolumeRange)
  },
  "speedScore": string,
  "averageTargetCpaMicros": string,
  "averageTargetRoas": number,
  "topImpressionPercentage": number,
  "validAcceleratedMobilePagesClicksPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "valuePerCurrentModelAttributedConversion": number,
  "videoQuartileP100Rate": number,
  "videoQuartileP25Rate": number,
  "videoQuartileP50Rate": number,
  "videoQuartileP75Rate": number,
  "videoViewRate": number,
  "videoViews": string,
  "viewThroughConversions": string,
  "allConversionsFromLocationAssetClickToCall": number,
  "allConversionsFromLocationAssetDirections": number,
  "allConversionsFromLocationAssetMenu": number,
  "allConversionsFromLocationAssetOrder": number,
  "allConversionsFromLocationAssetOtherEngagement": number,
  "allConversionsFromLocationAssetStoreVisits": number,
  "allConversionsFromLocationAssetWebsite": number,
  "eligibleImpressionsFromLocationAssetStoreReach": string,
  "viewThroughConversionsFromLocationAssetClickToCall": number,
  "viewThroughConversionsFromLocationAssetDirections": number,
  "viewThroughConversionsFromLocationAssetMenu": number,
  "viewThroughConversionsFromLocationAssetOrder": number,
  "viewThroughConversionsFromLocationAssetOtherEngagement": number,
  "viewThroughConversionsFromLocationAssetStoreVisits": number,
  "viewThroughConversionsFromLocationAssetWebsite": number
}
الحقول
allConversionsValueByConversionDate

number

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

number

إجمالي عدد التحويلات. ويتضمّن هذا جميع الإحالات الناجحة بصرف النظر عن قيمة includeIn ConversionsMetric. عند اختيار هذا العمود مع التاريخ، تشير القيم في عمود "التاريخ" إلى تاريخ الإحالة الناجحة. تتوفّر تفاصيل أعمدة by_conversion_date على https://support.google.com/google-ads/answer/9549009.
conversionsValueByConversionDate

number

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

number

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

enum (QualityScoreBucket)

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

enum (QualityScoreBucket)

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

enum (QualityScoreBucket)

نسبة النقر إلى الظهور (CTR) السابقة المتوقعة في البحث.
interactionEventTypes[]

enum (InteractionEventType)

أنواع التفاعلات المدفوعة والمجانية.
skAdNetworkConversions

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

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

number

إجمالي عدد التحويلات. ويتضمّن هذا جميع الإحالات الناجحة بصرف النظر عن قيمة includeIn ConversionsMetric.
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

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

number

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

number

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

number

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

number

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

number

عدد الإحالات الناجحة. ولا يشمل ذلك سوى إجراءات الإحالات الناجحة التي تم ضبط السمة includeIn ConversionsMetric عليها على "صحيح". وإذا كنت تستخدم عروض الأسعار المستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين هذه الإحالات الناجحة.
costMicros

string (int64 format)

مجموع تكلفة النقرة (CPC) والتكلفة لكل ألف ظهور (CPM) خلال هذه الفترة.
costPerAllConversions

number

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

number

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

number

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

number

الإحالات الناجحة التي يتم تسجيلها عندما ينقر العميل على إعلان على "إعلانات Google" من أحد الأجهزة، ثم يُجري إحالة ناجحة على جهاز أو متصفّح آخر سبق أن تم تضمين الإحالات الناجحة باستخدام أكثر من جهاز واحد في جميع الإحالات الناجحة.
ctr

number

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

number

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

number

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

number

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

number

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

number

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

عدد محادثات الرسائل التي بدأت (messageChat) مقسومًا على عدد مرات ظهور الرسائل (مرات ظهور الرسائل). معدّل بدء المستخدِم لمحادثة بعد ظهور إعلان مع تفعيل خيار المراسلة وتتبُّع الرسائل. تجدر الإشارة إلى أنّ هذا المعدّل يمكن أن يزيد عن 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, optionType).
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

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

number

نسبة النقر إلى الظهور مقسومًا على متوسط نسبة النقر إلى الظهور لجميع المعلنين على المواقع الإلكترونية التي تعرض إعلاناتك. يقيس مستوى أداء إعلاناتك على مواقع الشبكة الإعلانية مقارنة بالإعلانات الأخرى على نفس المواقع.
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

قيمة الإحالات الناجحة مقسومة على عدد الإحالات الناجحة. ولا يشمل ذلك سوى إجراءات الإحالات الناجحة التي تم ضبط السمة includeIn ConversionsMetric عليها على "صحيح". وإذا كنت تستخدم عروض الأسعار المستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين هذه الإحالات الناجحة.
valuePerConversionsByConversionDate

number

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

number

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

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),
  "newVersusReturningCustomers": enum (ConvertingUserPriorEngagementTypeAndLtvBucket),
  "activityAccountId": string,
  "activityRating": string,
  "externalActivityId": string,
  "adGroup": string,
  "assetGroup": string,
  "auctionInsightDomain": string,
  "campaign": string,
  "conversionAction": string,
  "conversionActionName": string,
  "conversionAdjustment": boolean,
  "date": string,
  "geoTargetAirport": string,
  "geoTargetCanton": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetCounty": string,
  "geoTargetDistrict": string,
  "geoTargetMetro": string,
  "geoTargetMostSpecificLocation": string,
  "geoTargetPostalCode": string,
  "geoTargetProvince": string,
  "geoTargetRegion": string,
  "geoTargetState": string,
  "hotelBookingWindowDays": string,
  "hotelCenterId": string,
  "hotelCheckInDate": string,
  "hotelCity": string,
  "hotelClass": integer,
  "hotelCountry": string,
  "hotelLengthOfStay": integer,
  "hotelRateRuleId": string,
  "hotelState": string,
  "hour": integer,
  "interactionOnThisExtension": boolean,
  "month": string,
  "partnerHotelId": string,
  "productAggregatorId": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productFeedLabel": string,
  "productItemId": string,
  "productLanguage": string,
  "productMerchantId": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "searchSubcategory": string,
  "searchTerm": string,
  "webpage": string,
  "week": string,
  "year": integer,
  "skAdNetworkConversionValue": string,
  "skAdNetworkSourceApp": {
    object (SkAdNetworkSourceApp)
  },
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
الحقول
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_CODE_APPLIED إجمالي القيمة المسجّلة للإحالات الناجحة التي لم يتمّ تطبيق قاعدة قيمة لها. يعرض الحقل "ORIGINAL" القيمة الأصلية للإحالات الناجحة التي تم تطبيق قاعدة قيمة عليها. يعرض Geo_LOCATION وDEVICE وAUDIENCE صافي التعديل بعد تطبيق قواعد القيمة.
skAdNetworkUserType

enum (SkAdNetworkUserType)

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

enum (SkAdNetworkAdEventType)

نوع حدث الإعلان على شبكة إعلانات iOS Store Kit.
skAdNetworkAttributionCredit

enum (SkAdNetworkAttributionCredit)

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

enum (ConvertingUserPriorEngagementTypeAndLtvBucket)

وهذا المقياس لتقسيم الإحالات الناجحة حسب ما إذا كان المستخدم عميلاً جديدًا أم عميلاً متكررًا. يُستخدم هذا التصنيف عادةً لقياس تأثير هدف اكتساب العملاء.
activityAccountId

string (int64 format)

رقم تعريف حساب النشاط
activityRating

string (int64 format)

تقييم النشاط
externalActivityId

string

رقم تعريف النشاط المقدَّم من المعلِن
adGroup

string

اسم مورد المجموعة الإعلانية.
assetGroup

string

اسم المورد لمجموعة مواد العرض
auctionInsightDomain

string

النطاق (عنوان URL المرئي) لأحد المشاركين في تقرير مؤشرات مزاد الإعلانات.
campaign

string

اسم مورد الحملة
conversionAction

string

اسم مورد إجراء الإحالة الناجحة.
conversionActionName

string

اسم إجراء الإحالة الناجحة
conversionAdjustment

boolean

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

رقم تعريف العارض للمنتج.
productBiddingCategoryLevel1

string

فئة عروض الأسعار (المستوى 1) للمنتج.
productBiddingCategoryLevel2

string

فئة عروض الأسعار (المستوى 2) للمنتج.
productBiddingCategoryLevel3

string

فئة عروض الأسعار (المستوى 3) للمنتج.
productBiddingCategoryLevel4

string

فئة عروض الأسعار (المستوى 4) للمنتج.
productBiddingCategoryLevel5

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 في 1-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 StoreKit. تعني القيمة "فارغ" أنّ هذه الشريحة غير قابلة للتطبيق، مثل حملة لا تستخدم نظام التشغيل iOS، أو أنّها لم تكن متوفّرة في أيّ عمليات إبلاغ عن الإحالات الناجحة أرسلتها شركة Apple.
assetInteractionTarget

object (AssetInteractionTarget)

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

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 للشبكة الإعلانية.
YOUTUBE_WATCH فيديوهات YouTube
MIXED الشبكة المتقاطعة.

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 التسوّق - المنتج - محلي.
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 الإحالات الناجحة القديمة للتطبيقات التي لم يتم توفير AppPlatform فيها، يتم عرضها في واجهة مستخدم "إعلانات 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" (إعلانات شبكة البحث 360).
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

اسم مورد معيار المجموعة الإعلانية

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 مؤهّلة للإحالة، لكنها لم تفوز.

AssetInteractionTarget

شريحة AssetInteractionTarget.

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

string

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

boolean

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

ConvertingUserPriorEngagementTypeAndLtvBucket

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

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