Method: insights.retrieveInsights

Mengambil insight data pemasaran untuk tujuan tertentu.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "destination": {
    object (Destination)
  },
  "baseline": {
    object (Baseline)
  }
}
Kolom
destination

object (Destination)

Wajib. Tujuan untuk mengambil insight.
baseline

object (Baseline)

Wajib. Dasar untuk insight yang diminta.

Isi respons

Pesan respons untuk DM API MarketingDataInsightsService.RetrieveInsights

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "marketingDataInsights": [
    {
      object (MarketingDataInsight)
    }
  ]
}
Kolom
marketingDataInsights[]

object (MarketingDataInsight)

Berisi insight untuk data pemasaran.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Dasar pengukuran

Kriteria dasar yang digunakan untuk membandingkan insight.

Representasi 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.
}
Kolom
Kolom union baseline. Lokasi dasar yang menjadi pembanding insight. baseline hanya dapat berupa salah satu dari berikut:
baselineLocation

object (Location)

Lokasi dasar permintaan. Lokasi dasar adalah daftar OR dari wilayah yang diminta.
locationAutoDetectionEnabled

boolean

Jika disetel ke benar (true), layanan akan mencoba mendeteksi lokasi dasar untuk insight secara otomatis.

Lokasi

Lokasi dasar permintaan. Lokasi dasar berada di daftar OR kode wilayah ISO 3166-1 alpha-2 dari wilayah yang diminta.

Representasi JSON 
{
  "regionCodes": [
    string
  ]
}
Kolom
regionCodes[]

string

Daftar kode wilayah ISO 3166-1 alpha-2.

MarketingDataInsight

Insight untuk data pemasaran.

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

enum (AudienceInsightsDimension)

Dimensi yang terkait dengan insight.
attributes[]

object (MarketingDataInsightsAttribute)

Insight untuk nilai dimensi tertentu.

AudienceInsightsDimension

Kemungkinan dimensi untuk digunakan dalam membuat insight.

Enum
AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED Tidak ditentukan.
AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN Nilai tidak diketahui dalam versi ini.
AFFINITY_USER_INTEREST Affinity UserInterest.
IN_MARKET_USER_INTEREST UserInterest Berniat Beli.
AGE_RANGE Rentang usia.
GENDER Gender.

MarketingDataInsightsAttribute

Insight untuk kumpulan atribut terkait dari dimensi yang sama.

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

string (int64 format)

ID minat pengguna.
lift

number

Pengukuran peningkatan yang dimiliki audiens untuk nilai atribut dibandingkan dengan dasar pengukuran. Rentang [0-1].
ageRange

enum (AgeRange)

Rentang usia audiens yang datanya disediakan.
gender

enum (Gender)

Gender audiens yang datanya digunakan untuk menghitung peningkatan.

RentangUsia

Rentang usia demografi

Enum
AGE_RANGE_UNSPECIFIED Tidak ditentukan.
AGE_RANGE_UNKNOWN Tak diketahui.
AGE_RANGE_18_24 Berusia antara 18 dan 24 tahun.
AGE_RANGE_25_34 Berusia antara 25 dan 34 tahun.
AGE_RANGE_35_44 Berusia antara 35 dan 44 tahun.
AGE_RANGE_45_54 Berusia antara 45 dan 54 tahun.
AGE_RANGE_55_64 Berusia antara 55 dan 64 tahun.
AGE_RANGE_65_UP 65 tahun ke atas.

Gender

Jenis gender demografis (misalnya, perempuan).

Enum
GENDER_UNSPECIFIED Tidak ditentukan.
GENDER_UNKNOWN Tak diketahui.
GENDER_MALE Laki-laki.
GENDER_FEMALE Perempuan.