SearchAds360Row

تم عرض صف من الاستعلام.

تمثيل JSON 
{
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdEffectiveLabel": {
    object (AdGroupAdEffectiveLabel)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionEffectiveLabel": {
    object (AdGroupCriterionEffectiveLabel)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupEffectiveLabel": {
    object (AdGroupEffectiveLabel)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "asset": {
    object (Asset)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupTopCombinationView": {
    object (AssetGroupTopCombinationView)
  },
  "assetGroup": {
    object (AssetGroup)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignEffectiveLabel": {
    object (CampaignEffectiveLabel)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "cartDataSalesView": {
    object (CartDataSalesView)
  },
  "audience": {
    object (Audience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerAssetSet": {
    object (CustomerAssetSet)
  },
  "accessibleBiddingStrategy": {
    object (AccessibleBiddingStrategy)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "keywordView": {
    object (KeywordView)
  },
  "label": {
    object (Label)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "userList": {
    object (UserList)
  },
  "userLocationView": {
    object (UserLocationView)
  },
  "webpageView": {
    object (WebpageView)
  },
  "visit": {
    object (Visit)
  },
  "conversion": {
    object (Conversion)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  },
  "customColumns": [
    {
      object (Value)
    }
  ]
}
الحقول
adGroup

object (AdGroup)

المجموعة الإعلانية المُشار إليها في الطلب
adGroupAd

object (AdGroupAd)

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

object (AdGroupAdEffectiveLabel)

التصنيف الفعال للإعلان في المجموعة الإعلانية المُشار إليه في الطلب
adGroupAdLabel

object (AdGroupAdLabel)

تصنيف الإعلان للمجموعة الإعلانية المُشار إليه في طلب البحث
adGroupAsset

object (AdGroupAsset)

مادة عرض المجموعة الإعلانية المُشار إليها في الطلب
adGroupAssetSet

object (AdGroupAssetSet)

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

object (AdGroupAudienceView)

عرض جمهور المجموعة الإعلانية المُشار إليه في الطلب
adGroupBidModifier

object (AdGroupBidModifier)

مُعدِّل عروض الأسعار المُشار إليه في طلب البحث.
adGroupCriterion

object (AdGroupCriterion)

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

object (AdGroupCriterionEffectiveLabel)

التصنيف الفعال لمعيار المجموعة الإعلانية المُشار إليه في الطلب
adGroupCriterionLabel

object (AdGroupCriterionLabel)

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

object (AdGroupEffectiveLabel)

التصنيف الفعال للمجموعة الإعلانية المُشار إليه في الطلب
adGroupLabel

object (AdGroupLabel)

تصنيف المجموعة الإعلانية المُشار إليه في طلب البحث
ageRangeView

object (AgeRangeView)

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

object (Asset)

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

object (AssetGroupAsset)

مادة عرض مجموعة مواد العرض المُشار إليها في الطلب
assetGroupSignal

object (AssetGroupSignal)

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

object (AssetGroupListingGroupFilter)

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

object (AssetGroupTopCombinationView)

عرض أفضل تركيبة لمجموعة مواد العرض المُشار إليها في طلب البحث.
assetGroup

object (AssetGroup)

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

object (AssetSetAsset)

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

object (AssetSet)

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

object (BiddingStrategy)

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

object (CampaignBudget)

ميزانية الحملة المُشار إليها في طلب البحث.
campaign

object (Campaign)

الحملة المُشار إليها في طلب البحث
campaignAsset

object (CampaignAsset)

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

object (CampaignAssetSet)

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

object (CampaignAudienceView)

عرض جمهور الحملة المُشار إليه في طلب البحث
campaignCriterion

object (CampaignCriterion)

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

object (CampaignEffectiveLabel)

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

object (CampaignLabel)

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

object (CartDataSalesView)

طريقة العرض الخاصة بمبيعات بيانات سلة التسوّق المُشار إليها في طلب البحث
audience

object (Audience)

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

object (ConversionAction)

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

object (ConversionCustomVariable)

المتغيّر المخصّص للإحالة الناجحة المُشار إليه في الطلب
customer

object (Customer)

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

object (CustomerAsset)

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

object (CustomerAssetSet)

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

object (AccessibleBiddingStrategy)

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

object (CustomerClient)

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

object (DynamicSearchAdsSearchTermView)

طريقة عرض عبارات البحث للإعلانات الديناميكية على شبكة البحث المُشار إليها في الطلب
genderView

object (GenderView)

عرض الجنس المُشار إليه في طلب البحث
geoTargetConstant

object (GeoTargetConstant)

الثابت الخاص بالاستهداف الجغرافي المُشار إليه في الطلب
keywordView

object (KeywordView)

عرض الكلمات الرئيسية المُشار إليه في طلب البحث.
label

object (Label)

التصنيف المُشار إليه في طلب البحث
languageConstant

object (LanguageConstant)

الثابت الخاص باللغة المُشار إليه في طلب البحث
locationView

object (LocationView)

عرض الموقع الجغرافي المُشار إليه في طلب البحث
productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

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

object (ProductGroupView)

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

object (ShoppingPerformanceView)

عرض أداء التسوّق المُشار إليه في طلب البحث
userList

object (UserList)

قائمة المستخدمين المُشار إليها في طلب البحث
userLocationView

object (UserLocationView)

طريقة عرض الموقع الجغرافي للمستخدِم المُشار إليها في طلب البحث.
webpageView

object (WebpageView)

عرض صفحة الويب المُشار إليه في طلب البحث
visit

object (Visit)

الزيارة على مستوى الحدث المُشار إليها في طلب البحث.
conversion

object (Conversion)

الإحالة الناجحة على مستوى الحدث المُشار إليها في طلب البحث
metrics

object (Metrics)

المقاييس.
segments

object (Segments)

الشرائح
customColumns[]

object (Value)

الأعمدة المخصّصة

المجموعة الإعلانية

مجموعة إعلانية

تمثيل JSON 
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus)
}
الحقول
resourceName

string

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

customers/{customerId}/adGroups/{ad_group_id}
status

enum (AdGroupStatus)

حالة المجموعة الإعلانية.
type

enum (AdGroupType)

نوع المجموعة الإعلانية.
adRotationMode

enum (AdGroupAdRotationMode)

وضع عرض الإعلانات بالتناوب للمجموعة الإعلانية.
creationTime

string

الطابع الزمني لوقت إنشاء هذه المجموعة الإعلانية. يكون الطابع الزمني بالتنسيق yyyy-MM-dd HH:mm:ss وحسب المنطقة الزمنية للعميل.
targetingSetting

object (TargetingSetting)

إعدادات الميزات ذات الصلة بالاستهداف
labels[]

string

أسماء موارد التصنيفات المرفقة بهذه المجموعة الإعلانية.
effectiveLabels[]

string

أسماء مصادر التصنيفات الفعّالة المرتبطة بهذه المجموعة الإعلانية التصنيف الفعّال هو تصنيف مكتسَب أو تمّ تعيينه مباشرةً لهذه المجموعة الإعلانية.
engineId

string

رقم تعريف المجموعة الإعلانية في حساب المحرّك الخارجي. هذا الحقل مخصّص للحسابات غير التابعة لخدمة "إعلانات Google" فقط، مثل Yahoo Japan وMicrosoft وBaidu وما إلى ذلك. بالنسبة إلى الكيانات في "إعلانات Google"، استخدِم "adGroup.id" بدلاً من ذلك.
startDate

string

تاريخ بدء عرض الإعلانات في هذه المجموعة الإعلانية. تبدأ المجموعة الإعلانية تلقائيًا الآن أو في تاريخ بدء المجموعة الإعلانية، أيهما لاحق. إذا تم ضبط هذا الحقل، تبدأ المجموعة الإعلانية من بداية التاريخ المحدّد في المنطقة الزمنية للعميل. لا يتوفّر هذا الحقل إلا لحسابات بوابة Microsoft Advertising وFacebook.

التنسيق: YYYY-MM-DD مثال: 14-03-2019
endDate

string

التاريخ الذي تنتهي فيه المجموعة الإعلانية من عرض الإعلانات. بشكل تلقائي، تنتهي المجموعة الإعلانية في تاريخ انتهاء المجموعة الإعلانية. إذا تم ضبط هذا الحقل، تنتهي المجموعة الإعلانية في نهاية التاريخ المحدّد في المنطقة الزمنية للعميل. لا يتوفّر هذا الحقل إلا لحسابات بوابة Microsoft Advertising وFacebook.

التنسيق: YYYY-MM-DD، مثال: ‎2019-03-14
languageCode

string

لغة الإعلانات والكلمات الرئيسية في مجموعة إعلانية لا يتوفّر هذا الحقل إلّا لحسابات Microsoft Advertising. مزيد من التفاصيل: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage
lastModifiedTime

string

التاريخ والوقت الذي تم فيه إجراء آخر تعديل على هذه المجموعة الإعلانية. يتم عرض التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss.ssssss".
id

string (int64 format)

رقم تعريف المجموعة الإعلانية.
name

string

اسم المجموعة

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

يجب أن يحتوي النص على أقل من 255 حرفًا بالعرض الكامل لترميز UTF-8.

يجب ألا يحتوي على أي أحرف فارغة (قيمة موضع الرمز 0x0) أو فواصل أسطر (قيمة موضع الرمز 0xA) أو علامات رجوع إلى أول السطر (قيمة موضع الرمز 0xD).
cpcBidMicros

string (int64 format)

عرض السعر الأقصى للنقرة.
engineStatus

enum (AdGroupEngineStatus)

حالة محرّك البحث للمجموعة الإعلانية.

AdGroupStatus

الحالات المحتملة للمجموعة الإعلانية.

عمليات التعداد
UNSPECIFIED لم يتم تحديد الحالة.
UNKNOWN

القيمة المُستلَمة غير معروفة في هذا الإصدار.

هذه قيمة للردّ فقط.
ENABLED تمّ تفعيل المجموعة الإعلانية.
PAUSED تم إيقاف المجموعة الإعلانية مؤقتًا.
REMOVED تمت إزالة المجموعة الإعلانية.

AdGroupType

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

عمليات التعداد
UNSPECIFIED لم يتم تحديد النوع.
UNKNOWN

القيمة المُستلَمة غير معروفة في هذا الإصدار.

هذه قيمة للردّ فقط.
SEARCH_STANDARD النوع التلقائي للمجموعة الإعلانية في "الحملات على شبكة البحث".
DISPLAY_STANDARD نوع المجموعة الإعلانية التلقائي للحملات على الشبكة الإعلانية.
SHOPPING_PRODUCT_ADS نوع المجموعة الإعلانية "لحملات Shopping" التي تعرِض إعلانات منتجات عادية.
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 نوع المجموعات الإعلانية في "حملات مقارنة الأسعار"
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 Ads).
CAMPAIGN_PAUSED لا يتم عرض أي إعلانات لهذه المجموعة الإعلانية لأنّ الحملة متوقفة مؤقتًا.
ACCOUNT_PAUSED لا يتم عرض أي إعلانات لهذه المجموعة الإعلانية، لأنه تم إيقاف الحساب مؤقتًا.

TargetingSetting

إعدادات الميزات المتعلّقة بالاستهداف على مستوى الحملة والمجموعة الإعلانية لمزيد من التفاصيل حول إعداد الاستهداف، يُرجى الانتقال إلى https://support.google.com/google-ads/answer/7365594.

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

object (TargetRestriction)

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

TargetRestriction

قائمة إعدادات الاستهداف لكل سمة استهداف.

تمثيل JSON 
{
  "targetingDimension": enum (TargetingDimension),
  "bidOnly": boolean
}
الحقول
targetingDimension

enum (TargetingDimension)

سمة الاستهداف التي تنطبق عليها هذه الإعدادات.
bidOnly

boolean

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

TargetingDimension

قائمة أرقام تصف سمات الاستهداف المحتملة

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
KEYWORD معايير الكلمات الرئيسية، مثل "رحلة بحرية إلى المريخ" يمكن استخدام KEYWORD كسمة عرض سعر مخصّصة. الكلمات الرئيسية هي دائمًا سمة استهداف، لذا لا يمكن ضبطها كسمة مستهدفة "الكل" باستخدام TargetRestriction.
AUDIENCE معايير الجمهور، التي تشمل قائمة المستخدمين واهتمامات المستخدمين والاهتمامات المشترَكة المخصّصة والجمهور المخصّص في السوق
TOPIC معايير المواضيع لاستهداف فئات المحتوى، على سبيل المثال، "category::Animals>Pets" المستخدَمة لاستهداف الشبكة الإعلانية وشبكة الفيديو
GENDER معايير استهداف الجنس
AGE_RANGE معايير استهداف الفئات العمرية.
PLACEMENT معايير مواضع الإعلانات، التي تشمل مواقع إلكترونية مثل "www.flowers4sale.com"، بالإضافة إلى التطبيقات المتوافقة مع الأجهزة الجوّالة وفئات التطبيقات المتوافقة مع الأجهزة الجوّالة وفيديوهات YouTube وقنوات YouTube
PARENTAL_STATUS معايير استهداف الحالة الأبوية.
INCOME_RANGE معايير استهداف نطاق الدخل

AdGroupAd

إعلان مجموعة إعلانية.

تمثيل JSON 
{
  "resourceName": string,
  "status": enum (AdGroupAdStatus),
  "ad": {
    object (Ad)
  },
  "creationTime": string,
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "engineId": string,
  "engineStatus": enum (AdGroupAdEngineStatus),
  "lastModifiedTime": string
}
الحقول
resourceName

string

اسم مورد الإعلان. يكون لأسماء موارد الإعلانات للمجموعات الإعلانية الشكل التالي:

customers/{customerId}/adGroupAds/{ad_group_id}~{adId}
status

enum (AdGroupAdStatus)

حالة الإعلان.
ad

object (Ad)

الإعلان
creationTime

string

الطابع الزمني لإنشاء adGroupAd هذا. يتم عرض التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss.ssssss".
labels[]

string

أسماء مصادر التصنيفات المرتبطة بهذا الإعلان للمجموعة الإعلانية.
effectiveLabels[]

string

أسماء موارد التصنيفات الفعّالة المرفقة بهذا الإعلان. التصنيف الفعّال هو تصنيف مكتسَب أو تمّ تعيينه مباشرةً لهذا الإعلان.
engineId

string

رقم تعريف الإعلان في حساب محرّك البحث الخارجي هذا الحقل مخصّص لحساب "إعلانات شبكة البحث 360" فقط، على سبيل المثال، Yahoo Japan وMicrosoft وBaidu وما إلى ذلك. بالنسبة إلى الكيانات غير التابعة لخدمة "إعلانات شبكة البحث 360"، استخدِم "adGroupAd.ad.id" بدلاً من ذلك.
engineStatus

enum (AdGroupAdEngineStatus)

حالة إضافية للإعلان في حساب محرّك البحث الخارجي تشمل الحالات المحتملة (حسب نوع الحساب الخارجي) "نشط" و"مؤهّل" و"في انتظار المراجعة" وما إلى ذلك.
lastModifiedTime

string

التاريخ والوقت اللذان تمّ فيهما إجراء آخر تعديل على إعلان هذه المجموعة الإعلانية. يتم عرض التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss.ssssss".

AdGroupAdStatus

الحالات المحتمَلة لأحد "إعلانات المجموعة الإعلانية"

عمليات التعداد
UNSPECIFIED لم يتم تحديد أي قيمة.
UNKNOWN

القيمة المستلَمة غير معروفة في هذا الإصدار.

هذه قيمة للردّ فقط.
ENABLED تم تفعيل الإعلان على مستوى المجموعة الإعلانية.
PAUSED إعلان المجموعة الإعلانية متوقف مؤقتًا.
REMOVED تمت إزالة إعلان المجموعة الإعلانية.

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 إعلان متعدد مواد العرض أثناء التصفّح
TRAVEL_AD إعلان سفر
DISCOVERY_VIDEO_RESPONSIVE_AD إعلان فيديو متجاوب أثناء التصفّح
MULTIMEDIA_AD إعلان متعدد الوسائط.

SearchAds360TextAdInfo

إعلان نصي في "إعلانات شبكة البحث 360"

تمثيل JSON 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "displayUrl": string,
  "displayMobileUrl": string,
  "adTrackingId": string
}
الحقول
headline

string

عنوان الإعلان.
description1

string

السطر الأول من وصف الإعلان
description2

string

السطر الثاني من وصف الإعلان.
displayUrl

string

عنوان URL المعروض للإعلان.
displayMobileUrl

string

تمثّل هذه السمة عنوان URL المعروض على الأجهزة الجوّالة للإعلان.
adTrackingId

string (int64 format)

رقم تعريف التتبّع للإعلان.

SearchAds360ExpandedTextAdInfo

إعلان نصي موسَّع في "إعلانات شبكة البحث 360".

