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)

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

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

تمثيل 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 أو Baidu أو ما إلى ذلك. وبالنسبة إلى كيان "إعلانات 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

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

id

string (int64 format)

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

name

string

اسم المجموعة

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

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

ويجب ألا يحتوي على أي أحرف فارغة (نقطة الرمز 0x0) أو خلاصة سطر NL (نقطة الرمز 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_SHOWCASE_ADS نوع المجموعات الإعلانية الذي يقتصر على عرض إعلانات واجهة العرض أو إعلانات التجّار في نتائج Shopping.
HOTEL_ADS النوع التلقائي للمجموعة الإعلانية لحملات الفنادق.
SHOPPING_SMART_ADS نوع المجموعات الإعلانية في حملات Shopping الذكية.
VIDEO_BUMPER الإعلانات القصيرة غير القابلة للتخطي أثناء عرض الفيديو.
VIDEO_TRUE_VIEW_IN_STREAM إعلانات فيديو TrueView (القابلة للتخطي) أثناء عرض الفيديو.
VIDEO_TRUE_VIEW_IN_DISPLAY إعلانات فيديو TrueView ضمن العرض.
VIDEO_NON_SKIPPABLE_IN_STREAM الإعلانات غير القابلة للتخطي أثناء عرض الفيديو.
VIDEO_OUTSTREAM الإعلانات خارج بث الفيديو.
SEARCH_DYNAMIC_ADS نوع المجموعة الإعلانية للمجموعات الإعلانية للإعلانات الديناميكية على شبكة البحث.
SHOPPING_COMPARISON_LISTING_ADS نوع المجموعات الإعلانية في حملات بيانات المقارنة على Shopping.
PROMOTED_HOTEL_ADS نوع المجموعة الإعلانية للمجموعات الإعلانية للفنادق التي يتم الترويج لها.
VIDEO_RESPONSIVE المجموعات الإعلانية المتجاوبة للفيديو.
VIDEO_EFFICIENT_REACH المجموعات الإعلانية لمدى الوصول الفعّال للفيديو
SMART_CAMPAIGN_ADS نوع المجموعة الإعلانية للحملات الذكية.
TRAVEL_ADS نوع المجموعة الإعلانية لـ "حملات السفر".

AdGroupAdRotationMode

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

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

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

هذه قيمة للاستجابة فقط.

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

AdGroupEngineStatus

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

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

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

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

TargetingSetting

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

تمثيل JSON
{
  "targetRestrictions": [
    {
      object (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 معايير الموضوع لاستهداف فئات المحتوى، مثل "الفئة::حيوانات>حيوانات أليفة" مستخدَمة لاستهداف الشبكة الإعلانية والفيديو
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

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

labels[]

string

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

engineId

string

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

engineStatus

enum (AdGroupAdEngineStatus)

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

lastModifiedTime

string

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

AdGroupAdStatus

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

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

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

هذه قيمة للاستجابة فقط.

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

AdType

تمثّل هذه السمة الأنواع الممكنة من الإعلان.

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

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

هذه قيمة للاستجابة فقط.

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

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
{
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
الحقول
path1

string

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

path2

string

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

adTrackingId

string (int64 format)

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

SearchAds360ProductAdInfo

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

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

SearchAds360ExpandedDynamicSearchAdInfo

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

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

string

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

description2

string

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

adTrackingId

string (int64 format)

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

AdGroupAdEngineStatus

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

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

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

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

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

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

AdGroupAdLabel

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

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

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

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

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

adGroup

string

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

asset

string

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

status

enum (AssetLinkStatus)

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

AssetLinkStatus

يشير هذا المقياس إلى عدد يصف حالات رابط مادة العرض.

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

AdGroupAssetSet

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

تمثيل 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 معيار معدِّل عروض أسعار المجموعة الإعلانية هذا.

مطلوب في عمليات الإنشاء التي تبدأ بـ V5. يمكن أن يكون الحقل "criterion" واحدًا فقط مما يلي:

device

object (DeviceInfo)

معيار جهاز.

DeviceInfo

معيار جهاز.

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

enum (Device)

نوع الجهاز

الجهاز

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

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

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)

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

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

qualityInfo

object (QualityInfo)

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

type

enum (CriterionType)

نوع المعيار.

labels[]

string

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

positionEstimates

object (PositionEstimates)

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

finalUrls[]

string

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

engineId

string

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

lastModifiedTime

string

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

criterionId

string (int64 format)

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

adGroup

string

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

negative

boolean

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

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

bidModifier

number

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

cpcBidMicros

string (int64 format)

عرض سعر النقرة.

effectiveCpcBidMicros

string (int64 format)

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

engineStatus

enum (AdGroupCriterionEngineStatus)

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

finalUrlSuffix

string

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

trackingUrlTemplate

string

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

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

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

keyword

object (KeywordInfo)

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

listingGroup

object (ListingGroupInfo)

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

ageRange

object (AgeRangeInfo)

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

gender

object (GenderInfo)

الجنس.

userList

object (UserListInfo)

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

webpage

object (WebpageInfo)

صفحة ويب

location

object (LocationInfo)

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

AdGroupCriterionStatus

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

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

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

هذه قيمة للاستجابة فقط.

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

QualityInfo

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

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

integer

نقاط الجودة.

قد لا تتم تعبئة هذا الحقل إذا لم يكن لدى Google معلومات كافية لتحديد قيمة.

CriterionType

يشير قيم التعداد إلى أنواع المعايير المحتملة.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
KEYWORD الكلمة الرئيسية، على سبيل المثال، "رحلة بحرية على المريخ".
PLACEMENT موضع الإعلان، الذي يُعرف أيضًا باسم موقع الويب، على سبيل المثال "www.flowers4sale.com"
MOBILE_APP_CATEGORY فئات تطبيقات الأجهزة الجوّالة المطلوب استهدافها.
MOBILE_APPLICATION تطبيقات الأجهزة الجوّالة المستهدفة.
DEVICE الأجهزة المطلوب استهدافها.
LOCATION المواقع الجغرافية المستهدفة.
LISTING_GROUP مجموعات البيانات المطلوب استهدافها
AD_SCHEDULE جدول عرض الإعلانات.
AGE_RANGE الفئة العمرية.
GENDER الجنس.
INCOME_RANGE نطاق الدخل.
PARENTAL_STATUS الحالة الأبوية.
YOUTUBE_VIDEO فيديو YouTube
YOUTUBE_CHANNEL قناة YouTube
USER_LIST قائمة المستخدمين.
PROXIMITY التقارب.
TOPIC موضوع مستهدَف على الشبكة الإعلانية (مثل "الحيوانات الأليفة").
LISTING_SCOPE نطاق بطاقة البيانات المطلوب استهدافه
LANGUAGE اللغة
IP_BLOCK IpBlock.
CONTENT_LABEL تصنيف المحتوى لاستبعاد الفئات.
CARRIER مشغّل شبكة الجوّال
USER_INTEREST الفئة التي يهتم بها المستخدم.
WEBPAGE معيار صفحة الويب للإعلانات الديناميكية على شبكة البحث.
OPERATING_SYSTEM_VERSION إصدار نظام التشغيل
APP_PAYMENT_MODEL نموذج الدفع للتطبيق
MOBILE_DEVICE جهاز جوّال
CUSTOM_AFFINITY تقارب مخصص.
CUSTOM_INTENT مخصّص حسب نيّة الشراء.
LOCATION_GROUP مجموعة المواقع الجغرافية.
CUSTOM_AUDIENCE جمهور مخصّص
COMBINED_AUDIENCE الجمهور المشترك
KEYWORD_THEME موضوع الكلمة الرئيسية للحملة الذكية
AUDIENCE الجمهور
LOCAL_SERVICE_ID رقم تعريف خدمة "إعلانات الخدمات المحلّية".
BRAND العلامة التجارية
BRAND_LIST قائمة العلامات التجارية
LIFE_EVENT حدث في الحياة

PositionEstimates

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

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

string (int64 format)

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

AdGroupCriterionEngineStatus

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

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

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

AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN Baidu: عرض السعر أو الجودة منخفضة جدًا بحيث يتعذّر عرضها.
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME Baidu: تم إيقافها مؤقتًا بواسطة Baidu بسبب انخفاض حجم البحث.
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW Baidu: عنوان URL للأجهزة الجوّالة قيد المراجعة.
AD_GROUP_CRITERION_PARTIALLY_INVALID Baidu: الصفحة المقصودة لأحد الأجهزة غير صالحة، بينما تكون الصفحة المقصودة للجهاز الآخر صالحة.
AD_GROUP_CRITERION_TO_BE_ACTIVATED Baidu: تم إنشاء الكلمة الرئيسية وإيقافها مؤقتًا من خلال إدارة حساب Baidu، وهي جاهزة الآن لتفعيلها.
AD_GROUP_CRITERION_UNDER_REVIEW Baidu: قيد المراجعة من قِبل Baidu. الجوزاء: المعيار قيد المراجعة.
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

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

id

string (int64 format)

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

name

string

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

trackingUrlTemplate

string

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

engineStatus

enum (AssetEngineStatus)

حالة محرّك البحث لمادة العرض

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

object (YoutubeVideoAsset)

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

imageAsset

object (ImageAsset)

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

textAsset

object (TextAsset)

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

calloutAsset

object (UnifiedCalloutAsset)

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

pageFeedAsset

object (UnifiedPageFeedAsset)

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

mobileAppAsset

object (MobileAppAsset)

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

callAsset

object (UnifiedCallAsset)

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

callToActionAsset

object (CallToActionAsset)

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

locationAsset

object (UnifiedLocationAsset)

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

AssetType

يشير التعداد إلى وصف الأنواع المحتملة من مواد العرض.

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

AssetStatus

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

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

AssetEngineStatus

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

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

YoutubeVideoAsset

مادة عرض على YouTube.

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

string

عنوان فيديو YouTube

youtubeVideoId

string

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

ImageAsset

مادة عرض صورة

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

enum (MimeType)

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

fullSize

object (ImageDimension)

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

fileSize

string (int64 format)

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

MimeType

نوع MIME

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

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

هذه قيمة للاستجابة فقط.

IMAGE_JPEG نوع MIME للصورة/jpeg.
IMAGE_GIF نوع MIME للصورة/gif هو.
IMAGE_PNG نوع MIME للصورة/png.
FLASH نوع MIME للتطبيق/x-shockwave-flash.
TEXT_HTML نوع MIME عبارة عن نص/html.
PDF نوع MIME للتطبيق/pdf.
MSWORD نوع MIME للتطبيق/msword.
MSEXCEL نوع MIME لملف app/vnd.ms-excel.
RTF نوع MIME للتطبيق/rtf.
AUDIO_WAV نوع MIME للصوت/wav.
AUDIO_MP3 نوع MIME للصوت/mp3.
HTML5_AD_ZIP نوع MIME للتطبيق/x-html5-ad-zip.

ImageDimension

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

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

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

يمثل معيارًا من معايير جدولة الإعلانات.

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

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

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

enum (MinuteOfHour)

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

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

endMinute

enum (MinuteOfHour)

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

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

dayOfWeek

enum (DayOfWeek)

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

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

startHour

integer

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

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

endHour

integer

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

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

MinuteOfHour

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

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

DayOfWeek

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

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

UnifiedSitelinkAsset

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

تمثيل JSON
{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "trackingId": string,
  "useSearcherTimeZone": boolean,
  "mobilePreferred": boolean
}
الحقول
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.
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)

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

callConversionAction

string

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

adScheduleTargets[]

object (AdScheduleInfo)

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

callOnly

boolean

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

callTrackingEnabled

boolean

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

useSearcherTimeZone

boolean

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

startDate

string

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

endDate

string

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

CallConversionReportingState

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

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

CallToActionAsset

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

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

enum (CallToActionType)

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

CallToActionType

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

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

UnifiedLocationAsset

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

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

string

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

businessProfileLocations[]

object (BusinessProfileLocation)

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

locationOwnershipType

enum (LocationOwnershipType)

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

BusinessProfileLocation

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

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

string

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

storeCode

string

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

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

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

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

enum (ListingGroupFilterBiddingCategoryLevel)

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

id

string (int64 format)

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

يعادل هذا المعرّف رقم تعريف فئة_المنتجات google_product_category كما هو موضّح في هذه المقالة: https://support.google.com/merchants/answer/6324436

ListingGroupFilterBiddingCategoryLevel

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

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

ProductBrand

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

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

string

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

ProductChannel

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

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

enum (ListingGroupFilterProductChannel)

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

ListingGroupFilterProductChannel

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

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

ProductCondition

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

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

enum (ListingGroupFilterProductCondition)

قيمة الشرط.

ListingGroupFilterProductCondition

يشير هذا المقياس إلى قيم التعداد التي تصف حالة عرض المنتج.

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

ProductCustomAttribute

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

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

enum (ListingGroupFilterCustomAttributeIndex)

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

value

string

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

ListingGroupFilterCustomAttributeIndex

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

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

ProductItemId

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

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

string

قيمة المعرّف

ProductType

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

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

enum (ListingGroupFilterProductTypeLevel)

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

value

string

قيمة النوع.

ListingGroupFilterProductTypeLevel

يشير هذا المقياس إلى قيم التعداد التي تصف مستوى نوع عرض المنتج.

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

ListingGroupFilterDimensionPath

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

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

object (ListingGroupFilterDimension)

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

AssetGroupTopCombinationView

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

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

string

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

assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

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

AssetGroupAssetCombinationData

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

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

object (AssetUsage)

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

AssetUsage

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

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

string

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

servedAssetFieldType

enum (ServedAssetFieldType)

نوع الحقل المعروض لمادة العرض.

ServedAssetFieldType

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

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

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

هذه قيمة للاستجابة فقط.

HEADLINE_1 مادة العرض مستخدَمة في العنوان 1.
HEADLINE_2 يتم استخدام مادة العرض في العنوان 2.
HEADLINE_3 يتم استخدام مادة العرض في العنوان 3.
DESCRIPTION_1 تُستخدم مادة العرض في الوصف 1.
DESCRIPTION_2 تُستخدم مادة العرض في الوصف 2.
HEADLINE تم استخدام مادة العرض في عنوان. لا تستخدم هذه السمة إلا في حال وجود عنوان واحد فقط في الإعلان. بخلاف ذلك، يمكنك استخدام التعدادات HEADLINE_1 أو HEADLINE_2 أو HEADLINE_3
HEADLINE_IN_PORTRAIT تم استخدام مادة العرض كعنوان في الصورة العمودية.
LONG_HEADLINE تمّ استخدام مادة العرض في عنوان طويل (مُستخدَم في متعدد مواد العرض المتجاوبة).
DESCRIPTION تم استخدام مادة العرض في الوصف. لا تستخدم هذا الخيار إلا إذا كان هناك وصف واحد فقط في الإعلان. في الحالات الأخرى، استخدم التعدادين DESCRIPTION_1 أو DESCRIPTION_@.
DESCRIPTION_IN_PORTRAIT تم استخدام مادة العرض كوصف في الصورة العمودية.
BUSINESS_NAME_IN_PORTRAIT تم استخدام مادة العرض كاسم للنشاط التجاري في الصورة العمودية.
BUSINESS_NAME تم استخدام مادة العرض كاسم للنشاط التجاري.
MARKETING_IMAGE تم استخدام مادة العرض كصورة تسويقية.
MARKETING_IMAGE_IN_PORTRAIT تم استخدام مادة العرض كصورة تسويقية في صورة عمودية.
SQUARE_MARKETING_IMAGE تم استخدام مادة العرض كصورة تسويقية مربّعة.
PORTRAIT_MARKETING_IMAGE تم استخدام مادة العرض كصورة تسويقية عمودية.
CALL_TO_ACTION تم استخدام مادة العرض كعبارة تحث المستخدم على اتخاذ إجراء.
YOU_TUBE_VIDEO تم استخدام مادة العرض كفيديو على YouTube.
CALL يتمّ استخدام مادة العرض هذه كمكالمة.
MOBILE_APP يتمّ استخدام مادة العرض هذه كتطبيق متوافق مع الأجهزة الجوّالة.
CALLOUT يتمّ استخدام مادة العرض هذه كوسيلة شرح.
STRUCTURED_SNIPPET يتم استخدام مادة العرض هذه كمقتطف من الموقع.
PRICE يتمّ استخدام مادة العرض هذه كسعر.
PROMOTION يتمّ استخدام مادة العرض هذه كعرض ترويجي.
AD_IMAGE يتم استخدام مادة العرض هذه كصورة.
LEAD_FORM يتم استخدام مادة العرض كنموذج عملاء محتملين.

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 المعروض في الإعلان لا يمكن ضبط هذا الحقل إلا عند ضبط المسار 1.

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

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

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

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

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

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

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)

إعداد التحكّم في حملات التسوّق.

geoTargetTypeSetting

object (GeoTargetTypeSetting)

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

labels[]

string

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

biddingStrategyType

enum (BiddingStrategyType)

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

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

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

accessibleBiddingStrategy

string

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

frequencyCaps[]

object (FrequencyCapEntry)

قائمة تحدّ من عدد مرات مشاهدة كل مستخدم لإعلانات هذه الحملة.

selectiveOptimization

object (SelectiveOptimization)

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

optimizationGoalSetting

object (OptimizationGoalSetting)

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

trackingSetting

object (TrackingSetting)

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

engineId

string

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

excludedParentAssetFieldTypes[]

enum (AssetFieldType)

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

createTime

string

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

creationTime

string

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

lastModifiedTime

string

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

id

string (int64 format)

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

name

string

اسم الحملة.

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

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

trackingUrlTemplate

string

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

campaignBudget

string

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

startDate

string

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

endDate

string

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

finalUrlSuffix

string

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

urlExpansionOptOut

boolean

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

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

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

biddingStrategy

string

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

manualCpa

object (ManualCpa)

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

manualCpc

object (ManualCpc)

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

manualCpm

object (ManualCpm)

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

maximizeConversions

object (MaximizeConversions)

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

maximizeConversionValue

object (MaximizeConversionValue)

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

targetCpa

object (TargetCpa)

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

targetImpressionShare

object (TargetImpressionShare)

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

targetRoas

object (TargetRoas)

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

targetSpend

object (TargetSpend)

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

percentCpc

object (PercentCpc)

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

targetCpm

object (TargetCpm)

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

CampaignStatus

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

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

CampaignServingStatus

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

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

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

هذه قيمة للاستجابة فقط.

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

BiddingStrategySystemStatus

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

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

AdServingOptimizationStatus

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

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

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

هذه قيمة للاستجابة فقط.

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

AdvertisingChannelType

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

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
SEARCH شبكة البحث. يشمل ذلك "الحملات على الشبكة الإعلانية" و"الحملات على شبكة البحث" و"الحملات على شبكة البحث".
DISPLAY شبكة Google الإعلانية فقط.
SHOPPING يتمّ عرض "حملات التسوّق" على موقع التسوّق وعلى نتائج البحث على google.com.
HOTEL حملات إعلانات الفنادق.
VIDEO حملات الفيديو
MULTI_CHANNEL "حملات التطبيقات" و"حملات التطبيقات لجذب المستخدِمين الحاليين" التي يتم عرضها في قنوات متعدّدة
LOCAL حملات الإعلانات المحلية
SMART الحملات الذكية:
PERFORMANCE_MAX حملات الأداء الأفضل:
LOCAL_SERVICES حملات الخدمات المحلّية.
DISCOVERY الحملات أثناء التصفّح:
TRAVEL "حملات السفر":

AdvertisingChannelSubType

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

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

CustomParameter

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

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

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" الأخرى.

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

string

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

useVehicleInventory

boolean

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

merchantId

string (int64 format)

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

salesCountry

string

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

campaignPriority

integer

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

enableLocal

boolean

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

GeoTargetTypeSetting

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

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

enum (PositiveGeoTargetType)

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

negativeGeoTargetType

enum (NegativeGeoTargetType)

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

PositiveGeoTargetType

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

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

NegativeGeoTargetType

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

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

FrequencyCapEntry

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

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

SelectiveOptimization

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

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

string

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

OptimizationGoalSetting

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

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

enum (OptimizationGoalType)

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

OptimizationGoalType

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

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

TrackingSetting

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

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

string

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

ManualCpa

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

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

ManualCpc

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

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

boolean

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

ManualCpm

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

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

PercentCpc

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

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

string (int64 format)

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

enhancedCpcEnabled

boolean

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

TargetCpm

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

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

CampaignAsset

تمثّل هذه السمة رابطًا بين حملة ومادة عرض.

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

string

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

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

status

enum (AssetLinkStatus)

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

campaign

string

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

asset

string

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

CampaignAssetSet

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

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

string

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

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

campaign

string

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

assetSet

string

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

status

enum (AssetSetLinkStatus)

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

CampaignAudienceView

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

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

string

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

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

CampaignCriterion

معيار حملة.

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

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

string

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

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

displayName

string

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

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

type

enum (CriterionType)

نوع المعيار.

status

enum (CampaignCriterionStatus)

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

lastModifiedTime

string

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

criterionId

string (int64 format)

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

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

bidModifier

number

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

negative

boolean

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

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

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

keyword

object (KeywordInfo)

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

location

object (LocationInfo)

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

device

object (DeviceInfo)

الجهاز.

ageRange

object (AgeRangeInfo)

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

gender

object (GenderInfo)

الجنس.

userList

object (UserListInfo)

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

language

object (LanguageInfo)

اللغة

webpage

object (WebpageInfo)

صفحة ويب

locationGroup

object (LocationGroupInfo)

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

CampaignCriterionStatus

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

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

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

هذه قيمة للاستجابة فقط.

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

LanguageInfo

معيار لغة.

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

string

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

LocationGroupInfo

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

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

string

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

radiusUnits

enum (LocationGroupRadiusUnits)

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

feedItemSets[]

string

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

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

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

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

العميل

عميل.

تمثيل JSON
{
  "resourceName": string,
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "accountType": enum (AccountType),
  "doubleClickCampaignManagerSetting": {
    object (DoubleClickCampaignManagerSetting)
  },
  "accountStatus": enum (AccountStatus),
  "lastModifiedTime": string,
  "engineId": string,
  "status": enum (CustomerStatus),
  "creationTime": string,
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "manager": boolean
}
الحقول
resourceName

string

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

customers/{customerId}

conversionTrackingSetting

object (ConversionTrackingSetting)

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

accountType

enum (AccountType)

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

doubleClickCampaignManagerSetting

object (DoubleClickCampaignManagerSetting)

إعداد DoubleClick Campaign Manager لعميل إداري.

accountStatus

enum (AccountStatus)

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

lastModifiedTime

string

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

engineId

string

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

status

enum (CustomerStatus)

حالة العميل.

creationTime

string

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

id

string (int64 format)

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

descriptiveName

string

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

currencyCode

string

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

timeZone

string

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

trackingUrlTemplate

string

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

finalUrlSuffix

string

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

autoTaggingEnabled

boolean

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

manager

boolean

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

ConversionTrackingSetting

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

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

boolean

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

conversionTrackingStatus

enum (ConversionTrackingStatus)

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

enhancedConversionsForLeadsEnabled

boolean

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

googleAdsConversionCustomer

string

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

conversionTrackingId

string (int64 format)

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

googleAdsCrossAccountConversionTrackingId

string (int64 format)

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

crossAccountConversionTrackingId

string (int64 format)

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

ConversionTrackingStatus

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

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

AccountType

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

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

DoubleClickCampaignManagerSetting

إعداد DoubleClick Campaign Manager لعميل إداري.

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

string (int64 format)

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

networkId

string (int64 format)

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

timeZone

string

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

AccountStatus

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

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

CustomerStatus

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

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

CustomerAsset

تمثّل هذه السمة رابطًا بين عميل ومادة عرض.

تمثيل JSON
{
  "resourceName": string,
  "asset": string,
  "status": enum (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

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

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)

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

targetCpaMicros

string (int64 format)

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

TargetCpa

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

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

string (int64 format)

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

TargetImpressionShare

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

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

enum (TargetImpressionShareLocation)

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

locationFractionMicros

string (int64 format)

الجزء المختار من الإعلانات الذي سيتم عرضه في الموقع الجغرافي المستهدف بالميكرو ثانية. على سبيل المثال، تساوي 1% 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

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

appliedLabels[]

string

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

customers/{customerId}/labels/{label_id}

status

enum (CustomerStatus)

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

clientCustomer

string

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

hidden

boolean

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

للقراءة فقط

level

string (int64 format)

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

timeZone

string

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

testAccount

boolean

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

manager

boolean

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

descriptiveName

string

تمثّل هذه السمة الاسم الوصفي للعميل. للقراءة فقط

currencyCode

string

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

id

string (int64 format)

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

DynamicSearchAdsSearchTermView

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

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

string

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

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

landingPage

string

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

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

GenderView

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

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

string

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

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

GeoTargetConstant

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

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

string

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

geoTargetConstants/{geo_target_constant_id}

status

enum (GeoTargetConstantStatus)

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

id

string (int64 format)

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

name

string

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

countryCode

string

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

targetType

string

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

canonicalName

string

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

parentGeoTarget

string

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

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

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

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

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

هذه قيمة للاستجابة فقط.

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

KeywordView

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

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

string

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

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

التصنيف

التصنيف

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

string

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

status

enum (LabelStatus)

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

textLabel

object (TextLabel)

يشير ذلك المصطلح إلى نوع من التصنيفات يعرض نصًا على خلفية ملوّنة.

id

string (int64 format)

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

name

string

اسم التصنيف.

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

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

LabelStatus

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

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

TextLabel

يشير ذلك المصطلح إلى نوع من التصنيفات يعرض نصًا على خلفية ملوّنة.

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

string

لون خلفية التصنيف بالتنسيق RGB يجب أن تتطابق هذه السلسلة مع التعبير العادي '^#([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، (على سبيل المثال، إذا access_reason=SHARED).

UserListType

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

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
REMARKETING يتم تمثيل قائمة المستخدمين كمجموعة من أنواع الإحالات الناجحة.
LOGICAL يتم تمثيل قائمة المستخدمين كمجموعة من قوائم/اهتمامات المستخدمين الأخرى.
EXTERNAL_REMARKETING قائمة المستخدمين التي تم إنشاؤها في منصة "مدير إعلانات Google".
RULE_BASED UserList المرتبطة بقاعدة.
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" رقمًا تعريفيًا. بالنسبة إلى الإحالات الناجحة على الإنترنت، تساوي هذه القيمة عمود "id" (رقم التعريف) أو عمود FloodlightOrderId استنادًا إلى تعليمات Floodlight للمعلِن.

productId

string

رقم تعريف المنتج الذي تم النقر عليه.

productChannel

enum (ProductChannel)

قناة البيع الخاصة بالمنتج الذي تم النقر عليه: على الإنترنت أو محلي

productLanguageCode

string

اللغة (ISO-639-1) التي تم ضبطها لخلاصة Merchant Center وتحتوي على بيانات حول المنتج.

productStoreId

string

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

productCountryCode

string

البلد (بالتنسيق ISO-3166) المسجَّل في خلاصة المستودع التي تحتوي على المنتج الذي تم النقر عليه.

attributionType

enum (AttributionType)

ما تُنسب إليه الإحالة الناجحة: زيارة أو الكلمة الرئيسية+الإعلان.

conversionDateTime

string

الطابع الزمني لحدث الإحالة الناجحة.

conversionLastModifiedDateTime

string

الطابع الزمني لآخر مرة تم فيها تعديل الإحالة الناجحة.

conversionVisitDateTime

string

الطابع الزمني للزيارة التي تُنسب إليها الإحالة الناجحة.

conversionQuantity

string (int64 format)

كمية السلع التي سجّلتها الإحالة الناجحة، على النحو الذي تحدّده المَعلمة qty لعنوان 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,
  "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

إجمالي عدد التحويلات. ويتضمّن هذا جميع الإحالات الناجحة بصرف النظر عن قيمة includeIn ConversionsMetric. عند اختيار هذا العمود مع التاريخ، تشير القيم في عمود "التاريخ" إلى تاريخ الإحالة الناجحة. تتوفّر تفاصيل أعمدة 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)

نسبة النقر إلى الظهور (CTR) السابقة المتوقعة في البحث.

interactionEventTypes[]

enum (InteractionEventType)

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

rawEventConversionMetrics[]

object (Value)

مقاييس الإحالات الناجحة الأولية للأحداث.

absoluteTopImpressionPercentage

number

"نسبة ظهور الإعلان في صدارة الصفحة على شبكة البحث" هي النسبة المئوية لمرات ظهور إعلانك في أبرز موضع على "شبكة البحث".

allConversionsFromInteractionsRate

number

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

allConversionsValue

number

قيمة كل الإحالات الناجحة.

allConversions

number

إجمالي عدد التحويلات. ويتضمّن هذا جميع الإحالات الناجحة بصرف النظر عن قيمة includeIn ConversionsMetric.

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

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

conversionsValuePerCost

number

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

conversionsFromInteractionsValuePerInteraction

number

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

clientAccountConversions

number

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

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

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

crossDeviceConversions

number

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

crossDeviceConversionsValue

number

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

ctr

number

عدد النقرات التي يتلقاها إعلانك (النقرات) مقسومًا على عدد مرات عرض إعلانك (مرات الظهور).

conversions

number

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

conversionsValue

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)

تكلفة السلع المُباعة من خلال بيع منتجات إضافية لحساب العميل هي إجمالي تكلفة المنتجات المُباعة نتيجة للإعلان عن منتج مختلف. آلية العمل: يمكنك تسجيل "الإحالات الناجحة استنادًا إلى بيانات سلّة التسوّق" لعمليات الشراء المكتملة على موقعك الإلكتروني. إذا كان الإعلان الذي تمّ التفاعل معه قبل الشراء مرتبطًا بمنتج ما (راجِع إعلانات 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,
  "month": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productItemId": string,
  "productLanguage": string,
  "productSoldBiddingCategoryLevel1": string,
  "productSoldBiddingCategoryLevel2": string,
  "productSoldBiddingCategoryLevel3": string,
  "productSoldBiddingCategoryLevel4": string,
  "productSoldBiddingCategoryLevel5": string,
  "productSoldBrand": string,
  "productSoldCustomAttribute0": string,
  "productSoldCustomAttribute1": string,
  "productSoldCustomAttribute2": string,
  "productSoldCustomAttribute3": string,
  "productSoldCustomAttribute4": string,
  "productSoldItemId": string,
  "productSoldTitle": string,
  "productSoldTypeL1": string,
  "productSoldTypeL2": string,
  "productSoldTypeL3": string,
  "productSoldTypeL4": string,
  "productSoldTypeL5": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "week": string,
  "year": integer,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
الحقول
adNetworkType

enum (AdNetworkType)

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

conversionActionCategory

enum (ConversionActionCategory)

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

conversionCustomDimensions[]

object (Value)

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

dayOfWeek

enum (DayOfWeek)

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

device

enum (Device)

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

keyword

object (Keyword)

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

productChannel

enum (ProductChannel)

قناة المنتج

productChannelExclusivity

enum (ProductChannelExclusivity)

حصرية قناة المنتج

productCondition

enum (ProductCondition)

حالة المنتج.

productSoldCondition

enum (ProductCondition)

حالة المنتج المُباعة.

rawEventConversionDimensions[]

object (Value)

أبعاد الإحالة الناجحة للأحداث الأولية.

conversionAction

string

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

conversionActionName

string

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

date

string

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

month

string

الشهر كما هو موضح بتاريخ أول يوم من الشهر. وقد تم التنسيق كـ yyyy-MM-dd.

productBiddingCategoryLevel1

string

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

productBiddingCategoryLevel2

string

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

productBiddingCategoryLevel3

string

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

productBiddingCategoryLevel4

string

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

productBiddingCategoryLevel5

string

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

productBrand

string

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

productCountry

string

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

productCustomAttribute0

string

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

productCustomAttribute1

string

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

productCustomAttribute2

string

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

productCustomAttribute3

string

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

productCustomAttribute4

string

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

productItemId

string

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

productLanguage

string

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

productSoldBiddingCategoryLevel1

string

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

productSoldBiddingCategoryLevel2

string

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

productSoldBiddingCategoryLevel3

string

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

productSoldBiddingCategoryLevel4

string

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

productSoldBiddingCategoryLevel5

string

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

productSoldBrand

string

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

productSoldCustomAttribute0

string

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

productSoldCustomAttribute1

string

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

productSoldCustomAttribute2

string

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

productSoldCustomAttribute3

string

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

productSoldCustomAttribute4

string

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

productSoldItemId

string

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

productSoldTitle

string

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

productSoldTypeL1

string

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

productSoldTypeL2

string

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

productSoldTypeL3

string

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

productSoldTypeL4

string

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

productSoldTypeL5

string

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

productStoreId

string

رقم تعريف متجر المنتج

productTitle

string

عنوان المنتج.

productTypeL1

string

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

productTypeL2

string

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

productTypeL3

string

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

productTypeL4

string

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

productTypeL5

string

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

quarter

string

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

week

string

الأسبوع كما هو محدّد من الاثنين إلى الأحد، ويُشار إليه بتاريخ الاثنين. وقد تم التنسيق كـ yyyy-MM-dd.

year

integer

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

assetInteractionTarget

object (AssetInteractionTarget)

لا تُستخدم إلّا مع مقاييس CustomerAsset وCampaignAsset وGroupAsset. يشير إلى ما إذا كانت مقاييس التفاعل حدثت في مادة العرض نفسها أو في مادة عرض أو وحدة إعلانية مختلفة. ويتم احتساب التفاعلات (مثل النقرات) على مستوى جميع أجزاء الإعلان المعروض (مثل الإعلان نفسه ومكوّنات أخرى مثل روابط أقسام الموقع) عند عرضها معًا. عندما تكون قيمةInteractOnThisAsset صحيحة، يعني ذلك أنّ التفاعلات على مادة العرض المحدّدة هذه، وعندما تكون التفاعلاتOnThisAsset غير صحيحة، هذا يعني أنّ التفاعلات لا تظهر على مادة العرض المحددة هذه، بل على أجزاء أخرى من الإعلان المعروض.

AdNetworkType

لتعداد أنواع شبكات "إعلانات Google".

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN القيمة غير معروفة في هذا الإصدار.
SEARCH بحث Google.
SEARCH_PARTNERS شركاء البحث.
CONTENT للشبكة الإعلانية.
YOUTUBE_WATCH فيديوهات YouTube
MIXED الشبكة المتقاطعة.

كلمة رئيسية

شريحة معيار الكلمة الرئيسية.

تمثيل JSON
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
الحقول
info

object (KeywordInfo)

معلومات الكلمة الرئيسية.

adGroupCriterion

string

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

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