Method: customers.generateInsightsFinderReport

Erstellt einen gespeicherten Bericht, der im Insights Finder-Tool aufgerufen werden kann.

Liste der ausgelösten Fehler: AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

HTTP-Anfrage

POST https://googleads.googleapis.com/v14/customers/{customerId}:generateInsightsFinderReport

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customerId

string

Erforderlich. Die ID des Kunden.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "baselineAudience": {
    object (BasicInsightsAudience)
  },
  "specificAudience": {
    object (BasicInsightsAudience)
  },
  "customerInsightsGroup": string
}
Felder
baselineAudience

object (BasicInsightsAudience)

Erforderlich. Eine Baseline-Zielgruppe für diesen Bericht, normalerweise alle Personen in einer Region.
specificAudience

object (BasicInsightsAudience)

Erforderlich. Die spezifische Zielgruppe, die für diesen Bericht interessiert ist. Die Statistiken im Bericht basieren auf Attributen, die in dieser Zielgruppe häufiger vorkommen als in der Baseline-Zielgruppe des Berichts.
customerInsightsGroup

string

Der Name der Kundin oder des Kunden, für den/die geplant werden soll. Dies ist ein benutzerdefinierter Wert.

Antworttext

Die Antwortnachricht für AudienceInsightsService.GenerateInsightsFinderReport, die die teilbare URL für den Bericht enthält.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "savedReportUrl": string
}
Felder
savedReportUrl

string

Eine HTTPS-URL, die einen Deeplink zur Insights Finder-Benutzeroberfläche bereitstellt. Die Berichtseingaben werden entsprechend der Anfrage ausgefüllt.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/adwords

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

BasicInsightsAudience

Eine Beschreibung einer Zielgruppe, die zum Anfordern von Statistiken verwendet wird.

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

object (LocationInfo)

Erforderlich. Die Länder für diese Zielgruppe.
subCountryLocations[]

object (LocationInfo)

Geografischer Standortattribute für das Unterland. Sofern vorhanden, muss jedes dieser Elemente in einem der Länder der Zielgruppe enthalten sein.
gender

object (GenderInfo)

Geschlecht der Zielgruppe. Ist dies nicht der Fall, wird die Zielgruppe nicht nach Geschlecht eingeschränkt.
ageRanges[]

object (AgeRangeInfo)

Altersgruppen für die Zielgruppe. Falls nicht, umfasst die Zielgruppe alle Personen über 18 Jahren, die den anderen Attributen entsprechen.
userInterests[]

object (UserInterestInfo)

Nutzerinteressen, die diese Zielgruppe definieren. Zielgruppen mit gemeinsamen Interessen und kaufbereite Zielgruppen werden unterstützt.
topics[]

object (AudienceInsightsTopic)

Themen, dargestellt durch Knowledge Graph-Objekte und/oder Produkt- und Dienstleistungskategorien, für die sich diese Zielgruppe interessiert.

AudienceInsightsTopic

Eine Entität oder Kategorie, die ein Thema darstellt und eine Zielgruppe definiert.

JSON-Darstellung 
{

  // 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.
}
Felder
Union-Feld topic. Ein Element- oder Kategorieattribut. Für topic ist nur einer der folgenden Werte zulässig:
entity

object (AudienceInsightsEntity)

Ein Knowledge Graph-Objekt
category

object (AudienceInsightsCategory)

Eine Produkt- und Dienstleistungskategorie