Analytics Operasyonları İçin Dokümantasyon ve Knowledge Base Yapısı

Analytics Operasyonları İçin Dokümantasyon ve Knowledge Base Yapısı

9 dk okuma19 Haziran 2026DGTLFACE Editorial

Sosyal medya analitiği büyüdükçe “rapor üretmek”ten daha zor bir şey ortaya çıkar: aynı raporu aynı şekilde okumak. Bir ekip “lead” derken form gönderimini, diğeri WhatsApp tıklamasını anlıyorsa; bir raporda paid_social direct altında akıyorsa; Tag Manager değişikliği sonrası event kırıldı ama kimse fark etmediyse… en iyi dashboard bile güven kaybeder. Bu yüzden “analytics ops” sadece panel yapmak değil, paneli yaşatan bir dokümantasyon ve governance sistemi kurmaktır. Bu rehber; KPI sözlüğü, dashboard rehberleri, UTM/channel mapping ve changelog’u tek bir knowledge base (wiki) yapısında toplayarak “tek veri gerçekliği” yaratmanın pratik yolunu anlatır.

Öne Çıkan Cevap

Sosyal medya analitiği büyüdükçe KPI tanımları, dashboard’lar, UTM şemaları ve tracking değişiklikleri hızla karmaşıklaşır. Analytics dokümantasyonu ve knowledge base; “veri nasıl okunur, neye güvenebiliriz?” sorularına tek yerden cevap vererek tutarlılık ve hız sağlar. Doğru yapı; KPI definition sözlüğü (ne, nasıl hesaplanır, hangi kaynak), dashboard kullanım rehberleri, UTM/channel mapping dokümanı ve tracking/event değişiklikleri için changelog kayıtlarını içerir. Güncel tutulmazsa yanlış karar riski büyür.

Özet

Analytics knowledge base; KPI sözlüğü + dashboard rehberi + UTM/mapping + changelog’dan oluşur. Amaç tek veri gerçekliği: herkes aynı KPI’yı aynı tanımla okur, karar hızlanır.

Maddeler

  • Hedef kitle: TR geneli otel grupları, ajanslar ve B2B analytics ekipleri
  • KPI çekirdeği: KPI dictionary + dashboard rehberleri + UTM/channel mapping + changelog
  • Entity theme: KPI, dashboard, UTM, tracking, changelog, governance
  • Model: analytics ops & governance → shared understanding → hızlı onboarding
  • Risk: güncellenmeyen doküman = yanlış karar + güven kaybı
  • Çıktı: knowledge base şeması + KPI sözlüğü tablosu + dokümantasyon checklist’i
  • Başarı ölçümü: onboarding hızlanır, KPI tartışmaları nesnelleşir

Kısa Cevap

KPI’ları standardize etmek için KPI sözlüğü, UTM/mapping ve changelog içeren tek bir analytics wiki kurun.

Hızlı Özet

  • 1) Analytics dokümantasyonunu rapor güvenilirliğinin sigortası olarak kur
  • 2) KPI sözlüğüyle her metriğin tanımını, hesabını, kaynağını ve sahibini netleştir
  • 3) Dashboard rehberleriyle rol bazlı okuma ve aksiyon sistemini standartlaştır
  • 4) UTM/channel mapping ile paid, organic ve kampanya kaynaklarını tek gerçekliğe bağla
  • 5) Changelog ile tracking, KPI ve dashboard değişikliklerini yaşayan sistem olarak takip et

1. Neden analytics dokümantasyonu?

Analytics dokümantasyonu “ekstra iş” gibi görünür; ama aslında raporun güvenilirliğini ve karar hızını koruyan sigortadır. Özellikle ajanslarda ekip değişimi, otel gruplarında marka/otel sayısının artması ve B2B’de pipeline tanımlarının evrilmesiyle “kafadaki bilgi” hızla kırılır.

Analytics dokümantasyonu neden gerekli?

Çünkü KPI tanımı, kanal mapping ve event yapısı değiştikçe raporun anlamı da değişir. Dokümantasyon yoksa ekipler farklı KPI tanımıyla karar verir ve aynı grafikten farklı sonuç çıkarır. Merkezi knowledge base; KPI sözlüğü, mapping ve changelog ile “hangi veri doğrudur?” sorusuna tek cevap üretir ve onboarding’i hızlandırır.

Mini Check

  • KPI’lar ekip içinde farklı mı yorumlanıyor?
  • Yeni gelen biri “hangi dashboard ne işe yarar?” sorusunu 10 dakikada bulabiliyor mu?
  • Tracking değişiklikleri “kimin aklında” kalıyor?

