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/v15/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.

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.