AudienceInsightsService için tüm istekler sıklık sınırlamasına tabidir. generateAudienceCompositionInsights ve generateSuggestedTargetingInsights için diğer kitle analizi yöntemlerine kıyasla günde daha az isteğe izin verilir. Daha fazla bilgi için API kotaları bölümüne bakın.
AudienceInsightsService, Google kitle analizi verilerini planlama araçlarınıza entegre etmenize olanak tanır. Bu veriler, medya ajanslarının ve medya planlamacılarının demografi, ilgi alanları ve online davranışlar dahil olmak üzere hedef kitlelerini daha iyi anlamalarına yardımcı olur.
Kitle analizleri, geniş bir bakış açısı sunarak bir kitleyi, kategoriyi, konuyu veya markayı anlamanıza yardımcı olur. İlgili konulardaki kullanıcı davranışlarını analiz ederek, bu kitle analizlerini kullanarak tüketicilerin sahip olduğu ilişkilendirmeleri ve algıları ortaya çıkarabilir ve yeni kitle segmentleri belirleyebilirsiniz.
API, üç temel kullanım alanını destekler:
- Kitleleri hassaslaştırma ve keşfetme: Bir markanın yeni kitlelerini belirlemek, kitle karakterleri geliştirmek ve kitle segmentasyonu stratejilerini hassaslaştırmak için tüketicilerin benzersiz ilgi alanlarını ve davranışlarını anlayın.
- Kampanya planlamasını bilgilendirme: Veri çıkışlarını, planlama yapılacak YouTube hedef kitlelerine dönüştürün, hedeflenen kitlelerin potansiyel erişimini tahmin edin ve kampanya erişimini en üst düzeye çıkarmak için kitle segmentleri arasındaki çakışmayı ölçün.
- Reklam öğesi mesajları geliştirin: Reklam öğesi mesajlarını, hedef kitlenizin en çok ilgilendiği konulara ve yakınlıklara göre uyarlayın.
Uygunluk koşulları
AudienceInsightsService'e uygun olmak için iş ortaklarının aşağıdaki koşulları karşılaması gerekir:
- Insights Finder'a erişiminiz olmalı veya erişim için uygun olmalısınız.
- API'yi entegre eden bir planlama aracına veya kullanıcı arayüzüne sahip olmalıdır.
- API'yi medya planlama veya diğer alakalı kullanım alanları için kullanın.
- Ön değerlendirmeyi tamamlayın.
- Veri kullanımı şartlarına uymak ve periyodik veri denetimlerinden geçmek
- Google Ads API hizmet şartlarını ve ilgili veri kullanımı politikasını kabul edin.
Daha fazla bilgi için Google temsilcinizle iletişime geçin.
Liste analizleri için uygun tarihler
Tipik bir iş akışı, analiz için hangi takvim aylarının ve tarih aralıklarının kullanılabilir olduğunu kontrol ederek başlar. listInsightsEligibleDates yöntemi, data_months alanında kitle analizi verilerinin kullanılabildiği ayları (YYYY-MM biçiminde) listeleyen bir ListInsightsEligibleDatesResponse döndürür.
Yanıtın last_thirty_days alanı, istekte data_month ayarlanmadığında generateAudienceCompositionInsights tarafından kullanılan tam tarih aralığını içerir.
Kitle analizi özelliklerini listeleme
Kitle bileşimi veya çakışma metriklerini sorgulamadan önce listAudienceInsightsAttributes kullanarak geçerli özellik kimliklerini bulun. Bu yöntem, istenen boyutlar için kullanılabilir özellikleri içeren bir ListAudienceInsightsAttributesResponse döndürür.
Örneğin, istekte boyut olarak AFFINITY_USER_INTEREST seçilirse yöntem, "Spor Taraftarları" veya "Müzik Severler" gibi desteklenen yakın ilgi alanı kitlelerini döndürür. Desteklenen diğer kullanıcı ilgi alanı boyutları arasında IN_MARKET_USER_INTEREST ve LIFE_EVENT_USER_INTEREST bulunur. Tek bir istekte birden fazla boyut ayarlayabilirsiniz. Desteklenen boyutların tam listesi için dimensions alan referansına bakın.
KNOWLEDGE_GRAPH boyutunu kullanarak Bilgi Grafiği varlıklarını (konular) ararken query_text alanında bir dize sorgusu sağlamanız gerekir (ör. "football and the World Cup").
Konu aramanızı özelleştirmek için isteğe bağlı olarak knowledge_graph_entity_search_options ekleyebilirsiniz:
- Özelliklere göre filtreleme: Alınan varlıkları yalnızca belirli özellikleri destekleyenlerle daraltmak için
search_filterkullanın. Örneğin,entity_capability_filtersalanındaCREATOR_ATTRIBUTEdeğerini sağlayarak içerik üretici özellikleri olarak desteklenen konuları filtreleyebilirsiniz. Birden fazla özellik sağlanabilir ve bunlarORmantığıyla birleştirilir. - Tüm içerik üretici özelliklerini alma: İçerik üretici özellikleri olarak etiketlenmiş tüm Bilgi Grafiği varlıklarını almak için
get_all_creator_attributesdeğerinitrueolarak ayarlayın. Bu seçenek kullanılırkenKNOWLEDGE_GRAPHboyutu seçilmeli,query_textboş olmalı ve bu seçeneğisearch_filterile birleştiremezsiniz.
Bu keşfedilebilirlik yönteminin döndürdüğü özellikler, diğer AudienceInsightsService yöntemleri için giriş olarak kullanılabilir.
ListAudienceInsightsAttributesResponse içindeki her AudienceInsightsAttributeMetadata nesnesi, açıklayıcı özellikler ve etkileşim metrikleriyle birlikte bir kitle özelliğinin yapılandırılmış temsilini sağlar.
Özelliğin birincil tanımını, görünen adını, boyut türünü ve tahmini kitle erişimini içerir. Alan tanımları için AudienceInsightsAttributeMetadata referansına bakın.
Kitle tanımı oluşturma
generateAudienceDefinition yöntemi, bir kitlenin serbest biçimli metin açıklamasını, daha sonraki analiz yöntemlerine iletebileceğiniz yapılandırılmış kitle özelliği önerilerine dönüştürür.
Hedefleme önerileri oluşturma
generateSuggestedTargetingInsights yöntemi, istenen kitleyle alakalı hedefleme analizlerinden (ör. hedeflenebilir kitle segmentleri) oluşan bir koleksiyon döndürür.
İstenen kitleyi yapılandırılmış bir InsightsAudienceDefinition veya InsightsAudienceDescription içinde metin açıklaması olarak belirtebilirsiniz.
generateAudienceCompositionInsights, her bir özellik segmenti için analizler döndürürken generateSuggestedTargetingInsights, hedeflenebilir Google Ads kitle segmentleriyle ilgili toplu öneriler döndürür. Bu yöntem, "Balık tutmaktan hoşlanan 30'lu yaşlardaki babalar için hedeflenebilir kitle önerileri ver" gibi soruları yanıtlamaya yardımcı olur.
Hedefleme önerisi metrikleri oluşturma
generateTargetingSuggestionMetrics yöntemi, GenerateTargetingSuggestionMetricsRequest içinde istenen her kitle tanımı için ulaşılabilecek potansiyel YouTube izleyicisi nüfusu içeren bir GenerateTargetingSuggestionMetricsResponse döndürür.
Bu yöntem, "ABD'de kamp yapmayla ilgilenen 18 yaş ve üzeri kaç erkeğe YouTube'da ulaşılabilir?" gibi soruları yanıtlamaya yardımcı olur.
Kitle bileşimi analizleri oluşturma
generateAudienceCompositionInsights yöntemi, istenen ilgi alanı kitlesini temsil eden özelliklerin listesini içeren bir GenerateAudienceCompositionInsightsResponse döndürür. Bu liste, her bir özelliğin kitledeki payını bir referans popülasyonla karşılaştıran dizin ve paylaşım metriklerini de içerir.
Kitle için bir hedef ülke belirtmeniz gerekir. İçerik analizlerini almak için desteklenen boyutların listesi, GenerateAudienceCompositionInsightsRequest nesnesinin dimensions alanında belgelenmiştir.
Bu yöntem, "Hedef kitlemin genel nüfusa kıyasla en çok ilgilendiği yakın ilgi alanları nelerdir ve bu yakın ilgi alanlarıyla etkileşim kurma olasılıkları ne kadar daha yüksektir?" gibi soruların yanıtlanmasına yardımcı olur.
Kitle çakışması analizleri oluşturma
generateAudienceOverlapInsights yöntemi, potansiyel YouTube erişimleri ile birincil özelliğin erişimi arasındaki çakışma tahminlerini içeren kitle özelliklerinin listesini barındıran bir GenerateAudienceOverlapInsightsResponse döndürür.
Hedef ülke ve birincil özellik belirtmeniz gerekir. Yaş grubu, cinsiyet, yakın ilgi alanı segmentleri ve pazardaki segmentler kitle boyutları olarak desteklenir.
Bu yöntem, "ABD'de hem spor tutkunlarını hem de müzikseverleri hedeflediğimizde artımlı kitle boyutu ne kadar olur?" gibi soruların yanıtlanmasına yardımcı olur.
Insights Finder raporu oluşturma
generateInsightsFinderReport yöntemi, GenerateInsightsFinderReportRequest içinde belirtilen girişlere göre Insights Finder'da kayıtlı bir rapor oluşturur ve bu raporu Insights Finder kullanıcı arayüzünde açmak için harici olarak erişilebilen bir bağlantı içeren GenerateInsightsFinderReportResponse döndürür.
Google Issue Tracker
Destekle ilgili sorular sormak, hataları bildirmek veya özellik istekleri göndermek için Google Issue Tracker'ı kullanın. Google, isteklerinizi doğrudan Issue Tracker'da takip eder, önceliklendirir ve isteklerinizle ilgili güncellemeleri yayınlar. Daha fazla bilgi için Google Issue Tracker'da sorun oluşturma başlıklı makaleyi inceleyin.
Aşağıdaki Issue Tracker şablonlarından birini kullanarak sorun oluşturun:
- Genel destek sorusu sorma veya belgelerle ilgili geri bildirim gönderme
- Teknik hata bildirme
- API özellik isteği gönderme
Google'ın isteğinizi yeniden oluşturabilmesi ve önceliklendirebilmesi için şablondaki tüm alanları ayrıntılı bilgilerle doldurun. Google, eksik raporları kapatabilir ve eksik ayrıntıları içeren yeni bir sorun göndermenizi isteyebilir.