Πώς να στέλνετε συμβάντα αγοραστών στο Shoply AI από ένα headless κατάστημα Shopify

Το Shoply AI παρακολουθεί τη συμπεριφορά των αγοραστών (προσθήκη στο καλάθι, ολοκλήρωση αγοράς, προβολές προϊόντων κ.λπ.) για να βελτιώνει την κατάταξη των αποτελεσμάτων αναζήτησης και τις προτάσεις. Στα τυπικά storefront του Shopify, αυτό γίνεται αυτόματα μέσω της επέκτασης Web Pixel . Ωστόσο, τα Shopify Web Pixels δεν εκτελούνται σε headless storefront, επειδή βασίζονται στη μηχανή απόδοσης του storefront του Shopify για την εισαγωγή του sandbox του pixel.

Αν χρησιμοποιείτε headless κατάστημα Shopify (π.χ. με Next.js, Hydrogen ή προσαρμοσμένο frontend), πρέπει να στέλνετε αυτά τα συμβάντα απευθείας από τον κώδικα του frontend σας.

Προαπαιτούμενα

• Έχετε εγκαταστήσει το Shoply AI και το script του Shoply AI έχει φορτωθεί στο storefront σας.

Αποστολή συμβάντος

Μόλις φορτωθεί το script του Shoply AI, εκθέτει αυτόματα το window.shoplyLogEvent. Καλέστε το απευθείας — δεν χρειάζεται να διαχειριστείτε μόνοι σας ID συνεδριών, κλειδιά καταστήματος ή endpoints API:

window.shoplyLogEvent(eventName, data)

Η μορφή του αντικειμένου data εξαρτάται από τον τύπο του συμβάντος (δείτε παρακάτω).

Απαραίτητα συμβάντα για την υποστήριξη της παρακολούθησης μετατροπών

product_added_to_cart

Ενεργοποιήστε αυτό το συμβάν όταν ένας αγοραστής προσθέτει μια παραλλαγή προϊόντος στο καλάθι του.

await window.shoplyLogEvent('product_added_to_cart', {
  "cartLine": {
    "cost": {
      "totalAmount": {
        "amount": 769,
        "currencyCode": "USD"
      }
    },
    "merchandise": {
      "id": "42553607094387",  // Variant ID
      "title": "25.5 Mondo",
      "price": {
        "amount": 769,
        "currencyCode": "USD"
      },
      "product": {
        "id": "7834124058739"  // Product ID
      }
    },
    "quantity": 1
  },
  "clientId": "35214700-144e-4022-974e-fe008736e973",  // Not used
  "referrer": "https://demo.shoplyai.ai/collections/all"
})

checkout_completed

Αν χρησιμοποιείτε το εγγενές checkout του Shopify, συνήθως δεν χρειάζεστε αυτό το συμβάν, καθώς χρησιμοποιούμε συμβάντα web pixel για την αυτόματη παρακολούθηση της ολοκλήρωσης αγοράς. Ωστόσο, αν έχετε τη δική σας ροή checkout, ενεργοποιήστε το όταν ένας αγοραστής ολοκληρώνει την αγορά (π.χ. στη σελίδα επιβεβαίωσης της παραγγελίας σας).

await window.shoplyLogEvent('checkout_completed', {
  "token": "8cea7db9ce551f0a8c9113a0f7f2dce0",  // Not used
  "order": {
    "id": "7251060916339",  // Shopify Order ID
    "customer": {
      "id": "9903183265907",  // Shopify Customer ID
      "isFirstOrder": true
    }
  },
  "lineItems": [
    {
      "finalLinePrice": {
        "amount": 1538,
        "currencyCode": "USD"
      },
      "quantity": 2,
      "variant": {
        "id": "42553607094387",  // Variant ID
        "title": "25.5 Mondo",
        "price": {
          "amount": 769,
          "currencyCode": "USD"
        },
        "product": {
          "id": "7834124058739"  // Product ID
        }
      }
    },
    {
      "finalLinePrice": {
        "amount": 384.93,
        "currencyCode": "USD"
      },
      "quantity": 1,
      "variant": {
        "id": "42553643958387",
        "title": "157 CM",
        "price": {
          "amount": 384.93,
          "currencyCode": "USD"
        },
        "product": {
          "id": "7834140180595"
        }
      }
    }
  ],
  "clientId": "35214700-144e-4022-974e-fe008736e973",  // Not used
  "referrer": "https://demo.shoplyai.ai/cart"
})

Χρειάζεστε βοήθεια;

Μπορείτε να κλείσετε μια συνάντηση μαζί μας  και θα σας βοηθήσουμε να ενσωματώσετε την παρακολούθηση συμβάντων στο headless storefront σας.