Send analytics events for widget usage and conversion tracking
event (string, required): Event type name (see Event Types below)properties (object, optional): Additional event propertiestimestamp (string, required): ISO 8601 timestamp$insert_id (string, required): Unique event ID for deduplication| Event Type | Description |
|---|---|
product_page:page_view | Product page viewed |
product_page:cart_add | Item added to cart from product page |
widget:button_view | Widget button displayed |
widget:button_click | Widget button clicked |
widget:modal_close | Widget modal closed |
widget:image_upload | User uploaded an image |
widget:image_upload_success | Image upload succeeded |
widget:image_upload_error | Image upload failed |
widget:generation_start | Generation job started |
widget:result_view | Generation result displayed |
widget:product_click | User clicked product link from result |
widget:email_prompt_view | Email collection prompt shown |
widget:email_collected | Email successfully collected |
widget:share_clicked | Share button clicked |
widget:download_clicked | Download button clicked |
widget:add_to_cart_clicked | Add to cart clicked from widget |
widget:add_to_cart_success | Add to cart succeeded |
widget:add_to_cart_error | Add to cart failed |
order:created | Order created (via webhook) |
api:error | API error occurred |
category:object_action (e.g., widget:button_click). Use lowercase with snake_case.$current_url - Full current page URL$pathname - URL pathname$host - Domain/hostname$referrer - Referrer URL (or null)$referring_domain - Referrer domain (or null)$screen_width - Screen width in pixels$screen_height - Screen height in pixels$viewport_width - Viewport width in pixels$viewport_height - Viewport height in pixels$raw_user_agent - Full user agent string$browser_language - Browser language (e.g., “en-US”)$timezone - Timezone (e.g., “America/New_York”)$session_id - Unique session identifier$pageview_id - Unique pageview identifiergenlook_client_id - UUID client identifiergenlook_widget_enabled - Whether widget is enabledgenlook_product_id - Current product ID (or null)genlook_variant_id - Current variant ID (or null)genlook_lib_version - Widget library versionwidget:button_view → widget:button_click → widget:image_uploadwidget:generation_start → widget:result_view → widget:product_clickwidget:add_to_cart_clicked → widget:add_to_cart_success → order:createdwidget:email_prompt_view → widget:email_collected