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، مثال: ‎2019-03-14
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 نوع المجموعات الإعلانية في "حملات إعلانات مقارنة الأسعار" على Shopping
PROMOTED_HOTEL_ADS نوع المجموعة الإعلانية للمجموعات الإعلانية للفنادق المروّجة.
VIDEO_RESPONSIVE المجموعات الإعلانية المتجاوبة لإعلانات الفيديو
VIDEO_EFFICIENT_REACH المجموعات الإعلانية لزيادة مدى الوصول الفعّال إلى الجمهور في الفيديو
SMART_CAMPAIGN_ADS نوع المجموعة الإعلانية للحملات الذكية
TRAVEL_ADS نوع المجموعة الإعلانية "لحملات السفر"

AdGroupAdRotationMode

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

عمليات التعداد
UNSPECIFIED لم يتم تحديد وضع عرض الإعلانات بالتناوب.
UNKNOWN

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

هذه قيمة للردّ فقط.
OPTIMIZE تحسين إعلانات المجموعة الإعلانية استنادًا إلى النقرات أو الإحالات الناجحة
ROTATE_FOREVER تناوب العرض بالتساوي إلى الأبد

AdGroupEngineStatus

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

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

تمّ الإيقاف. لا تستخدِم هذه الطريقة.
AD_GROUP_EXPIRED لا يتم عرض أي إعلانات لهذه المجموعة الإعلانية لأنّ تاريخ انتهائها قد انقضى.
AD_GROUP_REMOVED تم حذف المجموعة الإعلانية.
AD_GROUP_DRAFT لا يتم عرض أي إعلانات لهذه المجموعة الإعلانية لأنّ المجموعة الإعلانية المرتبطة بها لا تزال في شكل مسودة.
AD_GROUP_PAUSED تم إيقاف المجموعة الإعلانية مؤقتًا.
AD_GROUP_SERVING المجموعة الإعلانية نشطة وتعرض إعلانات حاليًا.
AD_GROUP_SUBMITTED تم إرسال المجموعة الإعلانية (حالة Microsoft Bing 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)

عرض سعر النقرة
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 حدث في الحياة

PositionEstimates

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

تمثيل 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 : Criterion pending review
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‏ application/x-shockwave-flash
TEXT_HTML نوع MIME للنص/html
PDF نوع MIME لتطبيق/ملف بتنسيق pdf
MSWORD نوع MIME‏ application/msword
MSEXCEL نوع MIME‏ application/vnd.ms-excel
RTF نوع MIME هو application/rtf.
AUDIO_WAV نوع MIME للملف audio/wav
AUDIO_MP3 نوع MIME للملف audio/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 بعد مرور 15 دقيقة على الساعة
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 Advertising.
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
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

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

object (AdScheduleInfo)

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

boolean

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

boolean

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

boolean

ما إذا كان سيتم عرض إضافة المكالمة في المنطقة الزمنية لمستخدم البحث تنطبق هذه المقالة على Microsoft Advertising.
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)

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

enum (LocationOwnershipType)

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

BusinessProfileLocation

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

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

string

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

string

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

string (int64 format)

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

LocationOwnershipType

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

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

عنصر واحد من فئة عروض الأسعار على مستوى معيّن. تكون الفئات ذات المستوى الأعلى في المستوى 1، والفئات الفرعية لها في المستوى 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 تم استخدام مادة العرض في عنوان طويل (مستخدَم في MultiAssetResponsiveAd).
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 التكلفة المستهدَفة لكل ألف ظهور هي استراتيجية عروض أسعار مبرمَجة تحدّد عروض الأسعار للمساعدة في الحصول على أكبر عدد ممكن من مرّات الظهور بالتكلفة المستهدَفة لكل ألف ظهور (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 و1, 000.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. فارغ، إذا كانت الحملة لا تستخدم استراتيجية محفظة تتوفّر سمات الاستراتيجية غير المشروطة لجميع العملاء الذين تتم مشاركة الاستراتيجية معهم ويتم قراءتها من مورد 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. استخدِم creationTime بدلاً من ذلك.
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. عند الإنشاء، يكون الإعداد التلقائي هو ‎30-12-2037، ما يعني أنّ الحملة ستستمر إلى أجل غير مسمى. لضبط حملة حالية على عرض الإعلانات إلى أجل غير مسمى، اضبط هذا الحقل على ‎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 هذا الحقل مطلوب لعمليات الإنشاء. هذا الحقل غير قابل للتغيير في "حملات Shopping".
salesCountry

string

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

integer

أولوية الحملة. تكون الحملات ذات الأولويات الأعلى رقميًا لها الأولوية على الحملات ذات الأولويات الأقل. هذا الحقل مطلوب لـ "حملات Shopping"، وتكون قيمه بين 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)

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

