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

Παρακολούθηση E-Commerce

Τα Joryio SDK περιλαμβάνουν ενσωματωμένη παρακολούθηση e-commerce για αλληλεπίδραση με προϊόντα, δραστηριότητα καλαθιού και αγορές. Ο tracker λειτουργεί με τον ίδιο τρόπο σε κάθε πλατφόρμα: ίδιες μέθοδοι, ίδια τυπικά ονόματα συμβάντων και ίδια σημασιολογία ιδιοτήτων - διαφέρει μόνο η σύνταξη της γλώσσας.

Επιλέξτε την πλατφόρμα σας σε οποιοδήποτε παράδειγμα κώδικα παρακάτω· η επιλογή συγχρονίζεται σε όλη τη σελίδα. Για εγκατάσταση και ρυθμίσεις, δείτε τους οδηγούς πλατφόρμας: Web SDK, iOS SDK, Android SDK, React Native SDK. Το React Native δεν διαθέτει αποκλειστικό tracker - η καρτέλα του δείχνει τις ισοδύναμες κλήσεις Joryio.track() (δείτε React Native παρακάτω).

Σύμβαση ονοματοδοσίας ID​

Το Joryio χρησιμοποιεί σαφή σύμβαση ονοματοδοσίας για αναγνωριστικά:

Το ID σαςΠεριγραφήΠαράδειγμα
productIdΑναγνωριστικό προϊόντος (SKU ή ID προϊόντος από την πλατφόρμα e-commerce σας)"SKU-12345"
orderIdΑναγνωριστικό παραγγελίας (αριθμός παραγγελίας από την πλατφόρμα σας)"ORD-2024-001"
userIdΑναγνωριστικό χρήστη (περνά στο identify())"user-123"

Χρησιμοποιήστε τα δικά σας αναγνωριστικά φυσικά - δεν απαιτούνται ειδικά προθέματα.

Αρχικοποίηση του E-Commerce Tracker​

// Get the e-commerce tracker from your SDK instance
// (joryio is the instance created with `new JoryioSDK({ sdkKey: ... })`)
const ecommerce = joryio.ecommerce({
  currency: 'USD' // Default currency for all events
});

Παρακολούθηση προβολών προϊόντων και αναζήτησης​

// When user views a product page
ecommerce.viewProduct({
  productId: 'SKU-12345',
  name: 'Classic Blue T-Shirt',
  price: 29.99,
  category: 'Clothing/T-Shirts',
  brand: 'Acme Apparel',
  imageUrl: 'https://example.com/images/blue-tshirt.jpg',
  url: 'https://example.com/products/blue-tshirt'
});

// When user views a category page
ecommerce.viewCategory('tshirts', 'T-Shirts');

// When user searches
ecommerce.search('blue shirts', 42); // query, result count

Παρακολούθηση δραστηριότητας καλαθιού​

// Add item to cart
ecommerce.addToCart({
  productId: 'SKU-12345',
  name: 'Classic Blue T-Shirt',
  price: 29.99,
  quantity: 1,
  variantId: 'var-medium',
  sku: 'BTS-001-M'
}, 59.98); // Optional: current cart value

// Remove item from cart
ecommerce.removeFromCart({
  productId: 'SKU-12345',
  name: 'Classic Blue T-Shirt',
  price: 29.99
}, 1); // quantity to remove

// Update entire cart
ecommerce.updateCart([
  { productId: 'SKU-12345', name: 'Blue T-Shirt', price: 29.99, quantity: 2 },
  { productId: 'SKU-67890', name: 'Black Jeans', price: 49.99, quantity: 1 }
], 109.97); // items array, total cart value

Παρακολούθηση ροής checkout​

// When user starts checkout
ecommerce.startCheckout([
  { productId: 'SKU-12345', name: 'Blue T-Shirt', price: 29.99, quantity: 2 },
  { productId: 'SKU-67890', name: 'Black Jeans', price: 49.99, quantity: 1 }
], 109.97); // items, cart value

// When user adds payment info
ecommerce.addPaymentInfo('credit_card');

Παρακολούθηση αγορών​

// When order is completed
ecommerce.purchase({
  orderId: 'ORD-2024-001',
  items: [
    {
      productId: 'SKU-12345',
      name: 'Classic Blue T-Shirt',
      price: 29.99,
      quantity: 2,
      category: 'Clothing',
      brand: 'Acme'
    },
    {
      productId: 'SKU-67890',
      name: 'Black Jeans',
      price: 49.99,
      quantity: 1
    }
  ],
  value: 109.97,
  currency: 'USD',
  shipping: 5.99,
  tax: 8.80,
  discount: 10.00,
  coupon: 'SAVE10'
});
Τα προϊόντα πρέπει να παρέχονται

