Açık kaynak · MIT · Analitik İşler

Yeniv0.8.0 npm'de yayında: @analitikisler/ai-tag-debugger →

AI Tag Debugger ile analitik ve reklam tag’lerinizi otomatik test edin. Açık kaynak.

Yapay zekâ sitenizde gerçek bir ziyaretçi gibi gezinir. GA4, Google Ads, Meta ve TikTok'a giden her istek, ölçümleme planınıza ve Consent Mode ayarlarınıza göre kontrol edilir. Terminalden, her deploy sonrasında CI'da ya da yapay zekâ asistanınızdan çalıştırabilirsiniz.

Kurulum

$ npm install -g @analitikisler/ai-tag-debugger

$ npx -y @analitikisler/ai-tag-debugger run --site https://staging.yourshop.com --journey add_to_cart

"ai-tag-debugger": { "command": "npx", "args": ["-y", "@analitikisler/ai-tag-debugger", "mcp"] }

Node 20 ve üstü gerekir. Ücretsiz, MIT lisanslı.Sonra hızlı başlangıca geçin →

Kullandığınız tag’leri kontrol eder

GA4Google AdsMeta PixelTikTok PixelX Pixel

LinkedInMicrosoft AdsPinterestSnapchatClarityHotjarDoubleClickAdSense

İstediklerinizi --providers ile seçebilirsiniz.

Gerçek bir test

Üç hatayı bilerek bıraktık. Tek komut hepsini buldu.

Bilinen ölçümleme hatalarıyla bir demo mağaza hazırladık ve iki senaryoyu masaüstünde ve mobilde çalıştırdık. Bu testte yapay zekâ kullanılmadı, sadece kurallar çalıştı. Yani herkes ücretsiz tekrarlayabilir.

~/demo-shop · ai-tag-debugger

$ ai-tag-debugger run --config examples/demo.config.json --scripted --no-ai ▶ checkout (mobile)  Accept cookies  Open the first product  Add to cart  Open the cart  Go to checkout  …  Place the order  ✓ All scripted steps completed. · 20 tracking hits captured ✗ broken   GA4 purchase sent without currency, value (mobile)✗ broken   Meta Purchase sent without value, currency (mobile)! risk     Meta PageView fired before the visitor accepted cookies! warning  add_to_cart sent 2 times by one action 2 broken · 1 risk · 1 warning · 4 okReport: reports/demo/report.html

Bulgular

bozuk

risk

uyarı

tamam

purchase mobilde GA4 ve Meta'ya value ve currency olmadan gitti
PageView çerez onayı verilmeden Meta'ya gitti
add_to_cart tek tıklamada iki kez gitti

2 senaryo · masaüstü ve mobil · 0 model çağrısıKendiniz deneyin →

Nasıl çalışır

Dört adım, tek komut. Yapay zekâ gezinir ve açıklar. Kontrolleri kurallar yapar.

Gezinme

Ödeme adımlarını elle tıklamak yerine

Yapay zekâ, tek cümleyle verdiğiniz hedefi takip eder. İsterseniz model kullanmadan kayıtlı adımları tekrar oynatır.

--journey purchase

Kayıt

Network sekmesini tek tek taramak yerine

Her istek ve her dataLayer push’u, hangi adımda oluştuğuyla birlikte kaydedilir. Test istekleri gerçek hesaplarınıza gitmez.

--providers ga4,meta,tiktok

Kontrol

Beklenen event’leri tabloda takip etmek yerine

Kurallar istekleri ölçümleme planınızla karşılaştırır: eksik event ve parametreler, tekrar eden event’ler, çerez onayı ve kişisel veri.

--events purchase,add_to_cart

Açıklama

Hata kaydını kendiniz yazmak yerine

Yapay zekâ her sorunun olası nedenini ve çözümünü Türkçe ya da İngilizce yazar.

--lang tr

Hızlı başlangıç

Kurulumdan rapora beş komutla.

~/my-shop · kurulum

$ npm install -g @analitikisler/ai-tag-debugger
$ npx -y playwright@1.56.1 install chromium

Node 20 ve üstünde çalışır. Testleri Playwright ile gerçek bir Chromium tarayıcısında yapar.

Rapor

Her istek, her adım. En önemli sorun en üstte.

