كيفية إرسال أحداث المتسوقين إلى Shoply AI من متجر Shopify بلا واجهة عرض

يتتبع Shoply AI سلوك المتسوقين (الإضافة إلى السلة وإتمام الدفع ومشاهدات المنتجات وما إلى ذلك) لتحسين ترتيب نتائج البحث والتوصيات. في متاجر Shopify القياسية، يحدث ذلك تلقائيًا عبر إضافة Web Pixel . لكن Shopify Web Pixels لا تعمل على واجهات العرض بلا واجهة لأنها تعتمد على محرك عرض المتجر في Shopify لحقن بيئة عزل البكسل.

إذا كنت تدير متجر 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"
})

هل تحتاج إلى مساعدة؟

لا تتردد في حجز اجتماع معنا ، وسنساعدك على دمج تتبع الأحداث في واجهة متجرك بلا واجهة.