Ne yapmalıyım?

  • Tek bir “analytics wiki” alanı aç
  • KPI sözlüğünü ilk doküman olarak zorunlu kıl
  • Her tracking değişikliğine changelog şartı getir
Tek veri gerçekliği, KPI standardizasyonu, analytics ops kültürü, ekip uyumu
Tek veri gerçekliği, KPI standardizasyonu, analytics ops kültürü, ekip uyumu

2. KPI tanım sözlüğü (KPI Dictionary)

KPI sözlüğü, knowledge base’in çekirdeğidir. “Ne ölçüyoruz?” kadar “nasıl hesaplıyoruz?” sorusunu da kilitler. İyi bir sözlük, rapor tartışmasını “yorum”dan çıkarıp “tanım”a taşır.

KPI definition sözlüğü nasıl hazırlanır?

Her KPI için şu alanları standart doldurun:

  • KPI adı: tek ve kısa
  • Tanım: iş diliyle 1 cümle
  • Hesaplama: formül veya event mantığı
  • Kaynak: GA4 / platform insights / CRM
  • Segment: organic/paid, platform, ülke (Varsayım)
  • Sahip: kim sorumlu?
  • Not: değişiklik ve istisna

Mini Check

  • “Lead” tanımı tek mi?
  • “Engagement rate” reach bazlı mı, impression bazlı mı?
  • KPI’nın kaynağı ve event adı yazılı mı?

Ne yapmalıyım?

  • İlk 15 KPI ile başla (fazlası sonra)
  • KPI’ları “core” ve “advanced” diye ayır
  • Her değişiklikte sözlüğü güncelle ve sürümle (v1.0 → v1.1)
Tablo: KPI dictionary örnek tablosu
KPITanımHesaplamaKaynakScopeSahipSon güncelleme
LeadSatışa aday aksiyonform_submit + WA_click (varsayım)GA4+CRMpaid+organic________
Engagement RateEtkileşim/erişim(engagement / reach)Platformorganic________

3. Dashboard ve rapor rehberleri (Nasıl okunur?)

Dashboard rehberi, “panel var ama kimse bakmıyor” sorununu çözer. Her panelin amacı, kimin baktığı ve hangi kararı desteklediği yazılı değilse ekipler dashboard’u yanlış beklentiyle açar.

Dashboard rehberi içeriği (minimum)

  • Dashboard adı + link (Varsayım)
  • Amaç: hangi soruyu cevaplar?
  • Hedef rol: CEO / pazarlama / içerik / İK (Varsayım)
  • Okuma sırası: 1–2–3 adım
  • Sık hata: yanlış yorum örnekleri
  • “Ne yapmalıyım?”: tipik aksiyonlar

Mini Check

  • Dashboard’lar rol bazlı mı?
  • Her panelin “okuma sırası” var mı?
  • Yanlış yorumlara karşı not kutusu var mı?

Ne yapmalıyım?

  • CEO paneli için 1 sayfalık okuma kılavuzu yaz
  • İçerik paneli için “top 10 / zayıf 10” standartlaştır
  • Her panelin sonuna “aksiyon backlog” linki koy
Dashboard rehberi ve rol bazlı okuma, analytics ops standardı, karar akışı
Dashboard rehberi ve rol bazlı okuma, analytics ops standardı, karar akışı

4. UTM ve kanal mapping dokümanı (tek gerçeklik)

Sosyal medya raporlarında en pahalı hata “yanlış kanal ataması”dır. UTM ve channel mapping dokümanı; paid_social/organic_social ayrımını, campaign naming standardını ve GA4 kanal gruplamasını tekleştirir.

UTM ve kanal mapping dokümanını nasıl tutarım?

  • UTM sözlüğü yaz: utm_source, utm_medium, utm_campaign, utm_content
  • Allowed values (izinli değerler) tanımla: paid_social / organic_social vb.
  • GA4 channel grouping ile eşleştir
  • Örnek link şablonları ver
  • Kampanya naming standardını zorunlu kıl (YYYYMM_kampanyaadi)
  • Değişiklikleri changelog’a bağla

Mini Check

  • UTM medium değerleri ekipte herkes için aynı mı?
  • Campaign isim standardı var mı?
  • GA4’te social trafik “direct” altında mı birikiyor? (Varsayım)