تمثيل JSON 
{
  "headline": string,
  "headline2": string,
  "headline3": string,
  "description1": string,
  "description2": string,
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
الحقول
headline

string

عنوان الإعلان.
headline2

string

العنوان الثاني للإعلان.
headline3

string

العنوان الثالث للإعلان.
description1

string

السطر الأول من وصف الإعلان
description2

string

السطر الثاني من وصف الإعلان.
path1

string

نص مرفق بعنوان URL المرئي الذي تم إنشاؤه تلقائيًا باستخدام فاصل
path2

string

نص مرفق بالمسار 1 باستخدام فاصل
adTrackingId

string (int64 format)

رقم تعريف التتبّع للإعلان.

SearchAds360ResponsiveSearchAdInfo

إعلان متجاوب على شبكة البحث في "إعلانات شبكة البحث 360"

تمثيل JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
الحقول
headlines[]

object (AdTextAsset)

قائمة بمواد العرض النصية للعناوين عند عرض الإعلان، سيتم اختيار العناوين من هذه القائمة.
descriptions[]

object (AdTextAsset)

قائمة بمواد العرض النصية للأوصاف عند عرض الإعلان، سيتم اختيار الأوصاف من هذه القائمة.
path1

string

نص مرفق بعنوان URL المرئي الذي تم إنشاؤه تلقائيًا باستخدام فاصل
path2

string

نص مرفق بالمسار 1 باستخدام فاصل
adTrackingId

string (int64 format)

رقم تعريف التتبّع للإعلان.

AdTextAsset

مادة عرض نصية تُستخدم داخل إعلان.

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

string

نص مادة العرض

SearchAds360ProductAdInfo

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

إعلان منتج في "إعلانات شبكة البحث 360"

SearchAds360ExpandedDynamicSearchAdInfo

إعلان ديناميكي موسّع على شبكة البحث

تمثيل JSON 
{
  "description1": string,
  "description2": string,
  "adTrackingId": string
}
الحقول
description1

string

السطر الأول من وصف الإعلان
description2

string

السطر الثاني من وصف الإعلان.
adTrackingId

string (int64 format)

رقم تعريف التتبّع للإعلان.

AdGroupAdEngineStatus

يُدرِج حالات محرّك AdGroupAd.

عمليات التعداد
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 تم إيقاف تصميم الإعلان مؤقتًا لأن المجموعة الإعلانية متوقفة مؤقتًا.

AdGroupAdEffectiveLabel

علاقة بين إعلان مجموعة إعلانية وتصنيف فعّال التصنيف الفعّال هو تصنيف مكتسَب أو تمّ تعيينه مباشرةً لإعلان هذه المجموعة الإعلانية.

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

string

اسم المرجع للتصنيف الفعّال للإعلان في المجموعة الإعلانية يكون شكل أسماء موارد التصنيفات الفعالة للإعلانات في المجموعة الإعلانية على النحو التالي: customers/{customerId}/adGroupAdEffectiveLabels/{ad_group_id}~{adId}~{label_id}
adGroupAd

string

إعلان المجموعة الإعلانية الذي تم إرفاق التصنيف الفعال به.
label

string

التصنيف الفعّال الذي تمّ تعيينه لإعلان المجموعة الإعلانية.
ownerCustomerId

string (int64 format)

رقم تعريف العميل الذي يملك التصنيف الفعّال.

AdGroupAdLabel

علاقة بين إعلان مجموعة إعلانية وتصنيف

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

string

اسم مصدر تصنيف الإعلان للمجموعة الإعلانية. تكون أسماء موارد تصنيفات الإعلانات للمجموعات الإعلانية على النحو التالي: customers/{customerId}/adGroupAdLabels/{ad_group_id}~{adId}~{label_id}
adGroupAd

string

إعلان المجموعة الإعلانية الذي تم إرفاق التصنيف به.
label

string

التصنيف الذي تمّ تعيينه لإعلان المجموعة الإعلانية.
ownerCustomerId

string (int64 format)

رقم تعريف العميل الذي يملك التصنيف.

AdGroupAsset

رابط بين مجموعة إعلانية ومادّة عرض

تمثيل JSON 
{
  "resourceName": string,
  "adGroup": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
الحقول
resourceName

string

اسم المرجع لمادة عرض المجموعة الإعلانية. تكون أسماء موارد AdGroupAsset على النحو التالي:

customers/{customerId}/adGroupAssets/{ad_group_id}~{assetId}~{fieldType}
adGroup

string

مطلوب. المجموعة الإعلانية المرتبطة بمادة العرض.
asset

string

مطلوب. مادة العرض المرتبطة بالمجموعة الإعلانية.
status

enum (AssetLinkStatus)

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

AssetLinkStatus

تعداد يصف حالات رابط مادة العرض

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

AdGroupAssetSet

AdGroupAssetSet هي عبارة عن الارتباط بين مجموعة إعلانية ومجموعة مواد عرض. يؤدي إنشاء AdGroupAssetSet إلى ربط مجموعة مواد عرض بمجموعة إعلانية.

تمثيل JSON 
{
  "resourceName": string,
  "adGroup": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
الحقول
resourceName

string

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

customers/{customerId}/adGroupAssetSets/{ad_group_id}~{asset_set_id}
adGroup

string

المجموعة الإعلانية المرتبطة بمجموعة مواد العرض هذه.
assetSet

string

مجموعة مواد العرض المرتبطة بالمجموعة الإعلانية.
status

enum (AssetSetLinkStatus)

حالة مجموعة مواد عرض المجموعة الإعلانية. للقراءة فقط.

AssetSetLinkStatus

الحالات المحتمَلة للربط بين مجموعة مواد العرض وحاويتها

عمليات التعداد
UNSPECIFIED لم يتم تحديد الحالة.
UNKNOWN القيمة المستلَمة غير معروفة في هذا الإصدار. هذه قيمة للردّ فقط.
ENABLED تم تفعيل الربط بين مجموعة مواد العرض وحاويتها.
REMOVED تتم إزالة الرابط بين مجموعة مواد العرض وحاويتها.

AdGroupAudienceView

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

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

string

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

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

AdGroupBidModifier

تمثّل مُعدِّل عرض سعر المجموعة الإعلانية.

تمثيل JSON 
{
  "resourceName": string,
  "bidModifier": number,

  // Union field criterion can be only one of the following:
  "device": {
    object (DeviceInfo)
  }
  // End of list of possible types for union field criterion.
}
الحقول
resourceName

string

اسم المورد لمعدِّل عروض أسعار المجموعة الإعلانية. يكون شكل أسماء موارد مُعدِّل عروض أسعار المجموعة الإعلانية على النحو التالي:

customers/{customerId}/adGroupBidModifiers/{ad_group_id}~{criterionId}
bidModifier

number

المُعدِّل لعرض السعر عند تطابق المعيار يجب أن يكون المُعدِّل في النطاق: 0.1 - 10.0. يتراوح النطاق بين 1.0 و6.0 لعنصر PreferredContent. استخدِم القيمة 0 لإيقاف نوع جهاز.

حقل الربط criterion معيار معدِّل عروض أسعار المجموعة الإعلانية هذا.

مطلوب في عمليات الإنشاء التي تبدأ من الإصدار 5. يمكن أن يكون criterion واحدًا فقط مما يلي:
device

object (DeviceInfo)

معيار جهاز

DeviceInfo

معيار الجهاز

تمثيل JSON 
{
  "type": enum (Device)
}
الحقول
type

enum (Device)

نوع الجهاز

الجهاز

لتعداد أجهزة "إعلانات Google" المتاحة للاستهداف.

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN القيمة غير معروفة في هذا الإصدار.
MOBILE الأجهزة الجوّالة المزوّدة بمتصفّحات كاملة الوظائف
TABLET الأجهزة اللوحية المزوّدة بمتصفّحات كاملة الوظائف
DESKTOP أجهزة الكمبيوتر
CONNECTED_TV أجهزة التلفزيون الذكية ووحدات تحكّم الألعاب
OTHER أنواع الأجهزة الأخرى

AdGroupCriterion

معيار مجموعة إعلانية لا يعرض تقرير adGroupCriterion سوى المعايير التي تمت إضافتها صراحةً إلى المجموعة الإعلانية.

تمثيل JSON 
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "engineId": string,
  "lastModifiedTime": string,
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "engineStatus": enum (AdGroupCriterionEngineStatus),
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "location": {
    object (LocationInfo)
  }
  // End of list of possible types for union field criterion.
}
الحقول
resourceName

string

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

customers/{customerId}/adGroupCriteria/{ad_group_id}~{criterionId}
creationTime

string

الطابع الزمني لإنشاء معيار المجموعة الإعلانية هذا. يكون الطابع الزمني بالتنسيق yyyy-MM-dd HH:mm:ss وحسب المنطقة الزمنية للعميل.
status

enum (AdGroupCriterionStatus)

حالة المعيار.

هذه هي حالة كيان معيار المجموعة الإعلانية التي ضبطها العميل. ملاحظة: قد تتضمّن تقارير واجهة المستخدم معلومات إضافية تؤثّر في ما إذا كان المعيار مؤهَّلاً للتشغيل. في بعض الحالات، قد يستمر ظهور معيار تمّت إزالته في واجهة برمجة التطبيقات على أنّه مفعّل في واجهة المستخدِم. على سبيل المثال، تظهر الحملات تلقائيًا للمستخدمين من جميع الفئات العمرية ما لم يتم استبعادها. سيعرض واجهة المستخدِم كلّ فئة عمرية على أنّها "مفعّلة"، لأنّها مؤهّلة لعرض الإعلانات، ولكن ستظهر الحالة AdGroupCriterion.status على أنّها "مُزالة"، لأنّه لم تتمّ إضافة أيّ معيار إيجابي.
qualityInfo

object (QualityInfo)

تمثّل هذه السمة معلومات حول جودة المعيار.
type

enum (CriterionType)

نوع المعيار
labels[]

string

أسماء موارد التصنيفات المرفقة بمعيار المجموعة الإعلانية هذا.
effectiveLabels[]

string

أسماء الموارد للتسميات الفعّالة المرتبطة بمعيار المجموعة الإعلانية هذا. التصنيف الفعّال هو تصنيف مكتسَب أو تمّ تعيينه مباشرةً لخاصيّة المجموعة الإعلانية هذه.
positionEstimates

object (PositionEstimates)

تقديرات عروض أسعار المعايير في مواضع مختلفة
finalUrls[]

string

قائمة عناوين URL النهائية المحتمَلة بعد كل عمليات إعادة التوجيه عبر النطاقات للإعلان
engineId

string

رقم تعريف معيار المجموعة الإعلانية في حساب المحرّك الخارجي هذا الحقل مخصّص للحسابات غير التابعة لخدمة "إعلانات Google" فقط، مثل Yahoo Japan وMicrosoft وBaidu وما إلى ذلك. بالنسبة إلى الكيانات في "إعلانات Google"، استخدِم "adGroupCriterion.criterion_id" بدلاً من ذلك.
lastModifiedTime

string

التاريخ والوقت الذي تم فيه إجراء آخر تعديل على معيار المجموعة الإعلانية هذا. يتم عرض التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss.ssssss".
criterionId

string (int64 format)

رقم تعريف المعيار.
adGroup

string

المجموعة الإعلانية التي ينتمي إليها المعيار.
negative

boolean

لتحديد ما إذا كنت تريد استهداف (false) أو استبعاد (true) المعيار.

هذا الحقل غير قابل للتغيير. لتبديل معيار من موجب إلى سلبي، أزِله ثم أعِد إضافته.
bidModifier

number

المُعدِّل لعرض السعر عند تطابق المعيار يجب أن يكون المُعدَّل في النطاق: 0.1 - 10.0. تتوافق معظم أنواع المعايير التي يمكن استهدافها مع المُعدِّلات.
cpcBidMicros

string (int64 format)

عرض سعر النقرة (CPC)
effectiveCpcBidMicros

string (int64 format)

عرض سعر النقرة الفعّال
engineStatus

enum (AdGroupCriterionEngineStatus)

حالة المحرّك لمعيار المجموعة الإعلانية.
finalUrlSuffix

string

نموذج عنوان URL لإلحاق المَعلمات بعنوان URL النهائي
trackingUrlTemplate

string

نموذج عنوان URL لإنشاء عنوان URL للتتبع.

حقل الربط criterion معيار المجموعة الإعلانية.

يجب تحديد قيمة واحدة فقط. يمكن أن يكون criterion واحدًا فقط مما يلي:
keyword

object (KeywordInfo)

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

object (ListingGroupInfo)

مجموعة البيانات
ageRange

object (AgeRangeInfo)

الفئة العمرية
gender

object (GenderInfo)

الجنس
userList

object (UserListInfo)

قائمة المستخدمين
webpage

object (WebpageInfo)

صفحة ويب
location

object (LocationInfo)

الموقع الجغرافي.

AdGroupCriterionStatus

الحالات المحتمَلة لمعيار المجموعة الإعلانية

عمليات التعداد
UNSPECIFIED لم يتم تحديد أي قيمة.
UNKNOWN

القيمة المستلَمة غير معروفة في هذا الإصدار.

هذه قيمة للردّ فقط.
ENABLED تم تفعيل معيار المجموعة الإعلانية.
PAUSED تم إيقاف معيار المجموعة الإعلانية مؤقتًا.
REMOVED تمت إزالة معيار المجموعة الإعلانية.

QualityInfo

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

تمثيل JSON 
{
  "qualityScore": integer
}
الحقول
qualityScore

integer

نقاط الجودة

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

تقديرات_المواقع

تقديرات عروض أسعار المعايير في مواضع مختلفة

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

string (int64 format)

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

AdGroupCriterionEngineStatus

يُدرِج حالات محرّك AdGroupCriterion.

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

تمّ الإيقاف. لا تستخدِم هذه الطريقة.
AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN 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. Gemini: المعيار قيد المراجعة.
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 (KeywordMatchType),
  "text": string
}
الحقول
matchType

enum (KeywordMatchType)

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

string

نص الكلمة الرئيسية (80 حرفًا و10 كلمات كحد أقصى)

KeywordMatchType

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

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
EXACT المطابقة التامة
PHRASE مطابقة العبارة.
BROAD المطابقة التقريبية:

ListingGroupInfo

معيار مجموعة بيانات.

تمثيل JSON 
{
  "type": enum (ListingGroupType)
}
الحقول
type

enum (ListingGroupType)

نوع مجموعة البيانات

ListingGroupType

نوع مجموعة البيانات

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
SUBDIVISION تقسيم فرعي للمنتجات على طول بعض سمات البيانات. لا يتم استخدام هذه العقد من خلال عرض الإعلانات لاستهداف إدخالات البيانات في البيانات، ولكن يتم استخدامها فقط لتحديد بنية الشجرة.
UNIT وحدة مجموعة البيانات التي تحدّد عرض سعر

AgeRangeInfo

معيار الفئة العمرية.

تمثيل JSON 
{
  "type": enum (AgeRangeType)
}
الحقول
type

enum (AgeRangeType)

نوع الفئة العمرية

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 (GenderType)
}
الحقول
type

enum (GenderType)

تمثّل هذه السمة نوع الجنس.

GenderType

نوع الأجناس الديمغرافية (على سبيل المثال، أنثى).

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

UserListInfo

معيار قائمة مستخدمين تمثّل قائمة مستخدمين حدّدها المعلِن لاستهدافها.

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

string

اسم مورد قائمة المستخدمين

WebpageInfo

يمثّل معيارًا لاستهداف صفحات الويب لموقع المعلِن الإلكتروني.

تمثيل JSON 
{
  "conditions": [
    {
      object (WebpageConditionInfo)
    }
  ],
  "coveragePercentage": number,
  "criterionName": string
}
الحقول
conditions[]

object (WebpageConditionInfo)

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

هذا الحقل مطلوب لعمليات CREATE وهو محظور في عمليات UPDATE.
coveragePercentage

number

النسبة المئوية لتغطية معايير الموقع الإلكتروني هذه هي النسبة المئوية المحسوبة لتغطية الموقع الإلكتروني استنادًا إلى استهداف الموقع الإلكتروني واستهداف الموقع الإلكتروني السلبي والكلمات الرئيسية السلبية في المجموعة الإعلانية والحملة. على سبيل المثال، عندما يتم عرض التغطية على أنّها 1، يعني ذلك أنّها تبلغ% 100. هذا الحقل للقراءة فقط.
criterionName

string

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

هذا الحقل مطلوب لعمليات الإنشاء (CREATE) وغير مسموح به في عمليات التعديل (UPDATE).

WebpageConditionInfo

تعبير منطقي لاستهداف صفحات الويب لموقع المعلِن الإلكتروني.

تمثيل JSON 
{
  "operand": enum (WebpageConditionOperand),
  "operator": enum (WebpageConditionOperator),
  "argument": string
}
الحقول
operand

enum (WebpageConditionOperand)

عامل تشغيل شرط استهداف صفحة الويب
operator

enum (WebpageConditionOperator)

عامل تشغيل شرط استهداف صفحة الويب
argument

string

وسيطة شرط استهداف صفحة الويب.

WebpageConditionOperand

عامل تشغيل حالة صفحة الويب في معيار صفحة الويب

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
URL خاصية تشير إلى شرط استهداف عنوان URL لصفحة الويب.
CATEGORY عامل تشغيل يشير إلى شرط استهداف فئة صفحة ويب.
PAGE_TITLE عامل تشغيل يشير إلى شرط استهداف عنوان صفحة ويب.
PAGE_CONTENT عامل تشغيل يشير إلى شرط استهداف محتوى صفحة الويب
CUSTOM_LABEL عامل تشغيل يشير إلى حالة استهداف تصنيف مخصّص لصفحة ويب.

WebpageConditionOperator

عامل تشغيل شرط صفحة الويب في معيار صفحة الويب

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
EQUALS يكون شرط الويب للوسيطة مساويًا لشرط الويب الذي تتم مقارنته.
CONTAINS شرط الويب للوسيطة هو جزء من شرط الويب المُقارَن.

LocationInfo

معيار موقع جغرافي

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

string

اسم المورد الثابت للاستهداف الجغرافي

AdGroupCriterionEffectiveLabel

علاقة بين معيار مجموعة إعلانية وعلامة فعّالة التصنيف الفعّال هو تصنيف مكتسَب أو تمّ تعيينه مباشرةً لخاصيّة المجموعة الإعلانية هذه.

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

string

اسم المورد للتصنيف الفعال لمعيار المجموعة الإعلانية. تكون أسماء موارد التصنيفات الفعّالة لمعايير المجموعة الإعلانية على النحو التالي: customers/{customerId}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterionId}~{label_id}
adGroupCriterion

string

معيار المجموعة الإعلانية الذي تم إرفاق التصنيف الفعال به.
label

string

التصنيف الفعّال الذي تمّ تعيينه لمعيار المجموعة الإعلانية.
ownerCustomerId

string (int64 format)

رقم تعريف العميل الذي يملك التصنيف الفعّال.

AdGroupCriterionLabel

علاقة بين معيار مجموعة إعلانية وعلامة

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

string

اسم المرجع لتصنيف معيار المجموعة الإعلانية. تكون أسماء موارد تصنيفات معايير المجموعة الإعلانية على النحو التالي: customers/{customerId}/adGroupCriterionLabels/{ad_group_id}~{criterionId}~{label_id}
adGroupCriterion

string

معيار المجموعة الإعلانية الذي يتم إرفاق التصنيف به.
label

string

التصنيف المعيَّن لمعيار المجموعة الإعلانية.
ownerCustomerId

string (int64 format)

معرّف العميل الذي يملك التصنيف.

AdGroupEffectiveLabel

علاقة بين مجموعة إعلانية وعلامة فعّالة التصنيف الفعّال هو تصنيف مكتسَب أو تمّ تعيينه مباشرةً لهذه المجموعة الإعلانية.

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

string

اسم المورد لتصنيف فعّال للمجموعة الإعلانية. يكون شكل أسماء موارد التصنيفات الفعالة للمجموعات الإعلانية على النحو التالي: customers/{customerId}/adGroupEffectiveLabels/{ad_group_id}~{label_id}
adGroup

string

المجموعة الإعلانية التي يرتبط بها التصنيف الفعّال.
label

string

التصنيف الفعّال الذي تمّ تعيينه للمجموعة الإعلانية.
ownerCustomerId

string (int64 format)

رقم تعريف العميل الذي يملك التصنيف الفعّال.

AdGroupLabel

علاقة بين مجموعة إعلانية وعلامة

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

string

اسم المورد لتصنيف المجموعة الإعلانية. يكون شكل أسماء موارد تصنيفات المجموعات الإعلانية على النحو التالي: customers/{customerId}/adGroupLabels/{ad_group_id}~{label_id}
adGroup

string

المجموعة الإعلانية التي تم إرفاق التصنيف بها.
label

string

التصنيف الذي تمّ تعيينه للمجموعة الإعلانية.
ownerCustomerId

string (int64 format)

رقم تعريف العميل الذي يملك التصنيف.

AgeRangeView

عرض الفئة العمرية

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

string

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

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

مادة العرض

مادة العرض هي جزء من إعلان يمكن مشاركته على مستوى إعلانات متعدّدة. يمكن أن تكون صورة (ImageAsset) أو فيديو (YoutubeVideoAsset) أو غير ذلك. إنّ مواد العرض غير قابلة للتغيير ولا يمكن إزالتها. لإيقاف ظهور مادة عرض معيّنة، يجب إزالتها من الكيان الذي يستخدمها.

