Lewati ke konten utama

Pelacakan Aplikasi

Tianji menyediakan SDK yang kuat untuk melacak kejadian dan perilaku pengguna dalam aplikasi Anda. Panduan ini menjelaskan cara mengintegrasikan dan menggunakan SDK Pelacakan Aplikasi dalam proyek Anda.

Instalasi​

Pasang SDK Tianji untuk React Native dalam proyek Anda:

npm install tianji-react-native
# atau
yarn add tianji-react-native
# atau
pnpm add tianji-react-native

Inisialisasi​

Sebelum menggunakan fitur pelacakan apa pun, Anda perlu menginisialisasi SDK Aplikasi dengan URL server Tianji dan ID aplikasi Anda:

import { initApplication } from 'tianji-react-native';

initApplication({
  serverUrl: 'https://tianji.example.com',  // URL server Tianji Anda
  applicationId: 'your-application-id'      // Identifier aplikasi Anda
});

Pelacakan Kejadian​

Anda dapat melacak kejadian khusus dalam aplikasi Anda untuk memantau tindakan dan perilaku pengguna:

import { reportApplicationEvent } from 'tianji-react-native';

// Lacak kejadian sederhana
reportApplicationEvent('Button Clicked');

// Lacak kejadian dengan data tambahan
reportApplicationEvent('Purchase Completed', {
  productId: 'product-123',
  price: 29.99,
  currency: 'USD'
});

Pelacakan Layar​

Lacak tampilan layar dalam aplikasi Anda untuk memahami pola navigasi pengguna:

Menetapkan Layar Saat Ini​

Anda dapat menetapkan informasi layar saat ini yang akan disertakan dalam kejadian berikutnya:

import { updateCurrentApplicationScreen } from 'tianji-react-native';

// Perbarui layar saat ini ketika pengguna bernavigasi
updateCurrentApplicationScreen('ProductDetails', { productId: 'product-123' });

Melaporkan Tampilan Layar​

Secara eksplisit melaporkan kejadian tampilan layar:

import { reportApplicationScreenView } from 'tianji-react-native';

// Laporkan tampilan layar saat ini
reportApplicationScreenView();

// Atau laporkan tampilan layar tertentu
reportApplicationScreenView('Checkout', { cartItems: 3 });

Integrasi dengan expo-router​

import { useGlobalSearchParams, usePathname } from 'expo-router'
import { reportApplicationScreenView } from 'tianji-react-native'

function App() {
  const pathname = usePathname()
  const params = useGlobalSearchParams()

  useEffect(() => {
    reportApplicationScreenView(pathname, params)
  }, [pathname, params])
}

Identifikasi Pengguna​

Identifikasi pengguna dalam aplikasi Anda untuk melacak perilaku mereka di berbagai sesi:

import { identifyApplicationUser } from 'tianji-react-native';

// Identifikasi pengguna dengan informasi mereka
identifyApplicationUser({
  id: 'user-123',          // Identifier unik pengguna
  email: '[email protected]',
  name: 'John Doe',
  // Tambahkan properti pengguna lainnya
  plan: 'premium',
  signupDate: '2023-01-15'
});

Referensi API​

initApplication(options)​

Menginisialisasi SDK pelacakan aplikasi.

Parameter:

  • options: ApplicationTrackingOptions

reportApplicationEvent(eventName, eventData?, screenName?, screenParams?)​

Mengirimkan kejadian aplikasi ke server Tianji.

Parameter:

  • eventName: Nama kejadian (maks 50 karakter)
  • eventData: (Opsional) Objek data kejadian
  • screenName: (Opsional) Nama layar untuk mengganti layar saat ini
  • screenParams: (Opsional) Parameter layar untuk mengganti parameter layar saat ini

updateCurrentApplicationScreen(name, params)​

Memperbarui informasi layar aplikasi saat ini.

Parameter:

  • name: Nama layar
  • params: Objek parameter layar

reportApplicationScreenView(screenName?, screenParams?)​

Mengirimkan kejadian tampilan layar ke server Tianji.

Parameter:

  • screenName: (Opsional) Nama layar untuk mengganti layar saat ini
  • screenParams: (Opsional) Parameter layar untuk mengganti parameter layar saat ini

identifyApplicationUser(userInfo)​

Mengidentifikasi pengguna dalam aplikasi.

Parameter:

  • userInfo: Objek data identifikasi pengguna

Batasan Payload​

  • Informasi bahasa: maks 35 karakter
  • Informasi sistem operasi: maks 20 karakter
  • Informasi URL: maks 500 karakter
  • Nama kejadian: maks 50 karakter