SearchAds360Row

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

تمثيل JSON
{
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "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)
  },
  "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)
  },
  "webpageView": {
    object (WebpageView)
  },
  "visit": {
    object (Visit)
  },
  "conversion": {
    object (Conversion)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  },
  "customColumns": [
    {
      object (Value)
    }
  ]
}
الحقول
adGroup

object (AdGroup)

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

adGroupAd

object (AdGroupAd)

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

adGroupAdLabel

object (AdGroupAdLabel)

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

adGroupAsset

object (AdGroupAsset)

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

adGroupAssetSet

object (AdGroupAssetSet)

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

adGroupAudienceView

object (AdGroupAudienceView)

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

adGroupBidModifier

object (AdGroupBidModifier)

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

adGroupCriterion

object (AdGroupCriterion)

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

adGroupCriterionLabel

object (AdGroupCriterionLabel)

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

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)

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

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)

العميل المشار إليه في الاستعلام.

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)

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

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
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus)
}
الحقول
resourceName

string

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

customers/{customerId}/adGroups/{ad_group_id}

status

enum (AdGroupStatus)

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

type

enum (AdGroupType)

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

adRotationMode

enum (AdGroupAdRotationMode)

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

creationTime

string

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

targetingSetting

object (TargetingSetting)

إعداد لاستهداف الميزات ذات الصلة.

labels[]

string

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

engineId

string

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

startDate

string

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

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

endDate

string

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

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

languageCode

string

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

lastModifiedTime

string

التاريخ والوقت الذي تم فيه إجراء آخر تعديل على هذه المجموعة الإعلانية. التاريخ والوقت في المنطقة الزمنية للعميل وفي "ي ي-ش ش-س س س س ث ث:دد:ث ث.sssss" .

id

string (int64 format)

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

name

string

اسم المجموعة

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

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

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

cpcBidMicros

string (int64 format)

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

engineStatus

enum (AdGroupEngineStatus)

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

AdGroupStatus

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

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

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

هذه قيمة مخصّصة للردّ فقط.

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

AdGroupType

يشير ذلك المصطلح إلى تعداد يتضمّن الأنواع المحتمَلة لمجموعة إعلانية.

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

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

هذه قيمة مخصّصة للردّ فقط.

SEARCH_STANDARD النوع التلقائي للمجموعة الإعلانية في "الحملات على شبكة البحث".
DISPLAY_STANDARD نوع المجموعة الإعلانية التلقائي للحملات على الشبكة الإعلانية.
SHOPPING_PRODUCT_ADS نوع المجموعة الإعلانية لحملات Shopping التي تعرض إعلانات منتجات عادية.
SHOPPING_SHOWCASE_ADS نوع المجموعات الإعلانية التي تقتصر على عرض إعلانات عرض الصور أو إعلانات التجّار في نتائج Shopping.
HOTEL_ADS نوع المجموعة الإعلانية التلقائي لحملات الفنادق.
SHOPPING_SMART_ADS نوع المجموعات الإعلانية في حملات Shopping الذكية.
VIDEO_BUMPER الإعلانات القصيرة غير القابلة للتخطي أثناء عرض الفيديو
VIDEO_TRUE_VIEW_IN_STREAM إعلانات فيديو TrueView (قابلة للتخطي) أثناء عرض الفيديو.
VIDEO_TRUE_VIEW_IN_DISPLAY إعلانات فيديو TrueView ضمن العرض
VIDEO_NON_SKIPPABLE_IN_STREAM الإعلانات غير القابلة للتخطي أثناء عرض الفيديو.
VIDEO_OUTSTREAM إعلانات خارج بث الفيديو
SEARCH_DYNAMIC_ADS نوع المجموعة الإعلانية للمجموعات الإعلانية للإعلانات الديناميكية على شبكة البحث.
SHOPPING_COMPARISON_LISTING_ADS نوع المجموعات الإعلانية في حملات مقارنة الأسعار على Shopping.
PROMOTED_HOTEL_ADS نوع المجموعة الإعلانية للمجموعات الإعلانية للفنادق التي يتم الترويج لها.
VIDEO_RESPONSIVE المجموعات الإعلانية المتجاوبة مع إعلانات الفيديو:
VIDEO_EFFICIENT_REACH المجموعات الإعلانية ذات الوصول الفعّال إلى الفيديو
SMART_CAMPAIGN_ADS نوع المجموعة الإعلانية لـ "الحملات الذكية".
TRAVEL_ADS نوع المجموعة الإعلانية لـ "حملات السفر".

AdGroupAdRotationMode

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

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

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

هذه قيمة مخصّصة للردّ فقط.

OPTIMIZE تحسين إعلانات المجموعة الإعلانية استنادًا إلى النقرات أو الإحالات الناجحة.
ROTATE_FOREVER عرض الإعلانات بالتناوب بشكل متساوٍ إلى الأبد.

AdGroupEngineStatus

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

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

تمّ الإيقاف. يُرجى عدم استخدامها.

AD_GROUP_EXPIRED لا يتم عرض أي إعلانات لهذه المجموعة الإعلانية؛ نظرًا لأن تاريخ انتهاء المجموعة انقضى.
AD_GROUP_REMOVED تم حذف المجموعة الإعلانية.
AD_GROUP_DRAFT لا يتم عرض أي إعلانات لهذه المجموعة الإعلانية لأن المجموعة الإعلانية المرتبطة لا تزال في حالة مسودة.
AD_GROUP_PAUSED تم إيقاف المجموعة الإعلانية مؤقتًا.
AD_GROUP_SERVING المجموعة الإعلانية نشطة وتعرض الإعلانات حاليًا.
AD_GROUP_SUBMITTED تم إرسال المجموعة الإعلانية (الحالة القديمة من Microsoft Bing Ads).
CAMPAIGN_PAUSED لا يتم عرض أي إعلانات لهذه المجموعة الإعلانية، لأنه تم إيقاف الحملة مؤقتًا.
ACCOUNT_PAUSED لا يتم عرض أي إعلانات لهذه المجموعة الإعلانية، لأنه تم إيقاف الحساب مؤقتًا.

TargetingSetting

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

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

object (TargetRestriction)

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

TargetRestriction

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

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

enum (TargetingDimension)

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

bidOnly

boolean

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

TargetingDimension

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

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم للقيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
KEYWORD معايير الكلمة الرئيسية، على سبيل المثال، "رحلة بحرية في المريخ". يمكن استخدام الكلمة الرئيسية كبُعد لعرض سعر مخصص. الكلمات الرئيسية هي دائمًا سمة استهداف، لذا لا يمكن ضبطها كقيمة مستهدفة "الكل" باستخدام TargetRestriction.
AUDIENCE معايير الجمهور، والتي تشمل قائمة المستخدمين، واهتمامات المستخدمين، والجمهور المخصّص ذي الاهتمامات المشتركة، والجمهور المخصّص في السوق.
TOPIC معايير المواضيع لاستهداف فئات المحتوى، مثل "category::حيوانات>حيوانات أليفة" تُستخدَم لاستهداف الشبكة الإعلانية والفيديو.
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
  ],
  "engineId": string,
  "engineStatus": enum (AdGroupAdEngineStatus),
  "lastModifiedTime": string
}
الحقول
resourceName

string

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

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

status

enum (AdGroupAdStatus)

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

ad

object (Ad)

الإعلان.

creationTime

string

الطابع الزمني لوقت إنشاء إعلان المجموعة الإعلانية هذا. التاريخ والوقت في المنطقة الزمنية للعميل وفي "ي ي-ش ش-س س س س ث ث:دد:ث ث.sssss" .

labels[]

string

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

engineId

string

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

engineStatus

enum (AdGroupAdEngineStatus)

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

lastModifiedTime

string

التاريخ والوقت الذي تم فيه إجراء آخر تعديل على إعلان المجموعة الإعلانية. التاريخ والوقت في المنطقة الزمنية للعميل وفي "ي ي-ش ش-س س س س ث ث:دد:ث ث.sssss" .

AdGroupAdStatus

الحالات المحتملة لإعلان GroupAd.

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

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

هذه قيمة مخصّصة للردّ فقط.

ENABLED تم تفعيل إعلان المجموعة الإعلانية.
PAUSED إعلان المجموعة الإعلانية متوقف مؤقتًا.
REMOVED تمت إزالة إعلان المجموعة الإعلانية.

AdType

أنواع الإعلانات المحتملة.

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

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

هذه قيمة مخصّصة للردّ فقط.

TEXT_AD الإعلان عبارة عن إعلان نصي.
EXPANDED_TEXT_AD الإعلان عبارة عن إعلان نصي موسَّع.
CALL_ONLY_AD يكون الإعلان للاتصال فقط.
EXPANDED_DYNAMIC_SEARCH_AD هذا الإعلان عبارة عن إعلان ديناميكي موسّع على شبكة البحث.
HOTEL_AD هذا الإعلان هو إعلان فندق.
SHOPPING_SMART_AD هذا الإعلان هو إعلان Shopping ذكي.
SHOPPING_PRODUCT_AD الإعلان هو إعلان Shopping عادي.
VIDEO_AD ويكون هذا الإعلان إعلان فيديو.
GMAIL_AD هذا الإعلان عبارة عن إعلان على Gmail.
IMAGE_AD هذا الإعلان عبارة عن إعلان مصوّر.
RESPONSIVE_SEARCH_AD هذا الإعلان هو إعلان متجاوب على شبكة البحث.
LEGACY_RESPONSIVE_DISPLAY_AD الإعلان هو إعلان صوري متجاوب قديم.
APP_AD الإعلان هو إعلان تطبيق.
LEGACY_APP_INSTALL_AD الإعلان قديم لتثبيت تطبيق.
RESPONSIVE_DISPLAY_AD الإعلان هو إعلان صوري متجاوب.
LOCAL_AD إذا كان الإعلان عبارة عن إعلان محلي.
HTML5_UPLOAD_AD الإعلان هو إعلان تحميل صوري لنوع المنتج HTML5_UPLOAD_AD.
DYNAMIC_HTML5_AD الإعلان عبارة عن إعلان تحميل صوري يضم أحد أنواع المنتجات DYNAMIC_HTML5_*.
APP_ENGAGEMENT_AD الإعلان هو إعلان جذب إلى تطبيق.
SHOPPING_COMPARISON_LISTING_AD هذا الإعلان هو إعلان مقارنة أسعار.
VIDEO_BUMPER_AD إعلان ملصق الفيديو الصغير.
VIDEO_NON_SKIPPABLE_IN_STREAM_AD إعلان فيديو غير قابل للتخطي ضمن البث.
VIDEO_OUTSTREAM_AD إعلان خارج بث الفيديو
VIDEO_TRUEVIEW_DISCOVERY_AD إعلان فيديو TrueView ضمن العرض.
VIDEO_TRUEVIEW_IN_STREAM_AD إعلان فيديو TrueView أثناء عرض الفيديو.
VIDEO_RESPONSIVE_AD إعلان فيديو متجاوب.
SMART_CAMPAIGN_AD إعلان حملة ذكية.
APP_PRE_REGISTRATION_AD إعلان تسجيل مُسبَق للتطبيقات العامة
DISCOVERY_MULTI_ASSET_AD إعلان متعدد مواد العرض أثناء التصفّح
TRAVEL_AD إعلان سفر
DISCOVERY_VIDEO_RESPONSIVE_AD إعلان فيديو متجاوب أثناء التصفّح
MULTIMEDIA_AD إعلان متعدد الوسائط.

SearchAds360TextAdInfo

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

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

string

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

description1

string

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

description2

string

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

displayUrl

string

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

displayMobileUrl

string

عنوان URL المعروض للأجهزة الجوّالة للإعلان.

adTrackingId

string (int64 format)

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

SearchAds360ExpandedTextAdInfo

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

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

string

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

headline2

string

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

headline3

string

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

description1

string

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

description2

string

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

path1

string

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

path2

string

سيتم إلحاق النص بالمسار 1 باستخدام محدِّد.

adTrackingId

string (int64 format)

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

SearchAds360ResponsiveSearchAdInfo

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

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

object (AdTextAsset)

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

descriptions[]

object (AdTextAsset)

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

path1

string

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

path2

string

سيتم إلحاق النص بالمسار 1 باستخدام محدِّد.

adTrackingId

string (int64 format)

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

AdTextAsset

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

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

string

نص مادة العرض.

SearchAds360ProductAdInfo

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

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

SearchAds360ExpandedDynamicSearchAdInfo

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

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

string

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

description2

string

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

adTrackingId

string (int64 format)

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

AdGroupAdEngineStatus

لتعداد حالات محرك AdGroupAd.

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

تمّ الإيقاف. يُرجى عدم استخدامها.

AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN Baidu: لم تتم الموافقة على تصميم الإعلان.
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW Baidu: عنوان URL للأجهزة الجوّالة قيد المراجعة.
AD_GROUP_AD_PARTIALLY_INVALID Baidu: تصميم الإعلان غير صالح على الأجهزة الجوّالة، ولكنه صالح على أجهزة الكمبيوتر المكتبي.
AD_GROUP_AD_TO_BE_ACTIVATED Baidu: تصميم الإعلان جاهز للتفعيل.
AD_GROUP_AD_NOT_REVIEWED Baidu: لم تتم مراجعة تصميم الإعلان.
AD_GROUP_AD_ON_HOLD