Η μέθοδος purchase() απαιτεί να περάσετε ρητά τα προϊόντα της παραγγελίας. Το SDK δεν αποθηκεύει την κατάσταση καλαθιού στον client ούτε αντλεί αυτόματα προϊόντα από το καταγεγραμμένο καλάθι ή τον διακομιστή. Αυτό εξασφαλίζει ακρίβεια, επειδή η σελίδα ή η οθόνη επιβεβαίωσης παραγγελίας γνωρίζει τα ακριβή προϊόντα που αγοράστηκαν.

Παρακολούθηση αλλαγών κατάστασης παραγγελίας​

// Order shipped
ecommerce.orderFulfilled('ORD-2024-001', '1Z999AA10123456784', 'UPS');

// Order delivered
ecommerce.orderDelivered('ORD-2024-001');

// Order cancelled
ecommerce.orderCancelled('ORD-2024-001', 'Customer requested');

// Order refunded
ecommerce.orderRefunded('ORD-2024-001', 29.99, 'Product defective');

Παρακολούθηση λίστας επιθυμιών και κοινοποίησης​

// Add to wishlist
ecommerce.addToWishlist({
  productId: 'SKU-12345',
  name: 'Classic Blue T-Shirt',
  price: 29.99
});

// Share product
ecommerce.shareProduct({
  productId: 'SKU-12345',
  name: 'Classic Blue T-Shirt'
}, 'facebook'); // share method

Παρακολούθηση κουπονιών​

// Coupon applied
ecommerce.applyCoupon('SAVE10', 10.00, 'percentage');

// Coupon removed
ecommerce.removeCoupon('SAVE10');

Παρακολούθηση αξιολογήσεων​

// Product review submitted
ecommerce.submitReview('SKU-12345', 5, 'Great quality shirt!');

Τυπικά συμβάντα E-Commerce​

Ο e-commerce tracker στέλνει τα ίδια τυπικά συμβάντα σε κάθε πλατφόρμα:

Όνομα συμβάντοςΠεριγραφή
Product ViewedΟ χρήστης προβάλλει σελίδα προϊόντος
Product List ViewedΟ χρήστης προβάλλει σελίδα κατηγορίας
Products SearchedΟ χρήστης αναζητά προϊόντα
Product AddedΠροϊόν προστέθηκε στο καλάθι
Product RemovedΠροϊόν αφαιρέθηκε από το καλάθι
Cart UpdatedΤο περιεχόμενο του καλαθιού άλλαξε
Checkout StartedΟ χρήστης ξεκινά checkout
Payment Info EnteredΟ χρήστης προσθέτει μέθοδο πληρωμής
Order CompletedΗ παραγγελία ολοκληρώθηκε
Order FulfilledΗ παραγγελία στάλθηκε
Order DeliveredΗ παραγγελία παραδόθηκε
Order CancelledΗ παραγγελία ακυρώθηκε
Order RefundedΗ παραγγελία επιστράφηκε
Product Added to WishlistΠροϊόν προστέθηκε στη λίστα επιθυμιών
Product Removed from WishlistΠροϊόν αφαιρέθηκε από τη λίστα επιθυμιών
Product SharedΤο προϊόν κοινοποιήθηκε
Coupon AppliedΕφαρμόστηκε κωδικός κουπονιού
Coupon RemovedΑφαιρέθηκε κωδικός κουπονιού
Product ReviewedΥποβλήθηκε αξιολόγηση προϊόντος

React Native​

Το React Native SDK δεν περιλαμβάνει αποκλειστικό e-commerce tracker. Οι εφαρμογές React Native στέλνουν ακριβώς τα ίδια τυπικά συμβάντα με Joryio.track(), χρησιμοποιώντας τα ίδια ονόματα συμβάντων και τα ίδια ονόματα ιδιοτήτων στο wire που εκπέμπουν οι trackers των άλλων SDK (οι trackers μετατρέπουν τα inputs camelCase σε ιδιότητες συμβάντων snake_case στο wire). Η καρτέλα React Native σε κάθε ενότητα παραπάνω δείχνει την ισοδύναμη κλήση Joryio.track() για κάθε μέθοδο tracker.

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