تتيح واجهتا برمجة التطبيقات CampaignCriterionService و AdGroupCriterionService و CustomerNegativeCriterionService استهداف أنواع مختلفة من المعايير أو استبعادها.
معايير الحملة
يتيح لك CampaignCriterionService تحديد الاستهداف على مستوى الحملة للأنواع التالية. يمكنك أيضًا تحديد معدِّلات عروض أسعار على هذا المستوى باستخدام مضاعِف، ولكن لا يمكنك تحديد عروض أسعار مطلقة.
- AdScheduleInfo
لن تحتوي الحملة الجديدة تلقائيًا على جداول عرض إعلانات، ما يعني أنّ الإعلانات ستظهر خلال جميع الفترات الزمنية. يمكنك إعداد جدول لعرض الإعلانات، بما يصل إلى ربع ساعة، لتحديد الوقت المناسب لعرض إعلاناتك بدقة أكبر.
يمكنك استهداف جداول عرض الإعلانات فقط. الاستبعاد غير متاح.
- AgeRangeInfo
لن تتضمّن الحملة الجديدة تلقائيًا معايير للفئات العمرية، ما يعني أنّه يتم إدراج جميع الأعمار.
- BrandListInfo
تحدّد هذه السمة قائمة بالعلامات التجارية. يمكن أن يكون معيار من هذا النوع مستهدفًا أو مستبعدًا.
- CarrierInfo
لن تحتوي الحملة الجديدة تلقائيًا على معايير مشغّلي شبكات الجوّال، ما يعني أنّه سيتم تضمين جميع مشغّلي شبكات الجوّال. لا تتوفّر سوى المعايير الموجبة على مستوى الحملة.
- CombinedAudienceInfo
يمكن دمج أي عدد من معايير الجمهور في شريحة جمهور مجمّعة. بشكلٍ default، لا تحتوي الحملات الجديدة على أي شرائح جمهور مجمّعة. لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة "مركز المساعدة" حول شرائح الجمهور المجمّعة.
- ContentLabelInfo
لن تتضمّن الحملة الجديدة تلقائيًا معايير لتصنيف المحتوى، ما يعني أنّه يتم تضمين جميع الفئات. لا تتوفّر سوى المعايير السلبية على مستوى الحملة.
- CustomAffinityInfo
لن تحتوي الحملة الجديدة تلقائيًا على معايير تقارب مخصص. يتم تحديد معايير التقارب المخصصة من خلال موارد CustomInterest التي يجب أن ينشئها المستخدم. لا يمكن استخدام سوى المعايير الموجبة. تحتوي هذه المقالة على مزيد من التفاصيل حول آلية عمل معايير التشابه المخصّصة وكيفية استخدامها.
- CustomAudienceInfo
قائمة بالمستخدمين حسب الاهتمام يتم تحديد معايير الجمهور المخصّص من خلال موارد CustomAudience التي يجب أن ينشئها المستخدم. تحتوي هذه المقالة على مزيد من التفاصيل حول آلية عمل معايير الجمهور المخصّص وكيفية استخدامها.
- DeviceInfo
حدِّد معايير
DeviceInfo
باستخدام أحد التعدادات المُحدَّدة مسبقًا Device. الحالة الرئيسية لاستخدام استهداف الأجهزة هي تعديل عروض الأسعار لجهاز معيّن باستخدام قيمةbid_modifier
لسمة CampaignCriterion.يمكنك استهداف الأجهزة فقط. الاستبعاد غير متاح.
- GenderInfo
لن تحتوي الحملة الجديدة تلقائيًا على معايير للجنس، ما يعني أنّه يتم إدراج جميع الأجناس. لا تتوفّر سوى المعايير السلبية على مستوى الحملة.
- IncomeRangeInfo
لن تحتوي الحملة الجديدة تلقائيًا على معايير نطاق الدخل، ما يعني أنّه يتم تضمين جميع الدخل. لا يُسمح إلّا بالمعايير السلبية على مستوى الحملة
- IpBlockInfo
بشكل تلقائي، لن تتضمّن الحملة الجديدة معايير حظر عناوين IP، ما يعني أنّ كل البيانات مُدرَجة.
- KeywordInfo
يتم إنشاء الكلمات الرئيسية باستخدام نص حر الشكل وإحدى قيم التعداد لنوع المطابقة.
يمكنك استبعاد الكلمات الرئيسية على مستوى الحملة فقط، لذا يجب تحديد
negative = true
في CampaignCriterion للكلمة الرئيسية.- KeywordThemeInfo
يمكن تحديد قيمة ثابتة مُسبَقة لمواضيع الكلمات الرئيسية أو نص بتنسيق حر.
- LanguageInfo
لن تحتوي الحملة الجديدة تلقائيًا على معايير لغوية، ما يعني أنّه يتم تضمين كل اللغات. لا تتوفّر سوى المعايير الموجبة.
- ListingScopeInfo
لن تحتوي الحملة الجديدة تلقائيًا على معايير نطاق بطاقة بيانات المتجر. لا يُسمح إلا بالمعايير الإيجابية.
- LocalServiceIdInfo
يمثّل نوع خدمة (مثل
install_faucet
) يمكن أن تستهدفه "حملة الخدمات المحلية".- LocationInfo
يتم تنفيذ الاستهداف حسب الموقع الجغرافي المُسمّى كـ
LocationInfo
ويتم إنشاؤه باستخدام مجموعة ثابتة من أرقام تعريف المعايير. يتم إدراج أرقام التعريف المتاحة في المستندات ويمكن البحث عنها بشكل فردي باستخدامGeoTargetConstantService
. يمكن ضبط هذه المعايير على أنّها إيجابية أو سلبية، مع إلغاء استهدافات السلبية للاستهدافات الإيجابية. لن تتضمّن الحملة الجديدة تلقائيًا معايير للمواقع الجغرافية، ما يعني أنّه يتم استهداف جميع المواقع الجغرافية. مع عدم وجود استهداف للموقع الجغرافي، يتم عرض الإعلانات في كل مكان. عند إضافة الاستهداف حسب الموقع الجغرافي، يتم عرض الإعلانات في تلك المنطقة فقط.اطّلِع على مزيد من المعلومات عن الاستهداف حسب الموقع الجغرافي المُحدَّد باسم وأهمية الاستهداف الجغرافي.
- LocationGroupInfo
تتيح
LocationGroup
للحملات استهداف مناطق جغرافية متعددة. يتم تحديد هذه المناطق من خلال مجموعة من المواقع الجغرافية ونطاق جغرافي حول كل موقع جغرافي إما بالمتر أو الأميال. يمكن فلترة استهداف هذه المواقع الجغرافية باستخدام قائمة بأرقام تعريف معايير الاستهداف الجغرافي.اطّلِع على مزيد من المعلومات عن استهداف مناطق جغرافية متعددة.
- MobileAppCategoryInfo
لن تحتوي الحملة الجديدة تلقائيًا على معايير فئات التطبيقات المتوافقة مع الأجهزة الجوّالة، ما يعني أنّه يتم تضمين جميع الفئات. لا تتوفّر سوى المعايير السلبية على مستوى الحملة.
- MobileApplicationInfo
لن تحتوي المجموعة الإعلانية الجديدة تلقائيًا على معايير تطبيقات الأجهزة الجوّالة. يجب تحديد التطبيقات المتوافقة مع الأجهزة الجوّالة الفردية وفقًا لقيمة الحقل
app_id
.- MobileDeviceInfo
لن تحتوي الحملة الجديدة تلقائيًا على معايير الأجهزة الجوّالة، ما يعني أنّه يتم تضمين جميع الأجهزة.
لتحديد جهاز جوّال فردي، عليك استخدام اسم المورد MobileDeviceConstant لضبط الحقل
device
في معايير الحملة.يمكنك استهداف الأجهزة الجوّالة فقط. الاستبعاد غير متاح.
- OperatingSystemVersionInfo
لن تحتوي الحملة الجديدة تلقائيًا على معايير إصدار نظام التشغيل، ما يعني أنّه يتم استهداف جميع أنظمة التشغيل. لا يتم دعم سوى المعايير الإيجابية على مستوى الحملة.
- ParentalStatusInfo
لن تحتوي الحملة الجديدة تلقائيًا على أيّ معايير للحالة الأبوية، ما يعني أنّه سيتمّ تضمين جميع فئات الحالة الأبوية. لا يُسمح إلّا بالمعايير السلبية على مستوى الحملة.
- PlacementInfo
ويتم إنشاء هذه الإعلانات باستخدام عنوان URL للعميل. هناك حدود على طول عناوين URL المستخدمة (250 حرفًا) وعمقها (مستوىان). ولا يمكن سوى ضبطها على أنّها سلبية، ولن تحتوي الحملة الجديدة تلقائيًا على معايير مواضع الإعلانات. لا يُسمح بمواضع الإعلانات السلبية التي تحتوي على عنوان URL بالشكل التالي بالضبط:
adsenseformobileapps.com
.- ProximityInfo
يتم تنفيذ أهداف النطاق الجغرافي كمعايير ProximityInfo. ويمكن إنشاؤها باستخدام إما عنوان أو خط طول وخط الطول، وعن طريق تحديد نصف قطر. ولا يمكن ضبطها إلا على أنّها إيجابية، ولن تحتوي حملة جديدة تلقائيًا على معايير القرب.
اطّلِع على مزيد من المعلومات عن استهداف مستخدمي ميزة "شبه محيط جغرافي" .
- TopicInfo
لن تحتوي الحملة الجديدة تلقائيًا على معايير المواضيع. لا يُسمح إلّا بالمعايير السلبية على مستوى الحملة.
- UserInterestInfo
لن تحتوي الحملة الجديدة على معايير اهتمامات المستخدمين بشكلٍ تلقائي. لا تتوفّر سوى المعايير السلبية على مستوى الحملة.
عند استرداد
UserInterest
لضبطه فيUserInterestInfo
، تأكَّد منavailabilities[]
التوافق مع نوع الحملة. لا تتوفّر بعض خيارات "UserInterest
" إلا لأنواع معيّنة من الحملات.- UserListInfo
لن تحتوي الحملة الجديدة على معايير قوائم المستخدمين تلقائيًا. استخدِم رقم التعريف لقائمة المستخدمين لتحديد قائمة المستخدمين في المعيار. يتم دعم المعايير الإيجابية والسلبية على مستوى الحملة.
- WebpageInfo
لن تحتوي الحملة الجديدة بشكلٍ تلقائي على معايير صفحات الويب، مما يعني أنه يتم تضمين جميع صفحات الويب. لا تتوفّر سوى المعايير السلبية على مستوى الحملة.
- YouTubeChannelInfo
لن تحتوي الحملة الجديدة تلقائيًا على معايير قنوات YouTube. لا تتوفّر سوى المعايير السلبية على مستوى الحملة.
- YouTubeVideoInfo
لن تحتوي الحملة الجديدة على معايير فيديو YouTube بشكلٍ تلقائي. لا تتوفّر سوى المعايير السلبية على مستوى الحملة.
معايير المجموعة الإعلانية
تتيح لك AdGroupCriterionService تحديد الاستهداف على مستوى المجموعة الإعلانية للأنواع التالية.
- AgeRangeInfo
- لن تحتوي المجموعة الإعلانية الجديدة تلقائيًا على معايير الفئة العمرية، ما يعني تضمين جميع الفئات العمرية. على مستوى المجموعة الإعلانية، يمكنك تقديم عروض أسعار على الفئات العمرية أو استبعادها.
- AppPaymentModelInfo
- على مستوى المجموعة الإعلانية، يمكنك فقط استهداف معايير نموذج الدفع للتطبيقات.
- AudienceInfo
- بشكل تلقائي، لن تحتوي المجموعة الإعلانية الجديدة على معايير الجمهور. راجِع دليل إنشاء شرائح الجمهور وإدارتها لمعرفة كيفية ضبط استهداف الجمهور لمجموعة إعلانية في الحملات لزيادة الطلب.
- CombinedAudienceInfo
- يمكن دمج أي عدد من معايير الجمهور في جمهور مُجمَّع. لا تحتوي المجموعات الإعلانية الجديدة تلقائيًا على أي جماهير مجمَّعة. لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة مركز المساعدة حول شرائح الجمهور المجمّعة.
- CustomAffinityInfo
- بشكل تلقائي، لن تحتوي المجموعة الإعلانية الجديدة على معايير تقارب مخصص. يتم تحديد معايير التقارب المخصصة من خلال موارد CustomInterest التي يجب أن ينشئها المستخدم. لا يمكن استخدام سوى المعايير الموجبة.تتضمّن هذه المقالة مزيدًا من التفاصيل حول آلية عمل معايير التشابه المخصّصة وكيفية استخدامها.
- CustomAudienceInfo
- قائمة بالمستخدمين حسب الاهتمام يتمّ تحديد معايير شرائح الجمهور المخصّصة من خلال موارد CustomAudience التي يجب أن ينشئها المستخدِم. تحتوي هذه المقالة](https://support.google.com/google-ads/answer/2497941) على مزيد من التفاصيل حول آلية عمل معايير الجمهور المخصّص وكيفية استخدامها.
- CustomIntentInfo
- لن تحتوي المجموعة الإعلانية الجديدة تلقائيًا على معايير نية مخصّصة بالشراء. يتم تحديد معايير النية بالشراء من خلال موارد CustomInterest التي يجب أن ينشئها المستخدم. المعايير الإيجابية فقط هي التي يتم دعمها. تحتوي هذه المقالة على مزيد من المعلومات عن آلية عمل معايير النية بالشراء وكيفية استخدامها.
- GenderInfo
- تلقائيًا، لن تحتوي المجموعة الإعلانية الجديدة على معايير للجنس، ما يعني أنّه يتم تضمين جميع الأجناس. على مستوى المجموعة الإعلانية، يمكنك تقديم عروض أسعار على الأنواع أو استبعادها.
- IncomeRangeInfo
- لن تحتوي المجموعة الإعلانية الجديدة تلقائيًا على معايير نطاق الدخل، ما يعني أنّه سيتم تضمين جميع الدخل. على مستوى المجموعة الإعلانية، يمكنك تقديم عروض أسعار على نطاقات الدخل أو استبعادها.
- KeywordInfo
- على مستوى المجموعة الإعلانية، يمكنك استهداف الكلمات الرئيسية أو استبعادها.
- LanguageInfo
- لن تحتوي الحملة الجديدة تلقائيًا على معايير لغوية، ما يعني أنّه سيتم تضمين جميع اللغات. يُسمح فقط بالمعايير الإيجابية.
- ListingGroupInfo
- تحدّد مجموعات البيانات بنية معايير مستندة إلى العرض التدرّجي لإعلانات الفنادق وحملات التسوّق.
- LocationInfo
يتمّ تنفيذ الاستهداف حسب الموقع الجغرافي المُسمّى على أنّه
LocationInfo
ويتمّ إنشاؤه باستخدام مجموعة ثابتة من أرقام تعريف المعايير. يتم إدراج أرقام التعريف المتاحة في المستندات ويمكن البحث عنها بشكل فردي باستخدامGeoTargetConstantService
. يمكن تهيئة هذه المعايير على أنها إما إيجابية أو سالبة، مع أن تغلب الأهداف السلبية على الأهداف الإيجابية. لن تتضمّن الحملة الجديدة تلقائيًا معايير للمواقع الجغرافية، ما يعني أنّه يتم استهداف جميع المواقع الجغرافية. مع عدم وجود استهداف للموقع الجغرافي، يتم عرض الإعلانات في كل مكان. وعند إضافة ميزة "الاستهداف حسب الموقع الجغرافي"، لن يتم عرض الإعلانات إلا في تلك المنطقة.اطّلِع على مزيد من المعلومات عن الاستهداف حسب الموقع الجغرافي المُحدَّد باسم وأهمية الاستهداف الجغرافي.
- MobileAppCategoryInfo
على مستوى المجموعة الإعلانية، يمكنك استهداف معايير فئة التطبيقات المتوافقة مع الأجهزة الجوّالة أو استبعادها.
- MobileApplicationInfo
لن تحتوي المجموعة الإعلانية الجديدة تلقائيًا على معايير تطبيقات الأجهزة الجوّالة. يجب تحديد التطبيقات المتوافقة مع الأجهزة الجوّالة الفردية وفقًا لقيمة الحقل
app_id
.- ParentalStatusInfo
لن تحتوي المجموعة الإعلانية الجديدة تلقائيًا على أيّ معايير للحالة الأبوية، ما يعني أنّه سيتمّ تضمين جميع فئات الحالة الأبوية. على مستوى المجموعة الإعلانية، يمكنك تقديم عروض أسعار لفئات الحالة الأبوية أو استبعادها.
- PlacementInfo
ويتم إنشاء هذه الإعلانات باستخدام عنوان URL للعميل. هناك حدود لطول عناوين URL المستخدمة (250 حرفًا) وعمقها (مستويان). ولا يمكن ضبطها على أنّها سلبية إلا، ولن تحتوي المجموعة الإعلانية الجديدة على معايير مواضع الإعلانات بشكل تلقائي. لا يُسمح بمواضع الإعلانات السلبية التي لها عنوان URL
adsenseformobileapps.com
بالضبط.- TopicInfo
بشكل تلقائي، لن تحتوي المجموعة الإعلانية الجديدة على معايير المواضيع. على مستوى المجموعة الإعلانية، يمكنك تقديم عروض أسعار لفئات الدخل أو استبعادها.
- UserInterestInfo
بشكلٍ تلقائي، لن تحتوي المجموعة الإعلانية الجديدة على معايير اهتمامات المستخدمين. على مستوى المجموعة الإعلانية، يمكنك تقديم عروض أسعار لاهتمامات المستخدمين أو استبعادها.
عند استرداد
UserInterest
لضبطه فيUserInterestInfo
، تأكَّد منavailabilities[]
التوافق مع نوع الحملة. لا تتوفّر بعض خيارات "UserInterest
" إلا لأنواع معيّنة من الحملات.- UserListInfo
لن تحتوي المجموعة الإعلانية الجديدة تلقائيًا على معايير قوائم المستخدمين. استخدم معرّف قائمة المستخدمين لتحديد قائمة المستخدمين في المعيار. على مستوى المجموعة الإعلانية، يمكنك تقديم عروض أسعار على قوائم المستخدمين أو استبعادها.
- WebpageInfo
على مستوى المجموعة الإعلانية، يمكنك استهداف معايير صفحة الويب أو استبعادها.
- YouTubeChannelInfo
على مستوى المجموعة الإعلانية، يمكنك استهداف معايير قناة YouTube أو استبعادها.
- YouTubeVideoInfo
على مستوى المجموعة الإعلانية، يمكنك استهداف معايير فيديوهات YouTube أو استبعادها.
معايير العملاء
تتيح لك واجهة برمجة التطبيقات CustomerNegativeCriterionService تحديد الاستهداف السلبي على مستوى الحساب للأنواع التالية .
- ContentLabelInfo
- لن تتضمّن الحملة الجديدة تلقائيًا معايير لتصنيف المحتوى، ما يعني أنّه يتم تضمين جميع الفئات. على مستوى العملاء، لا يُسمح سوى بمعايير ContentLabelInfo السلبية.
- IpBlockInfo
- لن تحتوي الحملة الجديدة تلقائيًا على معايير حظر عناوين IP، ما يعني أنّه سيتم تضمين كل شيء. على مستوى العملاء، لا يتم دعم سوى معايير IpBlockInfo السلبية.
- MobileAppCategoryInfo
- استبعاد فئة تطبيقات متوافقة مع الأجهزة الجوّالة في قائمة MobileAppCategoryConstant
- MobileApplicationInfo
- استبعاد تطبيقات فردية متوافقة مع الأجهزة الجوّالة وفقًا لقيمة الحقل
app_id
. - NegativeKeywordList
- استبعاد
SharedSet
من الكلمات الرئيسية. لا يمكن إرفاق سوى معيار واحد لقائمة الكلمات الرئيسية السلبية لكل حساب. - PlacementInfo
- يتم إنشاء هذه السمات باستخدام عنوان URL للعميل. هناك حدود لطول عناوين URL المستخدمة
(250 حرفًا) وعمقها (مستويان). لا يُسمح بمواضع الإعلان السلبية
التي تحتوي على عنوان URL
adsenseformobileapps.com
بالضبط. - YouTubeChannelInfo
- استبعاد قناة على YouTube حسب معرّف القناة أو رمز القناة
- YouTubeVideoInfo
- يمكنك استبعاد فيديو محدّد على YouTube باستخدام معرّف الفيديو كما يظهر على صفحة مشاهدة YouTube.