Audience

O público-alvo é uma opção de segmentação eficaz que permite usar diferentes atributos de segmentos, como informações demográficas e afinidades detalhadas, para criar públicos-alvo que representem seções dos seus segmentos.

Representação JSON 
{
  "resourceName": string,
  "id": string,
  "status": enum (AudienceStatus),
  "name": string,
  "description": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "exclusionDimension": {
    object (AudienceExclusionDimension)
  }
}
Campos
resourceName

string

Imutável. O nome do recurso do público. Os nomes dos públicos-alvo têm o seguinte formato:

customers/{customerId}/audiences/{audience_id}
id

string (int64 format)

Apenas saída. ID do público-alvo.
status

enum (AudienceStatus)

Apenas saída. Status deste público-alvo. Indica se o público-alvo foi ativado ou removido.
name

string

Obrigatório. Nome do público-alvo. Ele precisa ser único para todos os públicos. Ele precisa ter um comprimento mínimo de 1 e máximo de 255.
description

string

É a descrição deste público-alvo.
dimensions[]

object (AudienceDimension)

Dimensões positivas que especificam a composição do público-alvo.
exclusionDimension

object (AudienceExclusionDimension)

Dimensão negativa que especifica a composição do público-alvo.

AudienceStatus

Enumeração contendo possíveis tipos de status do público.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa o valor desconhecido nesta versão.
ENABLED Status ativado: o público-alvo está ativado e pode ser segmentado.
REMOVED Status removido: o público-alvo foi removido e não pode ser usado para segmentação.

AudienceDimension

Dimensão positiva que especifica o público-alvo do usuário.

Representação 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.
}
Campos
Campo de união dimension. Dimensão que especifica os usuários que pertencem ao público-alvo. dimension pode ser apenas de um dos tipos a seguir:
age

object (AgeDimension)

Dimensão que especifica os usuários por idade.
gender

object (GenderDimension)

Dimensão que especifica os usuários pelo gênero.
householdIncome

object (HouseholdIncomeDimension)

Dimensão que especifica os usuários pela renda familiar.
parentalStatus

object (ParentalStatusDimension)

Dimensão que especifica os usuários pelo status parental.
audienceSegments

object (AudienceSegmentDimension)

Dimensão que especifica os usuários por associação a outros segmentos de público-alvo.

AgeDimension

Dimensão que especifica os usuários por idade.

Representação JSON 
{
  "ageRanges": [
    {
      object (AgeSegment)
    }
  ],
  "includeUndetermined": boolean
}
Campos
ageRanges[]

object (AgeSegment)

Faixa etária contígua a ser incluída na dimensão.
includeUndetermined

boolean

Inclui usuários com idade não determinada.

AgeSegment

Faixa etária contígua.

Representação JSON 
{
  "minAge": integer,
  "maxAge": integer
}
Campos
minAge

integer

Idade mínima para incluir. É necessário especificar a idade mínima de 18 anos. Os valores permitidos são 18, 25, 35, 45, 55 e 65.
maxAge

integer

Idade máxima a ser incluída. Não é necessário especificar uma idade máxima. Se especificado, maxAge precisa ser maior que minAge, e os valores permitidos são 24, 34, 44, 54 e 64.

GenderDimension

Dimensão que especifica os usuários pelo gênero.

Representação JSON 
{
  "genders": [
    enum (GenderType)
  ],
  "includeUndetermined": boolean
}
Campos
genders[]

enum (GenderType)

Segmentos demográficos de gênero incluídos.
includeUndetermined

boolean

Inclui usuários com gênero não determinado.

HouseholdIncomeDimension

Dimensão que especifica os usuários pela renda familiar.

Representação JSON 
{
  "incomeRanges": [
    enum (IncomeRangeType)
  ],
  "includeUndetermined": boolean
}
Campos
incomeRanges[]

enum (IncomeRangeType)

Segmentos demográficos de renda familiar incluídos.
includeUndetermined

boolean

Inclui usuários cuja renda familiar não é determinada.

ParentalStatusDimension

Dimensão que especifica os usuários pelo status parental.

Representação JSON 
{
  "parentalStatuses": [
    enum (ParentalStatusType)
  ],
  "includeUndetermined": boolean
}
Campos
parentalStatuses[]

enum (ParentalStatusType)

Segmentos demográficos de status parental incluídos.
includeUndetermined

boolean

Incluir usuários com status parental indeterminado.

AudienceSegmentDimension

Dimensão que especifica os usuários por associação a outros segmentos de público-alvo.

Representação JSON 
{
  "segments": [
    {
      object (AudienceSegment)
    }
  ]
}
Campos
segments[]

object (AudienceSegment)

Segmentos de público-alvo incluídos. Os usuários são incluídos se pertencem a pelo menos um segmento.

AudienceSegment

Segmento de público-alvo positivo.

Representação 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.
}
Campos
Campo de união segment. Segmento positivo. segment pode ser apenas de um dos tipos a seguir:
userList

object (UserListSegment)

Segmento da lista de usuários.
userInterest

object (UserInterestSegment)

Segmento de afinidade ou no mercado.
lifeEvent

object (LifeEventSegment)

Segmento de público-alvo de evento ao vivo.
detailedDemographic

object (DetailedDemographicSegment)

Segmento demográfico detalhado.
customAudience

object (CustomAudienceSegment)

Segmento de público-alvo personalizado.

UserListSegment

Segmento da lista de usuários. A desativação dos Públicos-alvo semelhantes começa em maio de 2023. Consulte https://ads-developers.googleblog.com/2022/11/announcing-deprecation-and-sunset-of.html (em inglês) para outras opções.

Representação JSON 
{
  "userList": string
}
Campos
userList

string

O recurso da lista de usuários.

UserInterestSegment

Segmento de interesse do usuário.

Representação JSON 
{
  "userInterestCategory": string
}
Campos
userInterestCategory

string

O recurso de interesse do usuário.

LifeEventSegment

Segmento do evento ao vivo.

Representação JSON 
{
  "lifeEvent": string
}
Campos
lifeEvent

string

O recurso de evento importante.

DetailedDemographicSegment

Segmento demográfico detalhado.

Representação JSON 
{
  "detailedDemographic": string
}
Campos
detailedDemographic

string

O recurso demográfico detalhado.

CustomAudienceSegment

Segmento de público-alvo personalizado.

Representação JSON 
{
  "customAudience": string
}
Campos
customAudience

string

O recurso de público-alvo personalizado.

AudienceExclusionDimension

Dimensão negativa que especifica os usuários a serem excluídos do público-alvo.

Representação JSON 
{
  "exclusions": [
    {
      object (ExclusionSegment)
    }
  ]
}
Campos
exclusions[]

object (ExclusionSegment)

Segmento de público-alvo a ser excluído.

ExclusionSegment

É um segmento de público-alvo a ser excluído de um público-alvo.

Representação JSON 
{

  // Union field segment can be only one of the following:
  "userList": {
    object (UserListSegment)
  }
  // End of list of possible types for union field segment.
}
Campos
Campo de união segment. Segmento a ser excluído. segment pode ser apenas de um dos tipos a seguir:
userList

object (UserListSegment)

Segmento da lista de usuários a ser excluído.