Audience

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

JSON-представление
{
  "resourceName": string,
  "id": string,
  "status": enum (AudienceStatus),
  "name": string,
  "description": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "exclusionDimension": {
    object (AudienceExclusionDimension)
  }
}
Поля
resourceName

string

Неизменный. Имя ресурса аудитории. Имена аудиторий имеют вид:

customers/{customerId}/audiences/{audience_id}

id

string ( int64 format)

Только вывод. Идентификатор аудитории.

status

enum ( AudienceStatus )

Только вывод. Статус этой аудитории. Указывает, включена или удалена аудитория.

name

string

Необходимый. Название аудитории. Оно должно быть уникальным для всех аудиторий. Он должен иметь минимальную длину 1 и максимальную длину 255.

description

string

Описание этой аудитории.

dimensions[]

object ( AudienceDimension )

Положительные аспекты, определяющие состав аудитории.

exclusionDimension

object ( AudienceExclusionDimension )

Отрицательное измерение, определяющее состав аудитории.

Статус аудитории

Перечисление, содержащее возможные типы статуса аудитории.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
ENABLED Статус «Включено» — аудитория включена и может быть таргетирована.
REMOVED Статус «Удален» — аудитория удалена и не может быть использована для таргетинга.

Размер аудитории

Позитивное измерение, определяющее аудиторию пользователя.

JSON-представление
{

  // Union field dimension can be only one of the following:
  "age": {
    object (AgeDimension)
  },
  "gender": {
    object (GenderDimension)
  },
  "householdIncome": {
    object (HouseholdIncomeDimension)
  },
  "parentalStatus": {
    object (ParentalStatusDimension)
  },
  "audienceSegments": {
    object (AudienceSegmentDimension)
  }
  // End of list of possible types for union field dimension.
}
Поля
dimension поля объединения. Измерение, определяющее пользователей, принадлежащих к аудитории. dimension может быть только одной из следующих:
age

object ( AgeDimension )

Параметр, определяющий пользователей по их возрасту.

gender

object ( GenderDimension )

Параметр, определяющий пользователей по их полу.

householdIncome

object ( HouseholdIncomeDimension )

Измерение, определяющее пользователей по их семейному доходу.

parentalStatus

object ( ParentalStatusDimension )

Параметр, определяющий пользователей по их родительскому статусу.

audienceSegments

object ( AudienceSegmentDimension )

Измерение, определяющее пользователей по их принадлежности к другим сегментам аудитории.

ВозрастРазмерность

Параметр, определяющий пользователей по их возрасту.

JSON-представление
{
  "ageRanges": [
    {
      object (AgeSegment)
    }
  ],
  "includeUndetermined": boolean
}
Поля
ageRanges[]

object ( AgeSegment )

Непрерывный возрастной диапазон, который необходимо включить в измерение.

includeUndetermined

boolean

Включить пользователей, возраст которых не определен.

Возрастной сегмент

Соседний возрастной диапазон.

JSON-представление
{
  "minAge": integer,
  "maxAge": integer
}
Поля
minAge

integer

Минимальный возраст для включения. Необходимо указать минимальный возраст, который должен составлять не менее 18 лет. Допустимые значения: 18, 25, 35, 45, 55 и 65 лет.

maxAge

integer

Максимальный возраст для включения. Максимальный возраст указывать не обязательно. Если указано, maxAge должно быть больше minAge, а допустимые значения — 24, 34, 44, 54 и 64.

Гендерное измерение

Параметр, определяющий пользователей по их полу.

JSON-представление
{
  "genders": [
    enum (GenderType)
  ],
  "includeUndetermined": boolean
}
Поля
genders[]

enum ( GenderType )

Включены гендерно-демографические сегменты.

includeUndetermined

boolean

Включите пользователей, пол которых не определен.

ДомохозяйствоДоходИзмерение

Измерение, определяющее пользователей по их семейному доходу.

