Method: customers.generateAudienceCompositionInsights

Bir ilgi alanı kitlesinde temsil edilen bir özellik koleksiyonunu döndürür. Bu metrikler, her özelliğin kitle payını temel kitle payıyla karşılaştırır.

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

İsteğin gövdesi, aşağıdaki yapıya sahip 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

"yyyy-aa" biçiminde, analizler için kullanılacak bir aylık geçmiş veri aralığı. 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)

Analiz raporunun, bölümler halinde düzenlenmiş içeriği. Her bölüm, istekteki AudienceInsightsDimension değerlerinden biriyle ilişkilendirilir. Boyut başına birden çok 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şim analizleri raporundaki aynı türden 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 özellik 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 veriler ve metrikler içeren bir 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

Özellikle eşleşen temel kitlenin oranı (0 ile 1 (bu değerler dahil) aralığında).
audienceShare

number

Özellik ile eşleşen belirli kitlenin oranı (0 ile 1 dahil olmak üzere) sayısı.
index

number

AudienceShare'ın referansAudienceShare'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 alaka düzeyi puanı.

AudienceCompositionAttributeCluster

Kitle bileşim analizleri raporundaki meta veriler ve metriklerle birlikte ilgili özelliklerin koleksiyonu.

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 columnMetrics, kümenin tamamı ile ilişkilendirilen metriklerdir. Diğer boyutlar için bu alan ayarlanmamıştır.
attributes[]

object (AudienceCompositionAttribute)

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