تمّ الإيقاف. يُرجى عدم استخدامها. سبق أن استخدمه Gemini

AD_GROUP_AD_PAUSED تم إيقاف التصميم مؤقتًا.
AD_GROUP_AD_REMOVED تمت إزالة التصميم.
AD_GROUP_AD_PENDING_REVIEW تصميم الإعلان في انتظار المراجعة.
AD_GROUP_AD_UNDER_REVIEW تصميم الإعلان قيد المراجعة.
AD_GROUP_AD_APPROVED تمت الموافقة على التصميم.
AD_GROUP_AD_DISAPPROVED تم رفض التصميم.
AD_GROUP_AD_SERVING يتم عرض تصميم الإعلان.
AD_GROUP_AD_ACCOUNT_PAUSED تم إيقاف تصميم الإعلان مؤقتًا لأن الحساب متوقف مؤقتًا.
AD_GROUP_AD_CAMPAIGN_PAUSED تم إيقاف تصميم الإعلان مؤقتًا لأن الحملة متوقفة مؤقتًا.
AD_GROUP_AD_AD_GROUP_PAUSED تم إيقاف تصميم الإعلان مؤقتًا لأن المجموعة الإعلانية متوقفة مؤقتًا.

AdGroupAdLabel

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

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

string

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

adGroupAd

string

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

label

string

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

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

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

string

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

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

AdGroupBidModifier

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

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

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

string

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

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

bidModifier

number

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

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

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

device

object (DeviceInfo)

معيار الجهاز

DeviceInfo

معيار الجهاز

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

enum (Device)

نوع الجهاز

الجهاز

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

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

AdGroupCriterion

معيار مجموعة إعلانية. لا يعرض تقرير adGroupcriterion سوى المعايير التي تمت إضافتها بشكل صريح إلى المجموعة الإعلانية.

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

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

string

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

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

creationTime

string

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

status

enum (AdGroupCriterionStatus)

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

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

qualityInfo

object (QualityInfo)

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

type

enum (CriterionType)

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

labels[]

string

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

positionEstimates

object (PositionEstimates)

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

finalUrls[]

string

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

engineId

string

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

lastModifiedTime

string

التاريخ والوقت الذي تم فيه إجراء آخر تعديل على معيار المجموعة الإعلانية هذا. التاريخ والوقت في المنطقة الزمنية للعميل وفي "ي ي-ش ش-س س س س ث ث:دد:ث ث.sssss" .

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 : المعيار في انتظار المراجعة
AD_GROUP_CRITERION_PAUSED تم إيقاف المعيار مؤقتًا.
AD_GROUP_CRITERION_REMOVED تمت إزالة المعيار.
AD_GROUP_CRITERION_APPROVED تمت الموافقة على المعيار.
AD_GROUP_CRITERION_DISAPPROVED تم رفض المعيار.
AD_GROUP_CRITERION_SERVING المعيار نشط ويتم عرضه.
AD_GROUP_CRITERION_ACCOUNT_PAUSED تم إيقاف المعيار مؤقتًا منذ أن تم إيقاف الحساب مؤقتًا.

KeywordInfo

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

تمثيل JSON
{
  "matchType": enum (KeywordMatchType),
  "text": string
}
الحقول
matchType

enum (KeywordMatchType)

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

text

string

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

KeywordMatchType

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

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

ListingGroupInfo

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

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

enum (ListingGroupType)

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

ListingGroupType

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

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

AgeRangeInfo

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

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

enum (AgeRangeType)

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

AgeRangeType

نوع الفئات العمرية الديمغرافية (مثلاً، بين 18 و24 عامًا).

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم للقيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
AGE_RANGE_18_24 بين 18 و24 عامًا
AGE_RANGE_25_34 بين 25 و34 عامًا
AGE_RANGE_35_44 بين 35 و44 عامًا
AGE_RANGE_45_54 بين 45 و54 عامًا
AGE_RANGE_55_64 بين 55 و64 عامًا
AGE_RANGE_65_UP 65 عامًا فما فوق.
AGE_RANGE_UNDETERMINED الفئة العمرية غير محدّدة.

GenderInfo

معيار الجنس

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

enum (GenderType)

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

GenderType

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

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

UserListInfo

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

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

string

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

WebpageInfo

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

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

object (WebpageConditionInfo)

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

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

coveragePercentage

number

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

criterionName

string

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

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

WebpageConditionInfo

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

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

enum (WebpageConditionOperand)

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

operator

enum (WebpageConditionOperator)

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

argument

string

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

WebpageConditionOperand

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

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

WebpageConditionOperator

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

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

LocationInfo

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

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

string

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

AdGroupCriterionLabel

يشير ذلك المصطلح إلى علاقة بين معيار مجموعة إعلانية وتصنيف.

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

string

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

adGroupCriterion

string

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

label

string

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

AdGroupLabel

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

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

string

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

adGroup

string

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

label

string

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

AgeRangeView

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

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

string

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

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

مادة العرض

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

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

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

string

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

customers/{customerId}/assets/{assetId}

type

enum (AssetType)

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

finalUrls[]

string

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

status

enum (AssetStatus)

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

creationTime

string

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

lastModifiedTime

string

التاريخ والوقت الذي تم فيه إجراء آخر تعديل على مادة العرض هذه التاريخ والوقت في المنطقة الزمنية للعميل وفي "ي ي-ش ش-س س س س ث ث:دد:ث ث.sssss" .

id

string (int64 format)

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

name

string

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

trackingUrlTemplate

string

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

engineStatus

enum (AssetEngineStatus)

حالة المحرّك لمادة العرض.

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

object (YoutubeVideoAsset)

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

imageAsset

object (ImageAsset)

مادة عرض صورة

textAsset

object (TextAsset)

مادة عرض نصية

calloutAsset

object (UnifiedCalloutAsset)

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

pageFeedAsset

object (UnifiedPageFeedAsset)

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

mobileAppAsset

object (MobileAppAsset)

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

callAsset

object (UnifiedCallAsset)

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

callToActionAsset

object (CallToActionAsset)

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

locationAsset

object (UnifiedLocationAsset)

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

AssetType

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

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

AssetStatus

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

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

AssetEngineStatus

رقم التعريف التالي = 11

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم للقيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
SERVING مادة العرض نشطة.
SERVING_LIMITED مادة العرض نشطة ومحدودة.
DISAPPROVED مادة العرض مرفوضة (غير مؤهَّلة).
DISABLED مادة العرض غير نشطة (في انتظار المراجعة).
REMOVED تمّت إزالة مادة العرض.

YoutubeVideoAsset

مادة عرض على YouTube

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

string

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

youtubeVideoId

string

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

ImageAsset

مادة عرض صورة

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

enum (MimeType)

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

fullSize

object (ImageDimension)

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

fileSize

string (int64 format)

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

MimeType

نوع MIME

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

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

هذه قيمة مخصّصة للردّ فقط.

IMAGE_JPEG نوع MIME للصورة/jpeg.
IMAGE_GIF نوع MIME للصورة/صورة GIF
IMAGE_PNG نوع الصورة MIME/png
FLASH نوع MIME للتطبيق/x-shockwave-flash.
TEXT_HTML نوع MIME للنص/html.
PDF نوع MIME للتطبيق/ملف pdf.
MSWORD نوع MIME للتطبيق/كلمة msword.
MSEXCEL نوع MIME للتطبيق/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

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

يتم تحديد Adالجدول في يوم من الأسبوع والفاصل الزمني الذي سيتم عرض الإعلانات خلاله.

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

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

enum (MinuteOfHour)

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

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

endMinute

enum (MinuteOfHour)

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

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

dayOfWeek

enum (DayOfWeek)

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

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

startHour

integer

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

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

endHour

integer

ساعة الانتهاء بعد 24 ساعة بينما يشير الرقم 24 إلى نهاية اليوم. يجب أن يكون الرقم ضمنًا بين 0 و24.

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

MinuteOfHour

تعداد ربع ساعة. على سبيل المثال، "FIFTEEN"

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN القيمة غير معروفة في هذا الإصدار.
ZERO صفر دقائق بعد الساعة.
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
}
الحقول
description1

string

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

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

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

phoneNumber

string

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

callConversionReportingState

enum (CallConversionReportingState)

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

callConversionAction

string

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

adScheduleTargets[]

object (AdScheduleInfo)

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

callOnly

boolean

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

callTrackingEnabled

boolean

لتحديد ما إذا كان ينبغي تفعيل المكالمة على تتبع المكالمات أم لا. ينطبق ذلك على Microsoft Ads.

useSearcherTimeZone

boolean

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

startDate

string

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

endDate

string

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

CallConversionReportingState

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

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

CallToActionAsset

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

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

enum (CallToActionType)

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

CallToActionType

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

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

UnifiedLocationAsset

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

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

string

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

businessProfileLocations[]

object (BusinessProfileLocation)

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

locationOwnershipType

enum (LocationOwnershipType)

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

BusinessProfileLocation

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

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

string

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

storeCode

string

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

listingId

string (int64 format)

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

LocationOwnershipType

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

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

AssetGroupSignal

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

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

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

string

اسم المورد لإشارة مجموعة مواد العرض يكون اسم مورد إشارة مجموعة مواد العرض بالشكل التالي:

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

assetGroup

string

مجموعة مواد العرض التي تنتمي إليها إشارة مجموعة مواد العرض هذه

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

object (AudienceInfo)

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

AudienceInfo

معيار شريحة الجمهور

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

string

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

AssetGroupListingGroupFilter

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

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

string

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

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

assetGroup

string

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

id

string (int64 format)

رقم تعريف ListingGroupFilter.

type

enum (ListingGroupFilterType)

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

vertical

enum (ListingGroupFilterVertical)

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

caseValue

object (ListingGroupFilterDimension)

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

parentListingGroupFilter

string

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

path

object (ListingGroupFilterDimensionPath)

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

ListingGroupFilterType

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

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

ListingGroupFilterVertical

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

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

ListingGroupFilterDimension

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

تمثيل JSON
{

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

object (ProductBiddingCategory)

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

productBrand

object (ProductBrand)

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

productChannel

object (ProductChannel)

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

productCondition

object (ProductCondition)

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

productCustomAttribute

object (ProductCustomAttribute)

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

productItemId

object (ProductItemId)

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

productType

object (ProductType)

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

ProductBiddingCategory

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

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

enum (ListingGroupFilterBiddingCategoryLevel)

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

id

string (int64 format)

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

يعادل هذا المعرّف معرّف فئة المنتجات من Google كما هو موضّح في هذه المقالة: 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

اسم المورد لعرض تركيبة من أعلى مجموعة مواد العرض ويكون أسماء موارد عرض "المجموعة الأفضل" في AssetGroup على النحو التالي: ""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 تم استخدام مادة العرض في عنوان طويل (مستخدَم في MultiAssetWebAd).
DESCRIPTION تم استخدام مادة العرض في الوصف. لا تستخدِم هذه السمة إلّا إذا كان هناك وصف واحد فقط في الإعلان. في الحالات الأخرى، يُرجى استخدام التعداد DESCRIPTION_1 أو DESCRIPTION_@.
DESCRIPTION_IN_PORTRAIT تم استخدام مادة العرض كوصف في الصورة العمودية.
BUSINESS_NAME_IN_PORTRAIT تم استخدام مادة العرض كاسم للنشاط التجاري في صورة عمودية.
BUSINESS_NAME تم استخدام مادة العرض كاسم للنشاط التجاري.
MARKETING_IMAGE تم استخدام مادة العرض كصورة تسويقية.
MARKETING_IMAGE_IN_PORTRAIT تم استخدام مادة العرض كصورة تسويقية في صورة عمودية.
SQUARE_MARKETING_IMAGE تم استخدام مادة العرض كصورة تسويقية مربّعة.
PORTRAIT_MARKETING_IMAGE تم استخدام مادة العرض كصورة تسويقية عمودية.
CALL_TO_ACTION تم استخدام مادة العرض كعبارة تحث المستخدم على اتخاذ إجراء.
YOU_TUBE_VIDEO وتم استخدام مادة العرض كفيديو على YouTube.
CALL يتم استخدام مادة العرض هذه كمكالمة.
MOBILE_APP يتم استخدام مادة العرض هذه كتطبيق للأجهزة الجوّالة.
CALLOUT يتم استخدام مادة العرض هذه كوسيلة شرح.
STRUCTURED_SNIPPET يتم استخدام مادة العرض هذه كمقتطف من الموقع.
PRICE يتم استخدام مادة العرض هذه كسعر.
PROMOTION يتم استخدام مادة العرض هذه كعرض ترويجي.
AD_IMAGE يتم استخدام مادة العرض هذه كصورة.
LEAD_FORM تُستخدَم مادة العرض كنموذج عملاء محتملين.

AssetGroup

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

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

string

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

customers/{customerId}/assetGroups/{asset_group_id}

id

string (int64 format)

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

campaign

string

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

name

string

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

finalUrls[]

string

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

finalMobileUrls[]

string

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

status

enum (AssetGroupStatus)

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

path1

string

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

path2

string

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

adStrength

enum (AdStrength)

قوة الإعلان الإجمالية لمجموعة مواد العرض هذه.

AssetGroupStatus

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

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

AdStrength

تعداد يسرد نقاط قوة الإعلان المحتملة.

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم للقيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
PENDING قوة الإعلان في انتظار المراجعة حاليًا.
NO_ADS تعذّر إنشاء أي إعلانات.
POOR القوة ضعيفة.
AVERAGE متوسط القوة.
GOOD قوة جيدة.
EXCELLENT قوة ممتازة

AssetSetAsset

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

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

string

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

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

assetSet

string

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

asset

string

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

status

enum (AssetSetAssetStatus)

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

AssetSetAssetStatus

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

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

AssetSet

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

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

string (int64 format)

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

resourceName

string

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

customers/{customerId}/assetSets/{asset_set_id}

BiddingStrategy

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

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

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

string

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

customers/{customerId}/biddingStrategies/{bidding_strategy_id}

status

enum (BiddingStrategyStatus)

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

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

type

enum (BiddingStrategyType)

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

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

currencyCode

string

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

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

id

string (int64 format)

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

name

string

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

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

effectiveCurrencyCode

string

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

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

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

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

campaignCount

string (int64 format)

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

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

nonRemovedCampaignCount

string (int64 format)

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

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

حقل الاتحاد scheme. نظام عروض الأسعار.

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

enhancedCpc

object (EnhancedCpc)

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

maximizeConversionValue

object (MaximizeConversionValue)

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

maximizeConversions

object (MaximizeConversions)

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

targetCpa

object (TargetCpa)

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

targetImpressionShare

object (TargetImpressionShare)

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

targetOutrankShare

object (TargetOutrankShare)

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

targetRoas

object (TargetRoas)

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

targetSpend

object (TargetSpend)

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

BiddingStrategyStatus

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

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

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

هذه قيمة مخصّصة للردّ فقط.

ENABLED تفعيل استراتيجية عروض الأسعار.
REMOVED تمت إزالة استراتيجية عروض الأسعار.

BiddingStrategyType

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

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

EnhancedCpc

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

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

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

MaximizeConversionValue

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

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

string (int64 format)

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

cpcBidFloorMicros

string (int64 format)

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

targetRoas

number

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

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% تساوي 10000.

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)