تمثيل JSON 
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "engineStatus": enum (AssetEngineStatus),

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "calloutAsset": {
    object (UnifiedCalloutAsset)
  },
  "sitelinkAsset": {
    object (UnifiedSitelinkAsset)
  },
  "pageFeedAsset": {
    object (UnifiedPageFeedAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "callAsset": {
    object (UnifiedCallAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "locationAsset": {
    object (UnifiedLocationAsset)
  }
  // End of list of possible types for union field asset_data.
}
الحقول
resourceName

string

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

customers/{customerId}/assets/{assetId}
type

enum (AssetType)

نوع مادة العرض
finalUrls[]

string

قائمة بعناوين URL النهائية المحتمَلة بعد جميع عمليات إعادة التوجيه عبر النطاقات
status

enum (AssetStatus)

حالة مادة العرض
creationTime

string

الطابع الزمني لوقت إنشاء مادة العرض هذه يكون الطابع الزمني بالتنسيق yyyy-MM-dd HH:mm:ss وحسب المنطقة الزمنية للعميل.
lastModifiedTime

string

التاريخ والوقت اللذان تمّ فيهما تعديل مادة العرض هذه آخر مرة يكون التاريخ والوقت في المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss.ssssss".
id

string (int64 format)

رقم تعريف مادة العرض
name

string

اسم اختياري لمادة العرض.
trackingUrlTemplate

string

نموذج عنوان URL لإنشاء عنوان URL للتتبّع
engineStatus

enum (AssetEngineStatus)

حالة المحرّك لمادة عرض معيّنة.
حقل الربط asset_data النوع المحدّد لمادة العرض. يمكن أن يكون asset_data واحدًا فقط مما يلي:
youtubeVideoAsset

object (YoutubeVideoAsset)

مادة عرض فيديو على YouTube
imageAsset

object (ImageAsset)

مادة عرض صورة
textAsset

object (TextAsset)

مادة عرض نصية
calloutAsset

object (UnifiedCalloutAsset)

مادة عرض وسيلة شرح موحّدة
pageFeedAsset

object (UnifiedPageFeedAsset)

مادة عرض خلاصة صفحة موحّدة
mobileAppAsset

object (MobileAppAsset)

مادة عرض تطبيق متوافق مع الأجهزة الجوّالة
callAsset

object (UnifiedCallAsset)

مادة عرض مكالمات موحّدة
callToActionAsset

object (CallToActionAsset)

مادة عرض عبارة تحث المستخدم على اتّخاذ إجراء
locationAsset

object (UnifiedLocationAsset)

مادة عرض موقع جغرافي موحّدة

AssetType

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

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
YOUTUBE_VIDEO مادة عرض فيديو YouTube
MEDIA_BUNDLE مادة عرض حِزمة وسائط
IMAGE مادة عرض الصورة
TEXT مادة عرض نصية
LEAD_FORM مادة عرض نموذج العملاء المحتملين
BOOK_ON_GOOGLE مادة عرض "الحجز على Google"
PROMOTION مادة عرض خاصة بالعرض الترويجي
CALLOUT مادة عرض وسيلة الشرح
STRUCTURED_SNIPPET مادة عرض مقتطف من الموقع
PAGE_FEED مادة عرض خلاصة الصفحة
DYNAMIC_EDUCATION مادة عرض التعليم الديناميكي
MOBILE_APP مادة عرض تطبيق للأجهزة الجوّالة
HOTEL_CALLOUT مادة عرض وسيلة شرح للفندق
CALL مادة عرض المكالمة
PRICE مادة عرض السعر
CALL_TO_ACTION مادة عرض عبارة الحث على اتّخاذ إجراء
DYNAMIC_REAL_ESTATE مادة عرض عقارات ديناميكية
DYNAMIC_CUSTOM مادة عرض مخصّصة ديناميكية
DYNAMIC_HOTELS_AND_RENTALS مواد عرض الفنادق والإيجارات الديناميكية.
DYNAMIC_FLIGHTS مادة عرض رحلات جوية ديناميكية
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

string

عنوان الفيديو على YouTube
youtubeVideoId

string

معرّف الفيديو على YouTube هذه هي قيمة السلسلة التي تتألف من 11 حرفًا والتي يتم استخدامها في عنوان URL الخاص بالفيديو على YouTube.

ImageAsset

مادة عرض صورة.

تمثيل JSON 
{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "fileSize": string
}
الحقول
mimeType

enum (MimeType)

نوع MIME لمادة عرض الصورة
fullSize

object (ImageDimension)

البيانات الوصفية لهذه الصورة بحجمها الأصلي.
fileSize

string (int64 format)

حجم ملف مادة عرض الصورة بالبايت

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‏ application/vnd.ms-excel
RTF نوع MIME للتطبيق/rtf.
AUDIO_WAV نوع MIME للملف audio/wav
AUDIO_MP3 نوع MIME للملف الصوتي/mp3
HTML5_AD_ZIP نوع MIME هو application/x-html5-ad-zip.

سمة ImageDimension

البيانات الوصفية لصورة بحجم معيّن، سواء كانت الصورة الأصلية أو تم تغيير حجمها

تمثيل JSON 
{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}
الحقول
heightPixels

string (int64 format)

ارتفاع الصورة
widthPixels

string (int64 format)

عرض الصورة
url

string

عنوان URL يعرض الصورة بالارتفاع والعرض المحدَّدين

TextAsset

مادة عرض نصية

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

string

المحتوى النصي لمادة العرض النصية

UnifiedCalloutAsset

مادة عرض موحَّدة لوسائل الشرح.

تمثيل JSON 
{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "useSearcherTimeZone": boolean
}
الحقول
calloutText

string

نص وسيلة الشرح يجب أن يكون طول هذه السلسلة بين 1 و25، بشكل شامل.
startDate

string

تاريخ بدء سريان مادة العرض هذه وإمكانية عرضها، بالتنسيق yyyy-MM-dd
endDate

string

التاريخ الأخير الذي أصبحت فيه مادة العرض هذه سارية ولا تزال قيد العرض، بالتنسيق yyyy-MM-dd
adScheduleTargets[]

object (AdScheduleInfo)

قائمة بالجداول الزمنية غير المتداخلة التي تحدِّد جميع الفواصل الزمنية التي قد تُعرض خلالها مادة العرض يمكن أن يكون هناك 6 جداول زمنية كحد أقصى في اليوم، وإجمالي 42 جدولاً.
useSearcherTimeZone

boolean

ما إذا كان سيتم عرض مادة العرض في المنطقة الزمنية لمستخدم البحث تنطبق هذه المقالة على Microsoft Advertising.

AdScheduleInfo

تمثّل معيار "جدول عرض الإعلانات".

يتم تحديد AdSchedule على أنّه يوم الأسبوع وفاصل زمني سيتم عرض الإعلانات خلاله.

لا يمكن إضافة أكثر من ستة جداول إعلانات في اليوم نفسه.

تمثيل JSON 
{
  "startMinute": enum (MinuteOfHour),
  "endMinute": enum (MinuteOfHour),
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer
}
الحقول
startMinute

enum (MinuteOfHour)

دقائق بعد ساعة البدء التي يبدأ فيها هذا الجدول الزمني

هذا الحقل مطلوب لعمليات الإنشاء (CREATE) وغير مسموح به في عمليات التعديل (UPDATE).
endMinute

enum (MinuteOfHour)

دقائق بعد ساعة الانتهاء التي ينتهي فيها هذا الجدول الزمني. ولا يشمل الجدول الزمني دقيقة النهاية.

هذا الحقل مطلوب لعمليات CREATE وهو محظور في عمليات UPDATE.
dayOfWeek

enum (DayOfWeek)

يوم الأسبوع الذي ينطبق عليه الجدول الزمني

هذا الحقل مطلوب لعمليات الإنشاء (CREATE) وغير مسموح به في عمليات التعديل (UPDATE).
startHour

integer

ساعة البدء بعد 24 ساعة يجب أن تكون قيمة هذا الحقل بين 0 و23، بما في ذلك الرقمان.

هذا الحقل مطلوب لعمليات CREATE وهو محظور في عمليات UPDATE.
endHour

integer

ساعة الانتهاء بتنسيق 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 (AdScheduleInfo)
    }
  ],
  "trackingId": string,
  "useSearcherTimeZone": boolean,
  "mobilePreferred": boolean
}
الحقول
linkText

string

نص عرض عنوان URL لرابط أقسام الموقع. يجب أن يتراوح طول هذه السلسلة بين 1 و25 حرفًا.
description1

string

سطر الوصف الأول لرابط أقسام الموقع. في حال ضبط الطول، يجب أن يتراوح بين 1 و35، بما في ذلك، ويجب أيضًا ضبط description2.
description2

string

السطر الثاني من وصف رابط أقسام الموقع. في حال ضبط الطول، يجب أن يتراوح بين 1 و35، بما في ذلك، ويجب أيضًا ضبط description1.
startDate

string

تاريخ بدء سريان مادة العرض هذه وإمكانية عرضها، بالتنسيق yyyy-MM-dd
endDate

string

التاريخ الأخير الذي أصبحت فيه مادة العرض هذه سارية ولا تزال قيد العرض، بالتنسيق yyyy-MM-dd
adScheduleTargets[]

object (AdScheduleInfo)

قائمة بالجداول الزمنية غير المتداخلة التي تحدّد جميع الفواصل الزمنية التي يمكن أن يتم عرض مادة العرض خلالها يمكن أن يكون هناك 6 جداول كحدّ أقصى في اليوم، أي 42 جدولًا في المجمل.
trackingId

string (int64 format)

رقم التعريف المستخدَم لتتبُّع النقرات على مادة عرض رابط أقسام الموقع. هذا مستخدم على Yahoo! في اليابان فقط.
useSearcherTimeZone

boolean

ما إذا كان سيتم عرض مادة عرض رابط أقسام الموقع في المنطقة الزمنية لمستخدم البحث ينطبق ذلك على Microsoft Ads.
mobilePreferred

boolean

ما إذا كان الخيار المفضّل هو عرض مادة عرض رابط أقسام الموقع على الأجهزة الجوّالة. تنطبق هذه المقالة على Microsoft Advertising.

UnifiedPageFeedAsset

مادة عرض لخلاصة صفحة موحّدة.

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

string

صفحة الويب التي يريد المعلِنون استهدافها.
labels[]

string

التصنيفات المستخدَمة لتجميع عناوين URL للصفحات

MobileAppAsset

مادة عرض تمثّل تطبيقًا متوافقًا مع الأجهزة الجوّالة

تمثيل JSON 
{
  "appId": string,
  "appStore": enum (MobileAppVendor)
}
الحقول
appId

string

مطلوب. سلسلة تُعرِّف تطبيقًا للأجهزة الجوّالة بشكلٍ فريد. يجب أن يحتوي فقط على المعرّف الأصلي للنظام الأساسي، مثل "com.android.ebay" لنظام التشغيل Android أو "12345689" لنظام التشغيل iOS.
appStore

enum (MobileAppVendor)

مطلوب. متجر التطبيقات الذي يوزّع هذا التطبيق المحدّد.

MobileAppVendor

نوع موفِّر التطبيقات المتوافقة مع الأجهزة الجوّالة

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
APPLE_APP_STORE مورّد تطبيق الأجهزة الجوّالة لمتجر Apple App Store.
GOOGLE_APP_STORE مورّد تطبيق الأجهزة الجوّالة لمتجر تطبيقات Google.

UnifiedCallAsset

مادة عرض مكالمات موحّدة

تمثيل JSON 
{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "callOnly": boolean,
  "callTrackingEnabled": boolean,
  "useSearcherTimeZone": boolean,
  "startDate": string,
  "endDate": string
}
الحقول
countryCode

string

رمز البلد المكوّن من حرفين لرقم الهاتف أمثلة: 'US' أو 'us'.
phoneNumber

string

رقم هاتف المعلِن الأصلي. أمثلة: "1234567890" و"(123)456-7890"
callConversionReportingState

enum (CallConversionReportingState)

يشير إلى ما إذا كان يجب أن يستخدِم عنصر CallAsset هذا إعداد الإحالة الناجحة للمكالمات الخاص به، أو اتّباع الإعداد على مستوى الحساب، أو إيقاف الإحالة الناجحة للمكالمات.
callConversionAction

string

إجراء الإحالة الناجحة الذي يتمّ تحديد مصدر إحالة ناجحة عبر الاتصال الهاتفي له. وفي حال ترك هذه السياسة بدون ضبط، يتم استخدام إجراء الإحالة الناجحة التلقائي. لن يكون لهذا الحقل تأثير إلا في حال ضبط Call ConversionReportingState على USE_LOCATION_LEVEL_CALL_CONVERSION_ACTION.
adScheduleTargets[]

object (AdScheduleInfo)

قائمة بالجداول الزمنية غير المتداخلة التي تحدّد جميع الفواصل الزمنية التي يمكن أن يتم عرض مادة العرض خلالها يمكن أن يكون هناك 6 جداول كحدّ أقصى في اليوم، أي 42 جدولًا في المجمل.
callOnly

boolean

ما إذا كان الاتصال يعرض رقم الهاتف فقط بدون رابط إلى الموقع الإلكتروني ينطبق ذلك على Microsoft Ads.
callTrackingEnabled

boolean

يشير إلى ما إذا كان يجب تفعيل المكالمة في ميزة تتبُّع المكالمات. ينطبق ذلك على Microsoft Ads.
useSearcherTimeZone

boolean

ما إذا كان سيتم عرض إضافة المكالمة في المنطقة الزمنية لمستخدم البحث ينطبق ذلك على Microsoft Ads.
startDate

string

تاريخ بدء سريان مادة العرض هذه وإمكانية عرضها، بالتنسيق yyyy-MM-dd
endDate

string

آخر تاريخ ساري لهذه مادة العرض وتاريخ عرضها، بالتنسيق yyyy-MM-dd

CallConversionReportingState

أنواع البيانات المحتمَلة لحالة إجراء إحالة ناجحة عبر الاتصال الهاتفي

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN تُستخدَم لأغراض القيمة المعروضة فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
DISABLED تم إيقاف إجراء الإحالة الناجحة للمكالمات.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION سيستخدم إجراء الإحالة الناجحة للمكالمة نوع الإحالة الناجحة للمكالمة الذي تم ضبطه على مستوى الحساب.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION سيستخدم إجراء الإحالة الناجحة عبر المكالمات نوع الإحالة الناجحة عبر المكالمات الذي تم ضبطه على مستوى المورد (الإعلانات للاتصال فقط/إضافات المكالمات).

CallToActionAsset

مادة عرض عبارة تحث المستخدم على اتّخاذ إجراء

تمثيل JSON 
{
  "callToAction": enum (CallToActionType)
}
الحقول
callToAction

enum (CallToActionType)

عبارة حثّ المستخدم على اتخاذ إجراء

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 (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}
الحقول
placeId

string

تحدِّد أرقام تعريف الأماكن مكانًا بشكلٍ فريد في قاعدة بيانات "أماكن Google" وعلى "خرائط Google". يكون هذا الحقل فريدًا لكل من رقم تعريف العميل ونوع مادة العرض المحدّدَين. اطّلِع على https://developers.google.com/places/web-service/place-id للحصول على مزيد من المعلومات عن معرّف المكان.
businessProfileLocations[]

object (BusinessProfileLocation)

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

enum (LocationOwnershipType)

نوع ملكية الموقع الجغرافي إذا كان النوع هو BUSINESS_OWNER، سيتم عرضها كإضافة موقع جغرافي. إذا كان النوع "شريك تابع"، سيتم عرضه كموقع جغرافي للشركاء التابعين.

BusinessProfileLocation

بيانات الموقع الجغرافي للملف التجاري التي تمت مزامنتها من حساب "الملف التجاري" المرتبط

تمثيل JSON 
{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}
الحقول
labels[]

string

التصنيف الذي حدّده المعلِن للموقع الجغرافي في حساب "الملف التجاري" وتتم مزامنة هذه المعلومات من حساب "الملف التجاري على Google".
storeCode

string

رمز المتجر في "الملف التجاري" لهذا الموقع الجغرافي وتتم مزامنة هذه المعلومات من حساب "الملف التجاري على Google".
listingId

string (int64 format)

رقم تعريف النشاط لهذا الموقع الجغرافي في "الملف التجاري" تتم مزامنة هذه البيانات من حساب "الملف التجاري" المرتبط.

LocationOwnershipType

الأنواع المحتملة لملكية الموقع الجغرافي.

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
BUSINESS_OWNER مالك النشاط التجاري للموقع الجغرافي(إضافة الموقع الجغرافي القديمة - LE).
AFFILIATE موقع المعلِن الجغرافي(إضافة موقع جغرافي تابع لجهة خارجية)

AssetGroupAsset

AssetGroupAsset هو الرابط بين مادة عرض ومجموعة مواد عرض. تؤدي إضافة مادة عرض AssetGroupAsset إلى ربط مادة عرض بمجموعة مواد عرض.

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

string

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

customers/{customerId}/assetGroupAssets/{asset_group_id}~{assetId}~{fieldType}
assetGroup

string

مجموعة مواد العرض التي ترتبط بها مادة عرض مجموعة مواد العرض هذه.
asset

string

مادة العرض التي تربطها مادة عرض مجموعة مواد العرض هذه
fieldType

enum (AssetFieldType)

وصف لموضع مادة العرض ضمن مجموعة مواد العرض. على سبيل المثال: HEADLINE وYOUTUBE_VIDEO وما إلى ذلك
status

enum (AssetLinkStatus)

حالة الرابط بين مادة عرض ومجموعة مواد عرض

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 تم ربط مادة العرض لاستخدامها كإضافة مقتطف من الموقع.
MOBILE_APP تم ربط مادة العرض لاستخدامها كإضافة تطبيق للأجهزة الجوّالة.
HOTEL_CALLOUT تم ربط مادة العرض لاستخدامها كإضافة وسائل شرح فنادق.
CALL تم ربط مادة العرض لاستخدامها كإضافة مكالمة.
PRICE تم ربط مادة العرض لاستخدامها كمعلومات سعر إضافية.
LONG_HEADLINE تم ربط مادة العرض لاستخدامها كعنوان طويل.
BUSINESS_NAME أن تكون مادة العرض مرتبطة لاستخدامها كاسم نشاط تجاري
SQUARE_MARKETING_IMAGE تم ربط مادة العرض لاستخدامها كصورة تسويقية مربّعة.
PORTRAIT_MARKETING_IMAGE مادة العرض مرتبطة لاستخدامها كصورة تسويقية عمودية.
VIDEO تم ربط مادة العرض لاستخدامها كشعار غير تابع لمنصة YouTube.
CALL_TO_ACTION_SELECTION تم ربط مادة العرض لاستخدامها لاختيار عبارة تحثّ على اتّخاذ إجراء.
AD_IMAGE تم ربط مادة العرض لاستخدامها في اختيار صورة إعلان.
HOTEL_PROPERTY تم ربط مادة العرض لاستخدامها كفندق في "حملة الأداء الأفضل" المستندة إلى أهداف السفر.

AssetGroupSignal

يمثّل AssetGroupSignal إشارة في مجموعة مواد عرض. يُعلم توفّر إشارة "حملة الأداء الأفضل" بالمستخدِمين الذين يُرجّح إجراؤهم لإحالة ناجحة. وتستخدِم "حملات الأداء الأفضل" الإشارة للبحث عن مستخدِمين جدد لديهم نيّة شراء مشابهة أو أقوى حتى تتمكّن من العثور على إحالات ناجحة على مستوى "شبكة البحث" و"الشبكة الإعلانية" و"الفيديو" وغير ذلك.

تمثيل JSON 
{
  "resourceName": string,
  "assetGroup": string,

  // Union field signal can be only one of the following:
  "audience": {
    object (AudienceInfo)
  }
  // End of list of possible types for union field signal.
}
الحقول
resourceName

string

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

customers/{customerId}/assetGroupSignals/{asset_group_id}~{signal_id}
assetGroup

string

مجموعة مواد العرض التي تنتمي إليها إشارة مجموعة مواد العرض هذه.
حقل الربط signal إشارة مجموعة مواد العرض يمكن أن يكون signal واحدًا فقط مما يلي:
audience

object (AudienceInfo)

إشارة الجمهور التي ستستخدمها "حملة الأداء الأفضل".

AudienceInfo

معيار جمهور

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

string

اسم مورد "الجمهور"

AssetGroupListingGroupFilter

يمثّل AssetGroupListingGroupFilter عقدة شجرة فلتر مجموعة بيانات في مجموعة مواد عرض.

تمثيل JSON 
{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "vertical": enum (ListingGroupFilterVertical),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}
الحقول
resourceName

string

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

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

string

مجموعة مواد العرض التي يُعدّ فلتر مجموعة بيانات مجموعة مواد العرض هذا جزءًا منها.
id

string (int64 format)

رقم تعريف ListingGroupFilter
type

enum (ListingGroupFilterType)

نوع عقدة فلتر مجموعة البيانات
vertical

enum (ListingGroupFilterVertical)

يشير إلى الاتجاه العمودي الذي تمثّله شجرة العقدة الحالية. يجب أن تنتمي جميع العقد في الشجرة نفسها إلى المجال نفسه.
caseValue

object (ListingGroupFilterDimension)

قيمة السمة التي تعمل مجموعة البيانات هذه على تحسين عنصرها الرئيسي. غير محدّد للمجموعة الجذر.
parentListingGroupFilter

string

اسم المورد للقسم الفرعي من مجموعة البيانات الرئيسية. قيمة فارغة لعقدة فلتر مجموعة البيانات الأساسية
path

object (ListingGroupFilterDimensionPath)

مسار السمات التي تحدّد فلتر مجموعة البيانات هذا

ListingGroupFilterType

نوع فلتر مجموعة البيانات.

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
SUBDIVISION تقسيم المنتجات إلى مجموعات فرعية حسب بعض سمات البيانات
UNIT_INCLUDED عنصر ورقة فلتر مجموعة بيانات مضمّنة.
UNIT_EXCLUDED عنصر ورقة فلتر مجموعة بيانات مستبعَدة

