Method: accountTypes.accounts.insights.retrieve

Pobiera dane analityczne dotyczące marketingu dla danej listy użytkowników.

Ta funkcja jest dostępna tylko dla partnerów danych.

Nagłówki autoryzacji:

Ta metoda obsługuje te opcjonalne nagłówki, które określają, jak interfejs API autoryzuje dostęp do żądania:

  • login-account: (Opcjonalnie) Nazwa zasobu konta, na którym konto Google powiązane z danymi logowania jest użytkownikiem. Jeśli nie jest ustawiony, domyślnie jest to konto, z którego wysłano żądanie. Format: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (Opcjonalnie) Nazwa zasobu konta z utworzonym połączeniem z usługą login-account. Format: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}

Żądanie HTTP

POST https://datamanager.googleapis.com/v1/{parent=accountTypes/*/accounts/*}/insights:retrieve

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Wymagane. Konto nadrzędne, do którego należy lista użytkowników. Format: accountTypes/{accountType}/accounts/{account}

Treść żądania

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

Zapis JSON 
{
  "baseline": {
    object (Baseline)
  },
  "userListId": string
}
Pola
baseline

object (Baseline)

Wymagane. Wartość odniesienia dla żądanych statystyk.
userListId

string

Wymagane. Identyfikator listy użytkowników, dla której są wymagane statystyki.

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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "baselineLocation": {
    object (Location)
  },
  "locationAutoDetectionEnabled": boolean
  // End of mutually exclusive fields.
}
Pola
Lokalizacja bazowa, z którą porównywane są statystyki. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
baselineLocation

object (Location)

Lokalizacja odniesienia żądania. Lokalizacja odniesienia 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.
Koniec pól wykluczających się nawzajem.

Lokalizacja

Lokalizacja odniesienia żądania. Lokalizacja bazowa 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.

Ta funkcja jest dostępna tylko dla partnerów danych.

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 zbioru 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 grupa odbiorców wykazuje 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 grup demograficznych,

Wartości w polu enum
AGE_RANGE_UNSPECIFIED Nie określono.
AGE_RANGE_UNKNOWN Brak informacji.
AGE_RANGE_18_24 w wieku od 18 do 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 Damskie.