المعايير

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

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

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

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

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

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

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

• الإصدار 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 بحثًا عن audience_id

عند إنشاء شريحة جمهور باستخدام 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}")