Method: accountTypes.accounts.insights.retrieve

Mengambil insight data pemasaran untuk daftar pengguna tertentu.

Fitur ini hanya tersedia untuk partner data.

Header Otorisasi:

Metode ini mendukung header opsional berikut untuk menentukan cara API mengizinkan akses untuk permintaan:

  • login-account: (Opsional) Nama resource akun tempat Akun Google kredensial adalah pengguna. Jika tidak disetel, defaultnya adalah akun permintaan. Format: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (Opsional) Nama resource akun dengan link produk yang sudah dibuat ke login-account. Format: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib. Akun induk yang memiliki daftar pengguna. Format: accountTypes/{accountType}/accounts/{account}

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "baseline": {
    object (Baseline)
  },
  "userListId": string
}
Kolom
baseline

object (Baseline)

Wajib. Dasar untuk insight yang diminta.
userListId

string

Wajib. ID daftar pengguna yang insight-nya 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 
{

  // 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.
}
Kolom
Lokasi dasar pengukuran yang menjadi pembanding insight. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
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.
Akhir kolom yang saling eksklusif.

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.

Fitur ini hanya tersedia untuk partner data.

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 UserInterest Affinity.
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 demografi (misalnya, perempuan).

Enum
GENDER_UNSPECIFIED Tidak ditentukan.
GENDER_UNKNOWN Tak diketahui.
GENDER_MALE Pria.
GENDER_FEMALE Perempuan.