معیارها

معیارهای هدف‌یابی را می‌توان در سه سطح مختلف تنظیم کرد:

• در سطح پویش.
• در سطح گروه آگهی.
• در سطح مشتری.

همه انواع معیارها را نمی‌توان در همه سطوح تنظیم کرد: برخی‌از آن‌ها، برای مثال، فقط در سطح پویش قابل تنظیم هستند. علاوه‌براین، برخی‌از معیارها فقط می‌توانند برای هدف‌یابی منفی استفاده شوند و برخی‌از آن‌ها فقط می‌توانند برای هدف‌یابی مثبت استفاده شوند.

معیارهای پشتیبانی‌شده براساس سطح

جدول زیر استفاده مجاز از همه انواع معیارها را شرح می‌دهد:

تفاوت‌های نسخه

چندین نوع معیار و رفتار اعتبارسنجی در نسخه‌های پشتیبانی‌شده Google Ads API متفاوت است:

• نسخه ۲۶ و جدیدتر:
  • از require_eu_political_advertising_declaration در CampaignCriterion و AdGroupCriterion پشتیبانی می‌کند تا تعیین کند آیا معیاری به اظهارنامه تبلیغات سیاسی سطح پویش اتحادیه اروپا نیاز دارد یا نه.
  • از ابعاد سفر مستقل از حوزه در AdGroupBidModifier و دلایل خطای مستقل از حوزه در CriterionError استفاده می‌کند (جایگزین معیارهای ویژه هتل و کدهای خطا در نسخه ۲۵ و نسخه‌های قبلی).
• نسخه ۲۵ و جدیدتر: از معیار EntityBid (entity_bid) در AdGroupCriterion با نوع معیار VERTICAL_ADS_ITEM_BID برای تنظیم قیمت‌های پیشنهادی سطح مورد برای نهادهای سفر در «آگهی‌های عمودی» پشتیبانی می‌کند.
• نسخه ۲۴ و بالاتر:
  • از 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 (مجازشده) برای سیگنال‌های گروه دارایی «عملکرد بیشینه» پشتیبانی می‌کند.
  • وقتی تلاش می‌شود همه هدف‌ها در یک بُعد جمعیت‌شناختی (AgeRangeInfo، GenderInfo، IncomeRangeInfo، یا ParentalStatusInfo) مستثنی شوند، CriterionError.CANNOT_EXCLUDE_ALL_TARGETS را برمی‌گرداند.
  • وقتی تلاش می‌کنید زبان غیرمجازی را هدف‌یابی کنید، 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 را بازرسی کنید تا با تجزیه کردن resource_name برگشتی، audience_id را به‌دست آورید، و می‌توانید فیلدهای تغییرپذیر (مثل 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}")