الفترة التي يتم إنفاق الميزانية خلالها. إعداد القيمة التلقائية على "يومي" إذا لم يتم تحديده.

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)
  },
  "labels": [
    string
  ],
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "engineId": string,
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "createTime": string,
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "campaignBudget": string,
  "startDate": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "urlExpansionOptOut": boolean,

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

string

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

customers/{customerId}/campaigns/{campaign_id}

status

enum (CampaignStatus)

حالة الحملة.

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

servingStatus

enum (CampaignServingStatus)

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

biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

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

adServingOptimizationStatus

enum (AdServingOptimizationStatus)

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

advertisingChannelType

enum (AdvertisingChannelType)

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

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

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

advertisingChannelSubType

enum (AdvertisingChannelSubType)

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

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

urlCustomParameters[]

object (CustomParameter)

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

realTimeBiddingSetting

object (RealTimeBiddingSetting)

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

networkSettings

object (NetworkSettings)

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

dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

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

shoppingSetting

object (ShoppingSetting)

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

geoTargetTypeSetting

object (GeoTargetTypeSetting)

إعداد الاستهداف الجغرافي للإعلانات.

labels[]

string

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

biddingStrategyType

enum (BiddingStrategyType)

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

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

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

accessibleBiddingStrategy

string

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

excludedParentAssetFieldTypes[]

enum (AssetFieldType)

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

createTime

string

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

creationTime

string

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

lastModifiedTime

string

التاريخ والوقت الذي تم فيه إجراء آخر تعديل على هذه الحملة. التاريخ والوقت في المنطقة الزمنية للعميل وفي "ي ي-ش ش-س س س س ث ث:دد:ث ث.sssss" .

id

string (int64 format)

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

name

string

اسم الحملة.

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

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

trackingUrlTemplate

string

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

campaignBudget

string

ميزانية الحملة.

startDate

string

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

endDate

string

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

finalUrlSuffix

string

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

urlExpansionOptOut

boolean

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

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

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

biddingStrategy

string

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

manualCpa

object (ManualCpa)

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

manualCpc

object (ManualCpc)

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

manualCpm

object (ManualCpm)

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

maximizeConversions

object (MaximizeConversions)

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

maximizeConversionValue

object (MaximizeConversionValue)

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

targetCpa

object (TargetCpa)

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

targetImpressionShare

object (TargetImpressionShare)

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

targetRoas

object (TargetRoas)

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

targetSpend

object (TargetSpend)

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

percentCpc

object (PercentCpc)

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

targetCpm

object (TargetCpm)

استراتيجية عروض أسعار تُحسِّن التكلفة لكل ألف ظهور تلقائيًا.

CampaignStatus

الحالات المحتملة للحملة.

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

CampaignServingStatus

حالات العرض المحتملة لإحدى الحملات

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

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

هذه قيمة مخصّصة للردّ فقط.

SERVING يتم عرضها.
NONE بلا عُري
ENDED انْتَهَى.
PENDING Pending.
SUSPENDED تم تعليقه.

BiddingStrategySystemStatus

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

عمليات التعداد
UNSPECIFIED إشارات حدوث خطأ غير متوقّع، مثل عدم العثور على نوع استراتيجية عروض الأسعار أو عدم العثور على أي معلومات عن الحالة
UNKNOWN تُستخدَم للقيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
ENABLED إستراتيجية عروض الأسعار نشطة، ولم يتمكن AdWords من العثور على أي مشاكل محدّدة في الإستراتيجية.
LEARNING_NEW استراتيجية عروض الأسعار في مرحلة التعلّم لأنه تم إنشاؤها مؤخرًا أو تمت إعادة تفعيلها مؤخرًا.
LEARNING_SETTING_CHANGE استراتيجية عروض الأسعار في مرحلة التعلّم بسبب تغيير حديث في الإعدادات.
LEARNING_BUDGET_CHANGE استراتيجية عروض الأسعار في مرحلة التعلّم بسبب تغيير حديث في الميزانية.
LEARNING_COMPOSITION_CHANGE استراتيجية عروض الأسعار في مرحلة التعلّم بسبب تغيير حديث في عدد الحملات أو المجموعات الإعلانية أو الكلمات الرئيسية المرتبطة بها.
LEARNING_CONVERSION_TYPE_CHANGE تعتمد استراتيجية عروض الأسعار على إعداد تقارير الإحالات الناجحة، وقد عدّل العميل مؤخرًا أنواع الإحالات الناجحة التي كانت ذات صلة باستراتيجية عروض الأسعار.
LEARNING_CONVERSION_SETTING_CHANGE تعتمد استراتيجية عروض الأسعار على تقارير الإحالات الناجحة، وقد غيّر العميل إعدادات الإحالة الناجحة مؤخرًا.
LIMITED_BY_CPC_BID_CEILING تكون استراتيجية عروض الأسعار مقيَّدة بالحد الأقصى لعرض سعرها.
LIMITED_BY_CPC_BID_FLOOR تكون استراتيجية عروض الأسعار مقيَّدة بالحد الأدنى لعرض سعرها.
LIMITED_BY_DATA تكون استراتيجية عروض الأسعار محدودة بسبب عدم تلقّي عدد كافٍ من زيارات الإحالات الناجحة خلال الأسابيع الماضية.
LIMITED_BY_BUDGET هناك جزء كبير من الكلمات الرئيسية في استراتيجية عروض الأسعار هذه أدنى من حدود الميزانية المطلوبة.
LIMITED_BY_LOW_PRIORITY_SPEND لا يمكن أن تصل استراتيجية عروض الأسعار إلى الإنفاق الهدف بسبب عدم تحديد أولوية إنفاقها.
LIMITED_BY_LOW_QUALITY تتسم نسبة كبيرة من الكلمات الرئيسية في استراتيجية عروض الأسعار هذه بنقاط جودة منخفضة.
LIMITED_BY_INVENTORY لا يمكن لاستراتيجية عروض الأسعار إنفاق ميزانيتها بالكامل بسبب تضييق نطاق الاستهداف.
MISCONFIGURED_ZERO_ELIGIBILITY عدم توفّر ميزة تتبُّع الإحالات الناجحة (لا تتوفّر إشعارات) و/أو قوائم تجديد النشاط التسويقي ضمن حملة Shopping ذكية (SSC)
MISCONFIGURED_CONVERSION_TYPES تعتمد استراتيجية عروض الأسعار على إعداد تقارير الإحالات الناجحة، ويفتقر العميل إلى أنواع الإحالات الناجحة التي يمكن إعداد تقارير عنها لهذه الاستراتيجية.
MISCONFIGURED_CONVERSION_SETTINGS تعتمد استراتيجية عروض الأسعار على إعداد تقارير الإحالات الناجحة، ويتم إعداد إعدادات الإحالة الناجحة للعميل بشكلٍ خاطئ.
MISCONFIGURED_SHARED_BUDGET هناك حملات خارج استراتيجية عروض الأسعار تشترك في الميزانيات مع حملات مضمّنة في الاستراتيجية.
MISCONFIGURED_STRATEGY_TYPE تحتوي الحملة على نوع استراتيجية غير صالح ولا يتم عرض إعلاناتها.
PAUSED استراتيجية عروض الأسعار غير نشطة. لا توجد حملات أو مجموعات إعلانية أو كلمات رئيسية نشطة مرتبطة باستراتيجية عروض الأسعار. أو ليست هناك ميزانيات نشطة مرتبطة باستراتيجية عروض الأسعار.
UNAVAILABLE لا توفّر استراتيجية عروض الأسعار هذه حاليًا إعداد تقارير الحالة.
MULTIPLE_LEARNING كانت هناك حالات نظام LEARNING_* متعددة لاستراتيجية عروض الأسعار هذه خلال الفترة المعنية.
MULTIPLE_LIMITED كانت هناك حالات نظام LIMITED_* متعددة لاستراتيجية عروض الأسعار هذه خلال الفترة المعنية.
MULTIPLE_MISCONFIGURED كانت هناك حالات نظام MISCONFIGURED_* متعددة لاستراتيجية عروض الأسعار هذه خلال الفترة المعنية.
MULTIPLE كانت هناك حالات نظام متعددة لاستراتيجية عروض الأسعار هذه خلال الفترة المعنية.

AdServingOptimizationStatus

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

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

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

هذه قيمة مخصّصة للردّ فقط.

OPTIMIZE يتم تحسين عرض الإعلانات استنادًا إلى نسبة النقر إلى الظهور للحملة.
CONVERSION_OPTIMIZE يتم تحسين عرض الإعلانات استنادًا إلى نسبة النقر إلى الظهور * الإحالات الناجحة للحملة. إذا لم تكن الحملة ضمن استراتيجية عروض أسعار محسِّن الإحالات الناجحة، فسيتم ضبطها تلقائيًا على "محسَّن".
ROTATE يتم عرض الإعلانات بالتناوب بشكل متساوٍ لمدة 90 يومًا، ثم يتم تحسينها لزيادة النقرات.
ROTATE_INDEFINITELY اعرض الإعلانات الأقل أداءً بشكل متساوٍ مع الإعلانات الأعلى أداءً، ولا تُجري التحسين.
UNAVAILABLE حالة تحسين عرض الإعلانات غير متوفّرة.

AdvertisingChannelType

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

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم للقيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
SEARCH شبكة البحث. تتضمّن الحملات المجمّعة على الشبكة الإعلانية وحملات شبكة البحث.
DISPLAY شبكة Google الإعلانية فقط.
SHOPPING يتمّ عرض إعلانات "حملات التسوّق" على موقع 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 حملات Shopping الذكية:
DISPLAY_GMAIL_AD حملات الإعلانات على Gmail:
DISPLAY_SMART_CAMPAIGN الحملات الذكية على الشبكة الإعلانية. يتعذّر إنشاء حملات جديدة من هذا النوع الفرعي.
VIDEO_OUTSTREAM حملات الإعلانات خارج بث الفيديو
VIDEO_ACTION حملات فيديو TrueView for Action.
VIDEO_NON_SKIPPABLE حملات الفيديو التي تحتوي على إعلانات فيديو غير قابلة للتخطّي
APP_CAMPAIGN حملة تطبيقات تسمح لك بالترويج بسهولة لتطبيق Android أو iOS على أهم خدمات Google، بما في ذلك "بحث Google" وPlay وYouTube و"شبكة Google الإعلانية".
APP_CAMPAIGN_FOR_ENGAGEMENT حملة تطبيقات لجذب المستخدمين الحاليين، تركّز على زيادة إعادة التفاعل مع التطبيق في العديد من أهم خدمات Google، بما في ذلك "بحث Google" وYouTube و"شبكة Google الإعلانية".
LOCAL_CAMPAIGN حملات متخصصة للإعلانات المحلية.
SHOPPING_COMPARISON_LISTING_ADS حملات مقارنة بيانات Shopping:
SMART_CAMPAIGN الحملات الذكية العادية.
VIDEO_SEQUENCE حملات الفيديو التي تحتوي على إعلانات فيديو متسلسلة
APP_CAMPAIGN_FOR_PRE_REGISTRATION حملة تطبيقات للتسجيل المُسبَق، متخصصة في الإعلان عن التسجيل المُسبَق للتطبيقات المتوافقة مع الأجهزة الجوّالة، وتستهدف قنوات إعلانية متعددة على Google Play وYouTube و"الشبكة الإعلانية".
VIDEO_REACH_TARGET_FREQUENCY "حملة فيديو تركّز على الوصول إلى الجمهور" تستخدِم استراتيجية عروض أسعار "عدد مرّات الظهور المستهدَف".
TRAVEL_ACTIVITIES حملات أنشطة السفر
SOCIAL_FACEBOOK_TRACKING_ONLY يتتبع Facebook حملات الشبكات الاجتماعية فقط.

