Wat zijn Shopify Customer Events (web pixels)?
Shopify Customer Events zijn de gestandaardiseerde gedragsevents — zoals product_viewed, product_added_to_cart en checkout_completed — die een Shopify-winkel naar zijn eigen datalaag publiceert, waarop web pixels intekenen en die ze doorsturen naar analytics- of marketingendpoints.
Een web pixel is JavaScript dat op de winkel is geregistreerd en draait in een door Shopify beheerde sandbox in plaats van in de JavaScript-context van de pagina zelf. Shopify stelt dezelfde eventstroom beschikbaar op het storefront, de checkout en de post-purchase-oppervlakken, zodat een pixel checkout-events kan ontvangen die themacode nooit ziet.
- checkout-events
- checkout_startedcheckout_contact_info_submittedcheckout_shipping_info_submittedpayment_info_submittedcheckout_completed
Daniil Maximkin Gepubliceerd Gecontroleerd
- In de praktijk
Hoe werken Customer Events en web pixels?
App pixels
zijn web pixel-appextensies die door apps worden geïnstalleerd en draaien in een strikte sandbox gebouwd op een web worker
Aangepaste pixels
worden door de handelaar toegevoegd en draaien in een lakse sandbox: een iframe met script- en formulierpermissies, zodat verouderde snippets blijven werken
Shopify publiceert customer events naar zijn eigen datalaag terwijl een bezoeker door de winkel gaat, en een web pixel tekent in op de events die het nodig heeft. De pixel ontvangt de eventnaam en payload via de Web Pixels API en stuurt door wat nodig is, over het storefront, de checkout en de post-purchase-oppervlakken.
- In de praktijk
Op welke standaardevents kan een pixel intekenen?
Shopify definieert een vaste set standaardevents, die het winkelpad dekt van page_viewed en product_viewed via cart_viewed, product_added_to_cart en search_submitted, en daarna de checkoutstappen.
De checkout-events omvatten checkout_started, checkout_contact_info_submitted, checkout_shipping_info_submitted, payment_info_submitted en checkout_completed. Het post-purchase-oppervlak maakt de afgeronde order beschikbaar voor ingetekende pixels, en daarom is Customer Events de ondersteunde bron voor een purchase-event.
- In de praktijk
Waar heeft een web pixel geen toegang toe?
Een web pixel kan de DOM van de pagina niet lezen of schrijven, en kan het top-frame niet bereiken. App pixels draaien in een web worker waar alleen een gedocumenteerde set globals gegarandeerd is; document en window zijn niet beschikbaar.
Aangepaste pixels draaien in een gesandboxte iframe die geen toegang heeft tot het top-frame, dus een eigenschap zoals de pagina-URL resolvet naar de sandbox-URL in plaats van de URL van de winkel. Geen van beide typen kan de checkout-markup scrapen voor orderdata; de eventpayload is de bron van waarheid.
- Niet te verwarren met
Niet te verwarren met Is niet Is de dataLayer van Google Tag Manager de eigen eventlaag van Shopify themascript draait onder de regels van Shopify, inclusief consent Customer Events zijn niet de dataLayer van Google Tag Manager, en een web pixel is geen GTM-tag: het zijn de eigen eventlaag van Shopify, en een scripttag aan het thema toevoegen is niet hoe een pixel wordt geïnstalleerd.
Een aangepaste pixel is ook geen themascript. Hij draait onder de regels van Shopify, inclusief consent: web pixels respecteren de Customer Privacy API, en in regio’s waar consent vereist is, draaien pixel-callbacks pas nadat de klant consent geeft.
- Waar te controleren
Hoe controleer ik welke pixels events ontvangen?
- Shopify-adminInstellingenCustomer events
In het Shopify-admin staat onder Instellingen en dan Customer events elke pixel van de winkel, en daar worden aangepaste pixels toegevoegd. Logging binnen een eventabonnement in een development store bevestigt dat een event aankomt en toont de payload; de documentatie van Shopify waarschuwt tegen logging in productie.
