Μετάβαση στο κύριο περιεχόμενο

Επισκόπηση προγραμματιστών

Καλώς ήρθατε στην τεκμηρίωση προγραμματιστών του Joryio. Αυτός ο οδηγός θα σας βοηθήσει να ενσωματώσετε το Joryio στις εφαρμογές σας.

Τι μπορείτε να δημιουργήσετε;​

Με την πλατφόρμα προγραμματιστών του Joryio, μπορείτε να:

  • Παρακολουθείτε τη συμπεριφορά χρηστών σε web, iOS και Android
  • Διαχειρίζεστε προφίλ χρηστών και γνωρίσματα προγραμματιστικά
  • Στέλνετε προσαρμοσμένα συμβάντα για τμηματοποίηση και αναλυτικά στοιχεία
  • Ενσωματώνεστε με webhooks για ειδοποιήσεις συμβάντων σε πραγματικό χρόνο
  • Ενεργοποιείτε καμπάνιες μέσω API
  • Υποβάλλετε ερωτήματα σε δεδομένα αναλυτικών για προσαρμοσμένα dashboards

Αρχιτεκτονική πλατφόρμας​

Data in
Your appsSDK keys
Web · iOS · Android · React Native
Your backendAPI keys
REST API
Store platforms
Shopify · WooCommerce · Magento
Bulk import
CSV · JSON
Warehouse sync
Snowflake · BigQuery
Joryio platform
Joryio
Profiles & events
Segments
Journeys (Canvas)
Campaigns
Analytics & ML
Data out
Messages
Email · SMS · WhatsApp · Push · In-app · Wallet
Webhooks
journey nodes & event streams
Data streaming
Snowflake · BigQuery · Redshift · S3 · Kafka · Mixpanel · Amplitude

One track() call powers every surface — a Kafka-based streaming spine fans events out in real time.

Τα συμβάντα διακλαδώνονται σε αναλυτικά στοιχεία, στόχευση κοινού, σήματα ανταμοιβής ML και αξιολόγηση εναυσμάτων journey τη στιγμή που φτάνουν. Ο ίδιος κορμός τροφοδοτεί το Data Streaming, το οποίο παραδίδει τα συμβάντα σας στην αποθήκη δεδομένων, τον χώρο αποθήκευσης ή τη στοίβα αναλυτικών σας, και το Warehouse sync φέρνει τα υπάρχοντα δεδομένα σας.

Έλεγχος ταυτότητας​

Το Joryio χρησιμοποιεί δύο τύπους ελέγχου ταυτότητας:

Κλειδιά SDK (στην πλευρά του πελάτη)​

Για παρακολούθηση από εφαρμογές web και κινητών:

jry_sdk_web_abc123...     (Web SDK)
jry_sdk_ios_def456...     (iOS SDK)
jry_sdk_android_ghi789... (Android SDK)

Ασφάλεια: Ασφαλή για συμπερίληψη σε κώδικα πλευράς πελάτη. Περιορίζονται μόνο σε λειτουργίες παρακολούθησης.

Κλειδιά API (στην πλευρά του διακομιστή)​

Για κλήσεις API από διακομιστή σε διακομιστή:

jry_live_xyz789... (Παραγωγή)
jry_test_abc123... (Δοκιμή)

Ασφάλεια: Πρέπει να παραμένουν μυστικά. Μην τα εκθέτετε ποτέ σε κώδικα πλευράς πελάτη. Πλήρης πρόσβαση σε όλες τις λειτουργίες API.

Κρατήστε τα κλειδιά API μυστικά

Μην προσθέτετε ποτέ κλειδιά API σε έλεγχο εκδόσεων και μην τα εκθέτετε σε κώδικα πλευράς πελάτη. Χρησιμοποιήστε μεταβλητές περιβάλλοντος.

Γρήγορη ενσωμάτωση​

1. Παρακολούθηση Web​

import JoryioSDK from '@joryio/web-sdk';

const joryio = new JoryioSDK({
  sdkKey: 'jry_sdk_web_your_key_here'
});

// Identify user
joryio.identify('user_123');
joryio.setAttributes({
  email: 'user@example.com',
  plan: 'premium',
});

// Track event
joryio.track('Button Clicked', {
  button: 'signup',
  page: 'homepage'
});

