Method: customers.generateInsightsFinderReport

Es wird ein gespeicherter Bericht erstellt, der im Insights Finder aufgerufen werden kann.

Liste der ausgegebenen Fehler: AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

HTTP-Anfrage

POST https://googleads.googleapis.com/v17/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 von Interesse ist. Die Informationen im Bericht basieren auf Attributen, die in dieser Zielgruppe häufiger vorkommen als in der Baseline-Zielgruppe.
customerInsightsGroup

string

Der Name des Kunden, für den die Planung geplant ist. Dies ist ein benutzerdefinierter Wert.

Antworttext

Die Antwortnachricht für AudienceInsightsService.GenerateInsightsFinderReport mit der URL, die für den Bericht freigegeben werden kann.

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 zur Insights Finder-Benutzeroberfläche bereitgestellt wird. 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)

Geografische Standortattribute für Unterländer. Falls vorhanden, muss jedes dieser Elemente in einem der Länder in dieser Zielgruppe enthalten sein.
gender

object (GenderInfo)

Geschlecht der Zielgruppe. Fehlt diese Angabe, 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, an denen diese Zielgruppe interessiert ist.

AudienceInsightsTopic

Eine Entität oder Kategorie, die ein Thema darstellt, das 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)

Ein Knowledge Graph-Objekt
category

object (AudienceInsightsCategory)

Ein Produkt und Dienstleistungskategorie