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),
  "description": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "exclusionDimension": {
    object (AudienceExclusionDimension)
  },
  "scope": enum (AudienceScope),
  "assetGroup": string,
  "name": string
}
Campos
resourceName

string

Inmutable. Es el nombre del recurso del público. Los nombres de los públicos tienen el siguiente formato:

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 se habilitó o quitó el público.
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.
scope

enum (AudienceScope)

Define el alcance en el que se puede usar este público. De forma predeterminada, el alcance es CUSTOMER. Los públicos se pueden crear con un alcance de ASSET_GROUP para uso exclusivo por parte de un solo assetGroup. El alcance puede variar de ASSET_GROUP a CUSTOMER, pero no de CUSTOMER a ASSET_GROUP.
assetGroup

string

Inmutable. Es el grupo de recursos en el que se determina el alcance de este público. Solo se debe establecer si el alcance es ASSET_GROUP. Inmutable después de la creación Si un público con alcance de ASSET_GROUP se actualiza al alcance de CUSTOMER, este campo se borrará automáticamente.
name

string

Es el nombre del público. Debe ser único para todos los públicos de la cuenta. Debe tener una longitud mínima de 1 y una longitud máxima de 255. Obligatorio cuando el alcance no está establecido o se establece en CUSTOMER. No se puede establecer o actualizar cuando el alcance es ASSET_GROUP.

AudienceStatus

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

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor que se muestra. Representa un valor desconocido en esta versión.
ENABLED Enabled: El público está 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 que especifica los usuarios según su edad.
gender

object (GenderDimension)

Dimensión que especifica los usuarios por su género.
householdIncome

object (HouseholdIncomeDimension)

Dimensión que especifica los usuarios según su ingreso familiar.
parentalStatus

object (ParentalStatusDimension)

Dimensión que especifica los usuarios por su estado parental.
audienceSegments

object (AudienceSegmentDimension)

Dimensión que especifica los usuarios según su membresía en otros segmentos de público.

AgeDimension

Dimensión que especifica 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

Incluir a los usuarios cuya edad no se ha 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, que debe ser mayor de 18 años. Los valores permitidos son 18, 25, 35, 45, 55 y 65.
maxAge

integer

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

GenderDimension

Dimensión que especifica los usuarios por su género.

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

enum (GenderType)

Segmentos demográficos de género incluidos
includeUndetermined

boolean

Incluir a los usuarios cuyo género no se ha determinado.

HouseholdIncomeDimension

Dimensión que especifica los usuarios según su ingreso familiar.

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

enum (IncomeRangeType)

Se incluyeron los segmentos demográficos de ingresos familiares.
includeUndetermined

boolean

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

ParentalStatusDimension

Dimensión que especifica 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 que especifica los usuarios según 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 de eventos 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 desactivación de los Públicos similares comienza 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 lista de usuarios.

UserInterestSegment

Segmento de intereses de los usuarios

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

string

Es el recurso de interés del usuario.

LifeEventSegment

Segmento de evento 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

Es 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)

Segmento de público que se excluirá.

ExclusionSegment

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)

Segmento de la lista de usuarios que se excluirá.

AudienceScope

Enumeración que contiene posibles valores de alcance del público.

Enumeradores
UNSPECIFIED No se especificó el alcance.
UNKNOWN El valor recibido no se conoce en esta versión.
CUSTOMER El público se define a nivel del cliente.
ASSET_GROUP El público se define en un AssetGroup específico.