How Appizer Works | Appizer API Documentation

From Zero to Automated Re-Engagement in 30 Minutes

Quick Start: This guide will walk you through the complete setup process. Each phase builds on the previous one, so follow them in order.

The Complete Workflow

Appizer follows a simple 4-phase workflow that takes you from signup to live campaigns in about 30 minutes.

Workflow Steps:

Phase 1: Setup - Create account and connect WonderPush
Phase 2: Track Events - Implement event tracking in your app
Phase 3: Configure - Set up analytics and prompt context
Phase 4: Launch Campaigns - Create audiences and campaigns
Result: Automated Re-Engagement 24/7

Pro Tip: You can complete phases 1 to 3 in as little as 20 minutes using our agentic integration with v0, Bolt, or Windsurf.

Phase 1: Account Setup (5 minutes)

Step 1: Create Your Appizer Account

Go to appizer.com/signup
Sign up with Google or Email
Create your first app/project

What You Get:

Appizer API key: sk_live_xxxxx (keep this secret)
App ID: app_abc123
Access to the dashboard

Security Notice: Never expose your API key in client-side code or commit it to version control. Always use environment variables in production.

Step 2: Connect WonderPush

WonderPush is the delivery platform that actually sends your push notifications. It is extremely affordable (about 1 dollar per 1,000 users per month).

Create a WonderPush account (if you don't have one)
Get your WonderPush credentials:
- Client ID
- Client Secret
Paste them into Appizer app settings
Click "Test Connection"
Verify: Green checkmark "Connected"

Why WonderPush?

Affordable: about 1 dollar per 1,000 subscribers per month
Reliable: Owned by Brevo (1 billion dollar plus valuation company)
Flexible: Works with web, iOS, Android

Phase 2: Track Events (10 to 30 minutes)

This is where Appizer learns what your users are doing. Without event tracking, Appizer can't identify disengaging users.

Option A: Agentic Integration (Recommended, 5 to 10 minutes)

Perfect for: v0, Bolt, Windsurf, Cursor, Replit, Lovable users

Go to Appizer dashboard, then Integration Guides
Select your platform (e.g., "v0.dev")
Copy the platform-specific prompt
Paste into your IDE's AI assistant
Replace these variables:
- [APPIZER_API_KEY] = Your API key
- [WONDERPUSH_CLIENT_ID] = From WonderPush
- [WONDERPUSH_CLIENT_SECRET] = From WonderPush
Hit "Submit" or "Run"
AI automatically implements event tracking

Time: 5 to 10 minutes
Difficulty: Beginner

Option B: Manual Integration (20 to 30 minutes)

Perfect for: Developers who prefer manual control

Install Dependencies

npm install wonderpush-sdk axios

Initialize WonderPush

import WonderPush from 'wonderpush-sdk';

// On app startup
WonderPush.initialize({
  clientId: process.env.WONDERPUSH_CLIENT_ID,
  userId: getCurrentUserId() // From your auth system
});

Create Event Tracking Function

async function trackEvent(eventName, properties = {}) {
  try {
    await fetch('https://api.appizer.com/v1/events', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        api_key: process.env.APPIZER_API_KEY,
        user_id: getCurrentUserId(),
        event_name: eventName,
        properties: properties,
        timestamp: new Date().toISOString()
      })
    });
  } catch (error) {
    console.error('Event tracking failed:', error);
  }
}

Track Key Events

// On page load
trackEvent('page_view', { page: '/home' });

// On button click
function handlePlayClick() {
  trackEvent('button_click', { button: 'play' });
  startGame();
}

// On conversion
function handleSignup(email) {
  trackEvent('form_submit', { form: 'signup' });
  createUser(email);
  trackEvent('conversion', { type: 'signup' });
}

What Events Should You Track?

Minimum Recommended:

page_view - User navigated to a page
app_open - User opened the app
button_click - User clicked an important button
form_submit - User submitted a form
conversion - User completed a goal (signup, purchase, etc.)

Domain-Specific Examples:

For Games:

level_complete - User finished a level
achievement_unlock - User earned a badge
tutorial_start - User began tutorial
streak_broken - User lost their streak

