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

InsightsAudience

AudienceInsightsService'te analizleri istenebilecek, çeşitli özelliklerle tanımlanan bir kullanıcı grubu.

JSON gösterimi 
{
  "countryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "subCountryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "incomeRanges": [
    {
      object (IncomeRangeInfo)
    }
  ],
  "dynamicLineups": [
    {
      object (AudienceInsightsDynamicLineup)
    }
  ],
  "topicAudienceCombinations": [
    {
      object (InsightsAudienceAttributeGroup)
    }
  ]
}
Alanlar
countryLocations[]

object (LocationInfo)

Zorunlu. Kitle için ülkeler.
subCountryLocations[]

object (LocationInfo)

Ülke alt bölgesi coğrafi konum özellikleri. Bu gruplar varsa bunların her biri, bu kitledeki ülkelerden birinde yer almalıdır. Yoksa, kitle coğrafi olarak countryLocations içindir ve başka bir yerde bulunmaz.
gender

object (GenderInfo)

Kitlenin cinsiyeti. Kitle yoksa cinsiyete göre kısıtlama yapılmaz.
ageRanges[]

object (AgeRangeInfo)

Kitle için yaş aralıkları. Yoksa kitle, diğer özelliklerle eşleşen 18 yaşından büyük tüm kullanıcıları temsil eder.
parentalStatus

object (ParentalStatusInfo)

Kitle için ebeveynlik durumu. Bu etiket yoksa kitle, ebeveynlik durumuna göre kısıtlamaz.
incomeRanges[]

object (IncomeRangeInfo)

Kitle için hane geliri yüzdelik dilim aralıkları. Kitle yoksa hane geliri aralığıyla kısıtlama yapılmaz.
dynamicLineups[]

object (AudienceInsightsDynamicLineup)

Kitle tarafından izlenen YouTube içeriğini temsil eden dinamik kanal listeleri.
topicAudienceCombinations[]

object (InsightsAudienceAttributeGroup)

Kitleyi tanımlayan varlık, kategori ve kullanıcı ilgi alanı özelliklerinin kombinasyonu. Kombinasyon, mantıksal bir OR'lar yapısına sahiptir: Her bir InsightsAudienceAttributeGroup içindeki özellikler, OR ile birleştirilir ve kombinasyonların kendileri VE ile birleştirilir. Örneğin, (Varlık VEYA Yakın İlgi Alanı) VE (Pazardaki VEYA Kategori) ifadesi, her biri iki Özellik içeren iki InsightsAudienceAttributeGroups kullanılarak oluşturulabilir.

InsightsAudienceAttributeGroup

AudienceInsightsAttributes listesi.

JSON gösterimi 
{
  "attributes": [
    {
      object (AudienceInsightsAttribute)
    }
  ]
}
Alanlar
attributes[]

object (AudienceInsightsAttribute)

Zorunlu. Mantıksal OR ile birleştirilecek kitle özellikleri koleksiyonu. Özelliklerin hepsinin aynı boyutta olması gerekmez. Bu bağlamda yalnızca Bilgi Grafiği varlıkları, Ürün ve Hizmet Kategorileri ile Yakın İlgi Alanı ve Pazardaki kitleler desteklenir.

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.