Audience

Il pubblico è un'opzione di targeting efficace che ti consente di incrociare diversi attributi di segmenti, ad esempio dati demografici dettagliati e affinità, per creare segmenti di pubblico che rappresentano sezioni dei tuoi segmenti target.

Rappresentazione JSON 
{
  "resourceName": string,
  "id": string,
  "status": enum (AudienceStatus),
  "description": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "exclusionDimension": {
    object (AudienceExclusionDimension)
  },
  "scope": enum (AudienceScope),
  "assetGroup": string,
  "name": string
}
Campi
resourceName

string

Immutabile. Il nome della risorsa del segmento di pubblico. I nomi dei segmenti di pubblico hanno il seguente formato:

customers/{customerId}/audiences/{audience_id}
id

string (int64 format)

Solo output. ID del segmento di pubblico.
status

enum (AudienceStatus)

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

string

Descrizione di questo segmento di pubblico.
dimensions[]

object (AudienceDimension)

Dimensioni positive che specificano la composizione del pubblico.
exclusionDimension

object (AudienceExclusionDimension)

Dimensione negativa che specifica la composizione del pubblico.
scope

enum (AudienceScope)

Definisce l'ambito in cui può essere utilizzato questo segmento di pubblico. Per impostazione predefinita, l'ambito è CUSTOMER. I segmenti di pubblico possono essere creati con l'ambito ASSET_GROUP per uso esclusivo da parte di un singolo assetGroup. L'ambito può cambiare da ASSET_GROUP a CUSTOMER ma non da CUSTOMER a ASSET_GROUP.
assetGroup

string

Immutabile. Il gruppo di asset a cui è limitato l'ambito di questo segmento di pubblico. Deve essere impostato solo se l'ambito è ASSET_GROUP. Immutabile dopo la creazione. Se viene eseguito l'upgrade all'ambito CUSTOMER per un segmento di pubblico con ambito ASSET_GROUP, questo campo verrà cancellato automaticamente.
name

string

Il nome del segmento di pubblico. Deve essere univoco per tutti i segmenti di pubblico all'interno dell'account. Deve avere una lunghezza minima di 1 e un massimo di 255. Obbligatorio quando l'ambito non è impostato o è impostato su CUSTOMER. Impossibile impostare o aggiornare quando l'ambito è ASSET_GROUP.

AudienceStatus

Enum contenente possibili tipi di stati del segmento di pubblico.

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 è attivato e può essere scelto come target.
REMOVED Stato rimosso: il segmento di pubblico è stato rimosso e non può essere utilizzato per il targeting.

AudienceDimension

Dimensione positiva che specifica il segmento di pubblico dell'utente.

Rappresentazione JSON 
{

  // Union field dimension can be only one of the following:
  "age": {
    object (AgeDimension)
  },
  "gender": {
    object (GenderDimension)
  },
  "householdIncome": {
    object (HouseholdIncomeDimension)
  },
  "parentalStatus": {
    object (ParentalStatusDimension)
  },
  "audienceSegments": {
    object (AudienceSegmentDimension)
  }
  // End of list of possible types for union field dimension.
}
Campi
Campo di unione dimension. Dimensione che specifica gli utenti che appartengono al segmento di pubblico. dimension può essere solo uno dei seguenti:
age

object (AgeDimension)

Dimensione che specifica gli utenti in base all'età.
gender

object (GenderDimension)

Dimensione che specifica gli utenti in base al genere.
householdIncome

object (HouseholdIncomeDimension)

Dimensione che specifica gli utenti in base al reddito del nucleo familiare.
parentalStatus

object (ParentalStatusDimension)

Dimensione che specifica gli utenti in base al loro stato parentale.
audienceSegments

object (AudienceSegmentDimension)

Dimensione che specifica gli utenti in base alla loro appartenenza ad altri segmenti di pubblico.

AgeDimension

Dimensione che specifica gli utenti in base all'età.

Rappresentazione JSON 
{
  "ageRanges": [
    {
      object (AgeSegment)
    }
  ],
  "includeUndetermined": boolean
}
Campi
ageRanges[]

object (AgeSegment)

Fascia di età contigua da includere nella dimensione.
includeUndetermined

boolean

Includi gli utenti la cui età non è determinata.

AgeSegment

Fascia d'età contigua.

Rappresentazione JSON 
{
  "minAge": integer,
  "maxAge": integer
}
Campi
minAge

integer

Età minima da includere. È necessario specificare un'età minima che deve avere almeno 18 anni. I valori consentiti sono 18, 25, 35, 45, 55 e 65.
maxAge

integer

Età massima da includere. Non è necessario specificare un'età massima. Se specificato, maxAge deve essere maggiore di minAge e i valori consentiti sono 24, 34, 44, 54 e 64.

GenderDimension

Dimensione che specifica gli utenti in base al genere.

Rappresentazione JSON 
{
  "genders": [
    enum (GenderType)
  ],
  "includeUndetermined": boolean
}
Campi
genders[]

