İçeriğe geç
English

Karşınızda Magic Analytics 1.0.1

Magic uygulamanız için GA4, reklamlar kapalı.

Magic framework için tek bir Analytics facade'ı: web'de kendi alan adınızdan sunulan Google Tag Manager, iOS ve Android'de Firebase. E-postalar ve token'lar hiçbir şey çıkmadan önce temizlenir.

Çalıştığı platformlar

  • Android
  • iOS
  • Web

Tek facade. Her platform.

GA4, Tag Manager ve Firebase; Magic router'ını, kimlik doğrulama durumunu ve route kalıplarınızı bilmez. Magic Analytics bunları bağlar: sayfa görüntülemesi kalıbı taşır, çıkış kullanıcıyı temizler.

Tek Analytics facade'ı

track, identify, setUserProperties ve setDefaultParams tek facade üzerinden çağrı sırasıyla çalışır; bir driver hatası loglanır, arayüz akışına asla fırlatılmaz.

  • Takım bilgileri setDefaultParams'a gider; kümeyi değiştirir ve her olayla gönderilir
  • GA4 sınırını aşan bir çağrı debug'da assert'e takılır, release'te düşürülür
Dokümanı okuyun
Future<void> afterSignIn(String userUuid, String teamPlan) async {
  await Analytics.identify(userUuid);
  await Analytics.setDefaultParams({'team_plan': teamPlan});
  await Analytics.track('monitor_created', {'monitor_type': 'http'});
}

Kalıba göre sayfa görüntüleme

MagicRouter üzerindeki gözlemci her adlandırılmış sayfayı konum olarak route kalıbıyla raporlar; cihazdan kimlik, token ya da e-posta çıkmaz.

  • Her monitör /monitors/:id olarak sayılır, asla /monitors/42 değil
  • Dialog ya da bottom sheet sayfa görüntülemesi değildir; kapatmak da bir şey raporlamaz
Dokümanı okuyun
Future<void> onTabChanged(String tab) {
  return Analytics.screen('monitor_$tab', location: '/monitors/:id/$tab');
}

Web'de GTM, mobilde Firebase

Web, Tag Manager container'ını kendi origin'inizdeki bir yoldan yükler; iOS ve Android Firebase üzerinden gönderir; GTM ya da Firebase kimlikleri yoksa null driver hiçbir şey göndermez.

  • Container hiçbir zaman googletagmanager.com'dan istenmez
  • Firebase web'de hiçbir zaman başlatılmaz
Dokümanı okuyun

Reklamlar hep kapalı

ad_storage, ad_user_data ve ad_personalization her açılışta reddedilir; Analytics.setOptOut cihazdaki geri kalan her şeyi durdurur.

  • Reklam sinyallerini açan hiçbir config anahtarı ya da çağrı yoktur
  • Opt-out bellekte tutulur: saklayın ve ilk sayfa görüntülemesinden önce ayarlayın
Dokümanı okuyun
Future<void> restoreOptOut(bool storedOptOut) {
  return Analytics.setOptOut(storedOptOut);
}

URL temizleme

UrlScrubber, her sayfa konumundaki, başlıktaki ve metin parametresindeki e-posta ve token'ları gönderimden önce maskeler.

  • Anahtarı token, password, email ya da code içeren sorgu değerleri [Filtered] olur
  • identify, scrubber'ın değiştireceği bir kimliği reddeder; e-posta asla kullanıcı kimliği olmaz
Dokümanı okuyun

Property olmadan test

Analytics.fake() gerçek manager'ı kayıt tutan bir driver üzerine bağlar; test yalnızca doğrulamadan, temizlemeden ve opt-out kapısından geçeni görür.

  • assertTracked, assertNotTracked ve assertNothingSent mock kütüphanesi gerektirmez
  • Analytics.fake()'i provider kaydolduktan sonra, testWidgets gövdesinin içinde çağırın
Dokümanı okuyun
test('creating a monitor sends one event', () async {
  final FakeAnalytics fake = Analytics.fake();

  await Analytics.track('monitor_created');

  fake.assertTracked('monitor_created');
});
platform
3
kurulum komutu
2
lisans
MIT

