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

Audience — это многократно используемый набор целевых сегментов, демографического таргетинга и исключений. Таргетинг по аудитории поддерживается для кампаний Performance Max , Demand Gen и App. Если вы хотите напрямую нацеливаться на сегменты аудитории в кампаниях Display, Search, Video, Hotel или Standard Shopping, см. раздел «Сегменты аудитории» .

Создавайте аудиторию

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

Проверьте значение параметра `mutateAudienceResult` для параметра `authentication_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

Целевая аудитория

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

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

В кампаниях Performance Max для таргетирования аудиторий используется сигнал группы 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 . При этом параметре при попытке добавить критерии, исключающие сегменты и демографические данные на уровне кампании, будет выдаваться ошибка.

Передовые методы

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

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

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

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