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,
  "trackingUrlTemplate": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus),
  "finalUrlSuffix": string
}
الحقول
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) أو أحرف NL لإنهاء السطر (قيمة موضع الرمز 0xA) أو أحرف الرجوع إلى أول السطر (قيمة موضع الرمز 0xD).
trackingUrlTemplate

string

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

string (int64 format)

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

enum (AdGroupEngineStatus)

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

string

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

AdGroupStatus

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

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

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

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

AdGroupType

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

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

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

هذه قيمة مخصّصة للردود فقط.
SEARCH_STANDARD نوع المجموعة الإعلانية التلقائي لـ "الحملات على شبكة البحث"
DISPLAY_STANDARD نوع المجموعة الإعلانية التلقائي في "الحملات على الشبكة الإعلانية"
SHOPPING_PRODUCT_ADS نوع المجموعة الإعلانية في "حملات Shopping" التي تعرض إعلانات المنتجات العادية
SHOPPING_SHOWCASE_ADS نوع المجموعات الإعلانية التي يقتصر عرضها على "إعلانات عرض صور المنتجات" أو إعلانات Merchant في نتائج Shopping
HOTEL_ADS نوع المجموعة الإعلانية التلقائي في "حملات الفنادق"
SHOPPING_SMART_ADS نوع المجموعات الإعلانية في "حملات التسوّق الذكية"
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

الحالات المحتملة لـ AdGroupAd.

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

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

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

FinalAppUrl

عنوان URL للربط بصفحة معيّنة في تطبيق لنظام التشغيل المحدّد

تمثيل JSON 
{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}
الحقول
osType

enum (AppUrlOperatingSystemType)

نظام التشغيل المستهدَف من خلال عنوان URL هذا. الحقل مطلوب.
url

string

عنوان URL لرابط لصفحة في التطبيق تحدّد الروابط لصفحات في التطبيق موقعًا في التطبيق يتوافق مع المحتوى الذي تريد عرضه، ويجب أن تكون على الشكل {scheme}://{host_path} ويحدّد المخطط التطبيق الذي سيتم فتحه. بالنسبة إلى تطبيقك، يمكنك استخدام مخطط مخصّص يبدأ باسم التطبيق. يحدّد المضيف والمسار الموقع الجغرافي الفريد في التطبيق الذي يتوفّر فيه المحتوى. مثال: "exampleapp://productid_1234". الحقل مطلوب.

AppUrlOperatingSystemType

نظام التشغيل

عمليات التعداد
UNSPECIFIED لم يتم تحديد أي قيمة.
UNKNOWN يُستخدَم لقيمة العائد فقط. تمثّل قيمة غير معروفة في هذا الإصدار.
IOS نظام التشغيل Apple IOS
ANDROID نظام التشغيل Android

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

نص مُلحق بـ path1 مع محدد
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

نص مُلحق بـ path1 مع محدد
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/{ownerCustomerId}/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/{ownerCustomerId}/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. يتراوح نطاق PreferredContent بين 1.0 و6.0. استخدِم القيمة 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
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "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 القيمة "removed"، لأنّه لم تتم إضافة أي معيار إيجابي.
qualityInfo

object (QualityInfo)

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

enum (CriterionType)

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

string

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

string

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

object (PositionEstimates)

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

string

قائمة بعناوين URL النهائية المحتملة بعد كل عمليات إعادة التوجيه عبر النطاقات للإعلان.
finalMobileUrls[]

string

قائمة بعناوين URL النهائية المحتملة للأجهزة الجوّالة بعد كل عمليات إعادة التوجيه عبر النطاقات
urlCustomParameters[]

object (CustomParameter)

قائمة عمليات الربط المستخدَمة لاستبدال علامات المَعلمات المخصّصة في trackingUrlTemplate أو finalUrls أو mobile_final_urls
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

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

عمليات التعداد
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 تم إيقاف معيار الاستهداف مؤقتًا لأنّ الحساب متوقف مؤقتًا.

CustomParameter

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

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

string

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

string

القيمة المطلوب استبدالها

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/{ownerCustomerId}/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/{ownerCustomerId}/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/{ownerCustomerId}/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/{ownerCustomerId}/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
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": 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 النهائية المحتملة بعد كل عمليات إعادة التوجيه عبر النطاقات
finalMobileUrls[]

string

قائمة بعناوين URL النهائية المحتملة للأجهزة الجوّالة بعد جميع عمليات إعادة التوجيه على مستوى النطاقات
urlCustomParameters[]

object (CustomParameter)

قائمة بعمليات الربط التي سيتم استخدامها لاستبدال علامات مَعلمات عناوين URL المخصّصة في trackingUrlTemplate وfinalUrls و/أو finalMobileUrls.
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 للتتبّع
finalUrlSuffix

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

