CustomAudience

Un segmento di pubblico personalizzato. Questo è un elenco di utenti in base agli interessi.

Rappresentazione JSON 
{
  "resourceName": string,
  "id": string,
  "status": enum (CustomAudienceStatus),
  "name": string,
  "type": enum (CustomAudienceType),
  "description": string,
  "members": [
    {
      object (CustomAudienceMember)
    }
  ]
}
Campi
resourceName

string

Immutabile. Il nome della risorsa del segmento di pubblico personalizzato. I nomi delle risorse di pubblico personalizzate hanno il seguente formato:

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

string (int64 format)

Solo output. ID del segmento di pubblico personalizzato.
status

enum (CustomAudienceStatus)

Solo output. Stato di questo segmento di pubblico personalizzato. Indica se il segmento di pubblico personalizzato è stato attivato o rimosso.
name

string

Il nome del segmento di pubblico personalizzato. Deve essere univoco per tutti i segmenti di pubblico personalizzati creati da un cliente. Questo campo è obbligatorio per creare operazioni.
type

enum (CustomAudienceType)

Tipo di segmento di pubblico personalizzato. ("INTEREST" OR "PURCHASE_INTENT" non è consentito per il segmento di pubblico personalizzato appena creato, ma viene mantenuto per i segmenti di pubblico esistenti)
description

string

Descrizione di questo segmento di pubblico personalizzato.
members[]

object (CustomAudienceMember)

Elenco dei membri del segmento di pubblico personalizzato da cui è composto questo segmento di pubblico personalizzato. I membri possono essere aggiunti durante la creazione dei segmenti di pubblico personalizzati. Se i membri vengono visualizzati nell'operazione di AGGIORNAMENTO, i membri esistenti verranno sostituiti.

CustomAudienceStatus

Enum contenente possibili stati dei segmenti di pubblico personalizzati.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
ENABLED Stato attivato: il segmento di pubblico personalizzato è attivato e può essere scelto come target.
REMOVED Stato rimosso. Il segmento di pubblico personalizzato è stato rimosso e non può essere utilizzato per il targeting.

CustomAudienceType

Enum contenente possibili tipi di segmenti di pubblico personalizzati.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
AUTO Google Ads seleziona automaticamente la migliore interpretazione al momento della pubblicazione.
INTEREST Abbina gli utenti in base ai loro interessi.
PURCHASE_INTENT Abbina gli utenti in base agli argomenti che stanno cercando o ai prodotti che stanno prendendo in considerazione per l'acquisto.
SEARCH Abbina gli utenti in base a ciò che hanno cercato nella Ricerca Google.

CustomAudienceMember

Un membro di un segmento di pubblico personalizzato. Un membro può essere KEYWORD, URL, PLACE_CATEGORY o APP. Può essere solo creato o rimosso, ma non modificato.

Rappresentazione 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.
}
Campi
memberType

enum (CustomAudienceMemberType)

Il tipo di membro del pubblico personalizzato, KEYWORD, URL, PLACE_CATEGORY o APP.
Campo di unione value. Il valore CustomAudienceMember. Un campo viene compilato in base al tipo di membro. value può essere solo uno dei seguenti:
keyword

string

Una parola chiave o una frase chiave composta da un massimo di 10 parole e 80 caratteri. Nelle lingue con caratteri a doppia larghezza, come cinese, coreano o giapponese, è consentito inserire 40 caratteri, che descrivono gli interessi o le azioni dell'utente.
url

string

Un URL HTTP, incluso nel protocollo, di massimo 2048 caratteri, che include i contenuti per i quali gli utenti sono interessati.
placeCategory

string (int64 format)

Un tipo di luogo descritto da una categoria di luogo visitata dagli utenti.
app

string

Un nome di pacchetto delle app Android installate dagli utenti, ad esempio com.google.example.

CustomAudienceMemberType

Enum contenente possibili tipi di membri del segmento di pubblico personalizzati.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
KEYWORD Utenti i cui interessi o azioni sono descritti da una parola chiave.
URL Utenti che hanno interessi correlati ai contenuti del sito web.
PLACE_CATEGORY Utenti che visitano tipi di luogo descritti in base a una categoria di luogo.
APP Utenti che hanno installato un'app mobile.