ListingGroupFilterVertical

نوع الفلتر العمودي لمجموعة البيانات

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

ListingGroupFilterDimension

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

تمثيل JSON 
{

  // Union field dimension can be only one of the following:
  "productBiddingCategory": {
    object (ProductBiddingCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  }
  // End of list of possible types for union field dimension.
}
الحقول
حقل الاتحاد dimension. تكون سمة من أحد الأنواع أدناه متوفّرة دائمًا. يمكن أن يكون dimension واحدًا فقط مما يلي:
productBiddingCategory

object (ProductBiddingCategory)

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

object (ProductBrand)

العلامة التجارية لعرض منتج معيّن
productChannel

object (ProductChannel)

الموقع الجغرافي لعرض المنتج
productCondition

object (ProductCondition)

تمثّل هذه السمة حالة عرض المنتج.
productCustomAttribute

object (ProductCustomAttribute)

سمة مخصّصة لعرض منتج
productItemId

object (ProductItemId)

معرّف السلعة لعرض منتج
productType

object (ProductType)

نوع عرض المنتج

ProductBiddingCategory

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

تمثيل JSON 
{
  "level": enum (ListingGroupFilterBiddingCategoryLevel),
  "id": string
}
الحقول
level

enum (ListingGroupFilterBiddingCategoryLevel)

يشير إلى مستوى الفئة في التصنيف.
id

string (int64 format)

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

هذا المعرّف مكافئ لمعرّف 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

string

قيمة سلسلة العلامة التجارية للمنتج

ProductChannel

الموقع الجغرافي لعرض المنتج

تمثيل JSON 
{
  "channel": enum (ListingGroupFilterProductChannel)
}
الحقول
channel

enum (ListingGroupFilterProductChannel)

قيمة المنطقة المحلية

ListingGroupFilterProductChannel

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

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

ProductCondition

تمثّل هذه السمة حالة عرض المنتج.

تمثيل JSON 
{
  "condition": enum (ListingGroupFilterProductCondition)
}
الحقول
condition

enum (ListingGroupFilterProductCondition)

قيمة الشرط

ListingGroupFilterProductCondition

قائمة أرقام تصف حالة عرض المنتج

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

ProductCustomAttribute

سمة مخصّصة لعرض منتج

تمثيل JSON 
{
  "index": enum (ListingGroupFilterCustomAttributeIndex),
  "value": string
}
الحقول
index

enum (ListingGroupFilterCustomAttributeIndex)

يشير إلى فهرس السمة المخصّصة.
value

string

قيمة السلسلة لسمة المنتج المخصّصة

ListingGroupFilterCustomAttributeIndex

فهرس سمات العملاء

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
INDEX0 السمة المخصّصة لأول فلتر لمجموعة بيانات في مجموعة مواد العرض
INDEX1 السمة المخصّصة لفلتر مجموعة البيانات الثانية.
INDEX2 السمة المخصّصة لفلترة مجموعة البيانات الثالثة
INDEX3 السمة المخصّصة لفلترة مجموعة البيانات الرابعة
INDEX4 السمة المخصّصة للفلتر الخامس لمجموعة البيانات

ProductItemId

معرّف السلعة لعرض المنتج

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

string

قيمة المعرّف

ProductType

نوع عرض المنتج

تمثيل JSON 
{
  "level": enum (ListingGroupFilterProductTypeLevel),
  "value": string
}
الحقول
level

enum (ListingGroupFilterProductTypeLevel)

مستوى النوع.
value

string

قيمة النوع.

ListingGroupFilterProductTypeLevel

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

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
LEVEL1 المستوى 1:
LEVEL2 المستوى 2:
LEVEL3 المستوى 3:
LEVEL4 المستوى 4:
LEVEL5 المستوى 5.

ListingGroupFilterDimensionPath

مسار تحديد السمات التي تحدّد فلتر مجموعة البيانات

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

object (ListingGroupFilterDimension)

المسار الكامل للأبعاد من خلال التسلسل الهرمي لفلترة مجموعة البيانات (باستثناء العقدة الجذر) إلى فلتر مجموعة البيانات هذا.

AssetGroupTopCombinationView

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

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

string

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

object (AssetGroupAssetCombinationData)

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

AssetGroupAssetCombinationData

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

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

object (AssetUsage)

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

AssetUsage

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

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

string

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

enum (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 تم استخدام مادة العرض في عنوان طويل (مستخدَم في MultiAssetAnswerAd).
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 تم استخدام مادة العرض كصورة تسويقية رأسية.
CALL_TO_ACTION تم استخدام مادة العرض كعبارة تحثّ على اتّخاذ إجراء.
YOU_TUBE_VIDEO تم استخدام مادة العرض كفيديو على YouTube.
CALL يتم استخدام مادة العرض هذه كطلب.
MOBILE_APP يتم استخدام مادة العرض هذه كتطبيق متوافق مع الأجهزة الجوّالة.
CALLOUT يتم استخدام مادة العرض هذه كوسيط شرح.
STRUCTURED_SNIPPET يتم استخدام مادة العرض هذه كمقتطف من الموقع.
PRICE يتم استخدام مادة العرض هذه كسعر.
PROMOTION يتم استخدام مادة العرض هذه كعرض ترويجي.
AD_IMAGE يتم استخدام مادة العرض هذه كصورة.
LEAD_FORM تُستخدَم مادة العرض كنموذج عملاء محتملين.

AssetGroup

مجموعة مواد عرض يتم استخدام AssetGroupAsset لربط مادة عرض بمجموعة مواد العرض. تُستخدَم AssetGroupSignal لربط إشارة بمجموعة مواد عرض.

تمثيل JSON 
{
  "resourceName": string,
  "id": string,
  "campaign": string,
  "name": string,
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "status": enum (AssetGroupStatus),
  "path1": string,
  "path2": string,
  "adStrength": enum (AdStrength)
}
الحقول
resourceName

string

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

customers/{customerId}/assetGroups/{asset_group_id}
id

string (int64 format)

رقم تعريف مجموعة مواد العرض.
campaign

string

الحملة المرتبطة بمجموعة مواد العرض هذه. مادة العرض المرتبطة بمجموعة مواد العرض
name

string

مطلوب. اسم مجموعة مواد العرض. مطلوب. يجب أن يكون الحد الأدنى للطول 1 والحد الأقصى للطول هو 128. يجب أن يكون فريدًا ضمن حملة.
finalUrls[]

string

قائمة بعناوين URL النهائية بعد جميع عمليات إعادة التوجيه على جميع النطاقات في "حملات الأداء الأفضل"، تكون عناوين URL مؤهّلة للتوسيع تلقائيًا ما لم يتم إيقافها.
finalMobileUrls[]

string

قائمة بعناوين URL النهائية للأجهزة الجوّالة بعد جميع عمليات إعادة التوجيه عبر النطاقات. في "حملات الأداء الأفضل"، تكون عناوين URL مؤهّلة للتوسّع تلقائيًا ما لم يتم إيقاف هذه الميزة.
status

enum (AssetGroupStatus)

حالة مجموعة مواد العرض.
path1

string

الجزء الأول من النص الذي قد يظهر مرفقًا بعنوان URL المعروض في الإعلان.
path2

string

الجزء الثاني من النص الذي قد يظهر مرفقًا بعنوان URL المعروض في الإعلان. لا يمكن ضبط هذا الحقل إلا عند ضبط path1.
adStrength

enum (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 (AssetSetAssetStatus)
}
الحقول
resourceName

string

اسم مصدر مادة عرض مجموعة مواد العرض يكون لأسماء موارد مواد عرض مجموعة مواد العرض التنسيق التالي:

customers/{customerId}/assetSetAssets/{asset_set_id}~{assetId}
assetSet

string

مجموعة مواد العرض التي ترتبط بها مادة عرض مجموعة مواد العرض هذه.
asset

string

مادة العرض التي ترتبط بها مادة عرض مجموعة مواد العرض هذه.
status

enum (AssetSetAssetStatus)

حالة مادة عرض مجموعة مواد العرض للقراءة فقط.

AssetSetAssetStatus

الحالات المحتمَلة لمادة عرض مجموعة مواد العرض

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

AssetSet

مجموعة مواد عرض تمثّل مجموعة من مواد العرض استخدِم AssetSetAsset لربط مادة عرض بمجموعة مواد العرض.

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

string (int64 format)

رقم تعريف مجموعة مواد العرض.
resourceName

string

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

customers/{customerId}/assetSets/{asset_set_id}

BiddingStrategy

استراتيجية عروض أسعار

تمثيل JSON 
{
  "resourceName": string,
  "status": enum (BiddingStrategyStatus),
  "type": enum (BiddingStrategyType),
  "currencyCode": string,
  "id": string,
  "name": string,
  "effectiveCurrencyCode": string,
  "campaignCount": string,
  "nonRemovedCampaignCount": string,

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

string

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

customers/{customerId}/biddingStrategies/{bidding_strategy_id}
status

enum (BiddingStrategyStatus)

حالة استراتيجية عروض الأسعار.

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

enum (BiddingStrategyType)

نوع استراتيجية عروض الأسعار. إنشاء استراتيجية عروض أسعار من خلال ضبط نظام عروض الأسعار.

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

string

العملة المستخدَمة في استراتيجية عروض الأسعار (رمز مكوّن من ثلاثة أحرف وفقًا لمعيار ISO 4217)

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

string (int64 format)

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

string

اسم استراتيجية عروض الأسعار. يجب تسمية جميع استراتيجيات عروض الأسعار في الحساب بشكلٍ مميز.

يجب أن يتراوح طول هذه السلسلة بين 1 و255، بما في ذلك، بوحدات بت UTF-8 (مقتطعة).
effectiveCurrencyCode

string

العملة المستخدَمة في استراتيجية عروض الأسعار (رمز مكوّن من ثلاثة أحرف وفقًا لمعيار ISO 4217)

بالنسبة إلى استراتيجيات عروض الأسعار في حسابات العملاء المدرَجين، هذه هي العملة التي ضبطها المعلِن عند إنشاء الاستراتيجية. بالنسبة إلى العملاء، هذا هو currencyCode للعميل.

يتمّ عرض مقاييس استراتيجية عروض الأسعار بهذه العملة.

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

string (int64 format)

عدد الحملات المرفقة باستراتيجية عروض الأسعار هذه.

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

string (int64 format)

عدد الحملات غير المُزالة والمُرفَقة باستراتيجية عروض الأسعار هذه.

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

حقل الربط scheme مخطّط عروض الأسعار

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

object (EnhancedCpc)

استراتيجية عروض أسعار ترفع عروض الأسعار للنقرات التي يزداد احتمال أن تؤدي إلى إحالة ناجحة وتخفضها للنقرات التي يقلّ احتمال أن تؤدي إلى إحالة ناجحة.
maximizeConversionValue

object (MaximizeConversionValue)

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

object (MaximizeConversions)

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

object (TargetCpa)

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

object (TargetImpressionShare)

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

object (TargetOutrankShare)

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

object (TargetRoas)

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

object (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

لا يتضمّن هذا النوع أيّ حقول.

استراتيجية عروض أسعار مبرمَجة ترفع عروض الأسعار للنقرات التي يزداد احتمال أن تؤدي إلى إحالة ناجحة، وتخفضها للنقرات التي يقل احتمال أن تؤدي إلى إحالات ناجحة.

تم إيقاف استراتيجية عروض الأسعار هذه نهائيًا ولا يمكن إنشاؤها بعد ذلك. استخدِم ManualCpc مع ضبط enhancedCpcEnabled على true للحصول على وظيفة مماثلة.

MaximizeConversionValue

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

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

string (int64 format)

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

string (int64 format)

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

number

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

MaximizeConversions

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

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

TargetCpa

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

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

TargetImpressionShare

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

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

enum (TargetImpressionShareLocation)

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

string (int64 format)

الجزء المحدّد من الإعلانات التي سيتم عرضها في الموقع الجغرافي المستهدَف بالميكرو على سبيل المثال، %1 تساوي 10,000.
cpcBidCeilingMicros

string (int64 format)

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

TargetImpressionShareLocation

يصف التعداد الأهداف المحتملة.

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
ANYWHERE_ON_PAGE أيّ موقع على صفحة الويب
TOP_OF_PAGE أعلى مربّع الإعلانات
ABSOLUTE_TOP_OF_PAGE الشريحة العلوية في المربّع العلوي من الإعلانات

TargetOutrankShare

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

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

string (Int64Value format)

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

TargetRoas

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

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

number

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

string (int64 format)

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

string (int64 format)

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

TargetSpend

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

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

string (int64 format)

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

string (int64 format)

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

CampaignBudget

ميزانية حملة

تمثيل JSON 
{
  "resourceName": string,
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "amountMicros": string
}
الحقول
resourceName

string

اسم المورد لميزانية الحملة. تكون أسماء موارد ميزانية الحملة على النحو التالي:

customers/{customerId}/campaignBudgets/{campaign_budget_id}
deliveryMethod

enum (BudgetDeliveryMethod)

طريقة العرض التي تحدّد معدّل إنفاق ميزانية الحملة

يتم ضبط القيمة تلقائيًا على STANDARD في حال عدم تحديدها في عملية إنشاء.
period

enum (BudgetPeriod)

الفترة التي يتم خلالها إنفاق الميزانية. يتم ضبط القيمة تلقائيًا على DAILY في حال عدم تحديدها.
amountMicros

string (int64 format)

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

BudgetDeliveryMethod

طرق العرض المحتمَلة للميزانية

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

BudgetPeriod

الفترة المحتملة للميزانية.

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
DAILY الميزانية اليومية.
FIXED_DAILY ميزانية يومية ثابتة
CUSTOM_PERIOD يمكن استخدام الميزانية المخصّصة مع total_amount لتحديد حدّ الميزانية منذ الإنشاء.

الحملة

حملة.

تمثيل JSON 
{
  "resourceName": string,
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "effectiveLabels": [
    string
  ],
  "labels": [
    string
  ],
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "engineId": string,
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "createTime": string,
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "campaignBudget": string,
  "startDate": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "urlExpansionOptOut": boolean,

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  },
  "percentCpc": {
    object (PercentCpc)
  },
  "targetCpm": {
    object (TargetCpm)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
الحقول
resourceName

string

اسم مورد الحملة. تكون أسماء موارد الحملات على النحو التالي:

customers/{customerId}/campaigns/{campaign_id}
status

enum (CampaignStatus)

حالة الحملة.

عند إضافة حملة جديدة، تكون الحالة التلقائية هي "مفعّلة".
servingStatus

enum (CampaignServingStatus)

حالة عرض الإعلانات للحملة.
biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

حالة النظام لاستراتيجية عروض أسعار الحملة.
adServingOptimizationStatus

enum (AdServingOptimizationStatus)

حالة تحسين عرض الإعلانات للحملة.
advertisingChannelType

enum (AdvertisingChannelType)

استهداف العرض الأساسي للإعلانات ضمن الحملة. يمكن تحسين خيارات الاستهداف في networkSettings.

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

لا يمكن ضبطها إلا عند إنشاء الحملات. ولا يمكن تغيير الحقل بعد إنشاء الحملة.
advertisingChannelSubType

enum (AdvertisingChannelSubType)

تحسين اختياري إلى advertisingChannelType يجب أن يكون نوعًا فرعيًا صالحًا لنوع القناة الرئيسي.

لا يمكن ضبطها إلا عند إنشاء الحملات. بعد إنشاء الحملة، لا يمكن تغيير الحقل.
urlCustomParameters[]

object (CustomParameter)

قائمة عمليات الربط المستخدَمة لاستبدال علامات المَعلمات المخصّصة في trackingUrlTemplate أو finalUrls أو mobile_final_urls
realTimeBiddingSetting

object (RealTimeBiddingSetting)

إعدادات عروض الأسعار في الوقت الفعلي، وهي ميزة لا تتوفّر إلا للحملات التي تستهدِف شبكة Ad Exchange.
networkSettings

object (NetworkSettings)

إعدادات الشبكة للحملة.
dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

الإعداد للتحكّم في الإعلانات الديناميكية على شبكة البحث
shoppingSetting

object (ShoppingSetting)

الإعداد للتحكّم في "حملات Shopping"
geoTargetTypeSetting

object (GeoTargetTypeSetting)

إعداد الاستهداف الجغرافي للإعلانات
effectiveLabels[]

string

أسماء مصادر التصنيفات الفعّالة المرفقة بهذه الحملة التصنيف الفعّال هو تصنيف مكتسَب أو تمّ تعيينه مباشرةً لهذه الحملة.
labels[]

string

أسماء مصادر التصنيفات المرفقة بهذه الحملة.
biddingStrategyType

enum (BiddingStrategyType)

نوع استراتيجية عروض الأسعار.

يمكن إنشاء استراتيجية عروض أسعار من خلال ضبط نظام عروض الأسعار لإنشاء استراتيجية عروض أسعار عادية أو حقل biddingStrategy لإنشاء استراتيجية محفظة لعروض الأسعار.

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

string

اسم المورد لاستراتيجية الوصول إلى عروض الأسعار، وهو عرض للقراءة فقط للسمات غير المحظورة ضمن استراتيجية المحفظة لعروض الأسعار المرفقة التي تم تحديدها من خلال استراتيجية عروض الأسعار "عروض الأسعار". فارغ، إذا كانت الحملة لا تستخدم استراتيجية محفظة تتوفّر سمات الاستراتيجية غير المشروطة لجميع العملاء الذين تتم مشاركة الاستراتيجية معهم ويتم قراءتها من مورد AccessibleBiddingStrategy. في المقابل، لا تتوفّر السمات المحظورة إلا لمالك الاستراتيجية ومدراءه. لا يمكن قراءة السمات المحظورة إلا من مورد BiddingStrategy.
frequencyCaps[]

object (FrequencyCapEntry)

قائمة تحدّ من عدد مرّات ظهور إعلانات هذه الحملة لكلّ مستخدِم
selectiveOptimization

object (SelectiveOptimization)

إعداد التحسين الانتقائي لهذه الحملة، والذي يتضمّن مجموعة من إجراءات الإحالات الناجحة لتحسين هذه الحملة من أجلها لا تنطبق هذه الميزة إلا على حملات التطبيقات التي تستخدم MULTI_CHANNEL على أنّها AdvertisingChannelType وAPP_CAMPAIGN أو APP_CAMPAIGN_FOR_ENGAGEMENT بصفتها AdvertisingChannelSubType.
optimizationGoalSetting

object (OptimizationGoalSetting)

إعداد هدف التحسين لهذه الحملة، والذي يتضمّن مجموعة من أنواع أهداف التحسين
trackingSetting

object (TrackingSetting)

الإعدادات على مستوى الحملة لمعلومات التتبّع
engineId

string

رقم تعريف الحملة في حساب محرّك البحث الخارجي هذا الحقل مخصّص للحسابات غير التابعة لخدمة "إعلانات Google" فقط، مثل Yahoo! Japan وMicrosoft وBaidu وما إلى ذلك. بالنسبة إلى الكيانات في "إعلانات Google"، استخدِم "campaign.id" بدلاً من ذلك.
excludedParentAssetFieldTypes[]

enum (AssetFieldType)

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

string

الطابع الزمني لوقت إنشاء هذه الحملة. يتم عرض الطابع الزمني بالتنسيق yyyy-MM-dd HH:mm:ss في المنطقة الزمنية للعميل. سيتم إيقاف createTime نهائيًا في الإصدار 1. استخدِم createTime بدلاً من ذلك.
creationTime

string

الطابع الزمني لوقت إنشاء هذه الحملة. يكون الطابع الزمني بالتنسيق yyyy-MM-dd HH:mm:ss وحسب المنطقة الزمنية للعميل.
lastModifiedTime

string

التاريخ والوقت الذي تم فيه إجراء آخر تعديل على هذه الحملة. يكون التاريخ والوقت في المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss.ssssss".
id

string (int64 format)

رقم تعريف الحملة.
name

string

اسم الحملة.

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

يجب ألا يحتوي على أي أحرف فارغة (نقطة رمز 0x0) أو خلاصة سطر غير مكتوب (نقطة رمز 0xA) أو أحرف رجوع إلى أول السطر (نقطة الرمز 0xD).
trackingUrlTemplate

string

نموذج عنوان URL لإنشاء عنوان URL للتتبّع
campaignBudget

string

اسم المورد لميزانية الحملة.
startDate

string

تاريخ بدء عرض الحملة في المنطقة الزمنية للعميل بالتنسيق YYYY-MM-DD
endDate

string

اليوم الأخير من الحملة في عرض المنطقة الزمنية للعميل بالتنسيق YYYY-MM-DD. عند الإنشاء، يتم الضبط تلقائيًا على 2037-12-30، ما يعني أنّ الحملة ستستمر إلى أجل غير مسمى. لضبط حملة حالية على عرض الإعلانات إلى أجل غير مسمى، اضبط هذا الحقل على ‎30-12-2037.
finalUrlSuffix

string

اللاحقة المستخدَمة لإلحاق مَعلمات طلبات البحث بالصفحات المقصودة التي يتم عرضها باستخدام التتبّع الموازي
urlExpansionOptOut

boolean

يمثّل إيقاف توسيع نطاق عنوان URL لعناوين URL أكثر استهدافًا. في حال إيقاف الميزة (true)، يتم استهداف عناوين URL النهائية فقط في مجموعة مواد العرض أو عناوين URL المحدّدة في خلاصات بيانات النشاط التجاري أو Google Merchant Center للمعلِن. في حال تفعيل الميزة (خطأ)، سيتم استهداف النطاق بأكمله. لا يمكن ضبط هذا الحقل إلّا في "حملات الأداء الأفضل"، حيث تكون القيمة التلقائية هي false.

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

يجب أن تكون إما مخصّصة للمحفظة (تم إنشاؤها من خلال خدمة BiddingStrategy) أو عادية، ومضمّنة في الحملة. يمكن أن يكون campaign_bidding_strategy واحدًا فقط مما يلي:
biddingStrategy

string

اسم مصدر استراتيجية عروض أسعار المحفظة المستخدَمة من قِبل الحملة.
manualCpa

object (ManualCpa)

استراتيجية عروض الأسعار اليدوية العادية للتكلفة المستهدَفة للإجراء استراتيجية عروض الأسعار اليدوية التي تسمح للمعلِن بتحديد عرض السعر لكل إجراء يحدده المعلِن. لا تتوفّر هذه الميزة إلا لحملات "الخدمات المحلّية".
manualCpc

object (ManualCpc)

استراتيجية عروض أسعار تكلفة النقرة اليدوية العادية عروض الأسعار اليدوية المستندة إلى النقرات التي يدفع فيها المستخدِم لكل نقرة
manualCpm

object (ManualCpm)

استراتيجية عروض الأسعار اليدوية العادية استنادًا إلى التكلفة لكلّ ألف ظهور عروض أسعار يدوية مستندة إلى مرّات الظهور يدفع فيها المستخدِم لكلّ ألف مرّة ظهور.
maximizeConversions

object (MaximizeConversions)

استراتيجية عروض أسعار "تحقيق الحد الأقصى من الإحالات الناجحة" العادية التي تحقّق تلقائيًا الحد الأقصى لعدد الإحالات الناجحة في حدود ميزانيتك.
maximizeConversionValue

object (MaximizeConversionValue)

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

object (TargetCpa)

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

object (TargetImpressionShare)

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

object (TargetRoas)

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

object (TargetSpend)

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

object (PercentCpc)

استراتيجية عروض الأسعار العادية للنسبة المئوية لتكلفة النقرة، حيث تكون عروض الأسعار جزءًا من السعر المُعلَن عنه لبعض السلع أو الخدمات.
targetCpm

object (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 الذكية"
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 يتم عرض "حملات التسوّق" على موقع Shopping وعلى نتائج البحث على google.com.
HOTEL حملات إعلانات الفنادق
VIDEO حملات الفيديو
MULTI_CHANNEL "حملات التطبيقات" و"حملات التطبيقات لجذب المستخدمين الحاليين" التي يتم عرضها على قنوات متعدّدة
LOCAL الحملات الإعلانية المحلية:
SMART الحملات الذكية
PERFORMANCE_MAX "حملات الأداء الأفضل"
LOCAL_SERVICES الحملات المحلية
DISCOVERY الحملات أثناء التصفّح
TRAVEL حملات السفر:
SOCIAL حملات الشبكات الاجتماعية

AdvertisingChannelSubType

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

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN تُستخدَم كقيمة معروضة فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
SEARCH_MOBILE_APP حملات تطبيقات الأجهزة الجوّالة في شبكة البحث.
DISPLAY_MOBILE_APP "حملات تطبيقات الأجهزة الجوّالة" على "شبكة Google الإعلانية"
SEARCH_EXPRESS حملات AdWords Express على شبكة البحث
DISPLAY_EXPRESS حملات AdWords Express للشبكة الإعلانية
SHOPPING_SMART_ADS حملات Shopping الذكية:
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 و"شبكة Google الإعلانية".
VIDEO_REACH_TARGET_FREQUENCY "حملة فيديو تركّز على الوصول إلى الجمهور" مع استراتيجية عروض أسعار "عدد مرّات الظهور المستهدَف"
TRAVEL_ACTIVITIES حملات الأنشطة السياحية
SOCIAL_FACEBOOK_TRACKING_ONLY يتتبع Facebook حملات الشبكات الاجتماعية فقط.

CustomParameter

تعيين يمكن أن تستخدمه علامات المَعلمات المخصّصة في trackingUrlTemplate أو finalUrls أو mobile_final_urls.

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

string

المفتاح الذي يطابق اسم علامة المعلمة.
value

string

القيمة التي سيتم استبدالها.

RealTimeBiddingSetting

إعدادات عروض الأسعار في الوقت الفعلي، وهي ميزة لا تتوفّر إلا للحملات التي تستهدِف شبكة Ad Exchange.

تمثيل JSON 
{
  "optIn": boolean
}
الحقول
optIn

boolean

ما إذا كانت الحملة قد فعّلت ميزة عروض الأسعار في الوقت الفعلي أم لا.

NetworkSettings

إعدادات الشبكة للحملة.

تمثيل JSON 
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean
}
الحقول
targetSearchNetwork

boolean

ما إذا كان سيتم عرض الإعلانات على المواقع الإلكترونية للشركاء في "شبكة بحث Google" (يتطلب ذلك ضبط targetGoogleSearch على true أيضًا)
targetContentNetwork

boolean

ما إذا كان سيتم عرض الإعلانات في مواضع إعلان محدّدة في "شبكة Google الإعلانية" يتم تحديد مواضع الإعلانات باستخدام معيار "موضع الإعلان".
targetPartnerSearchNetwork

boolean

ما إذا كان سيتم عرض الإعلانات على "شبكة شركاء Google" لا يتوفّر هذا الخيار إلا لبعض حسابات شركاء Google المحدّدة.

DynamicSearchAdsSetting

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

تمثيل JSON 
{
  "domainName": string,
  "languageCode": string,
  "useSuppliedUrlsOnly": boolean
}
الحقول
domainName

string

مطلوب. اسم نطاق الإنترنت الذي يمثّله هذا الإعداد، على سبيل المثال، "google.com" أو "www.google.com".
languageCode

string

مطلوب. رمز اللغة الذي يحدد لغة النطاق، على سبيل المثال "en".
useSuppliedUrlsOnly

boolean

ما إذا كانت الحملة تستخدم عناوين URL التي يقدّمها المعلِن بشكلٍ حصري.

ShoppingSetting

إعداد حملات Shopping. يحدِّد نطاق المنتجات التي يمكن للحملة الإعلان عنها، وكيفية تفاعل هذه الحملة مع "حملات Shopping" الأخرى.

تمثيل JSON 
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "merchantId": string,
  "salesCountry": string,
  "campaignPriority": integer,
  "enableLocal": boolean
}
الحقول
feedLabel

string

تصنيف الخلاصة للمنتجات المطلوب تضمينها في الحملة لا يمكن ضبط سوى حقل واحد من حقلَي feedLabel أو salesCountry. في حال استخدامه بدلاً من salesCountry، يقبل الحقل feedLabel رموز البلدان بالتنسيق نفسه، على سبيل المثال: ‎"XX". أمّا إذا لم يكن الأمر كذلك، فيمكن أن تكون أي سلسلة تستخدمها لتصنيف الخلاصة في Google Merchant Center.
useVehicleInventory

boolean

ما إذا كان سيتم استهداف مستودع بيانات المركبات
merchantId

string (int64 format)

رقم تعريف حساب Merchant Center هذا الحقل مطلوب لعمليات الإنشاء. هذا الحقل غير قابل للتغيير لحملات التسوّق.
salesCountry

string

بلد بيع المنتجات المطلوب تضمينها في الحملة.
campaignPriority

integer

أولوية الحملة. وتحظى الحملات ذات الأولوية الأعلى عدديًا بالأولوية على الحملات ذات الأولوية الأقل. هذا الحقل مطلوب لحملات التسوّق، ذات القيم بين 0 و2، بشكل شامل. هذا الحقل اختياري في "حملات Shopping الذكية"، ولكن يجب أن يكون مساويًا لـ 3 في حال ضبطه.
enableLocal

boolean

تحديد ما إذا كان سيتم تضمين المنتجات المحلية.

GeoTargetTypeSetting

يمثل هذا الإعداد مجموعة من الإعدادات ذات الصلة بالاستهداف الجغرافي للإعلانات.

تمثيل JSON 
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
الحقول
positiveGeoTargetType

enum (PositiveGeoTargetType)

الإعداد المستخدَم للاستهداف الجغرافي الإيجابي في هذه الحملة المحدّدة.
negativeGeoTargetType

enum (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[]

string

المجموعة المحدّدة من أسماء الموارد لإجراءات الإحالات الناجحة لتحسين هذه الحملة.

OptimizationGoalSetting

إعداد هدف التحسين لهذه الحملة، والذي يتضمّن مجموعة من أنواع أهداف التحسين

تمثيل JSON 
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
الحقول
optimizationGoalTypes[]

enum (OptimizationGoalType)

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

OptimizationGoalType

نوع هدف التحسين

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN تُستخدَم كقيمة معروضة فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
CALL_CLICKS تحسين النقرات التي تؤدّي إلى إجراء مكالمات الإحالات الناجحة الناتجة عن النقر على إعلان للاتصال هي عدد المرّات التي اختار فيها المستخدمون "الاتصال" للتواصل مع متجر بعد مشاهدة إعلان.
DRIVING_DIRECTIONS تحسين المحتوى لعرض اتجاهات القيادة الإحالات الناجحة لاتجاهات القيادة هي المرات التي اختار فيها الأشخاص "الحصول على الاتجاهات" للانتقال إلى متجر بعد عرض إعلان.
APP_PRE_REGISTRATION تحسين الأداء لزيادة التسجيلات المُسبَقة الإحالات الناجحة للتسجيل المُسبَق هي عدد عمليات الاشتراك في التسجيل المُسبَق لتلقّي إشعار عند إطلاق التطبيق.

TrackingSetting

الإعدادات على مستوى الحملة لمعلومات التتبّع

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

string

عنوان URL المستخدَم للتتبّع الديناميكي.

ManualCpa

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

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

ManualCpc

عروض الأسعار اليدوية المستندة إلى النقرات التي يدفع فيها المستخدِم لكل نقرة

تمثيل JSON 
{
  "enhancedCpcEnabled": boolean
}
الحقول
enhancedCpcEnabled

boolean

ما إذا كان سيتم تحسين عروض الأسعار استنادًا إلى بيانات "مُحسِّن الإحالات الناجحة"

ManualCpm

لا يتضمّن هذا النوع أيّ حقول.

عروض أسعار يدوية مستندة إلى مرّات الظهور يدفع فيها المستخدِم لكلّ ألف مرّة ظهور.

PercentCpc

استراتيجية عروض أسعار تكون فيها عروض الأسعار جزءًا من السعر المعلَن لبعض السلع أو الخدمات.

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

string (int64 format)

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

boolean

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

TargetCpm

لا يتضمّن هذا النوع أيّ حقول.

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

CampaignAsset

رابط بين حملة ومادة عرض

تمثيل JSON 
{
  "resourceName": string,
  "status": enum (AssetLinkStatus),
  "campaign": string,
  "asset": string
}
الحقول
resourceName

string

اسم مصدر مادة عرض الحملة. يكون لأسماء موارد CampaignAsset الشكل التالي:

customers/{customerId}/campaignAssets/{campaign_id}~{assetId}~{fieldType}
status

enum (AssetLinkStatus)

حالة مادة عرض الحملة.
campaign

string

الحملة المرتبطة بمادة العرض.
asset

string

مادة العرض المرتبطة بالحملة.

CampaignAssetSet

CampaignAssetSet هو الرابط بين حملة ومجموعة مواد عرض. تؤدي إضافة CampaignAssetSet إلى ربط مجموعة مواد عرض بحملة.

تمثيل JSON 
{
  "resourceName": string,
  "campaign": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
الحقول
resourceName

string

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

customers/{customerId}/campaignAssetSets/{campaign_id}~{asset_set_id}
campaign

string

الحملة التي ترتبط بها مجموعة مواد العرض هذه.
assetSet

string

مجموعة مواد العرض المرتبطة بالحملة
status

enum (AssetSetLinkStatus)

حالة مادة عرض مجموعة مواد عرض الحملة. للقراءة فقط.

CampaignAudienceView

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

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

string

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

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

CampaignCriterion

معيار حملة

تمثيل JSON 
{
  "resourceName": string,
  "displayName": string,
  "type": enum (CriterionType),
  "status": enum (CampaignCriterionStatus),
  "lastModifiedTime": string,
  "criterionId": string,
  "bidModifier": number,
  "negative": boolean,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "device": {
    object (DeviceInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "language": {
    object (LanguageInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "locationGroup": {
    object (LocationGroupInfo)
  }
  // End of list of possible types for union field criterion.
}
الحقول
resourceName

string

اسم المورد لمعيار الحملة. تكون أسماء موارد معايير الحملة على النحو التالي:

customers/{customerId}/campaignCriteria/{campaign_id}~{criterionId}
displayName

string

الاسم المعروض للمعيار

يتم تجاهل هذا الحقل في عمليات التعديل.
type

enum (CriterionType)

تمثّل هذه السمة نوع المعيار.
status

enum (CampaignCriterionStatus)

حالة المعيار
lastModifiedTime

string

التاريخ والوقت اللذان تمّ فيهما إجراء آخر تعديل على معيار الحملة هذا. يتم عرض التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss.ssssss".
criterionId

string (int64 format)

رقم تعريف المعيار.

يتم تجاهل هذا الحقل أثناء عملية التغيير.
bidModifier

number

معدِّل عروض الأسعار عند مطابقة المعيار. يجب أن يكون المُعدِّل في النطاق: 0.1 - 10.0. تتوافق معظم أنواع المعايير التي يمكن استهدافها مع المُعدِّلات. استخدِم القيمة 0 لإيقاف نوع جهاز.
negative

boolean

ما إذا كان سيتم استهداف المعيار (false) أو استبعاده (true)

حقل الربط criterion معيار الحملة.

يجب تحديد قيمة واحدة فقط. يمكن أن يكون criterion واحدًا فقط مما يلي:
keyword

object (KeywordInfo)

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

object (LocationInfo)

الموقع الجغرافي.
device

object (DeviceInfo)

الجهاز.
ageRange

object (AgeRangeInfo)

الفئة العمرية
gender

object (GenderInfo)

الجنس
userList

object (UserListInfo)

قائمة المستخدمين
language

object (LanguageInfo)

اللغة
webpage

object (WebpageInfo)

صفحة ويب.
locationGroup

object (LocationGroupInfo)

مجموعة المواقع الجغرافية

CampaignCriterionStatus

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

عمليات التعداد
UNSPECIFIED لم يتم تحديد أي قيمة.
UNKNOWN

القيمة المستلَمة غير معروفة في هذا الإصدار.

هذه قيمة للردّ فقط.
ENABLED تم تفعيل معيار الحملة.
PAUSED تم إيقاف معيار الحملة مؤقتًا.
REMOVED تتم إزالة معيار الحملة.

LanguageInfo

معيار اللغة

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

string

اسم المورد الثابت اللغة.

LocationGroupInfo

نطاق جغرافي حول قائمة بالمواقع الجغرافية المحدّدة من خلال خلاصة

تمثيل JSON 
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "radius": string
}
الحقول
geoTargetConstants[]

string

تمثّل هذه السمة ثوابت الاستهداف الجغرافي التي تفرض قيودًا على نطاق المنطقة الجغرافية ضمن الخلاصة. يُسمح حاليًا بمتغيّر ثابت واحد فقط للموقع الجغرافي المستهدَف.
radiusUnits

enum (LocationGroupRadiusUnits)

وحدة النطاق الجغرافي. يمكن استخدام الأميال والمتر في الثابتات المتعلّقة بالموقع الجغرافي المستهدَف. يمكن استخدام وحدات المليميال والمتر لمجموعات عناصر الخلاصة. هذا الإجراء مطلوب ويجب ضبطه في عمليات CREATE.
feedItemSets[]

string

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

string (int64 format)

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

LocationGroupRadiusUnits

وحدة قياس المسافة في النطاق الجغرافي ضمن مجموعة المواقع الجغرافية (مثل MILES)

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

CampaignEffectiveLabel

تمثّل هذه السمة علاقة بين حملة وعلامة فعّالة. التصنيف الفعّال هو تصنيف مكتسَب أو تمّ تعيينه مباشرةً لهذه الحملة.

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

string

اسم المورد تكون أسماء موارد CampaignEffectivelabel على النحو التالي: customers/{customerId}/campaignEffectiveLabels/{campaign_id}~{label_id}
campaign

string

الحملة التي تم إرفاق التصنيف الفعّال بها.
label

string

التصنيف الفعال الذي تم تعيينه للحملة.
ownerCustomerId

string (int64 format)

رقم تعريف العميل الذي يملك التصنيف الفعّال.

CampaignLabel

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

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

string

اسم المورد تكون أسماء مصادر تصنيفات الحملات على النحو التالي: customers/{customerId}/campaignLabels/{campaign_id}~{label_id}
campaign

string

الحملة التي تم إرفاق التصنيف بها.
label

string

التصنيف الذي تمّ تعيينه للحملة.
ownerCustomerId

string (int64 format)

رقم تعريف العميل الذي يملك التصنيف.

CartDataSalesView

عرض المبيعات استنادًا إلى بيانات سلة التسوّق

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

string

اسم المورد لعرض مبيعات بيانات سلة التسوّق. يكون شكل أسماء موارد عرض مبيعات بيانات سلة التسوّق على النحو التالي: customers/{customerId}/cartDataSalesView

الجمهور

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

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

string

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

customers/{customerId}/audiences/{audience_id}
id

string (int64 format)

رقم تعريف شريحة الجمهور
name

string

مطلوب. اسم شريحة الجمهور. يجب أن يكون فريدًا على مستوى جميع شرائح الجمهور. يجب ألا يقلّ طولها عن 1 حرف وألا يزيد عن 255 حرفًا.
description

string

وصف هذا الجمهور

ConversionAction

إجراء إحالة ناجحة

تمثيل JSON 
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "floodlightSettings": {
    object (FloodlightSettings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInClientAccountConversionsMetric": boolean,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "appId": string
}
الحقول
resourceName

string

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

customers/{customerId}/conversionActions/{conversion_action_id}
creationTime

string

الطابع الزمني لإنشاء نشاط Floodlight، بتنسيق ISO 8601
status

enum (ConversionActionStatus)

حالة إجراء الإحالة الناجحة هذا لتجميع أحداث الإحالات الناجحة.
type

enum (ConversionActionType)

نوع إجراء الإحالة الناجحة هذا.
category

enum (ConversionActionCategory)

فئة الإحالات الناجحة التي تم الإبلاغ عنها لإجراء الإحالة الناجحة هذا.
valueSettings

object (ValueSettings)

الإعدادات ذات الصلة بقيمة أحداث الإحالات الناجحة المرتبطة بهذا الإجراء
attributionModelSettings

object (AttributionModelSettings)

الإعدادات ذات الصلة بنموذج تحديد المصدر لإجراء الإحالة الناجحة هذا
floodlightSettings

object (FloodlightSettings)

إعدادات Floodlight لأنواع الإحالات الناجحة في Floodlight
id

string (int64 format)

رقم تعريف إجراء الإحالة الناجحة.
name

string

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

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

boolean

إذا كان العنصر primaryForGoal للإجراء إحالة ناجحة غير صحيح، لا يمكن تقديم عروض أسعار للإجراء إحالة ناجحة في جميع الحملات بغض النظر عن هدف الإحالة الناجحة للعميل أو هدف الإحالة الناجحة للحملة. ومع ذلك، لا تراعي أهداف الإحالات الناجحة المخصّصة السمة primaryForGoal، لذا إذا كانت الحملة تتضمّن هدف إحالة ناجحة مخصّصًا تم ضبطه باستخدام إجراء إحالة ناجحة primaryForGoal = false، سيظلّ بإمكانك تقديم عروض أسعار لهذا الإجراء. ستكون primaryForGoal صحيحة تلقائيًا في حال عدم ضبطها. في الإصدار V9، لا يمكن ضبطPrimaryForGoal على "خطأ" إلا بعد الإنشاء من خلال عملية "تحديث" لأنّه لم يتم تعريفها على أنّها اختيارية.
ownerCustomer

string

اسم المورد لعميل مالك إجراء الإحالة الناجحة، أو قيمة خالية إذا كان هذا إجراء إحالة ناجحة من تحديد النظام.
includeInClientAccountConversionsMetric

boolean

ما إذا كان يجب تضمين إجراء الإحالة الناجحة هذا في مقياس "clientAccount اللازمة (الإحالات الناجحة)".
includeInConversionsMetric

boolean

ما إذا كان يجب تضمين إجراء الإحالة الناجحة هذا في مقياس "الإحالات الناجحة".
clickThroughLookbackWindowDays

string (int64 format)

الحدّ الأقصى لعدد الأيام التي قد تمضي بين تفاعل (مثل نقرة) وحدث إحالة ناجحة.
appId

string

رقم تعريف التطبيق لإجراء إحالة ناجحة للتطبيق

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 مكالمة أو رسالة قصيرة أو رسالة إلكترونية أو محادثة أو أيّ نوع آخر من الاتّصال بالمعلِن
ENGAGEMENT حدث تفاعل على الموقع الإلكتروني، مثل قضاء وقت طويل على الموقع الإلكتروني أو هدف ذكي في "إحصاءات Google" يُقصد استخدامها لاستيراد أهداف "إحصاءات Google" وFirebase و"إحصاءات Google" من المستوى الذهبي.
STORE_VISIT زيارة إلى موقع جغرافي لمتجر
STORE_SALE تخفيضات في متجر
QUALIFIED_LEAD إحالة ناجحة لعميل محتمل تمّ استيرادها من مصدر خارجي إلى "إعلانات Google"، وتمّت إضافتها من قِبل المعلِن (فريق التسويق/فريق المبيعات). في رحلة جذب العملاء المحتملين إلى إتمام البيع، يحصل المعلِنون على العملاء المحتملين، ثم ينفّذون إجراءات بشأنهم من خلال التواصل مع المستهلكين. إذا كان المستهلك مهتمًا وقد ينتهى إلى شراء منتجه، يضع المعلِن علامة "عملاء محتمَلين مؤهَّلين" على هذا النوع من العملاء.
CONVERTED_LEAD إحالة ناجحة لعميل محتمل تمّ استيرادها من مصدر خارجي إلى "إعلانات Google"، وأكملت مرحلة محدّدة على النحو الذي حدّده المعلِن الذي ينشئ قوائم العملاء المحتملين.

ValueSettings

الإعدادات ذات الصلة بقيمة أحداث الإحالات الناجحة المرتبطة بهذا الإجراء

تمثيل JSON 
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
الحقول
defaultValue

number

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

string

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

boolean

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

AttributionModelSettings

الإعدادات ذات الصلة بنموذج تحديد المصدر لإجراء الإحالة الناجحة هذا

تمثيل JSON 
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
الحقول
attributionModel

enum (AttributionModel)

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

enum (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

string

سلسلة تُستخدَم لتحديد مجموعة أنشطة Floodlight عند إعداد تقارير عن الإحالات الناجحة
activityTag

string

سلسلة تُستخدَم لتحديد نشاط Floodlight عند إعداد تقارير الإحالات الناجحة.
activityId

string (int64 format)

رقم تعريف نشاط Floodlight في DoubleClick Campaign Manager (DCM)

ConversionCustomVariable

متغيّر مخصّص للإحالة الناجحة اطّلِع على "لمحة عن مقاييس Floodlight وسماته المخصّصة في التجربة الجديدة من "إعلانات شبكة البحث 360" على الرابط https://support.google.com/sa360/answer/13567857.

تمثيل JSON 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "tag": string,
  "status": enum (ConversionCustomVariableStatus),
  "ownerCustomer": string,
  "family": enum (ConversionCustomVariableFamily),
  "cardinality": enum (ConversionCustomVariableCardinality),
  "floodlightConversionCustomVariableInfo": {
    object (FloodlightConversionCustomVariableInfo)
  },
  "customColumnIds": [
    string
  ]
}
الحقول
resourceName

string

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

customers/{customerId}/conversionCustomVariables/{conversion_custom_variable_id}
id

string (int64 format)

رقم تعريف المتغيّر المخصّص للإحالة الناجحة.
name

string

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

string

مطلوب. علامة المتغيّر المخصّص للإحالة الناجحة. يجب أن تكون العلامة فريدة وأن تتكون من حرف "u" متبوعًا برقم أقل من ormequal إلى 100. على سبيل المثال: "u4".
status

enum (ConversionCustomVariableStatus)

حالة المتغيّر المخصّص للإحالة الناجحة لتجميع أحداث الإحالات الناجحة.
ownerCustomer

string

اسم مورد العميل الذي يملك المتغيّر المخصّص للإحالة الناجحة.
family

enum (ConversionCustomVariableFamily)

عائلة المتغيّر المخصّص للإحالة الناجحة.
cardinality

enum (ConversionCustomVariableCardinality)

عدد القيم الفريدة للمتغيّر المخصّص للإحالة الناجحة.
floodlightConversionCustomVariableInfo

object (FloodlightConversionCustomVariableInfo)

حقول المتغيّرات المخصّصة للإحالات الناجحة في Floodlight في "إعلانات شبكة البحث 360"
customColumnIds[]

string (int64 format)

أرقام تعريف الأعمدة المخصّصة التي تستخدم هذا المتغيّر المخصّص للإحالة الناجحة.

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),
  "floodlightVariableDataType": enum (FloodlightVariableDataType)
}
الحقول
floodlightVariableType

enum (FloodlightVariableType)

نوع متغيّر Floodlight المحدَّد في "إعلانات شبكة البحث 360".
floodlightVariableDataType

enum (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 من النوعَين DIMENSION أو METRIC.
STRING ويمثل ذلك متغيّر Floodlight من النوع "سلسلة". يمكن تخصيص هذا المتغيّر لمتغيّرات Floodlight من النوع سمة.

العميل

عميل

تمثيل JSON 
{
  "resourceName": string,
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "accountType": enum (AccountType),
  "doubleClickCampaignManagerSetting": {
    object (DoubleClickCampaignManagerSetting)
  },
  "accountStatus": enum (AccountStatus),
  "lastModifiedTime": string,
  "engineId": string,
  "status": enum (CustomerStatus),
  "creationTime": string,
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "manager": boolean
}
الحقول
resourceName

string

اسم مورد العميل وتكون أسماء موارد العملاء على النحو التالي:

customers/{customerId}
conversionTrackingSetting

object (ConversionTrackingSetting)

إعداد تتبُّع الإحالات الناجحة لعميل.
accountType

enum (AccountType)

نوع حساب محرّك البحث، على سبيل المثال، "إعلانات Google" وMicrosoft Advertising وYahoo Japan وBaidu وFacebook و"حساب تتبُّع محرّكات البحث" وما إلى ذلك
doubleClickCampaignManagerSetting

object (DoubleClickCampaignManagerSetting)

إعدادات DoubleClick Campaign Manager (DCM) لعميل إداري
accountStatus

enum (AccountStatus)

حالة الحساب، على سبيل المثال، مفعَّلة أو متوقفة مؤقتًا أو تمت إزالتها أو غير ذلك
lastModifiedTime

string

التاريخ والوقت الذي تم فيه إجراء آخر تعديل لهذا العميل. يتم عرض التاريخ والوقت حسب المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss.ssssss".
engineId

string

رقم تعريف الحساب في حساب المحرّك الخارجي
status

enum (CustomerStatus)

حالة العميل.
creationTime

string

الطابع الزمني لوقت إنشاء هذا العميل. يكون الطابع الزمني بالتنسيق yyyy-MM-dd HH:mm:ss وحسب المنطقة الزمنية للعميل.
id

string (int64 format)

رقم تعريف العميل.
descriptiveName

string

اسم وصفي اختياري غير فريد للعميل
currencyCode

string

العملة التي يعمل بها الحساب. تتوفّر مجموعة فرعية من رموز العملات وفقًا لمعيار ISO 4217.
timeZone

string

رقم تعريف المنطقة الزمنية المحلية للعميل.
trackingUrlTemplate

string

نموذج عنوان URL لإنشاء عنوان URL للتتبّع من المَعلمات
finalUrlSuffix

string

نموذج عنوان URL لإلحاق المَعلمات بعنوان URL النهائي
autoTaggingEnabled

boolean

ما إذا كان وضع العلامات التلقائي مفعَّلاً للعميل.
manager

boolean

ما إذا كان العميل مديرًا.

ConversionTrackingSetting

مجموعة من الإعدادات على مستوى العميل ذات الصلة بتتبُّع الإحالات الناجحة في "إعلانات شبكة البحث 360"

تمثيل JSON 
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "googleAdsCrossAccountConversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
الحقول
acceptedCustomerDataTerms

boolean

ما إذا كان العميل قد قبل بنود بيانات العملاء أم لا. في حال استخدام ميزة تتبُّع الإحالات الناجحة في جميع الحسابات، يتم اكتساب هذه القيمة من الحساب الإداري. هذا الحقل للقراءة فقط. لمزيد من المعلومات، يُرجى الاطّلاع على https://support.google.com/adspolicy/answer/7475709.
conversionTrackingStatus

enum (ConversionTrackingStatus)

حالة تتبُّع الإحالات الناجحة ويشير ذلك إلى ما إذا كان العميل يستخدم ميزة تتبُّع الإحالات الناجحة، وإلى مالك ميزة تتبُّع الإحالات الناجحة لهذا العميل. إذا كان هذا العميل يستخدم ميزة تتبُّع الإحالات الناجحة في جميع الحسابات، ستختلف القيمة المعروضة استنادًا إلى login-customer-id الطلب.
enhancedConversionsForLeadsEnabled

boolean

ما إذا كان العميل قد فعّل ميزة "الإحالات الناجحة المحسّنة للعملاء المحتملين" في حال استخدام ميزة تتبُّع الإحالات الناجحة في جميع الحسابات، يتم اكتساب هذه القيمة من الحساب الإداري. هذا الحقل للقراءة فقط.
googleAdsConversionCustomer

string

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

string (int64 format)

رقم تعريف تتبُّع الإحالة الناجحة المستخدَم لهذا الحساب. لا يشير هذا المعرّف إلى ما إذا كان العميل يستخدم ميزة تتبُّع الإحالات الناجحة (يشير conversionTrackingStatus إلى ذلك). هذا الحقل للقراءة فقط.
googleAdsCrossAccountConversionTrackingId

string (int64 format)

رقم تعريف تتبُّع الإحالة الناجحة الخاص بمدير العميل. يتمّ ضبط هذا المَعلمة عندما يوافق العميل على تتبُّع الإحالات الناجحة، وتتجاهل مَعلمة conversionTrackingId. لا يمكن إدارة هذا الحقل إلا من خلال واجهة مستخدم "إعلانات Google". هذا الحقل للقراءة فقط.
crossAccountConversionTrackingId

string (int64 format)

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

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 (DCM) لعميل إداري

تمثيل JSON 
{
  "advertiserId": string,
  "networkId": string,
  "timeZone": string
}
الحقول
advertiserId

string (int64 format)

رقم تعريف المعلِن على "مدير الحملة" المرتبط بهذا العميل.
networkId

string (int64 format)

رقم تعريف شبكة "مدير الحملة" المرتبطة بهذا العميل.
timeZone

string

المنطقة الزمنية لشبكة "مدير الحملة" المرتبطة بهذا العميل بتنسيق قاعدة بيانات المنطقة الزمنية IANA، مثل America/New_York.

AccountStatus

الحالات المحتملة للحساب

عمليات التعداد
UNSPECIFIED القيمة التلقائية
UNKNOWN قيمة غير معروفة.
ENABLED يمكن للحساب عرض الإعلانات.
PAUSED أوقف المستخدم الحساب.
SUSPENDED تم إيقاف الحساب من خلال عملية داخلية.
REMOVED تم إيقاف الحساب نهائيًا.
DRAFT لا يزال الحساب قيد الإعداد، ولم يتم تفعيله بعد.

CustomerStatus

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

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN تُستخدَم لأغراض القيمة المعروضة فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
ENABLED يشير إلى حساب نشط يمكنه عرض الإعلانات.
CANCELED يشير ذلك إلى حساب تم إلغاؤه ولا يمكنه عرض الإعلانات. يمكن للمشرف إعادة تفعيل الحساب.
SUSPENDED يشير إلى حساب معلّق لا يمكنه عرض الإعلانات. يمكن لفريق الدعم في Google تفعيل هذه الميزة فقط.
CLOSED يشير ذلك إلى حساب مغلق لا يمكنه عرض الإعلانات. سيظهر للحساب التجريبي أيضًا حالة "مغلق". الحالة دائمة ولا يمكن إعادة فتحها.

CustomerAsset

رابط بين العميل ومادة العرض.

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

string

اسم مورد مادة عرض العميل تكون أسماء موارد CustomerAsset على النحو التالي:

customers/{customerId}/customerAssets/{assetId}~{fieldType}
asset

string

مطلوب. مادة العرض المرتبطة بالعميل
status

enum (AssetLinkStatus)

حالة مادة عرض العميل.

CustomerAssetSet

CustomerAssetSet هو الرابط بين العميل ومجموعة مواد العرض. تؤدي إضافة CustomerAssetSet إلى ربط مجموعة مواد عرض بعميل.

تمثيل JSON 
{
  "resourceName": string,
  "assetSet": string,
  "customer": string,
  "status": enum (AssetSetLinkStatus)
}
الحقول
resourceName

string

اسم المورد لمجموعة مواد عرض العميل يكون لأسماء موارد مواد عرض مجموعة مواد العرض التنسيق التالي:

customers/{customerId}/customerAssetSets/{asset_set_id}
assetSet

string

مجموعة مواد العرض المرتبطة بالعميل
customer

string

العميل المرتبط بمجموعة مواد العرض هذه.
status

enum (AssetSetLinkStatus)

حالة مادة عرض مجموعة مواد عرض العملاء للقراءة فقط.

AccessibleBiddingStrategy

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

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

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

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

string

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

customers/{customerId}/accessibleBiddingStrategies/{bidding_strategy_id}
id

string (int64 format)

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

string

اسم استراتيجية عروض الأسعار.
type

enum (BiddingStrategyType)

نوع استراتيجية عروض الأسعار.
ownerCustomerId

string (int64 format)

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

string

descriptiveName للعميل الذي يملك استراتيجية عروض الأسعار.

حقل الربط scheme مخطّط عروض الأسعار

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

object (MaximizeConversionValue)

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

object (MaximizeConversions)

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

object (TargetCpa)

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

object (TargetImpressionShare)

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

object (TargetRoas)

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

object (TargetSpend)

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

MaximizeConversionValue

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

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

number

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

MaximizeConversions

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

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

string (int64 format)

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

string (int64 format)

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

TargetCpa

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

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

string (int64 format)

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

TargetImpressionShare

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

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

enum (TargetImpressionShareLocation)

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

string (int64 format)

الجزء المحدّد من الإعلانات التي سيتم عرضها في الموقع الجغرافي المستهدَف بالميكرو على سبيل المثال، %1 تساوي 10,000.
cpcBidCeilingMicros

string (int64 format)

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

TargetRoas

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

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

number

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

TargetSpend

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

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

string (int64 format)

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

string (int64 format)

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

ManagerLinkStatus

الحالات المحتملة للرابط

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
ACTIVE تشير إلى العلاقة السارية حاليًا
INACTIVE يشير إلى علاقة منتهية
PENDING يشير ذلك إلى أنّ المدير قد طلب العلاقة، ولكنّ العميل لم يقبلها بعد.
REFUSED طلب المدير العلاقة، لكن العميل رفض.
CANCELED يشير ذلك إلى أنّ الحساب الإداري قد طلب إنشاء العلاقة، ولكنّه ألغى ذلك.

CustomerClient

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

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

string

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

string

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

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

enum (CustomerStatus)

حالة العميل. للقراءة فقط.
clientCustomer

string

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

boolean

تُحدِّد ما إذا كان هذا حسابًا مخفيًا.

للقراءة فقط.
level

string (int64 format)

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

string

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

boolean

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

boolean

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

string

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

string

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

string (int64 format)

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

DynamicSearchAdsSearchTermView

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

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

string

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

customers/{customerId}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}
landingPage

string

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

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

GenderView

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

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

string

اسم المورد لعرض الجنس تكون أسماء موارد عرض الجنس على النحو التالي:

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

GeoTargetConstant

ثابت الاستهداف الجغرافي

تمثيل JSON 
{
  "resourceName": string,
  "status": enum (GeoTargetConstantStatus),
  "id": string,
  "name": string,
  "countryCode": string,
  "targetType": string,
  "canonicalName": string,
  "parentGeoTarget": string
}
الحقول
resourceName

string

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

geoTargetConstants/{geo_target_constant_id}
status

enum (GeoTargetConstantStatus)

الحالة الثابتة للاستهداف الجغرافي.
id

string (int64 format)

رقم تعريف ثابت الاستهداف الجغرافي.
name

string

الاسم الإنجليزي لقيَم الاستهداف الجغرافي الثابتة
countryCode

string

رمز البلد وفقًا لمعيار ISO-3166-1 alpha-2 والمرتبط بالهدف.
targetType

string

نوع الاستهداف الثابت للاستهداف الجغرافي
canonicalName

string

الاسم الإنجليزي المؤهَّل بالكامل، ويتألّف من اسم الهدف واسم الشركة الرئيسية والبلد
parentGeoTarget

string

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

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

الحالات المحتملة لثابت الاستهداف الجغرافي

عمليات التعداد
UNSPECIFIED لم يتم تحديد أي قيمة.
UNKNOWN

القيمة المستلَمة غير معروفة في هذا الإصدار.

هذه قيمة للردّ فقط.
ENABLED ثابت الاستهداف الجغرافي صالح.
REMOVAL_PLANNED الثابت الخاص بالمنطقة الجغرافية المستهدَفة قديم وسيتمّت إزالته.

KeywordView

عرض الكلمات الرئيسية

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

string

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

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

التصنيف

التسمية

تمثيل JSON 
{
  "resourceName": string,
  "status": enum (LabelStatus),
  "textLabel": {
    object (TextLabel)
  },
  "id": string,
  "name": string
}
الحقول
resourceName

string

اسم المورد يكون لأسماء موارد التصنيف التنسيق التالي: customers/{customerId}/labels/{label_id}
status

enum (LabelStatus)

حالة التصنيف للقراءة فقط.
textLabel

object (TextLabel)

نوع من التصنيفات يعرض نصًا على خلفية ملونة.
id

string (int64 format)

رقم تعريف التصنيف. للقراءة فقط.
name

string

تمثّل هذه السمة اسم التصنيف.

هذا الحقل مطلوب ويجب ألا يكون فارغًا عند إنشاء تصنيف جديد.

يجب أن يتراوح طول هذه السلسلة بين 1 و80 حرفًا.

LabelStatus

الحالات المحتمَلة للتصنيف

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

TextLabel

نوع من التصنيفات يعرض نصًا على خلفية ملونة.

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

string

لون خلفية التصنيف بتنسيق سداسي عشري يجب أن تتطابق هذه السلسلة مع التعبير العادي "^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$". ملاحظة: قد لا يكون لون الخلفية مرئيًا للحسابات الإدارية.
description

string

وصف موجز للتصنيف يجب ألا يزيد طول العنوان عن 200 حرف.

LanguageConstant

لغة

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

string

اسم المورد لسمة اللغة الثابتة. تكون أسماء موارد الثابتة للغة على النحو التالي:

languageConstants/{criterionId}
id

string (int64 format)

رقم تعريف ثابت اللغة.
code

string

رمز اللغة، على سبيل المثال، "en_US" و"en_AU" و"es" و"fr" وما إلى ذلك
name

string

الاسم الكامل للّغة باللغة الإنجليزية، على سبيل المثال، "الإنجليزية (الولايات المتحدة)" أو "الإسبانية" أو غير ذلك
targetable

boolean

ما إذا كانت اللغة قابلة للاستهداف

LocationView

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

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

string

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

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

ProductBiddingCategoryConstant

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

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

string

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

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

enum (ProductBiddingCategoryLevel)

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

enum (ProductBiddingCategoryStatus)

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

string (int64 format)

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

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

string

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

string

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

string

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

string

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

ProductBiddingCategoryLevel

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

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
LEVEL1 المستوى 1:
LEVEL2 المستوى 2:
LEVEL3 المستوى 3:
LEVEL4 المستوى 4:
LEVEL5 المستوى 5

ProductBiddingCategoryStatus

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

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

ProductGroupView

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

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

string

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

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

ShoppingPerformanceView

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

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

string

اسم المورد لعرض أداء Shopping يكون شكل أسماء الموارد في طريقة عرض أداء Shopping على النحو التالي: customers/{customerId}/shoppingPerformanceView

UserList

قائمة المستخدمين تتضمّن هذه القائمة قائمة بالمستخدمين الذين يمكن أن يستهدفهم عميل.

تمثيل JSON 
{
  "resourceName": string,
  "type": enum (UserListType),
  "id": string,
  "name": string
}
الحقول
resourceName

string

اسم المورد لقائمة المستخدمين يكون لأسماء موارد قائمة المستخدمين الشكل التالي:

customers/{customerId}/userLists/{user_list_id}
type

enum (UserListType)

نوع هذه القائمة

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

string (int64 format)

رقم تعريف قائمة المستخدمين
name

string

اسم قائمة المستخدمين هذه. استنادًا إلى access_reason لتلك القائمة، قد لا يكون اسم قائمة المستخدمين فريدًا (على سبيل المثال، إذا access_reason=SHARED)

UserListType

رقم تعداد يحتوي على أنواع قوائم المستخدمين المحتملة

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
REMARKETING يتم تمثيل قائمة المستخدمين كمجموعة من أنواع الإحالات الناجحة.
LOGICAL يتم تمثيل UserList كمجموعة من قوائم/اهتمامات المستخدمين الأخرى.
EXTERNAL_REMARKETING تم إنشاء قائمة المستخدمين في منصة "مدير إعلانات Google".
RULE_BASED قائمة المستخدمين المرتبطة بقاعدة
SIMILAR قائمة مستخدمين تتضمّن مستخدمين مشابهين لمستخدمي قائمة مستخدمين أخرى
CRM_BASED UserList من بيانات إدارة علاقات العملاء التابعة للطرف الأول التي يقدّمها المعلِن في شكل رسائل إلكترونية أو بتنسيقات أخرى.

UserLocationView

عرض الموقع الجغرافي للمستخدم

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

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

string

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

customers/{customerId}/userLocationViews/{countryCriterionId}~{targetingLocation}
countryCriterionId

string (int64 format)

رقم تعريف المعيار للبلد.
targetingLocation

boolean

يشير إلى ما إذا كان الموقع الجغرافي مستهدفًا أم لا.

WebpageView

عرض صفحة ويب

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

string

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

customers/{customerId}/webpageViews/{ad_group_id}~{criterionId}

انتقال

زيارة.

تمثيل JSON 
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitDateTime": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
الحقول
resourceName

string

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

customers/{customerId}/visits/{ad_group_id}~{criterionId}~{ds_visit_id}
id

string (int64 format)

رقم تعريف الزيارة.
criterionId

string (int64 format)

رقم تعريف الكلمة الرئيسية في "إعلانات شبكة البحث 360" وتشير القيمة 0 إلى أنّ الكلمة الرئيسية غير منسوبة.
merchantId

string (int64 format)

رقم تعريف حساب المستودع الإعلاني في "إعلانات شبكة البحث 360" الذي يحتوي على المنتج الذي تم النقر عليه. تُنشئ "إعلانات شبكة البحث 360" هذا المعرّف عند ربط حساب مستودع في "إعلانات شبكة البحث 360".
adId

string (int64 format)

رقم تعريف الإعلان تشير القيمة 0 إلى أنّ الإعلان غير منسَب.
clickId

string

سلسلة فريدة لكل زيارة يتم تمريرها إلى الصفحة المقصودة كمعلمة عنوان URL لمعرّف النقرة.
visitDateTime

string

الطابع الزمني لحدث الزيارة. يكون الطابع الزمني بالتنسيق yyyy-MM-dd HH:mm:ss وحسب المنطقة الزمنية للعميل.
productId

string

معرّف المنتج الذي تم النقر عليه.
productChannel

enum (ProductChannel)

قناة البيع للمنتج الذي تم النقر عليه: على الإنترنت أو في المتجر
productLanguageCode

string

اللغة (ISO-639-1) التي تم ضبطها لخلاصة Merchant Center التي تحتوي على بيانات عن المنتج.
productStoreId

string

المتجر في "الإعلان للمنتجات داخل المتجر" الذي تم النقر عليه. ويجب أن يتطابق مع أرقام تعريف المتاجر المستخدَمة في خلاصة المنتجات في المتاجر المحلية.
productCountryCode

string

البلد (بتنسيق ISO-3166) المسجَّل لخلاصة المستودع التي تحتوي على المنتج الذي تم النقر عليه.
assetId

string (int64 format)

رقم تعريف مادة العرض التي تم التفاعل معها أثناء حدث الزيارة
assetFieldType

enum (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 (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "attributionType": enum (AttributionType),
  "conversionDateTime": string,
  "conversionLastModifiedDateTime": string,
  "conversionVisitDateTime": string,
  "conversionQuantity": string,
  "conversionRevenueMicros": string,
  "floodlightOriginalRevenue": string,
  "floodlightOrderId": string,
  "status": enum (ConversionStatus),
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
الحقول
resourceName

string

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

customers/{customerId}/conversions/{ad_group_id}~{criterionId}~{ds_conversion_id}
id

string (int64 format)

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

string (int64 format)

رقم تعريف معيار "إعلانات شبكة البحث 360". تشير القيمة 0 إلى أنّ المعيار لم يتم تحديد مصدره.
merchantId

string (int64 format)

رقم تعريف حساب المستودع في "إعلانات شبكة البحث 360" الذي يحتوي على المنتج الذي تم النقر عليه. تُنشئ "إعلانات شبكة البحث 360" هذا المعرّف عند ربط حساب مستودع في "إعلانات شبكة البحث 360".
adId

string (int64 format)

رقم تعريف الإعلان وتشير القيمة 0 إلى أنّ الإعلان لم يتمّ تحديد مصدره.
clickId

string

سلسلة فريدة للزيارة التي تُنسب إليها الإحالة الناجحة، ويتم تمريرها إلى الصفحة المقصودة كمعلمة عنوان URL لمعرّف النقرة.
visitId

string (int64 format)

رقم تعريف الزيارة في "إعلانات شبكة البحث 360" الذي تمّ تحديد مصدر الإحالة الناجحة على أنّه مصدره.
advertiserConversionId

string

بالنسبة إلى الإحالات الناجحة بلا إنترنت، يكون هذا المعرّف مقدَّمًا من المعلِنين. وإذا لم يحدِّد المعلِن رقم تعريف كهذا، تنشئ "إعلانات شبكة البحث 360" رقم تعريف. بالنسبة إلى الإحالات الناجحة على الإنترنت، يكون هذا العمود مساويًا لعمود id أو عمود floodlightOrderId استنادًا إلى تعليمات Floodlight التي يقدّمها المعلِن.
productId

string

معرّف المنتج الذي تم النقر عليه.
productChannel

enum (ProductChannel)

قناة البيع للمنتج الذي تم النقر عليه: على الإنترنت أو في المتجر
productLanguageCode

string

اللغة (ISO-639-1) التي تم ضبطها لخلاصة Merchant Center التي تحتوي على بيانات عن المنتج.
productStoreId

string

المتجر في "الإعلان للمنتجات داخل المتجر" الذي تم النقر عليه. يجب أن تتطابق هذه القيمة مع أرقام تعريف المتاجر المستخدَمة في خلاصة المنتجات في المتاجر المحلّية.
productCountryCode

string

البلد (بتنسيق ISO-3166) المسجَّل لخلاصة المستودع التي تحتوي على المنتج الذي تم النقر عليه.
attributionType

enum (AttributionType)

الغرض من الإحالة الناجحة: زيارة أو الكلمة الرئيسية + الإعلان
conversionDateTime

string

الطابع الزمني لحدث الإحالة الناجحة.
conversionLastModifiedDateTime

string

الطابع الزمني لآخر مرة تم فيها تعديل الإحالة الناجحة
conversionVisitDateTime

string

الطابع الزمني للزيارة التي تمّ تحديد مصدر الإحالة الناجحة إليها.
conversionQuantity

string (int64 format)

كمية السلع التي سجّلتها الإحالة الناجحة، على النحو الذي تحدّده مَعلمة عنوان URL للكمية. يتحمّل المعلِن مسؤولية تعبئة المَعلمة ديناميكيًا (مثل عدد السلع المُباعة في الإحالة الناجحة)، وإلا سيتم ضبطها تلقائيًا على 1.
conversionRevenueMicros

string (int64 format)

الأرباح المعدَّلة بالميكرو لحدث الإحالة الناجحة. وسيتمّ احتسابها دائمًا بعملة حساب عرض الإعلانات.
floodlightOriginalRevenue

string (int64 format)

الأرباح الأصلية غير المتغيّرة المرتبطة بحدث Floodlight (بالعملة المحدّدة في التقرير الحالي)، قبل إجراء تعديلات على إعدادات عملة Floodlight
floodlightOrderId

string

رقم تعريف طلب Floodlight الذي يقدّمه المعلِن للإحالة الناجحة
status

enum (ConversionStatus)

حالة الإحالة الناجحة، سواء كانت "مفعّلة" أو "مُزالة"
assetId

string (int64 format)

رقم تعريف مادة العرض التي تم التفاعل معها أثناء حدث الإحالة الناجحة.
assetFieldType

enum (AssetFieldType)

نوع حقل مادة العرض لحدث الإحالة الناجحة

AttributionType

نوع تحديد مصدر الإحالات الناجحة في "إعلانات شبكة البحث 360"

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

ConversionStatus

الحالات المحتملة للإحالة الناجحة

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

المقاييس

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

تمثيل JSON 
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionCustomMetrics": [
    {
      object (Value)
    }
  ],
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "rawEventConversionMetrics": [
    {
      object (Value)
    }
  ],
  "absoluteTopImpressionPercentage": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "visits": number,
  "allConversionsFromStoreWebsite": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpm": number,
  "clicks": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "clientAccountConversionsValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "clientAccountConversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsByConversionDate": number,
  "crossDeviceConversionsValue": number,
  "crossDeviceConversionsValueByConversionDate": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "averageQualityScore": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "generalInvalidClickRate": number,
  "generalInvalidClicks": string,
  "mobileFriendlyClicksPercentage": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "topImpressionPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "clientAccountViewThroughConversions": string,
  "clientAccountCrossSellCostOfGoodsSoldMicros": string,
  "crossSellCostOfGoodsSoldMicros": string,
  "clientAccountCrossSellGrossProfitMicros": string,
  "crossSellGrossProfitMicros": string,
  "clientAccountCrossSellRevenueMicros": string,
  "crossSellRevenueMicros": string,
  "clientAccountCrossSellUnitsSold": number,
  "crossSellUnitsSold": number,
  "clientAccountLeadCostOfGoodsSoldMicros": string,
  "leadCostOfGoodsSoldMicros": string,
  "clientAccountLeadGrossProfitMicros": string,
  "leadGrossProfitMicros": string,
  "clientAccountLeadRevenueMicros": string,
  "leadRevenueMicros": string,
  "clientAccountLeadUnitsSold": number,
  "leadUnitsSold": number
}
الحقول
allConversionsValueByConversionDate

number

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

number

إجمالي عدد التحويلات. ويشمل ذلك جميع الإحالات الناجحة بغض النظر عن قيمة includeInConversionsMetric. عند اختيار هذا العمود مع التاريخ، تشير القيم في عمود التاريخ إلى تاريخ الإحالة الناجحة. تتوفّر تفاصيل أعمدة by_conversion_date على الرابط https://support.google.com/sa360/answer/9250611.
conversionCustomMetrics[]

object (Value)

المقاييس المخصّصة للإحالات الناجحة
conversionsValueByConversionDate

number

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

number

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

enum (QualityScoreBucket)

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

enum (QualityScoreBucket)

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

enum (QualityScoreBucket)

نسبة النقر إلى الظهور المتوقّعة في نتائج البحث السابقة
interactionEventTypes[]

enum (InteractionEventType)

أنواع التفاعلات المستحقة والمجانية.
rawEventConversionMetrics[]

object (Value)

مقاييس الإحالات الناجحة للأحداث الأوّلية
absoluteTopImpressionPercentage

number

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

number

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

number

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

number

إجمالي عدد التحويلات. يشمل ذلك جميع الإحالات الناجحة بغض النظر عن قيمةincludeInconversionMetric.
allConversionsValuePerCost

number

قيمة كل الإحالات الناجحة مقسومة على إجمالي تكلفة التفاعلات مع الإعلانات (مثل النقرات على الإعلانات النصية أو مشاهدات إعلانات الفيديو).
allConversionsFromClickToCall

number

عدد المرّات التي نقر فيها الأشخاص على زر "الاتصال" بهدف الاتصال بمتجر أثناء النقر على إعلان أو بعده. ولا يشمل هذا العدد ما إذا كانت المكالمات قد تم تلقّيها أم لا، أو مدة أيٍّ منها.

ينطبق هذا المقياس على عناصر الخلاصة فقط.
allConversionsFromDirections

number

عدد المرّات التي نقر فيها العملاء على زر "الحصول على الاتجاهات" للانتقال إلى متجر بعد النقر على إعلان

ينطبق هذا المقياس على عناصر الخلاصة فقط.
allConversionsFromInteractionsValuePerInteraction

number

قيمة جميع الإحالات الناجحة من التفاعلات مقسومةً على إجمالي عدد التفاعلات.
allConversionsFromMenu

number

عدد المرّات التي نقر فيها الأشخاص على رابط لعرض قائمة متجر بعد النقر على إعلان

ينطبق هذا المقياس على العناصر في الخلاصة فقط.
allConversionsFromOrder

number

عدد المرّات التي قدَّم فيها الأشخاص طلبًا في متجر بعد النقر على إعلان

ينطبق هذا المقياس على العناصر في الخلاصة فقط.
allConversionsFromOtherEngagement

number

عدد الإحالات الناجحة الأخرى (مثل، نشر مراجعة أو حفظ موقع جغرافي لمتجر) التي حدثت بعد أن نقر الأشخاص على إعلان.

ينطبق هذا المقياس على عناصر الخلاصة فقط.
allConversionsFromStoreVisit

number

العدد المقدّر لزيارات الأشخاص لمتجر بعد النقر على إعلان.

ينطبق هذا المقياس على عناصر الخلاصة فقط.
visits

number

النقرات التي سجّلتها "إعلانات شبكة البحث 360" وأعادت توجيهها بنجاح إلى الصفحة المقصودة للمعلِن.
allConversionsFromStoreWebsite

number

عدد المرّات التي تمّ فيها توجيه المستخدِمين إلى عنوان URL لمتجر بعد النقر على إعلان

ينطبق هذا المقياس على عناصر الخلاصة فقط.
averageCost

number

متوسط المبلغ الذي تدفعه مقابل كل تفاعل. هذا المبلغ هو إجمالي تكلفة إعلاناتك مقسومًا على إجمالي عدد التفاعلات.
averageCpc

number

إجمالي تكلفة جميع النقرات مقسومًا على إجمالي عدد النقرات التي تمّ تلقّيها. هذا المقياس هو قيمة نقدية ويتم عرضه تلقائيًا بعملة العميل. اطّلِع على المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
averageCpm

number

متوسّط التكلفة لكل ألف ظهور (CPM) هذا المقياس هو قيمة نقدية ويتم عرضها بعملة العميل تلقائيًا. اطّلِع على المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
clicks

string (int64 format)

عدد النقرات.
contentBudgetLostImpressionShare

number

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

number

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

number

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

number

متوسّط الإحالات الناجحة التي يمكن تقديم عروض أسعار لها (من التفاعل) لكلّ تفاعل مؤهّل للإحالة الناجحة. تعرِض هذه السمة متوسّط عدد المرّات التي يؤدّي فيها أحد التفاعلات مع الإعلان إلى إحالة ناجحة يمكن تقديم عروض أسعار لها.
clientAccountConversionsValue

number

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

number

قيمة الإحالة الناجحة التي يمكن تقديم عروض أسعار لها مقسومةً على إجمالي تكلفة التفاعلات المؤهَّلة للإحالة الناجحة.
conversionsFromInteractionsValuePerInteraction

number

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

number

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

string (int64 format)

مجموع تكلفة النقرة (CPC) والتكلفة لكل ألف ظهور (CPM) خلال هذه الفترة. هذا المقياس هو قيمة نقدية ويتم عرضها بعملة العميل تلقائيًا. اطّلِع على المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
costPerAllConversions

number

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

number

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

number

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

number

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

number

عدد الإحالات الناجحة باستخدام أكثر من جهاز واحد حسب تاريخ الإحالة الناجحة تتوفّر تفاصيل أعمدة by_conversion_date على الرابط https://support.google.com/sa360/answer/9250611.
crossDeviceConversionsValue

number

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

number

مجموع قيمة الإحالات الناجحة باستخدام أكثر من جهاز واحد حسب تاريخ الإحالة الناجحة. تتوفّر تفاصيل أعمدة by_conversion_date على الرابط https://support.google.com/sa360/answer/9250611.
ctr

number

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

number

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

number

مجموع قيم الإحالات الناجحة للإحالات الناجحة المضمّنة في حقل "الإحالات الناجحة". يُعدّ هذا المقياس مفيدًا فقط إذا أدخلت قيمة لإجراءات الإحالات الناجحة.
averageQualityScore

number

متوسّط نتيجة الجودة
historicalQualityScore

string (int64 format)

نقاط الجودة للفترات السابقة.
impressions

string (int64 format)

عدد مرّات ظهور إعلانك على صفحة نتائج بحث أو موقع إلكتروني على "شبكة Google"
interactionRate

number

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

string (int64 format)

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

number

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

string (int64 format)

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

number

النسبة المئوية للنقرات التي تم استبعادها من إجمالي عدد النقرات (النقرات التي تمّت فلترتها + النقرات التي لم تتم فلترتها) لأنّها نقرات غير صالحة عامة. هذه هي النقرات التي تعتبرها Google غير مشروعة ويتم رصدها من خلال وسائل الفلترة الروتينية (أي الزيارات المعروفة غير الصالحة لمراكز البيانات أو برامج التتبّع أو العناكب أو برامج الزحف الأخرى أو الأنماط غير المنتظمة وما إلى ذلك). ولا يتم تحميلك تكلفة هذه النقرات، ولا تؤثر في إحصاءات حسابك. يمكنك الاطّلاع على صفحة المساعدة على https://support.google.com/campaignmanager/answer/6076504 لمعرفة التفاصيل.
generalInvalidClicks

string (int64 format)

عدد النقرات غير الصالحة الناشئة عن تقنيات معروفة هذه هي مجموعة فرعية من النقرات غير الصالحة التي يتم رصدها من خلال وسائل الفلترة الروتينية (مثل الزيارات المعروفة غير الصالحة لمراكز البيانات أو برامج التتبّع أو برامج العنكبوت أو برامج الزحف الأخرى أو الأنماط غير المنتظمة أو ما إلى ذلك). ولا يتم تحميلك تكلفة هذه النقرات، ولا تؤثر في إحصاءات حسابك. يمكنك الاطّلاع على صفحة المساعدة على الرابط https://support.google.com/campaignmanager/answer/6076504 للحصول على التفاصيل.
mobileFriendlyClicksPercentage

number

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

number

النسبة المئوية لمرات ظهور إعلانات Shopping أو إعلانات شبكة البحث للعملاء التي تظهر في أبرز موضع على Shopping. يُرجى الاطّلاع على https://support.google.com/sa360/answer/9566729 للحصول على التفاصيل. يتم تسجيل أي قيمة أقل من 0.1 على أنّها 0.0999.
searchBudgetLostAbsoluteTopImpressionShare

number

العدد الذي يقدِّر عدد المرات التي لم يظهر فيها إعلانك كأول إعلان بين أهم الإعلانات في نتائج البحث بسبب انخفاض الميزانية. ملاحظة: يتم تسجيل نسبة عدم ظهور الإعلان في صدارة الصفحة على شبكة البحث (الميزانية) في النطاق من 0 إلى 0.9. ويتم تسجيل أي قيمة أعلى من 0.9 كـ 0.9001.
searchBudgetLostImpressionShare

number

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

number

يشير هذا المقياس إلى العدد الذي يقدِّر عدد مرات عدم ظهور إعلانك بجانب أهم نتائج البحث المجاني بسبب انخفاض الميزانية. ملاحظة: يتم تسجيل نسبة عدم ظهور الإعلان في أعلى الصفحة على شبكة البحث ضمن الميزانية في النطاق من 0 إلى 0.9. يتم تسجيل أي قيمة أعلى من 0.9 على أنّها 0.9001.
searchClickShare

number

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

number

عدد مرّات الظهور التي حصلت عليها مقسومًا على العدد المقدَّر لمرّات الظهور التي كنت مؤهّلاً للحصول عليها في "شبكة البحث" عن عبارات البحث التي تطابقت تمامًا مع كلماتك الرئيسية (أو كانت عبارة عن صيغ قريبة لكلمتك الرئيسية)، بغض النظر عن أنواع مطابقة الكلمات الرئيسية ملاحظة: يتم تسجيل نسبة ظهور الإعلان بمطابقة تامة في شبكة البحث في النطاق بين 0.1 و1. يتم تسجيل أي قيمة أقل من 0.1 على أنّها 0.0999.
searchImpressionShare

number

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

number

العدد الذي يقدِّر عدد المرات التي لم يظهر فيها إعلانك كأول إعلان بين أهم الإعلانات في نتائج البحث بسبب انخفاض "ترتيب الإعلان". ملاحظة: يتم تسجيل نسبة عدم ظهور الإعلان في صدارة الصفحة في ترتيب البحث ضمن النطاق من 0 إلى 0.9. ويتم تسجيل أي قيمة أعلى من 0.9 كـ 0.9001.
searchRankLostImpressionShare

number

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

number

يشير هذا المقياس إلى العدد الذي يقدِّر عدد مرات عدم ظهور إعلانك بجانب أهم نتائج البحث المجاني بسبب انخفاض ترتيب الإعلان. ملاحظة: يتم تسجيل نسبة عدم ظهور الإعلان في أعلى الصفحة في ترتيب البحث ضمن النطاق بين 0 و0.9. يتم تسجيل أي قيمة أعلى من 0.9 على أنّها 0.9001.
searchTopImpressionShare

number

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

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

number

النسبة المئوية لمرات ظهور إعلانك التي تظهر بجانب أهم نتائج البحث المجاني.
valuePerAllConversions

number

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

number

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

number

قيمة الإحالة الناجحة التي يمكن تقديم عروض أسعار لها مقسومة على عدد الإحالات الناجحة التي يمكن تقديم عروض أسعار لها. تعرِض هذه السمة القيمة المتوسطة لكلّ إحالة ناجحة يمكن تقديم عروض أسعار لها.
valuePerConversionsByConversionDate

number

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

string (int64 format)

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

string (int64 format)

تكلفة السلع المُباعة من خلال بيع منتجات إضافية لحساب العميل هي إجمالي تكلفة المنتجات التي تم بيعها نتيجةً لإعلان عن منتج مختلف. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. وتكلفة السلع المُباعة من خلال بيع منتجات إضافية هي إجمالي تكلفة المنتجات التي تم بيعها بدون الإعلان عنها. مثال: نقر شخص ما على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة تكلفة السلع المُباعة للقميص 5 دولار أمريكي. تبلغ تكلفة السلع المُباعة من خلال بيع منتجات إضافية لهذا الطلب 5 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه تلقائيًا بعملة العميل. اطّلِع على المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
crossSellCostOfGoodsSoldMicros

string (int64 format)

تكلفة السلع المُباعة من خلال بيع منتجات إضافية (COGS) هي إجمالي تكلفة المنتجات التي تم بيعها نتيجةً لإعلان عن منتج مختلف. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. وتكلفة السلع المُباعة من خلال بيع منتجات إضافية هي إجمالي تكلفة المنتجات التي تم بيعها بدون الإعلان عنها. مثال: نقر شخص ما على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة تكلفة السلع المُباعة للقميص 5 دولار أمريكي. تبلغ تكلفة السلع المُباعة من خلال بيع منتجات إضافية لهذا الطلب 5 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه تلقائيًا بعملة العميل. اطّلِع على المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
clientAccountCrossSellGrossProfitMicros

string (int64 format)

الأرباح الإجمالية من بيع منتجات إضافية في حساب العميل هي الأرباح التي حقّقتها من المنتجات المُباعة نتيجة للإعلان عن منتج مختلف، بعد طرح تكلفة السلع المُباعة منها. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في عملية الشراء هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الأرباح الإجمالية من بيع منتجات إضافية هي الأرباح التي يتمّ تحقيقها من خلال بيع منتجات إضافية منسوبة إلى إعلاناتك بعد طرح تكلفة السلع المُباعة منها. مثال: نقر شخص ما على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القميص ‏$20، وله قيمة تكلفة سلع مُباعة تبلغ ‏$5. تبلغ الأرباح الإجمالية من بيع منتجات إضافية لهذا الطلب ‏$15 = ‏$20 - ‏$5. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه تلقائيًا بعملة العميل. يمكنك الاطّلاع على المَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
crossSellGrossProfitMicros

string (int64 format)

الأرباح الإجمالية من بيع منتجات إضافية هي الأرباح التي تحقّقها من المنتجات المُباعة نتيجة للإعلان عن منتج مختلف، بعد طرح تكلفة السلع المُباعة منها. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في عملية الشراء هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الأرباح الإجمالية من بيع منتجات إضافية هي الأرباح التي يتمّ تحقيقها من خلال بيع منتجات إضافية منسوبة إلى إعلاناتك بعد طرح تكلفة السلع المُباعة منها. مثال: نقر شخص ما على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القميص ‏$20، وله قيمة تكلفة سلع مُباعة تبلغ ‏$5. تبلغ الأرباح الإجمالية من بيع منتجات إضافية لهذا الطلب ‏$15 = ‏$20 - ‏$5. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضها بعملة العميل تلقائيًا. اطّلِع على المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
clientAccountCrossSellRevenueMicros

string (int64 format)

الأرباح من بيع المنتجات الإضافية في حساب العميل هي إجمالي المبلغ الذي تحقّقه من المنتجات المُباعة نتيجة للإعلان عن منتج آخر. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الأرباح من بيع المنتجات الإضافية هي القيمة الإجمالية التي حقّقتها من خلال بيع منتجات إضافية منسوبة إلى إعلاناتك. مثال: نقر شخص ما على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ الأرباح من بيع منتجات إضافية لهذا الطلب 20 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه تلقائيًا بعملة العميل. اطّلِع على المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
crossSellRevenueMicros

string (int64 format)

الأرباح من بيع المنتجات الإضافية هي إجمالي المبلغ الذي تحقّقه من المنتجات المُباعة نتيجة للإعلان عن منتج آخر. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الأرباح من بيع المنتجات الإضافية هي القيمة الإجمالية التي حقّقتها من خلال بيع منتجات إضافية منسوبة إلى إعلاناتك. مثال: نقر شخص ما على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ الأرباح من بيع منتجات إضافية لهذا الطلب 20 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه تلقائيًا بعملة العميل. اطّلِع على المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
clientAccountCrossSellUnitsSold

number

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

number

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

string (int64 format)

تكلفة السلع المُباعة للعملاء المحتملِين في حسابات العملاء هي إجمالي تكلفة المنتجات المُباعة نتيجةً للإعلان عن المنتج نفسه. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمُباعة، يتمّ احتساب تكلفة هذه السلع ضمن تكلفة السلع المُباعة للعملاء المحتملِين. مثال: نقر شخص ما على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة تكلفة السلع المُباعة للقميص 5 دولار أمريكي. تبلغ تكلفة السلع المُباعة للعملاء المحتملِين لهذا الطلب 3 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه تلقائيًا بعملة العميل. يمكنك الاطّلاع على المَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
leadCostOfGoodsSoldMicros

string (int64 format)

تكلفة السلع المُباعة للعملاء المحتملِين هي إجمالي تكلفة المنتجات المُباعة نتيجة للإعلان عن المنتج نفسه. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمُباعة، يتمّ احتساب تكلفة هذه السلع ضمن تكلفة السلع المُباعة للعملاء المحتملِين. على سبيل المثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة تكلفة السلع المُباعة للقميص 5 دولار أمريكي. تبلغ تكلفة السلع المُباعة للعملاء المحتملِين لهذا الطلب 3 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضها بعملة العميل تلقائيًا. يمكنك الاطّلاع على المَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountLeadGrossProfitMicros

string (int64 format)

الأرباح الإجمالية من العملاء المحتملِين في حساب العميل هي الأرباح التي حقّقتها من المنتجات المُباعة نتيجة للإعلان عن المنتج نفسه، بعد طرح تكلفة السلع المُباعة منها. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت كلٌّ من المنتجات المعلَن عنها والمنتجات المُباعة، تكون الأرباح التي تحقّقها من هذه المبيعات بعد طرح تكلفة السلع المُباعة منها هي الأرباح الإجمالية من العملاء المحتملِين. مثال: نقر شخص ما على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ولها قيمة تكلفة سلع مُباعة تبلغ 3 دولار أمريكي. ستكون الأرباح الإجمالية من العملاء المحتملِين لهذا الطلب هي 7 دولار أمريكي = 10 دولار أمريكي - 3 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه تلقائيًا بعملة العميل. اطّلِع على المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
leadGrossProfitMicros

string (int64 format)

الأرباح الإجمالية من العملاء المحتملِين هي الأرباح التي تحقِقّها من المنتجات المُباعة نتيجة للإعلان عن المنتج نفسه، بعد طرح تكلفة السلع المُباعة منها. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت كلٌّ من المنتجات المعلَن عنها والمنتجات المُباعة، تكون الأرباح التي تحقّقها من هذه المبيعات بعد طرح تكلفة السلع المُباعة منها هي الأرباح الإجمالية من العملاء المحتملِين. على سبيل المثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ولها قيمة تكلفة سلع مُباعة تبلغ 3 دولار أمريكي. ستكون الأرباح الإجمالية من العملاء المحتملِين لهذا الطلب هي 7 دولار أمريكي = 10 دولار أمريكي - 3 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه تلقائيًا بعملة العميل. يمكنك الاطّلاع على المَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountLeadRevenueMicros

string (int64 format)

الأرباح من العملاء المحتملِين لحساب العميل هي إجمالي المبلغ الذي حقّقته من منتجات تمّ بيعها نتيجة الإعلان عن المنتج نفسه. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمُباعة، يتمّ عرض القيمة الإجمالية التي حقّقتها من مبيعات هذه المنتجات ضمن الأرباح من العملاء المحتملِين. مثال: نقر شخص ما على إعلان Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ الإيرادات من العملاء المحتملين لهذا الطلب 10 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضها بعملة العميل تلقائيًا. اطّلِع على المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
leadRevenueMicros

string (int64 format)

الأرباح من العملاء المحتملِين هي إجمالي المبلغ الذي حقّقته من منتجات تمّ بيعها نتيجة الإعلان عن المنتج نفسه. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمُباعة، يتمّ عرض القيمة الإجمالية التي حقّقتها من مبيعات هذه المنتجات ضمن الأرباح من العملاء المحتملِين. على سبيل المثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ الإيرادات من العملاء المحتملين لهذا الطلب 10 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضه تلقائيًا بعملة العميل. اطّلِع على المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
clientAccountLeadUnitsSold

number

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

number

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

القيمة

حاوية بيانات عامة.

تمثيل JSON 
{

  // Union field value can be only one of the following:
  "booleanValue": boolean,
  "int64Value": string,
  "floatValue": number,
  "doubleValue": number,
  "stringValue": string
  // End of list of possible types for union field value.
}
الحقول
حقل الربط value قيمة يمكن أن يكون value واحدًا فقط مما يلي:
booleanValue

boolean

قيمة منطقية.
int64Value

string (int64 format)

‎int64
floatValue

number

عدد عائم.
doubleValue

number

غرفة مزدوجة.
stringValue

string

سلسلة.

QualityScoreBucket

يشير ذلك المصطلح إلى تعداد يسرد مجموعات نقاط الجودة المحتمَلة.

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

InteractionEventType

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

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

الشرائح

حقول التقسيم فقط.

تمثيل JSON 
{
  "adNetworkType": enum (AdNetworkType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionCustomDimensions": [
    {
      object (Value)
    }
  ],
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "keyword": {
    object (Keyword)
  },
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "productSoldCondition": enum (ProductCondition),
  "rawEventConversionDimensions": [
    {
      object (Value)
    }
  ],
  "conversionAction": string,
  "conversionActionName": string,
  "date": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetMetro": string,
  "geoTargetRegion": string,
  "hour": integer,
  "month": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productItemId": string,
  "productLanguage": string,
  "productSoldBiddingCategoryLevel1": string,
  "productSoldBiddingCategoryLevel2": string,
  "productSoldBiddingCategoryLevel3": string,
  "productSoldBiddingCategoryLevel4": string,
  "productSoldBiddingCategoryLevel5": string,
  "productSoldBrand": string,
  "productSoldCustomAttribute0": string,
  "productSoldCustomAttribute1": string,
  "productSoldCustomAttribute2": string,
  "productSoldCustomAttribute3": string,
  "productSoldCustomAttribute4": string,
  "productSoldItemId": string,
  "productSoldTitle": string,
  "productSoldTypeL1": string,
  "productSoldTypeL2": string,
  "productSoldTypeL3": string,
  "productSoldTypeL4": string,
  "productSoldTypeL5": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "week": string,
  "year": integer,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
الحقول
adNetworkType

enum (AdNetworkType)

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

enum (ConversionActionCategory)

فئة إجراء الإحالة الناجحة
conversionCustomDimensions[]

object (Value)

السمات المخصّصة للإحالة الناجحة
dayOfWeek

enum (DayOfWeek)

يوم من الأسبوع، على سبيل المثال، الإثنين
device

enum (Device)

الجهاز الذي تنطبق عليه المقاييس
keyword

object (Keyword)

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

enum (ProductChannel)

قناة المنتج.
productChannelExclusivity

enum (ProductChannelExclusivity)

الحقوق الحصرية للمنتج.
productCondition

enum (ProductCondition)

حالة المنتج
productSoldCondition

enum (ProductCondition)

حالة المنتج المُباع.
rawEventConversionDimensions[]

object (Value)

سمات الإحالات الناجحة للأحداث الأوّلية
conversionAction

string

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

string

اسم إجراء الإحالة الناجحة.
date

string

التاريخ الذي تنطبق عليه المقاييس. التنسيق yyyy-MM-dd، على سبيل المثال، ‎2018-04-17.
geoTargetCity

string

اسم المورد للثابت المستهدَف الجغرافي الذي يمثّل مدينة.
geoTargetCountry

string

اسم المورد للثابت المستهدَف جغرافيًا الذي يمثّل بلدًا.
geoTargetMetro

string

اسم المورد للثابت المستهدف الجغرافي الذي يمثّل منطقة مترو.
geoTargetRegion

string

اسم المورد للثابت المستهدَف الجغرافي الذي يمثّل منطقة
hour

integer

ساعة اليوم بالتنسيق الرقمي من 0 إلى 23
month

string

الشهر كما يمثّله تاريخ اليوم الأول من الشهر التنسيق بالتنسيق yyyy-MM-dd
productBiddingCategoryLevel1

string

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

string

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

string

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

string

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

string

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

string

العلامة التجارية للمنتج
productCountry

string

اسم المرجع للثابت الخاص بالاستهداف الجغرافي لبلد بيع المنتج.
productCustomAttribute0

string

السمة المخصّصة 0 للمنتج.
productCustomAttribute1

string

السمة المخصّصة 1 للمنتج.
productCustomAttribute2

string

السمة المخصّصة 2 للمنتج.
productCustomAttribute3

string

السمة المخصّصة 3 للمنتج
productCustomAttribute4

string

السمة المخصّصة 4 للمنتج.
productItemId

string

معرّف السلعة للمنتج.
productLanguage

string

اسم المرجع لسمة اللغة الثابتة للغة المنتج.
productSoldBiddingCategoryLevel1

string

فئة عروض الأسعار (المستوى 1) للمنتج المُباع
productSoldBiddingCategoryLevel2

string

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

string

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

string

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

string

فئة عروض الأسعار (المستوى 5) للمنتج المُباع.
productSoldBrand

string

العلامة التجارية للمنتج المباع
productSoldCustomAttribute0

string

السمة المخصّصة 0 للمنتج الذي تمّ بيعه.
productSoldCustomAttribute1

string

السمة المخصّصة 1 للمنتج الذي تمّ بيعه.
productSoldCustomAttribute2

string

السمة المخصّصة 2 للمنتج الذي تمّ بيعه.
productSoldCustomAttribute3

string

السمة المخصّصة 3 للمنتج الذي تمّ بيعه.
productSoldCustomAttribute4

string

السمة المخصّصة 4 للمنتج الذي تمّ بيعه.
productSoldItemId

string

معرّف السلعة للمنتج المباع.
productSoldTitle

string

عنوان المنتج المُباع
productSoldTypeL1

string

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

string

نوع (المستوى 2) المنتج المباع.
productSoldTypeL3

string

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

string

نوع (المستوى 4) المنتج المُباع
productSoldTypeL5

string

نوع (المستوى 5) المنتج المُباع
productStoreId

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

الربع كما يمثّله تاريخ اليوم الأول من الربع. تستخدم السنة التقويمية لربع السنة، على سبيل المثال، يبدأ الربع الثاني من عام 2018 في 2018-04-01. بالتنسيق yyyy-MM-dd
week

string

الأسبوع على أنّه من الاثنين إلى الأحد، ويمثّله تاريخ الاثنين بالتنسيق yyyy-MM-dd
year

integer

السنة بالتنسيق yyyy
assetInteractionTarget

object (AssetInteractionTarget)

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

AdNetworkType

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

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN القيمة غير معروفة في هذا الإصدار.
SEARCH بحث Google.
SEARCH_PARTNERS شركاء البحث
CONTENT للشبكة الإعلانية.
YOUTUBE_WATCH فيديوهات YouTube
MIXED على جميع الشبكات

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

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

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

object (KeywordInfo)

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

string

اسم مورد 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

string

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

boolean

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