Headless Shopify Mağazasından Shoply AI’a Alışverişçi Etkinlikleri Nasıl Gönderilir?

Shoply AI, arama sıralamasını ve önerileri iyileştirmek için alışverişçi davranışlarını (sepete ekleme, ödeme, ürün görüntüleme vb.) takip eder. Standart Shopify vitrinlerinde bu işlem Web Pixel uzantımız aracılığıyla otomatik olarak gerçekleşir. Ancak Shopify Web Pixels headless vitrinlerde çalışmaz; çünkü piksel sandbox’ını eklemek için Shopify’ın vitrin oluşturma motoruna ihtiyaç duyarlar.

Headless bir Shopify mağazası işletiyorsanız (ör. Next.js, Hydrogen veya özel bir frontend ile), bu etkinlikleri doğrudan frontend kodunuzdan göndermeniz gerekir.

Ön Koşullar

Shoply AI’ı yüklediniz ve Shoply AI komut dosyası vitrinize yüklendi.

Etkinlik Gönderme

Shoply AI komut dosyası yüklendikten sonra window.shoplyLogEvent otomatik olarak kullanıma açılır. Oturum kimliklerini, mağaza anahtarlarını veya API uç noktalarını kendiniz yönetmenize gerek yoktur; doğrudan çağırabilirsiniz:


window.shoplyLogEvent(eventName, data)

data nesnesinin yapısı etkinlik türüne bağlıdır (aşağıya bakın).

Dönüşüm Takibini Desteklemek İçin Gerekli Etkinlikler

`product_added_to_cart`

Bir alışverişçi bir ürün varyantını sepetine eklediğinde bunu çalıştırın.


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’ın yerel ödeme sürecini kullanıyorsanız, ödeme tamamlanmasını otomatik olarak takip etmek için web pixel etkinliklerini kullandığımızdan genellikle buna ihtiyacınız olmaz. Ancak kendi ödeme akışınız varsa, bir alışverişçi ödemeyi tamamladığında (ör. sipariş onay sayfanızda) bunu çalıştırın.


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

Yardıma mı İhtiyacınız Var?

Etkinlik takibini headless vitrininize entegre etmenize yardımcı olmamız için bizimle bir görüşme planlayabilirsiniz .