User Properties

User properties are attributes and characteristics associated with individual users in your application. They help Aampe

understand user behavior and associate patterns with other users
segment your audience
personalize experiences and messaging copy.

This documentation outlines common user properties and their usage. This is just a comprehensive list of all possible user properties. You can share whatever data is available in your system and is applicable as per your use-cases

Core User Properties

Identification Properties

user_id: Unique identifier for the user (e.g., "usr_12345")
anonymous_id: Temporary identifier for users before they sign up (e.g., "anon_789xyz")
notification_token: Notification token of the user for push

Profile Information

full_name: Complete name (e.g., "John Doe")
username: Chosen username (e.g., "johndoe123")
language: Preferred language (e.g., "en-US")
timezone: User's timezone (e.g., "America/New_York")

Demographics

gender: User's gender (e.g., "female", "male", "non-binary")
country: Country of residence (e.g., "United States")
city: City of residence (e.g., "San Francisco")

Account Properties

Subscription Data

plan_name: Current subscription plan (e.g., "premium", "basic", "enterprise")
plan_price: Price of current plan (e.g., 99.99)
billing_interval: Billing frequency (e.g., "monthly", "annual")
trial_end_date: When free trial expires (e.g., "2024-02-15")
subscription_status: Current status (e.g., "active", "canceled", "past_due")

Account Status

account_type: Type of account (e.g., "individual", "business")
account_status: Current standing (e.g., "active", "suspended", "deleted")
created_at: Account creation date (e.g., "2023-01-15T10:30:00Z")
last_login_at: Most recent login timestamp
is_verified: Email verification status (e.g., true/false)

Behavioral Properties

Engagement Metrics

login_count: Number of times logged in (e.g., 42)
last_active_at: Last activity timestamp
total_sessions: Total number of sessions
average_session_duration: Average time per session (in minutes)

Transaction Data

lifetime_value: Total revenue from user (e.g., 599.99)
total_purchases: Number of completed purchases
last_purchase_date: Date of most recent purchase
average_order_value: Average spending per order
payment_method: Preferred payment method (e.g., "credit_card", "paypal")

Industry-Specific Properties

E-commerce Properties

cart_value: Current shopping cart total (e.g., 129.99)
abandoned_cart_count: Number of abandoned carts (e.g., 3)
favorite_categories: Array of preferred shopping categories (e.g., ["electronics", "fashion"])
last_viewed_products: Array of recently viewed product IDs
shipping_addresses: Array of saved delivery addresses
preferred_payment_methods: Array of saved payment methods
wishlist_count: Number of items in wishlist
return_rate: Percentage of returned items (e.g., 2.5)
average_order_frequency: Days between purchases (e.g., 45)
loyalty_points: Current reward points balance (e.g., 500)
vip_tier: Loyalty program level (e.g., "gold", "platinum")
lifetime_value: (users total lifetime value)
currency: (users transaction currency)

Gaming Properties

player_level: Current game level (e.g., 42)
total_playtime: Time spent in game (in hours)
current_rank: Competitive ranking (e.g., "diamond")
achievement_count: Number of completed achievements
preferred_game_modes: Array of favorite modes (e.g., ["battle_royale", "team_deathmatch"])
in_game_purchases: Total spent on virtual items
active_character: Current character/class being used
win_rate: Percentage of games won
last_match_played: Timestamp of last game session
inventory_items: Array of owned virtual items
friend_count: Number of in-game friends
preferred_server: Default game server region

Food Delivery Properties

dietary_preferences: Array of dietary requirements (e.g., ["vegetarian", "gluten-free"])
favorite_cuisines: Array of preferred cuisine types (e.g., ["italian", "thai"])
average_order_size: Typical number of items per order
delivery_address_count: Number of saved addresses
order_frequency: How often they order (e.g., "weekly")
favorite_restaurants: Array of frequently ordered restaurant IDs
last_cuisine_ordered: Type of food in last order
delivery_instructions: Special delivery notes
meal_preferences: Preferred meal types (e.g., ["lunch", "dinner"])
group_order_frequency: How often they place group orders
review_count: Number of restaurant reviews submitted
average_rating: Average rating given to restaurants

Custom Properties

Marketing Data

acquisition_source: How user found you (e.g., "google_ads", "referral")
acquisition_campaign: Specific campaign (e.g., "summer_2024")
email_subscription: Newsletter status (e.g., true/false)
marketing_preferences: JSON object with communication preferences

Example JSON Representation

{  
   "user_id":"usr_5f3a9c2e",  
   "first_name":"Sarah",  
   "last_name":"Parker",  
   "account_type":"business",  
   "plan_name":"enterprise",  
   "created_at":"2023-12-01T08:30:00Z",  
   "last_login_at":"2024-01-26T15:45:22Z",  
   "company_name":"TechCorp Solutions",  
   "role":"Product Manager",  
   "country":"United States",  
   "timezone":"America/Los_Angeles",  
   "lifetime_value":2499.99,  
   "login_count":157,  
   "is_verified":true,  
   "subscription_status":"active",  
   "trial_end_date":"2024-02-15",  
   "marketing_preferences":{  
      "email":true,  
      "sms":false  
   },  
   "feature_usage":{  
      "dashboard":42,  
      "reports":15  
   },  
   "acquisition_source":"google_ads",  
   "last_purchase_date":"2024-01-15",  
   "plan_price":299.99,`
`   "company_size":"100-500",  
   "language":"en-US",  
   "avatar_url":"<https://assets.company.com/avatars/sp.jpg"">"  
}