string

اسم المورد للعميل مالك إجراء الإحالة الناجحة، أو قيمة فارغة إذا كان هذا إجراء إحالة ناجحة محدّدًا من النظام.
includeInClientAccountConversionsMetric

boolean

ما إذا كان يجب تضمين إجراء الإحالة الناجحة هذا في مقياس "الإحالات الناجحة في حساب العميل".
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 نهائيًا واستبدالها بطريقة محسّنة لاستيراد إحالاتك الناجحة من Salesforce. - اطّلِع على https://support.google.com/google-ads/answer/14728349.
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 متبوعًا مباشرةً برقم أقل من 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 من النوع سمة.

العميل

عميل

تمثيل JSON 
{
  "resourceName": string,
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "accountType": enum (AccountType),
  "doubleClickCampaignManagerSetting": {
    object (DoubleClickCampaignManagerSetting)
  },
  "accountStatus": enum (AccountStatus),
  "lastModifiedTime": string,
  "engineId": string,
  "status": enum (CustomerStatus),
  "creationTime": string,
  "managerId": string,
  "managerDescriptiveName": string,
  "subManagerId": string,
  "subManagerDescriptiveName": string,
  "associateManagerId": string,
  "associateManagerDescriptiveName": string,
  "accountLevel": enum (AccountLevelType),
  "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 وحسب المنطقة الزمنية للعميل.
managerId

string (int64 format)

الرقم التعريفي للعميل المتعلق بالمدير تشير القيمة 0 إلى أنّ العميل ليس لديه حساب إداري على "إعلانات شبكة البحث 360".
managerDescriptiveName

string

الاسم الوصفي للمدير
subManagerId

string (int64 format)

الرقم التعريفي للعميل الخاص بالمدير الفرعي تشير القيمة 0 إلى أنّ العميل ليس لديه حساب مدير فرعي على "إعلانات شبكة البحث 360".
subManagerDescriptiveName

string

الاسم الوصفي للمدير الفرعي
associateManagerId

string (int64 format)

رقم تعريف العميل للمدير المساعد تشير القيمة 0 إلى أنّ العميل ليس لديه مدير مساعد في "إعلانات شبكة البحث 360".
associateManagerDescriptiveName

string

الاسم الوصفي للمدير المساعد
accountLevel

enum (AccountLevelType)

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

AccountLevelType

مصنّف يصف مستويات الحساب المحتملة

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
CLIENT_ACCOUNT_FACEBOOK حساب العميل (Facebook)
CLIENT_ACCOUNT_GOOGLE_ADS حساب العميل ("إعلانات Google")
CLIENT_ACCOUNT_MICROSOFT حساب العميل (Microsoft)
CLIENT_ACCOUNT_YAHOO_JAPAN حساب العميل (Yahoo Japan)
CLIENT_ACCOUNT_ENGINE_TRACK حساب العميل (تتبُّع محرّكات البحث)
MANAGER حساب المدير في المستوى الأعلى
SUB_MANAGER حساب مدير فرعي
ASSOCIATE_MANAGER حساب المدير الشريك

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

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

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

تمثيل سلسلة Common Locale Data Repository (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

عرض قيمة فئة عروض أسعار المنتجات المترجَمة وفقًا لـ languageCode

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

عرض أداء "التسوّق على YouTube" يوفّر إحصاءات حملات 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 UserList ممثّلة كمجموعة من أنواع الإحالات الناجحة
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 qty. يتحمّل المعلِن مسؤولية تعبئة المَعلمة ديناميكيًا (مثل عدد السلع التي تم بيعها في الإحالة الناجحة)، وإلا سيتم ضبطها تلقائيًا على 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

إجمالي عدد التحويلات. ويشمل ذلك جميع الإحالات الناجحة بغض النظر عن قيمة includeInConversionsMetric.
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

عدد الإحالات الناجحة. لا يشمل ذلك سوى إجراءات الإحالات الناجحة التي تم ضبط السمة includeInConversionsMetric عليها على true. إذا كنت تستخدِم عروض أسعار مستندة إلى الإحالات الناجحة، ستعمل استراتيجيات عروض الأسعار على تحسين الأداء لتحقيق هذه الإحالات الناجحة.
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 في 1 نيسان (أبريل) 2018. بالتنسيق 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. يشير إلى ما إذا كانت مقاييس التفاعل قد حدثت على مادة العرض نفسها أو على مادة عرض أو وحدة إعلانية مختلفة.