Ne yapmalıyım?

  • UTM sözlüğünü knowledge base’in “zorunlu” sayfası yap
  • Kampanya açılmadan önce UTM checklist’i çalıştır
  • Mapping değiştiğinde dashboard notunu güncelle
UTM channel mapping akışı, KPI sözlüğüyle tek gerçeklik, SMM analytics governance
UTM channel mapping akışı, KPI sözlüğüyle tek gerçeklik, SMM analytics governance

5. Değişiklik (changelog) kayıtları (tracking ve KPI evrimi)

Analytics ops’un en kritik “yaşayan” parçası changelog’dur. Çünkü KPI tanımı veya event değiştiğinde trend grafikleri “aynı şey”i göstermemeye başlar. Changelog yoksa ekip yanlış alarm üretir.

Changelog’da ne olmalı?

  • Tarih
  • Ne değişti? (UTM, event, dashboard, KPI tanımı)
  • Etkilenen raporlar/paneller
  • Beklenen etki (kısa)
  • Sahip / onaylayan
  • Geri dönüş planı (Varsayım)

Teknik not (kritik): Dokümantasyon yaşayan bir sistemdir. Güncellenmeyen KPI tanımları ve UTM şemaları zamanla yanlış karar ve güven kaybına yol açar; bu nedenle changelog ve periyodik temizlik (deprecated sayfaları kaldırma) şarttır.

Mini Check

  • Tag Manager deploy sonrası event testi kayıt altına alınıyor mu?
  • KPI tanımı değişince eski rapor notlanıyor mu?
  • Changelog okunmadan trend yorumu yapılıyor mu?

Ne yapmalıyım?

  • “Değişiklik yapıldıysa changelog zorunlu” kuralı koy
  • Aylık: changelog review + deprecated temizlik
  • Büyük değişiklikte: rapor üstüne “kırılma notu” ekle
Tracking changelog ve governance, event değişiklikleri, sürdürülebilir raporlama
Tracking changelog ve governance, event değişiklikleri, sürdürülebilir raporlama

6. Otel ve B2B için analytics knowledge base örnek yapıları

Knowledge base’in yapısı sektöre göre küçük farklar gösterir ama ana başlıklar aynıdır.

Otel için örnek wiki yapısı

  • KPI Dictionary (rezervasyon niyeti, WhatsApp/telefon click, teklif sayfası KPI’ları)
  • Kanal mapping (seasonality notları dahil)
  • Dashboard rehberleri (GM/gelir yönetimi vs içerik ekibi)
  • Changelog (PMS/rezervasyon event değişimleri)

B2B için örnek wiki yapısı

  • KPI Dictionary (lead→MQL→SQL tanımları)
  • CRM source/campaign mapping (Varsayım)
  • Dashboard rehberleri (sales + marketing ortak dili)
  • Changelog (form event ve pipeline değişimleri)

Key Statistics / Data Point (sheet’ten, yumuşatılmış): İyi dokümante edilmiş analytics süreçlerine sahip ekiplerde yeni çalışan/ajans onboarding’i daha hızlı olur; KPI tartışmaları ise daha nesnel ve verimli ilerler. Bu, raporun “kullanılma” oranını da artırır.

Mini Check

  • Otelde sezon notları ve event tanımları wiki’de var mı?
  • B2B’de pipeline tanımları KPI sözlüğüne yazıldı mı?
  • Wiki sahipliği ve güncelleme ritmi var mı?

Ne yapmalıyım?

  • Knowledge base’e bir “owner” ata (analytics ops owner)
  • Aylık “doc review” ritmi koy (30 dk)
  • En çok sorulan 10 soruyu wiki’ye çevir (SSS mantığı)
Analytics dokümantasyon checklist’i, KPI sözlüğü ve changelog, ekip standardı
Analytics dokümantasyon checklist’i, KPI sözlüğü ve changelog, ekip standardı
KPI dictionary kartları, tanım ve hesaplama, otel ve B2B rapor tutarlılığı
KPI dictionary kartları, tanım ve hesaplama, otel ve B2B rapor tutarlılığı
Knowledge base teslim paketi, wiki şeması ve doküman seti, DGTLFACE
Knowledge base teslim paketi, wiki şeması ve doküman seti, DGTLFACE
Media bulunamadı → slug: analytics-operasyonlari-icin-dokumantasyon-ve-knowledge-base-yapisi / slot: knowledge-base-schema

7. Sosyal Medya Analytics KPI Sözlüğü & Changelog Şablonunu İndir

TEMPLATEv1.0Checklist + Sprint

