איך לשלוח אירועי קונים ל־Shoply AI מחנות Shopify ללא ממשק קדמי של Shopify

Shoply AI עוקבת אחר התנהגות הקונים (הוספה לעגלה, תשלום, צפייה במוצרים ועוד) כדי לשפר את דירוג תוצאות החיפוש ואת ההמלצות. בחזיתות חנות רגילות של Shopify, הדבר מתבצע אוטומטית באמצעות תוסף Web Pixel שלנו. עם זאת, Shopify Web Pixels אינם פועלים בחנויות ללא ממשק קדמי מכיוון שהם מסתמכים על מנגנון הרינדור של חזית החנות של Shopify כדי להזריק את ארגז החול של ה־pixel.

אם אתם מפעילים חנות Shopify ללא ממשק קדמי (למשל באמצעות Next.js, Hydrogen או חזית מותאמת אישית), עליכם לשלוח את האירועים האלה ישירות מקוד החזית שלכם.

דרישות מוקדמות

התקנתם את Shoply AI והסקריפט של Shoply AI נטען בחזית החנות שלכם.

שליחת אירוע

לאחר טעינת הסקריפט של Shoply AI, הוא חושף באופן אוטומטי את window.shoplyLogEvent. קראו לו ישירות — אין צורך לנהל בעצמכם מזהי הפעלה, מפתחות חנות או נקודות קצה של 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`

אם אתם משתמשים בתשלום המקורי של Shopify, בדרך כלל אין צורך באירוע זה, מכיוון שאנחנו משתמשים באירועי Web Pixel כדי לעקוב אוטומטית אחר השלמת התשלום. עם זאת, אם יש לכם תהליך תשלום משלכם, הפעילו אירוע זה כאשר קונה משלים את התשלום (למשל בדף אישור ההזמנה שלכם).


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"
})

צריכים עזרה?

אתם מוזמנים לקבוע איתנו פגישה , ונעזור לכם לשלב מעקב אחר אירועים בחזית החנות שלכם ללא ממשק קדמי.