Audience

El público es una opción de segmentación eficaz que te permite combinar diferentes atributos de segmentos, como públicos afines y datos demográficos detallados, para crear públicos que representen secciones de tus segmentos objetivo.

Representación JSON
{
  "resourceName": string,
  "id": string,
  "status": enum (AudienceStatus),
  "name": string,
  "description": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "exclusionDimension": {
    object (AudienceExclusionDimension)
  }
}
Campos
resourceName

string

Inmutable. Es el nombre del recurso del público. Los nombres del público tienen la siguiente forma:

customers/{customerId}/audiences/{audience_id}

id

string (int64 format)

Solo salida. Es el ID del público.

status

enum (AudienceStatus)

Solo salida. Es el estado de este público. Indica si el público se habilitó o se quitó.

name

string

Obligatorio. Es el nombre del público. Debe ser único para todos los públicos. Debe tener una longitud mínima de 1 y una máxima de 255.

description

string

Es la descripción de este público.

dimensions[]

object (AudienceDimension)

Dimensiones positivas que especifican la composición del público.

exclusionDimension

object (AudienceExclusionDimension)

Dimensión negativa que especifica la composición del público.

AudienceStatus

Enumeración que contiene posibles tipos de estados de público.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor de retorno. Representa un valor desconocido en esta versión.
ENABLED Habilitado: público habilitado y se puede orientar
REMOVED Estado quitado: El público se quitó y no se puede usar para la segmentación.

AudienceDimension

Dimensión positiva que especifica el público del usuario.

Representación 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ón dimension. Dimensión que especifica los usuarios que pertenecen al público. Las direcciones (dimension) solo pueden ser una de las siguientes opciones:
age

object (AgeDimension)

Dimensión en la que se especifican los usuarios según su edad.

gender

object (GenderDimension)

Dimensión en la que se especifican los usuarios por su género.

householdIncome

object (HouseholdIncomeDimension)

Dimensión en la que se especifican los usuarios según su ingreso familiar.

parentalStatus

object (ParentalStatusDimension)

Dimensión en la que se especifican los usuarios por su estado parental.

audienceSegments

object (AudienceSegmentDimension)

Dimensión en la que se especifican los usuarios por su membresía en otros segmentos de público.

AgeDimension

Dimensión en la que se especifican los usuarios según su edad.

Representación JSON
{
  "ageRanges": [
    {
      object (AgeSegment)
    }
  ],
  "includeUndetermined": boolean
}
Campos
ageRanges[]

object (AgeSegment)

Corresponde al rango de edad contiguo que se incluirá en la dimensión.

includeUndetermined

boolean

Incluye a los usuarios cuya edad no se haya determinado.

AgeSegment

Rango de edad contiguo.

Representación JSON
{
  "minAge": integer,
  "maxAge": integer
}
Campos
minAge

integer

Edad mínima para incluir. Se debe especificar una edad mínima y ser mayor de 18 años. Los valores permitidos son 18, 25, 35, 45, 55 y 65.

maxAge

integer

Edad máxima para incluir. No es necesario especificar una edad máxima. Si se especifica, maxAge debe ser mayor que minAge, y los valores permitidos son 24, 34, 44, 54 y 64.

GenderDimension

Dimensión en la que se especifican los usuarios por su género.

Representación JSON
{
  "genders": [
    enum (GenderType)
  ],
  "includeUndetermined": boolean
}
Campos
genders[]

enum (GenderType)

Se incluyeron los segmentos demográficos de género.

includeUndetermined

boolean

Incluye a los usuarios cuyo género no está determinado.

HouseholdIncomeDimension

Dimensión en la que se especifican los usuarios según su ingreso familiar.

Representación JSON
{
  "incomeRanges": [
    enum (IncomeRangeType)
  ],
  "includeUndetermined": boolean
}
Campos
incomeRanges[]

enum (IncomeRangeType)

Segmentos demográficos de ingresos familiares incluidos.

includeUndetermined

boolean

Incluye a los usuarios cuyos ingresos familiares no se hayan determinado.

ParentalStatusDimension

Dimensión en la que se especifican los usuarios por su estado parental.

Representación JSON
{
  "parentalStatuses": [
    enum (ParentalStatusType)
  ],
  "includeUndetermined": boolean
}
Campos
parentalStatuses[]

enum (ParentalStatusType)

Se incluyeron los segmentos demográficos de estado parental.

includeUndetermined

boolean

Incluir a los usuarios cuyo estado parental es indeterminado.

AudienceSegmentDimension

Dimensión en la que se especifican los usuarios por su membresía en otros segmentos de público.

Representación JSON
{
  "segments": [
    {
      object (AudienceSegment)
    }
  ]
}
Campos
segments[]

object (AudienceSegment)

Segmentos de público incluidos. Los usuarios se incluyen si pertenecen al menos a un segmento.

AudienceSegment

Segmento de público positivo.

Representación 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ón segment. Segmento positivo. Las direcciones (segment) solo pueden ser una de las siguientes opciones:
userList

object (UserListSegment)

Segmento de la lista de usuarios

userInterest

object (UserInterestSegment)

Segmento afín o en el mercado

lifeEvent

object (LifeEventSegment)

Segmento de público del evento en vivo

detailedDemographic

object (DetailedDemographicSegment)

Segmento demográfico detallado.

customAudience

object (CustomAudienceSegment)

Segmento de público personalizado

UserListSegment

Segmento de la lista de usuarios La descontinuación de los Públicos similares comenzará en mayo de 2023. Consulta https://ads-developers.googleblog.com/2022/11/announcing-deprecation-and-sunset-of.html para conocer otras opciones.

Representación JSON
{
  "userList": string
}
Campos
userList

string

El recurso de la lista de usuarios

UserInterestSegment

Segmento de intereses de usuarios

Representación JSON
{
  "userInterestCategory": string
}
Campos
userInterestCategory

string

El recurso de interés del usuario

LifeEventSegment

Segmento de eventos en vivo.

Representación JSON
{
  "lifeEvent": string
}
Campos
lifeEvent

string

El recurso de acontecimientos.

DetailedDemographicSegment

Segmento demográfico detallado.

Representación JSON
{
  "detailedDemographic": string
}
Campos
detailedDemographic

string

El recurso de datos demográficos detallados

CustomAudienceSegment

Segmento de público personalizado

Representación JSON
{
  "customAudience": string
}
Campos
customAudience

string

El recurso de público personalizado.

AudienceExclusionDimension

Dimensión negativa que especifica los usuarios que se excluirán del público.

Representación JSON
{
  "exclusions": [
    {
      object (ExclusionSegment)
    }
  ]
}
Campos
exclusions[]

object (ExclusionSegment)

El segmento de público que se excluirá.

ExclusionSegment

Es un segmento de público que se excluirá de un público.

Representación 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ón segment. Es el segmento que se excluirá. Las direcciones (segment) solo pueden ser una de las siguientes opciones:
userList

object (UserListSegment)

El segmento de la lista de usuarios que se excluirá.