Method: customers.generateAudienceCompositionInsights

Restituisce una raccolta di attributi rappresentati in un segmento di pubblico di interesse, con metriche che confrontano la quota di pubblico di ciascun attributo con la relativa quota di un pubblico di riferimento.

Elenco degli errori generati: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

Richiesta HTTP

POST https://googleads.googleapis.com/v15/customers/{customerId}:generateAudienceCompositionInsights

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customerId

string

Obbligatorio. L'ID del cliente.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "audience": {
    object (InsightsAudience)
  },
  "baselineAudience": {
    object (InsightsAudience)
  },
  "dataMonth": string,
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "customerInsightsGroup": string
}
Campi
audience

object (InsightsAudience)

Obbligatorio. Il segmento di pubblico di interesse per il quale vengono richiesti gli approfondimenti.
baselineAudience

object (InsightsAudience)

Il pubblico di riferimento con cui viene confrontato il pubblico di interesse.
dataMonth

string

L'intervallo di un mese di dati storici da utilizzare per gli approfondimenti, nel formato "aaaa-mm". Se il criterio non viene configurato, verranno restituiti gli approfondimenti relativi agli ultimi 30 giorni.
dimensions[]

enum (AudienceInsightsDimension)

Obbligatorio. Le dimensioni del segmento di pubblico per le quali devono essere restituite informazioni sulla composizione.
customerInsightsGroup

string

Il nome del cliente per cui è stata pianificata la pianificazione. Questo è un valore definito dall'utente.

Corpo della risposta

Messaggio di risposta per AudienceInsightsService.GenerateAudienceCompositionInsights.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "sections": [
    {
      object (AudienceCompositionSection)
    }
  ]
}
Campi
sections[]

object (AudienceCompositionSection)

I contenuti del report Approfondimenti, organizzati in sezioni. Ogni sezione è associata a uno dei valori AudienceInsightsDimension nella richiesta. Ogni dimensione può contenere più di una sezione.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/adwords

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

AudienceCompositionSection

Una raccolta di attributi correlati dello stesso tipo in un report Informazioni sulla composizione del pubblico.

Rappresentazione JSON 
{
  "dimension": enum (AudienceInsightsDimension),
  "topAttributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ],
  "clusteredAttributes": [
    {
      object (AudienceCompositionAttributeCluster)
    }
  ]
}
Campi
dimension

enum (AudienceInsightsDimension)

Il tipo degli attributi in questa sezione.
topAttributes[]

object (AudienceCompositionAttribute)

I segmenti più pertinenti per questo pubblico. Se la dimensione è GENDER, AGE_RANGE o PARENTAL_STATUS, questo elenco di attributi è esaustivo.
clusteredAttributes[]

object (AudienceCompositionAttributeCluster)

Attributi aggiuntivi per questo segmento di pubblico, raggruppati in cluster. Viene compilata solo se la dimensione è YOUTUBE_CHANNEL.

AudienceCompositionAttribute

Un attributo del pubblico con metadati e metriche.

Rappresentazione JSON 
{
  "attributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "metrics": {
    object (AudienceCompositionMetrics)
  }
}
Campi
attributeMetadata

object (AudienceInsightsAttributeMetadata)

L'attributo con i relativi metadati.
metrics

object (AudienceCompositionMetrics)

Condividi e indicizza le metriche per l'attributo.

AudienceCompositionMetrics

Le metriche di quota e indice associate a un attributo in un report Informazioni sulla composizione del pubblico.

Rappresentazione JSON 
{
  "baselineAudienceShare": number,
  "audienceShare": number,
  "index": number,
  "score": number
}
Campi
baselineAudienceShare

number

La frazione (da 0 a 1 inclusi) del pubblico di riferimento che corrisponde all'attributo.
audienceShare

number

La frazione (da 0 a 1 inclusi) del segmento di pubblico specifico che corrisponde all'attributo.
index

number

Il rapporto tra AudienceShare e baseAudienceShare di riferimento oppure zero se questo rapporto non è definito o non è significativo.
score

number

Un punteggio di pertinenza da 0 a 1 inclusi.

AudienceCompositionAttributeCluster

Una raccolta di attributi correlati, con metadati e metriche, in un report Informazioni sulla composizione del pubblico.

Rappresentazione JSON 
{
  "clusterDisplayName": string,
  "clusterMetrics": {
    object (AudienceCompositionMetrics)
  },
  "attributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ]
}
Campi
clusterDisplayName

string

Il nome di questo cluster di attributi
clusterMetrics

object (AudienceCompositionMetrics)

Se la dimensione associata a questo cluster è YOUTUBE_CHANNEL, clusterMetrics è una metrica associata al cluster nel suo complesso. Per le altre dimensioni, questo campo non viene impostato.
attributes[]

object (AudienceCompositionAttribute)

I singoli attributi che compongono questo cluster, con metadati e metriche.