Kaip siųsti pirkėjų įvykius iš „Headless Shopify“ parduotuvės į „Shoply AI“

„Shoply AI“ seka pirkėjų elgesį (įdėjimą į krepšelį, atsiskaitymą, produkto peržiūras ir kt.), kad pagerintų paieškos reitingą ir rekomendacijas. Standartinėse „Shopify“ parduotuvėse tai vyksta automatiškai naudojant mūsų „Web Pixel“ plėtinį . Tačiau „Shopify Web Pixels“ neveikia „headless“ parduotuvėse, nes jie remiasi „Shopify“ parduotuvės atvaizdavimo varikliu, kuris įterpia pikselio smėlio dėžę.

Jei naudojate „headless Shopify“ parduotuvę (pvz., su „Next.js“, „Hydrogen“ arba pasirinktine sąsaja), šiuos įvykius turite siųsti tiesiogiai iš savo sąsajos kodo.

Būtinos sąlygos

Esate įdiegę „Shoply AI“, o „Shoply AI“ scenarijus įkeltas jūsų parduotuvėje.

Įvykio siuntimas

Kai „Shoply AI“ scenarijus įkeltas, jis automatiškai suteikia window.shoplyLogEvent. Iškvieskite jį tiesiogiai — jums nereikia patiems tvarkyti seanso ID, parduotuvės raktų ar API galinių taškų:


window.shoplyLogEvent(eventName, data)

Objekto data struktūra priklauso nuo įvykio tipo (žr. toliau).

Būtini įvykiai konversijų stebėjimui

`product_added_to_cart`

Iškvieskite šį įvykį, kai pirkėjas įdeda produkto variantą į krepšelį.


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`

Jei naudojate savąjį „Shopify“ atsiskaitymą, paprastai to nereikia, nes atsiskaitymo užbaigimą automatiškai stebime naudodami žiniatinklio pikselio įvykius. Tačiau jei turite savo atsiskaitymo eigą, iškvieskite šį įvykį, kai pirkėjas užbaigia atsiskaitymą (pvz., užsakymo patvirtinimo puslapyje).


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

Reikia pagalbos?

Drąsiai užsisakykite susitikimą su mumis — padėsime integruoti įvykių stebėjimą į jūsų „headless“ parduotuvę.