المعايير

يمكن ضبط معايير الاستهداف على ثلاثة مستويات مختلفة:

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

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

المعايير المتوافقة حسب المستوى

يوضّح الجدول التالي الاستخدام المسموح به لجميع أنواع المعايير:

الاختلافات بين الإصدارات

تختلف عدة أنواع من المعايير وسلوكيات التحقّق من الصحة في إصدارات Google Ads API المتوافقة:

• الإصدار 26 والإصدارات الأحدث:
  • تتيح هذه السمة استخدام require_eu_political_advertising_declaration في CampaignCriterion وAdGroupCriterion لتحديد ما إذا كان المعيار يتطلّب بيانًا عن الإعلانات السياسية في الاتحاد الأوروبي على مستوى الحملة.
  • يستخدم سمات السفر غير المرتبطة بمجال معيّن في AdGroupBidModifier وأسباب الأخطاء غير المرتبطة بمجال معيّن في CriterionError (يحلّ محلّ المعايير ورموز الأخطاء المتعلّقة بالفنادق في الإصدار 25 والإصدارات الأقدم).
• الإصدار 25 والإصدارات الأحدث: يتيح استخدام معيار EntityBid (entity_bid) في AdGroupCriterion مع نوع المعيار VERTICAL_ADS_ITEM_BID لضبط عروض الأسعار على مستوى السلعة لجهات السفر في "الإعلانات في القطاعات الرأسية".
• الإصدار 24 والإصدارات الأحدث:
  • يتيح استخدام RetailFilterBundle (AdGroupCriterion.retail_filter_bundle وAssetGroupListingGroupFilter.Dimension.retail_filter_bundle) وRetailFilter (SharedCriterion.retail_filter) لفلترة المنتجات المستندة إلى العلامات (الحسابات المدرَجة في القائمة المسموح بها فقط).
  • يتيح استخدام سمات قواعد user_rating وvenue وevent_participant_display_name في VerticalAdsItemGroupRuleInfo في SharedCriterion.
  • تتيح استخدام AssetGroupSignal.local_services_id وAssetGroupSignal.vertical_ads_item_group_rule_list (المُدرَجة في القائمة المسموح بها) لإشارات مجموعات مواد العرض في "حملات الأداء الأفضل".
  • يتم عرض CriterionError.CANNOT_EXCLUDE_ALL_TARGETS عند محاولة استبعاد جميع الاستهدافات ضمن سمة ديمغرافية (AgeRangeInfo أو GenderInfo أو IncomeRangeInfo أو ParentalStatusInfo).
  • يتم عرض CriterionError.CANNOT_TARGET_LANGUAGE عند محاولة استهداف لغة غير مسموح بها.
  • يتم عرض الخطأ CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN عند محاولة إزالة جميع المواقع الجغرافية من "حملة الأداء الأفضل" في "الخدمات المحلّية".

معايير استهداف معلومات الجمهور

يمكنك استهداف شرائح الجمهور على مستوى المجموعة الإعلانية باستخدام معايير AudienceInfo في AdGroupCriterion.audience. اضبط ad_group_criterion.audience.audience على اسم المورد Audience الذي تريد استهدافه. لاستخدام معايير AudienceInfo في AdGroupCriterion، عليك ضبط ad_group.audience_setting.use_audience_grouped = true عند إنشاء المجموعة الإعلانية (لا يمكن تغيير هذا الإعداد بعد الإنشاء). يمكنك أيضًا ضبط campaign.audience_setting.use_audience_grouped = true اختياريًا عند إنشاء الحملة لمنع استبعادات الشرائح والفئات الديمغرافية على مستوى الحملة.

فحص MutateAudienceResult

عند إنشاء شريحة جمهور باستخدام AudienceService.MutateAudiences، تُعرِض كل عملية MutateAudienceResult. يمكنك فحص MutateAudienceResult للحصول على audience_id من خلال تحليل resource_name الذي تم عرضه، ويمكنك فحص الحقول القابلة للتغيير (مثل name) في عنصر audience الذي تم عرضه عندما يتم ضبط response_content_type على MUTABLE_RESOURCE:

# Inspect MutateAudienceResult to get audience_id.
for result in response.results:
    resource_name = result.resource_name
    # Format: customers/{customer_id}/audiences/{audience_id}
    audience_id = audience_service.parse_audience_path(resource_name)[
        "audience_id"
    ]
    print(f"Created audience '{resource_name}' with ID '{audience_id}'.")

    # Access mutable fields on result.audience when MUTABLE_RESOURCE is requested.
    if result.audience.resource_name:
        print(f"Audience name from mutable resource: {result.audience.name}")

معايير استهداف اللغة

يمكنك استهداف اللغات بشكل إيجابي باستخدام معايير LanguageInfo على مستوى الحملة (CampaignCriterion.language) أو على مستوى المجموعة الإعلانية (AdGroupCriterion.language) من خلال ضبط language_constant على اسم مورد LanguageConstant يمكن استهدافه (بالصيغة languageConstants/{criterion_id}، اطّلِع على رموز اللغات المتاحة). في الإصدار 24 والإصدارات الأحدث، تؤدي محاولة استهداف لغة غير مسموح بها أو غير قابلة للاستهداف إلى ظهور الخطأ CriterionError.CANNOT_TARGET_LANGUAGE.

يعتمد توفّر ميزة "LanguageInfo" على نوع الحملة:

• أنواع الحملات المتوافقة: يمكنك استهداف اللغات في أنواع الحملات المؤهَّلة، مثل "الحملات على الشبكة الإعلانية" و"حملات الفيديو" وحملات الأداء الأفضل (على مستوى الحملة، وينطبق ذلك على القنوات غير "قناة شبكة البحث") وحملات التطبيقات (على مستوى الحملة) وحملات زيادة الطلب (على مستوى المجموعة الإعلانية تلقائيًا، أو على مستوى الحملة حسب DemandGenCampaignSettings.upgraded_targeting).
• "الحملات على شبكة البحث" (AdvertisingChannelType.SEARCH) و"AI Max في الحملات على شبكة بحث Google" وإعلانات "حملات الأداء الأفضل" على "بحث Google": لا يتوفّر الاستهداف اليدوي للّغة. بدلاً من ذلك، تتم مطابقة الإعلانات المعروضة على "بحث Google" تلقائيًا مع المستخدمين استنادًا إلى لغة مواد الإعلان الإبداعية وصفحاتك المقصودة بالإضافة إلى اللغات المفضّلة للمستخدمين:
  • إنشاء المعايير أو تعديلها: ستؤدي محاولة إنشاء معيار LanguageInfo أو تعديله في "حملة على شبكة البحث" إلى ظهور الخطأ ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT.
  • الاستعلام عن المعايير القديمة وإزالتها: لا تزال معايير CampaignCriterion.language الحالية في "الحملات على شبكة البحث" تظهر في الردود على الطلبات، على الرغم من أنّها لم تعُد تُستخدم في عرض الإعلانات. على الرغم من أنّ واجهة مستخدم "إعلانات Google" لا توفّر حقل استهداف اللغة في "الحملات على شبكة البحث"، يمكنك إزالة معايير CampaignCriterion.language القديمة باستخدام CampaignCriterionService.