Audience

Il pubblico è un'opzione di targeting efficace che ti consente di incrociare diversi attributi di segmenti, 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),
  "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 un ambito di ASSET_GROUP per l'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 di un segmento di pubblico con ambito ASSET_GROUP all'ambito CUSTOMER, questo campo verrà cancellato automaticamente.
name

string

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 una lunghezza massima di 255. Obbligatorio quando l'ambito non è impostato o è impostato su CUSTOMER. Impossibile impostare o aggiornare quando l'ambito è ASSET_GROUP.

AudienceStatus

Enum contenente i 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 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 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 d'età contigua da includere nella dimensione.
includeUndetermined

boolean

Includi gli utenti di cui non è stata determinata l'età.

AgeSegment

Fascia d'età contigua.

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

integer

Età minima da includere. È necessario specificare un'età minima e 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 di genere inclusi.
includeUndetermined

boolean

Include gli utenti di cui non è stato determinato il genere.

HouseholdIncomeDimension

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

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

enum (IncomeRangeType)

Segmenti demografici relativi al reddito del nucleo familiare inclusi.
includeUndetermined

boolean

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

ParentalStatusDimension

Dimensione che specifica gli utenti in base allo stato parentale.

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

enum (ParentalStatusType)

Segmenti demografici inclusi nello stato parentale.
includeUndetermined

boolean

Sono inclusi 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 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 Eventi dal vivo.
detailedDemographic

object (DetailedDemographicSegment)

Segmento demografico dettagliato.
customAudience

object (CustomAudienceSegment)

Segmento di pubblico personalizzato.

UserListSegment

Segmento elenco utenti.

Rappresentazione JSON 
{
  "userList": string
}
Campi
userList

string

La risorsa elenco utenti.

UserInterestSegment

Segmento di interesse degli utenti.

Rappresentazione JSON 
{
  "userInterestCategory": string
}
Campi
userInterestCategory

string

La risorsa di interesse utente.

LifeEventSegment

Segmento Evento 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 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 di ambito del segmento di 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 Il segmento di pubblico è limitato all'ambito di un gruppo di asset specifico.