Method: customers.generateInsightsFinderReport

Es wird ein gespeicherter Bericht erstellt, 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/v16/customers/{customerId}:generateInsightsFinderReport

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameters
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, in der Regel alle Personen in einer Region.
specificAudience

object (BasicInsightsAudience)

Erforderlich. Die spezifische Zielgruppe, die an diesem Bericht interessiert ist. Die Statistiken basieren auf Attributen, die in dieser Zielgruppe häufiger vorkommen als in der Baseline-Zielgruppe des Berichts.
customerInsightsGroup

string

Der Name des Kunden, für den Sie in der Planung sind. 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, über die ein Deeplink für die Insights Finder-Benutzeroberfläche bereitgestellt wird. Die Berichtseingaben werden dabei gemäß 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

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)

Attribute für den geografischen Standort von Unterländern. Falls vorhanden, muss jedes dieser Elemente in einem der Länder in dieser Zielgruppe enthalten sein.
gender

object (GenderInfo)

Geschlecht der Zielgruppe Wird keine Angabe gemacht, 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, durch die diese Zielgruppe definiert wird. Zielgruppen mit gemeinsamen Interessen und kaufbereite Zielgruppen werden unterstützt.
topics[]

object (AudienceInsightsTopic)

Themen, dargestellt durch Knowledge Graph-Elemente 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 Entitäts- oder Kategorieattribut. Für topic ist nur einer der folgenden Werte zulässig:
entity

object (AudienceInsightsEntity)

Eine Knowledge Graph-Entität
category

object (AudienceInsightsCategory)

Eine Produkt- und Dienstleistungskategorie