Arama trafiği analizi için telemetri verilerini toplama

Makale
04/27/2024

Arama trafiği analizi, Kullanıcı tarafından başlatılan tıklama olayları ve klavye girişleri gibi Azure AI Search uygulamanızla kullanıcı etkileşimleri hakkında telemetri toplamak için kullanılan bir desendir. Bu bilgileri kullanarak popüler arama terimleri, tıklama oranı ve sıfır sonuç veren sorgu girişleri dahil olmak üzere arama çözümünüzün verimliliğini belirleyebilirsiniz.

Bu düzen, kullanıcı verilerini toplamak için Uygulama Analizler (Azure İzleyici'nin bir özelliği) bağımlılığını alır. Bu makalede açıklandığı gibi istemci kodunuza izleme eklemeniz gerekir. Son olarak, verileri analiz etmek için bir raporlama mekanizmasına ihtiyacınız vardır. Power BI'ı öneririz, ancak Uygulama Panosu'nu veya Uygulama Analizler bağlanan herhangi bir aracı kullanabilirsiniz.

Not

Bu makalede açıklanan desen, istemcinize eklediğiniz kod tarafından oluşturulan gelişmiş senaryolara ve tıklama akışı verilerine yöneliktir. Buna karşılık hizmet günlüklerini ayarlamak, çeşitli ölçümler sağlamak ve portalda kod gerektirmeden yapmak kolaydır. Günlüğün etkinleştirilmesi tüm senaryolar için önerilir. Daha fazla bilgi için bkz . Günlük verilerini toplama ve analiz etme.

İlgili arama verilerini tanımlama

Arama trafiği analizi için yararlı ölçümlere sahip olmak için arama uygulamanızın kullanıcılarından bazı sinyalleri günlüğe kaydetmek gerekir. Bu sinyaller, kullanıcıların ilgilendiği ve ilgili olarak değerlendirdikleri içeriği belirtir. Arama trafiği analizi için bunlar şunlardır:

Kullanıcı tarafından oluşturulan arama olayları: Yalnızca bir kullanıcı tarafından başlatılan arama sorguları ilgi çekicidir. Modelleri doldurmak veya iç bilgileri almak için kullanılanlar gibi diğer arama istekleri önemli değildir. Sonuçlarınızda dengesizlik veya sapma olmaması için yalnızca kullanıcı tarafından başlatılan olayları izlemeyi unutmayın.
Kullanıcı tarafından oluşturulan tıklama olayları: Arama sonuçları sayfasında tıklama olayı genellikle belgenin belirli bir arama sorgusu için uygun bir sonuç olduğu anlamına gelir.

Arama ve tıklama olaylarını bağıntı kimliğiyle bağlayarak, uygulamanızın arama işlevinin ne kadar iyi performans sergilediği hakkında daha fazla bilgi edinebilirsiniz.

Arama trafiği analizi ekleme

Azure AI Arama hizmeti portal sayfasında, bu telemetri desenini takip eden bir bilgi sayfasına erişmek için Trafik Analizinde Ara sayfasını açın. Bu sayfadan bir Uygulama Analizler kaynağı seçebilir veya oluşturabilir, izleme anahtarını alabilir, çözümünüz için uyarlayabileceğiniz kod parçacıklarını kopyalayabilir ve desene yansıtılan şema üzerinde oluşturulmuş bir Power BI raporu indirebilirsiniz.

1. Adım: Uygulama Analizler ayarlama

Mevcut bir Uygulama Analizler kaynağı seçin veya henüz yoksa bir kaynak oluşturun.

Bazı Visual Studio proje türleri için çalışan bir kısayol aşağıdaki adımlarda yansıtılır.

Çizim için, bu adımlar Statik bir web uygulamasına arama ekle'den istemciyi kullanır.

Çözümünüzü Visual Studio’da açın.
Proje menüsünde, Bağlan hizmetler>Ekle> Azure Uygulaması lication Analizler'ı seçin.
Bağımlılık Bağlan Azure Uygulaması Analizler'ı ve ardından İleri'yi seçin.
Azure aboneliğinizi, Uygulama Analizler kaynağınızı ve ardından Son'u seçin.

Bu noktada, uygulamanız uygulama izleme için ayarlanır ve bu da istemci uygulamanızdaki tüm sayfa yüklemelerinin varsayılan ölçümlerle izleneceği anlamına gelir.

Bu kısayol sizin için işe yaramadıysa bkz. Uygulama Analizler sunucu tarafı telemetrisini etkinleştirme.

2. Adım: İzleme ekleme

İstemci uygulamanıza izleme kodu ekleyin. Azure portalındaki Trafik Analizinde Arama sayfası, uygulama kodunuz içine yapıştırabileceğiniz kod parçacıkları sağlar.

Telemetri istemcisi oluşturma

Application Analizler'a olay gönderen bir nesne oluşturun. Burada C# ve JavaScript varyantları olarak ifade edilen sunucu tarafı uygulama kodunuza veya tarayıcıda çalışan istemci tarafı kodunuza izleme ekleyebilirsiniz. Diğer diller için bkz . desteklenen platformlar ve çerçeveler.

Sunucu tarafı telemetrisi, azure'da web hizmeti olarak veya şirket ağı üzerinde şirket içi uygulama olarak çalışan uygulamalar gibi uygulama katmanındaki ölçümleri yakalar. Sunucu tarafı telemetrisi arama ve tıklama olaylarını, bir belgenin sonuçlardaki konumunu ve sorgu bilgilerini yakalar, ancak veri toplamanızın kapsamı bu katmanda sağlanan bilgilerle kaplanır.

İstemcide sorgu girişlerini işleyen, gezinti ekleyen veya bağlam (örneğin, giriş sayfasından başlatılan sorgular ve ürün sayfası) içeren başka kodunuz olabilir. Bu, çözümünüzü açıklıyorsa, telemetrinizin ek ayrıntıları yansıtması için istemci tarafı izlemesini tercih edebilirsiniz. Bu ek ayrıntının nasıl toplandığı bu düzenin kapsamının ötesine geçer, ancak bu kararla ilgili yardım için web sayfaları için Uygulama Analizler'ni gözden geçirebilirsiniz.

İzleme anahtarını Azure portalından Uygulama Analizler sayfalarından veya Azure AI Search için Trafik analizinde ara sayfasından alabilirsiniz.

// Application Insights SDK: https://www.nuget.org/packages/Microsoft.ApplicationInsights.Web 

var telemetryClient = new TelemetryClient();
telemetryClient.InstrumentationKey = "0000000000000000000000000000";

Günlük arama olayları

Bir kullanıcı tarafından her arama isteği verildiğinde, bunu bir Application Analizler özel olayında aşağıdaki şemayla bir arama olayı olarak günlüğe kaydetmeniz gerekir. Yalnızca kullanıcı tarafından oluşturulan arama sorgularını günlüğe kaydetmeyi unutmayın.

SearchServiceName: (dize) arama hizmeti adı
SearchId: (guid) arama sorgusunun benzersiz tanımlayıcısı (arama yanıtında gelir)
IndexName: (dize) sorgulanacak arama hizmeti dizini
QueryTerms: (dize) kullanıcı tarafından girilen arama terimleri
ResultCount: (int) döndürülen belge sayısı (arama yanıtında gelir)
ScoringProfile: (dize) varsa kullanılan puanlama profilinin adı

Not

Arama sorgunuza $count=true ekleyerek kullanıcı tarafından oluşturulan sorguların sayısını isteyin. Daha fazla bilgi için bkz . Belge Arama (REST).

var properties = new Dictionary <string, string> {
	{"SearchServiceName", <SEARCH SERVICE NAME>},
	{"SearchId", <SEARCH ID>},
	{"IndexName", <INDEX NAME>},
	{"QueryTerms", <SEARCH TERMS>},
	{"ResultCount", <RESULTS COUNT>},
	{"ScoringProfile", <SCORING PROFILE USED>}
};

telemetryClient.TrackEvent("Search", properties);

Günlük tıklama olayları

Bir kullanıcı bir belgeye her tıklayışında bu, arama analizi amacıyla günlüğe kaydedilmesi gereken bir sinyaldir. Bu olayları aşağıdaki şemayla günlüğe kaydetmek için Application Analizler özel olayları kullanın:

ServiceName: (dize) arama hizmeti adı
SearchId: (guid) ilgili arama sorgusunun benzersiz tanımlayıcısı
DocId: (dize) belge tanımlayıcısı
Konum: Arama sonuçları sayfasındaki belgenin (int) sırası

Not

Konum, uygulamanızdaki kardinal sırasına başvurur. Karşılaştırma için her zaman aynı olduğu sürece bu sayıyı ayarlayabilirsiniz.

var properties = new Dictionary <string, string> {
	{"SearchServiceName", <SEARCH SERVICE NAME>},
	{"SearchId", <SEARCH ID>},
	{"ClickedDocId", <CLICKED DOCUMENT ID>},
	{"Rank", <CLICKED DOCUMENT POSITION>}
};

telemetryClient.TrackEvent("Click", properties);

3. Adım: Power BI'da analiz etme

Uygulamanızı denetledikten ve uygulamanızın Application Analizler'a doğru şekilde bağlanıldığını doğruladıktan sonra, Power BI desktop'taki verileri analiz etmek için önceden tanımlanmış bir rapor şablonu indirirsiniz. Rapor, arama trafiği analizi için yakalanan ek verileri analiz etmek için yararlı olan önceden tanımlanmış grafikler ve tablolar içerir.

Arama hizmeti sayfalarındaki Azure portalında, Ayarlar altında Trafik analizinde ara'yı seçin.
Power BI'ı yüklemek için Power BI Desktop'ı edinin'i seçin.
Raporu almak için Power BI raporunu indir'i seçin.
Rapor Power BI Desktop'ta açılır ve Uygulama Analizler bağlanmanız ve kimlik bilgilerini sağlamanız istenir. Bağlantı bilgilerini Uygulama Analizler kaynağınızın Azure portalı sayfalarında bulabilirsiniz. Kimlik bilgileri için, portal oturumu açmak için kullandığınız kullanıcı adı ve parolayı belirtin.
Yükle'yi seçin.

Rapor, arama performansınızı ve ilginizi artırmak için daha bilinçli kararlar vermenizi sağlayan grafikler ve tablolar içerir.

Ölçümler aşağıdaki öğeleri içerir:

Arama hacmi ve en popüler terim-belge çiftleri: aynı belgeye tıklanarak, tıklanarak sıralanmış olarak sonuçlanan terimler.
Tıklama olmadan aramalar: tıklama kaydetmeden en çok kullanılan sorgular için terimler

Aşağıdaki ekran görüntüsünde, tüm şema öğelerini kullandıysanız yerleşik bir raporun nasıl görünebileceği gösterilmektedir.

Sonraki adımlar

Arama hizmetiniz hakkında güçlü ve içgörüler elde etmek için arama uygulamanızı izleme.

Uygulama Analizler hakkında daha fazla bilgi bulabilir ve farklı hizmet katmanları hakkında daha fazla bilgi edinmek için fiyatlandırma sayfasını ziyaret edebilirsiniz.

Rapor oluşturma hakkında daha fazla bilgi edinin. Ayrıntılar için bkz . Power BI Desktop'ı kullanmaya başlama.

Share via