Push Notifications Setup & Send Guide

Account Setup

There are two ways to set up a Webengage account:

• Default (Superfans-created): A Webengage account is created by us ([email protected]). To get access, contact our support team.

• Migration/existing setups: If you already have a Webengage account, add the details in your Superfans dashboard and enable it.

How to enable the Plugin?

Step 1 : Log in to your Vajro dashboard and go to Settings > Plugins.

Step 2 : Under the Search category, select Webengage and toggle it on.

Step 3 - Paste the License code in the dialogue box, and click on Save & Enable plugin.

Where to get License code?

To obtain the License Code, log in to your WebEngage dashboard, navigate to the Account section, and you will find the License Code listed there.

App rollout is required when the Webengage plugin is enabled or disabled.

Sending Push Notification Campaigns

Before creating a campaign, ensure:

• Android and iOS apps are configured.

• User attributes and custom events are tracked.

• Internal team members are added if testing campaigns.

Step 1: Create a Campaign

1. Go to Channels → Push.

2. Click Create Campaign or the plus (+) icon.

3.Select Campaign Type:

• One-time: Sent once to the selected audience at a scheduled time.

• Recurring: Sent repeatedly at defined intervals (daily, weekly, etc.) to the same or updated audience.

• Triggered: Sent automatically when a user performs a specific action or event.

• Transactional: Sent to confirm or notify users about a transaction or important activity (e.g., order confirmation).

Step 2: Define Audience

1. Give your campaign a name.

2. Select the audience:

   • All users

   • Specific live segment

3. Select Target Apps: Android, iOS, or both.

4. Save & Continue.

Step 3: Campaign Type and Delivery Settings

Under the When section, configure:

1. Delivery Time:

   • Immediate

   • Scheduled for later date/time

2. Frequency Capping & DND Hours:

• Set how often users can receive notifications.

• Block hours if needed.

3. Queueing Settings:

• Optional queuing for overlapping campaigns.

• Save & Continue.

Step 4: Create Push Message

Choose Notification Layout

• Default / Custom Image: Icon or image in collapsed notification.

• Collapsed Image Width: Full or half width (mirrored for RTL languages).

• Text and Actions:

  • Title- Give the title

  • Description- Draft the message

  • On-click actions (mandatory for iOS)

• Advanced Options:

  • Android: Sticky Push, message summary, up to 3 buttons.

  • iOS: Subtitle, predefined CTA buttons.

In-App Message Layouts

Text Layout:

• A simple, compact message for displaying text-based information.

• Includes a title, a brief description, and optional buttons.

• Ideal for quick, non-intrusive announcements or alerts.

Banner Layout:

• Displays a message at the top or bottom of the screen.

• Can include a small image, text, and a call-to-action button.

• Best used for notifications or promotions that don't block the user's view.

Overlay Layout:

• A highly visible, full-screen message that takes over the user's screen.

• Features a large background image, a title, and a description.

• Perfect for critical announcements, special offers, or full-page takeovers.

Special Layouts

Carousel Layout:

• 1-5 images, auto-scroll optional

• Add labels & deep links

Timer Layout (Android Only):

• Countdown, big countdown, or progress bar

• Duration or end-time timer

• Optional image, text, and action

Ratings Layout:

• Personalize title & description

• Background color/image

• Advanced options like auto-dismiss, buttons

Step 5: Add Deep Links (Optional)

Use full URLs when deep linking doesn’t work or when directing to public pages.

Fields: key: url, value: your-website-url

Supported URLs

• Home: https://yourstore.com/home

• Product Page: https://yourstore.com/products/nola-tee

• Collection Page: https://yourstore.com/collections/women-dresses

• Cart Page:https://yourstore.com/cart

• Account Page: https://yourstore.com/account

• Login Page:https://yourstore.com/login

• Search Page:https://yourstore.com/search?q=summer+dresses

In- App Navigation

1. Cart Page → Cart Key: cart & Value: [Empty]

2. Wishlist Page → Wishlist Key: wishlist & Value: [Empty]

3. Account/Profile Page → User Account Key: accounts & Value: [Empty]

4. Notification History→ Notification Center Key: notifications & Value: [Empty]

5. Search Page→ Search Key: search & Value: [Empty]

6. Product Page→ Specific Product Key: product & Value: product id

7. Category/Collection Page→ Specific collection Key: category & Value: your-collection-id

8. Dynamic Page→Custom Page by ID Key: page & Value: your-page-id

9. Custom Content Block→ Custom promo/content Key: customBlock & Value: your-block-id & customBlockType: full_screen

10. External Website→ Open in browser Key: eUrl & Value: https://your-website.com

Save & Continue.

Step 6: Enable Conversion Tracking (Optional)

1. Toggle Conversion Tracking ON.

2. Select Conversion Event:

   • Custom events (e.g., Checkout Completed)

   • System events (Session Started, User Login)

3. Add Event Attributes (optional):

   • AND/OR logic for filtering

   • Attributes: custom fields, location, time

4. Set Conversion Deadline:

   • Default 7 days, customizable in hours or days

Save & Continue.

Step 7: Add Control Groups (Optional)

• Campaign-level Control Group: Random subset of target audience for this campaign.

• Custom Control Group: Pre-created, reusable across campaigns.

• Universal Control Group: Can coexist with campaign-level or custom control groups.

• Notes:

  • Campaign-level and custom cannot be combined.

  • Adding multiple control groups decreases the effective target audience.

Save & Continue.

Step 8: Create Message Variations

• Create up to 5 variations (A–E).

• Options:

  • Create New: Build from scratch.

  • Copy: Duplicate an existing variation and edit.

• Variation Testing:

  • Automated: Test small audience, auto-send winner.

  • Manual: Split audience manually if small (<2,000 for One-time/Recurring, <500 for Triggered).

• Win Criteria: Clicks or Conversions.

Save & Continue.

Step 9: Test Campaign Internally

1. Select Variation to Test.

2. Select Test Segment:

   • Internal team members or custom segment.

3. Personalize Test Message:

   • Use internal user data

   • Or use data of a specific user

4. Send Test:

   • Monitor status: Delivered / Failed

Creating Test Segment

• Name segment (e.g., TEST - Design Team)

• Add users via User ID, email, or phone

• Save segment

Edit / Delete Test Segment

• Edit: Pencil icon → Update users

• Delete: Bin icon → Confirm deletion

Step 10: Preview & Launch

1. Review campaign summary:

   • Audience & target apps

   • Campaign type, delivery, frequency, DND

   • Message variations & OS preview

   • Conversion tracking & variation testing

2. Edit any step via pencil icon.

3. Save as draft if needed.

4. Click Launch Campaign:

   • Scheduled campaigns appear as “Upcoming” until delivery.

Pro Tips

• Test on multiple devices, screen sizes, OS versions.

• Ensure personalized messages use real user data for accurate previews.

• Use control groups to measure campaign impact accurately.

• Always test campaigns with images, buttons, or deep links before going live.

Next Steps

After launching your campaigns, you can analyze performance using WebEngage dashboard metrics:

• User engagement

• Conversions

• Revenue impact