Sosyal Medya Analytics KPI Sözlüğü & Changelog Şablonu — Analytics Ops (v1.0)

Bu şablon, SMM analytics operasyonunu ölçeklemek için gerekli iki ana dokümanı tek formatta toplar: KPI definition sözlüğü ve tracking/dashboard changelog kayıtları. UTM/channel mapping bölümüyle “tek veri gerçekliği”ni destekler; onboarding’i hızlandırır ve KPI tartışmalarını nesnelleştirir. Yaşayan sistem mantığıyla sürümleme ve temizlik (deprecated) adımlarını zorunlu tutar.

Kim Kullanır?

Büyüyen otel grupları, ajanslar ve B2B markalarda analytics owner, SMM lead ve performance ekipleri.

Nasıl Kullanılır?

  1. İlk 15 KPI’yı sözlüğe girip kaynak ve hesaplamayı kilitleyin.
  2. UTM/mapping sözlüğünü ekleyip izinli değerleri yayınlayın.
  3. Her tracking/dashboard değişikliğini changelog’a kaydedip aylık “doc review” ile güncelleyin.

Ölçüm & Önceliklendirme (Kısa sürüm)

  • ▢ ✅ KPI tanımları tek sözlükte
  • ▢ ✅ UTM/mapping izinli değerleri yayınlandı
  • ▢ ✅ Changelog zorunlu kuralı var
  • ▢ ✅ Aylık doc review yapılıyor
  • ▢ ✅ Eski/yanlış tanımlar temizleniyor

PDF içinde: Problem→Kök Neden→Çözüm tablosu + 14 gün sprint planı + önce/sonra KPI tablosu

Şablonu İndir Ücretsiz • PDF / Excel

8. Sonuç: Analytics ops, tek veri gerçekliğiyle çalışır

Sosyal medya analitiğinde rapor üretmek kadar önemli olan şey, raporu herkesin aynı tanımla okuyabilmesidir. KPI sözlüğü, dashboard rehberleri, UTM/channel mapping ve changelog bu ortak dili kurar.

Knowledge base yaşayan bir sistem olarak yönetildiğinde onboarding hızlanır, KPI tartışmaları nesnelleşir ve dashboard güveni artar. Güncellenmeyen dokümantasyon ise zamanla yanlış karar ve güven kaybı üretir.

Bir Sonraki Adım

KPI sözlüğü, mapping ve changelog ile ekipte tek veri gerçekliği kurar; otel ve B2B ekipleri için.

Sık Sorulan Sorular

Analytics dokümantasyonu neden gerekli?
KPI tanımları, mapping ve event’ler değiştikçe raporların anlamı kayar. Dokümantasyon, “hangi veri doğrudur?” sorusuna tek yerden cevap vererek tutarlılığı ve karar hızını korur; onboarding’i hızlandırır.
KPI definition sözlüğü nasıl hazırlanır?
Her KPI için tanım, hesaplama yöntemi, veri kaynağı, scope (paid/organic/platform), sahip ve not alanlarını standart doldurun. İlk 15 KPI ile başlayıp sürümleyin (v1.0→v1.1).
UTM ve kanal mapping dokümanını nasıl tutarım?
UTM alanları için izinli değer sözlüğü oluşturun, campaign naming standardı belirleyin ve GA4 channel grouping ile eşleştirin. Mapping değiştiğinde changelog kaydı ve dashboard notu ekleyin.
Tracking değişikliklerini neden mutlaka changelog’a yazmalıyım?
Çünkü trend grafikleri, tanım veya event değiştiğinde aynı şeyi göstermemeye başlar. Changelog yoksa ekip yanlış alarm üretir, kararlar hatalı olur ve dashboard’a güven düşer.
Knowledge base yapısı nasıl kurulmalı?
Minimum yapı: KPI sözlüğü, dashboard rehberleri, UTM/channel mapping ve changelog. Üstte “Sık Sorulanlar”, altta “Sürüm/Temizlik” bölümü ekleyin ve bir owner ile aylık review ritmi tanımlayın.
Dokümantasyon güncellenmezse ne olur?
Eski KPI tanımları ve mapping’ler yanlış karar üretir; ekipler aynı KPI için farklı sonuçlar görür ve güven kaybı oluşur. Dokümantasyon yaşayan sistem olarak ele alınmalı ve periyodik temizlenmelidir.
SMM Analytics Dokümantasyonu: KPI Sözlüğü ve Changelog | DGTLFACE