Создание аудиторий и управление ими

Audience – это набор целевых сегментов, настроек демографического таргетинга и исключений, который можно использовать в разных кампаниях. Выбор целевой аудитории поддерживается в кампаниях с максимальной эффективностью, кампаниях для создания спроса и кампаниях для приложений. Если вы хотите настроить таргетинг на сегменты аудитории в кампании для гостиниц, стандартной торговой, видеокампании, кампании в поисковой или контекстно-медийной сети, прочитайте статью Сегменты аудитории.

Как создавать аудитории

Создайте и обновите аудиторию с помощью AudienceService. У каждого Audience должно быть уникальное название. Эта аудитория позволяет комбинировать несколько параметров аудитории:

Проверьте MutateAudienceResult на наличие audience_id.

При создании аудитории с помощью AudienceService.MutateAudiences каждая операция возвращает MutateAudienceResult. Вы можете проверить MutateAudienceResult, чтобы получить audience_id, проанализировав возвращенный resource_name, и вы можете проверить изменяемые поля (такие как name) в возвращенном объекте audience, когда для response_content_type установлено значение MUTABLE_RESOURCE:

# Configure the request to return the mutable resource in the response.
request = googleads_client.get_type("MutateAudiencesRequest")
request.customer_id = customer_id
request.operations = [operation]
request.response_content_type = (
    googleads_client.enums.ResponseContentTypeEnum.MUTABLE_RESOURCE
)

response = audience_service.mutate_audiences(request=request)

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}")

Получение аудиторий

Как и в случае с другими ресурсами, для получения атрибутов аудиторий можно использовать GoogleAdsService.SearchStream.

SELECT
  audience.id,
  audience.resource_name,
  audience.name,
  audience.status,
  audience.description,
  audience.dimensions,
  audience.exclusion_dimension
FROM audience

Таргетинг на аудитории

Таргетинг на аудитории можно настраивать по-разному в зависимости от типа кампании.

Сигналы групп объектов

В кампаниях с максимальной эффективностью для таргетинга на целевую аудиторию используется AssetGroupSignal. См. руководство Сигналы групп объектов, чтобы узнать, как настраивать таргетинг на целевую аудиторию с помощью сигналов групп объектов.

Критерий группы объявлений

В кампаниях для создания спроса и кампаниях для приложений можно добавлять критерий группы объявлений "Аудитория" с помощью AdGroupCriterion, чтобы настраивать таргетинг на целевые аудитории или предоставлять сигналы аудитории. Вы можете настроить таргетинг на аудитории на уровне группы объявлений, используя критерии AudienceInfo в AdGroupCriterion.audience. Для этого укажите название ресурса аудитории в поле AudienceInfo.audience (ad_group_criterion.audience.audience).

Чтобы настроить таргетинг на аудиторию, выполните следующие действия:

Включите выбор целевой аудитории в AdGroup.

При создании группы объявлений необходимо включить выбор целевой аудитории в AdGroup, задав для параметра use_audience_grouped значение true. После создания группы объявлений изменить эту настройку нельзя.

Это позволяет добавить AdGroupCriterion с аудиториями. Если не задать значение true, то последующий запрос на таргетинг на аудиторию не будет выполнен.

Создать AdGroupCriterion

Создайте объект AdGroupCriterion и задайте в поле AudienceInfo.audience объекта AdGroupCriterion.audience название ресурса аудитории, созданной на этапе Создание аудиторий.

Необязательно: включите выбор целевой аудитории в Campaign.

При создании кампании можно задать для поля use_audience_grouped значение true. Если вы попытаетесь добавить критерии, которые исключают сегменты и демографические группы на уровне кампании, то получите сообщение об ошибке.

Рекомендации

  • Используйте аудитории для создания портретов клиентов. Аудитории лучше всего использовать в кампаниях с максимальной эффективностью, кампаниях для создания спроса и кампаниях для приложений, когда вы хотите добавить несколько сегментов и демографических критериев, чтобы настроить таргетинг на определенный типаж.
  • Используйте сегменты аудитории для прямого таргетинга. Для кампаний в поисковой и контекстно-медийной сети, кампаний для гостиниц, видеокампаний и стандартных торговых кампаний, а также в случаях, когда вам нужно настроить таргетинг только на один сегмент (например, список ремаркетинга), используйте сегменты аудитории, а не аудитории.

Распространенные ошибки

При создании или обновлении Audience Google Ads API проверяет запрос и возвращает ошибки из перечисления AudienceError, если проверка не пройдена.

AudienceError
AUDIENCE_SEGMENT_NOT_FOUND
Сводка Сегмент аудитории, указанный в запросе, не найден.
Основные причины Ссылка на идентификатор сегмента, который не существует или недоступен.
Как обрабатывать Прежде чем создавать или обновлять аудиторию, убедитесь, что все идентификаторы сегментов существуют и доступны.
Советы по предотвращению Проверяйте идентификаторы сегментов, прежде чем добавлять их в аудиторию.
DIMENSION_INVALID
Сводка Недопустимый параметр аудитории.
Основные причины В том числе detailed_demographic в exclusion_dimension.
Как обрабатывать Для исключений в exclusion_dimension используйте только user_list.
Советы по предотвращению При создании или обновлении аудитории в exclusion_dimension можно использовать только user_list.
DUPLICATE_AUDIENCE_SEGMENT
Сводка Аудитория содержит повторяющиеся сегменты.
Основные причины Добавление одного и того же сегмента в одну аудиторию несколько раз.
Как обрабатывать Удалите повторяющиеся сегменты из определения аудитории.
Советы по предотвращению Убедитесь, что все сегменты в аудитории уникальны.
NAME_ALREADY_IN_USE
Сводка Аудитория с таким названием уже существует.
Основные причины Попытка создать несколько аудиторий с одинаковым названием.
Как обрабатывать При создании аудитории используйте уникальное название.
Советы по предотвращению Прежде чем создавать новую аудиторию, проверьте названия существующих.
TOO_MANY_DIMENSIONS_OF_SAME_TYPE
Сводка Аудитория содержит слишком много параметров одного типа.
Основные причины Включать в одну аудиторию несколько параметров одного типа (например, несколько параметров возраста).
Как обрабатывать Убедитесь, что определение аудитории содержит только один параметр каждого типа.
Советы по предотвращению Проверьте определение аудитории и убедитесь, что в него не включены повторяющиеся типы параметров.
TOO_MANY_SEGMENTS
Сводка В аудитории слишком много сегментов.
Основные причины Превышено максимально допустимое количество сегментов в аудитории.
Как обрабатывать Уменьшите количество сегментов в определении аудитории.
Советы по предотвращению Ограничения на количество сегментов в аудитории указаны в документации.