- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- TargetingSuggestionMetrics
- Prova!
Restituisce una raccolta di informazioni sul targeting (ad es. segmenti di pubblico disponibili per il targeting) pertinenti per il segmento di pubblico richiesto.
Elenco di errori generati: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError
Richiesta HTTP
POST https://googleads.googleapis.com/v16/customers/{customerId}:generateSuggestedTargetingInsights
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 |
Campo facoltativo. Il pubblico di riferimento. Il valore predefinito, se non specificato, riguarda tutte le persone che si trovano nello stesso paese del segmento di pubblico di interesse. |
dataMonth |
Campo facoltativo. 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. |
customerInsightsGroup |
Campo facoltativo. 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.GenerateSuggestedTargetingInsights
.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"suggestions": [
{
object ( |
Campi | |
---|---|
suggestions[] |
Approfondimenti suggeriti per i segmenti di pubblico disponibili per il targeting. |
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.
TargetingSuggestionMetrics
Un segmento di pubblico disponibile per il targeting consigliato pertinente per il segmento di pubblico richiesto.
Rappresentazione JSON |
---|
{ "locations": [ { object ( |
Campi | |
---|---|
locations[] |
Targeting per località suggerito. Questi attributi hanno tutti la dimensione GEO_TARGET_COUNTRY o SUB_COUNTRY_LOCATION |
ageRanges[] |
Targeting per età suggerito; potrebbe essere vuoto e non indica alcun targeting per età. |
gender |
Targeting per genere suggerito. Se presente, questo attributo ha la dimensione GENDER. |
userInterests[] |
Segmenti di pubblico suggeriti da scegliere come target. Questi attributi hanno tutti una dimensione AFFINITY_USER_INTEREST o IN_MARKET_USER_INTEREST |
coverage |
La frazione (da 0 a 1 inclusi) del segmento di pubblico richiesto che può essere raggiunto utilizzando il targeting suggerito. |
index |
Il rapporto tra copertura e copertura del pubblico di riferimento oppure zero se questo rapporto non è definito o non è significativo. |
potentialYoutubeReach |
Il numero approssimativo di persone che possono essere raggiunte su YouTube utilizzando questo targeting. |