Hvernig á að senda atburði um kaupendur til Shoply AI úr headless Shopify-verslun

Shoply AI fylgist með hegðun kaupenda (bæta í körfu, greiðsluferli, skoðun vara o.s.frv.) til að bæta röðun leitarniðurstaðna og meðmæli. Í hefðbundnum Shopify-verslunum gerist þetta sjálfkrafa í gegnum Web Pixel-viðbótina okkar . Hins vegar keyra Shopify Web Pixels ekki í headless-verslunum vegna þess að þau reiða sig á myndvinnslukerfi Shopify-verslunarinnar til að setja inn pixel-sandkassann.

Ef þú rekur headless Shopify-verslun (t.d. með Next.js, Hydrogen eða sérsniðnum framenda) þarftu að senda þessa atburði beint úr framendakóðanum þínum.

Forsendur

Þú hefur sett upp Shoply AI og Shoply AI-skriftan er hlaðin í versluninni þinni.

Senda atburð

Þegar Shoply AI-skriftan hefur verið hlaðin birtir hún window.shoplyLogEvent sjálfkrafa. Kallaðu beint í hana — þú þarft ekki sjálf(ur) að halda utan um setuauðkenni, verslunarlykla eða API-endapunkta:


window.shoplyLogEvent(eventName, data)

Uppbygging data-hlutarins fer eftir gerð atburðarins (sjá hér að neðan).

Nauðsynlegir atburðir til að styðja við viðskiptamælingu

`product_added_to_cart`

Kveiktu á þessu þegar kaupandi bætir afbrigði vöru í körfuna sína.


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`

Ef þú notar innbyggt greiðsluferli Shopify þarftu yfirleitt ekki þetta, þar sem við notum web pixel-atburði til að fylgjast sjálfkrafa með því þegar greiðsluferli lýkur. Hins vegar, ef þú ert með þitt eigið greiðsluferli, skaltu kveikja á þessu þegar kaupandi lýkur greiðsluferlinu (t.d. á staðfestingarsíðu pöntunar).


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

Þarftu hjálp?

Þér er velkomið að bóka fund með okkur og við hjálpum þér að samþætta atburðamælingu í headless-verslunina þína.