In App Events

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