Method: customers.generateAudienceCompositionInsights

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

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

Permintaan HTTP

POST https://googleads.googleapis.com/v16/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 insightnya 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 selama tiga puluh hari terakhir.
dimensions[]

enum (AudienceInsightsDimension)

Wajib. Dimensi audiens yang analisis komposisinya harus ditampilkan.
customerInsightsGroup

string

Nama pelanggan yang direncanakan. Nilai ini ditentukan oleh 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)

Isi laporan insight, 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.

AudienceCompositionSection

Kumpulan atribut terkait dari jenis yang sama dalam laporan insight 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 dimensinya adalah GENDER, AGE_RANGE, atau PARENTAL_STATUS, maka daftar atribut ini lengkap.
clusteredAttributes[]

object (AudienceCompositionAttributeCluster)

Atribut tambahan untuk audiens ini, yang dikelompokkan ke dalam cluster. 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)

Metrik berbagi dan indeks untuk atribut.

AudienceCompositionMetrics

Metrik indeks dan pangsa 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) audiens dasar yang cocok dengan atribut.
audienceShare

number

Fraksi (dari 0 hingga 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 insight komposisi audiens.

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

string

Nama kelompok atribut ini
clusterMetrics

object (AudienceCompositionMetrics)

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

object (AudienceCompositionAttribute)

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