تعداد يصف حالات "محرك مواد العرض" المحتملة.

عمليات التعداد
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 الخاص بـ image/jpeg
IMAGE_GIF نوع MIME للصورة/ملف GIF
IMAGE_PNG نوع MIME الخاص بـ image/png.
FLASH نوع MIME لتطبيق/x-shockwave-flash
TEXT_HTML نوع MIME الخاص بـ text/html
PDF نوع MIME الخاص بتطبيق/pdf.
MSWORD نوع MIME لتطبيق/msword
MSEXCEL نوع MIME للتطبيق/vnd.ms-excel
RTF نوع MIME لتطبيق/rtf.
AUDIO_WAV نوع MIME لملف الصوت/wav.
AUDIO_MP3 نوع MIME لملف الصوت/mp3
HTML5_AD_ZIP نوع MIME لتطبيق/x-html5-ad-zip

ImageDimension

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

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

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 Ads.

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

تعدادات الأرباع ساعة على سبيل المثال، "خمسة عشر"

عمليات التعداد
UNSPECIFIED لم يتم تحديد أي قيمة.
UNKNOWN القيمة غير معروفة في هذا الإصدار.
ZERO صفر دقيقة بعد الساعة
FIFTEEN خمس عشرة دقيقة بعد الساعة.
THIRTY بعد نصف ساعة من الساعة.
FORTY_FIVE خمس وأربعون دقيقة بعد الساعة.

DayOfWeek

تعدّد أيام الأسبوع، مثل "الاثنين".

عمليات التعداد
UNSPECIFIED لم يتم تحديد أي قيمة.
UNKNOWN القيمة غير معروفة في هذا الإصدار.
MONDAY الاثنين
TUESDAY الثلاثاء
WEDNESDAY الأربعاء
THURSDAY الخميس
FRIDAY الجمعة
SATURDAY السبت
SUNDAY الأحد

UnifiedSitelinkAsset

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

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

string

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

string

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

string

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

string

تمثّل هذه السمة تاريخ بدء عرض هذا الأصل، بالتنسيق yyyy-MM-dd.
endDate

string

آخر تاريخ يكون فيه هذا الأصل ساريًا ويستمر في العرض، بالتنسيق yyyy-MM-dd.
adScheduleTargets[]

object (AdScheduleInfo)

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

string (int64 format)

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

boolean

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

boolean

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

UnifiedPageFeedAsset

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

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

string

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

string

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

MobileAppAsset

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

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

string

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

enum (MobileAppVendor)

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

MobileAppVendor

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

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

UnifiedCallAsset

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

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

string

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

string

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

enum (CallConversionReportingState)

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

string

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

object (AdScheduleInfo)

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

boolean

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

boolean

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

boolean

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

string

تمثّل هذه السمة تاريخ بدء عرض هذا الأصل، بالتنسيق yyyy-MM-dd.
endDate

string

آخر تاريخ يكون فيه هذا الأصل ساريًا ويستمر في العرض، بالتنسيق yyyy-MM-dd.

CallConversionReportingState

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

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

CallToActionAsset

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

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

enum (CallToActionType)

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

CallToActionType

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

عمليات التعداد
UNSPECIFIED لم يتم تحديد أي قيمة.
UNKNOWN يُستخدَم لقيمة العائد فقط. تمثّل قيمة غير معروفة في هذا الإصدار.
LEARN_MORE نوع عبارة الحثّ على اتّخاذ إجراء هو "مزيد من المعلومات".
GET_QUOTE نوع عبارة الحث على اتخاذ إجراء هو "الحصول على عرض أسعار".
APPLY_NOW نوع عبارة الحث على اتخاذ إجراء هو "تقديم طلب الآن".
SIGN_UP نوع عبارة الحث على اتخاذ إجراء هو الاشتراك.
CONTACT_US نوع عبارة الحث على اتخاذ إجراء هو "تواصل معنا".
SUBSCRIBE نوع عبارة الحث على اتخاذ إجراء هو "اشتراك".
DOWNLOAD نوع عبارة الحث على اتخاذ إجراء هو "تنزيل".
BOOK_NOW نوع عبارة الحث على اتّخاذ إجراء هو "احجز الآن".
SHOP_NOW نوع عبارة الحث على اتخاذ إجراء هو "تسوق الآن".
BUY_NOW نوع عبارة الحث على اتخاذ إجراء هو "شراء الآن".
DONATE_NOW نوع عبارة الحث على اتخاذ إجراء هو "تبرّع الآن".
ORDER_NOW نوع عبارة الحث على اتخاذ إجراء هو "اطلب الآن".
PLAY_NOW نوع عبارة الحث على اتخاذ إجراء هو "تشغيل الآن".
SEE_MORE نوع عبارة الحثّ على اتّخاذ إجراء هو "عرض المزيد".
START_NOW نوع عبارة الحث على اتّخاذ إجراء هو "ابدأ الآن".
VISIT_SITE نوع عبارة الحث على اتخاذ إجراء هو زيارة الموقع الإلكتروني.
WATCH_NOW نوع عبارة الحث على اتخاذ إجراء هو "المشاهدة الآن".

