- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- AudienceCompositionSection
- AudienceCompositionAttribute
- AudienceCompositionMetrics
- AudienceCompositionAttributeCluster
- Prova!
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 di errori generati: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError
Richiesta HTTP
POST https://googleads.googleapis.com/v16/customers/{customerId}:generateAudienceCompositionInsights
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
customerId |
obbligatorio. L'ID del cliente. |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "audience": { object ( |
Campi | |
---|---|
audience |
obbligatorio. Il segmento di pubblico di interesse per il quale vengono richiesti gli approfondimenti. |
baselineAudience |
Il pubblico di riferimento con cui viene confrontato il pubblico di interesse. |
dataMonth |
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 approfondimenti per i dati degli ultimi 30 giorni. |
dimensions[] |
obbligatorio. Le dimensioni del segmento di pubblico per cui devono essere restituiti informazioni sulla composizione. |
customerInsightsGroup |
Il nome del cliente per il quale stai eseguendo 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 ( |
Campi | |
---|---|
sections[] |
I contenuti del report sugli approfondimenti, organizzati in sezioni. Ogni sezione è associata a uno dei valori AudienceInsightsDimensione della richiesta. Potrebbe essere presente più di una sezione per dimensione. |
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/adwords
Per ulteriori informazioni, consulta la pagina Panoramica di OAuth 2.0.
AudienceCompositionSection
Una raccolta di attributi correlati dello stesso tipo in un report sulle informazioni sulla composizione del pubblico.
Rappresentazione JSON |
---|
{ "dimension": enum ( |
Campi | |
---|---|
dimension |
Il tipo di attributi in questa sezione. |
topAttributes[] |
I segmenti più pertinenti per questo segmento di pubblico. Se la dimensione è GENDER, AGE_RANGE o PARENTAL_STATUS, questo elenco di attributi è esaustivo. |
clusteredAttributes[] |
Attributi aggiuntivi per questo segmento di pubblico, raggruppati in cluster. Compilato solo se la dimensione è YOUTUBE_CHANNEL. |
AudienceCompositionAttribute
Un attributo del pubblico con metadati e metriche.
Rappresentazione JSON |
---|
{ "attributeMetadata": { object ( |
Campi | |
---|---|
attributeMetadata |
L'attributo insieme ai relativi metadati. |
metrics |
Condividi e indicizza le metriche per l'attributo. |
AudienceCompositionMetrics
Le metriche di quota e indice associate a un attributo in un report con informazioni sulla composizione del pubblico.
Rappresentazione JSON |
---|
{ "baselineAudienceShare": number, "audienceShare": number, "index": number, "score": number } |
Campi | |
---|---|
baselineAudienceShare |
La frazione (da 0 a 1 inclusi) del pubblico di riferimento corrispondente all'attributo. |
audienceShare |
La frazione (da 0 a 1 inclusi) del segmento di pubblico specifico corrispondente all'attributo. |
index |
Il rapporto tra AudienceShare e baselineAudienceShare oppure zero se questo rapporto non è definito o non è significativo. |
score |
Un punteggio di pertinenza compreso tra 0 e 1 inclusi. |
AudienceCompositionAttributeCluster
Una raccolta di attributi correlati, con metadati e metriche, in un report con informazioni sulla composizione del pubblico.
Rappresentazione JSON |
---|
{ "clusterDisplayName": string, "clusterMetrics": { object ( |
Campi | |
---|---|
clusterDisplayName |
Il nome di questo cluster di attributi |
clusterMetrics |
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 è impostato. |
attributes[] |
I singoli attributi che compongono il cluster, con metadati e metriche. |