Method: insights.retrieveInsights

Ruft Marketingdaten-Insights für ein bestimmtes Ziel ab.

HTTP-Anfrage

POST https://datamanager.googleapis.com/v1/insights:retrieveInsights

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "destination": {
    object (Destination)
  },
  "baseline": {
    object (Baseline)
  }
}
Felder
destination

object (Destination)

Erforderlich. Das Ziel, für das die Statistiken abgerufen werden sollen.
baseline

object (Baseline)

Erforderlich. Baseline für die angeforderten Statistiken.

Antworttext

Antwortnachricht für DM API MarketingDataInsightsService.RetrieveInsights

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

JSON-Darstellung 
{
  "marketingDataInsights": [
    {
      object (MarketingDataInsight)
    }
  ]
}
Felder
marketingDataInsights[]

object (MarketingDataInsight)

Enthält die Statistiken für die Marketingdaten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Referenz

Baseline-Kriterien, mit denen die Statistiken verglichen werden.

JSON-Darstellung 
{

  // Union field baseline can be only one of the following:
  "baselineLocation": {
    object (Location)
  },
  "locationAutoDetectionEnabled": boolean
  // End of list of possible types for union field baseline.
}
Felder
Union-Feld baseline. Referenzstandort, mit dem Statistiken verglichen werden. Für baseline ist nur einer der folgenden Werte zulässig:
baselineLocation

object (Location)

Der Referenzstandort der Anfrage. Der Referenzstandort ist eine ODER-Liste der angeforderten Regionen.
locationAutoDetectionEnabled

boolean

Wenn der Wert auf „true“ gesetzt ist, versucht der Dienst, den Baseline-Standort für Statistiken automatisch zu erkennen.

Standort

Der Referenzstandort der Anfrage. Der Ausgangsort befindet sich in der OR-Liste der ISO 3166-1-Alpha-2-Regionscodes der angeforderten Regionen.

JSON-Darstellung 
{
  "regionCodes": [
    string
  ]
}
Felder
regionCodes[]

string

Liste der ISO 3166-1-Alpha-2-Codes der Regionen.

MarketingDataInsight

Statistiken zu Marketingdaten.

JSON-Darstellung 
{
  "dimension": enum (AudienceInsightsDimension),
  "attributes": [
    {
      object (MarketingDataInsightsAttribute)
    }
  ]
}
Felder
dimension

enum (AudienceInsightsDimension)

Die Dimension, zu der die Statistik gehört.
attributes[]

object (MarketingDataInsightsAttribute)

Statistiken für Werte einer bestimmten Dimension.

AudienceInsightsDimension

Mögliche Dimensionen für die Generierung von Statistiken.

Enums
AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED Nicht angegeben.
AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN Der Wert ist in dieser Version unbekannt.
AFFINITY_USER_INTEREST Ein Affinity-UserInterest.
IN_MARKET_USER_INTEREST UserInterest für kaufbereite Nutzer.
AGE_RANGE Eine Altersgruppe.
GENDER Ein Geschlecht.

MarketingDataInsightsAttribute

Statistiken für eine Sammlung verwandter Attribute derselben Dimension.

JSON-Darstellung 
{
  "userInterestId": string,
  "lift": number,
  "ageRange": enum (AgeRange),
  "gender": enum (Gender)
}
Felder
userInterestId

string (int64 format)

Die ID des Nutzerinteresses.
lift

number

Maß für die Steigerung, die die Zielgruppe im Vergleich zur Baseline für den Attributwert erzielt. Bereich [0–1].
ageRange

enum (AgeRange)

Altersgruppe der Zielgruppe, für die die Steigerung angegeben wird.
gender

enum (Gender)

Geschlecht der Zielgruppe, für die die Steigerung angegeben wird.

Altersgruppe

Demografische Altersgruppen

Enums
AGE_RANGE_UNSPECIFIED Nicht angegeben.
AGE_RANGE_UNKNOWN Unbekannt
AGE_RANGE_18_24 Zwischen 18 und 24 Jahre alt
AGE_RANGE_25_34 Zwischen 25 und 34 Jahre alt
AGE_RANGE_35_44 Zwischen 35 und 44 Jahre alt.
AGE_RANGE_45_54 Zwischen 45 und 54 Jahre alt.
AGE_RANGE_55_64 Zwischen 55 und 64 Jahre alt.
AGE_RANGE_65_UP 65 Jahre und älter

Geschlecht

Die Art der demografischen Geschlechter (z. B. weiblich).

Enums
GENDER_UNSPECIFIED Nicht angegeben.
GENDER_UNKNOWN Unbekannt
GENDER_MALE Männlich
GENDER_FEMALE Weiblich.