UnifiedLocationAsset

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

تمثيل JSON 
{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}
الحقول
placeId

string

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

object (BusinessProfileLocation)

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

enum (LocationOwnershipType)

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

BusinessProfileLocation

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

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

string

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

string

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

string (int64 format)

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

LocationOwnershipType

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

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

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

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 تم استخدام مادة العرض في عنوان طويل (يُستخدَم في إعلان متجاوب متعدد مواد العرض).
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 تُستخدَم مادة العرض كنموذج عملاء محتملين.
DESCRIPTION_PREFIX تُستخدَم مادة العرض كبادئة للوصف.

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

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

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

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

هذا الحقل مخصّص للقراءة فقط.
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

الحالات المحتملة لـ BiddingStrategy.

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

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

هذه قيمة مخصّصة للردود فقط.
ENABLED تكون استراتيجية عروض الأسعار مفعَّلة.
REMOVED تتم إزالة استراتيجية عروض الأسعار.

BiddingStrategyType

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

عمليات التعداد
UNSPECIFIED لم يتم تحديد أي قيمة.
UNKNOWN يُستخدَم لقيمة العائد فقط. تمثّل قيمة غير معروفة في هذا الإصدار.
COMMISSION العمولة هي استراتيجية عروض أسعار مبرمَجة يدفع فيها المعلِن جزءًا معيّنًا من قيمة الإحالة الناجحة.
ENHANCED_CPC تكلفة النقرة المحسّنة هي استراتيجية عروض أسعار ترفع عروض الأسعار للنقرات التي يزداد احتمال أن تؤدي إلى إحالة ناجحة، وتخفضها للنقرات التي يقل احتمال أن تؤدي إلى إحالة ناجحة.
INVALID يُستخدَم لقيمة العائد فقط. تشير إلى أنّ الحملة ليس لديها استراتيجية عروض أسعار. ويمنع ذلك الحملة من عرض الإعلانات. على سبيل المثال، قد تكون الحملة مرتبطة باستراتيجية عروض أسعار تابعة لحساب إداري، ثم يتم إلغاء ربط حساب العرض بالحساب الإداري. في هذه الحالة، سيتم تلقائيًا فصل الحملة عن استراتيجية عروض الأسعار الخاصة بالمدير التي يتعذّر الوصول إليها الآن، والانتقال إلى نوع استراتيجية عروض الأسعار INVALID.
MANUAL_CPA استراتيجية عروض أسعار يدوية تسمح للمعلِن بتحديد عرض السعر لكل إجراء يحدّده المعلِن.
MANUAL_CPC عرض الأسعار المستند إلى النقرات اليدوية حيث يدفع المستخدم مقابل كل نقرة
MANUAL_CPM عروض الأسعار اليدوية المستندة إلى مرات الظهور، حيث يدفع المستخدم مقابل كل ألف مرّة ظهور.
MANUAL_CPV استراتيجية عروض أسعار تدفع مبلغًا قابلاً للتعديل مقابل كل مشاهدة فيديو.
MAXIMIZE_CONVERSIONS استراتيجية عروض أسعار تزيد تلقائيًا من عدد الإحالات الناجحة في حدود ميزانية يومية.
MAXIMIZE_CONVERSION_VALUE استراتيجية عروض أسعار مبرمَجة تحدِّد عروض الأسعار تلقائيًا لزيادة الأرباح إلى أقصى حدّ مع إنفاق ميزانيتك.
PAGE_ONE_PROMOTED مخطط عروض أسعار "الإعلانات المحسّنة على الصفحة الأولى"، الذي يضبط عروض الأسعار القصوى للنقرة لاستهداف مرات الظهور في الصفحة الأولى أو في مواضع الإعلانات المحسّنة على الصفحة الأولى على google.com. تم إيقاف هذه القيمة تعدادية نهائيًا.
PERCENT_CPC "النسبة المئوية لتكلفة النقرة" هي استراتيجية عروض أسعار تكون فيها عروض الأسعار جزءًا من السعر المُعلن عنه لبعض السلع أو الخدمات.
TARGET_CPA "التكلفة المستهدفة للإجراء" هي استراتيجية عروض أسعار مُبرمَجة تحدّد عروض الأسعار للمساعدة في الحصول على أكبر عدد ممكن من الإحالات الناجحة بالتكلفة المستهدفة للإجراء التي تحدّدها.
TARGET_CPM "التكلفة المستهدَفة لكلّ ألف ظهور" هي استراتيجية عروض أسعار مبرمَجة تحدّد عروض الأسعار للمساعدة في الحصول على أكبر عدد ممكن من مرّات الظهور بالتكلفة المستهدَفة لكلّ ألف ظهور التي تحدّدها.
TARGET_IMPRESSION_SHARE استراتيجية عروض أسعار مبرمَجة تضبط عروض الأسعار لكي يتم عرض نسبة مئوية معيّنة من الإعلانات على شبكة البحث في أعلى الصفحة الأولى (أو في موقع جغرافي مستهدَف آخر).
TARGET_OUTRANK_SHARE "حصة المرتبة الأعلى المستهدَفة" هي استراتيجية عروض أسعار مبرمَجة تضبط عروض الأسعار استنادًا إلى الجزء المستهدَف من المزادات الذي يجب أن يحقّق فيه المعلِن مرتبة أعلى من منافس معيّن. تم إيقاف قيمة التعداد هذه نهائيًا.
TARGET_ROAS "عائد الإنفاق الإعلاني المستهدَف" هي استراتيجية عروض أسعار مبرمَجة تساعدك في زيادة الأرباح إلى أقصى حدّ مع تحقيق متوسّط عائد إنفاق إعلاني مستهدَف محدّد.
TARGET_SPEND "الإنفاق المستهدف" هي استراتيجية عروض أسعار مبرمَجة تحدِّد عروض أسعارك للمساعدة في الحصول على أكبر عدد ممكن من النقرات في حدود ميزانيتك.

