Sending Custom Events

Vendo automatically monitors and tracks custom events submitted through Shopify’s Web Pixel API and forwards them to your connected destinations (e.g., Mixpanel, Segment, or other supported tools) without requiring direct SDK code for each destination.

Automatic User Properties

For each event received, Vendo automatically populates these user properties:

• distinct_id
• $device_id
• $insert_id
• $current_url
• page_title
• path_name
• $browser
• $device
• $os
• UTM parameters and Click IDs

Implementation Examples

1. Sending Events with Properties

Use this code structure to transmit custom events containing property data:

<script>
  Shopify.analytics.publish('replace_with_event_name', {
    replace_property_name: 'property_value',
  });
</script>

Replace the placeholder text with your specific event and property identifiers.

2. User Identification

Identify users by including their Shopify Customer ID:

<script>
  Shopify.analytics.publish('replace_with_event_name', {
    property_name: 'xxx',
    $user_id: '6807172218927',
  });
</script>

The $user_id field must contain the Shopify Customer ID to identify the user in destinations that support user identification. Mixpanel will use $user_id when connected.

3. Custom Tracking Source

Override the default source identifier (“Vendo - Shopify App”) using the $source parameter:

<script>
  Shopify.analytics.publish('replace_with_event_name', {
    property_name: 'xxx',
    $user_id: '6807172218927',
    $source: 'my_custom_source',
  });
</script>

The $source property enables distinguishing different event origins within your tracking data. Mixpanel will surface this value in event properties when connected.