Method: customers.generateAudienceCompositionInsights

Menampilkan kumpulan atribut yang direpresentasikan dalam audiens minat, dengan metrik yang membandingkan pangsa audiens setiap atribut dengan pangsa audiens dasar masing-masing.

Daftar error yang ditampilkan: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

Permintaan HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}:generateAudienceCompositionInsights

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

Wajib. ID pelanggan.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "audience": {
    object (InsightsAudience)
  },
  "baselineAudience": {
    object (InsightsAudience)
  },
  "dataMonth": string,
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "customerInsightsGroup": string
}
Kolom
audience

object (InsightsAudience)

Wajib. Audiens minat yang analisisnya diminta.
baselineAudience

object (InsightsAudience)

Audiens dasar yang dibandingkan dengan audiens minat.
dataMonth

string

Rentang data historis selama satu bulan yang akan digunakan untuk insight, dalam format "yyyy-mm". Jika tidak disetel, insight akan ditampilkan untuk data tiga puluh hari terakhir.
dimensions[]

enum (AudienceInsightsDimension)

Wajib. Dimensi audiens yang analisis komposisinya harus ditampilkan.
customerInsightsGroup

string

Nama pelanggan yang direncanakan. Nilai ini adalah nilai yang ditentukan pengguna.

Isi respons

Pesan respons untuk AudienceInsightsService.GenerateAudienceCompositionInsights.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "sections": [
    {
      object (AudienceCompositionSection)
    }
  ]
}
Kolom
sections[]

object (AudienceCompositionSection)

Konten laporan wawasan, yang disusun menjadi beberapa bagian. Setiap bagian dikaitkan dengan salah satu nilai AudienceInsightsDimension dalam permintaan. Mungkin ada lebih dari satu bagian per dimensi.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

InsightsAudience

Kumpulan pengguna, yang ditentukan menurut berbagai karakteristik, yang dapat dimintai insight-nya di AudienceInsightsService.

Representasi JSON 
{
  "countryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "subCountryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "incomeRanges": [
    {
      object (IncomeRangeInfo)
    }
  ],
  "dynamicLineups": [
    {
      object (AudienceInsightsDynamicLineup)
    }
  ],
  "topicAudienceCombinations": [
    {
      object (InsightsAudienceAttributeGroup)
    }
  ]
}
Kolom
countryLocations[]

object (LocationInfo)

Wajib. Negara untuk audiens.
subCountryLocations[]

object (LocationInfo)

Atribut lokasi geografis sub-negara. Jika ada, masing-masing harus berada di salah satu negara di audiens ini. Jika tidak ada, audiens akan berada secara geografis ke countryLocations dan tidak lagi.
gender

object (GenderInfo)

Gender untuk audiens. Jika tidak ada, audiens tidak akan dibatasi berdasarkan gender.
ageRanges[]

object (AgeRangeInfo)

Rentang usia untuk audiens. Jika tidak ada, audiens mewakili semua orang berusia di atas 18 tahun yang cocok dengan atribut lainnya.
parentalStatus

object (ParentalStatusInfo)

Status keorangtuaan untuk audiens. Jika tidak ada, audiens tidak dibatasi berdasarkan status keorangtuaan.
incomeRanges[]

object (IncomeRangeInfo)

Rentang persentil pendapatan rumah tangga untuk audiens. Jika tidak ada, audiens tidak dibatasi berdasarkan rentang pendapatan rumah tangga.
dynamicLineups[]

object (AudienceInsightsDynamicLineup)

Daftar dinamis yang mewakili konten YouTube yang ditonton oleh audiens.
topicAudienceCombinations[]

object (InsightsAudienceAttributeGroup)

