Audience

Pubblico è un'opzione di targeting efficace che ti consente di incrociare attributi di segmenti diversi, come 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),
  "name": string,
  "description": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "exclusionDimension": {
    object (AudienceExclusionDimension)
  }
}
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 è attivato o rimosso.
name

string

Obbligatorio. Il nome del segmento di pubblico. Deve essere univoco per tutti i segmenti di pubblico. Deve avere una lunghezza minima di 1 e una massima di 255.
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.

AudienceStatus

Enum contenente possibili tipi di stato 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 allo 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 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 pari ad 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)

Sono inclusi i segmenti demografici 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)

Sono inclusi i 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 allo stato parentale.

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

enum (ParentalStatusType)

Sono inclusi i segmenti demografici relativi allo stato parentale.
includeUndetermined

boolean

Includi 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 vengono 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 conoscere 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 dei dati demografici dettagliati.

CustomAudienceSegment

Segmento di pubblico personalizzato.

Rappresentazione JSON 
{
  "customAudience": string
}
Campi
customAudience

string

La risorsa di pubblico personalizzato.

AudienceExclusionDimension

Una 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 di elenco utenti da escludere.