Sut i Anfon Digwyddiadau Siopwyr at Shoply AI o Siop Shopify Headless

Mae Shoply AI yn olrhain ymddygiad siopwyr (ychwanegu at y fasged, talu, gweld cynnyrch, ac ati) er mwyn gwella safle chwilio ac argymhellion. Ar flaen siopau Shopify safonol, mae hyn yn digwydd yn awtomatig drwy ein estyniad Web Pixel . Fodd bynnag, nid yw Shopify Web Pixels yn rhedeg ar flaen siopau headless oherwydd eu bod yn dibynnu ar beiriant rendro blaen siop Shopify i fewnosod y blwch tywod pixel.

Os ydych yn rhedeg siop Shopify headless (e.e. gyda Next.js, Hydrogen, neu flaen-end personol), mae angen i chi anfon y digwyddiadau hyn yn uniongyrchol o’ch cod blaen-end.

Rhagofynion

Rydych wedi gosod Shoply AI ac mae sgript Shoply AI wedi’i llwytho ar eich blaen siop.

Anfon Digwyddiad

Unwaith y bydd sgript Shoply AI wedi’i llwytho, mae’n datgelu window.shoplyLogEvent yn awtomatig. Galwch arno’n uniongyrchol — nid oes angen i chi reoli IDau sesiynau, allweddi siop, na phwyntiau terfyn API eich hun:


window.shoplyLogEvent(eventName, data)

Mae siâp y gwrthrych data yn dibynnu ar fath y digwyddiad (gweler isod).

Digwyddiadau Hanfodol i Gefnogi Olrhain Trosi

`product_added_to_cart`

Galwch hyn pan fydd siopwr yn ychwanegu amrywiad cynnyrch at ei fasged.


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`

Os ydych yn defnyddio proses dalu frodorol Shopify, fel arfer nid oes angen hyn arnoch gan ein bod yn defnyddio digwyddiadau Web Pixel i olrhain cwblhau’r taliad yn awtomatig. Fodd bynnag, os oes gennych eich llif talu eich hun, galwch hyn pan fydd siopwr yn cwblhau’r taliad (e.e. ar eich tudalen cadarnhau archeb).


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

Angen Help?

Mae croeso i chi drefnu cyfarfod â ni , a byddwn yn eich helpu i integreiddio olrhain digwyddiadau yn eich blaen siop headless.