Критерии

Критерии таргетинга можно задать на трех уровнях:

• На уровне кампании.
• На уровне группы объявлений.
• На уровне клиента.

Не все типы критериев можно задать на всех уровнях. Например, некоторые из них можно задать только на уровне кампании. Кроме того, некоторые критерии можно использовать только для минус-таргетинга, а другие – только для таргетинга.

Поддерживаемые критерии по уровням

В таблице ниже описаны допустимые способы использования всех типов критериев.

Различия между версиями

В разных версиях 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 Поиске, автоматически подбираются для пользователей на основе языка креативов и целевых страниц, а также языковых настроек пользователей.
  • Создание или обновление критериев. Попытка создать или обновить критерий LanguageInfo в поисковой кампании завершается ошибкой ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT.
  • Запрос и удаление устаревших критериев. Существующие критерии CampaignCriterion.language в поисковых кампаниях по-прежнему возвращаются в ответах на запросы, хотя и не используются для показа объявлений. Хотя в интерфейсе Google Рекламы нет поля языкового таргетинга для поисковых кампаний, вы можете удалить устаревшие критерии CampaignCriterion.language с помощью CampaignCriterionService.