Method: customers.generateAudienceCompositionInsights

Her bir özelliğin kitle payını temel kitlenin payıyla karşılaştıran metriklerle birlikte, ilgili bir kitlede temsil edilen özelliklerin bir koleksiyonunu döndürür.

Atılan hataların listesi: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
customerId

string

Zorunlu. Müşterinin kimliği.

İstek içeriği

İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:

JSON gösterimi 
{
  "audience": {
    object (InsightsAudience)
  },
  "baselineAudience": {
    object (InsightsAudience)
  },
  "dataMonth": string,
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "customerInsightsGroup": string
}
Alanlar
audience

object (InsightsAudience)

Zorunlu. Analizlerin istendiği ilgili kitle.
baselineAudience

object (InsightsAudience)

İlgi alanı kitlesinin karşılaştırıldığı temel kitle.
dataMonth

string

Analizler için kullanılacak, "yyyy-aa" biçimindeki bir aylık geçmiş veri aralığı. Politika ayarlanmazsa son otuz güne ait verilerle ilgili analizler döndürülür.
dimensions[]

enum (AudienceInsightsDimension)

Zorunlu. Beste analizlerinin döndürülmesi gereken kitle boyutları.
customerInsightsGroup

string

Planlanan müşterinin adı. Bu, kullanıcı tanımlı bir değerdir.

Yanıt gövdesi

AudienceInsightsService.GenerateAudienceCompositionInsights için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "sections": [
    {
      object (AudienceCompositionSection)
    }
  ]
}
Alanlar
sections[]

object (AudienceCompositionSection)

Analiz raporunun, bölümler halinde düzenlenmiş içeriği. Her bölüm, istekteki AudienceInsightsBoyut değerlerinden biriyle ilişkilendirilir. Boyut başına birden fazla bölüm olabilir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.

AudienceCompositionSection

Kitle bileşimi analizleri raporundaki aynı türdeki ilgili özelliklerin koleksiyonu.

JSON gösterimi 
{
  "dimension": enum (AudienceInsightsDimension),
  "topAttributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ],
  "clusteredAttributes": [
    {
      object (AudienceCompositionAttributeCluster)
    }
  ]
}
Alanlar
dimension

enum (AudienceInsightsDimension)

Bu bölümdeki özelliklerin türü.
topAttributes[]

object (AudienceCompositionAttribute)

Bu kitle için en alakalı segmentler. Boyut GENDER, AGE_RANGE veya PARENTAL_STATUS ise bu özellikler listesi kapsamlıdır.
clusteredAttributes[]

object (AudienceCompositionAttributeCluster)

Bu kitlenin kümeler halinde gruplandırılmış ek özellikleri. Yalnızca boyut YOUTUBE_CHANNEL ise doldurulur.

AudienceCompositionAttribute

Meta verileri ve metrikleri içeren kitle özelliği.

JSON gösterimi 
{
  "attributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "metrics": {
    object (AudienceCompositionMetrics)
  }
}
Alanlar
attributeMetadata

object (AudienceInsightsAttributeMetadata)

Meta verileriyle birlikte özellik.
metrics

object (AudienceCompositionMetrics)

Özelliğin metriklerini paylaşın ve dizine ekleyin.

AudienceCompositionMetrics

Kitle bileşimi analizleri raporundaki bir özellikle ilişkili paylaşım ve dizin metrikleri.

JSON gösterimi 
{
  "baselineAudienceShare": number,
  "audienceShare": number,
  "index": number,
  "score": number
}
Alanlar
baselineAudienceShare

number

Özellik ile eşleşen temel kitlenin oranı (0 ile 1 dahil olmak üzere) değeri.
audienceShare

number

Özellikle eşleşen belirli kitlenin oranı (0 ile 1 dahil olmak üzere) değeri.
index

number

AudienceShare'ın temelAudienceShare'a oranı veya bu oran tanımlanmamışsa ya da anlamlı değilse sıfır.
score

number

0 ile 1 (bu değerler dahil) arasında bir alaka düzeyi puanı.

AudienceCompositionAttributeCluster

Kitle bileşimi analizleri raporundaki ilgili özelliklerin, meta verileri ve metrikleri içeren koleksiyon.

JSON gösterimi 
{
  "clusterDisplayName": string,
  "clusterMetrics": {
    object (AudienceCompositionMetrics)
  },
  "attributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ]
}
Alanlar
clusterDisplayName

string

Bu özellik kümesinin adı
clusterMetrics

object (AudienceCompositionMetrics)

Bu kümeyle ilişkilendirilen boyut YOUTUBE_CHANNEL ise kümeMetrikleri, kümenin bütünüyle ilişkilendirilmiş metriklerdir. Diğer boyutlar için bu alan ayarlanmamıştır.
attributes[]

object (AudienceCompositionAttribute)

Meta veri ve metriklerle birlikte bu kümeyi oluşturan bağımsız özellikler.