> ## Documentation Index
> Fetch the complete documentation index at: https://kb.aampe.com/llms.txt
> Use this file to discover all available pages before exploring further.

# User Events sample data

> A set of dummy events of several industries which help understand the Aampe data model

## Industry-Specific Event Samples

This guide provides comprehensive event examples for different industries, showing how to structure your events using the Aampe API/data dump. Each sample includes complete JSON payloads that you can adapt for your specific use case.

## E-commerce & Retail

### Product Discovery Journey

**Product Search Event**

<CodeGroup>
  ```json json theme={null}
  {
    "contact_id": "user_456789",
    "event_name": "product_searched",
    "timestamp": 1672531200,
    "event_id": "search_001",
    "metadata": {
      "search_term": "wireless headphones",
      "category": "electronics",
      "filters_applied": ["brand:sony", "price:50-200"],
      "results_count": 24,
      "search_location": "header_search",
      "session_id": "sess_abc123"
    }
  }
  ```
</CodeGroup>

**Product View Event**

<CodeGroup>
  ```json json theme={null}
  {
    "contact_id": "user_456789",
    "event_name": "product_viewed",
    "timestamp": 1672531260,
    "event_id": "view_001",
    "metadata": {
      "product_id": "prod_WH001",
      "product_name": "Sony WH-1000XM4 Wireless Headphones",
      "product_category": "Electronics > Audio > Headphones",
      "product_price": 299.99,
      "currency": "USD",
      "brand": "Sony",
      "in_stock": true,
      "product_rating": 4.5,
      "total_reviews": 1247,
      "referrer_source": "search_results"
    }
  }
  ```
</CodeGroup>

### Shopping Cart Journey

**Add to Cart Event**

<CodeGroup>
  ```json json theme={null}
  {
    "contact_id": "user_456789",
    "event_name": "product_added_to_cart",
    "timestamp": 1672531320,
    "event_id": "cart_add_001",
    "metadata": {
      "product_id": "prod_WH001",
      "quantity": 1,
      "variant_id": "color_black",
      "cart_id": "cart_xyz789",
      "unit_price": 299.99,
      "cart_value": 299.99,
      "cart_item_count": 1,
      "add_source": "product_page",
      "discount_applied": false
    }
  }
  ```
</CodeGroup>

**Checkout Started Event**

<CodeGroup>
  ```json json theme={null}
  {
    "contact_id": "user_456789",
    "event_name": "checkout_started",
    "timestamp": 1672531500,
    "event_id": "checkout_001",
    "metadata": {
      "cart_id": "cart_xyz789",
      "cart_value": 299.99,
      "item_count": 1,
      "shipping_method": "standard",
      "payment_method_selected": "credit_card",
      "coupon_code": "WELCOME10",
      "discount_amount": 29.99,
      "final_amount": 269.99,
      "currency": "USD"
    }
  }
  ```
</CodeGroup>

**Purchase Completed Event**

<CodeGroup>
  ```json json theme={null}
  {
    "contact_id": "user_456789",
    "event_name": "order_completed",
    "timestamp": 1672531800,
    "event_id": "order_001",
    "metadata": {
      "order_id": "ORD_2023_001",
      "order_value": 269.99,
      "payment_method": "visa_ending_1234",
      "shipping_method": "standard_delivery",
      "products": ["prod_WH001"],
      "quantities": [1],
      "shipping_address": "New York, NY",
      "estimated_delivery": "2023-01-03",
      "is_first_purchase": false,
      "order_source": "web"
    }
  }
  ```
</CodeGroup>

## SaaS & Software

### User Onboarding Flow

**Account Registration Event**

<CodeGroup>
  ```json json theme={null}
  {
    "contact_id": "user_789012",
    "event_name": "user_registered",
    "timestamp": 1672532000,
    "event_id": "reg_001",
    "metadata": {
      "registration_method": "email",
      "email_domain": "company.com",
      "referral_source": "google_ads",
      "utm_campaign": "winter_promotion",
      "selected_plan": "starter",
      "team_size": "1-10",
      "industry": "marketing",
      "use_case": "email_campaigns",
      "trial_days": 14
    }
  }
  ```
</CodeGroup>

**Feature Adoption Event**

