تثبيت 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-applicationexpo-application اختياري في تطبيقات React Native بدون Expo: مرّر قيم app بنفسك (تحت).
التشغيل
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' },
})الشاشات
الشاشات هي مشاهدات الصفحات في التطبيق. أرسل اسم الشاشة أو قالب المسار، وأبد لا ترسل القيم اللي فيه.
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>
)
}import { Slot, useSegments } from 'expo-router'
import { useEffect } from 'react'
import datacub from '@datacub/react-native'
export default function RootLayout() {
const segments = useSegments()
// the route template (/profile/[user]), never the path with values (/profile/sara)
useEffect(() => datacub.screen(segments.join('/') || 'index'), [segments])
return <Slot />
}import datacub from '@datacub/react-native'
datacub.screen('Checkout')نفس الاسم مرتين ورا بعض ينحسب مرة وحدة. والأجزاء اللي تشبه معرّفات أو إيميلات أو أرقام تنستبدل (Product/4512 تصير Product/:id).
وش يسوي بنفسه
- الجلسات: تنتهي بعد 30 دقيقة بدون نشاط، أو 24 ساعة كحد أقصى، وتستمر بين مرات فتح التطبيق.
- الإرسال: دفعات كل 10 ثواني أو عند 20 حدث، ولما يروح التطبيق للخلفية. يعيد المحاولة بفواصل متزايدة إذا ما فيه نت. ويقدر ينتظر على الجهاز لين 1,000 حدث.
- ما فيه أحداث دورة حياة: فتح التطبيق أو تحويله للخلفية ما يرسل شيء، فما تتضخم أرقام المستخدمين النشطين.
- ما ينرسل أبد: معرّفات الإعلانات، ومعرّفات الجهاز، وموديل الجهاز، وشركة الاتصالات، والموقع، وجهات الاتصال، ومقاس الشاشة، والمنطقة الزمنية.
استدعِ await datacub.flush() إذا تبي ترسل اللي في الطابور الحين، مثلًا قبل ما يخلص اختبار.
النسخ الاحتياطي في Android
النسخ الاحتياطي التلقائي في Android يرجّع بيانات التطبيق على الجوال الجديد، فالتثبيت المسترجع يحتفظ بنفس معرّف الزائر. وغالبًا هو نفس الشخص. إذا تبي كل تثبيت يكون له معرّف خاص، حط android.allowBackup: false في Expo، أو استثنِ قاعدة بيانات AsyncStorage (RKStorage) في dataExtractionRules في التطبيقات بدون Expo.