CustomAudience

Um público-alvo personalizado. Esta é uma lista de usuários por interesse.

Representação JSON 
{
  "resourceName": string,
  "id": string,
  "status": enum (CustomAudienceStatus),
  "name": string,
  "type": enum (CustomAudienceType),
  "description": string,
  "members": [
    {
      object (CustomAudienceMember)
    }
  ]
}
Campos
resourceName

string

Imutável. O nome do recurso do público-alvo personalizado. Os nomes dos recursos de público-alvo personalizado têm o seguinte formato:

customers/{customerId}/customAudiences/{custom_audience_id}
id

string (int64 format)

Apenas saída. ID do público-alvo personalizado.
status

enum (CustomAudienceStatus)

Apenas saída. Status desse público-alvo personalizado. Indica se o público-alvo personalizado está ativado ou removido.
name

string

Nome do público-alvo personalizado. Ele precisa ser exclusivo para todos os públicos-alvo personalizados criados por um cliente. Este campo é obrigatório para criar operações.
type

enum (CustomAudienceType)

Tipo do público-alvo personalizado. ("INTEREST" OU "PURCHASE_INTENT" não são permitidos para públicos-alvo personalizados recém-criados, mas são mantidos para públicos-alvo existentes)
description

string

Descrição desse público-alvo personalizado.
members[]

object (CustomAudienceMember)

Lista de membros do público-alvo personalizado. Os membros podem ser adicionados durante a criação de um público-alvo personalizado. Se os membros forem apresentados na operação UPDATE, os membros atuais serão substituídos.

CustomAudienceStatus

Enum que contém possíveis status de público-alvo personalizado.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
ENABLED Status ativado: o público-alvo personalizado está ativado e pode ser segmentado.
REMOVED Status "Removido": o público-alvo personalizado foi removido e não pode ser usado para segmentação.

CustomAudienceType

Enum que contém possíveis tipos de público-alvo personalizado.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
AUTO O Google Ads vai selecionar automaticamente a melhor interpretação no momento da veiculação.
INTEREST Corresponde aos usuários com base nos interesses deles.
PURCHASE_INTENT Combina os usuários por temas que estão pesquisando ou produtos que estão considerando comprar.
SEARCH Corresponde aos usuários com base no que eles pesquisaram na Pesquisa Google.

CustomAudienceMember

Um membro do público-alvo personalizado. Um membro pode ser uma PALAVRA-CHAVE, um URL, uma CATEGORIA_DE_LUGAR ou um APP. Ele só pode ser criado ou removido, mas não alterado.

Representação 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)

O tipo de membro do público-alvo personalizado: PALAVRA-CHAVE, URL, PLACE_CATEGORY ou APP.
Campo de união value. O valor de CustomAudienceMember. Um campo é preenchido dependendo do tipo de membro. value pode ser apenas de um dos tipos a seguir:
keyword

string

Uma palavra-chave ou frase-chave com, no máximo, 10 palavras e 80 caracteres. Idiomas com caracteres duplos, como chinês, japonês ou coreano, têm 40 caracteres para descrever os interesses ou ações do usuário.
url

string

Um URL HTTP, com protocolo incluído, de no máximo 2.048 caracteres, que inclui conteúdo de interesse dos usuários.
placeCategory

string (int64 format)

Um tipo de lugar descrito por uma categoria de lugar que os usuários visitam.
app

string

Um nome de pacote de apps Android instalados pelos usuários, como com.google.example.

CustomAudienceMemberType

Enum que contém possíveis tipos de membros do público-alvo personalizado.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
KEYWORD Usuários cujos interesses ou ações são descritos por uma palavra-chave.
URL Usuários que têm interesses relacionados ao conteúdo do site.
PLACE_CATEGORY Usuários que visitam tipos de lugar descritos por uma categoria de lugar.
APP Usuários que instalaram um app para dispositivos móveis.