Creating Your First In-App Message

Follow this simple guide to create engaging messages that connect with your audience.

Quick Start

🎯 Before You Begin

1. 📝 Prepare Your Content

   • Write your message text
   • Pick a background image (1200x800px works best)
   • Decide what action you want users to take
   • Choose who should see your message

2. 📅 Plan Your Campaign

   • Pick when your message should appear
   • Set start and end dates
   • Choose the right timezone

Step-by-Step Guide

Step 1: 🚀 Open the In-App Messaging Tool

Step 2: 📝 Set Up Your Basic Details

Campaign Information

• 📋 Campaign Name: Give your message a name (like "Summer Sale 2025")
• 🌍 Start Timezone: Pick your audience's timezone
• ⏰ Start Date & Time: When should your message begin?
• 📅 End Date & Time: (Optional) When should it stop?

Message Content

• 📱 Size: Choose "Full Screen" or "Half Screen"
• 📋 Title: Write your headline (keep it under 50 characters)
• 📄 Description: Add your message text (supports formatting)

Step 3: 🖼️ Add Your Background Image

Upload Your Image

1. Click "Upload Image" in the Image section
2. Select your image (JPG, PNG, or WebP under 2MB)
3. Preview the image to make sure it looks good
4. Remove and re-upload if needed using the "X" button

💡 Image Tips:

• Use high-quality, relevant images
• Make sure text is readable over your image
• Test how it looks on different backgrounds

Step 4: 🔘 Set Up Your Action Buttons

Primary Button (Required)

1. Turn ON the "Include In-App Message Button" toggle
2. Button Text: Write your call-to-action (like "Get Started", "Learn More")
3. Action URL: Add the link where users should go when they click

Secondary Button (Optional)

1. Turn ON "Add Secondary Button" toggle
2. Configure button text and action URL
3. Use for alternative actions like "Maybe Later" or "Dismiss"

Step 5: 🎯 Choose Your Audience & Timing

Pick Your Trigger

1. Click the "Trigger" dropdown (this is required)
2. Choose when your message appears:
   • 🌍 Everywhere: Shows on any page
   • 🚀 App Launched: When someone opens your app
   • 🧭 Navigating to Page: When users visit specific pages
   • 🎬 Finished Watching: After someone finishes a video

Select Your Audience

1. Click the "Visibility" field (shows "0 selected")
2. Choose your target audience
3. ⚠️ Important: You must pick an audience for your message to work!
4. Check the preview to see how many people will see your message

Step 6: 👀 Preview Your Message

1. Look at the mobile preview on the right side of the screen
2. Check how your message looks on the simulated phone
3. Verify everything looks good:
   • ✅ Background image displays correctly
   • ✅ Title and description text are readable
   • ✅ Buttons are positioned properly
   • ✅ Close button works

Configuration Details

📱 Message Size Options

Full Screen Messages

• Perfect for: Big announcements, welcoming new users, exclusive offers
• Content: Room for longer text and multiple elements
• Impact: Gets maximum attention (but more intrusive)

Half Screen Messages

• Perfect for: Regular promotions, feature announcements, gentle reminders
• Content: Limited space - keep text short and sweet
• Impact: Less disruptive, users can still see your app

📝 Content Writing Tips

Title Best Practices

• Keep it short (under 50 characters)
• Use action words like "Get", "Try", "Discover"
• Be specific about what users will get
• Avoid generic phrases like "Click Here"

Description Tips

• Use formatting to make text stand out
• Keep paragraphs short and easy to scan
• Include clear value - what's in it for users?
• Use bullet points for multiple benefits

🔘 Button Configuration

• Primary Button: Your main call-to-action
• Secondary Button: Alternative action or dismiss option
• URL Types: Internal pages, external sites, deep links, app store links

🎯 Targeting Options

Platform Targeting

• 📱 iOS: Target iPhone and iPad users
• 🤖 Android: Target Android device users
• 🌐 Web: Target web browser users

Audience Segments

• 👥 Custom Segments: Groups you've created based on behavior
• 🌍 Geographic: Target by location
• 📊 Behavioral: New users, returning users, active users
• 💳 Subscription: Free users vs premium subscribers

Preview & Testing

👀 Preview Features

The preview panel shows exactly how your message will appear to users:

• 📱 Mobile Device Mockup: Realistic phone interface
• ⚡ Live Updates: Changes reflect immediately as you edit
• ❌ Close Button: Shows the "X" button users will see
• 🔘 Button Styling: Displays actual button appearance

🧪 Testing Strategy

Before Publishing

1. 📝 Content Review: Check spelling, grammar, and messaging
2. 👁️ Visual Check: Ensure image quality and text readability
3. 🔗 Link Testing: Verify all URLs work correctly
4. 📱 Mobile Preview: Confirm it looks good on mobile devices

Small Audience Testing

1. 👥 Create Test Segment: Include yourself and team members
2. ⏰ Short Duration: Set brief time windows for testing
3. 👀 Monitor Display: Check if messages appear correctly
4. 🖱️ Test Interactions: Verify button clicks and navigation

Publishing

✅ Final Review Checklist

🚀 Publishing Steps

1. ✅ Review Configuration: Go through the checklist above
2. 📤 Submit Campaign: Click the "Submit" button
3. ✅ Confirmation: You'll receive confirmation that your campaign is active
4. 👀 Monitor: Watch for any issues in the first few hours
5. 🔧 Adjust: Make changes if needed (you can edit active campaigns)

📊 Post-Publishing

Monitoring Your Campaign

• 👀 Check that messages are appearing for your target audience
• 💬 Monitor user feedback and support tickets
• 📈 Track any changes in user behavior
• 🔧 Be ready to pause or modify if issues arise

Optimization

• 🧪 A/B test different variations
• ⏰ Adjust timing based on user behavior
• 🎯 Refine targeting based on performance
• 📅 Update content for seasonal relevance

---

🎉 You're Ready to Create!

💡 Pro Tip: Always start with a small test audience before launching to your full user base. This helps you catch any issues and optimize your message before reaching all users.

🚀 Ready to create your first campaign? Follow these steps and you'll be engaging your audience with targeted in-app messages in no time!