EnhancedCpc

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

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

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

MaximizeConversionValue

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

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

string (int64 format)

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

string (int64 format)

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

number

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

MaximizeConversions

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

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

TargetCpa

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

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

TargetImpressionShare

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

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

enum (TargetImpressionShareLocation)

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

string (int64 format)

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

string (int64 format)

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

TargetImpressionShareLocation

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

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

TargetOutrankShare

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

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

string (Int64Value format)

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

TargetRoas

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

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

number

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

string (int64 format)

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

string (int64 format)

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

TargetSpend

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

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

string (int64 format)

تم إيقافها نهائيًا: الإنفاق المستهدف الذي يجب تحقيقه لزيادة النقرات إلى أقصى حد. سيحاول مقدّم عروض الأسعار في استراتيجية "الإنفاق المستهدف" إنفاق المبلغ الأصغر من هذه القيمة أو مبلغ الإنفاق المحدود بشكل طبيعي. في حال عدم تحديدها، يتم استخدام الميزانية كهدف للإنفاق. تم إيقاف هذا الحقل نهائيًا ويجب عدم استخدامه بعد الآن. يمكنك الاطّلاع على 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,
  "feedTypes": [
    enum (AssetSetType)
  ],
  "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".
feedTypes[]

enum (AssetSetType)

أنواع الخلاصات التي يتم إرفاقها مباشرةً بهذه الحملة
id

string (int64 format)

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

string

اسم الحملة.

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

يجب ألّا يحتوي على أي أحرف فارغة (قيمة موضع الرمز 0x0) أو أحرف NL لإنهاء السطر (قيمة موضع الرمز 0xA) أو أحرف الرجوع إلى أول السطر (قيمة موضع الرمز 0xD).
trackingUrlTemplate

string

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

string

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

string

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

string

آخر يوم في الحملة في المنطقة الزمنية للعميل بالتنسيق YYYY-MM-DD عند الإنشاء، يتم ضبط القيمة التلقائية على 30-12-2037، ما يعني أنّ الحملة ستستمر إلى أجل غير مسمى. لضبط حملة حالية على العرض إلى أجل غير مسمى، اضبط هذا الحقل على 2037-12-30.
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

الحالات المحتملة للنظام في BiddingStrategy.

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

AdvertisingChannelSubType

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