CustomParameter

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

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

string

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

value

string

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

RealTimeBiddingSetting

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

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

boolean

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

NetworkSettings

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

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

boolean

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

targetContentNetwork

boolean

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

targetPartnerSearchNetwork

boolean

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

DynamicSearchAdsSetting

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

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

string

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

languageCode

string

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

useSuppliedUrlsOnly

boolean

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

ShoppingSetting

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

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

string

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

useVehicleInventory

boolean

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

merchantId

string (int64 format)

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

salesCountry

string

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

campaignPriority

integer

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

enableLocal

boolean

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

GeoTargetTypeSetting

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

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

enum (PositiveGeoTargetType)

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

negativeGeoTargetType

enum (NegativeGeoTargetType)

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

PositiveGeoTargetType

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

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN القيمة غير معروفة في هذا الإصدار.
PRESENCE_OR_INTEREST لتحديد عرض الإعلان إذا كان المستخدم متواجدًا في المواقع الجغرافية المستهدفة للمعلِن أو أظهر اهتمامًا بها.
SEARCH_INTEREST لتحديد أنه يتم عرض إعلان إذا بحث المستخدم عن المواقع الجغرافية المستهدفة للمعلِن. ولا يمكن استخدامها إلا مع "الحملات على شبكة البحث" و"حملات Shopping العادية".
PRESENCE لتحديد أنه يتم عرض الإعلان إذا كان المستخدم موجودًا في المواقع المستهدفة للمعلِن أو يتواجد فيها بشكل منتظم.

NegativeGeoTargetType

أنواع الاستهدافات الجغرافية السلبية المحتملة.

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN القيمة غير معروفة في هذا الإصدار.
PRESENCE_OR_INTEREST لتحديد أنّ المستخدم مستبعد من مشاهدة الإعلان إذا كان في المواقع الجغرافية المستبعَدة للمعلِن أو أبدي اهتمامًا بها.
PRESENCE لتحديد أنّ المستخدم مستبعد من مشاهدة الإعلان إذا كان في المواقع الجغرافية المستثناة للمعلِن.

FrequencyCapEntry

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

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

SelectiveOptimization

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

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

string

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

OptimizationGoalSetting

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

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

enum (OptimizationGoalType)

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

OptimizationGoalType

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

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

TrackingSetting

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

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

string

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

ManualCpa

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

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

ManualCpc

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

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

boolean

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

ManualCpm

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

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

PercentCpc

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

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

string (int64 format)

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

enhancedCpcEnabled

boolean

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

TargetCpm

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

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

CampaignAsset

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

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

string

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

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

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

التاريخ والوقت الذي تم فيه إجراء آخر تعديل على معيار هذه الحملة. التاريخ والوقت في المنطقة الزمنية للعميل وفي "ي ي-ش ش-س س س س ث ث:دد:ث ث.sssss" .

criterionId

string (int64 format)

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

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

bidModifier

number

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

negative

boolean

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

حقل الاتحاد criterion. معيار الحملة.

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

keyword

object (KeywordInfo)

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

location

object (LocationInfo)

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

device

object (DeviceInfo)

الجهاز.

ageRange

object (AgeRangeInfo)

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

gender

object (GenderInfo)

الجنس

userList

object (UserListInfo)

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

language

object (LanguageInfo)

اللغة

webpage

object (WebpageInfo)

صفحة ويب.

locationGroup

object (LocationGroupInfo)

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

CampaignCriterionStatus

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

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

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

هذه قيمة مخصّصة للردّ فقط.

ENABLED معيار الحملة مُفعَّل.
PAUSED معيار الحملة متوقف مؤقتًا.
REMOVED تمت إزالة معيار الحملة.

LanguageInfo

معيار لغة

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

string

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

LocationGroupInfo

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

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

string

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

radiusUnits

enum (LocationGroupRadiusUnits)

وحدة النطاق الجغرافي. يتم دعم الأميال والأمتار لثوابت الموقع الجغرافي المستهدف. ويُسمح باستخدام أجهزة المللي ميل والمتر مع مجموعات عناصر الخلاصة. هذا الإجراء مطلوب ويجب ضبطه في عمليات CREATE.

feedItemSets[]

string

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

radius

string (int64 format)

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

LocationGroupRadiusUnits

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

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

CampaignLabel

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

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

string

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

campaign

string

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

label

string

التصنيف المعيَّن للحملة.

CartDataSalesView

عرض مبيعات بيانات سلة التسوّق

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

string

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

الجمهور

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

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

string

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

customers/{customerId}/audiences/{audience_id}

id

string (int64 format)

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

name

string

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

description

string

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

ConversionAction

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

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

string

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

customers/{customerId}/conversionActions/{conversion_action_id}

creationTime

string

طابع زمني لإنشاء نشاط Floodlight، ويكون منسَّقًا وفقًا لمعيار ISO 8601

status

enum (ConversionActionStatus)

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

type

enum (ConversionActionType)

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

category

enum (ConversionActionCategory)

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

valueSettings

object (ValueSettings)

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

attributionModelSettings

object (AttributionModelSettings)

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

floodlightSettings

object (FloodlightSettings)

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

id

string (int64 format)

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

name

string

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

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

primaryForGoal

boolean

إذا كانت قيمة المَعلمةPrimaryForGoal لإجراء إحالة ناجحة غير صحيحة، لا يمكن تقديم عروض أسعار لإجراء الإحالة الناجحة لجميع الحملات بغض النظر عن هدف الإحالة الناجحة للعميل أو هدف الإحالة الناجحة للحملة. مع ذلك، لا تلتزم أهداف الإحالات الناجحة المخصّصة بـPrimaryForGoal، لذا إذا كانت الحملة تحتوي على هدف إحالة ناجحة مخصّص تم ضبطه باستخدام إجراء إحالة ناجحة أساسي أساسي = خطأ، سيظل من الممكن تقديم عروض أسعار لإجراء الإحالة الناجحة هذا. بشكلٍ تلقائي، ستكون PrimaryForGoal القيمة "صحيحًا" إذا لم يتم ضبطها. في الإصدار V9، لا يمكن ضبط primaryForGoal على "خطأ" إلا بعد الإنشاء من خلال "تحديث". لأنه لم يتم تعريفه على أنه اختيارية.

ownerCustomer

string

اسم المورد لعميل مالك إجراء الإحالة الناجحة، أو قيمة خالية إذا كان هذا إجراء إحالة ناجحة من تحديد النظام.

includeInClientAccountConversionsMetric

boolean

ما إذا كان يجب تضمين إجراء الإحالة الناجحة هذا في "clientAccount اللازمة (الإحالات الناجحة)" المقياس.

includeInConversionsMetric

boolean

ما إذا كان يجب تضمين إجراء الإحالة الناجحة هذا في "الإحالات الناجحة" المقياس.

clickThroughLookbackWindowDays

string (int64 format)

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

appId

string

رقم تعريف التطبيق لإجراء إحالة ناجحة خاص بالتطبيق.

ConversionActionStatus

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

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم للقيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
ENABLED سيتم تسجيل الإحالات الناجحة.
REMOVED لن يتم تسجيل الإحالات الناجحة.
HIDDEN لن يتم تسجيل الإحالات الناجحة ولن يظهر إجراء الإحالة الناجحة في واجهة المستخدِم.

ConversionActionType

الأنواع المحتملة لإجراء الإحالة الناجحة.

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم للقيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
AD_CALL الإحالات الناجحة التي تحدث عندما ينقر المستخدم على إضافة المكالمة الخاصة بالإعلان.
CLICK_TO_CALL الإحالات الناجحة التي تحدث عندما ينقر أحد المستخدمين على جهاز جوّال على رقم هاتف.
GOOGLE_PLAY_DOWNLOAD الإحالات الناجحة التي تحدث عندما يُنزِّل أحد المستخدمين تطبيقًا للأجهزة الجوّالة من "متجر Google Play".
GOOGLE_PLAY_IN_APP_PURCHASE الإحالات الناجحة التي تحدث عندما يُجري المستخدم عملية شراء في تطبيق من خلال نظام الفوترة في Android.
UPLOAD_CALLS الإحالات الناجحة للمكالمات التي يتتبعها المعلن ويحمّلها.
UPLOAD_CLICKS الإحالات الناجحة التي يتتبّعها المعلِن ويتم تحميلها باستخدام نقرات يمكن تحديد مصدرها.
WEBPAGE الإحالات الناجحة التي تحدث على صفحة ويب.
WEBSITE_CALL الإحالات الناجحة التي تحدث عندما يتصل المستخدم برقم هاتف تم إنشاؤه ديناميكيًا من الموقع الإلكتروني للمعلِن.
STORE_SALES_DIRECT_UPLOAD الإحالة الناجحة للمبيعات في المتاجر استنادًا إلى عمليات تحميل بيانات التاجر الخاصة بالطرف الأول أو التابع لجهة خارجية. يمكن فقط للعملاء المدرَجين في القائمة المسموح بها استخدام أنواع التحميل المباشر للمبيعات في المتاجر.
STORE_SALES الإحالة الناجحة للمبيعات في المتاجر استنادًا إلى عمليات تحميل بيانات التاجر الخاصة بالطرف الأول أو التابع لطرف ثالث و/أو من عمليات الشراء في المتاجر باستخدام بطاقات من شبكات الدفع. يمكن للعملاء المدرَجين في القائمة المسموح بها فقط استخدام أنواع المبيعات في المتاجر. للقراءة فقط.
FIREBASE_ANDROID_FIRST_OPEN يتم تتبُّع الإحالات الناجحة المفتوحة لأول مرة لتطبيق Android من خلال Firebase.
FIREBASE_ANDROID_IN_APP_PURCHASE تتبُّع الإحالات الناجحة المتمثّلة بعملية شراء لتطبيقات Android من خلال Firebase.
FIREBASE_ANDROID_CUSTOM الإحالات الناجحة المخصّصة لتطبيقات Android التي يتم تتبُّعها من خلال Firebase
FIREBASE_IOS_FIRST_OPEN يتم تتبُّع الإحالات الناجحة المفتوحة لأول مرة لتطبيق iOS من خلال Firebase.
FIREBASE_IOS_IN_APP_PURCHASE تطبيق iOS ضمن الإحالات الناجحة المتمثّلة بعملية شراء، والتي يتم تتبُّعها من خلال Firebase.
FIREBASE_IOS_CUSTOM الإحالات الناجحة المخصّصة لتطبيق iOS التي يتم تتبُّعها من خلال Firebase
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN الإحالات الناجحة المفتوحة لأول مرة لتطبيق Android التي يتم تتبُّعها من خلال "إحصاءات التطبيقات التابعة لجهات خارجية"
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE الإحالات الناجحة المتمثّلة بعملية شراء لتطبيق Android ضمن التطبيق من خلال "إحصاءات التطبيقات التابعة لجهات خارجية"
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM الإحالات الناجحة المخصّصة لتطبيقات Android التي يتم تتبُّعها من خلال إحصاءات التطبيقات التابعة لجهات خارجية
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN الإحالات الناجحة المفتوحة لأول مرة لتطبيق iOS التي يتم تتبُّعها من خلال "إحصاءات التطبيقات التابعة لجهة خارجية"
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE تطبيق iOS ضمن الإحالات الناجحة المتمثّلة بعملية شراء، والتي يتم تتبُّعها من خلال "إحصاءات التطبيقات التابعة لجهات خارجية"
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM الإحالات الناجحة المخصّصة لتطبيق iOS التي يتم تتبُّعها من خلال إحصاءات التطبيقات التابعة لجهات خارجية
ANDROID_APP_PRE_REGISTRATION الإحالات الناجحة التي تحدث عندما يسجِّل المستخدم مسبقًا تطبيقًا للأجهزة الجوّالة من "متجر Google Play". للقراءة فقط.
ANDROID_INSTALLS_ALL_OTHER_APPS الإحالات الناجحة التي تتتبّع جميع عمليات التنزيل على Google Play والتي لا يتم تتبُّعها حسب نوع خاص بالتطبيق للقراءة فقط.
FLOODLIGHT_ACTION نشاط Floodlight الذي يحتسب عدد المرات التي زار فيها المستخدِمون صفحة ويب معيّنة بعد مشاهدة أحد إعلانات المعلِن أو النقر عليه. للقراءة فقط.
FLOODLIGHT_TRANSACTION نشاط Floodlight الذي يتتبّع عدد المبيعات المحقّقة أو عدد السلع المشتراة ويمكنه أيضًا تسجيل القيمة الإجمالية لكل عملية بيع. للقراءة فقط.
GOOGLE_HOSTED الإحالات الناجحة التي تتتبّع الإجراءات المحلية من منتجات Google وخدماتها بعد التفاعل مع إعلان للقراءة فقط.
LEAD_FORM_SUBMIT يتم الإبلاغ عن الإحالات الناجحة عندما يرسل أحد المستخدمين نموذج عملاء محتملين. للقراءة فقط.
SALESFORCE الإحالات الناجحة الواردة من Salesforce. للقراءة فقط.
SEARCH_ADS_360 الإحالات الناجحة المستورَدة من بيانات Floodlight في "إعلانات شبكة البحث 360". للقراءة فقط.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL الإحالات الناجحة للمكالمات التي تحدث على إعلانات الحملات الذكية بدون إعداد تتبُّع المكالمات، باستخدام معايير مخصّصة في الحملات الذكية. للقراءة فقط.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL ينقر المستخدم على عنصر اتصال في خرائط Google. الحملة الذكية فقط. للقراءة فقط.
SMART_CAMPAIGN_MAP_DIRECTIONS يطلب المستخدم الاتّجاهات إلى الموقع الجغرافي للنشاط التجاري في "خرائط Google". الحملة الذكية فقط. للقراءة فقط.
SMART_CAMPAIGN_TRACKED_CALLS الإحالات الناجحة للمكالمات التي تحدث على إعلانات الحملات الذكية مع إعداد ميزة تتبُّع المكالمات، باستخدام معايير مخصّصة في الحملات الذكية. للقراءة فقط.
STORE_VISITS الإحالات الناجحة التي تحدث عندما يزور أحد المستخدمين متجر البيع بالتجزئة للمعلِن. للقراءة فقط.
WEBPAGE_CODELESS الإحالات الناجحة التي يتم إنشاؤها من أحداث الموقع الإلكتروني (مثل عمليات إرسال النماذج أو عمليات تحميل الصفحات) والتي لا تستخدِم مقتطفات عن الأحداث المرمَّزة بشكل فردي للقراءة فقط.
UNIVERSAL_ANALYTICS_GOAL الإحالات الناجحة الواردة من أهداف Universal Analytics المرتبطة
UNIVERSAL_ANALYTICS_TRANSACTION الإحالات الناجحة الواردة من معاملات Universal Analytics المرتبطة
GOOGLE_ANALYTICS_4_CUSTOM الإحالات الناجحة الواردة من الإحالات الناجحة للأحداث المخصّصة المرتبطة في "إحصاءات Google 4".
GOOGLE_ANALYTICS_4_PURCHASE الإحالات الناجحة الواردة من الإحالات الناجحة المتمثّلة بعملية شراء من "إحصاءات Google 4".

