Skip to Content
DestinationsOneSignalOverview

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

Events

Vendo sends both client-side and server-side Shopify event streams to OneSignal. See the complete event list in Events & Properties.

Customer Tags

Vendo sets user tags in OneSignal for segmentation. See the complete tag 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 MethodHow It WorksIdentifier Used
Web Push SubscriptionWhen 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 SignupWhen a visitor submits a newsletter/email form on your store, Vendo captures the email and identifies the user.Email
Customer LoginWhen 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 CompletedWhen 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

Platform Details

SettingValue
Sync MethodClient + server-side via Vendo
IdentityShopify Customer ID, Email, or OneSignal ID
DeduplicationUUID v5 hashing per event
Batch Size1,000 events per request
Data FormatAll values stored as strings

Verify Setup

  1. Subscribe to push notifications on your store — confirm the user appears in OneSignal
  2. Log in as a customer — confirm identity merges in OneSignal
  3. Trigger a test event (e.g., view a product) — confirm the event appears in OneSignal
  4. Check Vendo integration logs for recent sync activity

Compatible Sources

OneSignal works with the following Vendo sources:

SourceEventsUser TagsAudiences
ShopifyYesYesYes
MixpanelComing SoonComing SoonComing Soon
AmplitudeComing SoonComing SoonComing Soon
StripeComing SoonComing SoonComing Soon

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.

Last updated on