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. El nombre del recurso del público personalizado. Los nombres de los recursos de públicos personalizados 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 se habilitó o quitó el público personalizado.

name

string

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

type

enum (CustomAudienceType)

Tipo de 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 de este público personalizado compuesto por este. 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 existentes.

CustomAudienceStatus

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

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor que se muestra. Representa un valor desconocido en esta versión.
ENABLED Habilitado: público personalizado está habilitado y se puede orientar.
REMOVED Estado quitado: El público personalizado se quitó y no se puede usar 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 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 Hace coincidir a los usuarios según los temas que investigan o los productos que consideran comprar.
SEARCH Hace coincidir a los usuarios según lo que buscaron en la Búsqueda de Google.

CustomAudienceMember

Es miembro de un público personalizado. Un miembro puede ser KEYWORD, URL, PLACE_CATEGORY o APP. Solo se puede crear o quitar, 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 según el tipo de miembro. Las direcciones (value) solo pueden ser una de las siguientes opciones:
keyword

string

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

url

string

Una URL HTTP, con 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

Es 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 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 los 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.