Dört sekmeli tek bir HTML dosyası: Genel bakış, Bulgular, Yolculuklar, Kapsam ve plan. Geliştiriciye ya da müşterinize gönderebilirsiniz. Sunucu gerekmez, içinde script çalışmaz.

reports/demo/report.html#journeys

AI Tag Debugger raporunun Yolculuklar sekmesi: solda adımlar, sağda seçili adımın event’leri. Meta PageView, çerez onayından önce gittiği için işaretlenmiş.

Demo raporun tamamını açın →

her adımda sekme: Event, dataLayer, Network

seçilebilir platform

hazır senaryo

gerçek reklam hesaplarınıza giden test isteği

report.htmlÖzet, nedeni ve çözümüyle bulgular, tüm zaman akışı
timeline.csvHer istek bir satır, Excel ya da Google Sheets için
report.mdPull request yorumu için
capture.jsonYakalanan tüm veriler, kendi analiziniz için
[redacted]E-posta, telefon ve kullanıcı kimlikleri kaydedilmeden önce gizlenir

AI asistanlar

Ölçümleme kontrolünü yapay zekâ asistanınıza bırakın. API anahtarı gerekmez.

AI Tag Debugger aynı zamanda bir MCP sunucusu. Yani Claude, ChatGPT, Gemini gibi MCP destekleyen asistanlarla çalışır. Tarayıcıyı asistanın kendi modeli kullanır ve bulguları sohbette anlatır.

{
  "mcpServers": {
    "ai-tag-debugger": {
      "command": "npx",
      "args": ["-y", "@analitikisler/ai-tag-debugger", "mcp"]
    }
  }
}

{
  "mcpServers": {
    "ai-tag-debugger": {
      "command": "npx",
      "args": ["-y", "@analitikisler/ai-tag-debugger", "mcp"]
    }
  }
}

# Bu komutu çalıştıran bir MCP sunucusu ekleyin
npx -y @analitikisler/ai-tag-debugger mcp

# Tarayıcıyı bir kez kurun
npx -y playwright@1.56.1 install chromium

# 1. Bilgisayarınızdaki portu internete açın
cloudflared tunnel --url http://localhost:8787

# 2. Sunucuyu HTTP modunda başlatın
npx -y @analitikisler/ai-tag-debugger mcp --http --port 8787 \
  --public-url https://<tunel-adresiniz>

# 3. Çıkan /mcp/<gizli> adresini connector olarak ekleyin

export ANTHROPIC_API_KEY=...   # ya da OPENAI_API_KEY, GEMINI_API_KEY

ai-tag-debugger run --site https://staging.magazaniz.com \
  --journey purchase --viewport mobile --lang tr

# Mistral, DeepSeek, Groq, OpenRouter, kendi Ollama kurulumunuz...
ai-tag-debugger run --provider openai-compatible \
  --base-url http://localhost:11434/v1 --model qwen3 ...

Analitik İşler Cloud

AI Tag Debugger sizin yerinize çalışsın. Düzenli aralıklarla ve her sürümden sonra.

AI Tag Debugger ücretsiz ve açık kaynak olarak kalacak. Analitik İşler Cloud ise onun üzerine kurulu, bizim yönettiğimiz hizmet: geçmiş raporlar, uyarılar ve tüm siteleriniz tek yerde.

	AI Tag DebuggerAçık kaynak · Ücretsiz	Analitik İşler CloudHazır hizmet · Bize ulaşın
Test
Yapay zekâlı ya da sadece kurallarla test	✓	✓
Ölçümleme planı ve çerez onayı kontrolleri	✓	✓
Türkçe ya da İngilizce rapor	✓	✓
Çalıştırma
Her deploy sonrası	Kendi CI sisteminiz (GitHub Actions örneği var)	✓ Deploy webhook’u
Düzenli aralıklarla	—	✓
ChatGPT ya da Gemini’den	Kendi tüneliniz	✓ Hazır MCP adresi
Ekipler ve ajanslar
Test geçmişi ve uyarılar	—	✓
Tüm müşteri siteleri tek yerde	—	✓
Consent Check ve ölçümleme planı taslakları	—	Geliştiriliyor

Cloud erişimi isteyinya da e-posta gönderin: hello@analitikisler.com

Bir sonraki sürümden önce staging sitenizde deneyin.

$ npx -y @analitikisler/ai-tag-debugger run --site https://staging.yourshop.com --journey purchase

Hızlı başlangıç Cloud erişimi isteyin