Method: customers.generateSuggestedTargetingInsights

Restituisce una raccolta di informazioni sul targeting (ad es. segmenti di pubblico disponibili per il targeting) pertinenti al segmento di pubblico richiesto.

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

Richiesta HTTP

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

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,
  "customerInsightsGroup": string
}
Campi
audience

object (InsightsAudience)

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

object (InsightsAudience)

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

string

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 gli approfondimenti relativi agli ultimi 30 giorni.
customerInsightsGroup

string

Campo facoltativo. Il nome del cliente per cui è stata pianificata 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 (TargetingSuggestionMetrics)
    }
  ]
}
Campi
suggestions[]

object (TargetingSuggestionMetrics)

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 Panoramica di OAuth 2.0.

TargetingSuggestionMetrics

Un pubblico disponibile per il targeting consigliato pertinente per il segmento di pubblico richiesto.

Rappresentazione JSON 
{
  "locations": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "userInterests": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "coverage": number,
  "index": number,
  "potentialYoutubeReach": string
}
Campi
locations[]

object (AudienceInsightsAttributeMetadata)

Targeting per località suggerito. Questi attributi hanno tutti la dimensione GEO_TARGET_COUNTRY o SUB_COUNTRY_LOCATION
ageRanges[]

object (AgeRangeInfo)

Targeting per età suggerito; potrebbe essere vuoto per indicare che non è stato specificato il targeting per età.
gender

object (GenderInfo)

Targeting per genere suggerito. Se presente, questo attributo ha la dimensione GENDER.
userInterests[]

object (AudienceInsightsAttributeMetadata)

Segmenti di pubblico suggeriti da scegliere come target. Questi attributi hanno tutti la dimensione AFFINITY_USER_INTEREST o IN_MARKET_USER_INTEREST
coverage

number

La frazione (da 0 a 1 inclusi) del segmento di pubblico richiesto che può essere raggiunto utilizzando il targeting suggerito.
index

number

Il rapporto tra copertura e copertura del pubblico di riferimento oppure zero se questo rapporto non è definito o non è significativo.
potentialYoutubeReach

string (int64 format)

Il numero approssimativo stimato di persone che possono essere raggiunte su YouTube utilizzando questo targeting.