ConversionActionCategory

فئة الإحالات الناجحة المرتبطة بإجراء الإحالة الناجحة.

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم للقيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
DEFAULT الفئة التلقائية.
PAGE_VIEW زيارة مستخدِم لصفحة
PURCHASE الشراء أو المبيعات أو "تم تقديم الطلب" فعالية.
SIGNUP إجراء المستخدم المتعلق بالاشتراك
LEAD إجراءات إنشاء قوائم العملاء المحتملين
DOWNLOAD إجراء تنزيل البرامج (بالنسبة إلى التطبيق)
ADD_TO_CART إضافة سلع إلى حقيبة أو سلة تسوّق على موقع إلكتروني لأحد المعلنين.
BEGIN_CHECKOUT عندما يبدأ أحد الأشخاص إجراءات سير عملية الدفع على موقع إلكتروني لأحد المعلنين.
SUBSCRIBE_PAID بداية اشتراك مدفوع لمنتج أو خدمة.
PHONE_CALL_LEAD عبارة عن دعوة إلى الإشارة إلى الاهتمام بعرض المعلِن.
IMPORTED_LEAD إحالة ناجحة عبر نموذج العملاء المحتملين تم استيرادها من مصدر خارجي إلى "إعلانات Google".
SUBMIT_LEAD_FORM نموذج إرسال على موقع إلكتروني لأحد المعلنين للإشارة إلى اهتمام النشاط التجاري
BOOK_APPOINTMENT حجز موعد مع النشاط التجاري الخاص بالمعلن
REQUEST_QUOTE طلب عرض أسعار تقديري أو تقدير للسعر
GET_DIRECTIONS عملية بحث عن الموقع الجغرافي الخاص بنشاط المعلِن بهدف زيارته
OUTBOUND_CLICK نقرة على الموقع الإلكتروني لأحد الشركاء
CONTACT مكالمة أو رسالة قصيرة SMS أو رسالة إلكترونية أو محادثة أو أي نوع آخر من التواصل مع أحد المعلنين
ENGAGEMENT حدث التفاعل مع الموقع الإلكتروني، مثل وقت طويل للموقع الإلكتروني أو هدف ذكي في "إحصاءات Google" مخصص للاستخدام لعمليات استيراد أهداف "إحصاءات Google" وFirebase و"إحصاءات Google" الذهبية.
STORE_VISIT زيارة إلى الموقع الجغرافي لمتجرك
STORE_SALE عملية بيع تحدث في متجر.
QUALIFIED_LEAD إحالة ناجحة من عميل محتمل تم استيرادها من مصدر خارجي إلى "إعلانات Google"، وتم تأهُّلها من قِبل المعلِن (فريق التسويق/المبيعات). خلال رحلتك بدءًا من جذب العميل المحتمل وصولاً إلى إتمام عملية بيع، يحصل المعلِنون على عملاء محتملين، ثمّ يتصرفون بناءً على ذلك من خلال التواصل مع المستهلك. إذا كان المستهلك مهتمًا وقد ينتهى إلى شراء منتجه، يضع المعلِن علامة "عملاء محتمَلين مؤهَّلين" على هذا النوع من العملاء.
CONVERTED_LEAD إحالة ناجحة عبر نموذج العملاء المحتملِين تمّ استيرادها من مصدر خارجي إلى "إعلانات Google"، وأكملت مرحلةً مختارةً على النحو المحدّد من قِبل المُعلِن عن إنشاء قوائم العملاء المحتملِين.

ValueSettings

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

تمثيل JSON
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
الحقول
defaultValue

number

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

defaultCurrencyCode

string

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

alwaysUseDefaultValue

boolean

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

AttributionModelSettings

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

تمثيل JSON
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
الحقول
attributionModel

enum (AttributionModel)

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

dataDrivenModelStatus

enum (DataDrivenModelStatus)

حالة نموذج تحديد المصدر بالاستناد إلى البيانات لإجراء الإحالة الناجحة.

AttributionModel

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

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم للقيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
EXTERNAL يتم استخدام نموذج تحديد المصدر الخارجي.
GOOGLE_ADS_LAST_CLICK يَنسِب هذا النموذج كل المساهمة في إتمام الإحالة الناجحة إلى نقرتها الأخيرة.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK ينسب هذا النموذج كل المساهمة في إتمام الإحالة الناجحة إلى النقرة الأولى باستخدام عملية تحديد المصدر على "بحث Google".
GOOGLE_SEARCH_ATTRIBUTION_LINEAR يَنسِب هذا النموذج نسبة المساهمة في إتمام الإحالة الناجحة بالتساوي على جميع نقراتها باستخدام عملية تحديد المصدر على "بحث Google".
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY يَنسِب هذا النموذج زيادة كبيرة في المساهمة في إتمام الإحالة الناجحة إلى النقرات التي أدّت إلى حدوثها مؤخرًا باستخدام عملية تحديد المصدر في "بحث Google" (نصف دورة الحياة هو أسبوع واحد).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED يَنسِب هذا النموذج% 40 من المساهمة في إتمام الإحالة الناجحة إلى نقرته الأولى والأخيرة. ويتم توزيع% 20 المتبقية بالتساوي على جميع النقرات الأخرى. يستخدم هذا الإجراء إحالة "بحث Google".
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN نموذج مرن يستخدم تعلُّم الآلة لتحديد التوزيع المناسب للرصيد بين النقرات باستخدام عملية تحديد المصدر على "بحث Google"

DataDrivenModelStatus

لتعداد حالات النموذج المستند إلى البيانات.

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم للقيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
AVAILABLE يتوفّر نموذج تحديد المصدر بالاستناد إلى البيانات.
STALE النموذج المستند إلى البيانات قديم. لم يتم تعديلها منذ 7 أيام على الأقل. لا يزال هذا العرض قيد الاستخدام، ولكنه سينتهي في حال عدم تحديثه لمدة 30 يومًا.
EXPIRED انتهت صلاحية النموذج المستند إلى البيانات. لم يتم تعديلها منذ 30 يومًا على الأقل ولا يمكن استخدامها. يعود السبب في هذه المشكلة في أغلب الأحيان إلى عدم توفّر العدد المطلوب من الأحداث في آخر 30 يومًا.
NEVER_GENERATED لم يتم إنشاء نموذج مستند إلى البيانات مطلقًا. يعود السبب في هذه المشكلة في أغلب الأحيان إلى عدم توفّر العدد المطلوب من الأحداث خلال فترة 30 يومًا.

FloodlightSettings

الإعدادات المرتبطة بإجراء إحالة ناجحة في Floodlight

تمثيل JSON
{
  "activityGroupTag": string,
  "activityTag": string,
  "activityId": string
}
الحقول
activityGroupTag

string

سلسلة تُستخدَم لتحديد مجموعة أنشطة Floodlight عند إعداد تقارير عن الإحالات الناجحة

activityTag

string

سلسلة تُستخدَم لتحديد نشاط Floodlight عند إعداد تقارير عن الإحالات الناجحة

activityId

string (int64 format)

رقم تعريف نشاط Floodlight في DoubleClick Campaign Manager (DCM).

ConversionCustomVariable

متغيّر مخصّص للإحالة الناجحة الاطّلاع على "لمحة عن مقاييس وسمات Floodlight المخصّصة في التجربة الجديدة من "إعلانات شبكة البحث 360" على https://support.google.com/sa360/answer/13567857

تمثيل JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "tag": string,
  "status": enum (ConversionCustomVariableStatus),
  "ownerCustomer": string,
  "family": enum (ConversionCustomVariableFamily),
  "cardinality": enum (ConversionCustomVariableCardinality),
  "floodlightConversionCustomVariableInfo": {
    object (FloodlightConversionCustomVariableInfo)
  },
  "customColumnIds": [
    string
  ]
}
الحقول
resourceName

string

اسم المورد للمتغيّر المخصَّص للإحالة الناجحة وتكون أسماء موارد المتغيّرات المخصّصة للإحالات الناجحة على النحو التالي:

customers/{customerId}/conversionCustomVariables/{conversion_custom_variable_id}

id

string (int64 format)

رقم تعريف المتغيّر المخصّص للإحالة الناجحة.

name

string

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

tag

string

مطلوب. علامة المتغيّر المخصّص للإحالة الناجحة. يجب أن تكون العلامة فريدة وأن تتألف من حرف "u". حرف متبوعًا برقم أقل من أو يساوي 100. على سبيل المثال: "u4".

status

enum (ConversionCustomVariableStatus)

حالة المتغيّر المخصّص للإحالة الناجحة لتراكم حدث الإحالة الناجحة.

ownerCustomer

string

اسم مورد العميل الذي يملك المتغيّر المخصَّص للإحالة الناجحة.

family

enum (ConversionCustomVariableFamily)

عائلة المتغيّر المخصّص للإحالة الناجحة.

cardinality

enum (ConversionCustomVariableCardinality)

عدد القيم الفريدة للمتغيّر المخصّص للإحالة الناجحة

floodlightConversionCustomVariableInfo

object (FloodlightConversionCustomVariableInfo)

حقول المتغيّرات المخصّصة للإحالات الناجحة في Floodlight في "إعلانات شبكة البحث 360"

customColumnIds[]

string (int64 format)

أرقام تعريف الأعمدة المخصّصة التي تستخدم هذا المتغيّر المخصّص للإحالة الناجحة.

ConversionCustomVariableStatus

الحالات المحتملة لمتغيّر مخصّص للإحالة الناجحة

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

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

لا يمكن استخدام هذه الحالة في طلبات CREATE وUPDATE.

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

ConversionCustomVariableFamily

عائلة متغيّر مخصّص للإحالة الناجحة

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

ConversionCustomVariableCardinality

عدد القيم الفريدة للمتغيّر المخصّص للإحالة الناجحة

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم للقيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
BELOW_ALL_LIMITS يحتوي المتغيّر المخصَّص للإحالة الناجحة على عدد عناصر في الحقل أقل من جميع الحدود. ويمكن استخدام المتغيّر للتصنيف إلى قطاعات أو شرائح، كما يمكن تجميع الإحصاءات للقيم الجديدة في حال تفعيل المتغيّر.
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT يحتوي المتغيّر المخصَّص للإحالة الناجحة على عدد عناصر في الحقل يتجاوز حد التصنيف إلى قطاعات أو شرائح، ولكنه لا يتجاوز حدّ الإحصاءات. سيتم إيقاف التصنيف إلى شرائح، ولكن يمكن تجميع الإحصاءات للقيم الجديدة في حال تفعيل المتغيّر.
APPROACHES_STATS_LIMIT تجاوز المتغيّر المخصَّص للإحالة الناجحة حدود التصنيف إلى شرائح، ويقترب من بلوغ حدود الإحصاءات (> 90%). سيتم إيقاف التصنيف إلى شرائح، ولكن يمكن تجميع الإحصاءات للقيم الجديدة في حال تفعيل المتغيّر.
EXCEEDS_STATS_LIMIT تجاوز المتغيّر المخصّص للإحالة الناجحة كلاً من حدود التصنيف وحدود الإحصاءات. سيتم إيقاف التقسيم إلى شرائح، ولا يمكن تجميع الإحصاءات للمتغيرات المفعّلة إلا إذا لم تزيد القيم الحالية من عدد القيم الفريدة للمتغيّر أكثر من ذلك.

