Skip to main content
POST
/
public
/
tracking
/
events
curl -X POST "https://your-store.myshopify.com/apps/proxy_genlook-x/public/tracking/events" \
  -H "Content-Type: application/json" \
  -d '{
    "events": [
      {
        "event": "widget:button_click",
        "properties": { "product_id": "gid://shopify/Product/456" },
        "timestamp": "2024-01-15T10:30:00Z",
        "$insert_id": "event_123"
      }
    ],
    "context": {
      "$current_url": "https://yourstore.com/products/tshirt",
      "$host": "yourstore.com",
      "$session_id": "session_abc123",
      "genlook_client_id": "550e8400-e29b-41d4-a716-446655440000",
      "genlook_product_id": "gid://shopify/Product/456"
    }
  }'

{
  "success": true
}

Documentation Index

Fetch the complete documentation index at: https://docs.genlook.app/docs/llms.txt

Use this file to discover all available pages before exploring further.

Send batched analytics events to track widget usage and conversion funnels. Max 50 events per batch. Tracking failures never block user flow.

​
Request

​
events
array
required
Array of event objects. Each contains:
  • event (string, required) — Event name (e.g. widget:button_click)
  • properties (object, optional) — Custom properties
  • timestamp (string, required) — ISO 8601 timestamp
  • $insert_id (string, required) — Unique ID for deduplication
​
context
object
required
Shared context for all events in the batch: page URL, viewport size, user agent, session/pageview IDs, and Genlook-specific fields (genlook_client_id, genlook_product_id, genlook_variant_id, genlook_lib_version).
curl -X POST "https://your-store.myshopify.com/apps/proxy_genlook-x/public/tracking/events" \
  -H "Content-Type: application/json" \
  -d '{
    "events": [
      {
        "event": "widget:button_click",
        "properties": { "product_id": "gid://shopify/Product/456" },
        "timestamp": "2024-01-15T10:30:00Z",
        "$insert_id": "event_123"
      }
    ],
    "context": {
      "$current_url": "https://yourstore.com/products/tshirt",
      "$host": "yourstore.com",
      "$session_id": "session_abc123",
      "genlook_client_id": "550e8400-e29b-41d4-a716-446655440000",
      "genlook_product_id": "gid://shopify/Product/456"
    }
  }'

​
Event Types

EventDescription
widget:button_clickWidget button clicked
widget:image_uploadUser uploaded an image
widget:generation_startGeneration started
widget:result_viewResult displayed
widget:share_clickedShare button clicked
widget:download_clickedDownload button clicked
widget:add_to_cart_clickedAdd to cart from widget
widget:add_to_cart_successAdd to cart succeeded
widget:email_collectedEmail collected
product_page:page_viewProduct page viewed
product_page:cart_addCart add from product page
Event names follow category:action format with snake_case.

​
Response

​
success
boolean
required
Whether the batch was processed.
{
  "success": true
}