🎯 Marketing strategies and campaigns

Botoscope includes a powerful marketing system that lets you create flexible discount strategies and run promotional campaigns directly in your Telegram store. This feature is perfect for seasonal sales, clearance events, or targeted product promotions.

📋 How It Works: Two-Step Process

The marketing system consists of two parts:

1. Strategies — define the discount logic using formulas
2. Campaigns — apply strategies to specific products and time periods

🔧 Step 1: Create a Marketing Strategy

📝 Basic Strategy Setup

1. Go to the Marketing tab in Botoscope admin panel
2. Click STRATEGIES button
3. Click “NEW MARKETING STRATEGY”
4. Fill in the following fields:
   • Title — internal name for your reference (e.g., “Black Friday”, “Buy 2 Get 1”)
   • Description — internal note explaining the strategy logic

🧮 Understanding Discount Formulas

After creating a strategy, you must define at least one formula. Click “MANAGE” next to your strategy to add formulas.

Formula Structure:

Every formula follows this pattern:

condition ; discount ; modifiers

Three parts that define your discount:

1. Condition — when the discount applies (cart quantity rules)
2. Discount — how much to discount (percentage or fixed amount)
3. Modifiers — additional rules (which items, intervals, limits)

📐 Complete Example with Breakdown:

c >= 6 & c < 12; 25%; 3n, me, cap=3

🔧 Condition Operators:

💰 Discount Values:

• 50% — percentage discount (50% off)
• 100% — free item (100% off)
• 10 — fixed amount (e.g., $10 off)

🎛️ Available Modifiers:

📚 Common Formula Examples:

Buy 2, Get Cheapest 50% Off:
c>=2; 50%; mc

Buy 3, Get Cheapest Free:
c>=3; 100%; mc

Buy 2, Get 50% Off Second One:
c>=2; 50%; 2n, mc

Buy 3+, Every 2nd Item Free:
c>=3; 100%; mc, cap=2

⚡ Multiple Formulas: Last One Wins

You can add multiple formulas to create tiered discounts. However, remember:

• ✅ One product = one active formula
• ✅ Last matching formula takes priority
• ✅ Order matters — arrange formulas from least to most generous

Example Strategy with Multiple Formulas:

Formula 1: c>=2; 50%; mc
Formula 2: c>=3; 100%; mc, cap=2

Result:
- Cart with 2 items → 50% off cheapest (Formula 1)
- Cart with 3+ items → 2 cheapest items free (Formula 2 wins)

📢 Step 2: Create a Marketing Campaign

Once you have a strategy with formulas defined, create campaigns to activate them for your customers.

🎪 Campaign Setup

1. Click the CAMPAIGNS button
2. Click “NEW MARKETING CAMPAIGN”
3. Configure the campaign:
   • Description — customer-facing title (e.g., “Black Friday – 50% OFF”)
   • Strategy — select which strategy to apply
   • Date Range — set start and end date/time
   • Active Toggle — enable or disable the campaign

🎯 Apply to Specific Products

By default, campaigns apply to all products. To target specific items, click “MANAGE PRODUCTS”.

🔍 Product Search Options:

• By name — type 3+ characters (e.g., “shirt”)
• By product ID — type exact ID (e.g., 123)
• Show all variations — use v[ID] format

Example:
Search: v27 Shows: Red/Large, Blue/Medium, Green/Small, etc.

🧪 Test Mode Feature

Test campaigns privately before launching to all customers.

Setup Test Mode:

1. Add your Telegram Admin Chat ID to wp-config.php:

   define('BOTOSCOPE_ADMIN_CHAT_ID', 1234567890);

2. Toggle “Test mode” ON in campaign settings
3. Campaign becomes visible only to you in Telegram
4. Test checkout and discount calculations
5. Disable Test Mode when ready to launch publicly

🚫 Important Limitations

• 🎫 Coupons disable marketing campaigns — if a customer applies a coupon code, all marketing strategies are automatically disabled for that order to prevent discount stacking
• 🔢 One formula per product — strategies can have multiple formulas, but only one applies to each product
• ⏱️ One active campaign at a time — activating a new campaign disables others automatically

✅ Campaign Best Practices

• 📅 Schedule in advance — set future start dates for automated launches
• 🎯 Target slow movers — use product selection for clearance items
• 🧪 Always test first — verify calculations with Test Mode
• 📊 Keep formulas simple — complex logic confuses customers
• ⏰ Set end dates — avoid running expired promotions accidentally