# Magic Analytics

**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

Üst paket: [Magic](https://anilcancakir.com/tr/magic/index.md)

## 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

```dart
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'});
}
```

[Dokümanı okuyun: Tek Analytics facade'ı](https://anilcancakir.com/magic/docs/analytics/basics/facade-and-provider.md)

### 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

```dart
Future<void> onTabChanged(String tab) {
  return Analytics.screen('monitor_$tab', location: '/monitors/:id/$tab');
}
```

[Dokümanı okuyun: Kalıba göre sayfa görüntüleme](https://anilcancakir.com/magic/docs/analytics/basics/facade-and-provider.md)

### 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: Web'de GTM, mobilde Firebase](https://anilcancakir.com/magic/docs/analytics/basics/drivers.md)

### 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

```dart
Future<void> restoreOptOut(bool storedOptOut) {
  return Analytics.setOptOut(storedOptOut);
}
```

[Dokümanı okuyun: Reklamlar hep kapalı](https://anilcancakir.com/magic/docs/analytics/basics/consent-and-opt-out.md)

### 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: URL temizleme](https://anilcancakir.com/magic/docs/analytics/guides/url-scrubbing.md)

### 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

```dart
test('creating a monitor sends one event', () async {
  final FakeAnalytics fake = Analytics.fake();

  await Analytics.track('monitor_created');

  fake.assertTracked('monitor_created');
});
```

[Dokümanı okuyun: Property olmadan test](https://anilcancakir.com/magic/docs/analytics/guides/testing.md)

## 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.

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

[diğer editörler](https://github.com/anilcancakir/ai)

## Ü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.

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

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

## 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

```bash
flutter pub add magic_analytics
```

Ya da `pubspec.yaml` dosyasına ekleyin:

```yaml
dependencies:
  magic_analytics: ^1.0.1
```

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

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

## Diğer Magic eklentileri

- [Starter](https://anilcancakir.com/tr/magic/starter/index.md): Kimlik doğrulama, profil, takım ve bildirim ekranları hazır gelir.
- [Payments](https://anilcancakir.com/tr/magic/payments/index.md): Web faturalandırma ile iOS ve Android mağaza satın alması üzerinde tek bir yetki sözleşmesi.
- [Notifications](https://anilcancakir.com/tr/magic/notifications/index.md): Uygulama içi ve OneSignal push bildirimleri, tek bir facade ile.
- [Social Auth](https://anilcancakir.com/tr/magic/social_auth/index.md): Yerel Google (iOS, Android) ve Apple (iOS) girişi, gerisi için tarayıcı akışı.
- [Socket](https://anilcancakir.com/tr/magic/socket/index.md): Gerçek zamanlı yayın: Reverb üzerinde public, private ve presence kanalları.
- [Local Storage](https://anilcancakir.com/tr/magic/local_storage/index.md): Migration, seeder ve factory'lerle SQLite.
- [Deeplink](https://anilcancakir.com/tr/magic/deeplink/index.md): iOS'ta Universal Links, Android'de App Links, tek bir API ile.
- [Picker](https://anilcancakir.com/tr/magic/picker/index.md): Dosya, görsel ya da video seçin, elinize bir MagicFile gelsin.
- [Encryption](https://anilcancakir.com/tr/magic/encryption/index.md): Değerler cihazda AES-256-CBC ile okunamaz halde saklanır.
- [Sentry](https://anilcancakir.com/tr/magic/sentry/index.md): Sentry hata ve performans izleme, hazır bağlı.
- [Device](https://anilcancakir.com/tr/magic/device/index.md): Cihazın prize takılı olup olmadığını ve kullanıcının uzakta olup olmadığını bilin.
- [Devtools](https://anilcancakir.com/tr/magic/devtools/index.md): tapir ve crumbs için Magic'e özgü bağlam; ajan uygulamanızı Magic gibi görür.

## Dokümanlar

### Getting Started

- [Installation](https://anilcancakir.com/magic/docs/analytics/getting-started/installation.md)

### The Basics

- [Facade and Provider](https://anilcancakir.com/magic/docs/analytics/basics/facade-and-provider.md)
- [Drivers](https://anilcancakir.com/magic/docs/analytics/basics/drivers.md)
- [Consent and Opt-Out](https://anilcancakir.com/magic/docs/analytics/basics/consent-and-opt-out.md)

### Guides

- [Testing](https://anilcancakir.com/magic/docs/analytics/guides/testing.md)
- [URL Scrubbing](https://anilcancakir.com/magic/docs/analytics/guides/url-scrubbing.md)
