تثبيت SDK الجوال

@datacub/react-native مخصص لتطبيقات React Native و Expo. منطقه مختبر بالكامل، وتشغيله على محاكيات Android و iOS في CI لسه نجهّزه. ما يعتمد على أي مكتبة وقت التشغيل، وحجمه تقريبًا 5 كيلوبايت بعد الضغط.

التثبيت

ما انتشر للحين: @datacub/react-native مو موجود على npm، ولا شيء تحت @datacub في npm تابع لـ datacub، فلا تثبّته من هناك. تواصل مع فريق datacub عشان تجربه بدري.

الـ SDK يشتغل مع هذي المكتبات، وتثبّتها بالطريقة المعتادة:

npx expo install @react-native-async-storage/async-storage expo-application

expo-application اختياري في تطبيقات React Native بدون Expo: مرّر قيم app بنفسك (تحت).

التشغيل

App.tsx
import AsyncStorage from '@react-native-async-storage/async-storage'
import * as Application from 'expo-application'
import datacub from '@datacub/react-native'

datacub.init('pk_live_YOUR_PROJECT_KEY', { storage: AsyncStorage, app: Application })

بعدها أضف معرّف تطبيقك (bundle ID في iOS أو package name في Android)، مثل sa.example.shop، إلى التطبيقات المسموح لها بالإرسال في الإعدادات، عام. الأحداث من تطبيق مو في القائمة تنرفض. ومفاتيح pk_test_ تقبل Expo Go وقت التطوير.

الخيارات

الخياروش يسوي
storageوين تنحفظ المعرّفات والأحداث اللي ما انرسلت بين مرات فتح التطبيق: AsyncStorage، أو أي شيء فيه getItem و setItem و removeItem (متزامن أو لا، فيمشي معك غلاف MMKV). بدونه كل فتحة للتطبيق تصير زائر جديد، والأحداث اللي ما انرسلت تضيع إذا انقفل التطبيق
app{ applicationId, nativeApplicationVersion?, nativeBuildVersion? }. و expo-application جاهز بنفس الشكل
apiHostخادم الاستقبال أو البروكسي حقك. الافتراضي https://ingest.datacub.example

في تطبيق بدون expo-application:

import AsyncStorage from '@react-native-async-storage/async-storage'
import datacub from '@datacub/react-native'

datacub.init('pk_live_YOUR_PROJECT_KEY', {
  storage: AsyncStorage,
  app: { applicationId: 'sa.example.shop', nativeApplicationVersion: '2.3.0', nativeBuildVersion: '87' },
})

الشاشات

الشاشات هي مشاهدات الصفحات في التطبيق. أرسل اسم الشاشة أو قالب المسار، وأبد لا ترسل القيم اللي فيه.

App.tsx
import { NavigationContainer, useNavigationContainerRef } from '@react-navigation/native'
import { trackNavigation } from '@datacub/react-native/navigation'

export default function App() {
  const ref = useNavigationContainerRef()
  return (
    <NavigationContainer ref={ref} onReady={() => trackNavigation(ref)}>
      {/* your navigators */}
    </NavigationContainer>
  )
}

نفس الاسم مرتين ورا بعض ينحسب مرة وحدة. والأجزاء اللي تشبه معرّفات أو إيميلات أو أرقام تنستبدل (Product/4512 تصير Product/:id).

وش يسوي بنفسه

  • الجلسات: تنتهي بعد 30 دقيقة بدون نشاط، أو 24 ساعة كحد أقصى، وتستمر بين مرات فتح التطبيق.
  • الإرسال: دفعات كل 10 ثواني أو عند 20 حدث، ولما يروح التطبيق للخلفية. يعيد المحاولة بفواصل متزايدة إذا ما فيه نت. ويقدر ينتظر على الجهاز لين 1,000 حدث.
  • ما فيه أحداث دورة حياة: فتح التطبيق أو تحويله للخلفية ما يرسل شيء، فما تتضخم أرقام المستخدمين النشطين.
  • ما ينرسل أبد: معرّفات الإعلانات، ومعرّفات الجهاز، وموديل الجهاز، وشركة الاتصالات، والموقع، وجهات الاتصال، ومقاس الشاشة، والمنطقة الزمنية.

استدعِ await datacub.flush() إذا تبي ترسل اللي في الطابور الحين، مثلًا قبل ما يخلص اختبار.

النسخ الاحتياطي في Android

النسخ الاحتياطي التلقائي في Android يرجّع بيانات التطبيق على الجوال الجديد، فالتثبيت المسترجع يحتفظ بنفس معرّف الزائر. وغالبًا هو نفس الشخص. إذا تبي كل تثبيت يكون له معرّف خاص، حط android.allowBackup: false في Expo، أو استثنِ قاعدة بيانات AsyncStorage (RKStorage) في dataExtractionRules في التطبيقات بدون Expo.