Method: insights.retrieveInsights

Pobiera statystyki danych marketingowych dotyczące danego miejsca docelowego.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "destination": {
    object (Destination)
  },
  "baseline": {
    object (Baseline)
  }
}
Pola
destination

object (Destination)

Wymagane. Miejsce docelowe, dla którego chcesz uzyskać statystyki.
baseline

object (Baseline)

Wymagane. Wartość bazowa dla żądanych statystyk.

Treść odpowiedzi

Komunikat odpowiedzi interfejsu DM API MarketingDataInsightsService.RetrieveInsights

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "marketingDataInsights": [
    {
      object (MarketingDataInsight)
    }
  ]
}
Pola
marketingDataInsights[]

object (MarketingDataInsight)

Zawiera statystyki dotyczące danych marketingowych.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Punkt odniesienia

Kryteria bazowe, z którymi porównywane są statystyki.

Zapis JSON 
{

  // 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.
}
Pola
Pole zbiorcze baseline. Lokalizacja bazowa, z którą porównywane są statystyki. baseline może mieć tylko jedną z tych wartości:
baselineLocation

object (Location)

Lokalizacja bazowa żądania. Lokalizacja bazowa to lista regionów połączonych operatorem LUB.
locationAutoDetectionEnabled

boolean

Jeśli ustawisz wartość „true”, usługa spróbuje automatycznie wykryć lokalizację bazową dla statystyk.

Lokalizacja

Lokalizacja bazowa żądania. Lokalizacja podstawowa znajduje się na liście OR kodów regionów w formacie ISO 3166-1 alfa-2 dla żądanych regionów.

Zapis JSON 
{
  "regionCodes": [
    string
  ]
}
Pola
regionCodes[]

string

Lista kodów regionów w formacie ISO 3166-1 alfa-2.

MarketingDataInsight

Statystyki dotyczące danych marketingowych.

Zapis JSON 
{
  "dimension": enum (AudienceInsightsDimension),
  "attributes": [
    {
      object (MarketingDataInsightsAttribute)
    }
  ]
}
Pola
dimension

enum (AudienceInsightsDimension)

Wymiar, do którego należy statystyka.
attributes[]

object (MarketingDataInsightsAttribute)

Statystyki dotyczące wartości danego wymiaru.

AudienceInsightsDimension

Wymiary, których można używać do generowania statystyk.

Wartości w polu enum
AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED Nie określono.
AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN W tej wersji wartość jest nieznana.
AFFINITY_USER_INTEREST Zainteresowanie użytkownika o podobnych zainteresowaniach.
IN_MARKET_USER_INTEREST Zainteresowanie użytkownika na rynku.
AGE_RANGE przedział wiekowy,
GENDER Płeć.

MarketingDataInsightsAttribute

Statystyki dotyczące kolekcji powiązanych atrybutów tego samego wymiaru.

Zapis JSON 
{
  "userInterestId": string,
  "lift": number,
  "ageRange": enum (AgeRange),
  "gender": enum (Gender)
}
Pola
userInterestId

string (int64 format)

Identyfikator zainteresowania użytkownika.
lift

number

Miara wzrostu, jaki odbiorcy uzyskali w przypadku wartości atrybutu w porównaniu z wartością bazową. Zakres [0–1].
ageRange

enum (AgeRange)

Przedział wiekowy odbiorców, dla których podany jest wzrost.
gender

enum (Gender)

Płeć odbiorców, dla których podano wzrost.

ZakresWieku

Przedziały wiekowe danych demograficznych

Wartości w polu enum
AGE_RANGE_UNSPECIFIED Nie określono.
AGE_RANGE_UNKNOWN Brak informacji.
AGE_RANGE_18_24 w wieku 18–24 lat,
AGE_RANGE_25_34 w wieku 25–34 lat,
AGE_RANGE_35_44 w wieku 35–44 lat,
AGE_RANGE_45_54 w wieku 45–54 lat,
AGE_RANGE_55_64 55–64 lata.
AGE_RANGE_65_UP 65 lat i więcej.

Płeć

Rodzaj płci demograficznej (np. kobieta).

Wartości w polu enum
GENDER_UNSPECIFIED Nie określono.
GENDER_UNKNOWN Brak informacji.
GENDER_MALE Mężczyzna.
GENDER_FEMALE Kobieta.