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

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
Сводка В аудитории слишком много сегментов.
Основные причины Превышение максимально допустимого количества сегментов в аудитории.
Как обрабатывать Уменьшите количество сегментов в определении аудитории.
Советы по предотвращению Ограничения на количество сегментов в аудитории указаны в документации.