For SaaS:

feature_used - User accessed a feature
payment_processed - User made a payment
team_invite - User invited a teammate
upgrade - User upgraded plan

For E-commerce:

product_view - User viewed a product
add_to_cart - User added item to cart
purchase - User completed purchase
wishlist_add - User saved item

Verify Events Are Working

Perform actions in your app (click buttons, navigate pages)
Open browser DevTools, then Network tab
Look for requests to api.appizer.com/v1/events
Confirm they return 200 OK
Go to Appizer dashboard, then Activity Explorer
You should see events appearing in real-time

Checkpoint: Events visible in Activity Explorer

Great Work! Your event tracking is now set up! This is the foundation that enables Appizer's AI to understand user behavior and send personalized re-engagement messages.

Phase 3: Configure Analytics (5 minutes)

Make your AI smarter by providing context about your app.

Add Prompt Context (Recommended)

Tell Appizer what your app is about so AI can generate better messages:

Example for a Game:

PointCoin is a mobile rewards app where users earn points by completing 
actions and playing mini-games. Users love earning streaks and competing 
on leaderboards. Keep messages fun, achievement-focused, and motivational.

Example for SaaS:

TaskFlow is a productivity tool for small teams. Users value collaboration 
and time-saving features. Messages should highlight productivity gains and 
team benefits.

Example for Social App:

BookClub is a social reading community. Users want to feel part of a 
reading tribe. Messages should celebrate connections and shared interests.

Create Event Dictionary (Optional but Helpful)

Give human-readable descriptions to your events:

Event Name	Description
`level_complete`	User finished a game level
`achievement_unlock`	User earned a badge or achievement
`reward_claimed`	User claimed earned points or rewards
`rewarded_video_ad_failed`	User tried to load a video ad but it failed

Why This Matters: AI uses these descriptions to generate better insights and more relevant messages.

Configure Email (Optional)

If you want email campaigns in addition to push:

Create a Brevo account
Get your Brevo API key
Paste into Appizer app settings, then Brevo Integration
Click "Test Connection"

Note: Email is optional for v1. Push notifications are the primary channel.

Phase 4: Launch Campaigns (5 to 10 minutes)

Now comes the magic - automated re-engagement.

Step 1: Create Your First Audience

An audience is a group of users you want to target.

Option A: AI Natural Language (Easiest)

Go to Audiences, then Create Audience
Type in plain English: "Users who haven't been seen in 3 days"
Click "Create"
See live user count update

Option B: Manual Builder

Go to Audiences, then Create Audience, then Manual
Add filter: last_event more than 72 hours ago
Save audience
See live user count

Popular Audience Examples:

"Users inactive for 2 days"
"New users who never completed onboarding"
"Power users with 50 or more actions"
"Users who abandoned cart"
"Users with broken streaks"

Step 2: Create Your First Campaign

Go to Push Campaigns, then Create Campaign
Name: "3-Day Inactive Re-engagement"
Select Audience: Choose the audience from Step 1
Message: Choose one:

Option A: Write Static Message

Missing you! Come back for daily rewards

Option B: AI-Generated (Recommended)

Generate an encouraging message to bring back users who love puzzle games. 
Mention their progress and invite them to continue their streak. 
Keep it under 100 characters and fun.

AI will generate unique messages per user like:

"Your 5-game streak is waiting! "
"New puzzles just for you! Come play "
"You're so close to level 10! Finish today "

Send Timing: Choose one:
- Immediate (test send)
- Scheduled (specific date/time)
- Recurring (Recommended): Every day at 9 AM
Frequency Cap: Max 3 messages per user per day
Click "Review & Launch"

Step 3: Send Test Push

Before going live:

Click "Send Test" in campaign settings
Send to your device
Verify:
- Push notification appears
- Message looks good
- Timing is right

Step 4: Go Live

Set campaign status to "Live"
Confirm launch
Monitor metrics:
- Sends: Number sent
- Delivery: % successfully delivered
- Open Rate: % users opened (aim for more than 15%)
- Click Rate: % users clicked action