FloodlightConversionCustomVariableInfo

معلومات عن المتغيّرات المخصّصة للإحالات الناجحة في Floodlight في "إعلانات شبكة البحث 360"

تمثيل JSON
{
  "floodlightVariableType": enum (FloodlightVariableType),
  "floodlightVariableDataType": enum (FloodlightVariableDataType)
}
الحقول
floodlightVariableType

enum (FloodlightVariableType)

نوع متغيّر Floodlight المحدَّد في "إعلانات شبكة البحث 360".

floodlightVariableDataType

enum (FloodlightVariableDataType)

نوع بيانات متغيّر Floodlight المحدَّد في "إعلانات شبكة البحث 360"

FloodlightVariableType

نوع متغيّر Floodlight، كما هو محدَّد في "إعلانات شبكة البحث 360" اطّلع على https://support.google.com/searchads/answer/4397154?hl=en لمزيد من المعلومات.

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم للقيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
DIMENSION نوع متغيّر السمة Floodlight
METRIC نوع متغيّر Floodlight المستخدَم في المقياس
UNSET لم يتم ضبط نوع متغيّر Floodlight.

FloodlightVariableDataType

نوع بيانات متغيّر Floodlight، كما هو محدَّد في "إعلانات شبكة البحث 360" اطّلع على https://support.google.com/searchads/answer/4397154?hl=en لمزيد من المعلومات.

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم للقيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
NUMBER يمثّل متغيّر Floodlight بقيمة "الرقم" الكتابة. يمكن تخصيص هذا المتغيّر لمتغيّرات 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,
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "manager": boolean
}
الحقول
resourceName

string

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

customers/{customerId}

conversionTrackingSetting

object (ConversionTrackingSetting)

إعداد تتبُّع الإحالات الناجحة لأحد العملاء.

accountType

enum (AccountType)

نوع حساب محرّك البحث، مثل "إعلانات Google" أو Microsoft Advertising أو Yahoo Japan أو Baidu أو Facebook أو تتبُّع محرّكات البحث وما إلى ذلك

doubleClickCampaignManagerSetting

object (DoubleClickCampaignManagerSetting)

إعداد DoubleClick Campaign Manager (DCM) لعميل الحساب الإداري.

accountStatus

enum (AccountStatus)

حالة الحساب، مثل مُفعَّل، أو متوقف مؤقتًا، أو مُزال، وما إلى ذلك

lastModifiedTime

string

التاريخ والوقت الذي تم فيه إجراء آخر تعديل لهذا العميل. التاريخ والوقت في المنطقة الزمنية للعميل وفي "ي ي-ش ش-س س س س ث ث:دد:ث ث.sssss" .

engineId

string

رقم تعريف الحساب في حساب محرّك البحث الخارجي.

status

enum (CustomerStatus)

حالة العميل.

creationTime

string

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

id

string (int64 format)

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

descriptiveName

string

اسم وصفي اختياري غير فريد للعميل

currencyCode

string

العملة التي يعمل بها الحساب. تتوفّر مجموعة فرعية من رموز العملات وفقًا لمعيار ISO 4217.

timeZone

string

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

trackingUrlTemplate

string

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

finalUrlSuffix

string

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

autoTaggingEnabled

boolean

ما إذا كان وضع العلامات التلقائي مفعَّلاً للعميل.

manager

boolean

ما إذا كان العميل مديرًا.

ConversionTrackingSetting

مجموعة من الإعدادات على مستوى العميل ذات الصلة بتتبُّع الإحالات الناجحة في "إعلانات شبكة البحث 360".

تمثيل JSON
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "googleAdsCrossAccountConversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
الحقول
acceptedCustomerDataTerms

boolean

ما إذا كان العميل قد قبل بنود بيانات العملاء أم لا. وفي حال استخدام تتبُّع الإحالات الناجحة في جميع الحسابات، يتم اكتساب هذه القيمة من الحساب الإداري. هذا الحقل للقراءة فقط. لمزيد من المعلومات، يُرجى الاطّلاع على https://support.google.com/adspolicy/answer/7475709.

conversionTrackingStatus

enum (ConversionTrackingStatus)

حالة تتبُّع الإحالات الناجحة وهي تشير إلى ما إذا كان العميل يستخدِم ميزة تتبُّع الإحالات الناجحة، ومالك هذه الإحالة الناجحة لهذا العميل. إذا كان هذا العميل يستخدِم ميزة تتبُّع الإحالات الناجحة في جميع الحسابات، ستختلف القيمة المعروضة استنادًا إلى login-customer-id للطلب.

enhancedConversionsForLeadsEnabled

boolean

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

googleAdsConversionCustomer

string

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

conversionTrackingId

string (int64 format)

رقم تعريف تتبُّع الإحالات الناجحة المُستخدَم لهذا الحساب لا يشير هذا الرقم التعريفي إلى ما إذا كان العميل يستخدم ميزة تتبُّع الإحالات الناجحة أم لا (تُستخدَم حالة ConversionTrackingStatus). هذا الحقل للقراءة فقط.

googleAdsCrossAccountConversionTrackingId

string (int64 format)

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

crossAccountConversionTrackingId

string (int64 format)

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

ConversionTrackingStatus

حالة تتبُّع الإحالات الناجحة للعميل

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم للقيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
NOT_CONVERSION_TRACKED لا يستخدم العميل أي تتبُّع للإحالات الناجحة.
CONVERSION_TRACKING_MANAGED_BY_SELF يتم إنشاء إجراءات الإحالة الناجحة وإدارتها من قِبل هذا العميل.
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER يتم إنشاء إجراءات الإحالات الناجحة وإدارتها من قِبل المدير المحدّد في login-customer-id للطلب.
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER يتم إنشاء إجراءات الإحالة الناجحة وإدارتها من قِبل مدير مختلف عن العميل أو المدير المحدّد في login-customer-id للطلب.

AccountType

أنواع حسابات محرّكات البحث المحتملة

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم للقيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
BAIDU حساب على Baidu
ENGINE_TRACK حساب تتبُّع محرّكات البحث
FACEBOOK حساب Facebook.
FACEBOOK_GATEWAY حساب Facebook مُدار من خلال البوابة.
GOOGLE_ADS حسابك في إعلانات Google.
MICROSOFT حساب Microsoft Advertising.
SEARCH_ADS_360 الحساب الإداري في "إعلانات شبكة البحث 360".
YAHOO_JAPAN Yahoo Japan.

DoubleClickCampaignManagerSetting

إعداد DoubleClick Campaign Manager (DCM) لعميل الحساب الإداري.

تمثيل JSON
{
  "advertiserId": string,
  "networkId": string,
  "timeZone": string
}
الحقول
advertiserId

string (int64 format)

رقم تعريف المعلِن في "مدير الحملة" المرتبط بهذا العميل.

networkId

string (int64 format)

رقم تعريف شبكة "مدير الحملة" المرتبطة بهذا العميل.

timeZone

string

المنطقة الزمنية لشبكة "مدير الحملة" المرتبطة بهذا العميل بتنسيق قاعدة بيانات المنطقة الزمنية الصادرة عن IANA، مثل America/New_York.

AccountStatus

الحالات المحتملة للحساب.

عمليات التعداد
UNSPECIFIED القيمة التلقائية.
UNKNOWN قيمة غير معروفة.
ENABLED يمكن للحساب عرض الإعلانات.
PAUSED أوقف المستخدم الحساب.
SUSPENDED يتم إيقاف الحساب من خلال عملية داخلية.
REMOVED يتم إيقاف الحساب نهائيًا.
DRAFT لا يزال الحساب قيد الإعداد، ولم يتم تفعيله بعد.

CustomerStatus

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

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم للقيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
ENABLED يشير هذا الرمز إلى حساب نشط يمكنه عرض الإعلانات.
CANCELED يشير إلى عدم تمكّن الحساب المُلغى من عرض الإعلانات. يمكن لمستخدم مشرف إعادة تفعيله.
SUSPENDED يشير إلى عدم تمكّن الحساب المعلَّق من عرض الإعلانات. لا يمكن تفعيل هذا الإعداد إلا من خلال فريق دعم Google.
CLOSED يشير إلى عدم تمكّن حساب مغلق من عرض الإعلانات. وستظهر أيضًا حالة "مغلق" للحساب التجريبي. الحالة دائمة ولا يمكن إعادة فتحها.

CustomerAsset

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

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

string

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

customers/{customerId}/customerAssets/{assetId}~{fieldType}

asset

string

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

status

enum (AssetLinkStatus)

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

CustomerAssetSet

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

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

string

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

customers/{customerId}/customerAssetSets/{asset_set_id}

assetSet

string

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

customer

string

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

status

enum (AssetSetLinkStatus)

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

AccessibleBiddingStrategy

يتم تمثيل طريقة عرض استراتيجيات عروض الأسعار التي يملكها العميل وتتم مشاركتها معه.

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

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

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

customers/{customerId}/accessibleBiddingStrategies/{bidding_strategy_id}

id

string (int64 format)

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

name

string

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

type

enum (BiddingStrategyType)

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

ownerCustomerId

string (int64 format)

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

ownerDescriptiveName

string

بشكل وصفي اسم العميل الذي يملك استراتيجية عروض الأسعار.

حقل الاتحاد scheme. نظام عروض الأسعار.

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

maximizeConversionValue

object (MaximizeConversionValue)

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

maximizeConversions

object (MaximizeConversions)

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

targetCpa

object (TargetCpa)

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

targetImpressionShare

object (TargetImpressionShare)

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

targetRoas

object (TargetRoas)

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

targetSpend

object (TargetSpend)

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

MaximizeConversionValue

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

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

number

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

MaximizeConversions

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

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

string (int64 format)

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

targetCpaMicros

string (int64 format)

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

TargetCpa

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

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

string (int64 format)

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

TargetImpressionShare

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

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

enum (TargetImpressionShareLocation)

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

locationFractionMicros

string (int64 format)

الجزء المختار من الإعلانات التي سيتم عرضها في الموقع الجغرافي المستهدف بوحدات المايكرو. على سبيل المثال، 1% تساوي 10000.

cpcBidCeilingMicros

string (int64 format)

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

TargetRoas

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

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

number

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

TargetSpend

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

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

string (int64 format)

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

cpcBidCeilingMicros

string (int64 format)

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

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

اسم المورد للعميل العميل. تكون أسماء موارد العميل على النحو التالي: customers/{customerId}/customerClients/{client_customer_id}

appliedLabels[]

string

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

customers/{customerId}/labels/{label_id}

status

enum (CustomerStatus)

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

clientCustomer

string

اسم المورد للعميل المرتبط بالعميل المحدد. للقراءة فقط.

hidden

boolean

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

للقراءة فقط.

level

string (int64 format)

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

timeZone

string

تمثيل سلسلة مستودع بيانات اللغة المشتركة (CLDR) للمنطقة الزمنية للعميل، على سبيل المثال، America/Los_Angeles. للقراءة فقط.

testAccount

boolean

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

manager

boolean

يحدّد ما إذا كان العميل مديرًا. للقراءة فقط.

descriptiveName

string

اسم وصفي للعميل. للقراءة فقط.

currencyCode

string

رمز العملة (على سبيل المثال، "USD" و"EUR") للعميل. للقراءة فقط.

id

string (int64 format)

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

DynamicSearchAdsSearchTermView

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

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

string

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

customers/{customerId}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}

landingPage

string

عنوان URL للصفحة المقصودة المحددة ديناميكيًا لمرة الظهور.

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

GenderView

عرض الجنس يعكس مورد ageView حالة العرض الفعّالة، بدلاً من المعايير التي تمت إضافتها. تظهر المجموعة الإعلانية التي لا تتضمّن معايير الجنس بشكل تلقائي لجميع الأجناس، لذلك تظهر جميع الأجناس فيgenderView مع إحصاءات.

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

string

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

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

GeoTargetConstant

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

تمثيل JSON
{
  "resourceName": string,
  "status": enum (GeoTargetConstantStatus),
  "id": string,
  "name": string,
  "countryCode": string,
  "targetType": string,
  "canonicalName": string,
  "parentGeoTarget": string
}
الحقول
resourceName

string

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

geoTargetConstants/{geo_target_constant_id}

status

enum (GeoTargetConstantStatus)

الحالة الثابتة للاستهداف الجغرافي.

id

string (int64 format)

رقم تعريف ثابت الهدف الجغرافي.

name

string

الاستهداف الجغرافي لاسم ثابت باللغة الإنجليزية.

countryCode

string

تمثّل هذه السمة رمز البلد بصيغة ISO-3166-1 alpha-2 المرتبط بالهدف.

targetType

string

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

canonicalName

string

تمثّل هذه السمة الاسم الإنجليزي المؤهل بالكامل، ويتألف من اسم الهدف واسم البلد الأصلي.

parentGeoTarget

string

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

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

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

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

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

هذه قيمة مخصّصة للردّ فقط.

ENABLED ثابت الاستهداف الجغرافي صالح.
REMOVAL_PLANNED أصبح ثابت الاستهداف الجغرافي قديمًا وستتم إزالته.

KeywordView

طريقة عرض الكلمات الرئيسية.

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

string

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

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

التصنيف

التسمية

