Sending Custom Events

Vendo automatically monitors and tracks custom events that you submit through Shopify’s Web Pixel API. Vendo forwards these events to your connected destinations (for example Mixpanel, Segment, or other supported tools). You do not need direct SDK code for each destination.

Automatic Event Properties

For each event that it receives, Vendo automatically adds these event 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 send custom events that contain 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

To identify users, include their customer identifier:

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

To identify the user in destinations that support user identification, the $user_id field must contain the customer identifier. Use the identifier that you selected in Customer Identification (Shopify Customer ID or Email). When Mixpanel is connected, Mixpanel uses $user_id.

3. Custom Tracking Source

To override the default source identifier (“Vendo - Shopify App”), use 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 lets you distinguish different event origins in your tracking data. Mixpanel shows this value when the pixel sends the event to Mixpanel directly. Events that Mixpanel receives through the Vendo ingest API have $source set to Vendo - Server.