- تمثيل JSON
- AdGroup
- AdGroupStatus
- AdGroupType
- AdGroupAdRotationMode
- AdGroupEngineStatus
- TargetingSetting
- TargetRestriction
- TargetingDimension
- AdGroupAd
- AdGroupAdStatus
- الإعلان
- AdType
- SearchAds360TextAdInfo
- SearchAds360ExpandedTextAdInfo
- SearchAds360ResponsiveSearchAdInfo
- SearchAds360ProductAdInfo
- SearchAds360ExpandedDynamicSearchAdInfo
- في "إعلانات شبكة البحث 360"
- تمثيل JSON
- AdGroupAdEngineStatus
- AdGroupAdLabel
- AdGroupAsset
- AssetLinkStatus
- AdGroupAssetSet
- AssetSetLinkStatus
- AdGroupAudienceView
- AdGroupBidModifier
- DeviceInfo
- الجهاز
- AdGroupCriterion
- AdGroupCriterionStatus
- QualityInfo
- CriterionType
- PositionEstimates
- AdGroupCriterionEngineStatus
- KeywordInfo
- KeywordMatchType
- ListingGroupInfo
- ListingGroupType
- AgeRangeInfo
- AgeRangeType
- GenderInfo
- GenderType
- UserListInfo
- WebpageInfo
- WebpageConditionInfo
- WebpageConditionOperand
- WebpageConditionOperator
- LocationInfo
- AdGroupCriterionLabel
- AdGroupLabel
- AgeRangeView
- مادة العرض
- AssetType
- AssetStatus
- AssetEngineStatus
- YoutubeVideoAsset
- ImageAsset
- MimeType
- ImageDimension
- TextAsset
- UnifiedCalloutAsset
- AdScheduleInfo
- MinuteOfHour
- DayOfWeek
- UnifiedSitelinkAsset
- UnifiedPageFeedAsset
- MobileAppAsset
- MobileAppVendor
- UnifiedCallAsset
- CallConversionReportingState
- CallToActionAsset
- CallToActionType
- UnifiedLocationAsset
- BusinessProfileLocation
- LocationOwnershipType
- AssetGroupAsset
- AssetFieldType
- AssetGroupSignal
- AudienceInfo
- AssetGroupListingGroupFilter
- ListingGroupFilterType
- ListingGroupFilterVertical
- ListingGroupFilterDimension
- ProductBiddingCategory
- ListingGroupFilterBiddingCategoryLevel
- ProductBrand
- ProductChannel
- ListingGroupFilterProductChannel
- ProductCondition
- ListingGroupFilterProductCondition
- ProductCustomAttribute
- ListingGroupFilterCustomAttributeIndex
- ProductItemId
- ProductType
- ListingGroupFilterProductTypeLevel
- ListingGroupFilterDimensionPath
- AssetGroupTopCombinationView
- AssetGroupAssetCombinationData
- AssetUsage
- ServedAssetFieldType
- AssetGroup
- AssetGroupStatus
- AdStrength
- AssetSetAsset
- AssetSetAssetStatus
- AssetSet
- BiddingStrategy
- BiddingStrategyStatus
- BiddingStrategyType
- EnhancedCpc
- MaximizeConversionValue
- MaximizeConversions
- TargetCpa
- TargetImpressionShare
- TargetImpressionShareLocation
- TargetOutrankShare
- TargetRoas
- TargetSpend
- CampaignBudget
- BudgetDeliveryMethod
- BudgetPeriod
- الحملة
- CampaignStatus
- CampaignServingStatus
- BiddingStrategySystemStatus
- AdServingOptimizationStatus
- AdvertisingChannelType
- AdvertisingChannelSubType
- CustomParameter
- RealTimeBiddingSetting
- NetworkSettings
- DynamicSearchAdsSetting
- ShoppingSetting
- GeoTargetTypeSetting
- PositiveGeoTargetType
- NegativeGeoTargetType
- FrequencyCapEntry
- SelectiveOptimization
- OptimizationGoalSetting
- OptimizationGoalType
- TrackingSetting
- ManualCpa
- ManualCpc
- ManualCpm
- PercentCpc
- TargetCpm
- CampaignAsset
- CampaignAssetSet
- CampaignAudienceView
- CampaignCriterion
- CampaignCriterionStatus
- LanguageInfo
- LocationGroupInfo
- LocationGroupRadiusUnits
- CampaignLabel
- CartDataSalesView
- الجمهور
- ConversionAction
- ConversionActionStatus
- ConversionActionType
- ConversionActionCategory
- ValueSettings
- AttributionModelSettings
- AttributionModel
- DataDrivenModelStatus
- FloodlightSettings
- ConversionCustomVariable
- ConversionCustomVariableStatus
- ConversionCustomVariableFamily
- ConversionCustomVariableCardinality
- FloodlightConversionCustomVariableInfo
- FloodlightVariableType
- FloodlightVariableDataType
- العميل
- ConversionTrackingSetting
- ConversionTrackingStatus
- AccountType
- DoubleClickCampaignManagerSetting
- AccountStatus
- CustomerStatus
- CustomerAsset
- CustomerAssetSet
- AccessibleBiddingStrategy
- MaximizeConversionValue
- MaximizeConversions
- TargetCpa
- TargetImpressionShare
- TargetRoas
- TargetSpend
- CustomerManagerLink
- ManagerLinkStatus
- CustomerClient
- DynamicSearchAdsSearchTermView
- GenderView
- GeoTargetConstant
- GeoTargetConstantStatus
- KeywordView
- التصنيف
- LabelStatus
- TextLabel
- LanguageConstant
- LocationView
- ProductBiddingCategoryConstant
- ProductBiddingCategoryLevel
- ProductBiddingCategoryStatus
- ProductGroupView
- ShoppingPerformanceView
- UserList
- UserListType
- WebpageView
- انتقال
- ProductChannel
- الإحالة الناجحة
- AttributionType
- ConversionStatus
- المقاييس
- القيمة
- QualityScoreBucket
- InteractionEventType
- الشرائح
- AdNetworkType
- الكلمة الرئيسية
- ProductChannelExclusivity
- ProductCondition
- AssetInteractionTarget
صف تم عرضه من الاستعلام.
تمثيل JSON |
---|
{ "adGroup": { object ( |
الحقول | |
---|---|
adGroup |
المجموعة الإعلانية المشار إليها في طلب البحث. |
adGroupAd |
الإعلان المشار إليه في طلب البحث. |
adGroupAdLabel |
تصنيف إعلان المجموعة الإعلانية المشار إليه في طلب البحث. |
adGroupAsset |
مادة عرض المجموعة الإعلانية المُشار إليها في طلب البحث. |
adGroupAssetSet |
مجموعة مواد عرض المجموعة الإعلانية المُشار إليها في طلب البحث. |
adGroupAudienceView |
طريقة عرض الجمهور على مستوى المجموعة الإعلانية المُشار إليها في طلب البحث. |
adGroupBidModifier |
معدِّل عروض الأسعار المشار إليه في طلب البحث. |
adGroupCriterion |
المعيار المشار إليه في طلب البحث. |
adGroupCriterionLabel |
تصنيف معيار المجموعة الإعلانية المشار إليه في طلب البحث. |
adGroupLabel |
تصنيف المجموعة الإعلانية المشار إليه في طلب البحث. |
ageRangeView |
عرض الفئة العمرية المُشار إليها في طلب البحث. |
asset |
مادة العرض المُشار إليها في طلب البحث. |
assetGroupAsset |
مادة عرض مجموعة مواد العرض المُشار إليها في طلب البحث. |
assetGroupSignal |
إشارة مجموعة مواد العرض المُشار إليها في طلب البحث. |
assetGroupListingGroupFilter |
فلتر مجموعة البيانات في مجموعة مواد العرض المُشار إليها في طلب البحث. |
assetGroupTopCombinationView |
عرض مجموعة مواد العرض الأعلى في مجموعة مواد العرض المُشار إليها في طلب البحث |
assetGroup |
مجموعة مواد العرض المُشار إليها في طلب البحث. |
assetSetAsset |
مادة عرض مجموعة مواد العرض المُشار إليها في طلب البحث. |
assetSet |
مجموعة مواد العرض المُشار إليها في طلب البحث. |
biddingStrategy |
استراتيجية عروض الأسعار المشار إليها في طلب البحث. |
campaignBudget |
ميزانية الحملة المشار إليها في طلب البحث. |
campaign |
الحملة المشار إليها في طلب البحث. |
campaignAsset |
مادة عرض الحملة المُشار إليها في طلب البحث. |
campaignAssetSet |
مجموعة مواد عرض الحملة المُشار إليها في طلب البحث. |
campaignAudienceView |
مشاهدة جمهور الحملة المُشار إليها في طلب البحث. |
campaignCriterion |
معيار الحملة المشار إليه في طلب البحث. |
campaignLabel |
تصنيف الحملة المشار إليه في طلب البحث. |
cartDataSalesView |
الملف الشخصي للمبيعات في بيانات سلة التسوّق المُشار إليه في طلب البحث. |
audience |
الجمهور المشار إليه في طلب البحث. |
conversionAction |
إجراء الإحالة الناجحة المشار إليه في طلب البحث. |
conversionCustomVariable |
المتغيّر المخصَّص للإحالة الناجحة المشار إليه في طلب البحث. |
customer |
العميل المشار إليه في الطلب. |
customerAsset |
مادة عرض العميل المُشار إليها في طلب البحث. |
customerAssetSet |
مجموعة مواد عرض العميل المُشار إليها في طلب البحث. |
accessibleBiddingStrategy |
استراتيجية عروض الأسعار التي يمكن الوصول إليها المُشار إليها في طلب البحث. |
customerManagerLink |
CustomerManagerLink المشار إليه في طلب البحث. |
customerClient |
CustomerClient المشار إليه في الطلب. |
dynamicSearchAdsSearchTermView |
عرض عبارة البحث للإعلانات الديناميكية على شبكة البحث المُشار إليها في طلب البحث. |
genderView |
عرض الجنس المُشار إليه في طلب البحث. |
geoTargetConstant |
ثابت الهدف الجغرافي المُشار إليه في طلب البحث. |
keywordView |
عرض الكلمة الرئيسية المشار إليها في طلب البحث. |
label |
التصنيف المشار إليه في طلب البحث. |
languageConstant |
تمثّل هذه السمة الثابت اللغوي المُشار إليه في طلب البحث. |
locationView |
عرض الموقع الجغرافي المُشار إليه في طلب البحث. |
productBiddingCategoryConstant |
فئة عروض أسعار المنتج المُشار إليها في طلب البحث. |
productGroupView |
عرض مجموعة المنتجات المشار إليها في طلب البحث. |
shoppingPerformanceView |
عرض أداء التسوّق المُشار إليه في طلب البحث. |
userList |
قائمة المستخدمين المشار إليها في طلب البحث. |
webpageView |
عرض صفحة الويب المُشار إليه في طلب البحث. |
visit |
الزيارة على مستوى الحدث المُشار إليها في طلب البحث. |
conversion |
الإحالة الناجحة على مستوى الحدث المُشار إليها في طلب البحث. |
metrics |
المقاييس |
segments |
الشرائح |
customColumns[] |
الأعمدة المخصّصة. |
AdGroup
مجموعة إعلانية.
تمثيل JSON |
---|
{ "resourceName": string, "status": enum ( |
الحقول | |
---|---|
resourceName |
اسم مورد المجموعة الإعلانية. وتكون أسماء موارد المجموعة الإعلانية على النحو التالي:
|
status |
حالة المجموعة الإعلانية. |
type |
نوع المجموعة الإعلانية. |
adRotationMode |
وضع عرض الإعلانات بالتناوب للمجموعة الإعلانية. |
creationTime |
الطابع الزمني عند إنشاء هذه المجموعة الإعلانية. يكون الطابع الزمني حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss". |
targetingSetting |
إعداد لاستهداف الميزات ذات الصلة. |
labels[] |
أسماء الموارد للتصنيفات المرفقة بهذه المجموعة الإعلانية. |
engineId |
رقم تعريف المجموعة الإعلانية في حساب محرّك البحث الخارجي هذا الحقل مخصّص للحسابات غير التابعة لخدمة "إعلانات Google" فقط، مثل Yahoo Japan أو Microsoft أو Baidu أو ما إلى ذلك. وبالنسبة إلى كيان "إعلانات Google"، استخدِم "adGroup.id" بدلاً من ذلك. |
startDate |
تاريخ بدء هذه المجموعة الإعلانية في عرض الإعلانات. بشكلٍ افتراضي، تبدأ المجموعة الإعلانية الآن أو تاريخ بدء المجموعة الإعلانية، أيهما أبعد. إذا تم إعداد هذا الحقل، ستبدأ المجموعة الإعلانية في بداية التاريخ المحدّد في المنطقة الزمنية للعميل. هذا الحقل متاح فقط لحسابات بوابة Microsoft Advertising وFacebook. التنسيق: YYYY-MM-DD مثال: 14-03-2019 |
endDate |
تاريخ انتهاء المجموعة الإعلانية من عرض الإعلانات. بشكل افتراضي، تنتهي المجموعة الإعلانية في تاريخ انتهاء المجموعة الإعلانية. إذا تم ضبط هذا الحقل، ستنتهي المجموعة الإعلانية بنهاية التاريخ المحدّد في المنطقة الزمنية للعميل. هذا الحقل متاح فقط لحسابات بوابة Microsoft Advertising وFacebook. التنسيق: YYYY-MM-DD مثال: 14-03-2019 |
languageCode |
لغة الإعلانات والكلمات الرئيسية في المجموعة الإعلانية. هذا الحقل متاح فقط لحسابات Microsoft Advertising. مزيد من التفاصيل: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage |
lastModifiedTime |
تاريخ آخر تعديل لهذه المجموعة الإعلانية. يتم تحديد التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ssssss". |
id |
رقم تعريف المجموعة الإعلانية. |
name |
اسم المجموعة هذا الحقل مطلوب ويجب ألا يكون فارغًا عند إنشاء مجموعات إعلانية جديدة. ويجب أن يحتوي على أقل من 255 حرفًا بالعرض الكامل لترميز UTF-8. ويجب ألا يحتوي على أي أحرف فارغة (نقطة الرمز 0x0) أو خلاصة سطر NL (نقطة الرمز 0xA) أو أحرف الرجوع إلى أول السطر (رمز النقطة 0xD). |
cpcBidMicros |
عرض السعر الأقصى للنقرة. |
engineStatus |
حالة محرّك البحث للمجموعة الإعلانية. |
AdGroupStatus
الحالات المحتملة للمجموعة الإعلانية.
عمليات التعداد | |
---|---|
UNSPECIFIED |
لم يتمّ تحديد الحالة. |
UNKNOWN |
القيمة المُستلَمة غير معروفة في هذا الإصدار. هذه قيمة للاستجابة فقط. |
ENABLED |
المجموعة الإعلانية مفعّلة. |
PAUSED |
المجموعة الإعلانية متوقفة مؤقتًا. |
REMOVED |
تتم إزالة المجموعة الإعلانية. |
AdGroupType
يشير هذا المقياس إلى قيم التعداد التي تسرد الأنواع المحتملة لمجموعة إعلانية.
عمليات التعداد | |
---|---|
UNSPECIFIED |
لم يتم تحديد النوع. |
UNKNOWN |
القيمة المُستلَمة غير معروفة في هذا الإصدار. هذه قيمة للاستجابة فقط. |
SEARCH_STANDARD |
النوع التلقائي للمجموعة الإعلانية للحملات على شبكة البحث. |
DISPLAY_STANDARD |
النوع التلقائي للمجموعة الإعلانية لـ "الحملات على الشبكة الإعلانية". |
SHOPPING_PRODUCT_ADS |
نوع المجموعة الإعلانية لحملات التسوّق التي تعرض إعلانات منتجات عادية. |
SHOPPING_SHOWCASE_ADS |
نوع المجموعات الإعلانية الذي يقتصر على عرض إعلانات واجهة العرض أو إعلانات التجّار في نتائج Shopping. |
HOTEL_ADS |
النوع التلقائي للمجموعة الإعلانية لحملات الفنادق. |
SHOPPING_SMART_ADS |
نوع المجموعات الإعلانية في حملات Shopping الذكية. |
VIDEO_BUMPER |
الإعلانات القصيرة غير القابلة للتخطي أثناء عرض الفيديو. |
VIDEO_TRUE_VIEW_IN_STREAM |
إعلانات فيديو TrueView (القابلة للتخطي) أثناء عرض الفيديو. |
VIDEO_TRUE_VIEW_IN_DISPLAY |
إعلانات فيديو TrueView ضمن العرض. |
VIDEO_NON_SKIPPABLE_IN_STREAM |
الإعلانات غير القابلة للتخطي أثناء عرض الفيديو. |
VIDEO_OUTSTREAM |
الإعلانات خارج بث الفيديو. |
SEARCH_DYNAMIC_ADS |
نوع المجموعة الإعلانية للمجموعات الإعلانية للإعلانات الديناميكية على شبكة البحث. |
SHOPPING_COMPARISON_LISTING_ADS |
نوع المجموعات الإعلانية في حملات بيانات المقارنة على Shopping. |
PROMOTED_HOTEL_ADS |
نوع المجموعة الإعلانية للمجموعات الإعلانية للفنادق التي يتم الترويج لها. |
VIDEO_RESPONSIVE |
المجموعات الإعلانية المتجاوبة للفيديو. |
VIDEO_EFFICIENT_REACH |
المجموعات الإعلانية لمدى الوصول الفعّال للفيديو |
SMART_CAMPAIGN_ADS |
نوع المجموعة الإعلانية للحملات الذكية. |
TRAVEL_ADS |
نوع المجموعة الإعلانية لـ "حملات السفر". |
AdGroupAdRotationMode
أوضاع عرض الإعلانات بالتناوب الممكنة لإحدى المجموعات الإعلانية.
عمليات التعداد | |
---|---|
UNSPECIFIED |
لم يتم تحديد وضع عرض الإعلانات بالتناوب. |
UNKNOWN |
القيمة المُستلَمة غير معروفة في هذا الإصدار. هذه قيمة للاستجابة فقط. |
OPTIMIZE |
حسِّن إعلانات المجموعة الإعلانية استنادًا إلى النقرات أو الإحالات الناجحة. |
ROTATE_FOREVER |
عرض الإعلانات بالتناوب بشكل متساوٍ إلى الأبد. |
AdGroupEngineStatus
حالة محرّك المجموعة الإعلانية.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
AD_GROUP_ELIGIBLE |
تمّ الإيقاف. يُرجى عدم الاستخدام. |
AD_GROUP_EXPIRED |
لا يتم عرض أي إعلانات لهذه المجموعة الإعلانية، لأن تاريخ انتهاء المجموعة الإعلانية قد انقضى. |
AD_GROUP_REMOVED |
تم حذف المجموعة الإعلانية. |
AD_GROUP_DRAFT |
لا يتم عرض أي إعلانات لهذه المجموعة الإعلانية لأن المجموعة الإعلانية المرتبطة بها لا تزال في شكل مسودة. |
AD_GROUP_PAUSED |
تم إيقاف المجموعة الإعلانية مؤقتًا. |
AD_GROUP_SERVING |
المجموعة الإعلانية نشطة وتعرض إعلانات حاليًا. |
AD_GROUP_SUBMITTED |
تم إرسال المجموعة الإعلانية (الحالة القديمة لإعلانات Microsoft Bing). |
CAMPAIGN_PAUSED |
لا يتم عرض أي إعلانات لهذه المجموعة الإعلانية، لأنه تم إيقاف الحملة مؤقتًا. |
ACCOUNT_PAUSED |
لا يتم عرض أي إعلانات لهذه المجموعة الإعلانية؛ لأنه تم إيقاف الحساب مؤقتًا. |
TargetingSetting
إعدادات الميزات المرتبطة بالاستهداف، على مستوى الحملة والمجموعة الإعلانية لمزيد من التفاصيل عن إعداد الاستهداف، يُرجى زيارة https://support.google.com/google-ads/answer/7365594
تمثيل JSON |
---|
{
"targetRestrictions": [
{
object ( |
الحقول | |
---|---|
targetRestrictions[] |
الإعداد لكل سمة استهداف لتقييد مدى وصول حملتك أو مجموعتك الإعلانية |
TargetRestriction
قائمة إعدادات الاستهداف لكل سمة استهداف.
تمثيل JSON |
---|
{
"targetingDimension": enum ( |
الحقول | |
---|---|
targetingDimension |
سمة الاستهداف التي تنطبق عليها هذه الإعدادات. |
bidOnly |
تشير إلى ما إذا كان سيتم تقييد عرض إعلاناتك فقط للمعايير التي اخترتها لبُعد الاستهداف هذا، أو استهداف جميع القيم لبُعد الاستهداف هذا وعرض الإعلانات استنادًا إلى استهدافك في أبعاد استهداف أخرى. تعني القيمة |
TargetingDimension
رقم يصف أبعاد الاستهداف المحتملة.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
KEYWORD |
معايير الكلمات الرئيسية، مثل "رحلة بحرية على المريخ". ويمكن استخدام الكلمة الرئيسية كسمة عرض أسعار مخصّصة. تعتبر الكلمات الرئيسية دائمًا سمة استهداف، لذلك لا يمكن ضبطها على أنّها سمة "الكل" المستهدفة باستخدام TargetRestriction. |
AUDIENCE |
معايير الجمهور، والتي تشمل قائمة المستخدمين، واهتمامات المستخدمين، وجمهور مخصّص ذي اهتمامات مشتركة، وجمهور مخصّص في السوق. |
TOPIC |
معايير الموضوع لاستهداف فئات المحتوى، مثل "الفئة::حيوانات>حيوانات أليفة" مستخدَمة لاستهداف الشبكة الإعلانية والفيديو |
GENDER |
معايير استهداف الجنس. |
AGE_RANGE |
معايير استهداف الفئات العمرية. |
PLACEMENT |
معايير الموضع التي تشمل مواقع الويب مثل "www.flowers4sale.com"، بالإضافة إلى تطبيقات الأجهزة الجوّالة، وفئات تطبيقات الأجهزة الجوّالة، وفيديوهات YouTube، وقنوات YouTube. |
PARENTAL_STATUS |
معايير استهداف الحالة الأبوية. |
INCOME_RANGE |
معايير استهداف نطاق الدخل. |
AdGroupAd
إعلان مجموعة إعلانية.
تمثيل JSON |
---|
{ "resourceName": string, "status": enum ( |
الحقول | |
---|---|
resourceName |
اسم مورد الإعلان. وتكون أسماء موارد الإعلانات في المجموعة الإعلانية على النحو التالي:
|
status |
حالة الإعلان. |
ad |
الإعلان |
creationTime |
الطابع الزمني لوقت إنشاء إعلان المجموعة الإعلانية هذا. يتم تحديد التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ssssss". |
labels[] |
أسماء الموارد للتصنيفات المرفقة بإعلان المجموعة الإعلانية هذا. |
engineId |
رقم تعريف الإعلان في حساب محرّك البحث الخارجي هذا الحقل مخصّص لحساب "إعلانات شبكة البحث 360" فقط، مثل Yahoo Japan وMicrosoft وBidu وما إلى ذلك. وبالنسبة إلى الكيانات غير التابعة لـ "إعلانات شبكة البحث 360"، يمكنك استخدام "adGroupAd.ad.id" بدلاً من ذلك. |
engineStatus |
حالة إضافية للإعلان في حساب محرّك البحث الخارجي تشمل الحالات المحتملة (حسب نوع الحساب الخارجي) الحالة "نشط" أو "مؤهَّل" أو "في انتظار المراجعة"، وما إلى ذلك. |
lastModifiedTime |
تاريخ آخر تعديل تم إجراؤه على إعلان المجموعة الإعلانية هذا. يتم تحديد التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ssssss". |
AdGroupAdStatus
الحالات المحتملة لإعلان مجموعة إعلانية.
عمليات التعداد | |
---|---|
UNSPECIFIED |
لم يتم تحديد قيمة. |
UNKNOWN |
القيمة المُستلَمة غير معروفة في هذا الإصدار. هذه قيمة للاستجابة فقط. |
ENABLED |
إعلان المجموعة الإعلانية مفعّل. |
PAUSED |
إعلان المجموعة الإعلانية متوقف مؤقتًا. |
REMOVED |
تتم إزالة إعلان المجموعة الإعلانية. |
إعلان
إعلان
تمثيل JSON |
---|
{ "resourceName": string, "finalUrls": [ string ], "type": enum ( |
الحقول | |
---|---|
resourceName |
اسم مورد الإعلان. وتكون أسماء موارد الإعلانات على النحو التالي:
|
finalUrls[] |
قائمة عناوين URL النهائية المحتملة بعد جميع عمليات إعادة التوجيه عبر النطاقات للإعلان. |
type |
نوع الإعلان. |
id |
رقم تعريف الإعلان. |
displayUrl |
عنوان URL الذي يظهر في وصف الإعلان لبعض أشكال الإعلانات. |
name |
اسم الإعلان. يُستخدم هذا الإجراء فقط لتحديد الإعلان. ولا يلزم أن تكون فريدة ولا تؤثر في الإعلان المعروض. حقل الاسم متوافق حاليًا فقط مع DisplayUploadAd وImageAd وShoppingComparisonListingAd وVideoAd. |
حقل الاتحاد ad_data تفاصيل ذات صلة بنوع الإعلان يجب ضبط قيمة واحدة بالضبط. يمكن أن يكون الحقل "ad_data " واحدًا فقط مما يلي: |
|
textAd |
التفاصيل المتعلّقة بإعلان نصي. |
expandedTextAd |
التفاصيل المتعلّقة بإعلان نصي موسَّع |
responsiveSearchAd |
تفاصيل مرتبطة بإعلان متجاوب على شبكة البحث. |
productAd |
التفاصيل المتعلّقة بإعلان منتج. |
expandedDynamicSearchAd |
التفاصيل المتعلّقة بإعلان ديناميكي موسَّع على شبكة البحث |
AdType
تمثّل هذه السمة الأنواع الممكنة من الإعلان.
عمليات التعداد | |
---|---|
UNSPECIFIED |
لم يتم تحديد قيمة. |
UNKNOWN |
القيمة المُستلَمة غير معروفة في هذا الإصدار. هذه قيمة للاستجابة فقط. |
TEXT_AD |
الإعلان عبارة عن إعلان نصي. |
EXPANDED_TEXT_AD |
الإعلان عبارة عن إعلان نصي موسَّع. |
CALL_ONLY_AD |
الإعلان عبارة عن إعلان للاتصال فقط. |
EXPANDED_DYNAMIC_SEARCH_AD |
الإعلان هو إعلان ديناميكي موسّع على شبكة البحث. |
HOTEL_AD |
الإعلان هو إعلان فندق. |
SHOPPING_SMART_AD |
الإعلان هو إعلان Shopping ذكي. |
SHOPPING_PRODUCT_AD |
يُعتبر الإعلان إعلان Shopping عاديًا. |
VIDEO_AD |
الإعلان هو إعلان فيديو. |
GMAIL_AD |
هذا الإعلان إعلان على Gmail. |
IMAGE_AD |
هذا الإعلان عبارة عن إعلان مصوّر. |
RESPONSIVE_SEARCH_AD |
الإعلان عبارة عن إعلان متجاوب على شبكة البحث. |
LEGACY_RESPONSIVE_DISPLAY_AD |
الإعلان هو إعلان صوري متجاوب قديم. |
APP_AD |
الإعلان هو إعلان تطبيق. |
LEGACY_APP_INSTALL_AD |
الإعلان عبارة عن إعلان قديم لتثبيت التطبيق. |
RESPONSIVE_DISPLAY_AD |
يُعتبر الإعلان إعلانًا صوريًا متجاوبًا. |
LOCAL_AD |
الإعلان محلي. |
HTML5_UPLOAD_AD |
الإعلان عبارة عن إعلان صوري من نوع المنتج HTML5_UPLOAD_AD. |
DYNAMIC_HTML5_AD |
الإعلان عبارة عن إعلان صوري لتحميل الصور باستخدام أحد أنواع المنتجات DYNAMIC_HTML5_*. |
APP_ENGAGEMENT_AD |
الإعلان هو إعلان جذب إلى تطبيق. |
SHOPPING_COMPARISON_LISTING_AD |
الإعلان هو إعلان مقارنة على Shopping. |
VIDEO_BUMPER_AD |
إعلان ملصق صغير للفيديو. |
VIDEO_NON_SKIPPABLE_IN_STREAM_AD |
إعلان فيديو غير قابل للتخطي أثناء عرض الفيديو. |
VIDEO_OUTSTREAM_AD |
إعلان فيديو خارج البث |
VIDEO_TRUEVIEW_DISCOVERY_AD |
إعلان فيديو TrueView ضمن العرض. |
VIDEO_TRUEVIEW_IN_STREAM_AD |
إعلان فيديو TrueView أثناء عرض الفيديو. |
VIDEO_RESPONSIVE_AD |
إعلان فيديو متجاوب. |
SMART_CAMPAIGN_AD |
إعلان حملة ذكية. |
APP_PRE_REGISTRATION_AD |
إعلان تسجيل مُسبَق لتطبيقات عامة. |
DISCOVERY_MULTI_ASSET_AD |
إعلان متعدد مواد العرض أثناء التصفّح. |
DISCOVERY_CAROUSEL_AD |
إعلان متبدّل أثناء التصفّح. |
TRAVEL_AD |
إعلان سفر. |
DISCOVERY_VIDEO_RESPONSIVE_AD |
إعلان متجاوب للفيديو أثناء التصفّح |
SearchAds360TextAdInfo
إعلان نصي في "إعلانات شبكة البحث 360".
تمثيل JSON |
---|
{ "headline": string, "description1": string, "description2": string, "displayUrl": string, "displayMobileUrl": string, "adTrackingId": string } |
الحقول | |
---|---|
headline |
عنوان الإعلان. |
description1 |
السطر الأول من وصف الإعلان. |
description2 |
السطر الثاني من وصف الإعلان. |
displayUrl |
عنوان URL المعروض للإعلان. |
displayMobileUrl |
عنوان URL المعروض للأجهزة الجوّالة الخاص بالإعلان. |
adTrackingId |
رقم تعريف تتبّع الإعلان. |
SearchAds360ExpandedTextAdInfo
إعلان نصي موسَّع في "إعلانات شبكة البحث 360"
تمثيل JSON |
---|
{ "headline": string, "headline2": string, "headline3": string, "description1": string, "description2": string, "path1": string, "path2": string, "adTrackingId": string } |
الحقول | |
---|---|
headline |
عنوان الإعلان. |
headline2 |
العنوان الثاني للإعلان. |
headline3 |
العنوان الثالث للإعلان. |
description1 |
السطر الأول من وصف الإعلان. |
description2 |
السطر الثاني من وصف الإعلان. |
path1 |
تم إلحاق نص بعنوان URL المرئي الذي تم إنشاؤه تلقائيًا مع محدِّد. |
path2 |
تم إلحاق النص بالمسار 1 باستخدام محدِّد. |
adTrackingId |
رقم تعريف تتبّع الإعلان. |
SearchAds360ResponsiveSearchAdInfo
إعلان متجاوب على شبكة البحث في "إعلانات شبكة البحث 360".
تمثيل JSON |
---|
{ "path1": string, "path2": string, "adTrackingId": string } |
الحقول | |
---|---|
path1 |
تم إلحاق نص بعنوان URL المرئي الذي تم إنشاؤه تلقائيًا مع محدِّد. |
path2 |
تم إلحاق النص بالمسار 1 باستخدام محدِّد. |
adTrackingId |
رقم تعريف تتبّع الإعلان. |
SearchAds360ProductAdInfo
لا يشتمل هذا النوع على أي حقول.
إعلان منتج في "إعلانات شبكة البحث 360".
SearchAds360ExpandedDynamicSearchAdInfo
إعلان ديناميكي موسّع على شبكة البحث
تمثيل JSON |
---|
{ "description1": string, "description2": string, "adTrackingId": string } |
الحقول | |
---|---|
description1 |
السطر الأول من وصف الإعلان. |
description2 |
السطر الثاني من وصف الإعلان. |
adTrackingId |
رقم تعريف تتبّع الإعلان. |
AdGroupAdEngineStatus
لتعداد حالات محرك إعلان المجموعة الإعلانية.
عمليات التعداد | |
---|---|
UNSPECIFIED |
لم يتم تحديد قيمة. |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
AD_GROUP_AD_ELIGIBLE |
تمّ الإيقاف. يُرجى عدم الاستخدام. |
AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN |
Baidu: لم تتم الموافقة على تصميم الإعلان. |
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW |
Baidu: عنوان URL للأجهزة الجوّالة قيد المراجعة. |
AD_GROUP_AD_PARTIALLY_INVALID |
Baidu: تصميم الإعلان غير صالح على الجهاز الجوّال ولكنّه صالح على أجهزة الكمبيوتر المكتبي. |
AD_GROUP_AD_TO_BE_ACTIVATED |
Baidu: تصميم الإعلان جاهز للتفعيل. |
AD_GROUP_AD_NOT_REVIEWED |
Baidu: لم تتم مراجعة تصميم الإعلان. |
AD_GROUP_AD_ON_HOLD |
تمّ الإيقاف. يُرجى عدم الاستخدام. سبق أن استخدمه Gemini |
AD_GROUP_AD_PAUSED |
تم إيقاف تصميم الإعلان مؤقتًا. |
AD_GROUP_AD_REMOVED |
تمت إزالة التصميم. |
AD_GROUP_AD_PENDING_REVIEW |
التصميم في انتظار المراجعة. |
AD_GROUP_AD_UNDER_REVIEW |
تصميم الإعلان قيد المراجعة. |
AD_GROUP_AD_APPROVED |
تمت الموافقة على التصميم. |
AD_GROUP_AD_DISAPPROVED |
تم رفض تصميم الإعلان. |
AD_GROUP_AD_SERVING |
يتم عرض تصميم الإعلان. |
AD_GROUP_AD_ACCOUNT_PAUSED |
تم إيقاف تصميم الإعلان مؤقتًا لأن الحساب متوقف مؤقتًا. |
AD_GROUP_AD_CAMPAIGN_PAUSED |
تم إيقاف تصميم الإعلان مؤقتًا لأن الحملة متوقفة مؤقتًا. |
AD_GROUP_AD_AD_GROUP_PAUSED |
تم إيقاف تصميم الإعلان مؤقتًا بسبب إيقاف المجموعة الإعلانية مؤقتًا. |
AdGroupAdLabel
علاقة بين إعلان مجموعة إعلانية وتصنيف.
تمثيل JSON |
---|
{ "resourceName": string, "adGroupAd": string, "label": string } |
الحقول | |
---|---|
resourceName |
اسم المورد لتصنيف إعلان المجموعة الإعلانية. تكون أسماء موارد تصنيف الإعلان للمجموعة الإعلانية على النحو التالي: |
adGroupAd |
إعلان المجموعة الإعلانية الذي تم إرفاق التصنيف به. |
label |
التصنيف المعيَّن لإعلان المجموعة الإعلانية. |
AdGroupAsset
تمثّل هذه السمة رابطًا بين مجموعة إعلانية ومادة عرض.
تمثيل JSON |
---|
{
"resourceName": string,
"adGroup": string,
"asset": string,
"status": enum ( |
الحقول | |
---|---|
resourceName |
اسم المورد لمادة عرض المجموعة الإعلانية. تكون أسماء موارد المجموعة الإعلانية بالصيغة التالية:
|
adGroup |
مطلوبة. المجموعة الإعلانية التي ترتبط بها مادة العرض. |
asset |
مطلوبة. مادة العرض المرتبطة بالمجموعة الإعلانية. |
status |
حالة مادة عرض المجموعة الإعلانية. |
AssetLinkStatus
يشير هذا المقياس إلى عدد يصف حالات رابط مادة العرض.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
ENABLED |
تم تفعيل رابط مادة العرض. |
REMOVED |
تمت إزالة رابط مادة العرض. |
PAUSED |
تم إيقاف رابط مادة العرض مؤقتًا. |
AdGroupAssetSet
GroupAssetSet هي الرابط بين مجموعة إعلانية ومجموعة مواد عرض. عند إنشاء مجموعة مواد عرض مجموعة إعلانية، يتم ربط مجموعة مواد عرض بمجموعة إعلانية.
تمثيل JSON |
---|
{
"resourceName": string,
"adGroup": string,
"assetSet": string,
"status": enum ( |
الحقول | |
---|---|
resourceName |
اسم المورد لمجموعة مواد العرض في المجموعة الإعلانية تكون أسماء موارد مجموعة مواد العرض للمجموعة الإعلانية على النحو التالي:
|
adGroup |
المجموعة الإعلانية التي ترتبط بها مجموعة مواد العرض هذه. |
assetSet |
مجموعة مواد العرض المرتبطة بالمجموعة الإعلانية. |
status |
حالة مجموعة مواد العرض في المجموعة الإعلانية. للقراءة فقط |
AssetSetLinkStatus
الحالات المحتملة للربط بين مجموعة مواد العرض وحاويةها.
عمليات التعداد | |
---|---|
UNSPECIFIED |
لم يتمّ تحديد الحالة. |
UNKNOWN |
القيمة المُستلَمة غير معروفة في هذا الإصدار. هذه قيمة للاستجابة فقط. |
ENABLED |
تم تفعيل الربط بين مجموعة مواد العرض وحاوية هذه المجموعة. |
REMOVED |
تتم إزالة الرابط بين مجموعة مواد العرض وحاوية هذه المجموعة. |
AdGroupAudienceView
مشاهدة جمهور المجموعة الإعلانية. تشمل بيانات الأداء من قوائم الاهتمامات وقوائم تجديد النشاط التسويقي للإعلانات على الشبكة الإعلانية وشبكة YouTube، وقوائم تجديد النشاط التسويقي للإعلانات على شبكة البحث (قوائم تجديد النشاط التسويقي للإعلانات على شبكة البحث)، المجمّعة على مستوى الجمهور.
تمثيل JSON |
---|
{ "resourceName": string } |
الحقول | |
---|---|
resourceName |
اسم المورد لطريقة عرض الجمهور للمجموعة الإعلانية. تكون أسماء مراجع مشاهدة الجمهور في المجموعة الإعلانية على النحو التالي:
|
AdGroupBidModifier
يمثل معدِّل عروض أسعار المجموعة الإعلانية.
تمثيل JSON |
---|
{ "resourceName": string, "bidModifier": number, // Union field |
الحقول | |
---|---|
resourceName |
اسم المورد لمعدِّل عرض سعر المجموعة الإعلانية. تكون أسماء موارد معدِّل عروض أسعار المجموعة الإعلانية على النحو التالي:
|
bidModifier |
معدِّل عرض السعر عندما يتطابق المعيار. يجب أن يكون المعدَّل ضمن النطاق: 0.1 - 10.0. النطاق هو 1.0 - 6.0 بالنسبة إلى PreferredContent. استخدِم 0 لإيقاف نوع جهاز. |
حقل الاتحاد مطلوب في عمليات الإنشاء التي تبدأ بـ V5. يمكن أن يكون الحقل " |
|
device |
معيار جهاز. |
DeviceInfo
معيار جهاز.
تمثيل JSON |
---|
{
"type": enum ( |
الحقول | |
---|---|
type |
نوع الجهاز |
الجهاز
لتعداد أجهزة "إعلانات Google" المتاحة للاستهداف.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
القيمة غير معروفة في هذا الإصدار. |
MOBILE |
الأجهزة الجوّالة المجهزة بمتصفّحات إنترنت كاملة الوظائف |
TABLET |
الأجهزة اللوحية المزوّدة بمتصفّحات بوظائف كاملة. |
DESKTOP |
أجهزة الكمبيوتر. |
CONNECTED_TV |
أجهزة التلفزيون الذكية ووحدات تحكّم الألعاب |
OTHER |
أنواع الأجهزة الأخرى |
AdGroupCriterion
معيار مجموعة إعلانية. لا يعرض تقرير معيار المجموعة الإعلانية سوى المعايير التي تمت إضافتها بشكلٍ صريح إلى المجموعة الإعلانية.
تمثيل JSON |
---|
{ "resourceName": string, "creationTime": string, "status": enum ( |
الحقول | |
---|---|
resourceName |
اسم مورد معيار المجموعة الإعلانية. تكون أسماء موارد معايير المجموعة الإعلانية على النحو التالي:
|
creationTime |
الطابع الزمني عند إنشاء معيار المجموعة الإعلانية هذا. يكون الطابع الزمني حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss". |
status |
حالة المعيار. هذه هي حالة كيان معيار المجموعة الإعلانية، الذي حدّده العميل. ملاحظة: قد تتضمّن تقارير واجهة المستخدم معلومات إضافية تؤثّر في ما إذا كان المعيار مؤهَّلاً للعرض. في بعض الحالات، ما زال المعيار الذي تمت إزالته في واجهة برمجة التطبيقات يظهر على أنّه مفعّل في واجهة المستخدم. على سبيل المثال، يتم عرض الحملات تلقائيًا للمستخدمين من جميع الفئات العمرية ما لم يتم استبعادها. ستعرض واجهة المستخدم كل فئة عمرية على أنها "مفعّلة"، بما أنها مؤهَّلة لمشاهدة الإعلانات، إلا أنّ حالة قاعدة بيانات الإعلان: "تمت الإزالة"، بسبب عدم إضافة أي معيار إيجابي. |
qualityInfo |
تمثّل هذه السمة معلومات عن جودة المعيار. |
type |
نوع المعيار. |
labels[] |
أسماء موارد التصنيفات المرفقة بمعيار المجموعة الإعلانية هذا. |
positionEstimates |
تقديرات عروض أسعار المعايير في مواضع مختلفة. |
finalUrls[] |
قائمة عناوين URL النهائية المحتملة بعد جميع عمليات إعادة التوجيه عبر النطاقات للإعلان. |
engineId |
رقم تعريف معيار المجموعة الإعلانية في حساب محرّك البحث الخارجي هذا الحقل مخصّص للحسابات غير التابعة لخدمة "إعلانات Google" فقط، مثل Yahoo Japan أو Microsoft أو Baidu وما إلى ذلك. وبالنسبة إلى كيان "إعلانات Google"، استخدِم "adGroupcriterion.criterion_id" بدلاً منه. |
lastModifiedTime |
التاريخ والوقت لآخر تعديل لمعيار المجموعة الإعلانية هذا. يتم تحديد التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ssssss". |
criterionId |
رقم تعريف المعيار. |
adGroup |
المجموعة الإعلانية التي ينتمي إليها المعيار. |
negative |
تحديد ما إذا كان سيتم استهداف ( هذا الحقل غير قابل للتغيير. لتبديل معيار من موجب إلى سالب، عليك إزالته ثم إعادة إضافته. |
bidModifier |
معدِّل عرض السعر عندما يتطابق المعيار. يجب أن يكون المعدَّل ضمن النطاق: 0.1 - 10.0. تتوافق معظم أنواع المعايير القابلة للاستهداف مع المعدِّلات. |
cpcBidMicros |
عرض سعر النقرة. |
effectiveCpcBidMicros |
عرض سعر النقرة الفعّال. |
engineStatus |
حالة المحرّك لمعيار المجموعة الإعلانية. |
finalUrlSuffix |
نموذج عنوان URL لإلحاق المَعلمات برابط عنوان URL النهائي |
trackingUrlTemplate |
نموذج عنوان URL لإنشاء عنوان URL للتتبّع. |
حقل الاتحاد يجب ضبط واحد بالضبط. يمكن أن يكون الحقل " |
|
keyword |
الكلمة الرئيسية. |
listingGroup |
مجموعة البيانات |
ageRange |
الفئة العمرية. |
gender |
الجنس. |
userList |
قائمة المستخدمين. |
webpage |
صفحة ويب |
location |
الموقع الجغرافي. |
AdGroupCriterionStatus
الحالات المحتملة لمعيار المجموعة الإعلانية.
عمليات التعداد | |
---|---|
UNSPECIFIED |
لم يتم تحديد قيمة. |
UNKNOWN |
القيمة المُستلَمة غير معروفة في هذا الإصدار. هذه قيمة للاستجابة فقط. |
ENABLED |
معيار المجموعة الإعلانية مفعّل. |
PAUSED |
معيار المجموعة الإعلانية متوقف مؤقتًا. |
REMOVED |
تتم إزالة معيار المجموعة الإعلانية. |
QualityInfo
حاوية لمعلومات جودة معايير المجموعة الإعلانية
تمثيل JSON |
---|
{ "qualityScore": integer } |
الحقول | |
---|---|
qualityScore |
نقاط الجودة. قد لا تتم تعبئة هذا الحقل إذا لم يكن لدى Google معلومات كافية لتحديد قيمة. |
CriterionType
يشير قيم التعداد إلى أنواع المعايير المحتملة.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
KEYWORD |
الكلمة الرئيسية، على سبيل المثال، "رحلة بحرية على المريخ". |
PLACEMENT |
موضع الإعلان، الذي يُعرف أيضًا باسم موقع الويب، على سبيل المثال "www.flowers4sale.com" |
MOBILE_APP_CATEGORY |
فئات تطبيقات الأجهزة الجوّالة المطلوب استهدافها. |
MOBILE_APPLICATION |
تطبيقات الأجهزة الجوّالة المستهدفة. |
DEVICE |
الأجهزة المطلوب استهدافها. |
LOCATION |
المواقع الجغرافية المستهدفة. |
LISTING_GROUP |
مجموعات البيانات المطلوب استهدافها |
AD_SCHEDULE |
جدول عرض الإعلانات. |
AGE_RANGE |
الفئة العمرية. |
GENDER |
الجنس. |
INCOME_RANGE |
نطاق الدخل. |
PARENTAL_STATUS |
الحالة الأبوية. |
YOUTUBE_VIDEO |
فيديو YouTube |
YOUTUBE_CHANNEL |
قناة YouTube |
USER_LIST |
قائمة المستخدمين. |
PROXIMITY |
التقارب. |
TOPIC |
موضوع مستهدَف على الشبكة الإعلانية (مثل "الحيوانات الأليفة"). |
LISTING_SCOPE |
نطاق بطاقة البيانات المطلوب استهدافه |
LANGUAGE |
اللغة |
IP_BLOCK |
IpBlock. |
CONTENT_LABEL |
تصنيف المحتوى لاستبعاد الفئات. |
CARRIER |
مشغّل شبكة الجوّال |
USER_INTEREST |
الفئة التي يهتم بها المستخدم. |
WEBPAGE |
معيار صفحة الويب للإعلانات الديناميكية على شبكة البحث. |
OPERATING_SYSTEM_VERSION |
إصدار نظام التشغيل |
APP_PAYMENT_MODEL |
نموذج الدفع للتطبيق |
MOBILE_DEVICE |
جهاز جوّال |
CUSTOM_AFFINITY |
تقارب مخصص. |
CUSTOM_INTENT |
مخصّص حسب نيّة الشراء. |
LOCATION_GROUP |
مجموعة المواقع الجغرافية. |
CUSTOM_AUDIENCE |
جمهور مخصّص |
COMBINED_AUDIENCE |
الجمهور المشترك |
KEYWORD_THEME |
موضوع الكلمة الرئيسية للحملة الذكية |
AUDIENCE |
الجمهور |
LOCAL_SERVICE_ID |
رقم تعريف خدمة "إعلانات الخدمات المحلّية". |
BRAND |
العلامة التجارية |
BRAND_LIST |
قائمة العلامات التجارية |
LIFE_EVENT |
حدث في الحياة |
PositionEstimates
تقديرات عروض أسعار المعايير في مواضع مختلفة.
تمثيل JSON |
---|
{ "topOfPageCpcMicros": string } |
الحقول | |
---|---|
topOfPageCpcMicros |
تقدير عرض سعر النقرة المطلوب لعرض الإعلان أعلى الصفحة الأولى من نتائج البحث. |
AdGroupCriterionEngineStatus
لتعداد حالات محرّك معيار المجموعة الإعلانية.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
AD_GROUP_CRITERION_ELIGIBLE |
تمّ الإيقاف. يُرجى عدم الاستخدام. |
AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN |
Baidu: عرض السعر أو الجودة منخفضة جدًا بحيث يتعذّر عرضها. |
AD_GROUP_CRITERION_INVALID_MOBILE_SEARCH |
Baidu: عرض السعر أو الجودة منخفضة جدًا للأجهزة الجوّالة، ولكنّها مؤهَّلة للعرض على أجهزة الكمبيوتر المكتبي. |
AD_GROUP_CRITERION_INVALID_PC_SEARCH |
Baidu: عرض السعر أو الجودة منخفضة جدًا لجهاز الكمبيوتر المكتبي، ولكنّها مؤهَّلة للعرض على الأجهزة الجوّالة. |
AD_GROUP_CRITERION_INVALID_SEARCH |
Baidu: عرض السعر أو الجودة منخفضة جدًا بحيث يتعذّر عرضها. |
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME |
Baidu: تم إيقافها مؤقتًا بواسطة Baidu بسبب انخفاض حجم البحث. |
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW |
Baidu: عنوان URL للأجهزة الجوّالة قيد المراجعة. |
AD_GROUP_CRITERION_PARTIALLY_INVALID |
Baidu: الصفحة المقصودة لأحد الأجهزة غير صالحة، بينما تكون الصفحة المقصودة للجهاز الآخر صالحة. |
AD_GROUP_CRITERION_TO_BE_ACTIVATED |
Baidu: تم إنشاء الكلمة الرئيسية وإيقافها مؤقتًا من خلال إدارة حساب Baidu، وهي جاهزة الآن لتفعيلها. |
AD_GROUP_CRITERION_UNDER_REVIEW |
Baidu: قيد المراجعة من قِبل Baidu. الجوزاء: المعيار قيد المراجعة. |
AD_GROUP_CRITERION_NOT_REVIEWED |
Baidu: ستتم مراجعة المعيار. |
AD_GROUP_CRITERION_ON_HOLD |
تمّ الإيقاف. يُرجى عدم الاستخدام. سبق أن استخدمه Gemini |
AD_GROUP_CRITERION_PENDING_REVIEW |
Y!J : المعيار في انتظار المراجعة |
AD_GROUP_CRITERION_PAUSED |
تم إيقاف المعيار مؤقتًا. |
AD_GROUP_CRITERION_REMOVED |
تمت إزالة المعيار. |
AD_GROUP_CRITERION_APPROVED |
تمت الموافقة على المعيار. |
AD_GROUP_CRITERION_DISAPPROVED |
تم رفض المعيار. |
AD_GROUP_CRITERION_SERVING |
المعيار نشط ويتم عرضه. |
AD_GROUP_CRITERION_ACCOUNT_PAUSED |
تم إيقاف المعيار مؤقتًا بسبب إيقاف الحساب مؤقتًا. |
KeywordInfo
معيار كلمة رئيسية.
تمثيل JSON |
---|
{
"matchType": enum ( |
الحقول | |
---|---|
matchType |
نوع مطابقة الكلمة الرئيسية. |
text |
نص الكلمة الرئيسية (80 حرفًا و10 كلمات على الأكثر). |
KeywordMatchType
أنواع مطابقة الكلمات الرئيسية المحتملة.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
EXACT |
المطابقة التامة. |
PHRASE |
مطابقة العبارة. |
BROAD |
المطابقة التقريبية. |
ListingGroupInfo
معيار مجموعة بيانات.
تمثيل JSON |
---|
{
"type": enum ( |
الحقول | |
---|---|
type |
نوع مجموعة البيانات |
ListingGroupType
نوع مجموعة البيانات.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
SUBDIVISION |
قسم فرعي من المنتجات إلى جانب بعض سمات البيانات لا تُستخدم هذه العُقد عن طريق العرض على إدخالات قائمة الهدف، ولكنها تُستخدم فقط لتعريف هيكل الشجرة. |
UNIT |
وحدة مجموعة البيانات التي تحدِّد عرض السعر. |
AgeRangeInfo
معيار الفئة العمرية.
تمثيل JSON |
---|
{
"type": enum ( |
الحقول | |
---|---|
type |
تمثّل هذه السمة نوع الفئة العمرية. |
AgeRangeType
نوع الفئات العمرية للخصائص الديمغرافية (مثل: بين 18 و24 عامًا).
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
AGE_RANGE_18_24 |
بين 18 و24 عامًا. |
AGE_RANGE_25_34 |
بين 25 و34 عامًا. |
AGE_RANGE_35_44 |
بين 35 و44 عامًا. |
AGE_RANGE_45_54 |
بين 45 و54 عامًا. |
AGE_RANGE_55_64 |
بين 55 و64 عامًا. |
AGE_RANGE_65_UP |
تبلغ من العمر 65 عامًا أو أكثر. |
AGE_RANGE_UNDETERMINED |
الفئة العمرية غير محدّدة. |
GenderInfo
معيار للجنس
تمثيل JSON |
---|
{
"type": enum ( |
الحقول | |
---|---|
type |
تمثّل هذه السمة نوع الجنس. |
GenderType
تمثّل هذه السمة نوع الجنس الديمغرافية (مثل أنثى).
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
MALE |
ذكر |
FEMALE |
أنثى |
UNDETERMINED |
جنس غير مُحدد. |
UserListInfo
معيار قائمة المستخدمين. يمثل قائمة المستخدمين التي يحددها المعلن المستهدف.
تمثيل JSON |
---|
{ "userList": string } |
الحقول | |
---|---|
userList |
اسم مورد "قائمة المستخدمين". |
WebpageInfo
يمثل معيارًا لاستهداف صفحات الويب على الموقع الإلكتروني للمعلِن.
تمثيل JSON |
---|
{
"conditions": [
{
object ( |
الحقول | |
---|---|
conditions[] |
الشروط أو التعبيرات المنطقية لاستهداف صفحة الويب. يتم ربط قائمة شروط استهداف صفحة الويب معًا عند تقييم الاستهداف. تشير قائمة الشروط الفارغة إلى استهداف جميع صفحات الموقع الإلكتروني للحملة. هذا الحقل مطلوب لعمليات CREATE وهو محظور في عمليات UPDATE. |
coveragePercentage |
نسبة تغطية معايير المواقع الإلكترونية هذه هي النسبة المئوية المحسوبة لتغطية الموقع الإلكتروني استنادًا إلى استهداف الموقع الإلكتروني واستهداف الموقع الإلكتروني السلبي والكلمات الرئيسية السلبية في المجموعة الإعلانية والحملة. على سبيل المثال، عندما تظهر التغطية بقيمة 1، يعني ذلك أنّها تتضمّن تغطية بنسبة 100%. هذا الحقل للقراءة فقط. |
criterionName |
اسم المعيار الذي تحدّده هذه المَعلمة. سيتم استخدام قيمة الاسم لتحديد المعايير وفرزها وتصفيتها باستخدام هذا النوع من المعلمات. هذا الحقل مطلوب لعمليات CREATE وهو محظور في عمليات UPDATE. |
WebpageConditionInfo
تعبير منطقي لاستهداف صفحات الويب الخاصة بالموقع الإلكتروني لأحد المعلنين.
تمثيل JSON |
---|
{ "operand": enum ( |
الحقول | |
---|---|
operand |
مرتبط بشرط استهداف صفحة الويب. |
operator |
عامل تشغيل شرط استهداف صفحة الويب. |
argument |
وسيطة شرط استهداف صفحة الويب |
WebpageConditionOperand
معامل شرط صفحة الويب في معيار صفحة الويب
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
URL |
خاص يشير إلى شرط استهداف عنوان URL لصفحة الويب. |
CATEGORY |
خاص يشير إلى شرط استهداف فئة صفحة الويب. |
PAGE_TITLE |
خاص يشير إلى شرط استهداف عنوان صفحة ويب. |
PAGE_CONTENT |
خاص يشير إلى شرط استهداف محتوى صفحة ويب. |
CUSTOM_LABEL |
خاص يشير إلى شرط استهداف تصنيف مخصّص لصفحة الويب. |
WebpageConditionOperator
عامل تشغيل شرط صفحة الويب في معيار صفحة الويب.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
EQUALS |
شرط ويب الوسيطة يساوي شرط الويب المقارنة. |
CONTAINS |
شرط ويب الوسيطة هو جزء من شرط الويب المقارن. |
LocationInfo
معيار موقع جغرافي.
تمثيل JSON |
---|
{ "geoTargetConstant": string } |
الحقول | |
---|---|
geoTargetConstant |
اسم المورد الثابت المستهدف في الموقع الجغرافي. |
AdGroupCriterionLabel
يشير ذلك المصطلح إلى علاقة بين معيار مجموعة إعلانية وتصنيف معيَّن.
تمثيل JSON |
---|
{ "resourceName": string, "adGroupCriterion": string, "label": string } |
الحقول | |
---|---|
resourceName |
اسم المورد لتصنيف معيار المجموعة الإعلانية. تكون أسماء موارد تصنيف معايير المجموعة الإعلانية على النحو التالي: |
adGroupCriterion |
معيار المجموعة الإعلانية الذي يتم إرفاق التصنيف به. |
label |
التصنيف المعيَّن لمعيار المجموعة الإعلانية. |
AdGroupLabel
علاقة بين مجموعة إعلانية وتصنيف.
تمثيل JSON |
---|
{ "resourceName": string, "adGroup": string, "label": string } |
الحقول | |
---|---|
resourceName |
اسم المورد لتصنيف المجموعة الإعلانية. تكون أسماء موارد تصنيف المجموعة الإعلانية على النحو التالي: |
adGroup |
المجموعة الإعلانية التي تم إرفاق التصنيف بها. |
label |
التصنيف المعيَّن للمجموعة الإعلانية. |
AgeRangeView
عرض الفئة العمرية.
تمثيل JSON |
---|
{ "resourceName": string } |
الحقول | |
---|---|
resourceName |
اسم المورد لعرض الفئة العمرية. تكون أسماء موارد الاطّلاع على الفئة العمرية على النحو التالي:
|
مادة العرض
مادة العرض هي جزء من إعلان يمكن مشاركته مع إعلانات متعددة. ويمكن أن تكون مواد العرض صورة (ImageAsset) أو فيديو (YoutubeVideoAsset) وما إلى ذلك. مواد العرض غير قابلة للتغيير ولا يمكن إزالتها. لإيقاف عرض مادة عرض، يجب إزالتها من الكيان الذي يستخدمها.
تمثيل JSON |
---|
{ "resourceName": string, "type": enum ( |
الحقول | |
---|---|
resourceName |
اسم مورد مادة العرض. وتكون أسماء موارد مواد العرض على النحو التالي:
|
type |
نوع مادة العرض |
finalUrls[] |
قائمة بعناوين URL النهائية المحتملة بعد جميع عمليات إعادة التوجيه عبر النطاقات. |
status |
حالة مادة العرض |
creationTime |
الطابع الزمني عند إنشاء مادة العرض هذه يكون الطابع الزمني حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss". |
lastModifiedTime |
تمثّل هذه السمة تاريخ آخر تعديل لمادة العرض هذه. يتم تحديد التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ssssss". |
id |
رقم تعريف مادة العرض |
name |
اسم اختياري لمادة العرض |
trackingUrlTemplate |
نموذج عنوان URL لإنشاء عنوان URL للتتبّع. |
engineStatus |
حالة محرّك البحث لمادة العرض |
حقل الاتحاد asset_data النوع المحدد لمادة العرض. يمكن أن يكون الحقل "asset_data " واحدًا فقط مما يلي: |
|
youtubeVideoAsset |
مادة عرض فيديو على YouTube. |
imageAsset |
مادّة عرض صورة |
textAsset |
مادة عرض نصية. |
calloutAsset |
مادة عرض وسيلة شرح موحّدة |
sitelinkAsset |
مادة عرض رابط أقسام موقع موحَّدة |
pageFeedAsset |
مادة عرض خلاصة صفحة موحّدة. |
mobileAppAsset |
مادة عرض تطبيق للأجهزة الجوّالة. |
callAsset |
مادة عرض مكالمة موحّدة. |
callToActionAsset |
مادة عرض عبارة الحثّ على اتّخاذ إجراء. |
locationAsset |
مادة عرض موقع جغرافي موحَّدة |
AssetType
يشير التعداد إلى وصف الأنواع المحتملة من مواد العرض.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
YOUTUBE_VIDEO |
مادة عرض فيديو YouTube. |
MEDIA_BUNDLE |
مادة عرض حِزمة الوسائط |
IMAGE |
مادة عرض الصورة |
TEXT |
مادة عرض نصية |
LEAD_FORM |
مادة عرض نموذج العملاء المحتملين |
BOOK_ON_GOOGLE |
مادة عرض الحجز على Google. |
PROMOTION |
مادة العرض الخاصة بالعرض الترويجي |
CALLOUT |
مادة عرض وسيلة الشرح |
STRUCTURED_SNIPPET |
مادة عرض مقتطف من الموقع. |
SITELINK |
مادة عرض رابط أقسام الموقع. |
PAGE_FEED |
مادة عرض خلاصة الصفحة |
DYNAMIC_EDUCATION |
مادة عرض التعليم الديناميكي. |
MOBILE_APP |
مادة عرض تطبيق الأجهزة الجوّالة. |
HOTEL_CALLOUT |
مادة عرض وسيلة الشرح للفندق. |
CALL |
مادة عرض المكالمة |
PRICE |
مادة عرض السعر |
CALL_TO_ACTION |
مادة عرض عبارة الحثّ على اتّخاذ إجراء |
DYNAMIC_REAL_ESTATE |
مادة عرض عقارات ديناميكية. |
DYNAMIC_CUSTOM |
مادة عرض مخصَّصة ديناميكية. |
DYNAMIC_HOTELS_AND_RENTALS |
مواد عرض فنادق وأماكن استئجار ديناميكية |
DYNAMIC_FLIGHTS |
مادة عرض رحلات الطيران الديناميكية |
DISCOVERY_CAROUSEL_CARD |
مادة عرض بطاقة لوحة العرض الدوّارة أثناء التصفّح |
DYNAMIC_TRAVEL |
مادة عرض سفر ديناميكية. |
DYNAMIC_LOCAL |
مادة عرض محلية ديناميكية. |
DYNAMIC_JOBS |
مادة عرض الوظائف الديناميكية |
LOCATION |
مادة عرض الموقع الجغرافي |
HOTEL_PROPERTY |
مادة عرض موقع الفندق. |
AssetStatus
الحالات المحتملة لمادة عرض.
عمليات التعداد | |
---|---|
UNSPECIFIED |
لم يتمّ تحديد الحالة. |
UNKNOWN |
القيمة المُستلَمة غير معروفة في هذا الإصدار. هذه قيمة للاستجابة فقط. |
ENABLED |
مادة العرض مفعَّلة. |
REMOVED |
تمّت إزالة مادة العرض. |
ARCHIVED |
تمت أرشفة مادة العرض. |
PENDING_SYSTEM_GENERATED |
تم إنشاء مادة العرض بواسطة النظام في انتظار مراجعة المستخدم. |
AssetEngineStatus
المعرّف التالي = 11
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
SERVING |
مادة العرض نشطة. |
SERVING_LIMITED |
مادة العرض نشطة محدودة. |
DISAPPROVED |
مادة العرض مرفوضة (غير مؤهَّلة). |
DISABLED |
مادة العرض غير نشطة (في انتظار المراجعة). |
REMOVED |
تمّت إزالة مادة العرض. |
YoutubeVideoAsset
مادة عرض على YouTube.
تمثيل JSON |
---|
{ "youtubeVideoTitle": string, "youtubeVideoId": string } |
الحقول | |
---|---|
youtubeVideoTitle |
عنوان فيديو YouTube |
youtubeVideoId |
معرّف فيديو YouTube هذه هي قيمة السلسلة المكونة من 11 حرفًا والمستخدمة في عنوان URL للفيديو على YouTube. |
ImageAsset
مادة عرض صورة
تمثيل JSON |
---|
{ "mimeType": enum ( |
الحقول | |
---|---|
mimeType |
نوع MIME لمادة عرض الصورة. |
fullSize |
البيانات الوصفية لهذه الصورة بحجمها الأصلي |
fileSize |
حجم ملف مادة عرض الصورة بالبايت |
MimeType
نوع MIME
عمليات التعداد | |
---|---|
UNSPECIFIED |
لم يتم تحديد نوع MIME. |
UNKNOWN |
القيمة المُستلَمة غير معروفة في هذا الإصدار. هذه قيمة للاستجابة فقط. |
IMAGE_JPEG |
نوع MIME للصورة/jpeg. |
IMAGE_GIF |
نوع MIME للصورة/gif هو. |
IMAGE_PNG |
نوع MIME للصورة/png. |
FLASH |
نوع MIME للتطبيق/x-shockwave-flash. |
TEXT_HTML |
نوع MIME عبارة عن نص/html. |
PDF |
نوع MIME للتطبيق/pdf. |
MSWORD |
نوع MIME للتطبيق/msword. |
MSEXCEL |
نوع MIME لملف app/vnd.ms-excel. |
RTF |
نوع MIME للتطبيق/rtf. |
AUDIO_WAV |
نوع MIME للصوت/wav. |
AUDIO_MP3 |
نوع MIME للصوت/mp3. |
HTML5_AD_ZIP |
نوع MIME للتطبيق/x-html5-ad-zip. |
ImageDimension
البيانات الوصفية لصورة بحجم معيّن، سواء كان أصليًا أو تم تغيير حجمه
تمثيل JSON |
---|
{ "heightPixels": string, "widthPixels": string, "url": string } |
الحقول | |
---|---|
heightPixels |
ارتفاع الصورة. |
widthPixels |
عرض الصورة |
url |
عنوان URL يعرض الصورة بهذا الارتفاع والعرض. |
TextAsset
مادة عرض نصية:
تمثيل JSON |
---|
{ "text": string } |
الحقول | |
---|---|
text |
المحتوى النصي لمادة العرض النصية. |
UnifiedCalloutAsset
مادة عرض وسيلة شرح موحّدة
تمثيل JSON |
---|
{
"calloutText": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
الحقول | |
---|---|
calloutText |
نص وسيلة الشرح. يجب أن يتراوح طول هذه السلسلة بين 1 و25، بشكل شامل. |
startDate |
تاريخ البدء الذي ستكون فيه مادة العرض هذه سارية المفعول ويمكن بدء عرضها، بالتنسيق yyyy-MM-dd. |
endDate |
التاريخ الأخير الذي ستكون فيه مادة العرض هذه سارية المفعول ولا تزال معروضة، بالتنسيق yyyy-MM-dd. |
adScheduleTargets[] |
قائمة بجداول غير متداخلة تحدّد كل الفواصل الزمنية التي قد تظهر فيها مادة العرض. يمكن أن تكون هناك 6 جداول زمنية كحد أقصى في اليوم، إجمالي 42 جدولاً. |
useSearcherTimeZone |
ما إذا كان سيتم عرض مادة العرض في المنطقة الزمنية لمستخدم البحث. ينطبق ذلك على Microsoft Ads. |
AdScheduleInfo
يمثل معيارًا من معايير جدولة الإعلانات.
يتم تحديد جدول عرض الإعلانات بيوم من الأسبوع وفترة زمنية تظهر خلالها الإعلانات.
لا يمكن إضافة أكثر من ستة جداول عرض إعلانات في اليوم نفسه.
تمثيل JSON |
---|
{ "startMinute": enum ( |
الحقول | |
---|---|
startMinute |
الدقائق بعد ساعة البدء التي يبدأ فيها هذا الجدول الزمني هذا الحقل مطلوب لعمليات CREATE وهو محظور في عمليات UPDATE. |
endMinute |
الدقائق بعد ساعة الانتهاء التي ينتهي فيها هذا الجدول الزمني الجدول الزمني حصري لدقيقة النهاية. هذا الحقل مطلوب لعمليات CREATE وهو محظور في عمليات UPDATE. |
dayOfWeek |
يوم من الأسبوع الذي ينطبق عليه الجدول الزمني هذا الحقل مطلوب لعمليات CREATE وهو محظور في عمليات UPDATE. |
startHour |
ساعة البدء بعد 24 ساعة. يجب أن يتراوح هذا الحقل بين 0 و23، بشكل شامل. هذا الحقل مطلوب لعمليات CREATE وهو محظور في عمليات UPDATE. |
endHour |
انتهاء الساعة بتنسيق 24 ساعة؛ تشير الرقم 24 إلى نهاية اليوم. يجب أن يتراوح هذا الحقل بين 0 و24، بشكل شامل. هذا الحقل مطلوب لعمليات CREATE وهو محظور في عمليات UPDATE. |
MinuteOfHour
تعداد ربع ساعة. على سبيل المثال، "FIFTEEN"
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
القيمة غير معروفة في هذا الإصدار. |
ZERO |
0 دقيقة بعد الساعة. |
FIFTEEN |
خَمْسَ عَشْرَةَ دَقِيقَة بَعْدَ السَّاعَة. |
THIRTY |
ثلاثون دقيقة بعد الساعة |
FORTY_FIVE |
خَمْسَة وِأَرْبِعِينْ دِقِيقَة بَعْدَ السَّاعَة. |
DayOfWeek
لتعداد أيام الأسبوع، على سبيل المثال "الاثنين".
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
القيمة غير معروفة في هذا الإصدار. |
MONDAY |
الاثنين. |
TUESDAY |
الثلاثاء. |
WEDNESDAY |
الأربعاء. |
THURSDAY |
الخميس. |
FRIDAY |
الجمعة. |
SATURDAY |
السبت. |
SUNDAY |
الأحد. |
UnifiedSitelinkAsset
مادة عرض رابط أقسام موقع موحَّدة
تمثيل JSON |
---|
{
"linkText": string,
"description1": string,
"description2": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
الحقول | |
---|---|
linkText |
نص عرض عنوان URL لرابط أقسام الموقع. يجب أن يتراوح طول هذه السلسلة بين 1 و25، بشكل شامل. |
description1 |
السطر الأول من وصف رابط أقسام الموقع. وفي حال ضبطها، يجب أن يتراوح طولها بين 1 و35، وشاملًا، ويجب أيضًا ضبط الوصف 2. |
description2 |
السطر الثاني من وصف رابط أقسام الموقع. وفي حال ضبطها، يجب أن يتراوح طولها بين 1 و35، وشاملًا، ويجب أيضًا ضبط description1. |
startDate |
تاريخ البدء الذي ستكون فيه مادة العرض هذه سارية المفعول ويمكن بدء عرضها، بالتنسيق yyyy-MM-dd. |
endDate |
التاريخ الأخير الذي ستكون فيه مادة العرض هذه سارية المفعول ولا تزال معروضة، بالتنسيق yyyy-MM-dd. |
adScheduleTargets[] |
قائمة بجداول غير متداخلة تحدّد كل الفواصل الزمنية التي قد تظهر فيها مادة العرض. يمكن أن تكون هناك 6 جداول زمنية كحد أقصى في اليوم، إجمالي 42 جدولاً. |
trackingId |
رقم التعريف المستخدَم لتتبُّع النقرات في مادة عرض رابط أقسام الموقع هذا حساب Yahoo! حقل اليابان فقط. |
useSearcherTimeZone |
ما إذا كان سيتم عرض مادة عرض رابط أقسام الموقع في المنطقة الزمنية لمستخدِم البحث. ينطبق ذلك على Microsoft Ads. |
mobilePreferred |
ما إذا كان الخيار المفضّل هو عرض مادة عرض رابط أقسام الموقع على الأجهزة الجوّالة. ينطبق ذلك على Microsoft Ads. |
UnifiedPageFeedAsset
مادة عرض خلاصة صفحة موحّدة.
تمثيل JSON |
---|
{ "pageUrl": string, "labels": [ string ] } |
الحقول | |
---|---|
pageUrl |
صفحة الويب التي يريد المعلِنون استهدافها. |
labels[] |
التصنيفات المستخدَمة لتجميع عناوين URL للصفحات |
MobileAppAsset
مادة عرض تمثل تطبيقًا متوافقًا مع الأجهزة الجوّالة.
تمثيل JSON |
---|
{
"appId": string,
"appStore": enum ( |
الحقول | |
---|---|
appId |
مطلوبة. سلسلة تعرِّف تطبيقًا متوافقًا مع الأجهزة الجوّالة بشكلٍ فريد. يجب أن يحتوي فقط على المعرّف الأصلي للنظام الأساسي، مثل "com.android.ebay" لنظام التشغيل Android أو "12345689" لنظام التشغيل iOS. |
appStore |
مطلوبة. متجر التطبيقات الذي يوزّع هذا التطبيق المحدّد. |
MobileAppVendor
نوع مورد تطبيق الأجهزة الجوّالة
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
APPLE_APP_STORE |
مورّد تطبيقات الأجهزة الجوّالة لمتجر تطبيقات Apple. |
GOOGLE_APP_STORE |
مورّد تطبيقات الأجهزة الجوّالة في متجر تطبيقات Google. |
UnifiedCallAsset
مادة عرض مكالمة موحّدة.
تمثيل JSON |
---|
{ "countryCode": string, "phoneNumber": string, "callConversionReportingState": enum ( |
الحقول | |
---|---|
countryCode |
رمز البلد المكوّن من حرفين لرقم الهاتف. على سبيل المثال: "مصر" و"مصر". |
phoneNumber |
رقم هاتف المعلن الأولي. أمثلة: "1234567890"، "(123)456-7890" |
callConversionReportingState |
يشير إلى ما إذا كان يجب على CallAsset هذا استخدام إعداد الإحالة الناجحة للمكالمات الخاص به، أو اتّباع الإعداد على مستوى الحساب، أو إيقاف الإحالة الناجحة عبر الاتصال الهاتفي. |
callConversionAction |
إجراء الإحالة الناجحة المطلوب إسناد إحالة ناجحة عبر الاتصال إليه. وفي حال تم تركها بدون ضبط، يتم استخدام إجراء الإحالة الناجحة التلقائي. لن يكون لهذا الحقل تأثير إلا في حال ضبط callConversionReportingState على USE_Resource_LEVEL_CALL_CONVERSION_ACTION. |
adScheduleTargets[] |
قائمة بجداول غير متداخلة تحدّد كل الفواصل الزمنية التي قد تظهر فيها مادة العرض. يمكن أن تكون هناك 6 جداول زمنية كحد أقصى في اليوم، إجمالي 42 جدولاً. |
callOnly |
ما إذا كانت المكالمة تعرض رقم الهاتف فقط بدون رابط للموقع الإلكتروني ينطبق ذلك على Microsoft Ads. |
callTrackingEnabled |
ما إذا كان يجب تفعيل المكالمة عند تتبُّع المكالمات. ينطبق ذلك على Microsoft Ads. |
useSearcherTimeZone |
ما إذا كان سيتم عرض إضافة المكالمة في المنطقة الزمنية لمستخدم البحث. ينطبق ذلك على Microsoft Ads. |
startDate |
تاريخ البدء الذي ستكون فيه مادة العرض هذه سارية المفعول ويمكن بدء عرضها، بالتنسيق yyyy-MM-dd. |
endDate |
التاريخ الأخير الذي ستكون فيه مادة العرض هذه سارية المفعول ولا تزال معروضة، بالتنسيق yyyy-MM-dd. |
CallConversionReportingState
أنواع البيانات المحتملة لحالة إجراء إحالة ناجحة عبر الاتصال الهاتفي.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
DISABLED |
تم إيقاف إجراء الإحالة الناجحة للمكالمة. |
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION |
سيستخدِم إجراء الإحالة الناجحة عبر الاتصال الهاتفي نوع الإحالة الناجحة عبر الاتصال الهاتفي المحدّد على مستوى الحساب. |
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION |
سيستخدم إجراء الإحالة الناجحة عبر الاتصال الهاتفي نوع الإحالة الناجحة عبر الاتصال الهاتفي المحدّد على مستوى المورد (إعلانات للاتصال فقط/إضافات المكالمات). |
CallToActionAsset
مادة عرض عبارة الحثّ على اتّخاذ إجراء.
تمثيل JSON |
---|
{
"callToAction": enum ( |
الحقول | |
---|---|
callToAction |
عبارة الحث على اتّخاذ إجراء. |
CallToActionType
يشير عمود التعداد إلى الأنواع المحتمَلة من عبارات الحث على اتّخاذ إجراء.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
LEARN_MORE |
نوع عبارة الحث على اتخاذ إجراء هو "مزيد من المعلومات". |
GET_QUOTE |
نوع عبارة الحث على اتخاذ إجراء هو "الحصول على عرض أسعار تقديري". |
APPLY_NOW |
أصبح نوع عبارة الحث على اتّخاذ إجراء ساريًا الآن. |
SIGN_UP |
نوع عبارة الحث على اتخاذ إجراء هو الاشتراك. |
CONTACT_US |
نوع العبارة التي تحث المستخدم على اتخاذ إجراء هو "التواصل معنا". |
SUBSCRIBE |
نوع عبارة الحث على اتخاذ إجراء هو "اشتراك". |
DOWNLOAD |
نوع العبارة التي تحث المستخدم على اتخاذ إجراء هو "تنزيل". |
BOOK_NOW |
النوع الذي تحث المستخدم على اتخاذ إجراء هو الحجز الآن. |
SHOP_NOW |
نوع عبارة الحث على اتّخاذ إجراء هو "تسوّق الآن". |
BUY_NOW |
نوع عبارة الحث على اتخاذ إجراء هو الشراء الآن. |
DONATE_NOW |
نوع العبارة التي تحث المستخدم على اتخاذ إجراء هو "التبرع الآن". |
ORDER_NOW |
نوع عبارة الحث على اتخاذ إجراء هو الطلب الآن. |
PLAY_NOW |
نوع العبارة التي تحث المستخدم على اتخاذ إجراء هو التشغيل الآن. |
SEE_MORE |
يمكن الاطّلاع على المزيد من المعلومات من خلال نوع عبارة الحث على اتخاذ إجراء. |
START_NOW |
بدأ الآن نوع عبارة الحث على اتّخاذ إجراء. |
VISIT_SITE |
نوع العبارة التي تحث المستخدم على اتخاذ إجراء هو زيارة الموقع. |
WATCH_NOW |
نوع العبارة التي تحث المستخدم على اتخاذ إجراء هو "المشاهدة الآن". |
UnifiedLocationAsset
مادة عرض موقع جغرافي موحَّدة
تمثيل JSON |
---|
{ "placeId": string, "businessProfileLocations": [ { object ( |
الحقول | |
---|---|
placeId |
تحدد أرقام تعريف الأماكن بشكل فريد مكانًا في قاعدة بيانات أماكن Google وعلى خرائط Google. هذا الحقل فريد لرقم تعريف عميل ونوع مادة عرض معيّنة. راجع https://developers.google.com/places/web-service/place-id لمزيد من المعلومات عن رقم تعريف المكان. |
businessProfileLocations[] |
قائمة المواقع الجغرافية للنشاط التجاري للعميل. لن يظهر هذا الخيار إلا في حال مزامنة مادة عرض الموقع الجغرافي من حساب "الملف التجاري". من الممكن أن يكون لديك بطاقات بيانات متعددة للملف التجاري ضمن الحساب نفسه والتي تشير إلى رقم تعريف المكان نفسه. |
locationOwnershipType |
نوع ملكية الموقع الجغرافي. إذا كان النوع Business_OWNER، سيتم عرضه كإضافة موقع جغرافي. إذا كان النوع "شريك تابع"، سيتم عرضه كموقع جغرافي للشركاء التابعين. |
BusinessProfileLocation
تمت مزامنة بيانات الموقع الجغرافي في "الملف التجاري على Google" من حساب "الملف التجاري" المرتبط.
تمثيل JSON |
---|
{ "labels": [ string ], "storeCode": string, "listingId": string } |
الحقول | |
---|---|
labels[] |
تصنيف المعلِن الذي حدَّد للموقع الجغرافي في حساب "الملف التجاري" وتتم مزامنة هذه البيانات من حساب "الملف التجاري". |
storeCode |
رمز متجر "الملف التجاري" لهذا الموقع الجغرافي وتتم مزامنة هذه البيانات من حساب "الملف التجاري". |
listingId |
رقم تعريف بيانات الموقع الجغرافي لهذا الملف التجاري وتتم مزامنة هذه البيانات من حساب "الملف التجاري" المرتبط. |
LocationOwnershipType
الأنواع المحتملة لملكية الموقع الجغرافي
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
BUSINESS_OWNER |
مالك النشاط التجاري للموقع الجغرافي(إضافة الموقع الجغرافي القديمة - LE). |
AFFILIATE |
موقع المعلن الجغرافي(إضافة موقع جغرافي تابعة لجهة خارجية - ALE). |
AssetGroupAsset
AssetGroupAsset هي الرابط بين مادة عرض ومجموعة مواد عرض. تؤدي إضافة AssetGroupAsset إلى ربط مادة عرض بمجموعة مواد عرض.
تمثيل JSON |
---|
{ "resourceName": string, "assetGroup": string, "asset": string, "fieldType": enum ( |
الحقول | |
---|---|
resourceName |
اسم المورد لمادة العرض الخاصة بمجموعة مواد العرض يكون اسم مورد مادة العرض ضمن مجموعة مواد العرض على النحو التالي:
|
assetGroup |
مجموعة مواد العرض التي تربطها مادة عرض مجموعة مواد العرض هذه. |
asset |
مادة العرض التي تربطها مادة عرض مجموعة مواد العرض هذه. |
fieldType |
وصف موضع إعلان مادة العرض ضمن مجموعة مواد العرض. على سبيل المثال: HEADLINE وYOUTUBE_VIDEO وما إلى ذلك |
status |
حالة الرابط بين مادة عرض ومجموعة مواد عرض. |
AssetFieldType
يشير هذا المقياس إلى قيم التعداد التي تصف المواضع المحتملة لمادة عرض.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
HEADLINE |
تم ربط مادة العرض لاستخدامها كعنوان. |
DESCRIPTION |
تم ربط مادة العرض لاستخدامها كوصف. |
MANDATORY_AD_TEXT |
تم ربط مادة العرض لاستخدامها كنص إعلان إلزامي. |
MARKETING_IMAGE |
مادة العرض مرتبطة لاستخدامها كصورة تسويقية. |
MEDIA_BUNDLE |
تم ربط مادة العرض لاستخدامها كحِزمة وسائط. |
YOUTUBE_VIDEO |
تم ربط مادة العرض لاستخدامها كفيديو على YouTube. |
BOOK_ON_GOOGLE |
يتم ربط مادة العرض للإشارة إلى أنّه تم تفعيل ميزة "الحجز على Google" لحملة فنادق. |
LEAD_FORM |
تم ربط مادة العرض لاستخدامها كإضافة لنموذج عملاء محتملين. |
PROMOTION |
تم ربط مادة العرض لاستخدامها كإضافة عروض ترويجية. |
CALLOUT |
تم ربط مادة العرض لاستخدامها كإضافة وسائل شرح. |
STRUCTURED_SNIPPET |
مادة العرض مرتبطة للاستخدام كإضافة مقتطفات من الموقع. |
SITELINK |
تم ربط مادة العرض لاستخدامها كرابط أقسام موقع. |
MOBILE_APP |
تم ربط مادة العرض لاستخدامها كإضافة لتطبيق متوافق مع الأجهزة الجوّالة. |
HOTEL_CALLOUT |
تم ربط مادة العرض لاستخدامها كإضافة وسائل شرح للفنادق. |
CALL |
تم ربط مادة العرض لاستخدامها كإضافة مكالمة. |
PRICE |
تم ربط مادة العرض لاستخدامها على أنّها معلومات سعر إضافية. |
LONG_HEADLINE |
مادة العرض مرتبطة للاستخدام كعنوان طويل. |
BUSINESS_NAME |
مادة العرض مرتبطة للاستخدام كاسم للنشاط التجاري. |
SQUARE_MARKETING_IMAGE |
مادة العرض مرتبطة لاستخدامها كصورة تسويقية مربّعة. |
PORTRAIT_MARKETING_IMAGE |
مادة العرض مرتبطة لاستخدامها كصورة تسويقية عمودية. |
LOGO |
تم ربط مادة العرض لاستخدامها كشعار. |
LANDSCAPE_LOGO |
تم ربط مادة العرض لاستخدامها كشعار أفقي. |
VIDEO |
تم ربط مادة العرض لاستخدامها كشعار غير تابع لمنصة YouTube. |
CALL_TO_ACTION_SELECTION |
تم ربط مادة العرض لاستخدامها لاختيار عبارة حث على اتخاذ إجراء. |
AD_IMAGE |
ترتبط مادة العرض لاستخدامها لاختيار صورة إعلان. |
BUSINESS_LOGO |
مادة العرض مرتبطة لاستخدامها كشعار للنشاط التجاري. |
HOTEL_PROPERTY |
تم ربط مادة العرض لاستخدامها كفندق في "حملة أداء أفضل" مستندة إلى أهداف السفر. |
DISCOVERY_CAROUSEL_CARD |
تم ربط مادة العرض لاستخدامها كبطاقة منصّة عرض بعناصر متغيّرة أثناء التصفّح. |
AssetGroupSignal
تُمثِّل AssetGroupSignal إشارة في مجموعة مواد عرض. يؤدي توفُّر إشارة إلى إعلام "حملة الأداء الأفضل" بالمستخدمين الذين يزداد احتمال أن يُجروا إحالة ناجحة. وتستخدِم "حملات الأداء الأفضل" هذه الإشارة للبحث عن مستخدِمين جدد لديهم نيّة شراء مشابهة أو أقوى حتى تتمكّن من العثور على إحالات ناجحة على مستوى "الحملات على شبكة البحث" و"الشبكة الإعلانية" و"حملات الفيديو" وغير ذلك.
تمثيل JSON |
---|
{ "resourceName": string, "assetGroup": string, // Union field |
الحقول | |
---|---|
resourceName |
اسم المورد لإشارة مجموعة مواد العرض. يكون اسم مورد إشارة مجموعة مواد العرض على النحو التالي:
|
assetGroup |
مجموعة مواد العرض التي تنتمي إليها إشارة مجموعة مواد العرض هذه. |
حقل الاتحاد signal إشارة مجموعة مواد العرض. يمكن أن يكون الحقل "signal " واحدًا فقط مما يلي: |
|
audience |
إشارة الجمهور التي ستستخدِمها "حملة الأداء الأفضل" |
AudienceInfo
معيار جمهور.
تمثيل JSON |
---|
{ "audience": string } |
الحقول | |
---|---|
audience |
اسم مورد الجمهور. |
AssetGroupListingGroupFilter
يمثّل AssetGroupListingGroupFilter عقدة شجرة بيانات لمجموعة البيانات في مجموعة مواد عرض.
تمثيل JSON |
---|
{ "resourceName": string, "assetGroup": string, "id": string, "type": enum ( |
الحقول | |
---|---|
resourceName |
اسم المصدر لفلتر مجموعة بيانات مجموعة مواد العرض يكون اسم مورد فلتر مجموعة بيانات مجموعة مواد العرض على النحو التالي:
|
assetGroup |
مجموعة مواد العرض التي يشكّل فلتر مجموعة بيانات مجموعة مواد العرض هذا جزءًا منها. |
id |
رقم تعريف ListingGroupFilter. |
type |
نوع عقدة فلتر مجموعة البيانات. |
vertical |
العمود الذي تمثله شجرة العُقد الحالية. يجب أن تنتمي جميع العُقد في نفس الشجرة إلى العمود نفسه. |
caseValue |
قيمة السمة التي تعمل بها مجموعة البيانات هذه على تحسين عنصرها الرئيسي. غير معرَّف للمجموعة الجذر. |
parentListingGroupFilter |
اسم المورد للقسم الفرعي لمجموعة البيانات الرئيسية. قيمة فارغة لعقدة فلتر مجموعة بيانات الجذر. |
path |
مسار السمات التي تحدِّد فلتر مجموعة البيانات هذا. |
ListingGroupFilterType
نوع فلتر مجموعة البيانات.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
SUBDIVISION |
قسم فرعي من المنتجات إلى جانب بعض سمات البيانات |
UNIT_INCLUDED |
تمثّل هذه السمة عقدة طرفية مضمّنة لفلتر مجموعة البيانات. |
UNIT_EXCLUDED |
عقدة طرفية لفلتر مجموعة بيانات مستبعدة. |
ListingGroupFilterVertical
نوع فئة فلتر مجموعة البيانات.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
SHOPPING |
يمثل ذلك مجال التسوّق. لا يُسمح بالمجال إلّا في "حملات الأداء الأفضل" للبيع بالتجزئة. |
ListingGroupFilterDimension
سمات البيانات لفلتر مجموعة بيانات مجموعة مواد العرض
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد dimension ويكون أحد السمات الواردة أدناه موجودًا دائمًا. يمكن أن يكون الحقل "dimension " واحدًا فقط مما يلي: |
|
productBiddingCategory |
فئة عروض الأسعار لعرض منتج. |
productBrand |
العلامة التجارية لعرض المنتج. |
productChannel |
المنطقة المحلية لعرض المنتج. |
productCondition |
حالة عرض المنتج. |
productCustomAttribute |
السمة المخصّصة لعرض منتج. |
productItemId |
معرّف السلعة لعرض منتج معيّن. |
productType |
نوع العرض الترويجي للمنتج. |
ProductBiddingCategory
عنصر واحد في فئة عروض الأسعار على مستوى معيّن وفئات المستوى الأعلى تكون في المستوى 1، وأطفالهم في المستوى 2، وهكذا. نتيح حاليًا استخدام ما يصل إلى 5 مستويات. يجب أن يحدّد المستخدِم نوع سمة يشير إلى مستوى الفئة. يجب أن يكون لكل حالات التقسيم الفرعي نفسه نوع السمة نفسه (مستوى الفئة).
تمثيل JSON |
---|
{
"level": enum ( |
الحقول | |
---|---|
level |
يشير إلى مستوى الفئة في التصنيف. |
id |
رقم تعريف فئة عروض أسعار المنتج. يعادل هذا المعرّف رقم تعريف فئة_المنتجات google_product_category كما هو موضّح في هذه المقالة: https://support.google.com/merchants/answer/6324436 |
ListingGroupFilterBiddingCategoryLevel
مستوى فئة عروض أسعار فلتر مجموعة البيانات.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
LEVEL1 |
المستوى 1. |
LEVEL2 |
المستوى 2. |
LEVEL3 |
المستوى 3. |
LEVEL4 |
المستوى 4. |
LEVEL5 |
المستوى 5. |
ProductBrand
العلامة التجارية للمنتج
تمثيل JSON |
---|
{ "value": string } |
الحقول | |
---|---|
value |
قيمة السلسلة للعلامة التجارية للمنتج |
ProductChannel
المنطقة المحلية لعرض المنتج.
تمثيل JSON |
---|
{
"channel": enum ( |
الحقول | |
---|---|
channel |
قيمة المنطقة المحلية |
ListingGroupFilterProductChannel
يشير هذا المقياس إلى قيم التعداد التي تصف المنطقة المحلية لعرض منتج.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
ONLINE |
يتم بيع السلعة على الإنترنت. |
LOCAL |
يتم بيع السلعة في المتاجر المحلية. |
ProductCondition
حالة عرض المنتج.
تمثيل JSON |
---|
{
"condition": enum ( |
الحقول | |
---|---|
condition |
قيمة الشرط. |
ListingGroupFilterProductCondition
يشير هذا المقياس إلى قيم التعداد التي تصف حالة عرض المنتج.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
NEW |
أن تكون حالة المنتج جديدة. |
REFURBISHED |
حالة المنتج مجدَّد. |
USED |
يتم استخدام حالة المنتج. |
ProductCustomAttribute
السمة المخصّصة لعرض منتج.
تمثيل JSON |
---|
{
"index": enum ( |
الحقول | |
---|---|
index |
يشير إلى فهرس السمة المخصّصة. |
value |
قيمة السلسلة للسمة المخصّصة للمنتج. |
ListingGroupFilterCustomAttributeIndex
فهرس سمات العملاء.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
INDEX0 |
السمة المخصّصة لفلتر مجموعة البيانات الأولى. |
INDEX1 |
السمة المخصّصة الثانية لفلتر مجموعة البيانات: |
INDEX2 |
السمة المخصّصة لفلتر مجموعة البيانات الثالثة. |
INDEX3 |
السمة المخصّصة لفلتر مجموعة البيانات الرابعة. |
INDEX4 |
السمة المخصّصة لفلتر مجموعة البيانات الخامسة. |
ProductItemId
معرّف السلعة لعرض منتج معيّن.
تمثيل JSON |
---|
{ "value": string } |
الحقول | |
---|---|
value |
قيمة المعرّف |
ProductType
نوع العرض الترويجي للمنتج.
تمثيل JSON |
---|
{
"level": enum ( |
الحقول | |
---|---|
level |
تمثّل هذه السمة مستوى النوع. |
value |
قيمة النوع. |
ListingGroupFilterProductTypeLevel
يشير هذا المقياس إلى قيم التعداد التي تصف مستوى نوع عرض المنتج.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
LEVEL1 |
المستوى 1. |
LEVEL2 |
المستوى 2. |
LEVEL3 |
المستوى 3. |
LEVEL4 |
المستوى 4. |
LEVEL5 |
المستوى 5. |
ListingGroupFilterDimensionPath
المسار الذي يحدِّد السمات التي تحدِّد فلتر مجموعة البيانات.
تمثيل JSON |
---|
{
"dimensions": [
{
object ( |
الحقول | |
---|---|
dimensions[] |
المسار الكامل للسمات من خلال العرض الهرمي لفلتر مجموعة البيانات (باستثناء العقدة الجذر) إلى فلتر مجموعة البيانات هذا. |
AssetGroupTopCombinationView
عرض حول استخدام مجموعة مواد عرض إعلانات المجموعة الإعلانية.
تمثيل JSON |
---|
{
"resourceName": string,
"assetGroupTopCombinations": [
{
object ( |
الحقول | |
---|---|
resourceName |
اسم المورد لعرض مجموعة مواد العرض بأعلى مجموعة مواد العرض تكون أسماء موارد عرض مجموعة مواد العرض في أعلى مجموعة مواد العرض على النحو التالي: `"customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}" |
assetGroupTopCombinations[] |
أفضل مجموعات مواد العرض التي ظهرت معًا. |
AssetGroupAssetCombinationData
بيانات تركيبات مواد العرض في مجموعة مواد العرض
تمثيل JSON |
---|
{
"assetCombinationServedAssets": [
{
object ( |
الحقول | |
---|---|
assetCombinationServedAssets[] |
مواد العرض المعروضة. |
AssetUsage
تحتوي على معلومات استخدام مادة العرض.
تمثيل JSON |
---|
{
"asset": string,
"servedAssetFieldType": enum ( |
الحقول | |
---|---|
asset |
اسم المورد لمادة العرض |
servedAssetFieldType |
نوع الحقل المعروض لمادة العرض. |
ServedAssetFieldType
أنواع حقول مواد العرض المحتملة.
عمليات التعداد | |
---|---|
UNSPECIFIED |
لم يتم تحديد قيمة. |
UNKNOWN |
القيمة المُستلَمة غير معروفة في هذا الإصدار. هذه قيمة للاستجابة فقط. |
HEADLINE_1 |
مادة العرض مستخدَمة في العنوان 1. |
HEADLINE_2 |
يتم استخدام مادة العرض في العنوان 2. |
HEADLINE_3 |
يتم استخدام مادة العرض في العنوان 3. |
DESCRIPTION_1 |
تُستخدم مادة العرض في الوصف 1. |
DESCRIPTION_2 |
تُستخدم مادة العرض في الوصف 2. |
HEADLINE |
تم استخدام مادة العرض في عنوان. لا تستخدم هذه السمة إلا في حال وجود عنوان واحد فقط في الإعلان. بخلاف ذلك، يمكنك استخدام التعدادات HEADLINE_1 أو HEADLINE_2 أو HEADLINE_3 |
HEADLINE_IN_PORTRAIT |
تم استخدام مادة العرض كعنوان في الصورة العمودية. |
LONG_HEADLINE |
تمّ استخدام مادة العرض في عنوان طويل (مُستخدَم في متعدد مواد العرض المتجاوبة). |
DESCRIPTION |
تم استخدام مادة العرض في الوصف. لا تستخدم هذا الخيار إلا إذا كان هناك وصف واحد فقط في الإعلان. في الحالات الأخرى، استخدم التعدادين DESCRIPTION_1 أو DESCRIPTION_@. |
DESCRIPTION_IN_PORTRAIT |
تم استخدام مادة العرض كوصف في الصورة العمودية. |
BUSINESS_NAME_IN_PORTRAIT |
تم استخدام مادة العرض كاسم للنشاط التجاري في الصورة العمودية. |
BUSINESS_NAME |
تم استخدام مادة العرض كاسم للنشاط التجاري. |
MARKETING_IMAGE |
تم استخدام مادة العرض كصورة تسويقية. |
MARKETING_IMAGE_IN_PORTRAIT |
تم استخدام مادة العرض كصورة تسويقية في صورة عمودية. |
SQUARE_MARKETING_IMAGE |
تم استخدام مادة العرض كصورة تسويقية مربّعة. |
PORTRAIT_MARKETING_IMAGE |
تم استخدام مادة العرض كصورة تسويقية عمودية. |
LOGO |
تم استخدام مادة العرض كشعار. |
LANDSCAPE_LOGO |
تم استخدام مادة العرض كشعار أفقي. |
CALL_TO_ACTION |
تم استخدام مادة العرض كعبارة تحث المستخدم على اتخاذ إجراء. |
YOU_TUBE_VIDEO |
تم استخدام مادة العرض كفيديو على YouTube. |
SITELINK |
يتم استخدام مادة العرض هذه كرابط أقسام موقع. |
CALL |
يتمّ استخدام مادة العرض هذه كمكالمة. |
MOBILE_APP |
يتمّ استخدام مادة العرض هذه كتطبيق متوافق مع الأجهزة الجوّالة. |
CALLOUT |
يتمّ استخدام مادة العرض هذه كوسيلة شرح. |
STRUCTURED_SNIPPET |
يتم استخدام مادة العرض هذه كمقتطف من الموقع. |
PRICE |
يتمّ استخدام مادة العرض هذه كسعر. |
PROMOTION |
يتمّ استخدام مادة العرض هذه كعرض ترويجي. |
AD_IMAGE |
يتم استخدام مادة العرض هذه كصورة. |
LEAD_FORM |
يتم استخدام مادة العرض كنموذج عملاء محتملين. |
BUSINESS_LOGO |
يتم استخدام مادة العرض كشعار للنشاط التجاري. |
AssetGroup
مجموعة مواد عرض. يتمّ استخدام AssetGroupAsset لربط مادة عرض بمجموعة مواد العرض. يتمّ استخدام AssetGroupSignal لربط إشارة بمجموعة مواد عرض.
تمثيل JSON |
---|
{ "resourceName": string, "id": string, "campaign": string, "name": string, "finalUrls": [ string ], "finalMobileUrls": [ string ], "status": enum ( |
الحقول | |
---|---|
resourceName |
اسم المورد لمجموعة مواد العرض. تكون أسماء موارد مجموعة مواد العرض على النحو التالي:
|
id |
رقم تعريف مجموعة مواد العرض. |
campaign |
الحملة التي ترتبط بها مجموعة مواد العرض هذه. مادة العرض المرتبطة بمجموعة مواد العرض. |
name |
مطلوبة. اسم مجموعة مواد العرض مطلوبة. يجب أن يبلغ طولها 1 كحد أدنى و128 طولاً كحد أقصى. ويجب أن يكون فريدًا ضمن أي حملة. |
finalUrls[] |
قائمة بعناوين URL النهائية بعد جميع عمليات إعادة التوجيه عبر النطاقات. في حملات "الأداء الأفضل"، تكون عناوين URL تلقائيًا مؤهَّلة للتوسيع ما لم يتم إيقافها. |
finalMobileUrls[] |
قائمة بعناوين URL النهائية للأجهزة الجوّالة بعد جميع عمليات إعادة التوجيه عبر النطاقات. في حملات "الأداء الأفضل"، تكون عناوين URL تلقائيًا مؤهَّلة للتوسيع ما لم يتم إيقافها. |
status |
حالة مجموعة مواد العرض. |
path1 |
الجزء الأول من النص الذي قد يظهر مُلحقًا بعنوان URL المعروض في الإعلان |
path2 |
الجزء الثاني من النص الذي قد يظهر مُلحقًا بعنوان URL المعروض في الإعلان لا يمكن ضبط هذا الحقل إلا عند ضبط المسار 1. |
adStrength |
إجمالي قوة الإعلان لمجموعة مواد العرض هذه. |
AssetGroupStatus
الحالات المحتملة لمجموعة مواد عرض.
عمليات التعداد | |
---|---|
UNSPECIFIED |
لم يتمّ تحديد الحالة. |
UNKNOWN |
القيمة المُستلَمة غير معروفة في هذا الإصدار. |
ENABLED |
تم تفعيل مجموعة مواد العرض. |
PAUSED |
تم إيقاف مجموعة مواد العرض مؤقتًا. |
REMOVED |
تتم إزالة مجموعة مواد العرض. |
AdStrength
قائمة تعداد نقاط قوة الإعلان المحتملة
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
PENDING |
قوة الإعلان في انتظار المراجعة حاليًا. |
NO_ADS |
تعذَّر إنشاء أيّ إعلانات. |
POOR |
القوة ضعيفة. |
AVERAGE |
متوسط القوة. |
GOOD |
قوة جيدة. |
EXCELLENT |
قوة ممتازة. |
AssetSetAsset
AssetSetAsset هو الرابط بين مادة عرض ومجموعة مواد عرض. تؤدي إضافة AssetSetAsset إلى ربط مادة عرض بمجموعة مواد عرض.
تمثيل JSON |
---|
{
"resourceName": string,
"assetSet": string,
"asset": string,
"status": enum ( |
الحقول | |
---|---|
resourceName |
اسم المورد لمادة عرض مجموعة مواد العرض تكون أسماء موارد مواد العرض ضمن مجموعة مواد العرض على النحو التالي:
|
assetSet |
مجموعة مواد العرض التي ترتبط بها مادة عرض مجموعة مواد العرض هذه. |
asset |
مادة العرض التي ترتبط بها مادة عرض مجموعة مواد العرض هذه. |
status |
حالة مادة عرض مجموعة مواد العرض. للقراءة فقط |
AssetSetAssetStatus
الحالات المحتملة لمادة عرض مجموعة مواد العرض.
عمليات التعداد | |
---|---|
UNSPECIFIED |
لم يتمّ تحديد الحالة. |
UNKNOWN |
القيمة المُستلَمة غير معروفة في هذا الإصدار. هذه قيمة للاستجابة فقط. |
ENABLED |
مادة عرض مجموعة مواد العرض مفعَّلة. |
REMOVED |
تتم إزالة مادة عرض مجموعة مواد العرض. |
AssetSet
مجموعة مواد عرض تمثِّل مجموعة من مواد العرض. استخدِم AssetSetAsset لربط مادة عرض بمجموعة مواد العرض.
تمثيل JSON |
---|
{ "id": string, "resourceName": string } |
الحقول | |
---|---|
id |
رقم تعريف مجموعة مواد العرض. |
resourceName |
اسم المورد لمجموعة مواد العرض. وتكون أسماء موارد مجموعة مواد العرض على النحو التالي:
|
BiddingStrategy
استراتيجية عروض الأسعار.
تمثيل JSON |
---|
{ "resourceName": string, "status": enum ( |
الحقول | |
---|---|
resourceName |
اسم مورد استراتيجية عروض الأسعار. تكون أسماء موارد استراتيجية عروض الأسعار على النحو التالي:
|
status |
حالة استراتيجية عروض الأسعار. هذا الحقل للقراءة فقط. |
type |
نوع استراتيجية عروض الأسعار. أنشِئ استراتيجية عروض أسعار عن طريق إعداد مخطط عروض الأسعار. هذا الحقل للقراءة فقط. |
currencyCode |
العملة المستخدمة في استراتيجية عروض الأسعار (رمز مكوّن من ثلاثة أحرف وفقًا لمعيار ISO 4217). بالنسبة إلى استراتيجيات عروض الأسعار في حسابات العملاء الإدارية، يمكن ضبط هذه العملة عند الإنشاء، ويتم ضبطها تلقائيًا على عملة العميل الإداري. لا يمكن ضبط هذا الحقل لتقديم الخدمات للعملاء، فجميع الاستراتيجيات المتعلقة بالعميل الذي يقدّم الخدمة تستخدم بشكل ضمني عملة العميل الذي يقدّم الخدمة. في جميع الحالات، يعرض الحقلنشطCurrencyCode العملة المستخدَمة في الاستراتيجية. |
id |
رقم تعريف استراتيجية عروض الأسعار. |
name |
اسم استراتيجية عروض الأسعار. يجب تسمية جميع استراتيجيات عروض الأسعار ضمن الحساب بشكلٍ فريد. يجب أن يتراوح طول هذه السلسلة بين 1 و255، بشكل شامل، بترميز UTF-8 بايت، (قطع). |
effectiveCurrencyCode |
العملة المستخدمة في استراتيجية عروض الأسعار (رمز مكوّن من ثلاثة أحرف وفقًا لمعيار ISO 4217). بالنسبة إلى استراتيجيات عروض الأسعار في العملاء الإداريين، هذه هي العملة التي حدّدها المعلِن عند إنشاء الاستراتيجية. بالنسبة إلى العملاء الذين يتم تقديم الخدمات لهم، يتم استخدام رمز عملة العميل. يتم تسجيل مقاييس استراتيجية عروض الأسعار بهذه العملة. هذا الحقل للقراءة فقط. |
campaignCount |
عدد الحملات المرفقة باستراتيجية عروض الأسعار هذه. هذا الحقل للقراءة فقط. |
nonRemovedCampaignCount |
عدد الحملات التي لم تتم إزالتها المرفقة باستراتيجية عروض الأسعار هذه. هذا الحقل للقراءة فقط. |
حقل الاتحاد يمكن ضبط سمة واحدة فقط. يمكن أن يكون الحقل " |
|
enhancedCpc |
استراتيجية عروض أسعار ترفع عروض أسعار النقرات التي يُرجح أن تؤدي إلى إحالة ناجحة، وتخفض عروض الأسعار للنقرات التي يقل فيها احتمال حدوثها. |
maximizeConversionValue |
استراتيجية عروض أسعار مبرمَجة للمساعدة في الحصول على أقصى قيمة للإحالة الناجحة لحملاتك في حدود ميزانيتك |
maximizeConversions |
استراتيجية عروض أسعار مبرمَجة للمساعدة في الحصول على أكبر عدد من الإحالات الناجحة لحملاتك في حدود ميزانيتك |
targetCpa |
استراتيجية عروض أسعار تعمل على ضبط عروض الأسعار لمساعدتك في الحصول على أكبر عدد ممكن من الإحالات الناجحة بتكلفة الإجراء المستهدَفة التي تحدّدها. |
targetImpressionShare |
استراتيجية عروض أسعار يتم تحسينها تلقائيًا لزيادة نسبة مئوية مختارة من مرات الظهور. |
targetOutrankShare |
يشير ذلك المصطلح إلى استراتيجية عروض أسعار تحدِّد عروض الأسعار استنادًا إلى الجزء المستهدَف من المزادات التي يجب أن يحصل فيها المعلِن على مرتبة أعلى من منافس معيّن. تم إيقاف العمل بهذا الحقل. وسيتعذّر إنشاء استراتيجية عروض أسعار جديدة في هذا الحقل أو إرفاق استراتيجيات عروض الأسعار مع هذا الحقل بإحدى الحملات. يُسمح بإجراء عمليات التغيير إلى الاستراتيجيات التي تمت تعبئة هذا المخطط لها حاليًا. |
targetRoas |
استراتيجية عروض أسعار تساعدك على زيادة الأرباح إلى أقصى حد مع بلوغ متوسط عائد إنفاق إعلاني مستهدَف معيّن. |
targetSpend |
استراتيجية عروض أسعار تحدِّد عروض أسعارك لمساعدتك في الحصول على أكبر عدد ممكن من النقرات في حدود ميزانيتك. |
BiddingStrategyStatus
الحالات المحتملة لاستراتيجية عروض الأسعار.
عمليات التعداد | |
---|---|
UNSPECIFIED |
لم يتم تحديد قيمة. |
UNKNOWN |
القيمة المُستلَمة غير معروفة في هذا الإصدار. هذه قيمة للاستجابة فقط. |
ENABLED |
تم تفعيل استراتيجية عروض الأسعار. |
REMOVED |
تمت إزالة استراتيجية عروض الأسعار. |
BiddingStrategyType
رقم يصف أنواع استراتيجيات عروض الأسعار المحتملة.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
COMMISSION |
العمولات هي استراتيجية عروض أسعار تلقائية يدفع المعلِن فيها جزءًا معيّنًا من قيمة الإحالة الناجحة. |
ENHANCED_CPC |
تكلفة النقرة المحسّنة هي استراتيجية عروض أسعار ترفع عروض أسعار النقرات التي يُرجح أن تؤدي إلى إحالة ناجحة، وتخفضها مقابل النقرات التي يقل فيها احتمال حدوثها. |
INVALID |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يشير إلى أنّ الحملة لا تتضمن استراتيجية عروض أسعار. ويؤدي ذلك إلى منع الحملة من عرض الإعلانات. على سبيل المثال، قد يتم ربط حملة باستراتيجية عروض أسعار إدارية، ويتم بعد ذلك إلغاء ربط حساب عرض الإعلانات بالحساب الإداري. في هذه الحالة، سيتم فصل الحملة تلقائيًا عن استراتيجية عروض أسعار الحساب الإداري التي لا يمكن الوصول إليها وسيتم نقلها إلى نوع استراتيجية عروض الأسعار "غير صالح". |
MANUAL_CPA |
استراتيجية عروض أسعار يدوية تسمح للمعلِن بتحديد عرض السعر لكل إجراء يحدِّده المعلِن. |
MANUAL_CPC |
عروض الأسعار المستندة إلى النقرات اليدوية والتي يدفع فيها المستخدم مقابل كل نقرة |
MANUAL_CPM |
عروض الأسعار المستندة إلى مرات الظهور اليدوية التي يدفع فيها المستخدم مقابل كل ألف ظهور |
MANUAL_CPV |
استراتيجية عروض أسعار تدفع مبلغًا قابلاً للضبط لكل مشاهدة للفيديو. |
MAXIMIZE_CONVERSIONS |
استراتيجية عروض أسعار تعمل تلقائيًا على تحقيق الحد الأقصى من عدد الإحالات الناجحة وفقًا لميزانية يومية. |
MAXIMIZE_CONVERSION_VALUE |
استراتيجية عروض أسعار مبرمَجة تحدِّد عروض الأسعار تلقائيًا لتحقيق أكبر قدر من الأرباح مع إنفاق ميزانيتك |
PAGE_ONE_PROMOTED |
نظام عروض أسعار الصفحة الأولى المروّج لها، الذي يعيّن عروض الأسعار القصوى للنقرة لاستهداف مرات الظهور في الصفحة الأولى أو الخانات المروجة في الصفحة الأولى على google.com. تم إيقاف قيمة التعداد هذه نهائيًا. |
PERCENT_CPC |
تمثل النسبة المئوية لتكلفة النقرة استراتيجية عروض أسعار تشكل فيها عروض الأسعار جزءًا من السعر المعلَن عنه لبعض السلع أو الخدمات. |
TARGET_CPA |
التكلفة المستهدفة للإجراء هي استراتيجية عروض أسعار مُبرمَجة تُحدِّد عروض أسعار للمساعدة في الحصول على أكبر عدد ممكن من الإحالات الناجحة بالتكلفة المستهدفة للإجراء التي تحدِّدها. |
TARGET_CPM |
التكلفة المستهدفة لكل ألف ظهور هي استراتيجية عروض أسعار مُبرمَجة تُحدِّد عروض أسعار للمساعدة في الحصول على أكبر عدد ممكن من مرات الظهور بالتكلفة المستهدفة لكل ألف ظهور التي تحددها. |
TARGET_IMPRESSION_SHARE |
استراتيجية عروض أسعار مبرمَجة تعمل على ضبط عروض الأسعار بحيث تظهر نسبة معيّنة من الإعلانات على شبكة البحث أعلى الصفحة الأولى (أو أي موقع جغرافي آخر مستهدَف). |
TARGET_OUTRANK_SHARE |
"حصة المرتبة الأعلى المستهدفة" هي استراتيجية عروض أسعار مبرمَجة تحدِّد عروض الأسعار استنادًا إلى الجزء المستهدَف من المزادات التي يجب أن يحصل فيها المعلِن على مرتبة أعلى من منافس معيّن. تم إيقاف قيمة التعداد هذه. |
TARGET_ROAS |
"عائد الإنفاق الإعلاني المستهدف" هو استراتيجية عروض أسعار مبرمَجة تساعدك على زيادة الأرباح إلى أقصى حدّ مع احتساب متوسط عائد إنفاق إعلاني مستهدَف محدّد. |
TARGET_SPEND |
الإنفاق المستهدف هو استراتيجية عروض أسعار مُبرمَجة تُحدِّد عروض أسعارك للمساعدة في الحصول على أكبر عدد ممكن من النقرات في حدود ميزانيتك. |
EnhancedCpc
لا يشتمل هذا النوع على أي حقول.
استراتيجية عروض أسعار مبرمَجة ترفع عروض أسعار النقرات التي يزداد احتمال أن تؤدي إلى إحالة ناجحة، وتخفض عروض الأسعار للنقرات التي يقل فيها احتمال حدوثها
تم إيقاف استراتيجية عروض الأسعار هذه نهائيًا ولا يمكن إنشاؤها بعد ذلك. استخدِم يدويCpc مع ضبط قيمة النقرة المحسّنة على "صحيح" للوظائف المكافئة.
MaximizeConversionValue
استراتيجية عروض أسعار مبرمَجة للمساعدة في الحصول على أقصى قيمة للإحالة الناجحة لحملاتك في حدود ميزانيتك
تمثيل JSON |
---|
{ "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string, "targetRoas": number } |
الحقول | |
---|---|
cpcBidCeilingMicros |
الحد الأقصى لعروض الأسعار الذي يمكن ضبطه من خلال استراتيجية عروض الأسعار. وينطبق هذا الحد على جميع الكلمات الرئيسية التي تديرها الاستراتيجية. يمكن تغيير استراتيجيات المحفظة لعروض الأسعار فقط. |
cpcBidFloorMicros |
الحد الأدنى لعرض السعر الذي يمكن ضبطه من خلال استراتيجية عروض الأسعار. وينطبق هذا الحد على جميع الكلمات الرئيسية التي تديرها الاستراتيجية. يمكن تغيير استراتيجيات المحفظة لعروض الأسعار فقط. |
targetRoas |
خيار عائد الإنفاق الإعلاني المستهدَف (ROAS). وفي حال تحديدها، ستؤدي استراتيجية عروض الأسعار إلى زيادة الأرباح إلى أقصى حدّ مع احتساب متوسط عائد الإنفاق الإعلاني المستهدَف. إذا كان عائد الإنفاق الإعلاني المستهدف مرتفعًا، قد لا تتمكّن استراتيجية عروض الأسعار من إنفاق الميزانية بالكامل. وفي حال عدم ضبط عائد الإنفاق الإعلاني المستهدَف، ستهدِف استراتيجية عروض الأسعار إلى تحقيق أعلى عائد إنفاق إعلاني ممكن في الميزانية. |
MaximizeConversions
استراتيجية عروض أسعار مبرمَجة للمساعدة في الحصول على أكبر عدد من الإحالات الناجحة لحملاتك في حدود ميزانيتك
تمثيل JSON |
---|
{ "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string, "targetCpaMicros": string } |
الحقول | |
---|---|
cpcBidCeilingMicros |
الحد الأقصى لعروض الأسعار الذي يمكن ضبطه من خلال استراتيجية عروض الأسعار. وينطبق هذا الحد على جميع الكلمات الرئيسية التي تديرها الاستراتيجية. يمكن تغيير استراتيجيات المحفظة لعروض الأسعار فقط. |
cpcBidFloorMicros |
الحد الأدنى لعرض السعر الذي يمكن ضبطه من خلال استراتيجية عروض الأسعار. وينطبق هذا الحد على جميع الكلمات الرئيسية التي تديرها الاستراتيجية. يمكن تغيير استراتيجيات المحفظة لعروض الأسعار فقط. |
targetCpaMicros |
خيار التكلفة المستهدفة للإجراء. هذا هو متوسط المبلغ الذي تريد إنفاقه لكل إجراء إحالة ناجحة محدّد بالوحدات الصغيرة من عملة استراتيجية عروض الأسعار. وفي حال ضبطها، ستتلقّى استراتيجية عروض الأسعار أكبر عدد ممكن من الإحالات الناجحة بتكلفة الإجراء المستهدَفة أو أقل منها. في حال عدم ضبط التكلفة المستهدفة للإجراء، ستهدف استراتيجية عروض الأسعار إلى تحقيق أقل تكلفة ممكنة للإجراء في حدود الميزانية. |
TargetCpa
استراتيجية عروض أسعار مُبرمَجة تُحدِّد عروض الأسعار لمساعدتك في الحصول على أكبر عدد ممكن من الإحالات الناجحة بالتكلفة المستهدفة للإجراء التي تحدِّدها.
تمثيل JSON |
---|
{ "targetCpaMicros": string, "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string } |
الحقول | |
---|---|
targetCpaMicros |
متوسط تكلفة الإجراء المستهدفة. يجب أن تكون قيمة هذا الاستهداف أكبر من الحد الأدنى للوحدة القابلة للفوترة أو مساويًا له استنادًا إلى عملة الحساب. |
cpcBidCeilingMicros |
الحد الأقصى لعروض الأسعار الذي يمكن ضبطه من خلال استراتيجية عروض الأسعار. وينطبق هذا الحد على جميع الكلمات الرئيسية التي تديرها الاستراتيجية. يجب ضبط هذا الخيار لاستراتيجيات المحفظة لعروض الأسعار فقط. |
cpcBidFloorMicros |
الحد الأدنى لعرض السعر الذي يمكن ضبطه من خلال استراتيجية عروض الأسعار. وينطبق هذا الحد على جميع الكلمات الرئيسية التي تديرها الاستراتيجية. يجب ضبط هذا الخيار لاستراتيجيات المحفظة لعروض الأسعار فقط. |
TargetRoas
استراتيجية عروض أسعار مبرمَجة تساعدك على زيادة الأرباح إلى أقصى حد مع احتساب متوسط عائد إنفاق إعلاني مستهدَف محدّد
تمثيل JSON |
---|
{ "targetRoas": number, "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string } |
الحقول | |
---|---|
targetRoas |
مطلوبة. الأرباح المختارة (استنادًا إلى بيانات الإحالات الناجحة) لكل وحدة إنفاق. يجب أن تتراوح القيمة بين 0.01 و1000.0، بشكل شامل. |
cpcBidCeilingMicros |
الحد الأقصى لعروض الأسعار الذي يمكن ضبطه من خلال استراتيجية عروض الأسعار. وينطبق هذا الحد على جميع الكلمات الرئيسية التي تديرها الاستراتيجية. يجب ضبط هذا الخيار لاستراتيجيات المحفظة لعروض الأسعار فقط. |
cpcBidFloorMicros |
الحد الأدنى لعرض السعر الذي يمكن ضبطه من خلال استراتيجية عروض الأسعار. وينطبق هذا الحد على جميع الكلمات الرئيسية التي تديرها الاستراتيجية. يجب ضبط هذا الخيار لاستراتيجيات المحفظة لعروض الأسعار فقط. |
TargetSpend
استراتيجية عروض أسعار مُبرمَجة تُحدِّد عروض أسعارك للمساعدة في الحصول على أكبر عدد ممكن من النقرات في حدود ميزانيتك.
تمثيل JSON |
---|
{ "targetSpendMicros": string, "cpcBidCeilingMicros": string } |
الحقول | |
---|---|
targetSpendMicros |
الإنفاق المستهدف الذي يتم بموجبه تحقيق الحد الأقصى من النقرات. سيحاول مقدِّم عروض أسعار "الإنفاق الهدف" إنفاق القيمة الأقلّ من هذه القيمة أو مبلغ الإنفاق المضبوط بشكلٍ طبيعي. وفي حال عدم تحديدها، يتم استخدام الميزانية على أنها الإنفاق المستهدف. تم إيقاف هذا الحقل نهائيًا ويجب عدم استخدامه بعد الآن. يمكنك الاطّلاع على https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html لمعرفة التفاصيل. |
cpcBidCeilingMicros |
الحد الأقصى لعروض الأسعار الذي يمكن ضبطه من خلال استراتيجية عروض الأسعار. وينطبق هذا الحد على جميع الكلمات الرئيسية التي تديرها الاستراتيجية. |
CampaignBudget
ميزانية الحملة.
تمثيل JSON |
---|
{ "resourceName": string, "deliveryMethod": enum ( |
الحقول | |
---|---|
resourceName |
اسم مورد ميزانية الحملة. تكون أسماء موارد ميزانية الحملة على النحو التالي:
|
deliveryMethod |
طريقة العرض التي تحدِّد معدّل إنفاق ميزانية الحملة. يتم ضبط السياسة تلقائيًا على STANDARD في حال عدم تحديدها في عملية إنشاء. |
period |
الفترة التي سيتم إنفاق الميزانية خلالها. ويتم ضبط السياسة تلقائيًا على "يومي" إذا لم يتم تحديدها. |
amountMicros |
مبلغ الميزانية بالعملة المحلية للحساب. ويتم تحديد المبلغ بالمايكرو، حيث يعادل المليون وحدة عملة واحدة. ويبلغ الحد الأقصى للإنفاق الشهري 30.4 ضِعف هذا المبلغ. |
BudgetDeliveryMethod
طرق التسليم الممكنة للميزانية.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
STANDARD |
سيحدّد خادم الميزانية عرض الإعلانات بشكل متساوٍ خلال الفترة الزمنية بالكامل. |
ACCELERATED |
ولن يحدّ خادم الميزانية من عرض الإعلانات، وسيتم عرض الإعلانات في أسرع وقت ممكن. |
BudgetPeriod
الفترة المحتملة للميزانية.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
DAILY |
الميزانية اليومية. |
FIXED_DAILY |
ميزانية يومية ثابتة. |
CUSTOM_PERIOD |
يمكن استخدام ميزانية مخصّصة مع total_amount لتحديد حد الميزانية الدائمة. |
الحملة
حملة
تمثيل JSON |
---|
{ "resourceName": string, "status": enum ( |
الحقول | |
---|---|
resourceName |
اسم مورد الحملة. وتكون أسماء موارد الحملات على النحو التالي:
|
status |
حالة الحملة. عند إضافة حملة جديدة، يتم ضبط الحالة على "مفعَّل" بشكلٍ تلقائي. |
servingStatus |
حالة عرض الإعلانات للحملة |
biddingStrategySystemStatus |
حالة النظام لاستراتيجية عروض الأسعار للحملة. |
adServingOptimizationStatus |
حالة تحسين عرض الإعلانات للحملة |
advertisingChannelType |
استهداف العرض الأساسي للإعلانات داخل الحملة. يمكن تحسين خيارات الاستهداف في هذا الحقل مطلوب ويجب ألا يكون فارغًا عند إنشاء حملات جديدة. لا يمكن ضبطها إلا عند إنشاء الحملات. بعد إنشاء الحملة، لا يمكن تغيير الحقل. |
advertisingChannelSubType |
تحسين اختياري لـ لا يمكن ضبطها إلا عند إنشاء الحملات. بعد إنشاء الحملة، لا يمكن تغيير هذا الحقل. |
urlCustomParameters[] |
قائمة عمليات الربط المستخدَمة لاستبدال علامات المَعلمات المخصَّصة في |
realTimeBiddingSetting |
إعدادات عروض الأسعار في الوقت الفعلي، وهي ميزة لا تتوفّر إلا للحملات التي تستهدف شبكة Ad Exchange. |
networkSettings |
إعدادات الشبكة للحملة |
dynamicSearchAdsSetting |
إعداد التحكّم في الإعلانات الديناميكية على شبكة البحث (DSA). |
shoppingSetting |
إعداد التحكّم في حملات التسوّق. |
geoTargetTypeSetting |
إعداد الاستهداف الجغرافي للإعلانات. |
labels[] |
أسماء موارد التصنيفات المرفقة بهذه الحملة. |
biddingStrategyType |
نوع استراتيجية عروض الأسعار. يمكن إنشاء استراتيجية عروض أسعار من خلال ضبط مخطط عروض الأسعار لإنشاء استراتيجية عروض أسعار عادية أو الحقل هذا الحقل للقراءة فقط. |
accessibleBiddingStrategy |
اسم مورد Accessible BiddingStrategy"، وهو ملف شخصي للقراءة فقط على السمات غير المشروطة لاستراتيجية المحفظة لعروض الأسعار المرفقة التي تم تحديدها من خلال "عروض الأسعار" هذا الحقل فارغ، إذا كانت الحملة لا تستخدم استراتيجية محفظة. تتوفّر سمات الاستراتيجية غير المحدودة لجميع العملاء الذين تتم مشاركة الاستراتيجية معهم، ويمكن الاطّلاع عليها من مرجع Accessible BiddingStrategy. في المقابل، لا تتوفّر السمات المحظورة إلا للعميل مالك الاستراتيجية ومدرائه. لا يمكن قراءة السمات المحظورة إلا من مورد BiddingStrategy. |
frequencyCaps[] |
قائمة تحدّ من عدد مرات مشاهدة كل مستخدم لإعلانات هذه الحملة. |
selectiveOptimization |
إعداد تحسين انتقائي لهذه الحملة، يتضمّن مجموعة من إجراءات الإحالات الناجحة لتحسين هذه الحملة لتحقيقها. لا تنطبق هذه الميزة إلا على حملات التطبيقات التي تستخدم MULTI_CHANNEL ضمن النوع AdvertisingChannelType وAPP_CAMPAIGN أو APP_CAMPAIGN_FOR_ENGAGEMENT مثل AdvertisingChannelSubType. |
optimizationGoalSetting |
إعداد أهداف التحسين لهذه الحملة، والذي يتضمّن مجموعة من أنواع أهداف التحسين. |
trackingSetting |
إعدادات على مستوى الحملة لتتبُّع المعلومات. |
engineId |
رقم تعريف الحملة في حساب محرّك البحث الخارجي هذا الحقل مخصّص للحسابات غير التابعة لخدمة "إعلانات Google" فقط، مثل Yahoo Japan أو Microsoft أو Baidu أو غير ذلك. وبالنسبة إلى كيان "إعلانات Google"، استخدِم "campaign.id" بدلاً من ذلك. |
excludedParentAssetFieldTypes[] |
أنواع حقول مواد العرض التي يجب استبعادها من هذه الحملة. لن تكتسب هذه الحملة روابط مواد العرض مع أنواع الحقول هذه من المستوى الأعلى. |
createTime |
الطابع الزمني عند إنشاء هذه الحملة. يظهر الطابع الزمني حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss". وسيتم إيقاف createTime نهائيًا في الإصدار 1. استخدِم وقت الإنشاء بدلاً من ذلك. |
creationTime |
الطابع الزمني عند إنشاء هذه الحملة. يكون الطابع الزمني حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss". |
lastModifiedTime |
تاريخ آخر تعديل لهذه الحملة. يتم تحديد التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ssssss". |
id |
رقم تعريف الحملة. |
name |
اسم الحملة. هذا الحقل مطلوب ويجب ألا يكون فارغًا عند إنشاء حملات جديدة. ويجب ألا يحتوي على أي أحرف فارغة (نقطة الرمز 0x0) أو خلاصة سطر NL (نقطة الرمز 0xA) أو أحرف الرجوع إلى أول السطر (رمز النقطة 0xD). |
trackingUrlTemplate |
نموذج عنوان URL لإنشاء عنوان URL للتتبّع. |
campaignBudget |
ميزانية الحملة. |
startDate |
تاريخ بدء الحملة في عرض المنطقة الزمنية للعميل بالتنسيق YYYY-MM-DD. |
endDate |
اليوم الأخير من الحملة في المنطقة الزمنية للعميل بالتنسيق YYYY-MM-DD. وعند إنشاء الحملة، يتم ضبطها تلقائيًا على 2037-12-30، ما يعني أنّه سيتم عرض الحملة إلى أجل غير مسمى. لضبط حملة حالية من أجل عرضها إلى أجل غير مسمى، اضبط هذا الحقل على 2037-12-30. |
finalUrlSuffix |
اللاحقة المستخدمة لإلحاق مَعلمات طلب البحث بالصفحات المقصودة التي يتم عرضها مع التتبّع الموازي. |
urlExpansionOptOut |
يمثِّل إيقاف توسيع عنوان URL ليشمل عناوين URL أكثر استهدافًا. في حال إيقاف هذه الميزة (صحيح)، سيتم استهداف عناوين URL النهائية فقط في مجموعة مواد العرض أو عناوين URL المحدَّدة في خلاصات بيانات النشاط التجاري أو Google Merchant Center للمعلِن. في حال الموافقة (خطأ)، سيتم استهداف النطاق بالكامل. لا يمكن ضبط هذا الحقل إلّا لـ "حملات الأداء الأفضل"، حيث تكون القيمة التلقائية "خطأ". |
حقل الاتحاد يجب أن تكون محفظة (تم إنشاؤها من خلال خدمة BiddingStrategy) أو محفظة عادية مضمّنة في الحملة. يمكن أن يكون الحقل " |
|
biddingStrategy |
استراتيجية المحفظة لعروض الأسعار التي تستخدمها الحملة. |
manualCpa |
الإستراتيجية القياسية لعروض أسعار الإجراء اليدوية. استراتيجية عروض أسعار يدوية تسمح للمعلِن بتحديد عرض السعر لكل إجراء يحدِّده المعلِن. لا تتوفّر هذه الميزة إلا لحملات "الخدمات المحلّية". |
manualCpc |
الإستراتيجية القياسية لعروض أسعار النقرة اليدوية. عروض الأسعار اليدوية المستندة إلى النقرات والتي يدفع فيها المستخدم مقابل كل نقرة |
manualCpm |
هي استراتيجية قياسية لعروض الأسعار اليدوية لكل ألف ظهور. عروض الأسعار اليدوية المستندة إلى مرات الظهور والتي يدفع فيها المستخدم مقابل كل ألف ظهور |
maximizeConversions |
استراتيجية عروض أسعار "تحقيق الحد الأقصى من الإحالات الناجحة" العادية التي تعمل تلقائيًا على زيادة عدد الإحالات الناجحة إلى أقصى حد مع إنفاق ميزانيتك |
maximizeConversionValue |
الاستراتيجية العادية لعروض أسعار "تحقيق الحد الأقصى من قيمة الإحالات الناجحة" التي تضبط عروض الأسعار تلقائيًا لتحقيق الحد الأقصى من الأرباح في حدود ميزانيتك |
targetCpa |
هي الاستراتيجية العادية لعروض الأسعار المستهدفة للإجراء، والتي تحدِّد عروض الأسعار تلقائيًا لمساعدتك في الحصول على أكبر عدد ممكن من الإحالات الناجحة بالتكلفة المستهدفة للإجراء التي تحدِّدها. |
targetImpressionShare |
استراتيجية عروض أسعار "نسبة ظهور الإعلان المستهدَفة". يشير ذلك المصطلح إلى استراتيجية عروض أسعار مبرمَجة تعمل على ضبط عروض الأسعار لتحقيق نسبة محدَّدة من مرات الظهور. |
targetRoas |
استراتيجية عروض أسعار "عائد الإنفاق الإعلاني المستهدف" العادية التي تعمل تلقائيًا على زيادة الأرباح إلى أقصى حد تلقائيًا مع تحقيق متوسط عائد إنفاق إعلاني مستهدَف معيّن |
targetSpend |
استراتيجية عروض أسعار "الإنفاق الهدف" العادية التي تُحدِّد عروض أسعارك تلقائيًا لمساعدتك في الحصول على أكبر عدد ممكن من النقرات في حدود ميزانيتك. |
percentCpc |
استراتيجية عروض أسعار النسبة المئوية العادية لتكلفة النقرة حيث تكون عروض الأسعار جزءًا من السعر المُعلَن عنه لبعض السلع أو الخدمات. |
targetCpm |
استراتيجية عروض أسعار تعمل على تحسين التكلفة لكل ألف ظهور تلقائيًا. |
CampaignStatus
الحالات المحتملة للحملة.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
ENABLED |
الحملة نشطة ويمكنها عرض إعلانات. |
PAUSED |
أوقف المستخدم الحملة مؤقتًا. |
REMOVED |
تمت إزالة الحملة. |
CampaignServingStatus
حالات العرض المحتملة لإحدى الحملات
عمليات التعداد | |
---|---|
UNSPECIFIED |
لم يتم تحديد قيمة. |
UNKNOWN |
القيمة المُستلَمة غير معروفة في هذا الإصدار. هذه قيمة للاستجابة فقط. |
SERVING |
يتم عرضها |
NONE |
بلا عُري |
ENDED |
انتهى. |
PENDING |
Pending. |
SUSPENDED |
معلّقة. |
BiddingStrategySystemStatus
حالات النظام المحتملة لاستراتيجية عروض الأسعار.
عمليات التعداد | |
---|---|
UNSPECIFIED |
إشارات حدوث خطأ غير متوقع، مثل عدم العثور على نوع استراتيجية عروض الأسعار، أو عدم العثور على معلومات عن الحالة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
ENABLED |
إستراتيجية عروض الأسعار نشطة، ولم يتمكن AdWords من العثور على أي مشاكل محدّدة في الإستراتيجية. |
LEARNING_NEW |
استراتيجية عروض الأسعار في مرحلة التعلّم لأنه تم إنشاؤها مؤخرًا أو تمت إعادة تفعيلها مؤخرًا. |
LEARNING_SETTING_CHANGE |
استراتيجية عروض الأسعار في حالة التعلم بسبب تغيير حديث في الإعداد. |
LEARNING_BUDGET_CHANGE |
استراتيجية عروض الأسعار في حالة التعلم بسبب تغيير حديث في الميزانية. |
LEARNING_COMPOSITION_CHANGE |
استراتيجية عروض الأسعار في حالة التعلم بسبب التغيير الأخير في عدد الحملات أو المجموعات الإعلانية أو الكلمات الرئيسية المرفقة بها. |
LEARNING_CONVERSION_TYPE_CHANGE |
تعتمد استراتيجية عروض الأسعار على إعداد تقارير الإحالات الناجحة، وعدّل العميل مؤخرًا أنواع الإحالات الناجحة التي كانت ذات صلة باستراتيجية عروض الأسعار. |
LEARNING_CONVERSION_SETTING_CHANGE |
تعتمد استراتيجية عروض الأسعار على إعداد تقارير الإحالات الناجحة، وغيّر العميل إعدادات الإحالة الناجحة مؤخرًا. |
LIMITED_BY_CPC_BID_CEILING |
استراتيجية عروض الأسعار محدودة بالحد الأقصى لعروض الأسعار. |
LIMITED_BY_CPC_BID_FLOOR |
استراتيجية عروض الأسعار محدودة بالحد الأدنى لعرض السعر. |
LIMITED_BY_DATA |
استراتيجية عروض الأسعار محدودة بسبب عدم توفّر عدد كافٍ من الزيارات للإحالات الناجحة خلال الأسابيع الماضية. |
LIMITED_BY_BUDGET |
هناك جزء كبير من الكلمات الرئيسية في استراتيجية عروض الأسعار هذه أدنى من حدود الميزانية المطلوبة. |
LIMITED_BY_LOW_PRIORITY_SPEND |
لا يمكن لاستراتيجية عروض الأسعار الوصول إلى حد الإنفاق المستهدف بسبب عدم منح الأولوية للإنفاق. |
LIMITED_BY_LOW_QUALITY |
تتسم نسبة كبيرة من الكلمات الرئيسية في استراتيجية عروض الأسعار هذه بنقاط جودة منخفضة. |
LIMITED_BY_INVENTORY |
لا يمكن لاستراتيجية عروض الأسعار إنفاق ميزانيتها بالكامل بسبب ضيق الاستهداف. |
MISCONFIGURED_ZERO_ELIGIBILITY |
تتبُّع الإحالات الناجحة غير متوفّر (لا تتوفّر إشعارات) و/أو قوائم تجديد النشاط التسويقي في حملة Shopping الذكية (SSC). |
MISCONFIGURED_CONVERSION_TYPES |
تعتمد استراتيجية عروض الأسعار على إعداد تقارير الإحالات الناجحة، وينقص العميل أنواع الإحالات الناجحة التي يمكن تسجيلها وفقًا لهذه الاستراتيجية. |
MISCONFIGURED_CONVERSION_SETTINGS |
تعتمد استراتيجية عروض الأسعار على إعداد تقارير الإحالات الناجحة وتم ضبط إعدادات الإحالات الناجحة للعميل بشكلٍ خاطئ. |
MISCONFIGURED_SHARED_BUDGET |
هناك حملات خارج استراتيجية عروض الأسعار تشترك في الميزانيات مع الحملات المضمّنة في الاستراتيجية. |
MISCONFIGURED_STRATEGY_TYPE |
نوع استراتيجية الحملة غير صالح ولا يتم عرضه. |
PAUSED |
استراتيجية عروض الأسعار غير نشطة. إما أنه لا توجد حملات أو مجموعات إعلانية أو كلمات رئيسية نشطة مرفقة باستراتيجية عروض الأسعار. أو إذا لم تكن هناك ميزانيات نشطة مرتبطة باستراتيجية عروض الأسعار. |
UNAVAILABLE |
لا تتيح استراتيجية عروض الأسعار هذه إعداد تقارير الحالة حاليًا. |
MULTIPLE_LEARNING |
كانت هناك حالات نظام LEARNING_* متعددة لاستراتيجية عروض الأسعار هذه خلال الفترة المعنية. |
MULTIPLE_LIMITED |
كانت هناك حالات نظام LIMITED_* متعددة لاستراتيجية عروض الأسعار هذه خلال الفترة المعنية. |
MULTIPLE_MISCONFIGURED |
كانت هناك حالات نظام متعددة MISCONFIGURED_* لاستراتيجية عروض الأسعار هذه خلال الفترة المعنية. |
MULTIPLE |
كانت هناك حالات متعددة للنظام لاستراتيجية عروض الأسعار هذه خلال الفترة المعنية. |
AdServingOptimizationStatus
رقم يصف حالات العرض المحتملة.
عمليات التعداد | |
---|---|
UNSPECIFIED |
لم يتم تحديد قيمة. |
UNKNOWN |
القيمة المُستلَمة غير معروفة في هذا الإصدار. هذه قيمة للاستجابة فقط. |
OPTIMIZE |
يتم تحسين عرض الإعلانات استنادًا إلى نسبة النقر إلى الظهور للحملة. |
CONVERSION_OPTIMIZE |
يتم تحسين عرض الإعلانات استنادًا إلى نسبة النقر إلى الظهور * الإحالة الناجحة للحملة. إذا لم تكن الحملة ضمن استراتيجية عروض أسعار محسِّن الإحالات الناجحة، سيتم ضبطها تلقائيًا على "التحسين". |
ROTATE |
يتم عرض الإعلانات بالتناوب بشكل متساوٍ لمدة 90 يومًا، ثم يتم تحسينها للحصول على نقرات. |
ROTATE_INDEFINITELY |
عرض الإعلانات الأقل أداءً بشكل متساوٍ مع الإعلانات الأعلى أداءً، وعدم التحسين. |
UNAVAILABLE |
حالة تحسين عرض الإعلانات غير متاحة. |
AdvertisingChannelType
يشير هذا المقياس إلى قيم تعداد يصف أنواع القنوات الإعلانية المختلفة.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
SEARCH |
شبكة البحث. يشمل ذلك "الحملات على الشبكة الإعلانية" و"الحملات على شبكة البحث" و"الحملات على شبكة البحث". |
DISPLAY |
شبكة Google الإعلانية فقط. |
SHOPPING |
يتمّ عرض "حملات التسوّق" على موقع التسوّق وعلى نتائج البحث على google.com. |
HOTEL |
حملات إعلانات الفنادق. |
VIDEO |
حملات الفيديو |
MULTI_CHANNEL |
"حملات التطبيقات" و"حملات التطبيقات لجذب المستخدِمين الحاليين" التي يتم عرضها في قنوات متعدّدة |
LOCAL |
حملات الإعلانات المحلية |
SMART |
الحملات الذكية: |
PERFORMANCE_MAX |
حملات الأداء الأفضل: |
LOCAL_SERVICES |
حملات الخدمات المحلّية. |
DISCOVERY |
الحملات أثناء التصفّح: |
TRAVEL |
"حملات السفر": |
AdvertisingChannelSubType
يشير هذا المقياس إلى قيم التعداد التي تصف الأنواع الفرعية المختلفة للقنوات.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
ويتم استخدامها كقيمة معروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
SEARCH_MOBILE_APP |
حملات تطبيقات الأجهزة الجوّالة على شبكة البحث. |
DISPLAY_MOBILE_APP |
حملات تطبيقات الأجهزة الجوّالة للشبكة الإعلانية. |
SEARCH_EXPRESS |
حملات AdWords Express لشبكة البحث. |
DISPLAY_EXPRESS |
حملات AdWords Express للشبكة الإعلانية. |
SHOPPING_SMART_ADS |
حملات التسوّق الذكية: |
DISPLAY_GMAIL_AD |
حملات الإعلانات على Gmail. |
DISPLAY_SMART_CAMPAIGN |
الحملات الذكية على الشبكة الإعلانية. لا يمكن إنشاء حملات جديدة من هذا النوع الفرعي. |
VIDEO_OUTSTREAM |
حملات الفيديو خارج البث المباشر. |
VIDEO_ACTION |
حملات فيديو TrueView for Action. |
VIDEO_NON_SKIPPABLE |
حملات الفيديو التي تتضمن إعلانات فيديو غير قابلة للتخطي. |
APP_CAMPAIGN |
حملة تطبيقات تتيح لك الترويج لتطبيق Android أو iOS بسهولة على أهم خدمات Google، بما في ذلك "بحث Google" وPlay وYouTube و"شبكة Google الإعلانية". |
APP_CAMPAIGN_FOR_ENGAGEMENT |
"حملة تطبيقات لجذب المستخدِمين الحاليين" تركّز على تعزيز إعادة التفاعل مع التطبيق في العديد من أهم خدمات Google، بما في ذلك "بحث Google" وYouTube و"شبكة Google الإعلانية". |
LOCAL_CAMPAIGN |
حملات متخصّصة في الإعلانات المحلية |
SHOPPING_COMPARISON_LISTING_ADS |
حملات بيانات المقارنة على Shopping. |
SMART_CAMPAIGN |
الحملات الذكية العادية |
VIDEO_SEQUENCE |
حملات الفيديو التي تتضمّن إعلانات فيديو متسلسلة. |
APP_CAMPAIGN_FOR_PRE_REGISTRATION |
"حملة تطبيقات" للتسجيل المُسبَق، مخصَّصة للإعلان عن التسجيل المُسبَق لتطبيقات الأجهزة الجوّالة، وتستهدف قنوات إعلانية متعددة في Google Play وYouTube و"الشبكة الإعلانية". |
VIDEO_REACH_TARGET_FREQUENCY |
"حملة فيديو تركّز على الوصول إلى الجمهور" تستخدِم استراتيجية عروض أسعار "عدد مرّات الظهور المستهدَف". |
TRAVEL_ACTIVITIES |
حملات أنشطة السفر. |
CustomParameter
عملية ربط يمكن استخدامها بواسطة علامات مَعلمات مخصّصة في trackingUrlTemplate
أو finalUrls
أو mobile_final_urls
.
تمثيل JSON |
---|
{ "key": string, "value": string } |
الحقول | |
---|---|
key |
المفتاح الذي يطابق اسم علامة المَعلمة |
value |
القيمة المطلوب استبدالها. |
RealTimeBiddingSetting
إعدادات عروض الأسعار في الوقت الفعلي، وهي ميزة لا تتوفّر إلا للحملات التي تستهدف شبكة Ad Exchange.
تمثيل JSON |
---|
{ "optIn": boolean } |
الحقول | |
---|---|
optIn |
ما إذا كانت عروض الأسعار في الوقت الفعلي مفعَّلة في الحملة |
NetworkSettings
إعدادات الشبكة للحملة
تمثيل JSON |
---|
{ "targetGoogleSearch": boolean, "targetSearchNetwork": boolean, "targetContentNetwork": boolean, "targetPartnerSearchNetwork": boolean } |
الحقول | |
---|---|
targetGoogleSearch |
ما إذا كان سيتم عرض الإعلانات مع نتائج بحث google.com أم لا |
targetSearchNetwork |
ما إذا كان سيتم عرض الإعلانات على مواقع الشركاء في شبكة بحث Google (يتطلب ذلك |
targetContentNetwork |
ما إذا كان سيتم عرض الإعلانات في مواضع محدّدة على شبكة Google الإعلانية. ويتم تحديد مواضع الإعلانات باستخدام معيار موضع الإعلان. |
targetPartnerSearchNetwork |
ما إذا كان سيتم عرض الإعلانات على شبكة شركاء Google أم لا. ولا تتوفّر هذه الميزة إلا لبعض حسابات شركاء Google المختارة. |
DynamicSearchAdsSetting
إعداد التحكّم في الإعلانات الديناميكية على شبكة البحث (DSA).
تمثيل JSON |
---|
{ "domainName": string, "languageCode": string, "useSuppliedUrlsOnly": boolean } |
الحقول | |
---|---|
domainName |
مطلوبة. اسم نطاق الإنترنت الذي يمثله هذا الإعداد، على سبيل المثال، "google.com" أو "www.google.com". |
languageCode |
مطلوبة. رمز اللغة الذي يحدّد لغة النطاق، على سبيل المثال، "en". |
useSuppliedUrlsOnly |
ما إذا كانت الحملة تستخدم عناوين URL المقدّمة من المعلن حصريًا. |
ShoppingSetting
إعداد حملات التسوّق. تحدد هذه السمة مجموعة المنتجات التي يمكن الإعلان عنها من خلال الحملة، وكيفية تفاعل هذه الحملة مع "حملات Shopping" الأخرى.
تمثيل JSON |
---|
{ "feedLabel": string, "useVehicleInventory": boolean, "merchantId": string, "salesCountry": string, "campaignPriority": integer, "enableLocal": boolean } |
الحقول | |
---|---|
feedLabel |
تصنيف خلاصة المنتجات المطلوب تضمينها في الحملة يمكن ضبط قيمة واحدة فقط من FeedLabel أو salesCountry. في حال استخدامه بدلاً من salesCountry، يقبل حقل feedLabel رموز البلدان بالتنسيق نفسه، على سبيل المثال: "XX". ويمكن أيضًا أن يكون أيّ سلسلة مستخدَمة لتصنيف الخلاصة في Google Merchant Center. |
useVehicleInventory |
لتحديد ما إذا كنت تريد استهداف مستودع بيانات المركبات |
merchantId |
رقم تعريف حساب Merchant Center. هذا الحقل مطلوب لإنشاء عمليات. هذا الحقل غير قابل للتغيير في "حملات Shopping". |
salesCountry |
بلد مبيعات المنتجات المطلوب تضمينها في الحملة |
campaignPriority |
أولوية الحملة. الحملات ذات الأولويات الأعلى عدديًا لها الأولوية على تلك ذات الأولويات الأقل. هذا الحقل مطلوب لحملات التسوّق، ذات القيم بين 0 و2، بشكل شامل. هذا الحقل اختياري لحملات Shopping الذكية، ولكن يجب أن يساوي 3 في حال ضبطه. |
enableLocal |
لتحديد ما إذا كان يجب تضمين المنتجات المحلية. |
GeoTargetTypeSetting
يمثّل مجموعة من الإعدادات ذات الصلة بالاستهداف الجغرافي للإعلانات.
تمثيل JSON |
---|
{ "positiveGeoTargetType": enum ( |
الحقول | |
---|---|
positiveGeoTargetType |
الإعداد المستخدَم للاستهداف الجغرافي الإيجابي في هذه الحملة تحديدًا. |
negativeGeoTargetType |
الإعداد المستخدَم للاستهداف الجغرافي السلبي في هذه الحملة بالتحديد. |
PositiveGeoTargetType
أنواع الاستهدافات الجغرافية الإيجابية المحتملة.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
القيمة غير معروفة في هذا الإصدار. |
PRESENCE_OR_INTEREST |
تحدِّد هذه السياسة إمكانية عرض الإعلان إذا كان المستخدم في المواقع الجغرافية المستهدَفة للمعلِن أو يبدي اهتمامًا بها. |
SEARCH_INTEREST |
تحدّد هذه السمة أنّه يتم عرض إعلان إذا بحث المستخدم عن المواقع الجغرافية المستهدَفة للمعلِن. ويمكن استخدام هذه الميزة مع "الحملات على شبكة البحث" و"حملات Shopping العادية" فقط. |
PRESENCE |
تحدِّد هذه السمة أنّه يتم عرض إعلان إذا كان المستخدم مقيمًا في المواقع الجغرافية المستهدَفة للمعلِن أو يزورها بانتظام. |
NegativeGeoTargetType
أنواع الاستهدافات الجغرافية السلبية المحتملة.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
القيمة غير معروفة في هذا الإصدار. |
PRESENCE_OR_INTEREST |
تحدِّد هذه السياسة أنّه يتم استبعاد المستخدم من مشاهدة الإعلان إذا كان في المواقع الجغرافية المستبعَدة للمعلن أو يبدي اهتمامًا بها. |
PRESENCE |
تحدِّد هذه السياسة أنّه يتم استبعاد المستخدم من مشاهدة الإعلان إذا كان في مواقع جغرافية مستبعدة من المعلِن. |
FrequencyCapEntry
لا يشتمل هذا النوع على أي حقول.
يشير ذلك المصطلح إلى قاعدة تحدِّد الحدّ الأقصى لعدد مرات عرض إعلان (أو مجموعة معيّنة من الإعلانات) على المستخدِم خلال فترة زمنية معيّنة.
SelectiveOptimization
إعداد تحسين انتقائي لهذه الحملة، يتضمّن مجموعة من إجراءات الإحالات الناجحة لتحسين هذه الحملة لتحقيقها. لا تنطبق هذه الميزة إلا على حملات التطبيقات التي تستخدم MULTI_CHANNEL ضمن النوع AdvertisingChannelType وAPP_CAMPAIGN أو APP_CAMPAIGN_FOR_ENGAGEMENT مثل AdvertisingChannelSubType.
تمثيل JSON |
---|
{ "conversionActions": [ string ] } |
الحقول | |
---|---|
conversionActions[] |
المجموعة المختارة من إجراءات الإحالات الناجحة لتحسين هذه الحملة. |
OptimizationGoalSetting
إعداد أهداف التحسين لهذه الحملة، والذي يتضمّن مجموعة من أنواع أهداف التحسين.
تمثيل JSON |
---|
{
"optimizationGoalTypes": [
enum ( |
الحقول | |
---|---|
optimizationGoalTypes[] |
قائمة أنواع أهداف التحسين |
OptimizationGoalType
نوع هدف التحسين
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
ويتم استخدامها كقيمة معروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
CALL_CLICKS |
التحسين لزيادة النقرات على زرّ الاتصال الإحالات الناجحة الناتجة عن النقر للاتصال هي المرات التي اختار فيها الأشخاص "الاتصال" للتواصل مع متجر بعد عرض إعلان. |
DRIVING_DIRECTIONS |
تحسين اتجاهات القيادة الإحالات الناجحة لاتجاهات القيادة هي المرات التي اختار فيها الأشخاص "الحصول على الاتجاهات" للانتقال إلى متجر بعد مشاهدة إعلان. |
APP_PRE_REGISTRATION |
تحسين التسجيل المُسبَق الإحالات الناجحة للتسجيل المُسبَق هي عدد اشتراكات التسجيل المُسبَق التي تتلقّى إشعارًا عند إصدار التطبيق. |
TrackingSetting
إعدادات على مستوى الحملة لتتبُّع المعلومات.
تمثيل JSON |
---|
{ "trackingUrl": string } |
الحقول | |
---|---|
trackingUrl |
عنوان URL المستخدَم للتتبّع الديناميكي. |
ManualCpa
لا يشتمل هذا النوع على أي حقول.
استراتيجية عروض أسعار يدوية تسمح للمعلِن بتحديد عرض السعر لكل إجراء يحدِّده المعلِن.
ManualCpc
عروض الأسعار اليدوية المستندة إلى النقرات والتي يدفع فيها المستخدم مقابل كل نقرة
تمثيل JSON |
---|
{ "enhancedCpcEnabled": boolean } |
الحقول | |
---|---|
enhancedCpcEnabled |
ما إذا كان سيتم تحسين عروض الأسعار استنادًا إلى بيانات محسِّن الإحالات الناجحة |
ManualCpm
لا يشتمل هذا النوع على أي حقول.
عروض الأسعار اليدوية المستندة إلى مرات الظهور والتي يدفع فيها المستخدم مقابل كل ألف ظهور
PercentCpc
استراتيجية عروض أسعار تكون فيها عروض الأسعار جزءًا من السعر المعلَن عنه لبعض السلع أو الخدمات.
تمثيل JSON |
---|
{ "cpcBidCeilingMicros": string, "enhancedCpcEnabled": boolean } |
الحقول | |
---|---|
cpcBidCeilingMicros |
الحد الأقصى لعروض الأسعار الذي يمكن ضبطه من خلال استراتيجية عروض الأسعار. هذا حقل اختياري يدخله المعلِن ويتم تحديده بوحدات المايكرو المحلية. ملاحظة: يتم تفسير القيمة صفر بالطريقة نفسها التي يتم بها تفسير سمة Bid_ اثنين غير محددة. |
enhancedCpcEnabled |
يُعدّل عرض السعر لكل مزاد برفعه أو خفضه، استنادًا إلى احتمالية تحقيق إحالة ناجحة. قد تتجاوز عروض الأسعار الفردية cpcBidCeilingMicros، ولكن يجب ألا يحدث متوسط مبلغ عرض السعر للحملة. |
TargetCpm
لا يشتمل هذا النوع على أي حقول.
التكلفة المستهدَفة لكلّ ألف ظهور هي استراتيجية عروض أسعار مبرمَجة تضبط عروض الأسعار لتحسين الأداء في ضوء التكلفة المستهدَفة لكلّ ألف ظهور التي تحدّدها.
CampaignAsset
تمثّل هذه السمة رابطًا بين حملة ومادة عرض.
تمثيل JSON |
---|
{
"resourceName": string,
"status": enum ( |
الحقول | |
---|---|
resourceName |
اسم المورد لمادة عرض الحملة. تكون أسماء موارد CampaignAsset على النحو التالي:
|
status |
حالة مادة عرض الحملة. |
campaign |
الحملة التي ترتبط بها مادة العرض. |
asset |
مادة العرض المرتبطة بالحملة. |
CampaignAssetSet
CampaignAssetSet هو الرابط بين حملة ومجموعة مواد عرض. تعمل إضافة CampaignAssetSet على ربط مجموعة مواد عرض بإحدى الحملات.
تمثيل JSON |
---|
{
"resourceName": string,
"campaign": string,
"assetSet": string,
"status": enum ( |
الحقول | |
---|---|
resourceName |
اسم المورد لمجموعة مواد العرض للحملة تكون أسماء موارد مواد العرض ضمن مجموعة مواد العرض على النحو التالي:
|
campaign |
الحملة التي ترتبط بها مجموعة مواد العرض هذه. |
assetSet |
مجموعة مواد العرض المرتبطة بالحملة. |
status |
حالة مادة عرض مجموعة مواد العرض للحملة. للقراءة فقط |
CampaignAudienceView
طريقة عرض الجمهور للحملة يتضمن بيانات الأداء من الاهتمامات وقوائم تجديد النشاط التسويقي للإعلانات على الشبكة الإعلانية وشبكة YouTube، وقوائم تجديد النشاط التسويقي للإعلانات على شبكة البحث (قوائم تجديد النشاط التسويقي للإعلانات على شبكة البحث)، المجمّعة حسب معيار الحملة والجمهور. لا تتضمّن طريقة العرض هذه سوى شرائح الجمهور المرفقة على مستوى الحملة.
تمثيل JSON |
---|
{ "resourceName": string } |
الحقول | |
---|---|
resourceName |
اسم المورد لطريقة عرض جمهور الحملة. تكون أسماء مراجع مشاهدة الجمهور في الحملة على النحو التالي:
|
CampaignCriterion
معيار حملة.
تمثيل JSON |
---|
{ "resourceName": string, "displayName": string, "type": enum ( |
الحقول | |
---|---|
resourceName |
اسم المورد لمعيار الحملة. تكون أسماء موارد معايير الحملة على النحو التالي:
|
displayName |
الاسم المعروض للمعيار. يتم تجاهل هذا الحقل لعمليات التبديل. |
type |
نوع المعيار. |
status |
حالة المعيار. |
lastModifiedTime |
التاريخ والوقت لآخر تعديل لمعيار الحملة هذا. يتم تحديد التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ssssss". |
criterionId |
رقم تعريف المعيار. يتم تجاهل هذا الحقل أثناء عملية التبديل. |
bidModifier |
معدِّل عروض الأسعار عندما يتطابق المعيار. يجب أن يكون المعدَّل ضمن النطاق: 0.1 - 10.0. تتوافق معظم أنواع المعايير القابلة للاستهداف مع المعدِّلات. استخدِم 0 لإيقاف نوع جهاز. |
negative |
تحديد ما إذا كان سيتم استهداف ( |
حقل الاتحاد يجب ضبط واحد بالضبط. يمكن أن يكون الحقل " |
|
keyword |
الكلمة الرئيسية. |
location |
الموقع الجغرافي. |
device |
الجهاز. |
ageRange |
الفئة العمرية. |
gender |
الجنس. |
userList |
قائمة المستخدمين. |
language |
اللغة |
webpage |
صفحة ويب |
locationGroup |
مجموعة المواقع الجغرافية |
CampaignCriterionStatus
الحالات المحتملة لمعيار الحملة.
عمليات التعداد | |
---|---|
UNSPECIFIED |
لم يتم تحديد قيمة. |
UNKNOWN |
القيمة المُستلَمة غير معروفة في هذا الإصدار. هذه قيمة للاستجابة فقط. |
ENABLED |
معيار الحملة مفعّل. |
PAUSED |
معيار الحملة متوقف مؤقتًا. |
REMOVED |
تمت إزالة معيار الحملة. |
LanguageInfo
معيار لغة.
تمثيل JSON |
---|
{ "languageConstant": string } |
الحقول | |
---|---|
languageConstant |
اسم المورد الثابت للّغة |
LocationGroupInfo
نطاق جغرافي حول قائمة مواقع جغرافية محدّدة من خلال خلاصة
تمثيل JSON |
---|
{
"geoTargetConstants": [
string
],
"radiusUnits": enum ( |
الحقول | |
---|---|
geoTargetConstants[] |
ثوابت الاستهداف الجغرافي التي تفرض قيودًا على نطاق المنطقة الجغرافية في الخلاصة في الوقت الحالي، يُسمح باستخدام ثابت واحد فقط للاستهداف الجغرافي. |
radiusUnits |
وحدة النطاق الجغرافي يمكن استخدام الأميال والأمتار لثوابت الهدف الجغرافي. يُسمح بالمللي ميل والمتر لمجموعات عناصر الخلاصة. هذا مطلوب ويجب تعيينه في عمليات CREATE. |
feedItemSets[] |
FeedItemSets الذي تم استهداف عناصر FeedItems به. في حال تحديد أرقام تعريف متعددة، سيتم استهداف جميع العناصر التي تظهر في مجموعة واحدة على الأقل. لا يمكن استخدام هذا الحقل مع geoTargetConstants. هذا الإجراء اختياري ولا يمكن ضبطه إلا في عمليات CREATE. |
radius |
المسافة بالوحدات التي تحدد النطاق الجغرافي حول المواقع المستهدفة. هذا مطلوب ويجب تعيينه في عمليات CREATE. |
LocationGroupRadiusUnits
وحدة مسافة النطاق الجغرافي في مجموعة المواقع الجغرافية (على سبيل المثال، MILES)
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
METERS |
متر |
MILES |
ميل |
MILLI_MILES |
ملي ميل |
CampaignLabel
تمثل هذه السمة علاقة بين الحملة والتصنيف.
تمثيل JSON |
---|
{ "resourceName": string, "campaign": string, "label": string } |
الحقول | |
---|---|
resourceName |
اسم المورد تكون أسماء موارد تصنيف الحملة على النحو التالي: |
campaign |
الحملة التي تم إرفاق التصنيف بها. |
label |
التصنيف المعيَّن للحملة. |
CartDataSalesView
عرض المبيعات في بيانات سلة التسوّق
تمثيل JSON |
---|
{ "resourceName": string } |
الحقول | |
---|---|
resourceName |
اسم المورد لعرض المبيعات في بيانات سلة التسوّق تكون أسماء مراجع المبيعات في بيانات سلة التسوّق على النحو التالي: |
الجمهور
الجمهور هو خيار استهداف فعّال يتيح لك إجراء تقاطع بين سمات شرائح مختلفة، مثل الخصائص الديمغرافية المفصّلة وشرائح الجمهور ذات الاهتمامات المشتركة، وذلك لإنشاء شرائح جمهور تمثّل أقسامًا من الشرائح المستهدَفة.
تمثيل JSON |
---|
{ "resourceName": string, "id": string, "name": string, "description": string } |
الحقول | |
---|---|
resourceName |
اسم المورد للجمهور. وتكون أسماء شرائح الجمهور على النحو التالي:
|
id |
رقم تعريف شريحة الجمهور. |
name |
مطلوبة. اسم الجمهور. يجب أن يكون فريدًا لجميع شرائح الجمهور. يجب أن يبلغ طوله 1 كحد أدنى و255 طولاً كحد أقصى. |
description |
وصف هذا الجمهور. |
ConversionAction
إجراء إحالة ناجحة
تمثيل JSON |
---|
{ "resourceName": string, "creationTime": string, "status": enum ( |
الحقول | |
---|---|
resourceName |
اسم المورد لإجراء الإحالة الناجحة. تكون أسماء موارد إجراءات الإحالة الناجحة على النحو التالي:
|
creationTime |
الطابع الزمني لإنشاء نشاط Floodlight، والمنسق وفقًا لمعيار ISO 8601 |
status |
حالة إجراء الإحالة الناجحة هذا لتجميع حدث الإحالة الناجحة. |
type |
نوع إجراء الإحالة الناجحة هذا |
category |
فئة الإحالات الناجحة التي تم الإبلاغ عنها لإجراء الإحالة الناجحة هذا. |
valueSettings |
الإعدادات ذات الصلة بقيمة أحداث الإحالة الناجحة المرتبطة بإجراء الإحالة الناجحة هذا. |
attributionModelSettings |
الإعدادات ذات الصلة بنموذج تحديد المصدر لإجراء الإحالة الناجحة هذا |
floodlightSettings |
إعدادات Floodlight لأنواع الإحالات الناجحة في Floodlight |
id |
رقم تعريف إجراء الإحالة الناجحة. |
name |
اسم إجراء الإحالة الناجحة. هذا الحقل مطلوب ويجب ألا يكون فارغًا عند إنشاء إجراءات إحالات ناجحة جديدة. |
primaryForGoal |
إذا كانت وحدة البت BasicForGoal لأحد إجراءات الإحالة الناجحة غير صحيحة، لا يمكن تقديم عروض أسعار لإجراء الإحالة الناجحة في جميع الحملات بغض النظر عن هدف الإحالة الناجحة للعميل أو هدف الإحالة الناجحة للحملة. وفي المقابل، لا تراعي أهداف الإحالات الناجحة المخصّصة PrimaryForGoal، وبالتالي إذا كانت الحملة تحتوي على هدف إحالة ناجحة مخصّص تم إعداده باستخدام PrimaryForGoal = إجراء إحالة ناجحة خاطئ، سيظل بالإمكان تقديم عروض أسعار لإجراء الإحالة الناجحة هذا. بشكلٍ تلقائي، ستكونPrimaryForGoal صحيحة في حال عدم ضبطها. في الإصدار V9، لا يمكن ضبط baseForGoal على "خطأ" إلا بعد الإنشاء من خلال عملية "تعديل" لأنّه لم يتم تعريفها على أنّها اختيارية. |
ownerCustomer |
اسم المورد للعميل مالك إجراء الإحالة الناجحة، أو قيمة فارغة إذا كان هذا إجراء إحالة ناجحة من تحديد النظام. |
includeInClientAccountConversionsMetric |
ما إذا كان ينبغي تضمين إجراء الإحالة الناجحة هذا في المقياس "clientAccountالإحالات الناجحة" |
includeInConversionsMetric |
ما إذا كان يجب تضمين إجراء الإحالة الناجحة هذا في مقياس "الإحالات الناجحة" |
clickThroughLookbackWindowDays |
الحدّ الأقصى لعدد الأيام التي قد تنقضي بين تفاعل (على سبيل المثال، نقرة) وحدث إحالة ناجحة. |
appId |
رقم تعريف التطبيق لإجراء إحالة ناجحة خاص بالتطبيق. |
ConversionActionStatus
الحالات المحتملة لإجراء إحالة ناجحة.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
ENABLED |
سيتم تسجيل الإحالات الناجحة. |
REMOVED |
لن يتم تسجيل الإحالات الناجحة. |
HIDDEN |
لن يتم تسجيل الإحالات الناجحة ولن يظهر إجراء الإحالة الناجحة في واجهة المستخدم. |
ConversionActionType
الأنواع المحتملة من إجراء الإحالة الناجحة
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
AD_CALL |
الإحالات الناجحة التي تحدث عندما ينقر أحد المستخدمين على إضافة المكالمة في أحد الإعلانات. |
CLICK_TO_CALL |
الإحالات الناجحة التي تحدث عندما ينقر مستخدم على رقم هاتف على جهاز جوّال. |
GOOGLE_PLAY_DOWNLOAD |
الإحالات الناجحة التي تحدث عندما يُنزِّل المستخدم تطبيقًا متوافقًا مع الأجهزة الجوّالة من "متجر Google Play". |
GOOGLE_PLAY_IN_APP_PURCHASE |
الإحالات الناجحة التي تحدث عندما يُجري مستخدم عملية شراء في أحد التطبيقات من خلال الفوترة في Android. |
UPLOAD_CALLS |
الإحالات الناجحة للمكالمات التي يتتبّعها المعلِن ويحمِّلها. |
UPLOAD_CLICKS |
الإحالات الناجحة التي يتتبّعها المعلِن ويتم تحميلها بنقرات محدّدة |
WEBPAGE |
الإحالات الناجحة التي تحدث على صفحة ويب. |
WEBSITE_CALL |
الإحالات الناجحة التي تحدث عندما يتصل أحد المستخدمين برقم هاتف تم إنشاؤه ديناميكيًا من الموقع الإلكتروني للمعلن. |
STORE_SALES_DIRECT_UPLOAD |
الإحالة الناجحة للمبيعات في المتاجر استنادًا إلى عمليات تحميل بيانات تاجر الطرف الأول أو التاجر التابع لطرف ثالث. يمكن فقط للعملاء المدرَجين في القائمة المسموح بها استخدام أنواع التحميل المباشر للمبيعات في المتاجر. |
STORE_SALES |
الإحالات الناجحة للمبيعات في المتاجر استنادًا إلى عمليات تحميل بيانات تاجر الطرف الأول أو الطرف الثالث و/أو من عمليات الشراء في المتجر باستخدام بطاقات من شبكات الدفع. يمكن للعملاء المدرَجين في القائمة المسموح بها فقط استخدام أنواع المبيعات في المتاجر. للقراءة فقط |
FIREBASE_ANDROID_FIRST_OPEN |
الإحالات الناجحة المفتوحة على تطبيق Android لأول مرة التي يتم تتبُّعها من خلال Firebase. |
FIREBASE_ANDROID_IN_APP_PURCHASE |
الإحالات الناجحة المتمثّلة بعملية شراء لتطبيق Android داخل التطبيق يتم تتبُّعها من خلال Firebase. |
FIREBASE_ANDROID_CUSTOM |
الإحالات الناجحة المخصّصة لتطبيقات Android التي يتم تتبُّعها من خلال Firebase. |
FIREBASE_IOS_FIRST_OPEN |
الإحالات الناجحة المفتوحة لأول مرة على تطبيق iOS والتي يتم تتبُّعها من خلال Firebase. |
FIREBASE_IOS_IN_APP_PURCHASE |
الإحالات الناجحة المتمثّلة بعملية شراء لتطبيق iOS داخل التطبيق يتم تتبُّعها من خلال Firebase. |
FIREBASE_IOS_CUSTOM |
الإحالات الناجحة المخصّصة لتطبيقات iOS التي يتم تتبُّعها من خلال Firebase. |
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN |
يتم تتبُّع الإحالات الناجحة المفتوحة لتطبيق Android لأول مرة من خلال إحصاءات التطبيقات التابعة لجهات خارجية. |
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE |
الإحالات الناجحة المتمثّلة بعملية شراء لتطبيقات Android داخل التطبيق يتم تتبُّعها من خلال إحصاءات التطبيقات التابعة لجهات خارجية. |
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM |
يتم تتبُّع الإحالات الناجحة المخصّصة لتطبيقات Android من خلال إحصاءات التطبيقات التابعة لجهات خارجية. |
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN |
يتم تتبُّع الإحالات الناجحة المفتوحة لأول مرة لتطبيق iOS من خلال إحصاءات التطبيقات التابعة لجهة خارجية. |
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE |
الإحالات الناجحة المتمثّلة بعملية شراء لتطبيقات iOS داخل التطبيق يتم تتبُّعها من خلال إحصاءات التطبيقات التابعة لجهات خارجية. |
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM |
يتم تتبُّع الإحالات الناجحة المخصّصة لتطبيقات iOS من خلال إحصاءات التطبيقات التابعة لجهات خارجية. |
ANDROID_APP_PRE_REGISTRATION |
الإحالات الناجحة التي تحدث عندما يُسجِّل المستخدم مسبقًا تطبيقًا متوافقًا مع الأجهزة الجوّالة من "متجر Google Play". للقراءة فقط |
ANDROID_INSTALLS_ALL_OTHER_APPS |
الإحالات الناجحة التي تتتبّع جميع عمليات التنزيل من Google Play التي لا يتم تتبُّعها حسب نوع خاص بالتطبيق للقراءة فقط |
FLOODLIGHT_ACTION |
نشاط Floodlight الذي يحتسب عدد مرّات زيارة المستخدِم لصفحة ويب معيّنة بعد رؤية أحد إعلانات المعلِن أو النقر عليه للقراءة فقط |
FLOODLIGHT_TRANSACTION |
نشاط Floodlight الذي يتتبّع عدد عمليات البيع المحقّقة أو عدد السلع المشتراة ويمكنه أيضًا تسجيل القيمة الإجمالية لكل عملية بيع. للقراءة فقط |
GOOGLE_HOSTED |
الإحالات الناجحة التي تتتبّع الإجراءات المحلية من منتجات Google وخدماتها بعد التفاعل مع إعلان للقراءة فقط |
LEAD_FORM_SUBMIT |
يتم الإبلاغ عن الإحالات الناجحة عندما يرسل أحد المستخدمين نموذج عملاء محتملين. للقراءة فقط |
SALESFORCE |
الإحالات الناجحة الواردة من Salesforce. للقراءة فقط |
SEARCH_ADS_360 |
الإحالات الناجحة المستورَدة من بيانات Floodlight في "إعلانات شبكة البحث 360". للقراءة فقط |
SMART_CAMPAIGN_AD_CLICKS_TO_CALL |
الإحالات الناجحة للمكالمات التي تحدث على إعلانات الحملات الذكية بدون إعداد ميزة تتبُّع المكالمات، وذلك باستخدام معايير مخصّصة للحملة الذكية. للقراءة فقط |
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL |
ينقر المستخدِم على عنصر اتصال في "خرائط Google". حملة ذكية فقط. للقراءة فقط |
SMART_CAMPAIGN_MAP_DIRECTIONS |
يطلب المستخدم الاتجاهات إلى الموقع الجغرافي للنشاط التجاري في "خرائط Google". حملة ذكية فقط. للقراءة فقط |
SMART_CAMPAIGN_TRACKED_CALLS |
الإحالات الناجحة للمكالمات التي تحدث في إعلانات الحملات الذكية من خلال إعداد ميزة تتبُّع المكالمات، باستخدام معايير مخصّصة للحملة الذكية. للقراءة فقط |
STORE_VISITS |
الإحالات الناجحة التي تحدث عندما يزور أحد المستخدمين متجر البيع بالتجزئة لأحد المعلنين. للقراءة فقط |
WEBPAGE_CODELESS |
الإحالات الناجحة التي يتم إنشاؤها من أحداث المواقع الإلكترونية (مثل عمليات إرسال النماذج أو عمليات تحميل الصفحات)، والتي لا تستخدم مقتطفات عن الأحداث مشفّرة بشكل فردي. للقراءة فقط |
UNIVERSAL_ANALYTICS_GOAL |
الإحالات الناجحة الواردة من أهداف Universal Analytics المرتبطة. |
UNIVERSAL_ANALYTICS_TRANSACTION |
الإحالات الناجحة الواردة من معاملات Universal Analytics المرتبطة |
GOOGLE_ANALYTICS_4_CUSTOM |
الإحالات الناجحة الواردة من الإحالات الناجحة المرتبطة بالأحداث المخصّصة في "إحصاءات Google 4". |
GOOGLE_ANALYTICS_4_PURCHASE |
الإحالات الناجحة الواردة من الإحالات الناجحة المتمثّلة بعملية شراء في "إحصاءات Google 4" المرتبطة |
ConversionActionCategory
فئة الإحالات الناجحة المرتبطة بإجراء إحالة ناجحة.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
DEFAULT |
الفئة التلقائية. |
PAGE_VIEW |
مستخدم يزور إحدى الصفحات |
PURCHASE |
حدث شراء أو مبيعات أو "تم تقديم طلب". |
SIGNUP |
إجراء المستخدم للاشتراك. |
LEAD |
إجراء إنشاء قوائم العملاء المحتملين |
DOWNLOAD |
إجراء تنزيل البرنامج (بالنسبة إلى التطبيق). |
ADD_TO_CART |
إضافة سلع إلى سلة تسوّق أو حقيبة على موقع أحد المعلنين |
BEGIN_CHECKOUT |
عندما يبدأ أحد الأشخاص إجراءات سير عملية الدفع على موقع إلكتروني لأحد المعلنين. |
SUBSCRIBE_PAID |
بداية اشتراك مدفوع لمنتج أو خدمة. |
PHONE_CALL_LEAD |
مكالمة للإشارة إلى الاهتمام بعرض أحد المعلنين. |
IMPORTED_LEAD |
إحالة ناجحة من عميل محتمل تم استيرادها من مصدر خارجي إلى "إعلانات Google". |
SUBMIT_LEAD_FORM |
إرسال نموذج على موقع إلكتروني للمعلن يشير إلى الاهتمام بالنشاط التجاري |
BOOK_APPOINTMENT |
حجز موعد مع النشاط التجاري للمعلِن |
REQUEST_QUOTE |
طلب عرض أسعار تقديري أو سعر تقديري |
GET_DIRECTIONS |
عملية بحث عن الموقع الجغرافي للنشاط التجاري لأحد المعلِنين بغرض الزيارة |
OUTBOUND_CLICK |
نقرة على موقع شريك المعلِن |
CONTACT |
مكالمة أو رسالة قصيرة (SMS) أو بريد إلكتروني أو محادثة أو أي نوع آخر من أنواع التواصل مع أحد المعلنين |
ENGAGEMENT |
حدث تفاعل مع الموقع الإلكتروني، مثل مدة الموقع الإلكتروني الطويلة أو هدف ذكي في "إحصاءات Google". مخصّص للاستخدام في عمليات استيراد الأهداف على "إحصاءات Google" وFirebase و"إحصاءات Google" الذهبية. |
STORE_VISIT |
زيارة إلى موقع جغرافي للمتجر. |
STORE_SALE |
تشير هذه السمة إلى عملية بيع تتم في متجر. |
QUALIFIED_LEAD |
إحالة ناجحة من عميل محتمل تم استيرادها من مصدر خارجي إلى "إعلانات Google"، ومؤهَّل بشكل أكبر من قِبل المعلِن (فريق التسويق/المبيعات). خلال رحلتك بدءًا من جذب العميل المحتمل وصولاً إلى إتمام عملية بيع، يحصل المعلِنون على عملاء محتملين، ثم يتخذون إجراءات استنادًا إلى ذلك من خلال التواصل مع المستهلك. إذا كان المستهلك مهتمًا ويُحتمَل أن يشتري منتجه، يضع المعلِن علامة "عملاء محتملون مؤهّلون" على هؤلاء العملاء المحتملين. |
CONVERTED_LEAD |
إحالة ناجحة من عميل محتمل تم استيرادها من مصدر خارجي إلى "إعلانات Google"، وأكملت أيضًا مرحلة محدَّدة على النحو الذي حدّده المعلِن الذي يركّز على جذب العملاء المحتملين. |
ValueSettings
الإعدادات ذات الصلة بقيمة أحداث الإحالة الناجحة المرتبطة بإجراء الإحالة الناجحة هذا.
تمثيل JSON |
---|
{ "defaultValue": number, "defaultCurrencyCode": string, "alwaysUseDefaultValue": boolean } |
الحقول | |
---|---|
defaultValue |
القيمة المطلوب استخدامها عند إرسال أحداث الإحالة الناجحة لإجراء الإحالة الناجحة هذا بقيمة غير صالحة أو غير مسموح بها أو غير متوفّرة، أو عند ضبط إجراء الإحالة الناجحة هذا لاستخدام القيمة التلقائية دائمًا. |
defaultCurrencyCode |
رمز العملة الذي سيتم استخدامه عند إرسال أحداث الإحالة الناجحة لإجراء الإحالة الناجحة هذا برمز عملة غير صالح أو مفقود، أو عند إعداد إجراء الإحالة الناجحة هذا لاستخدام القيمة التلقائية دائمًا. |
alwaysUseDefaultValue |
تتحكّم هذه السياسة في ما إذا كان يتم استخدام القيمة التلقائية ورمز العملة التلقائي بدلاً من القيمة ورمز العملة المحدّدَين في أحداث الإحالة الناجحة لإجراء الإحالة الناجحة هذا. |
AttributionModelSettings
الإعدادات ذات الصلة بنموذج تحديد المصدر لإجراء الإحالة الناجحة هذا
تمثيل JSON |
---|
{ "attributionModel": enum ( |
الحقول | |
---|---|
attributionModel |
نوع نموذج تحديد المصدر لإجراء الإحالة الناجحة هذا |
dataDrivenModelStatus |
حالة نموذج تحديد المصدر بالاستناد إلى البيانات لإجراء الإحالة الناجحة. |
AttributionModel
نموذج تحديد المصدر الذي يصف كيفية توزيع نسبة المساهمة في إحالة ناجحة معيّنة على العديد من التفاعلات السابقة المحتملة.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
EXTERNAL |
يتم استخدام نموذج تحديد المصدر الخارجي. |
GOOGLE_ADS_LAST_CLICK |
يَنسِب هذا النموذج كلّ نسبة المساهمة في الإحالة الناجحة إلى النقرة الأخيرة التي حدثت لها. |
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK |
يَنسِب هذا النموذج كل نسبة المساهمة في الإحالة الناجحة إلى النقرة الأولى عليها باستخدام تحديد المصدر على "بحث Google". |
GOOGLE_SEARCH_ATTRIBUTION_LINEAR |
يَنسِب هذا النموذج نسبة المساهمة في الإحالة الناجحة بالتساوي على جميع نقراتها باستخدام نموذج تحديد المصدر على "بحث Google". |
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY |
يوزِّع هذا النموذج نسبة مساهمة أعلى في الإحالة الناجحة بشكلٍ كبير في أحدث نقراته باستخدام تحديد المصدر على "بحث Google" (ونصف العمر هو أسبوع واحد). |
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED |
يَنسِب هذا النموذج% 40 من المساهمة في إتمام الإحالة الناجحة إلى نقراته الأولى والأخيرة. ويتم توزيع نسبة 20% المتبقية بالتساوي على جميع النقرات الأخرى. يستخدم هذا الإجراء إحالة "بحث Google". |
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN |
نموذج مرن يستخدم تعلُّم الآلة لتحديد التوزيع المناسب لنسبة الإسهام بين النقرات باستخدام الإحالة على "بحث Google" |
DataDrivenModelStatus
تسرد حالات النماذج المستندة إلى البيانات.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
AVAILABLE |
النموذج المستند إلى البيانات متاح. |
STALE |
النموذج المستند إلى البيانات قديم. لم يتم تعديله لمدة 7 أيام على الأقل. لا يزال يتم استخدامه، ولكن ستنتهي صلاحيته إذا لم يتم تعديله لمدة 30 يومًا. |
EXPIRED |
انتهت صلاحية النموذج المستند إلى البيانات. ولم يتم تعديله لمدة 30 يومًا على الأقل ولا يمكن استخدامه. يحدث ذلك غالبًا لأنه لم يتوفر العدد المطلوب للأحداث خلال آخر 30 يومًا. |
NEVER_GENERATED |
لم يتم إنشاء نموذج مستند إلى البيانات مطلقًا. وغالبًا ما يحدث ذلك بسبب عدم توفُّر العدد المطلوب للأحداث خلال أي فترة 30 يومًا. |
FloodlightSettings
الإعدادات ذات الصلة بإجراء إحالة ناجحة في Floodlight
تمثيل JSON |
---|
{ "activityGroupTag": string, "activityTag": string, "activityId": string } |
الحقول | |
---|---|
activityGroupTag |
سلسلة تُستخدَم لتحديد مجموعة أنشطة Floodlight عند إعداد تقارير عن الإحالات الناجحة. |
activityTag |
سلسلة تُستخدَم لتحديد نشاط Floodlight عند إعداد تقارير عن الإحالات الناجحة. |
activityId |
رقم تعريف نشاط Floodlight في DoubleClick Campaign Manager |
ConversionCustomVariable
متغير مخصَّص للإحالة الناجحة. اطّلِع على "لمحة عن مقاييس Floodlight المخصّصة والسمات في التجربة الجديدة من "إعلانات شبكة البحث 360" على الرابط https://support.google.com/sa360/answer/13567857.
تمثيل JSON |
---|
{ "resourceName": string, "id": string, "name": string, "tag": string, "status": enum ( |
الحقول | |
---|---|
resourceName |
اسم المورد للمتغيّر المخصّص للإحالة الناجحة تكون أسماء موارد المتغيّرات المخصّصة للإحالات الناجحة على النحو التالي:
|
id |
رقم تعريف المتغيّر المخصَّص للإحالة الناجحة. |
name |
مطلوبة. اسم المتغيّر المخصَّص للإحالة الناجحة. يجب أن يكون الاسم فريدًا. يجب ألا يزيد عدد أحرف الاسم عن 100 حرف. يجب ألا تكون هناك أي مسافات إضافية قبل الاسم وبعده. |
tag |
مطلوبة. علامة المتغيّر المخصَّص للإحالة الناجحة يجب أن تكون العلامة فريدة وتتألف من حرف "u" متبوعًا مباشرةً برقم أقل من أو يساوي 100. على سبيل المثال: "u4". |
status |
حالة المتغيّر المخصَّص للإحالة الناجحة لتجميع حدث الإحالة الناجحة |
ownerCustomer |
اسم المورد للعميل الذي يملك المتغيّر المخصّص للإحالة الناجحة |
family |
عائلة المتغيّر المخصَّص للإحالة الناجحة |
cardinality |
عدد القيم الفريدة للمتغيّر المخصّص للإحالة الناجحة |
floodlightConversionCustomVariableInfo |
حقول المتغيّرات المخصَّصة للإحالات الناجحة على Floodlight في "إعلانات شبكة البحث 360" |
customColumnIds[] |
أرقام تعريف الأعمدة المخصّصة التي تستخدِم هذا المتغيّر المخصّص للإحالة الناجحة. |
ConversionCustomVariableStatus
الحالات المحتملة للمتغيّر المخصّص للإحالة الناجحة
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
ACTIVATION_NEEDED |
المتغيّر المخصَّص للإحالة الناجحة في انتظار التفعيل، ولن يتراكم أي إحصاءات إلى أن يتم ضبطه على "تفعيل". لا يمكن استخدام هذه الحالة في طلبات CREATE وUPDATE. |
ENABLED |
تم تفعيل المتغيّر المخصَّص للإحالة الناجحة وسيتم تجميع إحصاءات. |
PAUSED |
تم إيقاف المتغيّر المخصَّص للإحالة الناجحة مؤقتًا، ولن يتراكم أي إحصاءات إلى أن يتم ضبطه على "تفعيل" مرة أخرى. |
ConversionCustomVariableFamily
عائلة متغيّر مخصّص للإحالة الناجحة.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
STANDARD |
المتغيّر المخصَّص للإحالة الناجحة العادي. على العملاء تفعيل حساباتهم قبل استخدامها. |
FLOODLIGHT |
المتغيّر المخصَّص للإحالة الناجحة تم استيراده من متغيّر Floodlight مخصَّص. |
ConversionCustomVariableCardinality
عدد القيم الفريدة لمتغيّر مخصّص للإحالة الناجحة
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
BELOW_ALL_LIMITS |
عدد القيم الفريدة للسمة في المتغيّر المخصَّص للإحالة الناجحة أقل من كل الحدود. يمكن استخدام المتغير للتقسيم إلى شرائح، ويمكن أن تتراكم إحصاءات للقيم الجديدة إذا كان المتغير مفعَّلاً. |
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT |
يحتوي المتغيّر المخصَّص للإحالة الناجحة على عدد عناصر في الحقل يتجاوز حد التصنيف إلى قطاعات، ولكنه لا يتجاوز الحد الأقصى للإحصاءات. سيتم إيقاف التصنيف إلى شرائح، ولكن يمكن أن تتراكم إحصاءات للقيم الجديدة في حال تفعيل المتغيّر. |
APPROACHES_STATS_LIMIT |
تجاوز المتغير المخصّص للإحالة الناجحة حدود التصنيف إلى شرائح، ويوشك على بلوغ الحدود القصوى للإحصاءات (> 90%). سيتم إيقاف التصنيف إلى شرائح، ولكن يمكن أن تتراكم إحصاءات للقيم الجديدة في حال تفعيل المتغيّر. |
EXCEEDS_STATS_LIMIT |
تجاوز المتغيّر المخصَّص للإحالة الناجحة كلاً من حدود التصنيف إلى شرائح وحدود الإحصاءات. سيتم إيقاف التصنيف إلى شرائح، ولن يتم تجميع إحصاءات المتغيّرات المفعّلة إلا إذا لم تؤدي القيم الحالية إلى زيادة عدد القيم الفريدة للسمة في المتغيّر. |
FloodlightConversionCustomVariableInfo
معلومات عن المتغيّرات المخصّصة للإحالات الناجحة في Floodlight في "إعلانات شبكة البحث 360".
تمثيل JSON |
---|
{ "floodlightVariableType": enum ( |
الحقول | |
---|---|
floodlightVariableType |
نوع متغيّر Floodlight المحدّد في "إعلانات شبكة البحث 360". |
floodlightVariableDataType |
نوع بيانات متغيّر Floodlight المحدّد في "إعلانات شبكة البحث 360". |
FloodlightVariableType
نوع متغيّر Floodlight، كما هو محدّد في "إعلانات شبكة البحث 360" يمكنك الانتقال إلى https://support.google.com/searchads/answer/4397154?hl=en للاطّلاع على مزيد من المعلومات.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
DIMENSION |
نوع متغيّر السمة Floodlight |
METRIC |
نوع متغيّر Floodlight للمقياس |
UNSET |
لم يتم ضبط نوع متغير Floodlight. |
FloodlightVariableDataType
نوع بيانات متغيّر Floodlight، على النحو المحدّد في "إعلانات شبكة البحث 360" يمكنك الانتقال إلى https://support.google.com/searchads/answer/4397154?hl=en للاطّلاع على مزيد من المعلومات.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
NUMBER |
ويمثِّل متغيّر Floodlight من النوع "Number". يمكن تخصيص هذا المتغيّر لمتغيّرات Floodlight من نوعَي كيلومترَين أو METRIC. |
STRING |
ويمثِّل متغيّر Floodlight من النوع "سلسلة". يمكن تخصيص هذا المتغيّر لمتغيّرات Floodlight من نوع السمات. |
العميل
عميل.
تمثيل JSON |
---|
{ "resourceName": string, "conversionTrackingSetting": { object ( |
الحقول | |
---|---|
resourceName |
اسم مورد العميل. تكون أسماء موارد العملاء على النحو التالي:
|
conversionTrackingSetting |
إعداد تتبُّع الإحالات الناجحة للعميل. |
accountType |
نوع حساب محرّك البحث، مثل "إعلانات Google" أو Microsoft Advertising أو Yahoo Japan أو Baidu أو Facebook أو Engine Track أو غير ذلك |
doubleClickCampaignManagerSetting |
إعداد DoubleClick Campaign Manager لعميل إداري. |
accountStatus |
حالة الحساب، على سبيل المثال، مفعَّل أو متوقف مؤقتًا أو مُزالة وما إلى ذلك. |
lastModifiedTime |
التاريخ والوقت الذي تم فيه إجراء آخر تعديل لهذا العميل يتم تحديد التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ssssss". |
engineId |
رقم تعريف الحساب في حساب محرّك البحث الخارجي |
status |
حالة العميل. |
creationTime |
الطابع الزمني عند إنشاء هذا العميل يكون الطابع الزمني حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss". |
id |
رقم تعريف العميل. |
descriptiveName |
اسم وصفي اختياري وغير فريد للعميل |
currencyCode |
العملة التي يعمل بها الحساب. ويمكن استخدام مجموعة فرعية من رموز العملات وفقًا لمعيار ISO 4217. |
timeZone |
رقم تعريف المنطقة الزمنية المحلية للعميل |
trackingUrlTemplate |
نموذج عنوان URL لإنشاء عنوان URL للتتبّع باستخدام المَعلمات |
finalUrlSuffix |
نموذج عنوان URL لإلحاق المَعلمات بعنوان URL النهائي |
autoTaggingEnabled |
ما إذا كان وضع العلامات التلقائي مفعَّلاً للعميل أم لا. |
manager |
ما إذا كان العميل مديرًا. |
ConversionTrackingSetting
مجموعة من الإعدادات على مستوى العميل ذات الصلة بتتبُّع الإحالات الناجحة في "إعلانات شبكة البحث 360".
تمثيل JSON |
---|
{
"acceptedCustomerDataTerms": boolean,
"conversionTrackingStatus": enum ( |
الحقول | |
---|---|
acceptedCustomerDataTerms |
ما إذا كان العميل قد وافق على بنود بيانات العملاء وفي حال استخدام تتبُّع الإحالات الناجحة في جميع الحسابات، يتم اكتساب هذه القيمة من الحساب الإداري. هذا الحقل للقراءة فقط. لمزيد من المعلومات، يُرجى الاطّلاع على https://support.google.com/adspolicy/answer/7475709. |
conversionTrackingStatus |
حالة تتبُّع الإحالات الناجحة. ويشير إلى ما إذا كان العميل يستخدم تتبُّع الإحالات الناجحة، وهو مالك تتبُّع الإحالات الناجحة لهذا العميل. إذا كان هذا العميل يستخدم ميزة تتبُّع الإحالات الناجحة في جميع الحسابات، ستختلف القيمة المعروضة بناءً على |
enhancedConversionsForLeadsEnabled |
ما إذا كان العميل قد فعّل ميزة الإحالات الناجحة المحسّنة للعملاء المحتملين وفي حال استخدام تتبُّع الإحالات الناجحة في جميع الحسابات، يتم اكتساب هذه القيمة من الحساب الإداري. هذا الحقل للقراءة فقط. |
googleAdsConversionCustomer |
اسم المورد للعميل حيث يتم إنشاء الإحالات الناجحة وإدارتها. هذا الحقل للقراءة فقط. |
conversionTrackingId |
رقم تعريف تتبُّع الإحالات الناجحة المستخدَم لهذا الحساب. لا يشير هذا الرقم التعريفي إلى ما إذا كان العميل يستخدم تتبع الإحالات الناجحة (conversionTrackingStatus لا). هذا الحقل للقراءة فقط. |
googleAdsCrossAccountConversionTrackingId |
رقم تعريف تتبُّع الإحالات الناجحة لمدير العميل. يتم ضبط ذلك عند تفعيل العميل لميزة "تتبُّع الإحالات الناجحة"، ويؤدي ذلك إلى إلغاء قيمة الإحالة الناجحة. لا يمكن إدارة هذا الحقل إلّا من خلال واجهة مستخدِم "إعلانات Google". هذا الحقل للقراءة فقط. |
crossAccountConversionTrackingId |
رقم تعريف تتبُّع الإحالات الناجحة لمدير العميل. يتم ضبط ذلك عند تفعيل العميل لميزة "تتبُّع الإحالات الناجحة في جميع الحسابات"، ويتم بالتالي إلغاء قيمة الإحالة الناجحةTrackingId. |
ConversionTrackingStatus
حالة تتبُّع الإحالات الناجحة للعميل.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
NOT_CONVERSION_TRACKED |
لا يستخدم العميل أي تتبُّع للإحالات الناجحة. |
CONVERSION_TRACKING_MANAGED_BY_SELF |
ينشئ هذا العميل إجراءات الإحالات الناجحة ويديرها. |
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER |
يتم إنشاء إجراءات الإحالات الناجحة وإدارتها من خلال المدير المحدّد في login-customer-id للطلب. |
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER |
يتم إنشاء إجراءات الإحالات الناجحة وإدارتها من خلال مدير مختلف عن العميل أو المدير المحدَّد في login-customer-id الخاص بالطلب. |
AccountType
أنواع حسابات محرّكات البحث المحتمَلة
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
BAIDU |
حسابك على Baidu. |
ENGINE_TRACK |
حساب تتبُّع محرّكات البحث |
FACEBOOK |
حساب على Facebook. |
FACEBOOK_GATEWAY |
تتم إدارة حساب Facebook من خلال البوابة. |
GOOGLE_ADS |
حسابك في إعلانات Google. |
MICROSOFT |
حسابك على Microsoft Advertising. |
SEARCH_ADS_360 |
حساب إداري على "إعلانات شبكة البحث 360". |
YAHOO_JAPAN |
حساب Yahoo Japan. |
DoubleClickCampaignManagerSetting
إعداد DoubleClick Campaign Manager لعميل إداري.
تمثيل JSON |
---|
{ "advertiserId": string, "networkId": string, "timeZone": string } |
الحقول | |
---|---|
advertiserId |
رقم تعريف المعلِن في "مدير الحملة" المرتبط بهذا العميل. |
networkId |
رقم تعريف شبكة "مدير الحملة" المرتبطة بهذا العميل. |
timeZone |
المنطقة الزمنية لشبكة "مدير الحملة" المرتبطة بهذا العميل بتنسيق قاعدة بيانات المناطق الزمنية IANA، مثل أمريكا/نيو يورك. |
AccountStatus
الحالات المحتملة للحساب.
عمليات التعداد | |
---|---|
UNSPECIFIED |
القيمة التلقائية. |
UNKNOWN |
قيمة غير معروفة. |
ENABLED |
يمكن للحساب عرض الإعلانات. |
PAUSED |
أوقف المستخدم الحساب. |
SUSPENDED |
يتم إيقاف الحساب من خلال عملية داخلية. |
REMOVED |
ويتم إيقاف الحساب بشكل لا رجعة فيه. |
DRAFT |
لا يزال الحساب قيد الإعداد، ولم يتم تفعيله بعد. |
CustomerStatus
الحالات المحتملة للعميل.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
ENABLED |
يشير هذا الرمز إلى حساب نشط يمكنه عرض الإعلانات. |
CANCELED |
يشير إلى حساب مُلغى غير قادر على عرض الإعلانات. يمكن للمستخدم المشرف إعادة تفعيله. |
SUSPENDED |
يشير إلى حساب معلّق غير قادر على عرض الإعلانات. لا يمكن تفعيلها إلا من خلال فريق الدعم في Google. |
CLOSED |
يشير إلى حساب مغلق غير قادر على عرض الإعلانات. ستكون حالة الحساب التجريبي أيضًا "مغلق". إنّ الحالة دائمة ولا يمكن إعادة فتحها. |
CustomerAsset
تمثّل هذه السمة رابطًا بين عميل ومادة عرض.
تمثيل JSON |
---|
{
"resourceName": string,
"asset": string,
"status": enum ( |
الحقول | |
---|---|
resourceName |
اسم المورد لمادة عرض العميل. تكون أسماء موارد CustomerAsset على النحو التالي:
|
asset |
مطلوبة. مادة العرض المرتبطة بالعميل. |
status |
حالة مادة عرض العميل. |
CustomerAssetSet
CustomerAssetSet هو الرابط بين عميل ومجموعة مواد عرض. تؤدي إضافة CustomerAssetSet إلى ربط مجموعة مواد عرض بعميل.
تمثيل JSON |
---|
{
"resourceName": string,
"assetSet": string,
"customer": string,
"status": enum ( |
الحقول | |
---|---|
resourceName |
اسم المورد لمجموعة مواد العرض الخاصة بالعميل تكون أسماء موارد مواد العرض ضمن مجموعة مواد العرض على النحو التالي:
|
assetSet |
مجموعة مواد العرض المرتبطة بالعميل. |
customer |
العميل الذي ترتبط به مجموعة مواد العرض هذه. |
status |
حالة مادة عرض مجموعة مواد العرض للعميل. للقراءة فقط |
AccessibleBiddingStrategy
يمثّل عرضًا لاستراتيجيات عروض الأسعار التي يملكها العميل وتتم مشاركتها معه.
وعلى عكس "عروض الأسعار" (عروض الأسعار)، يتضمّن هذا المرجع استراتيجيات يملكها مدراء العميل وتمت مشاركتها مع هذا العميل، بالإضافة إلى الاستراتيجيات التي يملكها هذا العميل. لا يوفّر هذا المرجع مقاييس، وهو يعرض فقط مجموعة فرعية محدودة من سمات "استراتيجية عروض الأسعار".
تمثيل JSON |
---|
{ "resourceName": string, "id": string, "name": string, "type": enum ( |
الحقول | |
---|---|
resourceName |
اسم مورد استراتيجية عروض الأسعار التي يمكن الوصول إليها. تكون أسماء موارد Accessible BiddingStrategy على النحو التالي:
|
id |
رقم تعريف استراتيجية عروض الأسعار. |
name |
اسم استراتيجية عروض الأسعار. |
type |
نوع استراتيجية عروض الأسعار. |
ownerCustomerId |
رقم تعريف العميل الذي يملك استراتيجية عروض الأسعار. |
ownerDescriptiveName |
الاسم الوصفي للعميل الذي يملك استراتيجية عروض الأسعار. |
حقل الاتحاد يمكن ضبط سمة واحدة فقط. يمكن أن يكون الحقل " |
|
maximizeConversionValue |
استراتيجية عروض أسعار مبرمَجة للمساعدة في الحصول على أقصى قيمة للإحالة الناجحة لحملاتك في حدود ميزانيتك |
maximizeConversions |
استراتيجية عروض أسعار مبرمَجة للمساعدة في الحصول على أكبر عدد من الإحالات الناجحة لحملاتك في حدود ميزانيتك |
targetCpa |
استراتيجية عروض أسعار تعمل على ضبط عروض الأسعار لمساعدتك في الحصول على أكبر عدد ممكن من الإحالات الناجحة بتكلفة الإجراء المستهدَفة التي تحدّدها. |
targetImpressionShare |
استراتيجية عروض أسعار يتم تحسينها تلقائيًا لزيادة نسبة مئوية مختارة من مرات الظهور. |
targetRoas |
استراتيجية عروض أسعار تساعدك على زيادة الأرباح إلى أقصى حد مع بلوغ متوسط عائد إنفاق إعلاني مستهدَف معيّن. |
targetSpend |
استراتيجية عروض أسعار تحدِّد عروض أسعارك لمساعدتك في الحصول على أكبر عدد ممكن من النقرات في حدود ميزانيتك. |
MaximizeConversionValue
استراتيجية عروض أسعار مبرمَجة للمساعدة في الحصول على أقصى قيمة للإحالة الناجحة لحملاتك في حدود ميزانيتك
تمثيل JSON |
---|
{ "targetRoas": number } |
الحقول | |
---|---|
targetRoas |
خيار عائد الإنفاق الإعلاني المستهدَف (ROAS). وفي حال تحديدها، ستؤدي استراتيجية عروض الأسعار إلى زيادة الأرباح إلى أقصى حدّ مع احتساب متوسط عائد الإنفاق الإعلاني المستهدَف. إذا كان عائد الإنفاق الإعلاني المستهدف مرتفعًا، قد لا تتمكّن استراتيجية عروض الأسعار من إنفاق الميزانية بالكامل. وفي حال عدم ضبط عائد الإنفاق الإعلاني المستهدَف، ستهدِف استراتيجية عروض الأسعار إلى تحقيق أعلى عائد إنفاق إعلاني ممكن في الميزانية. |
MaximizeConversions
استراتيجية عروض أسعار مبرمَجة للمساعدة في الحصول على أكبر عدد من الإحالات الناجحة لحملاتك في حدود ميزانيتك
تمثيل JSON |
---|
{ "targetCpa": string, "targetCpaMicros": string } |
الحقول | |
---|---|
targetCpa |
خيار التكلفة المستهدفة للإجراء. هذا هو متوسط المبلغ الذي تريد إنفاقه لكل عملية اكتساب. |
targetCpaMicros |
خيار التكلفة المستهدفة للإجراء. هذا هو متوسط المبلغ الذي تريد إنفاقه لكل عملية اكتساب. |
TargetCpa
استراتيجية عروض أسعار مُبرمَجة تُحدِّد عروض الأسعار لمساعدتك في الحصول على أكبر عدد ممكن من الإحالات الناجحة بالتكلفة المستهدفة للإجراء التي تحدِّدها.
تمثيل JSON |
---|
{ "targetCpaMicros": string } |
الحقول | |
---|---|
targetCpaMicros |
متوسط تكلفة الإجراء المستهدفة. يجب أن تكون قيمة هذا الاستهداف أكبر من الحد الأدنى للوحدة القابلة للفوترة أو مساويًا له استنادًا إلى عملة الحساب. |
TargetRoas
استراتيجية عروض أسعار مبرمَجة تساعدك على زيادة الأرباح إلى أقصى حد مع احتساب متوسط عائد إنفاق إعلاني مستهدَف محدّد
تمثيل JSON |
---|
{ "targetRoas": number } |
الحقول | |
---|---|
targetRoas |
الأرباح المختارة (استنادًا إلى بيانات الإحالات الناجحة) لكل وحدة إنفاق. |
TargetSpend
استراتيجية عروض أسعار مُبرمَجة تُحدِّد عروض أسعارك للمساعدة في الحصول على أكبر عدد ممكن من النقرات في حدود ميزانيتك.
تمثيل JSON |
---|
{ "targetSpendMicros": string, "cpcBidCeilingMicros": string } |
الحقول | |
---|---|
targetSpendMicros |
الإنفاق المستهدف الذي يتم بموجبه تحقيق الحد الأقصى من النقرات. سيحاول مقدِّم عروض أسعار "الإنفاق الهدف" إنفاق القيمة الأقلّ من هذه القيمة أو مبلغ الإنفاق المضبوط بشكلٍ طبيعي. وفي حال عدم تحديدها، يتم استخدام الميزانية على أنها الإنفاق المستهدف. تم إيقاف هذا الحقل نهائيًا ويجب عدم استخدامه بعد الآن. يمكنك الاطّلاع على https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html لمعرفة التفاصيل. |
cpcBidCeilingMicros |
الحد الأقصى لعروض الأسعار الذي يمكن ضبطه من خلال استراتيجية عروض الأسعار. وينطبق هذا الحد على جميع الكلمات الرئيسية التي تديرها الاستراتيجية. |
CustomerManagerLink
يمثل علاقة الربط بين مدير العميل والعميل.
تمثيل JSON |
---|
{
"resourceName": string,
"status": enum ( |
الحقول | |
---|---|
resourceName |
اسم المورد تكون أسماء موارد CustomerManagerLink على النحو التالي: |
status |
حالة الربط بين العميل والمدير. |
managerCustomer |
العميل الإداري المرتبط بالعميل. |
managerLinkId |
رقم تعريف رابط مدير العميل. هذا الحقل للقراءة فقط. |
ManagerLinkStatus
الحالات المحتملة للرابط.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
ACTIVE |
يشير إلى علاقة التأثير الحالية |
INACTIVE |
يشير إلى إنهاء العلاقة |
PENDING |
تشير إلى أن المدير طلب العلاقة، لكن العميل لم يقبلها بعد. |
REFUSED |
تم طلب العلاقة من قبل المدير، لكن العميل رفض ذلك. |
CANCELED |
يشير إلى أن المدير طلب العلاقة، لكن المدير ألغاها. |
CustomerClient
تمثّل هذه السمة رابطًا بين عميل محدّد وعميل معيّن. يتوفر CustomerClients للعملاء الإداريين فقط. ويتم تضمين جميع العملاء المباشرين وغير المباشرين، بالإضافة إلى المدير نفسه.
تمثيل JSON |
---|
{
"resourceName": string,
"appliedLabels": [
string
],
"status": enum ( |
الحقول | |
---|---|
resourceName |
اسم المورد للعميل. تكون أسماء موارد CustomerClient على النحو التالي: |
appliedLabels[] |
أسماء الموارد للتصنيفات التي يملكها العميل الذي قدّم الطلب والتي يتم تطبيقها على العميل. تكون أسماء موارد التصنيف على النحو التالي:
|
status |
حالة العميل. للقراءة فقط |
clientCustomer |
اسم المورد للعميل - العميل المرتبط بالعميل المحدّد. للقراءة فقط |
level |
المسافة بين العميل المحدّد والعميل. بالنسبة إلى خيار الربط الذاتي، ستكون قيمة المستوى 0. للقراءة فقط |
timeZone |
تمثيل سلسلة بيانات لغة محلية مشتركة (CLDR) للمنطقة الزمنية للعميل، مثل America/Los_Angeles. للقراءة فقط |
testAccount |
تحدِّد ما إذا كان العميل حسابًا تجريبيًا. للقراءة فقط |
manager |
يحدد ما إذا كان العميل مديرًا أم لا. للقراءة فقط |
descriptiveName |
تمثّل هذه السمة الاسم الوصفي للعميل. للقراءة فقط |
currencyCode |
رمز العملة (على سبيل المثال، "USD" و"EUR") للعميل. للقراءة فقط |
id |
رقم تعريف العميل. للقراءة فقط |
DynamicSearchAdsSearchTermView
طريقة عرض عبارة بحث للإعلانات الديناميكية على شبكة البحث
تمثيل JSON |
---|
{ "resourceName": string, "landingPage": string } |
الحقول | |
---|---|
resourceName |
اسم المورد لعرض عبارة البحث للإعلانات الديناميكية على شبكة البحث. وتكون أسماء موارد عرض عبارات البحث للإعلانات الديناميكية على شبكة البحث على النحو التالي:
|
landingPage |
عنوان URL للصفحة المقصودة المحدّد ديناميكيًا لمرة الظهور. هذا الحقل للقراءة فقط. |
GenderView
عرض الجنس. يعكس مورد genderView حالة العرض الفعالة، بدلاً من المعايير التي تمت إضافتها. تظهر المجموعة الإعلانية التي لا تحتوي على معايير الجنس بشكلٍ تلقائي لجميع الأجناس، لذلك تظهر جميع الأجناس في genderView مع إحصاءات.
تمثيل JSON |
---|
{ "resourceName": string } |
الحقول | |
---|---|
resourceName |
اسم المورد لعرض الجنس. تكون أسماء موارد عرض الجنس على النحو التالي:
|
GeoTargetConstant
عدد ثابت للاستهداف الجغرافي.
تمثيل JSON |
---|
{
"resourceName": string,
"status": enum ( |
الحقول | |
---|---|
resourceName |
اسم المورد وثابت الهدف الجغرافي وتكون أسماء الموارد الثابتة للاستهداف الجغرافي على النحو التالي:
|
status |
الحالة الثابتة للاستهداف الجغرافي |
id |
رقم تعريف ثابت الهدف الجغرافي. |
name |
الاستهداف الجغرافي لاسم ثابت باللغة الإنجليزية. |
countryCode |
تمثّل هذه السمة رمز البلد وفقًا لمعيار ISO-3166-1 alpha-2 المرتبط بالهدف. |
targetType |
نوع استهداف ثابت للاستهداف الجغرافي |
canonicalName |
تمثّل هذه السمة الاسم باللغة الإنجليزية المؤهل بالكامل، ويتكون من اسم الهدف واسم البلد الأصلي والبلد. |
parentGeoTarget |
اسم المورد وثابت الهدف الجغرافي الرئيسي وتكون أسماء الموارد الثابتة للاستهداف الجغرافي على النحو التالي:
|
GeoTargetConstantStatus
تمثّل هذه السمة الحالات المحتملة لثابت الاستهداف الجغرافي.
عمليات التعداد | |
---|---|
UNSPECIFIED |
لم يتم تحديد قيمة. |
UNKNOWN |
القيمة المُستلَمة غير معروفة في هذا الإصدار. هذه قيمة للاستجابة فقط. |
ENABLED |
ثابت الهدف الجغرافي صالح. |
REMOVAL_PLANNED |
ثابت الهدف الجغرافي قديم وستتم إزالته. |
KeywordView
طريقة عرض الكلمات الرئيسية.
تمثيل JSON |
---|
{ "resourceName": string } |
الحقول | |
---|---|
resourceName |
اسم المورد لعرض الكلمات الرئيسية. وتكون أسماء موارد عرض الكلمات الرئيسية على النحو التالي:
|
التصنيف
التصنيف
تمثيل JSON |
---|
{ "resourceName": string, "status": enum ( |
الحقول | |
---|---|
resourceName |
اسم المورد تكون أسماء موارد التصنيفات على النحو التالي: |
status |
حالة التصنيف. للقراءة فقط |
textLabel |
يشير ذلك المصطلح إلى نوع من التصنيفات يعرض نصًا على خلفية ملوّنة. |
id |
رقم تعريف التصنيف. للقراءة فقط |
name |
اسم التصنيف. هذا الحقل مطلوب ويجب ألا يكون فارغًا عند إنشاء تصنيف جديد. يجب أن يتراوح طول هذه السلسلة بين 1 و80، بشكل شامل. |
LabelStatus
الحالات المحتملة للتصنيف.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
ENABLED |
تم تفعيل التصنيف. |
REMOVED |
تمت إزالة التصنيف. |
TextLabel
يشير ذلك المصطلح إلى نوع من التصنيفات يعرض نصًا على خلفية ملوّنة.
تمثيل JSON |
---|
{ "backgroundColor": string, "description": string } |
الحقول | |
---|---|
backgroundColor |
لون خلفية التصنيف بالتنسيق RGB يجب أن تتطابق هذه السلسلة مع التعبير العادي '^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. ملاحظة: قد لا يكون لون الخلفية مرئيًا للحسابات الإدارية. |
description |
اكتب وصفًا موجزًا للتصنيف. يجب ألا يزيد عدد الأحرف عن 200 حرف. |
LanguageConstant
لغة.
تمثيل JSON |
---|
{ "resourceName": string, "id": string, "code": string, "name": string, "targetable": boolean } |
الحقول | |
---|---|
resourceName |
تمثّل هذه السمة اسم المورد الثابت اللغوي. وتكون أسماء موارد اللغة الثابتة على النحو التالي:
|
id |
معرّف ثابت اللغة. |
code |
رمز اللغة، على سبيل المثال، "en_US" و"en_AU" و"es" و"fr" وما إلى ذلك. |
name |
الاسم الكامل للغة الإنجليزية، مثل "الإنجليزية (الولايات المتحدة)" أو "الإسبانية" إلخ. |
targetable |
ما إذا كانت اللغة قابلة للاستهداف أم لا. |
LocationView
يلخِّص عرض الموقع الجغرافي أداء الحملات حسب معيار الموقع الجغرافي.
تمثيل JSON |
---|
{ "resourceName": string } |
الحقول | |
---|---|
resourceName |
اسم المورد لعرض الموقع الجغرافي. تكون أسماء موارد عرض الموقع على النحو التالي:
|
ProductBiddingCategoryConstant
فئة عروض أسعار للمنتجات.
تمثيل JSON |
---|
{ "resourceName": string, "level": enum ( |
الحقول | |
---|---|
resourceName |
اسم المورد لفئة عروض أسعار المنتج. وتكون أسماء موارد فئات عروض أسعار المنتجات على النحو التالي:
|
level |
مستوى فئة عروض أسعار المنتج. |
status |
حالة فئة عروض أسعار المنتج. |
id |
رقم تعريف فئة عروض أسعار المنتج. يعادل هذا المعرّف رقم تعريف فئة_المنتجات google_product_category كما هو موضّح في هذه المقالة: https://support.google.com/merchants/answer/6324436. |
countryCode |
رمز بلد مكوّن من حرفَين كبيرَين ضمن فئة عروض أسعار المنتج. |
productBiddingCategoryConstantParent |
اسم المورد لفئة عروض أسعار المنتجات الرئيسية |
languageCode |
رمز اللغة لفئة عروض أسعار المنتج. |
localizedName |
القيمة المعروضة لفئة عروض أسعار المنتجات المترجَمة حسب رمز اللغة |
ProductBiddingCategoryLevel
يشير هذا المقياس إلى تعداد يصف مستوى فئة عروض أسعار المنتجات.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
LEVEL1 |
المستوى 1. |
LEVEL2 |
المستوى 2. |
LEVEL3 |
المستوى 3. |
LEVEL4 |
المستوى 4. |
LEVEL5 |
المستوى 5. |
ProductBiddingCategoryStatus
يشير هذا المقياس إلى تعداد يصف حالة فئة عروض أسعار المنتجات.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
ACTIVE |
الفئة نشطة ويمكن استخدامها لتقديم عروض الأسعار. |
OBSOLETE |
الفئة قديمة. تُستخدَم لأغراض إعداد التقارير فقط. |
ProductGroupView
عرض مجموعة منتجات.
تمثيل JSON |
---|
{ "resourceName": string } |
الحقول | |
---|---|
resourceName |
اسم المورد لعرض مجموعة المنتجات. تكون أسماء الموارد المعروضة لمجموعة المنتجات على النحو التالي:
|
ShoppingPerformanceView
عرض أداء التسوّق توفر إحصاءات حملات Shopping مجمّعة على مستويات متعددة لأبعاد المنتج. تجدر الإشارة إلى أنّ قيم سمات المنتج من Merchant Center، مثل العلامة التجارية والفئة والسمات المخصّصة وحالة المنتج ونوع المنتج، ستعكس حالة كل سمة اعتبارًا من التاريخ والوقت اللذين تمّ فيهما تسجيل الحدث المقابل.
تمثيل JSON |
---|
{ "resourceName": string } |
الحقول | |
---|---|
resourceName |
اسم المورد لعرض أداء Shopping تكون أسماء مراجع عرض أداء التسوّق على النحو التالي: |
UserList
قائمة مستخدمين هذه قائمة بالمستخدمين الذين قد يستهدفهم العميل.
تمثيل JSON |
---|
{
"resourceName": string,
"type": enum ( |
الحقول | |
---|---|
resourceName |
اسم المورد لقائمة المستخدمين. تكون أسماء موارد قائمة المستخدمين على النحو التالي:
|
type |
نوع هذه القائمة هذا الحقل للقراءة فقط. |
id |
رقم تعريف قائمة المستخدمين. |
name |
اسم قائمة المستخدمين هذه. قد لا يكون اسم قائمة المستخدمين فريدًا، بناءً على access_reason، (على سبيل المثال، إذا access_reason=SHARED). |
UserListType
يتضمن التعداد أنواع قوائم المستخدمين المحتملة.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
REMARKETING |
يتم تمثيل قائمة المستخدمين كمجموعة من أنواع الإحالات الناجحة. |
LOGICAL |
يتم تمثيل قائمة المستخدمين كمجموعة من قوائم/اهتمامات المستخدمين الأخرى. |
EXTERNAL_REMARKETING |
قائمة المستخدمين التي تم إنشاؤها في منصة "مدير إعلانات Google". |
RULE_BASED |
UserList المرتبطة بقاعدة. |
SIMILAR |
قائمة مستخدمين تتضمن مستخدمين مشابهين لمستخدمي قائمة مستخدمين أخرى. |
CRM_BASED |
قائمة المستخدمين ببيانات إدارة علاقات العملاء بالطرف الأول المقدمة من المعلن في شكل رسائل إلكترونية أو تنسيقات أخرى. |
WebpageView
طريقة عرض صفحة الويب
تمثيل JSON |
---|
{ "resourceName": string } |
الحقول | |
---|---|
resourceName |
اسم المورد لعرض صفحة الويب تكون أسماء موارد عرض صفحة الويب على النحو التالي:
|
انتقال
زيارة.
تمثيل JSON |
---|
{ "resourceName": string, "id": string, "criterionId": string, "merchantId": string, "adId": string, "clickId": string, "visitDateTime": string, "productId": string, "productChannel": enum ( |
الحقول | |
---|---|
resourceName |
اسم مورد الزيارة تكون أسماء موارد الزيارات على النحو التالي:
|
id |
رقم تعريف الزيارة. |
criterionId |
رقم تعريف الكلمة الرئيسية في "إعلانات شبكة البحث 360". تشير القيمة 0 إلى أنّ الكلمة الرئيسية لم يتم تحديد مصدرها. |
merchantId |
رقم تعريف حساب المستودع في "إعلانات شبكة البحث 360" الذي يحتوي على المنتج الذي تم النقر عليه. تُنشئ "إعلانات شبكة البحث 360" هذا المعرّف عند ربط حساب مستودع في "إعلانات شبكة البحث 360". |
adId |
الرقم التعريفي للإعلان. تشير القيمة 0 إلى أنّه لم يتم تحديد مصدر الإعلان. |
clickId |
سلسلة فريدة لكل زيارة يتم تمريرها إلى الصفحة المقصودة على أنّها مَعلمة عنوان URL لمعرّف النقرة. |
visitDateTime |
الطابع الزمني لحدث الزيارة يكون الطابع الزمني حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss". |
productId |
رقم تعريف المنتج الذي تم النقر عليه. |
productChannel |
قناة البيع الخاصة بالمنتج الذي تم النقر عليه: على الإنترنت أو محلي |
productLanguageCode |
اللغة (ISO-639-1) التي تم ضبطها لخلاصة Merchant Center وتحتوي على بيانات حول المنتج. |
productStoreId |
المتجر في إعلان المنتجات داخل المتجر الذي تم النقر عليه. ويجب أن تتطابق هذه القيمة مع أرقام تعريف المتاجر المستخدَمة في خلاصة المنتجات في المتاجر المحلّية. |
productCountryCode |
البلد (بتنسيق ISO-3166) المسجَّل في خلاصة المستودع التي تحتوي على المنتج الذي تم النقر عليه. |
assetId |
رقم تعريف مادة العرض التي تم التفاعل معها أثناء حدث الزيارة. |
assetFieldType |
نوع حقل مادة العرض لحدث الزيارة |
ProductChannel
يشير هذا المقياس إلى قيم التعداد التي تصف المنطقة المحلية لعرض منتج.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
ONLINE |
يتم بيع السلعة على الإنترنت. |
LOCAL |
يتم بيع السلعة في المتاجر المحلية. |
الإحالة الناجحة
إحالة ناجحة.
تمثيل JSON |
---|
{ "resourceName": string, "id": string, "criterionId": string, "merchantId": string, "adId": string, "clickId": string, "visitId": string, "advertiserConversionId": string, "productId": string, "productChannel": enum ( |
الحقول | |
---|---|
resourceName |
اسم مورد الإحالة الناجحة. وتكون أسماء موارد الإحالات الناجحة على النحو التالي:
|
id |
رقم تعريف الإحالة الناجحة |
criterionId |
رقم تعريف معيار "إعلانات شبكة البحث 360". تشير القيمة 0 إلى أنّ المعيار غير مرتبط. |
merchantId |
رقم تعريف حساب المستودع في "إعلانات شبكة البحث 360" الذي يحتوي على المنتج الذي تم النقر عليه. تُنشئ "إعلانات شبكة البحث 360" هذا المعرّف عند ربط حساب مستودع في "إعلانات شبكة البحث 360". |
adId |
الرقم التعريفي للإعلان. تشير القيمة 0 إلى أنّه لم يتم تحديد مصدر الإعلان. |
clickId |
سلسلة فريدة للزيارة التي تُنسب إليها الإحالة الناجحة، يتم تمريرها إلى الصفحة المقصودة باعتبارها مَعلمة عنوان URL لمعرّف النقرة. |
visitId |
رقم تعريف زيارة "إعلانات شبكة البحث 360" الذي يُنسب إليه الإحالة الناجحة. |
advertiserConversionId |
بالنسبة إلى الإحالات الناجحة بلا إنترنت، يمثّل هذا النوع المعرّف الذي يقدّمه المعلِنون. إذا لم يحدِّد المعلِن رقم تعريف من هذا النوع، تُنشئ "إعلانات شبكة البحث 360" رقمًا تعريفيًا. بالنسبة إلى الإحالات الناجحة على الإنترنت، تساوي هذه القيمة عمود "id" (رقم التعريف) أو عمود FloodlightOrderId استنادًا إلى تعليمات Floodlight للمعلِن. |
productId |
رقم تعريف المنتج الذي تم النقر عليه. |
productChannel |
قناة البيع الخاصة بالمنتج الذي تم النقر عليه: على الإنترنت أو محلي |
productLanguageCode |
اللغة (ISO-639-1) التي تم ضبطها لخلاصة Merchant Center وتحتوي على بيانات حول المنتج. |
productStoreId |
المتجر في إعلان المنتجات داخل المتجر الذي تم النقر عليه. ويجب أن تتطابق هذه القيمة مع أرقام تعريف المتاجر المستخدَمة في خلاصة المنتجات في المتاجر المحلّية. |
productCountryCode |
البلد (بالتنسيق ISO-3166) المسجَّل في خلاصة المستودع التي تحتوي على المنتج الذي تم النقر عليه. |
attributionType |
ما تُنسب إليه الإحالة الناجحة: زيارة أو الكلمة الرئيسية+الإعلان. |
conversionDateTime |
الطابع الزمني لحدث الإحالة الناجحة. |
conversionLastModifiedDateTime |
الطابع الزمني لآخر مرة تم فيها تعديل الإحالة الناجحة. |
conversionVisitDateTime |
الطابع الزمني للزيارة التي تُنسب إليها الإحالة الناجحة. |
conversionQuantity |
كمية السلع التي سجّلتها الإحالة الناجحة، على النحو الذي تحدّده المَعلمة qty لعنوان URL. المعلِن مسؤول عن تعبئة المَعلمة ديناميكيًا (مثل عدد السلع المُباعة في الإحالة الناجحة)، وبخلاف ذلك، يتم ضبطها تلقائيًا على 1. |
conversionRevenueMicros |
الأرباح المعدَّلة بوحدات المايكرو لحدث الإحالة الناجحة. وستكون دائمًا بعملة حساب عرض الإعلانات. |
floodlightOriginalRevenue |
الأرباح الأصلية التي لم تتغيّر والمرتبطة بحدث Floodlight (بعملة التقرير الحالي)، قبل تعديل تعليمات عملة Floodlight |
floodlightOrderId |
مُعرّف طلب Floodlight الذي قدّمه المعلِن للإحالة الناجحة. |
status |
حالة الإحالة الناجحة، إما "مفعّلة" أو "تمّت إزالتها". |
assetId |
رقم تعريف مادة العرض التي تم التفاعل معها أثناء حدث الإحالة الناجحة. |
assetFieldType |
نوع حقل مادة العرض لحدث الإحالة الناجحة. |
AttributionType
نوع تحديد مصدر الإحالات الناجحة في "إعلانات شبكة البحث 360"
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
VISIT |
تُنسب الإحالة الناجحة إلى زيارة. |
CRITERION_AD |
تُنسب الإحالة الناجحة إلى معيار وزوج إعلاني. |
ConversionStatus
الحالات المحتملة للإحالة الناجحة.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
ENABLED |
تم تفعيل الإحالة الناجحة. |
REMOVED |
تمّت إزالة الإحالة الناجحة. |
المقاييس
بيانات المقاييس
تمثيل JSON |
---|
{ "allConversionsValueByConversionDate": number, "allConversionsByConversionDate": number, "conversionCustomMetrics": [ { object ( |
الحقول | |
---|---|
allConversionsValueByConversionDate |
قيمة كل الإحالات الناجحة. عند اختيار هذا العمود مع التاريخ، تشير القيم في عمود "التاريخ" إلى تاريخ الإحالة الناجحة. تتوفّر تفاصيل أعمدة by_conversion_date على الرابط https://support.google.com/sa360/answer/9250611. |
allConversionsByConversionDate |
إجمالي عدد التحويلات. ويتضمّن هذا جميع الإحالات الناجحة بصرف النظر عن قيمة includeIn ConversionsMetric. عند اختيار هذا العمود مع التاريخ، تشير القيم في عمود "التاريخ" إلى تاريخ الإحالة الناجحة. تتوفّر تفاصيل أعمدة by_conversion_date على الرابط https://support.google.com/sa360/answer/9250611. |
conversionCustomMetrics[] |
المقاييس المخصّصة للإحالة الناجحة |
conversionsValueByConversionDate |
مجموع قيمة الإحالات الناجحة التي يمكن تقديم عروض أسعار لها حسب تاريخ الإحالة الناجحة. عند اختيار هذا العمود مع التاريخ، تشير القيم في عمود "التاريخ" إلى تاريخ الإحالة الناجحة. |
conversionsByConversionDate |
مجموع الإحالات الناجحة حسب تاريخ الإحالة الناجحة لأنواع الإحالات الناجحة التي يمكن تقديم عروض أسعار لها. يمكن أن يكون كسريًا بسبب إعداد نماذج تحديد المصدر. عند اختيار هذا العمود مع التاريخ، تشير القيم في عمود "التاريخ" إلى تاريخ الإحالة الناجحة. |
historicalCreativeQualityScore |
نقاط الجودة السابقة لتصميم الإعلان. |
historicalLandingPageQualityScore |
جودة تجربة الصفحة المقصودة للفترات السابقة |
historicalSearchPredictedCtr |
نسبة النقر إلى الظهور (CTR) السابقة المتوقعة في البحث. |
interactionEventTypes[] |
أنواع التفاعلات المدفوعة والمجانية. |
rawEventConversionMetrics[] |
مقاييس الإحالات الناجحة الأولية للأحداث. |
absoluteTopImpressionPercentage |
"نسبة ظهور الإعلان في صدارة الصفحة على شبكة البحث" هي النسبة المئوية لمرات ظهور إعلانك في أبرز موضع على "شبكة البحث". |
allConversionsFromInteractionsRate |
كل الإحالات الناجحة من التفاعلات (مقابل العرض من خلال الإحالات الناجحة) مقسومة على عدد التفاعلات مع الإعلانات. |
allConversionsValue |
قيمة كل الإحالات الناجحة. |
allConversions |
إجمالي عدد التحويلات. ويتضمّن هذا جميع الإحالات الناجحة بصرف النظر عن قيمة includeIn ConversionsMetric. |
allConversionsValuePerCost |
قيمة كل الإحالات الناجحة مقسومة على إجمالي تكلفة التفاعلات مع الإعلانات (مثل النقرات للإعلانات النصية أو مرّات المشاهدة لإعلانات الفيديو). |
allConversionsFromClickToCall |
عدد المرّات التي نقر فيها الأشخاص على زر "الاتصال" للاتصال بمتجر أثناء النقر على إعلان أو بعده. ولا يشمل هذا الرقم ما إذا كان قد تم إجراء المكالمات أم لا، أو مدة أي مكالمات. ينطبق هذا المقياس على العناصر في الخلاصة فقط. |
allConversionsFromDirections |
عدد المرّات التي نقر فيها الأشخاص على زر "الحصول على الاتجاهات" للانتقال إلى متجر بعد النقر على إعلان. ينطبق هذا المقياس على العناصر في الخلاصة فقط. |
allConversionsFromInteractionsValuePerInteraction |
قيمة كل الإحالات الناجحة من التفاعلات مقسومة على إجمالي عدد التفاعلات. |
allConversionsFromMenu |
عدد المرّات التي نقر فيها الأشخاص على رابط لعرض قائمة متجر بعد النقر على إعلان. ينطبق هذا المقياس على العناصر في الخلاصة فقط. |
allConversionsFromOrder |
عدد المرّات التي قدَّم فيها الأشخاص طلبًا في متجر بعد النقر على إعلان. ينطبق هذا المقياس على العناصر في الخلاصة فقط. |
allConversionsFromOtherEngagement |
عدد الإحالات الناجحة الأخرى (على سبيل المثال، نشر مراجعة أو حفظ موقع جغرافي لمتجر) التي حدثت بعد أن نقر الأشخاص على إعلان. ينطبق هذا المقياس على العناصر في الخلاصة فقط. |
allConversionsFromStoreVisit |
العدد المقدَّر للمرات التي زار فيها العملاء متجرًا بعد النقر على إعلان ينطبق هذا المقياس على العناصر في الخلاصة فقط. |
visits |
النقرات التي تم تسجيلها وإعادة توجيهها من خلال "إعلانات شبكة البحث 360" إلى الصفحة المقصودة للمعلِن بنجاح |
allConversionsFromStoreWebsite |
عدد المرّات التي تم فيها توجيه الأشخاص إلى عنوان URL لمتجر بعد النقر على إعلان. ينطبق هذا المقياس على العناصر في الخلاصة فقط. |
averageCost |
متوسط المبلغ الذي تدفعه لكل تفاعل. هذا المبلغ هو إجمالي تكلفة إعلاناتك مقسومًا على إجمالي عدد التفاعلات. |
averageCpc |
إجمالي تكلفة جميع النقرات مقسومًا على إجمالي عدد النقرات التي تم تلقّيها. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. يمكنك الاطّلاع على مَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
averageCpm |
متوسط التكلفة لكل ألف ظهور (CPM). هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. يمكنك الاطّلاع على مَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clicks |
عدد النقرات. |
contentBudgetLostImpressionShare |
النسبة المئوية المقدَّرة للمرات التي كان فيها إعلانك مؤهَّلاً للعرض على "الشبكة الإعلانية" ولكنه لم يُعرض لأن ميزانيتك كانت منخفضة جدًا. ملاحظة: يتم تسجيل نسبة ظهور الإعلان المفقودة لميزانية المحتوى في النطاق بين 0 و0.9. يتم تسجيل أي قيمة تزيد عن 0.9 على أنها 0.9001. |
contentImpressionShare |
عدد مرات الظهور التي تلقّيتها على الشبكة الإعلانية مقسومًا على العدد المقدَّر لمرات الظهور التي كنت مؤهَّلاً للحصول عليها. ملاحظة: يتم تسجيل نسبة ظهور الإعلان على شبكة المحتوى في النطاق من 0.1 إلى 1. يتم تسجيل أي قيمة أقل من 0.1 على أنها 0.0999. |
contentRankLostImpressionShare |
النسبة المئوية المقدَّرة لمرات الظهور على الشبكة الإعلانية التي لم تحصل عليها إعلاناتك بسبب ضعف ترتيب الإعلان. ملاحظة: يتم تسجيل نسبة ظهور الإعلان المفقودة لترتيب المحتوى في النطاق بين 0 و0.9. يتم تسجيل أي قيمة تزيد عن 0.9 على أنها 0.9001. |
conversionsFromInteractionsRate |
متوسط الإحالات الناجحة التي يمكن تقديم عروض أسعار لها (من التفاعل) لكل تفاعل مؤهَّل للإحالة الناجحة. يعرِض متوسط عدد المرات التي يؤدي فيها أحد التفاعلات مع الإعلان إلى إحالة ناجحة يمكن تحديد عروض أسعار لها. |
clientAccountConversionsValue |
قيمة الإحالات الناجحة لحساب العميل. ولا يشمل ذلك إلا إجراءات الإحالات الناجحة التي تم ضبط سمة includeInClientAccount ConversionsMetrics على "صحيح". وإذا كنت تستخدم عروض الأسعار المستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين هذه الإحالات الناجحة. |
conversionsValuePerCost |
قيمة الإحالة الناجحة التي يمكن تحديد عروض أسعار لها مقسومة على إجمالي تكلفة التفاعلات المؤهَّلة للإحالة الناجحة. |
conversionsFromInteractionsValuePerInteraction |
قيمة الإحالات الناجحة الناتجة من التفاعلات مقسومة على عدد التفاعلات مع الإعلانات. ولا يشمل ذلك سوى إجراءات الإحالات الناجحة التي تم ضبط السمة includeIn ConversionsMetric عليها على "صحيح". وإذا كنت تستخدم عروض الأسعار المستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين هذه الإحالات الناجحة. |
clientAccountConversions |
عدد الإحالات الناجحة لحساب العميل. ولا يشمل ذلك إلا إجراءات الإحالات الناجحة التي تم ضبط سمة includeInClientAccount ConversionsMetrics على "صحيح". وإذا كنت تستخدم عروض الأسعار المستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين هذه الإحالات الناجحة. |
costMicros |
مجموع تكلفة النقرة (CPC) والتكلفة لكل ألف ظهور (CPM) خلال هذه الفترة. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. يمكنك الاطّلاع على مَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
costPerAllConversions |
تكلفة التفاعلات مع الإعلان مقسومة على جميع الإحالات الناجحة. |
costPerConversion |
متوسط التكلفة المؤهَّلة للإحالة الناجحة لكل إحالة ناجحة يمكن تقديم عروض أسعار لها. |
costPerCurrentModelAttributedConversion |
تكلفة التفاعلات مع الإعلانات مقسومة على الإحالات الناجحة المنسوبة للنموذج الحالي. ولا يشمل ذلك سوى إجراءات الإحالات الناجحة التي تم ضبط السمة includeIn ConversionsMetric عليها على "صحيح". وإذا كنت تستخدم عروض الأسعار المستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين هذه الإحالات الناجحة. |
crossDeviceConversions |
الإحالات الناجحة التي يتم تسجيلها عندما ينقر العميل على إعلان في أحد الأجهزة، ثم يُجري إحالة ناجحة على جهاز أو متصفّح آخر. سبق أن تم تضمين الإحالات الناجحة باستخدام أكثر من جهاز واحد في جميع الإحالات الناجحة. |
crossDeviceConversionsValue |
مجموع قيمة الإحالات الناجحة باستخدام أكثر من جهاز واحد. |
ctr |
عدد النقرات التي يتلقاها إعلانك (النقرات) مقسومًا على عدد مرات عرض إعلانك (مرات الظهور). |
conversions |
عدد الإحالات الناجحة. ولا يشمل ذلك سوى إجراءات الإحالات الناجحة التي تم ضبط السمة includeIn ConversionsMetric عليها على "صحيح". وإذا كنت تستخدم عروض الأسعار المستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين هذه الإحالات الناجحة. |
conversionsValue |
مجموع قيم الإحالات الناجحة المُضمنة في حقل "الإحالات الناجحة". يُعد هذا المقياس مفيدًا فقط إذا أدخلت قيمة للإحالات الناجحة. |
historicalQualityScore |
نقاط الجودة السابقة. |
impressions |
عدد مرات ظهور إعلانك على صفحة نتائج البحث أو على موقع إلكتروني على شبكة Google. |
interactionRate |
عدد مرات تفاعل الأشخاص مع إعلانك بعد ظهوره لهم. هذا هو عدد التفاعلات مقسومًا على عدد مرات عرض إعلانك. |
interactions |
عدد التفاعلات. التفاعل هو الإجراء الأساسي الذي يتخذه المستخدم والمرتبط بالنقرات على شكل الإعلان للإعلانات النصية وإعلانات Shopping، ومرات مشاهدة إعلانات الفيديو، وما إلى ذلك. |
invalidClickRate |
النسبة المئوية للنقرات التي تمت تصفيتها من إجمالي عدد النقرات (النقرات التي تمت تصفيتها + النقرات التي لم تتم تصفيتها) خلال فترة إعداد التقرير. |
invalidClicks |
عدد النقرات التي تعتبرها Google غير قانونية ولا يتم تحصيل رسوم منك مقابلها. |
mobileFriendlyClicksPercentage |
النسبة المئوية لنقرات الجوّال التي تنقل إلى صفحة متوافقة مع الأجهزة الجوّالة. |
searchAbsoluteTopImpressionShare |
النسبة المئوية لمرّات ظهور إعلانات Shopping أو الإعلانات على شبكة البحث للعميل والتي تظهر في أبرز مواضع Shopping. يمكنك الانتقال إلى https://support.google.com/sa360/answer/9566729 لمعرفة التفاصيل. يتم تسجيل أي قيمة أقل من 0.1 على أنها 0.0999. |
searchBudgetLostAbsoluteTopImpressionShare |
العدد الذي يحتسب عدد المرات التي لم يكن فيها إعلانك أول إعلان بين أهم الإعلانات في نتائج البحث بسبب انخفاض الميزانية. ملاحظة: يتم تسجيل النسبة المطلقة المفقودة لظهور الإعلان في أعلى الصفحة ضمن ميزانية شبكة البحث في النطاق من 0 إلى 0.9. يتم تسجيل أي قيمة تزيد عن 0.9 على أنها 0.9001. |
searchBudgetLostImpressionShare |
النسبة المئوية المقدَّرة للمرات التي كان فيها إعلانك مؤهَّلاً للعرض على شبكة البحث، لكنه لم يُعرض لأن ميزانيتك كانت منخفضة جدًا. ملاحظة: يتم تسجيل نسبة ظهور الإعلان المفقودة ضمن ميزانية شبكة البحث في النطاق بين 0 و0.9. يتم تسجيل أي قيمة تزيد عن 0.9 على أنها 0.9001. |
searchBudgetLostTopImpressionShare |
العدد الذي يقدِّر عدد المرات التي لم يظهر فيها إعلانك بجوار أهم نتائج البحث المجاني بسبب انخفاض الميزانية. ملاحظة: يتم الإبلاغ عن نسبة ظهور الإعلان المفقودة في أعلى الصفحة ضمن ميزانية شبكة البحث في النطاق من 0 إلى 0.9. يتم تسجيل أي قيمة تزيد عن 0.9 على أنها 0.9001. |
searchClickShare |
عدد النقرات التي تلقّيتها على شبكة البحث مقسومًا على العدد المقدَّر للنقرات التي كنت مؤهَّلاً للحصول عليها. ملاحظة: يتم الإبلاغ عن نسبة النقر على الإعلان في نتائج البحث في النطاق من 0.1 إلى 1. يتم تسجيل أي قيمة أقل من 0.1 على أنها 0.0999. |
searchExactMatchImpressionShare |
عدد مرات الظهور التي تلقاها إعلانك مقسومًا على العدد المقدَّر لمرات الظهور التي كنت مؤهَّلاً للحصول عليها في شبكة البحث عن عبارات البحث التي تطابقت تمامًا مع كلماتك الرئيسية (أو كانت صيغًا قريبة من كلمتك الرئيسية)، بصرف النظر عن أنواع مطابقة كلماتك الرئيسية. ملاحظة: يتم تسجيل نسبة ظهور الإعلان المستندة إلى المطابقة التامة في شبكة البحث في النطاق من 0.1 إلى 1. يتم تسجيل أي قيمة أقل من 0.1 على أنها 0.0999. |
searchImpressionShare |
عدد مرات الظهور التي تلقّيتها على شبكة البحث مقسومًا على العدد المقدَّر لمرات الظهور التي كنت مؤهَّلاً للحصول عليها. ملاحظة: يتم تسجيل نسبة ظهور الإعلان في شبكة البحث في النطاق من 0.1 إلى 1. يتم تسجيل أي قيمة أقل من 0.1 على أنها 0.0999. |
searchRankLostAbsoluteTopImpressionShare |
العدد الذي يحتسب عدد المرات التي لم يكن فيها إعلانك أول إعلان بين أعلى الإعلانات في نتائج البحث بسبب ضعف ترتيب الإعلان. ملاحظة: يتم تسجيل النسبة المطلقة المفقودة لظهور الإعلان في أعلى الصفحة في الترتيب على شبكة البحث في النطاق من 0 إلى 0.9. يتم تسجيل أي قيمة تزيد عن 0.9 على أنها 0.9001. |
searchRankLostImpressionShare |
النسبة المئوية المقدَّرة لمرات الظهور على شبكة البحث التي لم تحصل عليها إعلاناتك بسبب ضعف ترتيب الإعلان. ملاحظة: يتم الإبلاغ عن نسبة ظهور الإعلان المفقودة ذات الترتيب في شبكة البحث في النطاق الذي يتراوح بين 0 و0.9. يتم تسجيل أي قيمة تزيد عن 0.9 على أنها 0.9001. |
searchRankLostTopImpressionShare |
العدد الذي يقدِّر عدد المرات التي لم يظهر فيها إعلانك بجوار أعلى نتائج البحث المجاني بسبب انخفاض ترتيب الإعلان. ملاحظة: يتم الإبلاغ عن نسبة عدم ظهور الإعلان في أعلى الصفحة لترتيب شبكة البحث في النطاق بين 0 و0.9. يتم تسجيل أي قيمة تزيد عن 0.9 على أنها 0.9001. |
searchTopImpressionShare |
مرات الظهور التي تلقّيتها بين أهم الإعلانات مقارنةً بالعدد المقدَّر لمرات الظهور التي كنت مؤهَّلاً للحصول عليها من بين أهم الإعلانات. ملاحظة: يتم الإبلاغ عن نسبة ظهور الإعلان في أعلى الصفحة في شبكة البحث في النطاق من 0.1 إلى 1. يتم تسجيل أي قيمة أقل من 0.1 على أنها 0.0999. بشكل عام، تظهر الإعلانات في أعلى الصفحة فوق أهم نتائج البحث المجاني. ومع ذلك، قد تظهر هذه الإعلانات أسفل أهم نتائج البحث المجاني في طلبات بحث معيّنة. |
topImpressionPercentage |
النسبة المئوية لمرات ظهور إعلانك التي تظهر بجانب أهم نتائج البحث المجاني. |
valuePerAllConversions |
قيمة كل الإحالات الناجحة مقسومة على عدد كل الإحالات الناجحة. |
valuePerAllConversionsByConversionDate |
قيمة كل الإحالات الناجحة مقسومة على عدد كل الإحالات الناجحة. عند اختيار هذا العمود مع التاريخ، تشير القيم في عمود "التاريخ" إلى تاريخ الإحالة الناجحة. تتوفّر تفاصيل أعمدة by_conversion_date على الرابط https://support.google.com/sa360/answer/9250611. |
valuePerConversion |
قيمة الإحالة الناجحة التي يمكن تقديم عروض أسعار لها مقسومة على عدد الإحالات الناجحة التي يمكن تقديم عروض أسعار لها. تعرِض هذه السمة قيمة كلّ إحالة ناجحة يمكن تقديم عروض أسعار لها في المتوسّط. |
valuePerConversionsByConversionDate |
قيمة الإحالات الناجحة التي يمكن تحديد عروض أسعار لها حسب تاريخ الإحالة الناجحة مقسومة على الإحالات الناجحة التي يمكن تحديد عروض أسعار لها على تاريخ الإحالة الناجحة. تعرِض هذه السمة متوسط قيمة كل إحالة من الإحالات الناجحة التي يمكن تقديم عروض أسعار لها (حسب تاريخ الإحالة الناجحة). عند اختيار هذا العمود مع التاريخ، تشير القيم في عمود "التاريخ" إلى تاريخ الإحالة الناجحة. |
clientAccountViewThroughConversions |
إجمالي عدد الإحالات الناجحة بعد رؤية الإعلان فقط. وتحدث هذه المشكلة عندما يرى العميل إعلانًا مصوّرًا أو إعلان الوسائط الغنية، ثم يكمل في وقت لاحق إحالة ناجحة على موقعك الإلكتروني بدون التفاعل مع إعلان آخر (مثلاً، النقر على). |
clientAccountCrossSellCostOfGoodsSoldMicros |
تكلفة السلع المُباعة من خلال بيع منتجات إضافية لحساب العميل هي إجمالي تكلفة المنتجات المُباعة نتيجة للإعلان عن منتج مختلف. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. وتكلفة السلع المُباعة من خلال بيع منتجات إضافية هي إجمالي تكلفة المنتجات التي تم بيعها بدون الإعلان عنها. مثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة التكلفة نفسها للقميص 5 دولار أمريكي. بناءً على ما سبق، تبلغ تكلفة السلع المُباعة من خلال بيع منتجات إضافية لهذا الطلب 5 دولار أمريكي. ولا يتوفّر هذا المقياس إلّا في حال الإبلاغ عن الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. يمكنك الاطّلاع على مَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
crossSellCostOfGoodsSoldMicros |
تكلفة السلع المُباعة من خلال بيع منتجات إضافية (COGS) هي إجمالي تكلفة المنتجات التي تم بيعها نتيجةً لإعلان عن منتج مختلف. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. وتكلفة السلع المُباعة من خلال بيع منتجات إضافية هي إجمالي تكلفة المنتجات التي تم بيعها بدون الإعلان عنها. مثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة التكلفة نفسها للقميص 5 دولار أمريكي. بناءً على ما سبق، تبلغ تكلفة السلع المُباعة من خلال بيع منتجات إضافية لهذا الطلب 5 دولار أمريكي. ولا يتوفّر هذا المقياس إلّا في حال الإبلاغ عن الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. يمكنك الاطّلاع على مَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clientAccountCrossSellGrossProfitMicros |
الأرباح الإجمالية من بيع منتجات إضافية لحساب العميل هي الأرباح التي تحقّقها من المنتجات المُباعة نتيجة للإعلان عن منتج مختلف، بعد طرح تكلفة السلع المُباعة منها. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في عملية الشراء هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الأرباح الإجمالية من بيع منتجات إضافية هي الأرباح التي تحقّقها من خلال بيع منتجات إضافية يعود مصدرها إلى إعلاناتك بعد طرح تكلفة السلع المُباعة منها. مثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القميص $20، وله قيمة تكلفة سلع مُباعة تبلغ $5. تبلغ الأرباح الإجمالية من بيع منتجات إضافية لهذا الطلب $15 = $20 - $5. ولا يتوفّر هذا المقياس إلّا في حال الإبلاغ عن الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. يمكنك الاطّلاع على مَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
crossSellGrossProfitMicros |
الأرباح الإجمالية من بيع منتجات إضافية هي الأرباح التي حقّقتها من المنتجات المُباعة نتيجة للإعلان عن منتج مختلف، بعد طرح تكلفة السلع المُباعة منها. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في عملية الشراء هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الأرباح الإجمالية من بيع منتجات إضافية هي الأرباح التي تحقّقها من خلال بيع منتجات إضافية يعود مصدرها إلى إعلاناتك بعد طرح تكلفة السلع المُباعة منها. مثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القميص $20، وله قيمة تكلفة سلع مُباعة تبلغ $5. تبلغ الأرباح الإجمالية من بيع منتجات إضافية لهذا الطلب $15 = $20 - $5. ولا يتوفّر هذا المقياس إلّا في حال الإبلاغ عن الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. يمكنك الاطّلاع على مَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clientAccountCrossSellRevenueMicros |
الأرباح من بيع منتجات إضافية لحساب العميل هي إجمالي المبلغ الذي تحقّقه من المنتجات المُباعة نتيجة للإعلان عن منتج آخر. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الأرباح من بيع المنتجات الإضافية هي القيمة الإجمالية التي حقّقتها من خلال بيع منتجات إضافية يعود مصدرها إلى إعلاناتك. مثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ الأرباح من بيع منتجات إضافية لهذا الطلب 20 دولار أمريكي. ولا يتوفّر هذا المقياس إلّا في حال الإبلاغ عن الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. يمكنك الاطّلاع على مَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
crossSellRevenueMicros |
الأرباح من بيع المنتجات الإضافية هي إجمالي المبلغ الذي تحقّقه من المنتجات المُباعة نتيجة للإعلان عن منتج آخر. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الأرباح من بيع المنتجات الإضافية هي القيمة الإجمالية التي حقّقتها من خلال بيع منتجات إضافية يعود مصدرها إلى إعلاناتك. مثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ الأرباح من بيع منتجات إضافية لهذا الطلب 20 دولار أمريكي. ولا يتوفّر هذا المقياس إلّا في حال الإبلاغ عن الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. يمكنك الاطّلاع على مَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clientAccountCrossSellUnitsSold |
الوحدات المُباعة من خلال بيع منتجات إضافية لحساب العميل هي إجمالي عدد المنتجات التي يتمّ بيعها نتيجة الإعلان عن منتج آخر. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الوحدات المُباعة من خلال بيع منتجات إضافية هي إجمالي عدد المنتجات الإضافية التي تمّ بيعها من خلال جميع الطلبات التي يعود مصدرها إلى إعلاناتك. مثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا وسُترة. عدد الوحدات المُباعة من خلال بيع منتجات إضافية في هذا الطلب هو وحدتان. ولا يتوفّر هذا المقياس إلّا في حال الإبلاغ عن الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق. |
crossSellUnitsSold |
الوحدات المُباعة من خلال بيع منتجات إضافية هي إجمالي عدد المنتجات التي يتمّ بيعها نتيجة الإعلان عن منتج آخر. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الوحدات المُباعة من خلال بيع منتجات إضافية هي إجمالي عدد المنتجات الإضافية التي تمّ بيعها من خلال جميع الطلبات التي يعود مصدرها إلى إعلاناتك. مثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا وسُترة. عدد الوحدات المُباعة من خلال بيع منتجات إضافية في هذا الطلب هو وحدتان. ولا يتوفّر هذا المقياس إلّا في حال الإبلاغ عن الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق. |
clientAccountLeadCostOfGoodsSoldMicros |
تكلفة السلع المُباعة للعملاء المحتملِين في حساب العميل هي إجمالي تكلفة المنتجات المُباعة نتيجة للإعلان عن المنتج نفسه. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمُباعة، يتمّ احتساب تكلفة هذه السلع ضمن تكلفة السلع المُباعة للعملاء المحتملِين. مثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة التكلفة نفسها للقميص 5 دولار أمريكي. تبلغ تكلفة السلع المُباعة للعملاء المحتملِين لهذا الطلب 3 دولار أمريكي. ولا يتوفّر هذا المقياس إلّا في حال الإبلاغ عن الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. يمكنك الاطّلاع على مَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
leadCostOfGoodsSoldMicros |
تكلفة السلع المُباعة للعملاء المحتملِين هي إجمالي تكلفة المنتجات المُباعة نتيجة للإعلان عن المنتج نفسه. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمُباعة، يتمّ احتساب تكلفة هذه السلع ضمن تكلفة السلع المُباعة للعملاء المحتملِين. مثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة التكلفة نفسها للقميص 5 دولار أمريكي. تبلغ تكلفة السلع المُباعة للعملاء المحتملِين لهذا الطلب 3 دولار أمريكي. ولا يتوفّر هذا المقياس إلّا في حال الإبلاغ عن الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. يمكنك الاطّلاع على مَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clientAccountLeadGrossProfitMicros |
الأرباح الإجمالية من العملاء المحتملِين لحساب العميل هي الأرباح التي حقّقتها من المنتجات المُباعة نتيجة للإعلان عن المنتج نفسه، بعد طرح تكلفة السلع المُباعة منها. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت كلٌّ من المنتجات المعلَن عنها والمنتجات المُباعة، تكون الأرباح التي تحقّقها من هذه المبيعات بعد طرح تكلفة السلع المُباعة منها هي الأرباح الإجمالية من العملاء المحتملِين. مثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ولها قيمة تكلفة سلع مُباعة تبلغ 3 دولار أمريكي. ستكون الأرباح الإجمالية من العملاء المحتملِين لهذا الطلب هي 7 دولار أمريكي = 10 دولار أمريكي - 3 دولار أمريكي. ولا يتوفّر هذا المقياس إلّا في حال الإبلاغ عن الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. يمكنك الاطّلاع على مَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
leadGrossProfitMicros |
الأرباح الإجمالية من العملاء المحتملِين هي الأرباح التي حققتها من المنتجات المُباعة نتيجة للإعلان عن المنتج نفسه، بعد طرح تكلفة السلع المُباعة منها. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت كلٌّ من المنتجات المعلَن عنها والمنتجات المُباعة، تكون الأرباح التي تحقّقها من هذه المبيعات بعد طرح تكلفة السلع المُباعة منها هي الأرباح الإجمالية من العملاء المحتملِين. مثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ولها قيمة تكلفة سلع مُباعة تبلغ 3 دولار أمريكي. ستكون الأرباح الإجمالية من العملاء المحتملِين لهذا الطلب هي 7 دولار أمريكي = 10 دولار أمريكي - 3 دولار أمريكي. ولا يتوفّر هذا المقياس إلّا في حال الإبلاغ عن الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. يمكنك الاطّلاع على مَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clientAccountLeadRevenueMicros |
الأرباح من العملاء المحتملِين لحساب العميل هي إجمالي المبلغ الذي تحقّقه من المنتجات المُباعة نتيجة للإعلان عن المنتج نفسه. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمُباعة، يتمّ عرض القيمة الإجمالية التي حقّقتها من مبيعات هذه المنتجات ضمن الأرباح من العملاء المحتملِين. مثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ الأرباح من العملاء المحتملِين لهذا الطلب 10 دولار أمريكي. ولا يتوفّر هذا المقياس إلّا في حال الإبلاغ عن الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. يمكنك الاطّلاع على مَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
leadRevenueMicros |
الأرباح من العملاء المحتملِين هي إجمالي المبلغ الذي حقّقته من منتجات تمّ بيعها نتيجة الإعلان عن المنتج نفسه. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمُباعة، يتمّ عرض القيمة الإجمالية التي حقّقتها من مبيعات هذه المنتجات ضمن الأرباح من العملاء المحتملِين. مثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ الأرباح من العملاء المحتملِين لهذا الطلب 10 دولار أمريكي. ولا يتوفّر هذا المقياس إلّا في حال الإبلاغ عن الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. يمكنك الاطّلاع على مَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clientAccountLeadUnitsSold |
الوحدات المُباعة للعملاء المحتملِين في حساب العميل هي إجمالي عدد المنتجات التي يتمّ بيعها نتيجة الإعلان عن المنتج نفسه. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمنتجات المُباعة، يظهر إجمالي عدد هذه المنتجات المُباعة ضمن "الوحدات المُباعة للعملاء المحتملِين". مثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا وسُترة. الوحدات المُباعة للعملاء المحتملِين في هذا الطلب هي 1. ولا يتوفّر هذا المقياس إلّا في حال الإبلاغ عن الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق. |
leadUnitsSold |
الوحدات المُباعة للعملاء المحتملِين هي إجمالي عدد المنتجات التي يتمّ بيعها نتيجة للإعلان عن المنتج نفسه. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمنتجات المُباعة، يظهر إجمالي عدد هذه المنتجات المُباعة ضمن "الوحدات المُباعة للعملاء المحتملِين". مثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا وسُترة. الوحدات المُباعة للعملاء المحتملِين في هذا الطلب هي 1. ولا يتوفّر هذا المقياس إلّا في حال الإبلاغ عن الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق. |
القيمة
حاوية بيانات عامة
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد value القيمة. يمكن أن يكون الحقل "value " واحدًا فقط مما يلي: |
|
booleanValue |
قيمة منطقية. |
int64Value |
Int64. |
floatValue |
عدد عشري. |
doubleValue |
مزدوج. |
stringValue |
سلسلة. |
QualityScoreBucket
يشير هذا المقياس إلى عدد التعداد الذي يدرج مجموعات بيانات نقاط الجودة المحتملة.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
BELOW_AVERAGE |
جودة تصميم الإعلان أقل من المتوسط. |
AVERAGE |
جودة تصميم الإعلان متوسطة. |
ABOVE_AVERAGE |
جودة تصميم الإعلان أعلى من المتوسط. |
InteractionEventType
يشير التعداد إلى الأنواع المحتملة للتفاعلات المدفوعة والمجانية.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
CLICK |
انقر للانتقال إلى الموقع الإلكتروني. وفي معظم الحالات، ينتقل هذا التفاعل إلى موقع جغرافي خارجي، وعادةً ما يكون الصفحة المقصودة للمعلِن. وهذا هو أيضًا InteractionEventType التلقائي لأحداث النقر. |
ENGAGEMENT |
نيّة المستخدم الواضحة في التفاعل مع الإعلان في موضعه |
VIDEO_VIEW |
شاهد المستخدم إعلان فيديو. |
NONE |
القيمة التلقائية InteractionEventType لأحداث الإحالات الناجحة للإعلانات. تُستخدَم هذه الطريقة عندما لا يشير صف الإحالة الناجحة للإعلانات إلى أنّ التفاعلات المجانية (مثل الإحالات الناجحة للإعلانات) يجب "الترويج" لها والإبلاغ عنها كجزء من المقاييس الأساسية. هذه ببساطة إحالات ناجحة أخرى (إعلان). |
الشرائح
الحقول الخاصة بالشرائح فقط
تمثيل JSON |
---|
{ "adNetworkType": enum ( |
الحقول | |
---|---|
adNetworkType |
نوع شبكة الإعلانات |
conversionActionCategory |
فئة إجراء الإحالة الناجحة |
conversionCustomDimensions[] |
السمات المخصّصة للإحالة الناجحة. |
dayOfWeek |
يوم من الأسبوع، على سبيل المثال، الاثنين. |
device |
الجهاز الذي تنطبق عليه المقاييس. |
keyword |
معيار الكلمة الرئيسية. |
productChannel |
قناة المنتج |
productChannelExclusivity |
حصرية قناة المنتج |
productCondition |
حالة المنتج. |
productSoldCondition |
حالة المنتج المُباعة. |
rawEventConversionDimensions[] |
أبعاد الإحالة الناجحة للأحداث الأولية. |
conversionAction |
اسم مورد إجراء الإحالة الناجحة. |
conversionActionName |
اسم إجراء الإحالة الناجحة |
date |
التاريخ الذي تنطبق عليه المقاييس. تنسيق yyyy-MM-dd، على سبيل المثال، 2018-04-17. |
month |
الشهر كما هو موضح بتاريخ أول يوم من الشهر. وقد تم التنسيق كـ yyyy-MM-dd. |
productBiddingCategoryLevel1 |
فئة عروض الأسعار (المستوى 1) للمنتج. |
productBiddingCategoryLevel2 |
فئة عروض الأسعار (المستوى 2) للمنتج. |
productBiddingCategoryLevel3 |
فئة عروض الأسعار (المستوى 3) للمنتج. |
productBiddingCategoryLevel4 |
فئة عروض الأسعار (المستوى 4) للمنتج. |
productBiddingCategoryLevel5 |
فئة عروض الأسعار (المستوى 5) للمنتج. |
productBrand |
العلامة التجارية للمنتج |
productCountry |
اسم المورد ثابت الاستهداف الجغرافي لبلد بيع المنتج |
productCustomAttribute0 |
السمة المخصّصة 0 للمنتج. |
productCustomAttribute1 |
السمة المخصّصة 1 للمنتج |
productCustomAttribute2 |
السمة المخصّصة 2 للمنتج |
productCustomAttribute3 |
السمة المخصّصة 3 للمنتج |
productCustomAttribute4 |
السمة المخصّصة 4 للمنتج. |
productItemId |
معرّف سلعة المنتج. |
productLanguage |
تمثّل هذه السمة اسم المورد الثابت اللغوي للغة المنتج. |
productSoldBiddingCategoryLevel1 |
فئة عرض الأسعار (المستوى 1) للمنتج المُباعة. |
productSoldBiddingCategoryLevel2 |
فئة عرض الأسعار (المستوى 2) للمنتج المُباعة. |
productSoldBiddingCategoryLevel3 |
فئة عرض الأسعار (المستوى 3) للمنتج المُباعة. |
productSoldBiddingCategoryLevel4 |
فئة عرض الأسعار (المستوى 4) للمنتج المُباعة. |
productSoldBiddingCategoryLevel5 |
فئة عرض الأسعار (المستوى 5) للمنتج المُباعة. |
productSoldBrand |
العلامة التجارية للمنتج المباع. |
productSoldCustomAttribute0 |
السمة المخصّصة 0 للمنتج المُباعة. |
productSoldCustomAttribute1 |
السمة المخصّصة 1 للمنتج المُباعة. |
productSoldCustomAttribute2 |
السمة المخصّصة 2 للمنتج المُباعة. |
productSoldCustomAttribute3 |
السمة المخصّصة 3 للمنتج المُباعة. |
productSoldCustomAttribute4 |
السمة المخصّصة 4 للمنتج المُباعة. |
productSoldItemId |
معرّف سلعة المنتج المُباعة. |
productSoldTitle |
عنوان المنتج المباع. |
productSoldTypeL1 |
نوع (المستوى 1) للمنتج المُباع. |
productSoldTypeL2 |
نوع المنتج المُباع (المستوى 2). |
productSoldTypeL3 |
نوع المنتج المُباع (المستوى 3). |
productSoldTypeL4 |
نوع (المستوى 4) للمنتج المُباع. |
productSoldTypeL5 |
نوع (المستوى 5) للمنتج المُباع. |
productStoreId |
رقم تعريف متجر المنتج |
productTitle |
عنوان المنتج. |
productTypeL1 |
نوع المنتج (المستوى 1) |
productTypeL2 |
نوع المنتج (المستوى 2) |
productTypeL3 |
نوع المنتج (المستوى 3) |
productTypeL4 |
نوع المنتج (المستوى 4) |
productTypeL5 |
نوع المنتج (المستوى 5) |
quarter |
ربع السنة كما هو ممثّل بتاريخ أول يوم من ربع السنة. لاستخدام السنة التقويمية للأرباع، على سبيل المثال، يبدأ الربع الثاني من 2018 في 1-04-2018. وقد تم التنسيق كـ yyyy-MM-dd. |
week |
الأسبوع كما هو محدّد من الاثنين إلى الأحد، ويُشار إليه بتاريخ الاثنين. وقد تم التنسيق كـ yyyy-MM-dd. |
year |
السنة، بالتنسيق yyyy. |
assetInteractionTarget |
لا تُستخدم إلّا مع مقاييس CustomerAsset وCampaignAsset وGroupAsset. يشير إلى ما إذا كانت مقاييس التفاعل حدثت في مادة العرض نفسها أو في مادة عرض أو وحدة إعلانية مختلفة. ويتم احتساب التفاعلات (مثل النقرات) على مستوى جميع أجزاء الإعلان المعروض (مثل الإعلان نفسه ومكوّنات أخرى مثل روابط أقسام الموقع) عند عرضها معًا. عندما تكون قيمةInteractOnThisAsset صحيحة، يعني ذلك أنّ التفاعلات على مادة العرض المحدّدة هذه، وعندما تكون التفاعلاتOnThisAsset غير صحيحة، هذا يعني أنّ التفاعلات لا تظهر على مادة العرض المحددة هذه، بل على أجزاء أخرى من الإعلان المعروض. |
AdNetworkType
لتعداد أنواع شبكات "إعلانات Google".
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
القيمة غير معروفة في هذا الإصدار. |
SEARCH |
بحث Google. |
SEARCH_PARTNERS |
شركاء البحث. |
CONTENT |
للشبكة الإعلانية. |
YOUTUBE_SEARCH |
بحث YouTube: |
YOUTUBE_WATCH |
فيديوهات YouTube |
MIXED |
الشبكة المتقاطعة. |
كلمة رئيسية
شريحة معيار الكلمة الرئيسية.
تمثيل JSON |
---|
{
"info": {
object ( |
الحقول | |
---|---|
info |
معلومات الكلمة الرئيسية. |
adGroupCriterion |
اسم مورد معيار المجموعة الإعلانية |
ProductChannelExclusivity
يشير هذا الحقل إلى رقم يشير إلى مدى توفّر عرض منتج.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
SINGLE_CHANNEL |
يتم بيع السلعة من خلال قناة واحدة فقط، إمّا في المتاجر المحلية أو على الإنترنت كما هو موضّح في ProductChannel. |
MULTI_CHANNEL |
تتم مطابقة السلعة مع نظيرتها في المتاجر المحلية أو على الإنترنت، ما يشير إلى أنّها متاحة للشراء في كلٍّ من ShoppingProductChannels. |
ProductCondition
يشير هذا المقياس إلى قيم التعداد التي تصف حالة عرض المنتج.
عمليات التعداد | |
---|---|
UNSPECIFIED |
عدم تحديد صيغة مخاطبة |
UNKNOWN |
تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
OLD |
حالة المنتج قديمة. |
NEW |
أن تكون حالة المنتج جديدة. |
REFURBISHED |
حالة المنتج مجدَّد. |
USED |
يتم استخدام حالة المنتج. |
AssetInteractionTarget
شريحة AssetInteractionTarget.
تمثيل JSON |
---|
{ "asset": string, "interactionOnThisAsset": boolean } |
الحقول | |
---|---|
asset |
اسم مورد مادة العرض. |
interactionOnThisAsset |
لا تُستخدم إلّا مع مقاييس CustomerAsset وCampaignAsset وGroupAsset. يشير إلى ما إذا كانت مقاييس التفاعل حدثت في مادة العرض نفسها أو في مادة عرض أو وحدة إعلانية مختلفة. |