- HTTP isteği
- Yol parametreleri
- İstek gövdesi
- Yanıt metni
- Yetkilendirme kapsamları
- AudienceCompositionSection
- AudienceCompositionAttribute
- AudienceCompositionMetrics
- AudienceCompositionAttributeCluster
- Deneyin.
İ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 |
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 ( |
Alanlar | |
---|---|
audience |
Zorunlu. Analizin istendiği ilgi alanı kitlesi. |
baselineAudience |
İlgili kitlenin karşılaştırıldığı temel kitle. |
dataMonth |
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[] |
Zorunlu. Beste analizlerinin döndürülmesi gereken kitle boyutları. |
customerInsightsGroup |
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 ( |
Alanlar | |
---|---|
sections[] |
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 ( |
Alanlar | |
---|---|
dimension |
Bu bölümdeki özelliklerin türü. |
topAttributes[] |
Bu kitleyle en alakalı segmentler. Boyut GENDER, AGE_RANGE veya PARENTAL_STATUS ise bu özellik listesi tam kapsamlıdır. |
clusteredAttributes[] |
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 ( |
Alanlar | |
---|---|
attributeMetadata |
Meta verileri olan özellik. |
metrics |
Ö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 |
Özellikle eşleşen temel kitlenin oranı (0-1 dahil). |
audienceShare |
Özellikle eşleşen belirli bir kitlenin oranı (0 ile 1 dahil olmak üzere bu değer arasında). |
index |
AudienceShare'in temel Kitle Payına oranı. Bu oran tanımlanmamışsa veya anlamlı değilse sıfırdır. |
score |
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 ( |
Alanlar | |
---|---|
clusterDisplayName |
Bu özellik kümesinin adı |
clusterMetrics |
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[] |
Meta veri ve metriklerle birlikte bu kümeyi oluşturan bağımsız özellikler. |