Microsoft Clarity Entegrasyonu

Microsoft Clarity, 31 Ekim 2025 itibarıyla Avrupa Ekonomik Alanı (EEA), Birleşik Krallık (UK) ve İsviçre (CH) bölgelerindeki ziyaretçiler için geçerli bir rıza sinyali (consent signal) gerektirmeye başlayacaktır. Bu entegrasyon sayesinde Microsoft Clarity izleme kodunu Efilli CMP üzerinden yönetebilir ve Clarity’nin yalnızca kullanıcı rızası alındıktan sonra veri toplamasını sağlayabilirsiniz.

Aşağıdaki adımları takip ederek Microsoft Clarity entegrasyonunu kolayca aktif edebilirsiniz.

---

1. Tasarım Editörüne Giriş

1. Efilli paneline giriş yapın.

2. Sol menüden “Domainler” sekmesine tıklayın.

3. İşlem yapmak istediğiniz domaini seçin.

4. Domain kartındaki “Tasarım Editörü” butonuna tıklayın.

5. Düzenleme yapmak istediğiniz banner katmanını seçin.

   • Eğer birden fazla dil yapılandırmanız varsa, bu adımı her dil banner’ı için tekrarlamanız gerekir.

---

2. Microsoft Clarity Ayarlarını Düzenleme

1. Banner katmanı içinde “Banner Ayarları” sekmesine tıklayın.

2. Açılan menüden “Microsoft Clarity Ayarları”nı seçin.

3. Açılan pencerede bir adet açma/kapama düğmesi ve iki adet Microsoft Clarity sinyali ile bu sinyallerin hangi rıza kategorisiyle eşleştiği görünecektir.

4. Açma/kapama düğmesini “ON” konumuna getirin.

5. Buradaki eşleştirmelerde ad_Storage sinyali Pazarlama kategorisi ile, analytics_Storage sinyali Analitik kategorisi ile eşleştirilmelidir.

Bu adım, Efilli CMP’nin kullanıcı rızasını Clarity’ye iletebilmesi için zorunludur.

---

3. Microsoft Clarity Panelinde Yapılması Gereken Ayar

Entegrasyonu tamamlamak için Microsoft Clarity hesabınıza giriş yapmanız gerekir.

1. Clarity hesabınıza giriş yapın.

2. Sol menüden “Setup” sekmesine tıklayın.

3. “Cookies” ayarını bulun ve “OFF” konumuna getirin.

Bu işlem, Clarity’nin kendi tarafında çerezleri otomatik olarak kurmasını engeller. Böylece çerez kurulumu yalnızca kullanıcı Efilli CMP üzerinden onay verdiğinde gerçekleşir.

---

4. Daha Önce Yapılmış Clarity Kurulumları

a. Clarity daha önce Efilli tarafından otomatik engellendiyse

Efilli destek ekibi tarafından Clarity, otomatik engelleme kurallarından çıkarılacaktır. Bu işlem için müşteri destek ekibimiz ile iletişime geçiniz.

b. Clarity, Google Tag Manager (GTM) üzerinden eklenmişse

• Efilli ekibinin GTM erişimi varsa, Clarity etiketi GTM’den kaldırılır.

• Efilli’nin GTM erişimi yoksa, müşteri bu işlemi kendisi yapmalıdır. GTM hesabınızda bulunan “Microsoft Clarity” etiketi veya tetikleyicisini kaldırın.

Bu adım, Clarity’nin birden fazla kez yüklenmesini önler.

---

5. Entegrasyonun Doğrulanması

Entegrasyonun doğru çalıştığını kontrol etmek için şu adımları izleyin:

1. Web sitenizi açın ve herhangi bir rıza vermeden tarayıcı konsolunu açın.

2. Aşağıdaki komutu çalıştırın:

   clarity('metadata', (d, u, consent) => { console.log('consentStatus:', consent); }, false, true, true);

3. Onay vermeden önce aşağıdaki çıktıyı görmelisiniz:

   { analytics_storage: "DENIED", ad_storage: "DENIED" }

4. Efilli banner’ı üzerinden onay verdikten sonra aynı komutu tekrar çalıştırın. Aşağıdaki çıktıyı görmelisiniz:

   { analytics_storage: "GRANTED", ad_storage: "GRANTED" }

Bu değerler doğru görünüyorsa, entegrasyon başarıyla tamamlanmıştır.

---

6. Bilinen Durum: GraphQL Hatası

Clarity bazen “GraphQL Error” hatası gösterebilir. Bu durum Efilli kaynaklı değildir. Sayfayı yenilediğinizde veya yeniden giriş yaptığınızda hata otomatik olarak gider.

---

Bu adımları tamamladıktan sonra Microsoft Clarity, yalnızca kullanıcı rızası verildiğinde çalışacak şekilde yapılandırılmış olur.