CustomAudience

Un público personalizado Esta es una lista de usuarios por interés.

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

string

Inmutable. Es 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. Estado de este público personalizado. Indica si el público personalizado está habilitado o quitado.

name

string

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

type

enum (CustomAudienceType)

Es el tipo de público personalizado. ("INTEREST" O "PURCHASE_INTENT" no se permite para el público personalizado creado recientemente, pero se mantiene para los públicos existentes)

description

string

Descripción de este público personalizado.

members[]

object (CustomAudienceMember)

Es la lista de miembros del público personalizado que lo compone. Los miembros se pueden agregar durante la creación de CustomAudience. Si los miembros se presentan en la operación UPDATE, se anularán los miembros existentes.

CustomAudienceStatus

Enum que contiene los posibles estados de los públicos personalizados.

Enumeraciones
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se muestra. Representa un valor desconocido en esta versión.
ENABLED Estado habilitado: El público personalizado está habilitado y se puede segmentar para anuncios.
REMOVED Estado eliminado: El público personalizado se quitó y no se puede usar para la segmentación.

CustomAudienceType

Enum que contiene los posibles tipos de públicos personalizados.

Enumeraciones
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa para el valor que se muestra. Representa un valor desconocido en esta versión.
AUTO Google Ads seleccionará automáticamente la mejor interpretación en el momento de la publicación.
INTEREST Hace coincidir a los usuarios según sus intereses.
PURCHASE_INTENT Busca usuarios en función de los temas que investigan o los productos que consideran comprar.
SEARCH Busca coincidencias entre los usuarios según lo que buscaron en la Búsqueda de Google.

CustomAudienceMember

Un miembro del público personalizado. Un miembro puede ser una PALABRA CLAVE, una URL, una PLACE_CATEGORY o una APP. Solo se puede crear o quitar, pero no cambiar.

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)

Es el tipo de miembro del público personalizado: PALABRA_CLAVE, URL, PLACE_CATEGORY o APP.

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

string

Una palabra clave o frase clave (como máximo, 10 palabras y 80 caracteres). Los idiomas con caracteres de ancho doble, 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, incluido el protocolo, de 2,048 caracteres como máximo, que incluye 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

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

CustomAudienceMemberType

Enum que contiene los posibles tipos de miembros de público personalizados.

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