In App Events

In-App Events Generator

Generate complete In-App Event metadata ready for App Store Connect upload, including event cards, descriptions, deep link configuration, and promotional image specifications.

When This Skill Activates

Use this skill when the user:

• Asks to "create in-app events" or "add App Store events"
• Mentions "event cards" or "App Store event metadata"
• Wants to create seasonal campaigns or challenges on the App Store
• Asks about "event badges" or "event promotion"
• Mentions driving engagement through App Store events

How In-App Events Work

In-App Events appear on:

• Your product page (up to 5 events visible)
• Search results (when relevant to search term)
• Editorial features and collections
• Personalized recommendations

Events are visible to ALL users — including people who haven't downloaded your app. This makes them a powerful discovery and re-engagement tool.

Configuration Questions

Ask user via AskUserQuestion:

1. Event type

• Challenge (skill-based competition or goal)
• Competition (leaderboard or ranked event)
• Live Event (real-time participation)
• Special Event (limited-time content or feature)
• Major Update (significant new version)
• New Season (seasonal content refresh)
• Premiere (first-time content debut)

2. Event purpose

• Drive new downloads (acquisition)
• Re-engage lapsed users (re-engagement)
• Increase active user engagement (retention)
• Promote new content/feature (awareness)

3. Number of events to create

• Single event
• Event series (3-5 related events)
• Seasonal calendar (12-month plan)

Generation Process

Step 1: Gather Event Details

For each event, collect:

• Event concept and theme
• Start and end dates
• Target audience (new users, existing users, lapsed users)
• Related app feature or content

Step 2: Generate Metadata

For each event, produce: 1. Event Reference Name (internal, not shown to users) 2. Event Badge (one of the 7 badge types) 3. Event Name (30 characters max, shown on event card) 4. Short Description (50 characters max, shown on event card) 5. Long Description (120 characters max, shown on event detail page) 6. Event Media Specs (image/video requirements) 7. Deep Link (where users land when they tap the event)

Step 3: Generate Image Specs

Provide exact image specifications for event cards:

• Event Card Image: 1080 x 1920 pixels (portrait) or 1920 x 1080 (landscape)
• Format: PNG or JPEG
• Safe zones: Keep critical content within center 80%

Step 4: Produce Output Document

Write a markdown document with all metadata ready for copy/paste into App Store Connect.

Event Badge Reference

Metadata Best Practices

Event Name (30 chars)

• DO: Use action-oriented language ("Join the Challenge", "Explore New Features")
• DO: Include time urgency ("This Week Only", "24-Hour Event")
• DON'T: Use generic names ("Special Event", "Update")
• DON'T: Include app name (it's already shown)

Short Description (50 chars)

• DO: Explain the core value or action
• DO: Create urgency or excitement
• DON'T: Repeat the event name
• DON'T: Use marketing fluff

Long Description (120 chars)

• DO: Provide specific details about what users will experience
• DO: Include clear call to action
• DON'T: List features — describe the experience

Output Format

Single Event Template

# In-App Event: [Event Concept]

## App Store Connect Metadata