<CodeGroup>
  ```json json theme={null}
  {
    "contact_id": "user_789012",
    "event_name": "feature_first_used",
    "timestamp": 1672532400,
    "event_id": "feature_001",
    "metadata": {
      "feature_name": "email_builder",
      "feature_category": "core",
      "time_to_adoption": 3600,
      "user_tenure_days": 1,
      "session_id": "sess_def456",
      "guided_tour_completed": true,
      "help_docs_accessed": ["getting_started", "email_templates"]
    }
  }
  ```
</CodeGroup>

### Engagement & Usage

**Project Created Event**

<CodeGroup>
  ```json json theme={null}
  {
    "contact_id": "user_789012",
    "event_name": "project_created",
    "timestamp": 1672532800,
    "event_id": "proj_001",
    "metadata": {
      "project_id": "proj_ABC123",
      "project_name": "Q1 Newsletter Campaign",
      "project_type": "email_campaign",
      "template_used": "newsletter_modern",
      "team_members_invited": 2,
      "estimated_send_volume": 5000,
      "creation_source": "dashboard"
    }
  }
  ```
</CodeGroup>

**Subscription Upgraded Event**

<CodeGroup>
  ```json json theme={null}
  {
    "contact_id": "user_789012",
    "event_name": "subscription_upgraded",
    "timestamp": 1672533200,
    "event_id": "sub_upgrade_001",
    "metadata": {
      "previous_plan": "starter",
      "new_plan": "professional",
      "upgrade_reason": "usage_limit_reached",
      "annual_billing": true,
      "upgrade_value": 588.00,
      "features_unlocked": ["advanced_analytics", "a_b_testing", "priority_support"],
      "trial_days_remaining": 7
    }
  }
  ```
</CodeGroup>

## Media & Entertainment

### Content Consumption

**Video Started Event**

<CodeGroup>
  ```json json theme={null}
  {
    "contact_id": "user_345678",
    "event_name": "video_started",
    "timestamp": 1672534000,
    "event_id": "video_start_001",
    "metadata": {
      "video_id": "vid_DEF789",
      "video_title": "Advanced React Patterns",
      "video_duration": 2400,
      "video_category": "Technology",
      "series_id": "series_react_mastery",
      "episode_number": 5,
      "video_quality": "1080p",
      "device_type": "desktop",
      "player_version": "v2.1.0",
      "autoplay": false
    }
  }
  ```
</CodeGroup>

**Content Engagement Event**

<CodeGroup>
  ```json json theme={null}
  {
    "contact_id": "user_345678",
    "event_name": "video_progress",
    "timestamp": 1672534600,
    "event_id": "video_progress_001",
    "metadata": {
      "video_id": "vid_DEF789",
      "progress_percentage": 25,
      "watch_time": 600,
      "playback_speed": 1.0,
      "quality_changes": 0,
      "paused_count": 2,
      "seek_count": 1,
      "engagement_score": 0.85
    }
  }
  ```
</CodeGroup>

**Subscription Event**

<CodeGroup>
  ```json json theme={null}
  {
    "contact_id": "user_345678",
    "event_name": "content_creator_followed",
    "timestamp": 1672535000,
    "event_id": "follow_001",
    "metadata": {
      "creator_id": "creator_tech_guru",
      "creator_name": "Tech Guru",
      "creator_category": "Technology",
      "follower_count": 125000,
      "follow_source": "video_page",
      "notification_enabled": true,
      "user_following_count": 47
    }
  }
  ```
</CodeGroup>

## Food & Beverage Delivery

### Restaurant Discovery

**Restaurant Search Event**

<CodeGroup>
  ```json json theme={null}
  {
    "contact_id": "user_901234",
    "event_name": "restaurant_searched",
    "timestamp": 1672535400,
    "event_id": "rest_search_001",
    "metadata": {
      "search_term": "italian pizza",
      "location": "Manhattan, NY",
      "delivery_time_filter": "30_minutes",
      "price_range_filter": "$$",
      "cuisine_filters": ["italian"],
      "dietary_filters": ["vegetarian_options"],
      "results_count": 18,
      "sort_by": "delivery_time"
    }
  }
  ```
</CodeGroup>

