Panel Verisinin Dışa Aktarımı
Microsoft Clarity Data Export API, panel verisinin programlı olarak alınmasını sağlar. Bu işlevin bütün oturum görüntülerini veya sınırsız tarih arşivini indirebildiği varsayılmamalıdır. İşletme önce raporun hangi soruyu yanıtlayacağını ve gerekli veri aralığını belirlemelidir. Örneğin günlük cihaz dağılımını saklamak ile aylar önceki tek ziyaretçinin hareketini yeniden oynatmak farklı amaçlardır. Uç noktanın sunduğu özet veri, kayıt oynatıcısının tüm yetenekleriyle aynı kapsamda değildir; entegrasyon tasarımı bu ayrımı koruyarak yapılır.
Erişim ve Anahtar Sahipliği
Dışa aktarım için proje yöneticisinin ürettiği erişim belirteci gerekir. Clarity istemci tarafında kullanılan proje kimliğiyle bu sunucu erişimi birbirine karıştırılmaz. Belge istekte Bearer belirteci tanımlar; gerçek değer ziyaretçinin tarayıcısına, herkese açık kod dosyasına veya ekran görüntüsüne konmamalıdır. Entegrasyonu hangi hizmetin kullandığı anlaşılır bir adla kaydedilebilir. Ekipten erişimi olan kişi ayrıldığında yalnız proje üyeliğini kaldırmakla yetinilmez; ilişkili dışa aktarım belirteçleri de gözden geçirilir. Böylece hesap yönetimiyle veri erişimi birlikte değerlendirilir.
Clarity Dışa Aktarım Belirteci Alanı
Clarity Dışa Aktarım Belirteci Alanı resmî yardım belgesindeki görünümüyle gösterilir. Görüntü ilgili alanın veya seçimin nasıl sunulduğunu açıklar; kullanılan panel sürümüne göre yerleşim değişebilir.
Tarih Penceresini Doğru Okumak
Belgede numOfDays parametresi son bir, iki veya üç günlük veriyi isteyecek şekilde tanımlanır. Bu değer takvimden serbest başlangıç ve bitiş tarihi seçen bir arşiv sorgusu değildir. Yanıtın UTC zamanına göre dönmesi, yerel gün raporuyla doğrudan karşılaştırmayı da etkileyebilir. Örnek olarak gece yarısı çalışan bir raporda hangi saat aralığının kapsandığı belirtilmezse eksik gün sanılan sonuç aslında farklı pencereyi temsil edebilir. Daha uzun dönem gerekiyorsa uygun saklama planı veri alınmaya başlanırken düşünülmelidir.
Clarity Veri Dışa Aktarımında Rapor Kapsamı İçin Örnek Durumlar
Günlük rapor alındı: UTC ve son gün penceresini okuyun. Yerel takvim günüyle birebir aynı olmayabilir. Tablo satır sınırında: Boyut seçimi ve sınırı kontrol edin. Sayfalamasız yanıt tüm ham veri sayılmaz. Yetkili kişi ayrıldı: İlişkili erişim belirteçlerini inceleyin. Üyelik ve belirteç erişimi birlikte ele alınır. Bu çizim, makaledeki koşulları açıklayan temsilî değerlendirmedir; gerçek hesap kaydı veya uygulanmış müşteri testi değildir.
Boyut ve Satır Sınırı
Clarity belgesi bir istekte en fazla üç boyut seçilebildiğini ve yanıtın satır sınırı bulunduğunu belirtir. Ayrıca bu sonuç için sayfalama sunulmadığını açıklar. Çok parçalı bir dağılımda gelen tabloyu mağazanın eksiksiz ham veri listesi saymak bu nedenle hatalıdır. Ekip rapor için gerçekten gerekli kırılımı seçebilir; cihaz ve kanal sorusuna gereksiz başka boyutlar eklemek tabloyu büyütür. Satır sınırına ulaşan yanıtın eksiksiz olduğu iddia edilmeden önce raporun kapsamı ve toplulaştırma ihtiyacı yeniden değerlendirilmelidir.
Hata Türüne Göre Müdahale
API belgesinde yetkilendirme, izin, parametre ve istek sınırı için farklı yanıtlar bulunur. Geçersiz belirteç ile kullanım kotasını aşma aynı yeniden deneme davranışıyla çözülmez. Teknik ekip durum kodunu ve ilgili isteğin kapsamını kaydetmelidir. Kota nedeniyle reddedilen isteği kısa aralıklarla tekrar etmek, sorunun nedenini değiştirmez. Kurgusal günlük rapor örneğinde aynı veriyi birçok panelin ayrı ayrı istemesi yerine gerekli çıktının güvenli biçimde paylaşılması düşünülebilir. Bu bir tasarım önerisidir; mevcut mağazada uygulanmış iyileştirme olarak sunulmaz.
Raporun Eksiksizlik Notu
Dışa aktarılan tablonun yanında kullanılan pencere, saat temeli, boyutlar ve olası satır sınırı belirtilmelidir. Bu açıklama alıcıya gösterilen makale yayın tarihi değildir; raporun veri kapsamıdır. Ekip aynı ölçüleri panelle karşılaştırırken filtre ve birimlerin eşleştiğini görmelidir. Sonuç yalnız günlük özet ihtiyacını karşılıyorsa bunun kapsamı korunur. Dışa aktarımın çalışması bütün dönüşümlerin doğru sayıldığı veya hiçbir ziyaretin kaybolmadığı anlamına gelmez; böyle bir iddia için ayrı ölçüm doğrulaması gerekir.
Bu Yazıdaki Terimler 1 Kavram
Kısa açıklamaları burada okuyabilir, ayrıntılar için sözlüğe geçebilirsiniz.
- API
- API (Application Programming Interface), farklı yazılımların birbirleriyle veri alışverişi yapmasını sağlayan bağlantı yöntemidir.
Bu Konuda Nasıl Destek Oluyoruz?
AdPix’in bu alandaki hizmet kapsamını ve çalışma sürecini inceleyin.