Kako pošiljati dogodke nakupovalcev iz trgovine Shopify brez glave v Shoply AI

Shoply AI spremlja vedenje nakupovalcev (dodajanje v košarico, zaključevanje nakupa, oglede izdelkov itd.), da izboljša razvrščanje v iskanju in priporočila. V standardnih trgovinah Shopify se to zgodi samodejno prek naše razširitve Web Pixel . Vendar Shopify Web Pixels ne delujejo v trgovinah brez glave, ker se zanašajo na Shopifyjev mehanizem za izris trgovine, ki vstavi peskovnik piksla.

Če uporabljate trgovino Shopify brez glave (npr. z Next.js, Hydrogen ali lastnim vmesnikom), morate te dogodke poslati neposredno iz kode svojega vmesnika.

Predpogoji

Namestili ste Shoply AI in skript Shoply AI je naložen v vaši trgovini.

Pošiljanje dogodka

Ko je skript Shoply AI naložen, samodejno razkrije window.shoplyLogEvent. Pokličite ga neposredno — sami vam ni treba upravljati ID-jev sej, ključev trgovine ali končnih točk API-ja:


window.shoplyLogEvent(eventName, data)

Oblika objekta data je odvisna od vrste dogodka (glejte spodaj).

Obvezni dogodki za podporo sledenju konverzijam

`product_added_to_cart`

Ta dogodek sprožite, ko nakupovalec doda različico izdelka v košarico.


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`

Če uporabljate izvorno plačilno stran Shopify, tega običajno ne potrebujete, saj za samodejno sledenje dokončanju nakupa uporabljamo dogodke spletnega piksla. Če pa imate lasten potek plačila, ta dogodek sprožite, ko nakupovalec dokonča nakup (npr. na strani s potrditvijo naročila).


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

Potrebujete pomoč?

Lahko rezervirate sestanek z nami in pomagali vam bomo vključiti sledenje dogodkom v vašo trgovino brez glave.