عمليات التعداد
UNSPECIFIED لم يتم تحديد أي قيمة.
UNKNOWN يُستخدَم كقيمة إرجاع فقط. تمثّل قيمة غير معروفة في هذا الإصدار.
SEARCH_MOBILE_APP "حملات التطبيقات على الأجهزة الجوّالة" على "شبكة البحث"
DISPLAY_MOBILE_APP "حملات التطبيقات على الأجهزة الجوّالة" على "الشبكة الإعلانية"
SEARCH_EXPRESS حملات AdWords Express على شبكة البحث
DISPLAY_EXPRESS حملات AdWords Express على الشبكة الإعلانية
SHOPPING_SMART_ADS حملات التسوّق الذكية
DISPLAY_GMAIL_AD حملات "الإعلانات على Gmail"
DISPLAY_SMART_CAMPAIGN الحملات الذكية على الشبكة الإعلانية. لا يمكن إنشاء حملات جديدة من هذا النوع الفرعي.
VIDEO_OUTSTREAM حملات "خارج بث الفيديو"
VIDEO_ACTION حملات الفيديو TrueView for Action
VIDEO_NON_SKIPPABLE "حملات الفيديو" التي تتضمّن "إعلانات فيديو غير قابلة للتخطّي"
APP_CAMPAIGN "حملة تطبيقات" تتيح لك الترويج بسهولة لتطبيقك على Android أو iOS على أهم خدمات Google، بما في ذلك "بحث Google" وPlay وYouTube و"شبكة Google الإعلانية".
APP_CAMPAIGN_FOR_ENGAGEMENT "حملة التطبيقات" لزيادة التفاعل، وهي حملة تركّز على إعادة التفاعل مع التطبيق على عدّة من أهم خدمات Google، بما في ذلك "بحث Google" وYouTube و"شبكة Google الإعلانية".
LOCAL_CAMPAIGN حملات متخصّصة في الإعلانات المحلية
SHOPPING_COMPARISON_LISTING_ADS حملات بيانات المقارنة في Shopping
SMART_CAMPAIGN "الحملات الذكية" العادية
VIDEO_SEQUENCE "حملات الفيديو" التي تتضمّن إعلانات فيديو متسلسلة
APP_CAMPAIGN_FOR_PRE_REGISTRATION "حملة تطبيقات" للتسجيل المُسبَق، وهي حملة متخصّصة في الإعلان عن التسجيل المُسبَق لتطبيقات الأجهزة الجوّالة، وتستهدف قنوات إعلانية متعدّدة على Google Play وYouTube و"الشبكة الإعلانية".
VIDEO_REACH_TARGET_FREQUENCY "حملة فيديو تركّز على الوصول إلى الجمهور" تستخدِم استراتيجية عروض الأسعار "عدد مرّات الظهور المستهدَف"
TRAVEL_ACTIVITIES "حملات الأنشطة المتعلقة بالسفر"
SOCIAL_FACEBOOK_TRACKING_ONLY يتتبّع Facebook الحملات على وسائل التواصل الاجتماعي فقط.

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

الحقل مطلوب. رمز اللغة الذي يحدّد لغة النطاق، مثل "ar".
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 المستخدَم للتتبُّع الديناميكي

AssetSetType

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

عمليات التعداد
UNSPECIFIED لم يتم تحديد أي قيمة.
UNKNOWN يُستخدَم لقيمة العائد فقط. تمثّل قيمة غير معروفة في هذا الإصدار.
PAGE_FEED مجموعة مواد عرض الصفحة
DYNAMIC_EDUCATION مجموعة مواد عرض التعليم الديناميكي
MERCHANT_CENTER_FEED مجموعة مواد العرض في Google Merchant Center
DYNAMIC_REAL_ESTATE مجموعة مواد عرض العقارات الديناميكية
DYNAMIC_CUSTOM مجموعة مواد عرض مخصّصة ديناميكية
DYNAMIC_HOTELS_AND_RENTALS مجموعة مواد عرض ديناميكية للفنادق وأماكن الاستئجار
DYNAMIC_FLIGHTS مجموعة مواد عرض رحلات الطيران الديناميكية
DYNAMIC_TRAVEL مجموعة مواد عرض السفر الديناميكية
DYNAMIC_LOCAL مجموعة مواد العرض المحلية الديناميكية
DYNAMIC_JOBS مجموعة مواد عرض الوظائف الديناميكية
LOCATION_SYNC مجموعة مواد عرض على مستوى مزامنة الموقع الجغرافي
BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP مجموعة مواد عرض مجموعة المواقع الجغرافية في "الملف التجاري"
CHAIN_DYNAMIC_LOCATION_GROUP مجموعة مواد عرض مجموعة المواقع الجغرافية التابعة لسلسلة متاجر، ويمكن استخدامها لكلّ من المواقع الجغرافية المملوكة والمواقع الجغرافية للشركاء التابعين
STATIC_LOCATION_GROUP مجموعة مواد عرض مجموعة المواقع الجغرافية الثابتة التي يمكن استخدامها لكلّ من المواقع الجغرافية المملوكة والمواقع الجغرافية للشركاء التابعين
HOTEL_PROPERTY مجموعة مواد عرض الفندق المستخدَمة لربط خلاصة فندق بـ "حملات الأداء الأفضل" المستندة إلى أهداف السفر
TRAVEL_FEED نوع مجموعة مواد العرض في خلاصة السفر يمكن أن تمثّل إما خلاصة فنادق أو خلاصة "أماكن مقترَحة" (أنشطة).

ManualCpa

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

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

ManualCpc

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

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

boolean

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

ManualCpm

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

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

PercentCpc

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

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

string (int64 format)