تمثيل JSON
{
  "resourceName": string,
  "status": enum (LabelStatus),
  "textLabel": {
    object (TextLabel)
  },
  "id": string,
  "name": string
}
الحقول
resourceName

string

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

status

enum (LabelStatus)

حالة التصنيف. للقراءة فقط.

textLabel

object (TextLabel)

نوع من التصنيفات يعرض النص على خلفية ملوّنة.

id

string (int64 format)

رقم تعريف التصنيف. للقراءة فقط.

name

string

تمثّل هذه السمة اسم التصنيف.

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

ويجب أن يتراوح طول هذه السلسلة بين 1 و80.

LabelStatus

الحالات المحتملة للتصنيف.

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

TextLabel

نوع من التصنيفات يعرض النص على خلفية ملوّنة.

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

string

لون خلفية التصنيف بتنسيق سداسي عشري يجب أن تتطابق هذه السلسلة مع التعبير العادي '^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. ملاحظة: قد لا يكون لون الخلفية مرئيًا للحسابات الإدارية.

description

string

تمثّل هذه السمة وصفًا موجزًا للتصنيف. يجب ألا يزيد الطول عن 200 حرف.

LanguageConstant

لغة.

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

string

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

languageConstants/{criterionId}

id

string (int64 format)

معرّف ثابت اللغة.

code

string

رمز اللغة، مثل "en_US" و"en_AU" و"es" و"fr" وما إلى ذلك.

name

string

الاسم الكامل للغة الإنجليزية، مثل "الإنجليزية (الولايات المتحدة)" و"الإسبانية" وما إلى ذلك.

targetable

boolean

ما إذا كانت اللغة قابلة للاستهداف.

LocationView

تلخّص طريقة عرض الموقع الجغرافي أداء الحملات حسب معيار الموقع الجغرافي.

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

string

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

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

ProductBiddingCategoryConstant

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

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

string

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

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

level

enum (ProductBiddingCategoryLevel)

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

status

enum (ProductBiddingCategoryStatus)

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

id

string (int64 format)

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

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

countryCode

string

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

productBiddingCategoryConstantParent

string

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

languageCode

string

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

localizedName

string

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

ProductBiddingCategoryLevel

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

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

ProductBiddingCategoryStatus

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

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

ProductGroupView

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

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

string

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

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

ShoppingPerformanceView

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

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

string

اسم المورد لعرض أداء Shopping. تكون أسماء المراجع لعرض أداء التسوّق على النحو التالي: 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=SHARED).

UserListType

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

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

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

productId

string

معرّف المنتج الذي تم النقر عليه.

productChannel

enum (ProductChannel)

قناة بيع المنتج الذي تم النقر عليه: على الإنترنت أو محلي.

productLanguageCode

string

تمثّل هذه السمة اللغة (ISO-639-1) التي تمّ ضبطها لخلاصة Merchant Center التي تحتوي على بيانات عن المنتج.

productStoreId

string

المتجر في "الإعلان للمنتجات داخل المتجر" الذي تم النقر عليه يجب أن تتطابق هذه القيمة مع أرقام تعريف المتاجر المستخدَمة في خلاصة المنتجات في المتاجر المحلّية.

productCountryCode

string

البلد (بتنسيق ISO-3166) المسجَّل في خلاصة المستودع التي تتضمّن المنتج الذي تم النقر عليه.

attributionType

enum (AttributionType)

الغرض من الإحالة الناجحة: زيارة أو الكلمة الرئيسية + الإعلان

conversionDateTime

string

الطابع الزمني لحدث الإحالة الناجحة.

conversionLastModifiedDateTime

string

الطابع الزمني لآخر مرة تم فيها تعديل الإحالة الناجحة.

conversionVisitDateTime

string

الطابع الزمني للزيارة التي تُنسَب إليها الإحالة الناجحة.

conversionQuantity

string (int64 format)

كمية السلع التي سجّلتها الإحالة الناجحة، على النحو الذي تحدّده مَعلمة عنوان URL للكمية. المعلِن مسؤول عن تعبئة المَعلمة بشكلٍ ديناميكي (مثل عدد السلع المُباعة في الإحالة الناجحة)، وإلّا يتم ضبطه تلقائيًا على 1.

conversionRevenueMicros

string (int64 format)

الأرباح المعدّلة بالمايكرو لحدث الإحالة الناجحة. وسيكون دائمًا بعملة حساب عرض الإعلانات.

floodlightOriginalRevenue

string (int64 format)

الأرباح الأصلية التي لم تتغيّر والمرتبطة بحدث Floodlight (بعملة التقرير الحالي)، قبل تعديلات تعليمات عملة Floodlight.

floodlightOrderId

string

رقم تعريف طلب Floodlight الذي يقدّمه المعلِن للإحالة الناجحة

status

enum (ConversionStatus)

حالة الإحالة الناجحة، إما "مُفعّلة" أو "تمت الإزالة".

assetId

string (int64 format)

رقم تعريف مادة العرض التي تم التفاعل معها أثناء حدث الإحالة الناجحة.

assetFieldType

enum (AssetFieldType)

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

AttributionType

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

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

ConversionStatus

الحالات المحتملة للإحالة الناجحة.

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

المقاييس

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

تمثيل JSON
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionCustomMetrics": [
    {
      object (Value)
    }
  ],
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "rawEventConversionMetrics": [
    {
      object (Value)
    }
  ],
  "absoluteTopImpressionPercentage": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "visits": number,
  "allConversionsFromStoreWebsite": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpm": number,
  "clicks": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "clientAccountConversionsValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "clientAccountConversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsValue": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "averageQualityScore": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "mobileFriendlyClicksPercentage": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "topImpressionPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "clientAccountViewThroughConversions": string,
  "clientAccountCrossSellCostOfGoodsSoldMicros": string,
  "crossSellCostOfGoodsSoldMicros": string,
  "clientAccountCrossSellGrossProfitMicros": string,
  "crossSellGrossProfitMicros": string,
  "clientAccountCrossSellRevenueMicros": string,
  "crossSellRevenueMicros": string,
  "clientAccountCrossSellUnitsSold": number,
  "crossSellUnitsSold": number,
  "clientAccountLeadCostOfGoodsSoldMicros": string,
  "leadCostOfGoodsSoldMicros": string,
  "clientAccountLeadGrossProfitMicros": string,
  "leadGrossProfitMicros": string,
  "clientAccountLeadRevenueMicros": string,
  "leadRevenueMicros": string,
  "clientAccountLeadUnitsSold": number,
  "leadUnitsSold": number
}
الحقول
allConversionsValueByConversionDate

number

قيمة كل الإحالات الناجحة. عند اختيار هذا العمود مع التاريخ، تعني القيم في عمود "التاريخ" تاريخ الإحالة الناجحة. تتوفّر تفاصيل أعمدة by_conversion_date على الرابط https://support.google.com/sa360/answer/9250611.

allConversionsByConversionDate

number

إجمالي عدد التحويلات. يشمل ذلك جميع الإحالات الناجحة بغض النظر عن قيمةincludeInconversionMetric. عند اختيار هذا العمود مع التاريخ، تعني القيم في عمود "التاريخ" تاريخ الإحالة الناجحة. تتوفّر تفاصيل أعمدة by_conversion_date على الرابط https://support.google.com/sa360/answer/9250611.

conversionCustomMetrics[]

object (Value)

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

conversionsValueByConversionDate

number

مجموع قيمة الإحالات الناجحة التي يمكن تقديم عروض أسعار لها حسب تاريخ الإحالة الناجحة. عند اختيار هذا العمود مع التاريخ، تعني القيم في عمود "التاريخ" تاريخ الإحالة الناجحة.

conversionsByConversionDate

number

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

historicalCreativeQualityScore

enum (QualityScoreBucket)

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

historicalLandingPageQualityScore

enum (QualityScoreBucket)

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

historicalSearchPredictedCtr

enum (QualityScoreBucket)

نسبة النقر إلى الظهور المتوقّعة في نتائج البحث السابقة.

interactionEventTypes[]

enum (InteractionEventType)

أنواع التفاعلات المستحقة والمجانية.

rawEventConversionMetrics[]

object (Value)

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

absoluteTopImpressionPercentage

number

"نسبة ظهور الإعلان في صدارة الصفحة على شبكة البحث" هي النسبة المئوية لمرات ظهور إعلانك في أبرز موضع على "شبكة البحث".

allConversionsFromInteractionsRate

number

كل الإحالات الناجحة من التفاعلات (بهدف العرض من خلال الإحالات الناجحة) مقسومةً على عدد التفاعلات مع الإعلان.

allConversionsValue

number

قيمة كل الإحالات الناجحة.

allConversions

number

إجمالي عدد التحويلات. يشمل ذلك جميع الإحالات الناجحة بغض النظر عن قيمةincludeInconversionMetric.

allConversionsValuePerCost

number

قيمة كل الإحالات الناجحة مقسومةً على إجمالي تكلفة التفاعلات مع الإعلانات (مثل النقرات على الإعلانات النصية أو مرّات المشاهدة لإعلانات الفيديو).

allConversionsFromClickToCall

number

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

ينطبق هذا المقياس على العناصر في الخلاصة فقط.

allConversionsFromDirections

number

عدد المرّات التي نقر فيها الأشخاص على "الحصول على الاتجاهات" زر للانتقال إلى متجر بعد النقر على أحد الإعلانات.

ينطبق هذا المقياس على العناصر في الخلاصة فقط.

allConversionsFromInteractionsValuePerInteraction

number

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

allConversionsFromMenu

number

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

ينطبق هذا المقياس على العناصر في الخلاصة فقط.

allConversionsFromOrder

number

عدد المرّات التي قدَّم فيها الأشخاص طلبًا في متجر بعد النقر على إعلان

ينطبق هذا المقياس على العناصر في الخلاصة فقط.

allConversionsFromOtherEngagement

number

عدد الإحالات الناجحة الأخرى (على سبيل المثال، نشر مراجعة أو حفظ موقع جغرافي لمتجر) التي حدثت بعد أن نقر الأشخاص على إعلان.

ينطبق هذا المقياس على العناصر في الخلاصة فقط.

allConversionsFromStoreVisit

number

العدد المقدّر لزيارات الأشخاص لمتجر بعد النقر على إعلان.

ينطبق هذا المقياس على العناصر في الخلاصة فقط.

visits

number

النقرات التي سجّلتها "إعلانات شبكة البحث 360" وأعادت توجيهها إلى الصفحة المقصودة للمعلِن بنجاح

allConversionsFromStoreWebsite

number

عدد المرّات التي تمّ فيها توجيه المستخدمين إلى عنوان URL لمتجر بعد النقر على إعلان

ينطبق هذا المقياس على العناصر في الخلاصة فقط.

averageCost

number

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

averageCpc

number

إجمالي تكلفة جميع النقرات مقسومًا على إجمالي عدد النقرات التي تم تلقّيها. هذا المقياس هو قيمة نقدية ويتم عرضها بعملة العميل تلقائيًا. يمكنك الاطّلاع على المَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

averageCpm

number

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

clicks

string (int64 format)

عدد النقرات

contentBudgetLostImpressionShare

number

النسبة المئوية المقدَّرة للمرات التي كان إعلانك مؤهَّلاً فيها للعرض على "الشبكة الإعلانية" ولكن لم يحدث ذلك لأنّ ميزانيتك كانت منخفضة جدًا. ملاحظة: يتم تسجيل نسبة ظهور الإعلان المفقودة في ميزانية المحتوى في نطاق يتراوح بين 0 و0.9. ويتم الإبلاغ عن أي قيمة أعلى من 0.9 كـ 0.9001.

contentImpressionShare

number

مرات الظهور التي تلقاها إعلانك على الشبكة الإعلانية مقسومًا على العدد المقدَّر لمرات الظهور التي كنت مؤهَّلاً للحصول عليها. ملاحظة: يتم تسجيل نسبة ظهور الإعلان في الشبكة الإعلانية في النطاق بين 0.1 و1. أي قيمة أقل من 0.1 يتم تسجيلها كـ 0.0999.

contentRankLostImpressionShare

number

النسبة المئوية المقدَّرة لمرات الظهور على الشبكة الإعلانية التي لم تتلقَّها إعلاناتك بسبب انخفاض ترتيب الإعلان. ملاحظة: تظهر نسبة ظهور الإعلان المفقودة في ترتيب المحتوى في النطاق بين 0 و0.9. ويتم الإبلاغ عن أي قيمة أعلى من 0.9 كـ 0.9001.

conversionsFromInteractionsRate

number

متوسط الإحالات الناجحة التي يمكن تقديم عروض أسعار لها (من التفاعل) لكل تفاعل مؤهَّل للإحالة الناجحة. يعرِض متوسط عدد المرّات التي يؤدي فيها أحد التفاعلات مع الإعلان إلى إحالة ناجحة يمكن تحديد عروض أسعار لها.

clientAccountConversionsValue

number

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

conversionsValuePerCost

number

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

conversionsFromInteractionsValuePerInteraction

number

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

clientAccountConversions

number

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

costMicros

string (int64 format)

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

costPerAllConversions

number

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

costPerConversion

number

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

costPerCurrentModelAttributedConversion

number

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

crossDeviceConversions

number

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

crossDeviceConversionsValue

number

مجموع قيمة الإحالات الناجحة باستخدام أكثر من جهاز واحد.

ctr

number

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

conversions

number

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

