Method: customers.generateAudienceCompositionInsights

İlgi alanı kitlesinde temsil edilen bir özellik koleksiyonunu döndürür. Her bir özelliğin kitledeki payını temel kitledeki payıyla karşılaştıran metriklerle birlikte gelir.

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

HTTP isteği

POST https://googleads.googleapis.com/v16/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ıya sahip verileri içerir:

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

object (InsightsAudience)

Zorunlu. Analizin istendiği ilgi alanı kitlesi.
baselineAudience

object (InsightsAudience)

İlgili kitlenin karşılaştırıldığı temel kitle.
dataMonth

string

Analizler için kullanılacak bir aylık geçmiş veri aralığıdır ve "yyyy-aa" biçimindedir. Politika ayarlanmadan bırakılırsa son otuz güne ait verilere ait 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)

Analizler raporunun bölümler halinde düzenlenmiş içeriği. Her bölüm, istekteki AudienceInsightsDimension değerlerinin 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 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

AudienceCompositionSection

Kitle bileşimi analizleri raporundaki aynı türden alakalı ö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 kitleyle en alakalı segmentler. Boyut GENDER, AGE_RANGE veya PARENTAL_STATUS ise bu özellik listesi tam kapsamlıdır.
clusteredAttributes[]

object (AudienceCompositionAttributeCluster)

Bu kitle için kümeler halinde gruplandırılmış ek özellikler. Yalnızca boyut YOUTUBE_CHANNEL olduğunda doldurulur.

AudienceCompositionAttribute

Meta veri ve metrikleri içeren bir kitle özelliği.

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

object (AudienceInsightsAttributeMetadata)

Meta verileri olan özellik.
metrics

object (AudienceCompositionMetrics)

Özelliğin paylaşım ve dizine ekleme metrikleri.

AudienceCompositionMetrics

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

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

number

Özellikle eşleşen temel kitlenin oranı (0-1 dahil).
audienceShare

number

Özellikle eşleşen belirli bir kitlenin oranı (0 ile 1 dahil olmak üzere bu değer arasında).
index

number

AudienceShare'in temel Kitle Payına oranı. Bu oran tanımlanmamışsa veya anlamlı değilse sıfırdır.
score

number

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

AudienceCompositionAttributeCluster

Kitle bileşimi analizleri raporunda meta veriler ve metriklerle birlikte ilgili özelliklerden oluşan bir 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 clusterMetrics bütün olarak kümeyle ilişkilendirilen metriklerdir. Diğer boyutlar için bu alan ayarlanmaz.
attributes[]

object (AudienceCompositionAttribute)

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