enum (GenderType)

Segmenti demografici inclusi di genere.
includeUndetermined

boolean

Includi gli utenti il cui genere non è determinato.

HouseholdIncomeDimension

Dimensione che specifica gli utenti in base al reddito del nucleo familiare.

Rappresentazione JSON 
{
  "incomeRanges": [
    enum (IncomeRangeType)
  ],
  "includeUndetermined": boolean
}
Campi
incomeRanges[]

enum (IncomeRangeType)

Include segmenti demografici relativi al reddito del nucleo familiare.
includeUndetermined

boolean

Includi gli utenti il cui reddito del nucleo familiare non è determinato.

ParentalStatusDimension

Dimensione che specifica gli utenti in base al loro stato parentale.

Rappresentazione JSON 
{
  "parentalStatuses": [
    enum (ParentalStatusType)
  ],
  "includeUndetermined": boolean
}
Campi
parentalStatuses[]

enum (ParentalStatusType)

Segmenti demografici inclusi relativi allo stato parentale.
includeUndetermined

boolean

Includere gli utenti il cui stato parentale non è determinato.

AudienceSegmentDimension

Dimensione che specifica gli utenti in base alla loro appartenenza ad altri segmenti di pubblico.

Rappresentazione JSON 
{
  "segments": [
    {
      object (AudienceSegment)
    }
  ]
}
Campi
segments[]

object (AudienceSegment)

Segmenti di pubblico inclusi. Gli utenti sono inclusi se appartengono ad almeno un segmento.

AudienceSegment

Segmento di pubblico positivo.

Rappresentazione JSON 
{

  // Union field segment can be only one of the following:
  "userList": {
    object (UserListSegment)
  },
  "userInterest": {
    object (UserInterestSegment)
  },
  "lifeEvent": {
    object (LifeEventSegment)
  },
  "detailedDemographic": {
    object (DetailedDemographicSegment)
  },
  "customAudience": {
    object (CustomAudienceSegment)
  }
  // End of list of possible types for union field segment.
}
Campi
Campo di unione segment. Segmento positivo. segment può essere solo uno dei seguenti:
userList

object (UserListSegment)

Segmento elenco utenti.
userInterest

object (UserInterestSegment)

Segmento di affinità o in-market.
lifeEvent

object (LifeEventSegment)

Segmento di pubblico di eventi dal vivo.
detailedDemographic

object (DetailedDemographicSegment)

Segmento demografico dettagliato.
customAudience

object (CustomAudienceSegment)

Segmento di pubblico personalizzato.

UserListSegment

Segmento elenco utenti. Il ritiro dei segmenti di pubblico simili inizierà a maggio 2023. Per altre opzioni, consulta la pagina https://ads-developers.googleblog.com/2022/11/announcing-deprecation-and-sunset-of.html.

Rappresentazione JSON 
{
  "userList": string
}
Campi
userList

string

La risorsa dell'elenco utenti.

UserInterestSegment

Segmento di interesse dell'utente.

Rappresentazione JSON 
{
  "userInterestCategory": string
}
Campi
userInterestCategory

string

La risorsa sugli interessi dell'utente.

LifeEventSegment

Segmento di eventi dal vivo.

Rappresentazione JSON 
{
  "lifeEvent": string
}
Campi
lifeEvent

string

La risorsa dell'evento importante.

DetailedDemographicSegment

Segmento demografico dettagliato.

Rappresentazione JSON 
{
  "detailedDemographic": string
}
Campi
detailedDemographic

string

La risorsa demografica dettagliata.

CustomAudienceSegment

Segmento di pubblico personalizzato.

Rappresentazione JSON 
{
  "customAudience": string
}
Campi
customAudience

string

La risorsa del segmento di pubblico personalizzato.

AudienceExclusionDimension

Dimensione esclusa che specifica gli utenti da escludere dal segmento di pubblico.

Rappresentazione JSON 
{
  "exclusions": [
    {
      object (ExclusionSegment)
    }
  ]
}
Campi
exclusions[]

object (ExclusionSegment)

Segmento di pubblico da escludere.

ExclusionSegment

Un segmento di pubblico da escludere da un segmento di pubblico.

Rappresentazione JSON 
{

  // Union field segment can be only one of the following:
  "userList": {
    object (UserListSegment)
  }
  // End of list of possible types for union field segment.
}
Campi
Campo di unione segment. Segmento da escludere. segment può essere solo uno dei seguenti:
userList

object (UserListSegment)

Segmento elenco utenti da escludere.

AudienceScope

Enum contenente possibili valori dell'ambito del pubblico.

Enum
UNSPECIFIED L'ambito non è stato specificato.
UNKNOWN Il valore ricevuto non è noto in questa versione.
CUSTOMER L'ambito del segmento di pubblico è a livello di cliente.
ASSET_GROUP L'ambito del segmento di pubblico è un determinato gruppo di asset.