CustomAudience

Un segmento di pubblico personalizzato. Si tratta di un elenco di utenti per interesse.

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 dei segmenti di pubblico personalizzati 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 è abilitato o rimosso.
name

string

Nome del segmento di pubblico personalizzato. Deve essere univoco per tutti i segmenti di pubblico personalizzati creati da un cliente. Questo campo è obbligatorio per la creazione delle operazioni.
type

enum (CustomAudienceType)

Tipo di segmento di pubblico personalizzato. ("INTEREST" OPPURE "PURCHASE_INTENT" non è consentito per i segmenti di pubblico personalizzati appena creati, 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 di cui è composto questo segmento di pubblico personalizzato. I membri possono essere aggiunti durante la creazione di CustomAudience. Se i membri sono presentati nell'operazione UPDATE, quelli esistenti verranno sostituiti.

CustomAudienceStatus

Enum contenente i possibili stati dei segmenti di pubblico personalizzati.

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

CustomAudienceType

Enum contenente i possibili tipi di segmenti di pubblico personalizzati.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
AUTO Google Ads selezionerà automaticamente l'interpretazione migliore al momento della pubblicazione.
INTEREST Corrispondenza utenti in base ai loro interessi.
PURCHASE_INTENT Abbina gli utenti in base agli argomenti che stanno cercando o ai prodotti che stanno valutando di acquistare.
SEARCH Corrisponde agli utenti in base alle loro ricerche nella Ricerca Google.

CustomAudienceMember

Un membro del segmento di pubblico personalizzato. Un elemento può essere una PAROLA_CHIAVE, un URL, una CATEGORIA_LUOGO o un'APP. Può essere 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 segmento di pubblico personalizzato, KEYWORD, URL, PLACE_CATEGORY o APP.
Campo 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 massimo 10 parole e 80 caratteri. Per le lingue con caratteri a doppia larghezza, come cinese, giapponese o coreano, sono consentiti 40 caratteri, che descrivono gli interessi o le azioni dell'utente.
url

string

Un URL HTTP, incluso il protocollo, di massimo 2048 caratteri, che include i contenuti che interessano agli utenti.
placeCategory

string (int64 format)

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

string

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

CustomAudienceMemberType

Enum contenente i possibili tipi di membri dei segmenti di pubblico personalizzati.

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