Checkpoint: First campaign is live and sending automatically

What Happens Next (Automated)

Once your campaign is live, here's what happens automatically:

Every 10 Minutes

Appizer re-evaluates your audiences
Identifies new users who match criteria
Updates segment membership

At Your Scheduled Time (e.g., 9 AM daily)

AI generates unique messages for each user
Messages are personalized based on:
- User's event history
- App prompt context
- Event dictionary descriptions
- Recent activity patterns
WonderPush delivers messages
Results are tracked in real-time

24/7 Monitoring

Dashboard shows live metrics
AI generates daily insights:
- "Your app had 109 daily active users yesterday, up 2% from the day before"
- "PointCoin saw 12 users complete a level in the last 24 hours"
- "Campaign 'Re-engagement' has 23% open rate (above average)"

The Complete Flow Visualized

WORKFLOW:

USER BEHAVIOR
- User plays game, Tracks event, Appizer receives
- User goes inactive for 3 days

APPIZER AI ANALYSIS
- Detects user is in "Inactive 3 days" audience
- Reviews user's event history
- Reads app prompt context
- Generates personalized message: "Your 5-game streak is waiting! Claim 50 points"

WONDERPUSH DELIVERY
- Sends push notification to user's device
- Tracks delivery status
- Reports back to Appizer

USER RETURNS
- User sees notification
- Opens app
- Continues playing
- New events tracked, Cycle continues

Advanced Workflows

Multi-Campaign Strategy

After your first campaign works, add more:

Campaign 1: New User Welcome

Audience: "Users created account in last 24 hours"
Message: "Welcome! Here's how to get started "
Timing: 1 hour after signup

Campaign 2: Onboarding Incomplete

Audience: "Users who signed up but never completed action X"
Message: "You're missing out! Complete setup in 2 minutes"
Timing: Day 3 after signup

Campaign 3: Power User Recognition

Audience: "Users with 50 or more actions"
Message: "You're in the top 1%! Here's something special "
Timing: Weekly

Campaign 4: Churn Recovery

Audience: "Users inactive for 7 days"
Message: "We miss you! Come back for double rewards"
Timing: Daily at 5 PM

Event-Triggered Campaigns

Send messages immediately after specific events:

Trigger: User completes level 10
Message: "Amazing! You've unlocked hard mode "
Timing: Immediately

Trigger: User's streak breaks
Message: "Don't give up! Start a new streak today"
Timing: 2 hours after streak breaks

Measuring Success

Key Metrics to Track

Campaign Performance:

Open Rate: 15 to 25% is good, more than 25% is excellent
Click Rate: 5 to 10% is good, more than 10% is excellent
Conversion Rate: Depends on your goal

App Health:

DAU (Daily Active Users): Should increase or stabilize
7-Day Retention: Should improve by 30 to 100%
Sessions per User: Should increase by 50 to 150%

ROI Indicators:

Time saved on manual campaigns: approximately 5 to 10 hours per week
Cost vs. enterprise platforms: Save 450 to 4950 per month
User LTV improvement: 2 to 3 times with better retention

Optimization Tips

If Open Rate is Low (less than 10%):

Test different message copy
Try different send times
Make messages more personalized
Check frequency (too many = fatigue)

If Users Don't Convert:

Review your call-to-action
Make the value clearer
Test different audience segments
Add urgency ("Limited time!")

Next Steps

Quick Start Guide - Follow our step-by-step tutorial to get your first campaign live
Explore Features - Deep dive into AI analytics, segmentation, and campaigns
API Documentation - Explore the full API reference and endpoints
Component Examples - See documentation components in action

Common Questions

Q: How long until I see results?
A: Most apps see improved retention within 7 to 14 days. PointCoin saw 250 percent increase in DAU in 30 days.

Q: Can I change campaigns after they're live?
A: Yes! You can pause, edit, or delete campaigns anytime.

Q: What if I don't have users yet?
A: Perfect! Set up Appizer before launch so retention is built-in from day one.

Q: How many campaigns should I create?
A: Start with 1 or 2, then expand to 4 to 6 campaigns covering different user journeys.

See all FAQs