CustomAudience

Un público personalizado. Esta es una lista de usuarios según sus intereses.

Representación JSON
{
  "resourceName": string,
  "id": string,
  "status": enum (CustomAudienceStatus),
  "name": string,
  "type": enum (CustomAudienceType),
  "description": string,
  "members": [
    {
      object (CustomAudienceMember)
    }
  ]
}
Campos
resourceName

string

Inmutable. El nombre del recurso del público personalizado. Los nombres de los recursos de público personalizado tienen el siguiente formato:

customers/{customerId}/customAudiences/{custom_audience_id}

id

string (int64 format)

Solo salida. Es el ID del público personalizado.

status

enum (CustomAudienceStatus)

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

name

string

Es el nombre del público personalizado. Debe ser único para todos los públicos personalizados creados por un cliente. Este campo es obligatorio para crear operaciones.

type

enum (CustomAudienceType)

Es el tipo del público personalizado. ("INTEREST" O "PURCHASE_INTENT" no se permiten para el público personalizado recién creado, pero se mantiene para los públicos existentes).

description

string

Es la descripción de este público personalizado.

members[]

object (CustomAudienceMember)

Lista de miembros del público personalizado que componen este público personalizado. Se pueden agregar miembros durante la creación de CustomAudience. Si los miembros se presentan en la operación UPDATE, se anularán los existentes.

CustomAudienceStatus

Enumeración que contiene posibles estados de públicos personalizados.

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 personalizado está habilitado y se puede orientar.
REMOVED Estado quitado: Se quitó el público personalizado y no se puede utilizar para la segmentación.

CustomAudienceType

Enumeración que contiene posibles tipos de públicos personalizados.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor de retorno. Representa un valor desconocido en esta versión.
AUTO Al momento de la publicación, Google Ads seleccionará automáticamente la mejor interpretación.
INTEREST Busca coincidencias en los usuarios según sus intereses.
PURCHASE_INTENT Hace coincidir a los usuarios según los temas que investigan o los productos que consideran comprar.
SEARCH Busca coincidencias en los usuarios según sus búsquedas en la Búsqueda de Google.

CustomAudienceMember

Es un miembro de un público personalizado. Un miembro puede ser una KEYWORD, una URL, PLACE_CATEGORY o APP. Solo puede crearse o quitarse, pero no puede modificarse.

Representación JSON
{
  "memberType": enum (CustomAudienceMemberType),

  // Union field value can be only one of the following:
  "keyword": string,
  "url": string,
  "placeCategory": string,
  "app": string
  // End of list of possible types for union field value.
}
Campos
memberType

enum (CustomAudienceMemberType)

El tipo de miembro del público personalizado, KEYWORD, URL, PLACE_CATEGORY o APP.

Campo de unión value. Es el valor de CustomAudienceMember. Se propaga un campo en función del tipo de miembro. Las direcciones (value) solo pueden ser una de las siguientes opciones:
keyword

string

Una palabra clave o frase de palabras clave (un máximo de 10 palabras y 80 caracteres). Los idiomas que utilizan caracteres de doble ancho, como el chino, el japonés o el coreano, pueden tener 40 caracteres, que describen los intereses o las acciones del usuario.

url

string

Una URL HTTP, con un protocolo incluido, con un máximo de 2,048 caracteres y que incluya el contenido que les interesa a los usuarios.

placeCategory

string (int64 format)

Es un tipo de lugar descrito por una categoría de lugar que visitan los usuarios.

app

string

Un nombre de paquete de las apps para Android que instalaron los usuarios, como com.google.example.

CustomAudienceMemberType

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

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor de retorno. Representa un valor desconocido en esta versión.
KEYWORD Son los usuarios cuyos intereses o acciones se describen mediante una palabra clave.
URL Son los usuarios con intereses relacionados con el contenido del sitio web.
PLACE_CATEGORY Son los usuarios que visitan los tipos de lugar descritos por una categoría de lugar.
APP Usuarios que instalaron una aplicación para dispositivos móviles.