الحدّ الأقصى لعرض السعر الذي يمكن ضبطه من خلال استراتيجية عروض الأسعار هذا حقل اختياري يُدخله المعلِن ويتم تحديده في المواقع الجغرافية الصغيرة المحلية. ملاحظة: يتم تفسير القيمة الصفرية بالطريقة نفسها التي يتم بها تفسير bid_ceiling غير المحدّدة.
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

الحالات المحتملة لـ CampaignCriterion.

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

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

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

LanguageInfo

معيار اللغة

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

string

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

LocationGroupInfo

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

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

string

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

enum (LocationGroupRadiusUnits)

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

string

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

string (int64 format)

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

LocationGroupRadiusUnits

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

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

CampaignEffectiveLabel

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

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

string

اسم المورد تتّخذ أسماء موارد CampaignEffectivelabel الشكل التالي: customers/{ownerCustomerId}/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/{ownerCustomerId}/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 لإجراء إحالة ناجحة هي false، لن يكون إجراء الإحالة الناجحة قابلاً لتقديم عروض الأسعار في جميع الحملات بغض النظر عن هدف الإحالة الناجحة للعميل أو هدف الإحالة الناجحة للحملة. ومع ذلك، لا تلتزم أهداف الإحالات الناجحة المخصّصة بالسمة primaryForGoal، لذا إذا تمّ ضبط هدف إحالة ناجحة مخصّص في حملة باستخدام إجراء إحالة ناجحة primaryForGoal = false، سيظلّ من الممكن تقديم عروض أسعار لإجراء الإحالة الناجحة هذا. تكون قيمة primaryForGoal تلقائية هي "صحيح" إذا لم يتم ضبطها. في الإصدار 9، لا يمكن ضبط primaryForGoal على "خطأ" إلا بعد الإنشاء من خلال عملية "تعديل" لأنّه لم يتم تعريفه على أنّه اختياري.
ownerCustomer

string

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

boolean

تحديد ما إذا كان يجب تضمين إجراء الإحالة الناجحة هذا في مقياس "clientAccountConversions".
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

فئة الإحالات الناجحة المرتبطة بـ ConversionAction

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

متغيّر الإحالة الناجحة المخصّص في انتظار التفعيل ولن يتم تجميع الإحصاءات إلى أن يتم ضبطه على ENABLED.

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

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 من النوع "رقم". يمكن تعيين هذا المتغيّر لمتغيّرات Floodlight من النوع DIMENSION أو METRIC.
STRING تمثّل هذه السمة متغيّر Floodlight من النوع "سلسلة". يمكن تعيين هذا المتغيّر لمتغيّرات Floodlight من النوع DIMENSION.

العميل

أحد العملاء

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

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

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

string (int64 format)

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

TargetImpressionShare

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

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

enum (TargetImpressionShareLocation)

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

string (int64 format)

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

string (int64 format)

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

TargetRoas

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

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

number

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

TargetSpend

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

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

string (int64 format)

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

string (int64 format)

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

ManagerLinkStatus

الحالات المحتملة للرابط

عمليات التعداد
UNSPECIFIED لم يتم تحديد أي قيمة.
UNKNOWN يُستخدَم لقيمة العائد فقط. تمثّل قيمة غير معروفة في هذا الإصدار.
ACTIVE تشير إلى العلاقة الحالية السارية
INACTIVE تشير إلى علاقة تم إنهاؤها
PENDING تشير إلى أنّ المدير طلب إنشاء علاقة، ولكنّ العميل لم يقبل الطلب بعد.
REFUSED طلب الحساب الإداري إنشاء علاقة، ولكن رفض العميل الطلب.
CANCELED يشير إلى أنّ الحساب الإداري طلب إنشاء علاقة، ولكنّه ألغاها.

CustomerClient

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

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

string

اسم المورِد الخاص بحساب العميل تتّخذ أسماء موارد CustomerClient الشكل التالي: customers/{customerId}/customerClients/{client_customer_id}
appliedLabels[]

string

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

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

enum (CustomerStatus)

حالة العميل. للقراءة فقط.
clientCustomer

string

اسم المورِد الخاص بالعميل المرتبط بالعميل المحدّد للقراءة فقط.
hidden

boolean

تحدِّد هذه السمة ما إذا كان هذا الحساب مخفيًا.

للقراءة فقط.
level

string (int64 format)

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

string

تمثيل السلسلة في مستودع 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/{ownerCustomerId}/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

لون خلفية التصنيف بتنسيق HEX يجب أن تتطابق هذه السلسلة مع التعبير العادي ‎ '^#([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

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

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

string

تمثّل هذه السمة اسم المورد الخاص بطريقة عرض "أداء التسوّق". تتّخذ أسماء موارد طريقة عرض أداء التسوّق الشكل التالي: customers/{customerId}/shoppingPerformanceView

UserList

قائمة مستخدمين هذه قائمة بالمستخدمين الذين يمكن للعميل استهدافهم.

