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