Skip to main content

Choose Your Integration Path

Need help deciding? This guide helps you pick the right integration method for your platform.

Takes: 2 minutes to find your perfect match

Quick Decision Tree​

Answer these 3 questions:​

1. What platform are you building on?

Platform-Specific Guides​

Web Applications​

You're building: A website or web app

Best integration method:

Next.js ⭐ Recommended for Next.js apps​

  • Time: 15 minutes
  • Difficulty: Easy
  • Best for: Next.js 13+ (App Router), Cloudflare Pages, Vercel
  • Guide: Next.js Integration

When to use: Building with Next.js, especially on Cloudflare Pages or Vercel.

Key features:

  • Client-side direct API pattern (no server-side proxy needed)
  • Works with Edge Runtime limitations
  • Cloudflare Pages deployment guide included
  • Complete error handling examples

JavaScript SDK ⭐ Recommended for other frameworks​

  • Time: 15 minutes
  • Difficulty: Easy
  • Best for: React, Vue, vanilla JS, any web framework
  • Guide: JavaScript SDK

Code example:

<script src="https://api.loyalteez.app/sdk.js"></script>
<script>
  LoyalteezAutomation.init('YOUR_BRAND_ID');
  // Events auto-tracked!
</script>

When to use: When you want automatic event detection and minimal code.

Direct API Calls (Alternative)​

  • Time: 20 minutes
  • Difficulty: Easy
  • Best for: When you want full control, or using a framework that conflicts with the SDK
  • Guide: Custom Integration

Code example:

fetch('https://api.loyalteez.app/loyalteez-api/manual-event', {
  method: 'POST',
  body: JSON.stringify({
    event: 'user_action',
    email: userEmail
  })
});

When to use: When you want to manually control every event.

Mobile Applications​

You're building: iOS, Android, or cross-platform mobile app

React Native ⭐ Recommended for cross-platform​

When to use: Building for both iOS and Android, or already using React Native.

Native iOS (Swift)​

  • Time: 40 minutes
  • Difficulty: Medium
  • Platforms: iOS only
  • Guide: iOS Integration

When to use: iOS-only app, or want native performance.

Native Android (Kotlin)​

When to use: Android-only app, or want native performance.

Flutter (Dart)​

  • Time: 35 minutes
  • Difficulty: Easy
  • Platforms: iOS + Android with one codebase
  • Guide: Flutter Integration

When to use: Already using Flutter, or prefer Dart.

Quick comparison:

FrameworkTimePlatformsDifficulty
React Native30 miniOS + Android⭐⭐⭐ Easy
iOS Native40 miniOS only⭐⭐ Medium
Android Native40 minAndroid only⭐⭐ Medium
Flutter35 miniOS + Android⭐⭐⭐ Easy

Chat Platforms​

You're building: A chat bot or community integration

Discord Bot ⭐ Most popular​

When to use: Running a Discord community or server.

Example use cases:

  • Reward server members for activity
  • Reward moderation actions
  • Reward event attendance
  • Reward server boosts

Telegram Bot​

When to use: Running a Telegram group or channel.

Example use cases:

  • Reward channel members
  • Reward message activity
  • Reward referrals
  • Reward poll participation

Slack, WhatsApp, WeChat​

When to use: Using other chat platforms with webhook/API support.

Quick comparison:

PlatformMonthly UsersSetup TimeBest For
Discord200M25 minGaming, tech communities
Telegram800M30 minGlobal communities, crypto
Slack20M40 minBusiness, professional groups

E-commerce​

You're building: An online store

Shopify ⭐ Most popular​

When to use: Running a Shopify store (any plan).

What you reward:

  • Purchases (1 LTZ per $1)
  • Account creation
  • First purchase bonuses
  • Product reviews
  • Referrals

WooCommerce (WordPress)​

When to use: Running a WordPress/WooCommerce store.

Custom E-commerce​

When to use: Custom-built store or other platforms (Magento, BigCommerce, etc.).

Quick comparison:

PlatformMarket ShareSetupIntegration Method
Shopify32%45 minWebhooks
WooCommerce26%45 minWordPress hooks
CustomVaries30-60 minDirect API

Gaming​

You're building: A game or game server

