Method: customers.generateInsightsFinderReport

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/v14/customers/{customerId}:generateInsightsFinderReport

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 
{
  "baselineAudience": {
    object (BasicInsightsAudience)
  },
  "specificAudience": {
    object (BasicInsightsAudience)
  },
  "customerInsightsGroup": string
}
Campi
baselineAudience

object (BasicInsightsAudience)

Obbligatorio. Un pubblico di riferimento per questo report, in genere composto da tutti gli utenti di una regione.
specificAudience

object (BasicInsightsAudience)

Obbligatorio. Il segmento di pubblico specifico di interesse per questo report. Le informazioni contenute nel report si baseranno sugli attributi più prevalenti in questo pubblico rispetto al pubblico di riferimento del report.
customerInsightsGroup

string

Il nome del cliente per cui è stata pianificata 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

string

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

BasicInsightsAudience

Una descrizione di un segmento di pubblico utilizzato per richiedere approfondimenti.

Rappresentazione JSON 
{
  "countryLocation": [
    {
      object (LocationInfo)
    }
  ],
  "subCountryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "userInterests": [
    {
      object (UserInterestInfo)
    }
  ],
  "topics": [
    {
      object (AudienceInsightsTopic)
    }
  ]
}
Campi
countryLocation[]

object (LocationInfo)

Obbligatorio. I paesi di questo segmento di pubblico.
subCountryLocations[]

object (LocationInfo)

Attributi della posizione geografica del paese secondario. Se presenti, ognuno di questi deve essere incluso in uno dei paesi in questo pubblico.
gender

object (GenderInfo)

Genere per il pubblico. Se non è presente, il pubblico non prevede limitazioni in base al genere.
ageRanges[]

object (AgeRangeInfo)

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.
userInterests[]

object (UserInterestInfo)

Interessi degli utenti che definiscono questo segmento di pubblico. I segmenti di pubblico di affinità e in-market sono supportati.
topics[]

object (AudienceInsightsTopic)

Argomenti, rappresentati da entità Knowledge Graph e/o categorie di prodotti e servizi, a cui questo segmento di pubblico è interessato.

AudienceInsightsTopic

Un'entità o una categoria che rappresenta un argomento e definisce un segmento di pubblico.

Rappresentazione JSON 
{

  // Union field topic can be only one of the following:
  "entity": {
    object (AudienceInsightsEntity)
  },
  "category": {
    object (AudienceInsightsCategory)
  }
  // End of list of possible types for union field topic.
}
Campi
Campo di unione topic. Un attributo di entità o categoria. topic può essere solo uno dei seguenti:
entity

object (AudienceInsightsEntity)

Un'entità Knowledge Graph
category

object (AudienceInsightsCategory)

Una categoria di prodotti e servizi