- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- BasicInsightsAudience
- AudienceInsightsTopic
- Prova!
Crea un report salvato che può essere visualizzato nello strumento Insights Finder.
Elenco degli errori generati: AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError
Richiesta HTTP
POST https://googleads.googleapis.com/v16/customers/{customerId}:generateInsightsFinderReport
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 |
---|
{ "baselineAudience": { object ( |
Campi | |
---|---|
baselineAudience |
obbligatorio. Un pubblico di riferimento per questo report, in genere composto da tutti gli utenti di una regione. |
specificAudience |
obbligatorio. Il segmento di pubblico di interesse specifico per questo report. Le informazioni del report si baseranno sugli attributi più prevalenti in questo segmento di pubblico rispetto al pubblico di riferimento del report. |
customerInsightsGroup |
Il nome del cliente per il quale stai eseguendo la pianificazione. Questo è un valore definito dall'utente. |
Corpo della risposta
Il messaggio di risposta per AudienceInsightsService.GenerateInsightsFinderReport
, contenente l'URL condivisibile per il report.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "savedReportUrl": string } |
Campi | |
---|---|
savedReportUrl |
Un URL HTTPS che fornisce un link diretto nell'interfaccia utente di Insights Finder con gli input del report compilati in base alla richiesta. |
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.
BasicInsightsAudience
Una descrizione di un segmento di pubblico utilizzato per richiedere approfondimenti.
Rappresentazione JSON |
---|
{ "countryLocation": [ { object ( |
Campi | |
---|---|
countryLocation[] |
obbligatorio. I paesi per questo pubblico. |
subCountryLocations[] |
Attributi della posizione geografica del paese secondario. Se presenti, ognuno di questi deve essere contenuto in uno dei paesi inclusi in questo segmento di pubblico. |
gender |
Genere del pubblico. Se non è presente, il pubblico non applica limitazioni in base al genere. |
ageRanges[] |
Le fasce d'età del pubblico. Se non è presente, il segmento di pubblico rappresenta tutte le persone di età superiore ai 18 anni che soddisfano gli altri attributi. |
userInterests[] |
Interessi degli utenti che definiscono questo segmento di pubblico. I segmenti di pubblico di affinità e in-market sono supportati. |
topics[] |
Argomenti, rappresentati da entità Knowledge Graph e/o categorie di prodotti e servizi, a cui questo segmento di pubblico è interessato. |
AudienceInsightsTopic
Un'entità o categoria che rappresenta un argomento che definisce un segmento di pubblico.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo di unione topic . Un attributo di entità o categoria. topic può essere solo uno dei seguenti: |
|
entity |
Un'entità Knowledge Graph |
category |
Una categoria di prodotti e servizi |