**Menu Browsing Event**

<CodeGroup>
  ```json json theme={null}
  {
    "contact_id": "user_901234",
    "event_name": "menu_item_viewed",
    "timestamp": 1672535600,
    "event_id": "menu_view_001",
    "metadata": {
      "restaurant_id": "rest_mario_pizza",
      "restaurant_name": "Mario's Authentic Pizza",
      "item_id": "item_margherita_large",
      "item_name": "Large Margherita Pizza",
      "item_category": "Pizza",
      "item_price": 18.99,
      "item_description": "Fresh mozzarella, basil, tomato sauce",
      "dietary_tags": ["vegetarian"],
      "prep_time": 20,
      "popularity_rank": 2
    }
  }
  ```
</CodeGroup>

### Order & Delivery Journey

**Order Placed Event**

<CodeGroup>
  ```json json theme={null}
  {
    "contact_id": "user_901234",
    "event_name": "order_placed",
    "timestamp": 1672536000,
    "event_id": "order_food_001",
    "metadata": {
      "order_id": "ORD_FOOD_001",
      "restaurant_id": "rest_mario_pizza",
      "order_value": 28.47,
      "delivery_fee": 2.99,
      "service_fee": 1.99,
      "tip_amount": 4.50,
      "total_amount": 28.47,
      "items": [
        {
          "item_id": "item_margherita_large",
          "quantity": 1,
          "unit_price": 18.99,
          "customizations": ["extra_cheese"]
        }
      ],
      "delivery_address": "123 Main St, Apt 4B",
      "estimated_delivery": 35,
      "payment_method": "credit_card"
    }
  }
  ```
</CodeGroup>

**Delivery Tracking Event**

<CodeGroup>
  ```json json theme={null}
  {
    "contact_id": "user_901234",
    "event_name": "delivery_status_updated",
    "timestamp": 1672536800,
    "event_id": "delivery_update_001",
    "metadata": {
      "order_id": "ORD_FOOD_001",
      "status": "out_for_delivery",
      "previous_status": "preparing",
      "estimated_arrival": 1672537200,
      "driver_id": "driver_john_d",
      "driver_name": "John D.",
      "driver_rating": 4.8,
      "delivery_vehicle": "bicycle",
      "live_tracking_enabled": true
    }
  }
  ```
</CodeGroup>

## Gaming & Entertainment

### Game Session Events

**Game Session Started Event**

<CodeGroup>
  ```json json theme={null}
  {
    "contact_id": "user_567890",
    "event_name": "game_session_started",
    "timestamp": 1672537200,
    "event_id": "game_start_001",
    "metadata": {
      "game_id": "adventure_quest_mobile",
      "game_version": "v1.2.3",
      "player_level": 15,
      "character_class": "warrior",
      "game_mode": "story_campaign",
      "chapter_id": "chapter_3",
      "device_type": "mobile",
      "platform": "ios",
      "session_id": "game_sess_xyz123"
    }
  }
  ```
</CodeGroup>

**Achievement Unlocked Event**

<CodeGroup>
  ```json json theme={null}
  {
    "contact_id": "user_567890",
    "event_name": "achievement_unlocked",
    "timestamp": 1672537800,
    "event_id": "achievement_001",
    "metadata": {
      "achievement_id": "first_boss_defeated",
      "achievement_name": "Dragon Slayer",
      "achievement_category": "combat",
      "achievement_rarity": "rare",
      "points_earned": 100,
      "reward_type": "gold",
      "reward_amount": 500,
      "player_level": 15,
      "completion_percentage": 0.25
    }
  }
  ```
</CodeGroup>

**In-App Purchase Event**

<CodeGroup>
  ```json json theme={null}
  {
    "contact_id": "user_567890",
    "event_name": "in_app_purchase_completed",
    "timestamp": 1672538400,
    "event_id": "iap_001",
    "metadata": {
      "product_id": "gold_pack_large",
      "product_name": "Large Gold Pack",
      "product_type": "consumable",
      "price_usd": 9.99,
      "local_price": 9.99,
      "currency": "USD",
      "store": "app_store",
      "purchase_location": "shop_main",
      "player_level": 15,
      "gold_amount": 10000,
      "bonus_percentage": 20
    }
  }
  ```
