Audience

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

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

string

Imutável. O nome do recurso do público-alvo. Os nomes de público-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.
description

string

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.
scope

enum (AudienceScope)

Define o escopo em que esse público pode ser usado. Por padrão, o escopo é CUSTOMER. Os públicos-alvo podem ser criados com um escopo de ASSET_GROUP para uso exclusivo por um único assetGroup. O escopo pode mudar de ASSET_GROUP para CUSTOMER, mas não de CUSTOMER para ASSET_GROUP.
assetGroup

string

Imutável. O grupo de recursos em que esse público-alvo está selecionado. Deve ser definido somente se o escopo for ASSET_GROUP. Imutável após a criação. Se um público-alvo com o escopo ASSET_GROUP for atualizado para o escopo CUSTOMER, este campo será apagado automaticamente.
name

string

Nome do público-alvo. Ele precisa ser exclusivo para todos os públicos-alvo da conta. Ele precisa ter comprimento mínimo de 1 e máximo de 255. Obrigatório quando o escopo não estiver definido ou estiver definido como CUSTOMER. Não é possível definir ou atualizar quando o escopo é ASSET_GROUP.

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 um 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 pela 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 pela associação a outros segmentos de público-alvo.

AgeDimension

Dimensão que especifica os usuários pela 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

Incluir usuários cuja 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 uma 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 deverá 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 sexo incluídos.
includeUndetermined

boolean

Incluir usuários cujo gênero não foi 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

Incluir 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

Inclui usuários com status parental indeterminado.

AudienceSegmentDimension

Dimensão que especifica os usuários pela 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 do 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 ver outras opções.

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

string

O recurso de 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.

AudienceScope

Enumeração que contém possíveis valores de escopo do público.

Enums
UNSPECIFIED O escopo não foi especificado.
UNKNOWN O valor recebido não é conhecido nesta versão.
CUSTOMER O escopo do público-alvo é definido no nível do cliente.
ASSET_GROUP O público-alvo é delimitado em um AssetGroup específico.