Unity (C#)​

When to use: Building with Unity engine.

What you reward:

  • Achievement unlocks
  • Level completion
  • Daily login
  • In-game milestones

Unreal Engine (C++)​

When to use: Building with Unreal Engine.

Web Games (JavaScript)​

When to use: Browser-based games.

Game Servers (Minecraft, etc.)​

When to use: Running game servers with plugin support.

Quick comparison:

PlatformLanguageDifficultyBest For
UnityC#MediumCross-platform games
UnrealC++HardAAA-style games
Web GamesJavaScriptEasyCasual browser games
Game ServersJava/PythonMediumMultiplayer servers

Custom / Other​

You're building: Something unique or not listed above

Choose based on your language:​

Your LanguageIntegration TimeGuide Section
JavaScript/Node.js15 minCustom Integration
Python15 minCustom Integration
Ruby15 minCustom Integration
Go15 minCustom Integration
PHP15 minCustom Integration
Rust20 minCustom Integration
Java20 minCustom Integration
C#20 minCustom Integration

All you need: Ability to make HTTP POST requests.

Integration Comparison Table​

MethodTimeDifficultyBest ForFeatures
JavaScript SDK15 min⭐⭐⭐ EasyWeb appsAuto-detection
React Native30 min⭐⭐⭐ EasyMobile (both platforms)Offline support
Discord Bot25 min⭐⭐⭐ EasyDiscord communitiesChat rewards
Telegram Bot30 min⭐⭐⭐ EasyTelegram groupsGlobal reach
Shopify45 min⭐⭐ MediumE-commercePurchase rewards
Unity30 min⭐⭐ MediumGamesAchievement rewards
Custom API15-60 min⭐⭐ MediumAny platformFull control

Decision Flowchart​

START
  │
  ├─ Building a web app?
  │    └─ YES → JavaScript SDK (15 min)
  │
  ├─ Building a mobile app?
  │    ├─ iOS + Android? → React Native (30 min)
  │    ├─ iOS only? → Native iOS (40 min)
  │    └─ Android only? → Native Android (40 min)
  │
  ├─ Building a Discord bot?
  │    └─ YES → Discord Integration (25 min)
  │
  ├─ Building a Telegram bot?
  │    └─ YES → Telegram Integration (30 min)
  │
  ├─ Running a Shopify store?
  │    └─ YES → Shopify Integration (45 min)
  │
  ├─ Building a game?
  │    ├─ Unity? → Custom (C# section, 30 min)
  │    ├─ Unreal? → Custom (C++ section, 45 min)
  │    └─ Web game? → JavaScript SDK (15 min)
  │
  └─ Something else?
       └─ Custom Integration (15-60 min)
           Pick your language, follow examples

Still Not Sure? Ask These Questions​

Question 1: "Do I have a JavaScript/Node.js environment?"​

Question 3: "What programming language am I most comfortable with?"​

Integration Difficulty Ratings​

⭐⭐⭐ Easy (Beginner-Friendly)​

  • JavaScript SDK (Web)
  • React Native (Mobile)
  • Discord Bot
  • Telegram Bot

Characteristics:

  • Copy-paste code works immediately
  • Detailed step-by-step guides
  • Active community support
  • Well-documented libraries

⭐⭐ Medium (Some Experience Needed)​

  • Native iOS/Android
  • Shopify Integration
  • Unity Games
  • WordPress/PHP

Characteristics:

  • Requires platform-specific knowledge
  • More configuration needed
  • Some troubleshooting may be required
  • Platform-specific tools needed

⭐ Hard (Advanced)​

  • Unreal Engine (C++)
  • Low-level game engines
  • Complex custom platforms

Characteristics:

  • Deep technical knowledge required
  • Manual implementation needed
  • Advanced debugging skills
  • Custom architecture

Good news: We have examples for all difficulty levels!

Feature Comparison​

FeatureSDKMobileDiscordTelegramShopifyCustom
Auto event tracking✅❌❌❌⚠️❌
Offline support⚠️✅N/AN/AN/AOptional
Push notifications❌✅✅✅⚠️Optional
Chat integration❌❌✅✅❌Optional
E-commerce ready⚠️❌❌❌✅Optional
Setup time15 min30-40 min25 min30 min45 min15-60 min

✅ = Included
⚠️ = Partial support
❌ = Not applicable
Optional = You can implement

Need More Help?​

Still can't decide?​

Email us: [email protected]

Tell us:

  1. What platform you're building on
  2. What programming language you use
  3. What you want to reward users for

We'll recommend the best integration method for you!

Want to see examples first?​

Check out our Integration Overview to see all possibilities.

Want to understand the basics first?​

Read Understanding Concepts for a beginner-friendly explanation.

Quick Recommendations​

"I want the fastest integration"​

→ JavaScript SDK (15 minutes)

"I want mobile app integration"​

→ React Native (30 minutes, both iOS + Android)

"I want to reward my Discord community"​

→ Discord Bot (25 minutes)

"I want to reward my e-commerce customers"​

→ Shopify Integration (45 minutes)

"I want maximum flexibility"​

→ Custom Integration (15-60 minutes, your language)

Next Steps​

  1. Pick your integration method from above
  2. Click the guide link for step-by-step instructions
  3. Follow the guide (usually 15-45 minutes)
  4. Test with a few users
  5. Launch! 🚀

You got this! Every guide includes copy-paste code examples and troubleshooting help.

Last updated on