</CodeGroup>

## Healthcare & Fitness

### Fitness Tracking

**Workout Started Event**

<CodeGroup>
  ```json json theme={null}
  {
    "contact_id": "user_111222",
    "event_name": "workout_started",
    "timestamp": 1672539000,
    "event_id": "workout_001",
    "metadata": {
      "workout_id": "workout_hiit_001",
      "workout_name": "30-Min HIIT Blast",
      "workout_type": "HIIT",
      "workout_category": "cardio",
      "instructor_id": "trainer_sarah_j",
      "estimated_duration": 1800,
      "difficulty_level": "intermediate",
      "equipment_needed": ["dumbbells", "mat"],
      "calories_target": 300,
      "device_type": "mobile"
    }
  }
  ```
</CodeGroup>

**Health Metric Logged Event**

<CodeGroup>
  ```json json theme={null}
  {
    "contact_id": "user_111222",
    "event_name": "health_metric_logged",
    "timestamp": 1672540800,
    "event_id": "health_log_001",
    "metadata": {
      "metric_type": "weight",
      "metric_value": 165.5,
      "metric_unit": "lbs",
      "measurement_date": "2023-01-01",
      "data_source": "manual_entry",
      "goal_progress": 0.75,
      "trend_direction": "decreasing",
      "notes": "Morning weigh-in after workout"
    }
  }
  ```
</CodeGroup>

## Financial Services

### Account Activity

**Transaction Event**

<CodeGroup>
  ```json json theme={null}
  {
    "contact_id": "user_333444",
    "event_name": "transaction_completed",
    "timestamp": 1672541400,
    "event_id": "txn_001",
    "metadata": {
      "transaction_id": "TXN_2023_001",
      "transaction_type": "transfer",
      "amount": 250.00,
      "currency": "USD",
      "from_account": "checking_001",
      "to_account": "savings_001",
      "category": "savings",
      "method": "mobile_app",
      "fee_amount": 0.00,
      "balance_after": 1750.00,
      "merchant_name": null,
      "is_recurring": false
    }
  }
  ```
</CodeGroup>

**Investment Activity Event**

<CodeGroup>
  ```json json theme={null}
  {
    "contact_id": "user_333444",
    "event_name": "investment_order_placed",
    "timestamp": 1672542000,
    "event_id": "invest_001",
    "metadata": {
      "order_id": "INV_ORD_001",
      "order_type": "buy",
      "security_symbol": "AAPL",
      "security_name": "Apple Inc.",
      "quantity": 10,
      "order_value": 1500.00,
      "order_method": "market_order",
      "account_type": "individual_taxable",
      "portfolio_percentage": 0.15,
      "investment_goal": "growth"
    }
  }
  ```
</CodeGroup>

## Education & Learning

### Course Engagement

**Lesson Started Event**

<CodeGroup>
  ```json json theme={null}
  {
    "contact_id": "user_555666",
    "event_name": "lesson_started",
    "timestamp": 1672542600,
    "event_id": "lesson_001",
    "metadata": {
      "course_id": "course_javascript_fundamentals",
      "course_name": "JavaScript Fundamentals",
      "lesson_id": "lesson_variables_functions",
      "lesson_name": "Variables and Functions",
      "lesson_number": 3,
      "lesson_type": "video",
      "estimated_duration": 900,
      "difficulty_level": "beginner",
      "prerequisites_completed": true,
      "course_progress": 0.20
    }
  }
  ```
</CodeGroup>

**Assessment Completed Event**

<CodeGroup>
  ```json json theme={null}
  {
    "contact_id": "user_555666",
    "event_name": "assessment_completed",
    "timestamp": 1672543500,
    "event_id": "assessment_001",
    "metadata": {
      "assessment_id": "quiz_js_basics",
      "assessment_type": "quiz",
      "score": 85,
      "max_score": 100,
      "passing_score": 70,
      "passed": true,
      "questions_total": 20,
      "questions_correct": 17,
      "time_taken": 600,
      "attempts": 1,
      "lesson_id": "lesson_variables_functions"
    }
  }
  ```
</CodeGroup>

These samples provide a foundation for implementing comprehensive event tracking across different industries.