JSON-представление
{
  "incomeRanges": [
    enum (IncomeRangeType)
  ],
  "includeUndetermined": boolean
}
Поля
incomeRanges[]

enum ( IncomeRangeType )

Включены демографические сегменты доходов домохозяйств.

includeUndetermined

boolean

Включите пользователей, чей семейный доход не определен.

Родительский статусИзмерение

Параметр, определяющий пользователей по их родительскому статусу.

JSON-представление
{
  "parentalStatuses": [
    enum (ParentalStatusType)
  ],
  "includeUndetermined": boolean
}
Поля
parentalStatuses[]

enum ( ParentalStatusType )

Включены демографические сегменты родительского статуса.

includeUndetermined

boolean

Включите пользователей, чей родительский статус не определен.

АудиторияСегментИзмерение

Измерение, определяющее пользователей по их принадлежности к другим сегментам аудитории.

JSON-представление
{
  "segments": [
    {
      object (AudienceSegment)
    }
  ]
}
Поля
segments[]

object ( AudienceSegment )

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

Сегмент аудитории

Позитивный сегмент аудитории.

JSON-представление
{

  // Union field segment can be only one of the following:
  "userList": {
    object (UserListSegment)
  },
  "userInterest": {
    object (UserInterestSegment)
  },
  "lifeEvent": {
    object (LifeEventSegment)
  },
  "detailedDemographic": {
    object (DetailedDemographicSegment)
  },
  "customAudience": {
    object (CustomAudienceSegment)
  }
  // End of list of possible types for union field segment.
}
Поля
segment поля объединения. Позитивный сегмент. segment может быть только одним из следующих:
userList

object ( UserListSegment )

Сегмент списка пользователей.

userInterest

object ( UserInterestSegment )

Сегмент по интересам или заинтересованных покупателей.

lifeEvent

object ( LifeEventSegment )

Сегмент аудитории прямых трансляций.

detailedDemographic

object ( DetailedDemographicSegment )

Подробный демографический сегмент.

customAudience

object ( CustomAudienceSegment )

Пользовательский сегмент аудитории.

Пользовательский сегмент

Сегмент списка пользователей. Закрытие функции «Похожие аудитории» начнётся в мае 2023 года. Другие варианты см. на странице https://ads-developers.googleblog.com/2022/11/announcing-deprecation-and-sunset-of.html .

JSON-представление
{
  "userList": string
}
Поля
userList

string

Ресурс списка пользователей.

ПользовательскийИнтерестСегмент

Сегмент интересов пользователей.

JSON-представление
{
  "userInterestCategory": string
}
Поля
userInterestCategory

string

Ресурс по интересам пользователей.

ЖизньСобытиеСегмент

Сегмент живого мероприятия.

JSON-представление
{
  "lifeEvent": string
}
Поля
lifeEvent

string

Ресурс событий жизни.

Подробный демографический сегмент

Подробный демографический сегмент.

JSON-представление
{
  "detailedDemographic": string
}
Поля
detailedDemographic

string

Подробный демографический ресурс.

Пользовательский сегмент аудитории

Пользовательский сегмент аудитории.

JSON-представление
{
  "customAudience": string
}
Поля
customAudience

string

Ресурс пользовательской аудитории.

АудиторияИсключениеИзмерение

Отрицательное измерение, указывающее пользователей, которых следует исключить из аудитории.

JSON-представление
{
  "exclusions": [
    {
      object (ExclusionSegment)
    }
  ]
}
Поля
exclusions[]

object ( ExclusionSegment )

Сегмент аудитории, который необходимо исключить.

Сегмент исключения

Сегмент аудитории, который необходимо исключить из аудитории.

JSON-представление
{

  // Union field segment can be only one of the following:
  "userList": {
    object (UserListSegment)
  }
  // End of list of possible types for union field segment.
}
Поля
segment поля объединения. Сегмент, который необходимо исключить. segment может быть только одним из следующих:
userList

object ( UserListSegment )

Сегмент списка пользователей, который необходимо исключить.