2. API στην πλευρά διακομιστή​

const response = await fetch('https://api-eu1.joryio.com/users', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer jry_live_your_api_key_here'
  },
  body: JSON.stringify({
    userId: 'user_123',
    email: 'user@example.com',
    attributes: {
      plan: 'premium',
      signupDate: '2024-01-15'
    }
  })
});

SDK και βιβλιοθήκες​

Επίσημα SDK​

ΠλατφόρμαΚατάστασηΤεκμηρίωση
Web (JavaScript)ΔιαθέσιμοΟδηγός Web SDK
iOS (Swift)ΔιαθέσιμοΟδηγός iOS SDK
Android (Kotlin)ΔιαθέσιμοΟδηγός Android SDK
React NativeΔιαθέσιμοΟδηγός React Native SDK

REST API​

Πλήρες REST API για όλες τις λειτουργίες:

  • Αναφορά API
  • Βασικό URL: https://api-eu1.joryio.com
  • Μορφή: JSON
  • Έλεγχος ταυτότητας: bearer κλειδί API (Authorization: Bearer jry_live_...)

Βασικές έννοιες​

Κάθε έννοια έχει τον δικό της οδηγό - αυτή η σελίδα παραμένει ένας χάρτης:

  • Εφαρμογές - μία ανά πλατφόρμα, καθεμία με το δικό της κλειδί SDK.
  • Χρήστες - προφίλ, γνωρίσματα, ψευδώνυμα και API δημιουργίας/ενημέρωσης.
  • Συμβάντα - συμβάσεις ονοματοδοσίας, ιδιότητες, identify έναντι track και εντοπισμός σφαλμάτων.
  • Τμήματα - δυναμικές ομάδες χρηστών βάσει γνωρισμάτων και συμπεριφοράς.

Ροή ανάπτυξης​

1. Περιβάλλον ανάπτυξης​

# Use test API keys
export JORYIO_API_KEY=jry_test_abc123...

Ενεργοποιήστε τη λειτουργία εντοπισμού στο Web SDK:

const joryio = new JoryioSDK({
  sdkKey: 'jry_sdk_web_test_...',
  enableDebug: true
});

2. Δοκιμές​

  • Χρησιμοποιήστε δοκιμαστικά κλειδιά API για ανάπτυξη
  • Δημιουργήστε δοκιμαστικά τμήματα και καμπάνιες
  • Επαληθεύστε συμβάντα στο dashboard
  • Δοκιμάστε τελικά σημεία webhook τοπικά (χρησιμοποιήστε ngrok)

3. Ανάπτυξη στην παραγωγή​

  • Μεταβείτε σε κλειδιά API παραγωγής
  • Απενεργοποιήστε τη λειτουργία εντοπισμού
  • Παρακολουθήστε ποσοστά σφαλμάτων
  • Ρυθμίστε webhooks για κρίσιμα συμβάντα

Όρια ρυθμού και σφάλματα​

Η συμπεριφορά ορίου ρυθμού (429 + Retry-After), το τυπικό σώμα σφάλματος και οι κωδικοί κατάστασης τεκμηριώνονται μία φορά στην Επισκόπηση API: Περιορισμός ρυθμού · Κωδικοί κατάστασης HTTP.

Εξαγωγή συμβάντων​

Για να λαμβάνετε συμβάντα Joryio στο δικό σας τελικό σημείο σε πραγματικό χρόνο, προσθέστε έναν προορισμό Webhook στο Data Streaming - κάθε συμβάν αποστέλλεται ως JSON στο HTTPS URL σας. Τα Journeys μπορούν επίσης να καλούν τα συστήματά σας ανά επαφή με τον κόμβο Webhook, και οι αποτυχημένες παραδόσεις webhook μπορούν να ελεγχθούν και να επαναληφθούν στις Ρυθμίσεις → Αρχεία καταγραφής και παρακολούθηση (Επαναλήψεις webhook).

Βέλτιστες πρακτικές​

Υποστήριξη και πόροι​

Επόμενα βήματα​

  1. Ενσωματώστε το Web SDK
  2. Ρυθμίστε παρακολούθηση χρηστών
  3. Δημιουργήστε το πρώτο τμήμα σας
  4. Στείλτε καμπάνια