تمثيل JSON 
{
  "resourceName": string,
  "type": enum (UserListType),
  "id": string,
  "name": string
}
الحقول
resourceName

string

اسم المورد لقائمة المستخدِمين. تتّخذ أسماء موارد قوائم المستخدِمين الشكل التالي:

customers/{customerId}/userLists/{user_list_id}
type

enum (UserListType)

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

هذا الحقل مخصّص للقراءة فقط.
id

string (int64 format)

معرّف قائمة المستخدمين.
name

string

اسم قائمة المستخدمين هذه استنادًا إلى access_reason، قد لا يكون اسم قائمة المستخدمين فريدًا (على سبيل المثال، إذا كانت access_reason=SHARED).

UserListType

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

عمليات التعداد
UNSPECIFIED لم يتم تحديد أي قيمة.
UNKNOWN يُستخدَم لقيمة العائد فقط. تمثّل قيمة غير معروفة في هذا الإصدار.
REMARKETING قائمة المستخدمين ممثّلة كمجموعة من أنواع الإحالات الناجحة.
LOGICAL قائمة المستخدمين ممثّلة كمجموعة من قوائم المستخدمين/الاهتمامات الأخرى.
EXTERNAL_REMARKETING قائمة المستخدمين التي تم إنشاؤها في منصة "مدير إعلانات Google"
RULE_BASED UserList المرتبطة بقاعدة
SIMILAR UserList تتضمّن مستخدمين مشابهين لمستخدمي UserList أخرى.
CRM_BASED UserList هي قائمة ببيانات الطرف الأول من نظام إدارة علاقات العملاء (CRM) يقدّمها المعلِن في شكل رسائل إلكترونية أو تنسيقات أخرى.

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

حالة الإحالة الناجحة، إما ENABLED أو REMOVED.
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,
  "uniqueUsers": string,
  "averageImpressionFrequencyPerUser": 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

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

number

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

number

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

number

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

string (int64 format)

مجموع تكلفة النقرة (CPC) والتكلفة لكل ألف ظهور خلال هذه الفترة. هذا المقياس هو قيمة نقدية ويتم عرضه بعملة العميل تلقائيًا. راجِع المَعلمة metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
costPerAllConversions

number

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

number

متوسط التكلفة المؤهّلة للإحالة الناجحة لكلّ إحالة ناجحة يمكن ضبط عرض سعر لها.
costPerCurrentModelAttributedConversion

number

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

string (int64 format)

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

number

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

القيمة

حاوية بيانات عامة

تمثيل JSON 
{

  // Union field value can be only one of the following:
  "booleanValue": boolean,
  "int64Value": string,
  "floatValue": number,
  "doubleValue": number,
  "stringValue": string
  // End of list of possible types for union field value.
}
الحقول
حقل الدمج value قيمة يمكن أن تكون value إحدى القيم التالية فقط:
booleanValue

boolean

قيمة منطقية
int64Value

string (int64 format)

تمثّل هذه السمة عددًا صحيحًا من النوع int64.
floatValue

number

قيمة عددية ذات فاصلة عشرية
doubleValue

number

عدد مزدوج
stringValue

string

سلسلة

QualityScoreBucket

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

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

InteractionEventType

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

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

الشرائح

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