| Field | Value |
|-------|-------|
| Reference Name | [internal-name-kebab-case] |
| Badge | [Badge Type] |
| Event Name | [30 chars max] |
| Short Description | [50 chars max] |
| Long Description | [120 chars max] |
| Start Date | [YYYY-MM-DD HH:MM timezone] |
| End Date | [YYYY-MM-DD HH:MM timezone] |
| Event Purpose | [Primary / Informational] |
| Event Priority | [Normal / High] |
| Deep Link | [yourapp://event/event-id] |

## Event Card Image

| Spec | Value |
|------|-------|
| Size | 1080 x 1920 px (portrait) |
| Format | PNG, no transparency |
| Safe Zone | Center 80% for critical content |
| Background | [Color/gradient suggestion] |
| Content | [Visual description] |
| Text Overlay | [Text to include on image] |

## Deep Link Configuration

- URL Scheme: `yourapp://event/[event-id]`
- Universal Link: `https://yourapp.com/event/[event-id]`
- Fallback: App Store product page

## Localization Notes

- [Language]: [Localized event name and descriptions]

Event Series Template

# Event Series: [Series Name]

## Series Overview
[Brief description of the series theme and cadence]

## Events

### Event 1: [Name]
[Same fields as single event template]

### Event 2: [Name]
[Same fields as single event template]

### Event 3: [Name]
[Same fields as single event template]

## Series Strategy
- **Cadence**: [Weekly / Biweekly / Monthly]
- **Escalation**: [How events build on each other]
- **Retention hook**: [What brings users back for the next event]

Annual Calendar Template

# Annual Event Calendar: [App Name]

| Month | Event | Badge | Duration | Goal |
|-------|-------|-------|----------|------|
| Jan | [Event name] | [Badge] | [X days] | [Goal] |
| Feb | [Event name] | [Badge] | [X days] | [Goal] |
| ... | ... | ... | ... | ... |

## Seasonal Themes
- **Q1 (Jan-Mar)**: [Theme — e.g., New Year motivation]
- **Q2 (Apr-Jun)**: [Theme — e.g., Spring refresh, WWDC tie-in]
- **Q3 (Jul-Sep)**: [Theme — e.g., Summer activities, back to school]
- **Q4 (Oct-Dec)**: [Theme — e.g., Halloween, holiday season]

References

• Related: app-store/marketing-strategy — Strategic event planning by app type
• Related: generators/custom-product-pages — Pair events with targeted product pages
• Related: app-store/app-description-writer — Event description writing style
• Apple: App Store Connect Help > In-App Events

In-App Events Templates

Ready-to-use event metadata templates by category and purpose.

Template 1: Fitness Challenge Event

Reference Name: january-fitness-challenge-2025
Badge: Challenge
Event Name: 30-Day Fitness Challenge
Short Description: Complete daily workouts to earn badges
Long Description: Start the new year strong! Complete one workout each day for 30 days. Track your streak, earn exclusive badges, and see how you compare.
Start Date: 2025-01-01 00:00 PST
End Date: 2025-01-31 23:59 PST
Deep Link: yourapp://challenge/january-2025

Image Concept: Energetic gradient (blue → purple), centered "30" with burst effect, workout silhouette at bottom.

---

Template 2: App Major Update

Reference Name: v3-redesign-launch
Badge: Major Update
Event Name: All-New Design & Features
Short Description: Completely redesigned from the ground up
Long Description: Version 3.0 brings a stunning new interface, faster performance, and features you've been asking for. Update now to experience the difference.
Start Date: [release date]
End Date: [release date + 14 days]
Deep Link: yourapp://whats-new

Image Concept: Before/after split screen showing old vs. new UI, clean and modern aesthetic.

---

Template 3: Seasonal Content

Reference Name: holiday-collection-2025
Badge: Special Event
Event Name: Holiday Collection
Short Description: Limited-time festive themes and content
Long Description: Celebrate the holidays with exclusive seasonal themes, festive stickers, and special rewards. Available for a limited time — don't miss out!
Start Date: 2025-12-15 00:00 PST
End Date: 2026-01-05 23:59 PST
Deep Link: yourapp://seasonal/holiday-2025

Image Concept: Holiday-themed with snowflakes, warm colors, gift imagery, app content preview.

---

Template 4: Learning Milestone

Reference Name: vocabulary-sprint-march
Badge: Challenge
Event Name: Vocabulary Sprint
Short Description: Learn 100 new words this month
Long Description: Challenge yourself to learn 100 new vocabulary words in March. Daily goals, progress tracking, and a certificate of completion await. Ready?
Start Date: 2025-03-01 00:00 PST
End Date: 2025-03-31 23:59 PST
Deep Link: yourapp://challenge/vocab-sprint

---

Template 5: Community Event

Reference Name: community-creation-week
Badge: Live Event
Event Name: Community Creation Week
Short Description: Create, share, and vote on community content
Long Description: Join thousands of creators in our biggest community event. Submit your creations, vote on favorites, and win featured placement in the app.
Start Date: 2025-06-15 00:00 PST
End Date: 2025-06-22 23:59 PST
Deep Link: yourapp://community/creation-week

---

Template 6: New Feature Premiere

Reference Name: ai-assistant-premiere
Badge: Premiere
Event Name: Introducing AI Assistant
Short Description: Your new intelligent helper is here
Long Description: Meet your personal AI assistant — powered by on-device intelligence. Ask questions, get suggestions, and work smarter. Available now for all Pro users.
Start Date: [feature release date]
End Date: [release date + 14 days]
Deep Link: yourapp://features/ai-assistant

---

Template 7: Back-to-School

Reference Name: back-to-school-2025
Badge: Special Event
Event Name: Back to School Ready
Short Description: Get organized for the new school year
Long Description: Start the school year prepared with new templates, study tools, and organizational features. Special student pricing available for a limited time.
Start Date: 2025-08-15 00:00 PST
End Date: 2025-09-15 23:59 PST
Deep Link: yourapp://promo/back-to-school

---

Event Card Image Specifications

Required Sizes

Design Guidelines

Layout Structure:

┌─────────────────────────┐
│                         │
│    [Safe Zone - 80%]    │
│                         │
│    ┌─────────────────┐  │
│    │   Key Visual    │  │
│    │   or Feature    │  │
│    │   Screenshot    │  │
│    └─────────────────┘  │
│                         │
│    Event Title Text     │
│    (if text overlay)    │
│                         │
└─────────────────────────┘

Color Palette by Event Type:

• Challenge: Energetic (orange, red, electric blue)
• Competition: Bold (gold, silver, dark backgrounds)
• Live Event: Urgent (red, white, high contrast)
• Special Event: Festive (matches seasonal theme)
• Major Update: Clean (your brand colors, modern)
• New Season: Fresh (greens, blues, seasonal tones)
• Premiere: Premium (dark backgrounds, spotlight effect)

Text on Images:

• Maximum 3-5 words on the image itself
• Use your app's brand font
• Ensure readability at small sizes (event cards are small in browse)
• Don't duplicate the event name (it appears separately)

---

Deep Link Configuration

URL Scheme Setup

// In your App's URL handling
enum DeepLink {
    case event(String)
    case challenge(String)
    case feature(String)
    case promo(String)

    init?(url: URL) {
        guard let host = url.host() else { return nil }
        let path = url.pathComponents.dropFirst().joined(separator: "/")

        switch host {
        case "event": self = .event(path)
        case "challenge": self = .challenge(path)
        case "features": self = .feature(path)
        case "promo": self = .promo(path)
        default: return nil
        }
    }
}

Universal Links (Recommended)

{
    "applinks": {
        "apps": [],
        "details": [{
            "appID": "TEAMID.com.yourapp",
            "paths": ["/event/*", "/challenge/*", "/features/*", "/promo/*"]
        }]
    }
}

---

Event Scheduling Best Practices

Event Duration by Type

Overlap Strategy

• Maximum 5 events visible at once
• Don't overlap events with the same badge type
• Stagger events so one ends as another begins
• Keep at least 1 event active at all times for product page engagement