README.md

DataArt JavaScript Client

🚀 Proje Hakkında

Bu proje, DataArt platformu için geliştirdiğim JavaScript istemci kütüphanesidir. Kullanıcı davranışlarını ve olayları izlemek, analiz etmek için kolay kullanımlı bir API sunar.

🛠️ Kurulum

NPM veya Yarn kullanarak paketi yükleyebilirsiniz:

# NPM ile
npm install @dataart.ai/dataart-js

# Yarn ile
yarn add @dataart.ai/dataart-js

📝 Kullanım

Temel Kullanım

import DataArt from '@dataart.ai/dataart-js'

const client = new DataArt({
  apiKey: 'YOUR-API-KEY',
  flushInterval: 30 * 1000  // 30 saniye
});

// Olay gönderme
client.emitAction({
  eventKey: 'button_click',
  userKey: 'user123',
  isAnonymousUser: false,
  timestamp: new Date(),
  metadata: {
    buttonName: 'signup',
    pageLocation: 'header'
  }
});

// Kullanıcı tanımlama
client.identify({
  userKey: 'user123',
  metadata: {
    name: 'John Doe',
    age: 28,
    plan: 'premium'
  }
});

React ile Kullanım Örneği

import { useMemo, useCallback } from 'react';
import DataArt from '@dataart.ai/dataart-js'

function AnalyticsComponent() {
  const client = useMemo(() => new DataArt({
    apiKey: 'YOUR-API-KEY',
    flushInterval: 30 * 1000
  }), []);

  const handleButtonClick = useCallback(() => {
    client.emitAction({
      eventKey: 'feature_usage',
      userKey: 'user123',
      isAnonymousUser: false,
      timestamp: new Date(),
      metadata: {
        feature: 'dashboard',
        action: 'export'
      }
    });
  }, [client]);

  return (
    <div className="analytics-wrapper">
      <button onClick={handleButtonClick}>
        Veriyi Dışa Aktar
      </button>
    </div>
  );
}

export default AnalyticsComponent;

🌟 Özellikler

• ✨ Kolay entegrasyon
• 🔄 Otomatik veri senkronizasyonu
• 🛡️ TypeScript desteği
• 📊 Zengin metadata desteği
• 🚀 Yüksek performans
• 💾 Önbellekleme ve toplu gönderim

📚 Dokümantasyon

Daha detaylı bilgi için resmi dokümantasyonu ziyaret edebilirsiniz.

🤝 Katkıda Bulunma

Projeye katkıda bulunmak isterseniz:

1. Bu repo'yu fork edin
2. Yeni bir feature branch oluşturun (git checkout -b feature/amazing-feature)
3. Değişikliklerinizi commit edin (git commit -m 'feat: Add amazing feature')
4. Branch'inizi push edin (git push origin feature/amazing-feature)
5. Pull Request oluşturun

📝 Lisans

Bu proje MIT lisansı ile lisanslanmıştır. Detaylar için LICENSE dosyasına bakabilirsiniz.

---

Geliştirici: Efe Yeniyol
GitHub: github.com/efeyeniyol