Headless Shopify स्टोर से Shoply AI को खरीदारों की इवेंट कैसे भेजें

Shoply AI खोज रैंकिंग और सुझावों को बेहतर बनाने के लिए खरीदारों के व्यवहार (कार्ट में जोड़ना, चेकआउट, उत्पाद देखना आदि) को ट्रैक करता है। मानक Shopify storefronts पर यह हमारे Web Pixel extension के ज़रिए अपने आप होता है। हालाँकि, Shopify Web Pixels headless storefronts पर नहीं चलते, क्योंकि उन्हें pixel sandbox डालने के लिए Shopify के storefront rendering engine पर निर्भर रहना पड़ता है।

अगर आप headless Shopify स्टोर चलाते हैं (जैसे Next.js, Hydrogen या कोई कस्टम frontend), तो आपको ये इवेंट सीधे अपने frontend code से भेजने होंगे।

आवश्यकताएँ

आपने Shoply AI इंस्टॉल किया हुआ है और Shoply AI script आपके storefront पर लोड है।

कोई इवेंट भेजना

Shoply AI script लोड हो जाने पर यह अपने आप window.shoplyLogEvent उपलब्ध कराती है। इसे सीधे कॉल करें — session IDs, store keys या API endpoints को खुद प्रबंधित करने की ज़रूरत नहीं है:


window.shoplyLogEvent(eventName, data)

data ऑब्जेक्ट का आकार इवेंट के प्रकार पर निर्भर करता है (नीचे देखें)।

कन्वर्ज़न ट्रैकिंग के लिए ज़रूरी इवेंट

`product_added_to_cart`

जब कोई खरीदार किसी उत्पाद के variant को अपनी कार्ट में जोड़ता है, तब इसे फ़ायर करें।


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`

अगर आप Shopify का native checkout इस्तेमाल कर रहे हैं, तो आमतौर पर आपको इसकी ज़रूरत नहीं होगी, क्योंकि हम checkout पूरा होने को अपने आप ट्रैक करने के लिए web pixel events का उपयोग करते हैं। हालाँकि, अगर आपका अपना checkout flow है, तो खरीदार का checkout पूरा होने पर इसे फ़ायर करें (जैसे अपने order confirmation page पर)।


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 में event tracking इंटीग्रेट करने में मदद करेंगे।