GA4 analytics

Measure the GiftNote journey from curiosity to checkout.

Velop pushes storefront events to Google Tag Manager and GA4-compatible dataLayer events when they are available on the merchant site. Use these events to find where shoppers notice, learn, record, attach, or abandon a GiftNote.

Product-page intent

See whether shoppers notice the widget, open it, and choose a message type.

Help video clarity

Measure whether the training popup explains the QR message clearly enough to drive action.

Attachment funnel

Track recording, preview, confirmation, and message attachment before cart or checkout.

Conversion lift

Compare product add-to-cart and purchase behavior with or without a Velop message.

Setup

Add Google Tag Manager or GA4 to the merchant storefront. Velop will push events to window.dataLayer and call window.gtag when it exists. No customer media, sender names, or private message IDs are sent as GA4 parameters.

window.dataLayer.push({
  event: "velop_message_added",
  product_id: "123",
  method: "video",
  price: "4.99",
  currency: "SGD"
});

Funnel Events

Event	Purpose	Useful parameters
`velop_widget_viewed`	Widget first enters the shopper viewport.	product_id, widget_state, widget_placement, price, currency
`velop_widget_opened`	Shopper expands the product-page widget.	source, product_id, widget_placement
`velop_method_selected`	Shopper chooses voice, video, or upload.	method, product_id
`velop_recording_started`	Shopper starts a voice or video recording.	method, max_seconds
`velop_recording_completed`	Recording completes and moves to preview.	method, duration_seconds
`velop_upload_selected`	Shopper selects an uploaded media file.	file_type, file_size_bucket, duration_seconds
`velop_preview_viewed`	Shopper reaches the preview step.	method, duration_seconds
`velop_confirm_started`	Shopper reaches the sender/details confirmation step.	method
`velop_message_added`	GiftNote is confirmed and attached to the order flow.	method, duration_seconds, price, currency

Help Popup Events

Use these events to test whether the hover training popup and emotional preview video increase GiftNote starts.

Event	Purpose	Useful parameters
`velop_help_opened`	Help popover opens from hover, focus, or click.	trigger, sound_setting
`velop_help_video_started`	Preview video starts or falls back to muted playback.	sound_enabled, autoplay_blocked
`velop_help_video_progress`	Preview video crosses 25%, 50%, 75%, or 100%.	progress_percent, sound_enabled
`velop_help_closed`	Help popover closes.	watch_time_seconds

Commerce Events

Event	Purpose	Useful parameters
`velop_add_to_cart_clicked`	Shopper clicks a Velop or WooCommerce add-to-cart action.	has_message, method, location
`velop_product_add_to_cart_with_message`	WooCommerce add-to-cart fires while a Velop message ID is attached.	method, product_id

Friction Events

Event	Purpose	Useful parameters
`velop_browser_not_supported`	Browser cannot record voice/video.	missing_capability
`velop_permission_denied`	Camera or microphone access fails.	permission, method, error_code
`velop_api_error`	Create/confirm/upload flow fails.	action, method, error_code

Recommended Custom Dimensions

Create these in GA4 when you want to segment adoption by placement, method, product, or device.

product_id
widget_placement
widget_default_state
teaser_text
price
price_label
currency
method
store_domain
device_type
browser_supported

Recommended Key Events

velop_message_added for GiftNote attach rate.
velop_product_add_to_cart_with_message for add-to-cart intent with a completed GiftNote.
purchase segmented by whether the order contains a Velop message.
velop_help_video_progress at 75% if you are testing the education popup.

Ask about analytics setup

Implementation Note

GA4 has limits for custom dimensions and parameter length. Keep values short, avoid personally identifiable information, and use Google Tag Manager to map Velop event parameters into GA4 event parameters where needed.

Back to Velop docs