Ajanınız Magic Analytics konuşur.

Magic Analytics skill'i kodlama asistanınıza provider sırasını, gateway'i ve onay kurallarını framework'ün beklediği gibi, ilk satırdan önce öğretir. Tek komut kurar.

npx skills add anilcancakir/ai --skill magic-analytics

projenizde çalıştırın diğer editörler

şunlarla çalışır

  • Claude Code
  • Cursor
  • OpenCode
  • VS Code Copilot
  • Codex CLI

Üstelik dokümanı doğrular.

Skill'ler kurulumu öğretir. mcp.anilcancakir.com/magic_analytics adresindeki MCP sunucusu, ajanınıza düzenleme sırasında canlı doküman araması sağlar; imza uydurmaz.

  • Streamable HTTP

    Tek uç nokta, her istemci.

  • search-docs

    Kaynağa canlı sorgu.

  • Herkese açık

    Salt okunur, ücretsiz.

Editörünüzü bağlayın
mcp.anilcancakir.com/magic_analytics önizleme

# streamable http, varsayılan

claude mcp add --transport http magic_analytics https://mcp.anilcancakir.com/magic_analytics

# veya stdio, http desteklemeyen istemciler için

npx -y mcp-remote https://mcp.anilcancakir.com/magic_analytics

Herkese açık, kimlik doğrulamasız.

Sorular, cevaplar.

Magic Analytics paketini bir Flutter uygulamasına eklemeden önce sorulanlar.

Magic Analytics nedir?

Magic Analytics, Magic uygulamaları için GA4 eklentisidir. Tek bir Analytics facade'ı web'de Google Tag Manager, iOS ve Android'de Firebase üzerinden gönderir, sayfa görüntülemelerini route kalıbıyla raporlar ve her reklam sinyalini kapalı tutar.

Magic Analytics nasıl kurulur?

flutter pub add magic_analytics çalıştırın, ardından dart run magic:dowel plugin:install magic_analytics. Kurulum lib/config/analytics.dart dosyasını yayınlar, AnalyticsServiceProvider'ı kaydeder ve analyticsConfig'i config factory'lerine ekler; native dosya yazmaz ve web sunucunuzu kuramaz.

Magic Analytics hangi platformları destekler?

Google Tag Manager üzerinden web, Firebase üzerinden iOS ve Android. Dart 3.13+, Flutter 3.47+ ve magic ^1.0.0 gerektirir; Firebase web'de hiçbir zaman başlatılmaz.

Magic Analytics GTM ya da Firebase kimlikleri olmadan bir şey gönderir mi?

Hayır. ANALYTICS_ENABLED true, 1 ya da yes değilse provider hiçbir şey göndermeyen null driver'ı bağlar; web driver'ı ayrıca hem GTM_CONTAINER_ID hem GTM_GATEWAY_PATH ister.

Magic Analytics reklam sinyallerini açabilir mi?

Hayır. ad_storage, ad_user_data ve ad_personalization her açılışta, her platformda reddedilir; hiçbir config anahtarı ya da çağrı bunları açmaz. Analytics depolaması varsayılan olarak açıktır; toplamayı cihazın opt-out'u durdurur.

Magic Analytics yapay zeka kodlama ajanlarıyla çalışır mı?

Evet. Magic Analytics, asistanınıza provider sırasını, kimlik ve varsayılan parametre kurallarını ve onay kurulumunu öğreten bir ajan skill'i ve canlı arama için herkese açık bir doküman MCP sunucusu sunar.

Magic Analytics açık kaynak mı?

Evet. Magic Analytics, MIT lisansıyla açık kaynaktır.

Saniyeler içinde ekleyin

~/my_app
flutter pub add magic_analytics

Ya da pubspec.yaml dosyasına ekleyin:

dependencies:
  magic_analytics: ^1.0.1

Ya da yapay zeka ajanınıza şu istemi verin:

https://anilcancakir.com/magic/docs/analytics/llms.txt adresini oku ve Magic Analytics paketini bu projeye kur.