Event names
Use the name for the active Installation Path. Do not subscribe to both naming schemes on one Shopify Online Store theme.
Emission contract
An event is emitted:- When a new result transitions to ready during the current widget session
- Once for each event and result pair
- Only from storefront embed mode
- When a result is queued, running, or failed
- For a result that was already ready when tracking initialized
- From browser extension mode
Payload
Example:
- Product URL stored with the generated result
- Canonical product URL discovered on the page
- Current page URL
GA4 does not receive the customer photo, generated media, or internal Trylora job identifier.
Shopify App Pixel delivery
The Trylora storefront publishes the Shopify event fields onevent.customData. The Trylora App Pixel validates them and forwards the two success events to GA4 using the underscore event names in the table above.
The Shopify event also contains trylora_ga_measurement_id and trylora_source_job_id. These transport fields select the configured GA web stream and prove that the event belongs to a completed Trylora job. Neither field is sent as a GA4 event parameter.
Shopify custom events can be published manually from a browser, so the App Pixel and backend validate field types, the store connection, and the allowlisted event name before forwarding.
Generic provider delivery
- GA4 receives
gtag("event", eventName, payload). - GTM receives
{ event: eventName, ...payload }inwindow.dataLayer. - Mixpanel receives
mixpanel.track(eventName, payload).
