OneSignal
Destination — Vendo sends Shopify customer tags and commerce events to OneSignal, so you can launch push campaigns from real behavior and purchase history.
One-Click Installation (No Code)
Vendo deploys the OneSignal client-side widgets for Shopify with one click. You do not need to manually edit Shopify theme code.
Setup Requirements
Before activating OneSignal in Vendo, make sure you have:
- A Shopify store with the Vendo app installed
- A OneSignal app (Web platform)
- OneSignal App ID (required)
- OneSignal REST API Key (required for advanced sync features like user tagging and segment operations)
- Vendo app embed enabled in Shopify theme settings
What Vendo Sends
Customer Tags
Vendo sets user tags in OneSignal for segmentation. All values are stored as strings (OneSignal’s native format):
| Tag | Description |
|---|---|
email | Customer email |
first_name | First name |
last_name | Last name |
total_spent | Lifetime spend (string) |
order_count | Total orders (string) |
verified_email | ”true” or “false” |
tax_exempt | ”true” or “false” |
marketing_state | Marketing consent state |
first_order_date | First order date (ISO 8601 string) |
last_order_date | Most recent order (ISO 8601 string) |
customer_created_at | Customer creation date |
customer_tags | Comma-separated Shopify tags |
email_marketing_consent | Marketing opt-in state |
Events
Vendo sends both client-side and server-side Shopify event streams to OneSignal. See the complete event list in Events & Properties.
How User Identification Works
Vendo uses an identified-only approach for OneSignal — anonymous visitors are not tracked. Users must be identified through one of four methods before events are sent to OneSignal:
| Identification Method | How It Works | Identifier Used |
|---|---|---|
| Web Push Subscription | When a visitor subscribes to push notifications, OneSignal automatically creates a user. Vendo captures the OneSignal ID and uses it for event tracking. | OneSignal ID |
| Newsletter Signup | When a visitor submits a newsletter/email form on your store, Vendo captures the email and identifies the user. | |
| Customer Login | When a customer logs in to their account, Vendo detects this and identifies the user with their Shopify ID or email. | Shopify Customer ID or Email |
| Checkout Completed | When a customer completes a purchase, Vendo identifies them using their Shopify customer ID or email. | Shopify Customer ID or Email |
Identity Merging
If a push subscriber (identified by OneSignal ID) later logs in or makes a purchase, Vendo calls OneSignal.login() with their Shopify ID/email, which links the push subscription to the identified user. This means:
- All past push subscriptions are preserved
- Server-side events (orders, etc.) from the pipeline will reach the correct user
- No duplicate users are created
Why No Anonymous Tracking?
Previous versions tracked anonymous visitors using Shopify’s session cookie as an identifier. This created duplicate OneSignal users that could never be properly merged, leading to inflated user counts and fragmented data. The identified-only approach ensures clean, accurate user data.
Platform Details
| Setting | Value |
|---|---|
| Sync Method | Client + server-side via Vendo |
| Identity | Shopify Customer ID, Email, or OneSignal ID |
| Deduplication | UUID v5 hashing per event |
| Batch Size | 1,000 events per request |
| Data Format | All values stored as strings |
Verify Setup
- Subscribe to push notifications on your store — confirm the user appears in OneSignal
- Log in as a customer — confirm identity merges in OneSignal
- Trigger a test event (e.g., view a product) — confirm the event appears in OneSignal
- Check Vendo integration logs for recent sync activity
Compatible Sources
OneSignal works with the following Vendo sources:
| Source | Events | User Tags | Audiences |
|---|---|---|---|
| Shopify | Yes | Yes | Yes |
| Stripe | Yes | Yes | Yes |
| Mixpanel | — | — | Yes |
| Segment | — | — | Yes |
| Amplitude | — | — | Yes |
Events and user tags require Shopify or Stripe as the data source. Audience segments can be built from any source data in your BigQuery dataset.
Related Guides
- Web Push Setup
- Events & Properties
- How It Works
- Shopify + OneSignal Setup Guide — Step-by-step Shopify-specific setup with event payloads and use cases