- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- InsightsAudience
- InsightsAudienceAttributeGroup
- 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 degli errori generati: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError
Richiesta HTTP
POST https://googleads.googleapis.com/v14/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 gli approfondimenti relativi agli ultimi 30 giorni. |
dimensions[] |
Obbligatorio. Le dimensioni del segmento di pubblico per le quali devono essere restituite informazioni sulla composizione. |
customerInsightsGroup |
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 ( |
Campi | |
---|---|
sections[] |
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.
InsightsAudience
Un insieme di utenti, definiti da varie caratteristiche, per i quali è possibile richiedere approfondimenti in AudienceInsightsService.
Rappresentazione JSON |
---|
{ "countryLocations": [ { object ( |
Campi | |
---|---|
countryLocations[] |
Obbligatorio. I paesi a cui è indirizzato il pubblico. |
subCountryLocations[] |
Attributi della posizione geografica del paese secondario. Se presenti, ognuno di questi deve essere incluso in uno dei paesi in questo pubblico. Se non è presente, il pubblico è geografico solo per il paeseLocations e non oltre. |
gender |
Genere per il pubblico. Se non è presente, il pubblico non prevede limitazioni in base al genere. |
ageRanges[] |
Le fasce d'età del pubblico. Se non è presente, il segmento di pubblico rappresenta tutte le persone maggiori di 18 anni che corrispondono agli altri attributi. |
parentalStatus |
Stato parentale del pubblico. Se non è presente, il pubblico non è soggetto a limitazioni in base allo stato parentale. |
incomeRanges[] |
Intervalli percentili del reddito del nucleo familiare per il segmento di pubblico. Se non è presente, il pubblico non presenta limitazioni in base alla fascia di reddito del nucleo familiare. |
dynamicLineups[] |
Selezioni dinamiche che rappresentano i contenuti di YouTube visualizzati dal pubblico. |
topicAudienceCombinations[] |
Una combinazione di attributi entità, categoria e interesse dell'utente che definiscono il segmento di pubblico. La combinazione ha una struttura logica AND di OR: gli attributi all'interno di ogni InsightsAudienceAttributeGroup sono combinati con OR, mentre le combinazioni stesse vengono combinate con AND. Ad esempio, l'espressione (Entità OR Affinità) AND (In-Market OR Categoria) può essere formata utilizzando due InsightsAudienceAttributeGroups con due attributi ciascuno. |
InsightsAudienceAttributeGroup
Un elenco di AudienceInsightsAttributes.
Rappresentazione JSON |
---|
{
"attributes": [
{
object ( |
Campi | |
---|---|
attributes[] |
Obbligatorio. Una raccolta di attributi dei segmenti di pubblico da combinare con l'operatore logico OR. Gli attributi non devono necessariamente avere la stessa dimensione. In questo contesto sono supportati solo le entità Knowledge Graph, le categorie di prodotti e servizi e i segmenti di pubblico di affinità e in-market. |
AudienceCompositionSection
Una raccolta di attributi correlati dello stesso tipo in un report Informazioni sulla composizione del pubblico.
Rappresentazione JSON |
---|
{ "dimension": enum ( |
Campi | |
---|---|
dimension |
Il tipo degli attributi in questa sezione. |
topAttributes[] |
I segmenti più pertinenti per questo 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. Viene compilata solo se la dimensione è YOUTUBE_CHANNEL. |
AudienceCompositionAttribute
Un attributo del pubblico con metadati e metriche.
Rappresentazione JSON |
---|
{ "attributeMetadata": { object ( |
Campi | |
---|---|
attributeMetadata |
L'attributo con i 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 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 che corrisponde all'attributo. |
audienceShare |
La frazione (da 0 a 1 inclusi) del segmento di pubblico specifico che corrisponde all'attributo. |
index |
Il rapporto tra AudienceShare e baseAudienceShare di riferimento oppure zero se questo rapporto non è definito o non è significativo. |
score |
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 ( |
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 viene impostato. |
attributes[] |
I singoli attributi che compongono questo cluster, con metadati e metriche. |