conversionsValue

number

مجموع قيم الإحالات الناجحة للإحالات الناجحة المضمّنة في "الإحالات الناجحة" . يُعد هذا المقياس مفيدًا فقط إذا أدخلت قيمة للإحالات الناجحة.

averageQualityScore

number

تمثّل هذه السمة متوسط نقاط الجودة.

historicalQualityScore

string (int64 format)

نقاط الجودة للفترات السابقة.

impressions

string (int64 format)

يشير إلى عدد مرات ظهور إعلانك على إحدى صفحات نتائج البحث أو أحد المواقع الإلكترونية في شبكة Google.

interactionRate

number

عدد مرات تفاعل المستخدمين مع إعلانك بعد ظهوره لهم. يشير إلى عدد التفاعلات مقسومًا على عدد مرات عرض إعلانك.

interactions

string (int64 format)

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

invalidClickRate

number

النسبة المئوية للنقرات التي تمت تصفيتها من إجمالي عدد النقرات (النقرات التي تمت تصفيتها + النقرات التي لم تتم تصفيتها) خلال فترة إعداد التقرير.

invalidClicks

string (int64 format)

عدد النقرات التي تعتبرها Google غير قانونية ولا يتم تحصيل رسوم منك مقابلها.

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)

تكلفة السلع المُباعة من خلال بيع منتجات إضافية (COGS) في حساب العميل هي إجمالي تكلفة المنتجات التي تم بيعها نتيجةً لإعلان عن منتج مختلف. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. وتكلفة السلع المُباعة من خلال بيع منتجات إضافية هي إجمالي تكلفة المنتجات التي تم بيعها بدون الإعلان عنها. على سبيل المثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة تكلفة السلع المُباعة للقميص 5 دولار أمريكي. تبلغ تكلفة السلع المُباعة من خلال بيع منتجات إضافية لهذا الطلب 5 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضها بعملة العميل تلقائيًا. يمكنك الاطّلاع على المَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

crossSellCostOfGoodsSoldMicros

string (int64 format)

تكلفة السلع المُباعة من خلال بيع منتجات إضافية (COGS) هي إجمالي تكلفة المنتجات التي تم بيعها نتيجةً لإعلان عن منتج مختلف. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. وتكلفة السلع المُباعة من خلال بيع منتجات إضافية هي إجمالي تكلفة المنتجات التي تم بيعها بدون الإعلان عنها. على سبيل المثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة تكلفة السلع المُباعة للقميص 5 دولار أمريكي. تبلغ تكلفة السلع المُباعة من خلال بيع منتجات إضافية لهذا الطلب 5 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضها بعملة العميل تلقائيًا. يمكنك الاطّلاع على المَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountCrossSellGrossProfitMicros

string (int64 format)

الأرباح الإجمالية من بيع منتجات إضافية لحساب العميل هي الأرباح التي حقّقتها من المنتجات المُباعة نتيجة للإعلان عن منتج مختلف، بعد طرح تكلفة السلع المُباعة منها. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في عملية الشراء هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الأرباح الإجمالية من بيع منتجات إضافية هي الأرباح التي يتمّ تحقيقها من خلال بيع منتجات إضافية منسوبة إلى إعلاناتك بعد طرح تكلفة السلع المُباعة منها. على سبيل المثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القميص ‏$20، وله قيمة تكلفة سلع مُباعة تبلغ ‏$5. تبلغ الأرباح الإجمالية من بيع منتجات إضافية لهذا الطلب ‏$15 = ‏$20 - ‏$5. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضها بعملة العميل تلقائيًا. يمكنك الاطّلاع على المَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

crossSellGrossProfitMicros

string (int64 format)

الأرباح الإجمالية من بيع منتجات إضافية هي الأرباح التي تحقّقها من المنتجات المُباعة نتيجة للإعلان عن منتج مختلف، بعد طرح تكلفة السلع المُباعة منها. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في عملية الشراء هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الأرباح الإجمالية من بيع منتجات إضافية هي الأرباح التي يتمّ تحقيقها من خلال بيع منتجات إضافية منسوبة إلى إعلاناتك بعد طرح تكلفة السلع المُباعة منها. على سبيل المثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القميص ‏$20، وله قيمة تكلفة سلع مُباعة تبلغ ‏$5. تبلغ الأرباح الإجمالية من بيع منتجات إضافية لهذا الطلب ‏$15 = ‏$20 - ‏$5. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضها بعملة العميل تلقائيًا. يمكنك الاطّلاع على المَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountCrossSellRevenueMicros

string (int64 format)

الأرباح من بيع المنتجات الإضافية في حساب العميل هي إجمالي المبلغ الذي تحقّقه من المنتجات المُباعة نتيجة للإعلان عن منتج آخر. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الأرباح من بيع المنتجات الإضافية هي القيمة الإجمالية التي حقّقتها من خلال بيع منتجات إضافية منسوبة إلى إعلاناتك. على سبيل المثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ الأرباح من بيع منتجات إضافية لهذا الطلب 20 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضها بعملة العميل تلقائيًا. يمكنك الاطّلاع على المَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

crossSellRevenueMicros

string (int64 format)

الأرباح من بيع المنتجات الإضافية هي إجمالي المبلغ الذي تحقّقه من المنتجات المُباعة نتيجة للإعلان عن منتج آخر. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. في حال عدم تطابق هذه المنتجات، سيُعدّ ذلك بيع منتجات إضافية. الأرباح من بيع المنتجات الإضافية هي القيمة الإجمالية التي حقّقتها من خلال بيع منتجات إضافية منسوبة إلى إعلاناتك. على سبيل المثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ الأرباح من بيع منتجات إضافية لهذا الطلب 20 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضها بعملة العميل تلقائيًا. يمكنك الاطّلاع على المَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountCrossSellUnitsSold

number

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

crossSellUnitsSold

number

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

clientAccountLeadCostOfGoodsSoldMicros

string (int64 format)

تكلفة السلع المُباعة للعملاء المحتملِين في حساب العميل هي إجمالي تكلفة المنتجات المُباعة نتيجة للإعلان عن المنتج نفسه. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمُباعة، يتمّ احتساب تكلفة هذه السلع ضمن تكلفة السلع المُباعة للعملاء المحتملِين. على سبيل المثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة تكلفة السلع المُباعة للقميص 5 دولار أمريكي. تبلغ تكلفة السلع المُباعة للعملاء المحتملِين لهذا الطلب 3 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضها بعملة العميل تلقائيًا. يمكنك الاطّلاع على المَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

leadCostOfGoodsSoldMicros

string (int64 format)

تكلفة السلع المُباعة للعملاء المحتملِين هي إجمالي تكلفة المنتجات المُباعة نتيجة للإعلان عن المنتج نفسه. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمُباعة، يتمّ احتساب تكلفة هذه السلع ضمن تكلفة السلع المُباعة للعملاء المحتملِين. على سبيل المثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. تبلغ قيمة تكلفة السلع المُباعة للقبعة 3 دولار أمريكي، في حين تبلغ قيمة تكلفة السلع المُباعة للقميص 5 دولار أمريكي. تبلغ تكلفة السلع المُباعة للعملاء المحتملِين لهذا الطلب 3 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضها بعملة العميل تلقائيًا. يمكنك الاطّلاع على المَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountLeadGrossProfitMicros

string (int64 format)

الأرباح الإجمالية من العملاء المحتملين في حساب العميل هي الأرباح التي حقّقتها من المنتجات المُباعة نتيجة للإعلان عن المنتج نفسه، بعد طرح تكلفة السلع المُباعة منها. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت كلٌّ من المنتجات المعلَن عنها والمنتجات المُباعة، تكون الأرباح التي تحقّقها من هذه المبيعات بعد طرح تكلفة السلع المُباعة منها هي الأرباح الإجمالية من العملاء المحتملِين. على سبيل المثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ولها قيمة تكلفة سلع مُباعة تبلغ 3 دولار أمريكي. ستكون الأرباح الإجمالية من العملاء المحتملِين لهذا الطلب هي 7 دولار أمريكي = 10 دولار أمريكي - 3 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضها بعملة العميل تلقائيًا. يمكنك الاطّلاع على المَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

leadGrossProfitMicros

string (int64 format)

الأرباح الإجمالية من العملاء المحتملِين هي الأرباح التي تحقِقّها من المنتجات المُباعة نتيجة للإعلان عن المنتج نفسه، بعد طرح تكلفة السلع المُباعة منها. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت كلٌّ من المنتجات المعلَن عنها والمنتجات المُباعة، تكون الأرباح التي تحقّقها من هذه المبيعات بعد طرح تكلفة السلع المُباعة منها هي الأرباح الإجمالية من العملاء المحتملِين. على سبيل المثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ولها قيمة تكلفة سلع مُباعة تبلغ 3 دولار أمريكي. ستكون الأرباح الإجمالية من العملاء المحتملِين لهذا الطلب هي 7 دولار أمريكي = 10 دولار أمريكي - 3 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضها بعملة العميل تلقائيًا. يمكنك الاطّلاع على المَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountLeadRevenueMicros

string (int64 format)

الأرباح من العملاء المحتملِين في حساب العميل هي إجمالي المبلغ الذي حقّقته من منتجات تمّ بيعها نتيجة الإعلان عن المنتج نفسه. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمُباعة، يتمّ عرض القيمة الإجمالية التي حقّقتها من مبيعات هذه المنتجات ضمن الأرباح من العملاء المحتملِين. على سبيل المثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ الأرباح من العملاء المحتملِين لهذا الطلب 10 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضها بعملة العميل تلقائيًا. يمكنك الاطّلاع على المَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

leadRevenueMicros

string (int64 format)

الأرباح من العملاء المحتملِين هي إجمالي المبلغ الذي حقّقته من منتجات تمّ بيعها نتيجة الإعلان عن المنتج نفسه. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. وأيّ منتج مدرج في طلب العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمُباعة، يتمّ عرض القيمة الإجمالية التي حقّقتها من مبيعات هذه المنتجات ضمن الأرباح من العملاء المحتملِين. على سبيل المثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا. يبلغ سعر القبّعة 10 دولار أمريكي، ويبلغ سعر القميص 20 دولار أمريكي. تبلغ الأرباح من العملاء المحتملِين لهذا الطلب 10 دولار أمريكي. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. هذا المقياس هو قيمة نقدية ويتم عرضها بعملة العميل تلقائيًا. يمكنك الاطّلاع على المَعلمة Metrics_currency على الرابط https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountLeadUnitsSold

number

الوحدات المُباعة للعملاء المحتملِين في حساب العميل هي إجمالي عدد المنتجات التي يتمّ بيعها نتيجة للإعلان عن المنتج نفسه. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمنتجات المُباعة، يظهر إجمالي عدد هذه المنتجات المُباعة ضمن "الوحدات المُباعة للعملاء المحتملِين". على سبيل المثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا وسُترة. الوحدات المُباعة للعملاء المحتملِين في هذا الطلب هي 1. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.

leadUnitsSold

number

الوحدات المُباعة للعملاء المحتملِين هي إجمالي عدد المنتجات التي يتمّ بيعها نتيجة للإعلان عن المنتج نفسه. طريقة العمل: يمكنك تسجيل الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات Shopping)، يتمّ اعتبار هذا المنتج هو المنتج المعلَن عنه. أيّ منتج مدرج في الطلب الذي يقدّمه العميل هو منتج مُباع. إذا تطابقت المنتجات المُعلن عنها والمنتجات المُباعة، يظهر إجمالي عدد هذه المنتجات المُباعة ضمن "الوحدات المُباعة للعملاء المحتملِين". على سبيل المثال: نقر شخص ما على أحد إعلانات Shopping لقبّعة ثمّ اشترى القبّعة نفسها وقميصًا وسُترة. الوحدات المُباعة للعملاء المحتملِين في هذا الطلب هي 1. يمكنك استخدام هذا المقياس فقط في حال تسجيل الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق.

القيمة

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

تمثيل JSON
{

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

boolean

قيمة منطقية.

int64Value

string (int64 format)

وint64.

floatValue

number

عدد عائم.

doubleValue

number

مزدوجة.

stringValue

string

سلسلة.

QualityScoreBucket

يشير ذلك المصطلح إلى تعداد يسرد مجموعات نقاط الجودة المحتمَلة.

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

InteractionEventType

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

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

الشرائح

حقول التقسيم فقط.

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

enum (AdNetworkType)

نوع شبكة الإعلانات.

conversionActionCategory

enum (ConversionActionCategory)

فئة إجراء الإحالة الناجحة.

conversionCustomDimensions[]

object (Value)

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

dayOfWeek

enum (DayOfWeek)

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

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، مثلًا، 17-04-2018.

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

AdNetworkType

لتعداد أنواع شبكات "إعلانات Google".

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN القيمة غير معروفة في هذا الإصدار.
SEARCH بحث Google.
SEARCH_PARTNERS شركاء البحث
CONTENT للشبكة الإعلانية.
YOUTUBE_WATCH فيديوهات YouTube
MIXED الشبكات المتقاطعة:

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

شريحة معيار الكلمة الرئيسية.

تمثيل JSON
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
الحقول
info

object (KeywordInfo)

معلومات الكلمة الرئيسية.

adGroupCriterion

string

اسم مورد AdGroupReference.

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