Kombinasi atribut entitas, kategori, dan minat pengguna yang menentukan audiens. Kombinasi tersebut memiliki struktur AND-of-OR yang logis: Atribut dalam setiap InsightsAudienceAttributeGroup digabungkan dengan OR, dan kombinasi itu sendiri digabungkan dengan AND. Misalnya, ekspresi (Entitas ATAU Minat) AND (Berniat Beli ATAU Kategori) dapat dibentuk menggunakan dua InsightsAudienceAttributeGroups masing-masing dengan dua Atribut.

InsightsAudienceAttributeGroup

Daftar AudienceInsightsAttributes.

Representasi JSON 
{
  "attributes": [
    {
      object (AudienceInsightsAttribute)
    }
  ]
}
Kolom
attributes[]

object (AudienceInsightsAttribute)

Wajib. Kumpulan atribut audiens untuk digabungkan dengan logika ATAU. Atribut tidak harus memiliki dimensi yang sama. Konteks ini hanya mendukung entitas Pustaka Pengetahuan, Kategori Produk & Layanan, serta audiens Minat dan Berniat Beli.

AudienceCompositionSection

Kumpulan atribut terkait dari jenis yang sama dalam laporan analisis komposisi audiens.

Representasi JSON 
{
  "dimension": enum (AudienceInsightsDimension),
  "topAttributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ],
  "clusteredAttributes": [
    {
      object (AudienceCompositionAttributeCluster)
    }
  ]
}
Kolom
dimension

enum (AudienceInsightsDimension)

Jenis atribut di bagian ini.
topAttributes[]

object (AudienceCompositionAttribute)

Segmen yang paling relevan untuk audiens ini. Jika dimensi adalah GENDER, AGE_RANGE, atau PARENTAL_STATUS, maka daftar atribut ini sudah lengkap.
clusteredAttributes[]

object (AudienceCompositionAttributeCluster)

Atribut tambahan untuk audiens ini, yang dikelompokkan ke dalam beberapa klaster. Hanya diisi jika dimensi adalah YOUTUBE_CHANNEL.

AudienceCompositionAttribute

Atribut audiens dengan metadata dan metrik.

Representasi JSON 
{
  "attributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "metrics": {
    object (AudienceCompositionMetrics)
  }
}
Kolom
attributeMetadata

object (AudienceInsightsAttributeMetadata)

Atribut dengan metadatanya.
metrics

object (AudienceCompositionMetrics)

Membagikan dan mengindeks metrik untuk atribut.

AudienceCompositionMetrics

Metrik pangsa dan indeks yang terkait dengan atribut dalam laporan analisis komposisi audiens.

Representasi JSON 
{
  "baselineAudienceShare": number,
  "audienceShare": number,
  "index": number,
  "score": number
}
Kolom
baselineAudienceShare

number

Fraksi (dari 0 hingga 1 inklusif) dari audiens dasar yang cocok dengan atribut.
audienceShare

number

Fraksi (dari 0 sampai 1 inklusif) dari audiens tertentu yang cocok dengan atribut.
index

number

Rasio audienceShare terhadap baselineAudienceShare, atau nol jika rasio ini tidak ditentukan atau tidak berarti.
score

number

Skor relevansi dari 0 hingga 1 inklusif.

AudienceCompositionAttributeCluster

Kumpulan atribut terkait, dengan metadata dan metrik, dalam laporan analisis komposisi audiens.

Representasi JSON 
{
  "clusterDisplayName": string,
  "clusterMetrics": {
    object (AudienceCompositionMetrics)
  },
  "attributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ]
}
Kolom
clusterDisplayName

string

Nama cluster atribut ini
clusterMetrics

object (AudienceCompositionMetrics)

Jika dimensi yang terkait dengan cluster ini adalah YOUTUBE_CHANNEL, maka clusterMetrics adalah metrik yang terkait dengan cluster secara keseluruhan. Untuk dimensi lain, kolom ini tidak ditetapkan.
attributes[]

object (AudienceCompositionAttribute)

Atribut individual yang membentuk cluster ini, dengan metadata dan metrik.