تمثيل JSON 
{
  "adNetworkType": enum (AdNetworkType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionCustomDimensions": [
    {
      object (Value)
    }
  ],
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "keyword": {
    object (Keyword)
  },
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "productSoldCondition": enum (ProductCondition),
  "rawEventConversionDimensions": [
    {
      object (Value)
    }
  ],
  "conversionAction": string,
  "conversionActionName": string,
  "date": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetMetro": string,
  "geoTargetRegion": string,
  "hour": integer,
  "month": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productItemId": string,
  "productLanguage": string,
  "productSoldBiddingCategoryLevel1": string,
  "productSoldBiddingCategoryLevel2": string,
  "productSoldBiddingCategoryLevel3": string,
  "productSoldBiddingCategoryLevel4": string,
  "productSoldBiddingCategoryLevel5": string,
  "productSoldBrand": string,
  "productSoldCustomAttribute0": string,
  "productSoldCustomAttribute1": string,
  "productSoldCustomAttribute2": string,
  "productSoldCustomAttribute3": string,
  "productSoldCustomAttribute4": string,
  "productSoldItemId": string,
  "productSoldTitle": string,
  "productSoldTypeL1": string,
  "productSoldTypeL2": string,
  "productSoldTypeL3": string,
  "productSoldTypeL4": string,
  "productSoldTypeL5": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "week": string,
  "year": integer,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
الحقول
adNetworkType

enum (AdNetworkType)

نوع شبكة الإعلانات:
conversionActionCategory

enum (ConversionActionCategory)

فئة إجراء الإحالة الناجحة
conversionCustomDimensions[]

object (Value)

السمات المخصّصة للإحالات الناجحة
dayOfWeek

enum (DayOfWeek)

يوم من الأسبوع، على سبيل المثال، الاثنين
device

enum (Device)

الجهاز الذي تنطبق عليه المقاييس
keyword

object (Keyword)

معيار الكلمة الرئيسية:
productChannel

enum (ProductChannel)

قناة المنتج
productChannelExclusivity

enum (ProductChannelExclusivity)

تُستخدَم لتحديد ما إذا كان المنتج متوفّرًا حصريًا على قناة معيّنة.
productCondition

enum (ProductCondition)

تمثّل هذه السمة حالة المنتج.
productSoldCondition

enum (ProductCondition)

تمثّل هذه السمة حالة المنتج المباع.
rawEventConversionDimensions[]

object (Value)

سمات الإحالات الناجحة على مستوى الحدث الأوّلية
conversionAction

string

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

string

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

string

التاريخ الذي تنطبق عليه المقاييس، بالتنسيق yyyy-MM-dd، مثلاً ‎2018-04-17
geoTargetCity

string

اسم المورد لثابت الاستهداف الجغرافي الذي يمثّل مدينة.
geoTargetCountry

string

اسم المورد لثابت الاستهداف الجغرافي الذي يمثّل بلدًا
geoTargetMetro

string

اسم المورد لثابت الاستهداف الجغرافي الذي يمثّل مدينة كبرى
geoTargetRegion

string

اسم المورد لثابت الاستهداف الجغرافي الذي يمثّل منطقة
hour

integer

ساعة اليوم كعدد بين 0 و23، شاملة.
month

string

الشهر كما هو ممثّل بتاريخ اليوم الأول من الشهر يجب أن يكون التنسيق yyyy-MM-dd.
productBiddingCategoryLevel1

string

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

string

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

string

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

string

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

string

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

string

تمثّل هذه السمة العلامة التجارية للمنتج.
productCountry

string

اسم مصدر ثابت الاستهداف الجغرافي لبلد بيع المنتج.
productCustomAttribute0

string

السمة المخصّصة 0 للمنتج.
productCustomAttribute1

string

السمة المخصّصة 1 للمنتج.
productCustomAttribute2

string

السمة المخصّصة 2 للمنتج.
productCustomAttribute3

string

السمة المخصّصة 3 للمنتج.
productCustomAttribute4

string

السمة المخصّصة 4 للمنتج
productItemId

string

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

string

اسم المورد لثابت اللغة الذي يمثّل لغة المنتج.
productSoldBiddingCategoryLevel1

string

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

string

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

string

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

string

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

string

فئة عروض الأسعار (المستوى 5) للمنتج المُباع.
productSoldBrand

string

تمثّل هذه السمة العلامة التجارية للمنتج المباع.
productSoldCustomAttribute0

string

السمة المخصّصة 0 للمنتج المُباع.
productSoldCustomAttribute1

string

السمة المخصّصة 1 للمنتج المُباع.
productSoldCustomAttribute2

string

السمة المخصّصة 2 للمنتج المُباع.
productSoldCustomAttribute3

string

السمة المخصّصة 3 للمنتج المُباع.
productSoldCustomAttribute4

string

السمة المخصّصة 4 للمنتج المُباع.
productSoldItemId

string

معرّف السلعة للمنتج الذي تم بيعه.
productSoldTitle

string

عنوان المنتج المُباع
productSoldTypeL1

string

نوع المنتج المُباع (المستوى 1)
productSoldTypeL2

string

نوع المنتج المُباع (المستوى 2)
productSoldTypeL3

string

نوع المنتج المُباع (المستوى 3)
productSoldTypeL4

string

نوع المنتج المُباع (المستوى 4)
productSoldTypeL5

string

نوع المنتج المُباع (المستوى 5)
productStoreId

string

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

string

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

string

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

string

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

string

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

string

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

string

تمثّل هذه السمة نوع المنتج (المستوى 5).
quarter

string

الربع كما هو ممثّل بتاريخ اليوم الأول من الربع يستخدم السنة التقويمية للأرباع، على سبيل المثال، يبدأ الربع الثاني من عام 2018 في 2018-04-01. يجب أن يكون التنسيق yyyy-MM-dd.
week

string

الأسبوع هو الفترة من الاثنين إلى الأحد، ويتم تمثيله بتاريخ يوم الاثنين. يجب أن يكون التنسيق yyyy-MM-dd.
year

integer

السنة، بتنسيق yyyy
assetInteractionTarget

object (AssetInteractionTarget)

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

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. توضّح هذه السمة ما إذا كانت مقاييس التفاعل قد حدثت على مادة العرض نفسها أو على مادة عرض أو وحدة إعلانية مختلفة.