{
  "kind": "event_reference",
  "events_for_all_properties": [
    {
      "event": "earn_virtual_currency",
      "required_parameters": [],
      "note": "user is awarded virtual currency in a game"
    },
    {
      "event": "join_group",
      "required_parameters": [],
      "note": "user joins a group such as a guild, team, or family"
    },
    {
      "event": "login",
      "required_parameters": [],
      "note": "user has logged in; optional method"
    },
    {
      "event": "search",
      "required_parameters": [
        "search_term"
      ],
      "note": "user has performed a search"
    },
    {
      "event": "select_content",
      "required_parameters": [],
      "note": "user has selected content; optional content_type, content_id"
    },
    {
      "event": "share",
      "required_parameters": [],
      "note": "user has shared content; optional method, content_type, item_id"
    },
    {
      "event": "sign_up",
      "required_parameters": [],
      "note": "user has signed up; optional method"
    },
    {
      "event": "spend_virtual_currency",
      "required_parameters": [
        "value",
        "virtual_currency_name"
      ],
      "note": "sale of virtual goods in the app"
    },
    {
      "event": "tutorial_begin",
      "required_parameters": [],
      "note": "start of the on-boarding process; no parameters; pair with tutorial_complete"
    },
    {
      "event": "tutorial_complete",
      "required_parameters": [],
      "note": "completion of the on-boarding process; no parameters"
    }
  ],
  "online_sales_events": [
    "add_payment_info",
    "add_shipping_info",
    "add_to_cart",
    "add_to_wishlist",
    "begin_checkout",
    "purchase",
    "refund",
    "remove_from_cart",
    "select_item",
    "view_cart",
    "view_item",
    "view_item_list"
  ],
  "value_rule": "value = sum of (price * quantity) for all items; do not include shipping or tax; currency is required if value is set",
  "item_custom_parameter_limit": 27,
  "guide": "ga4-recommended-events-reference",
  "title": "The recommended events reference: the ten events for every property, and the online-sales set",
  "worked_example": {
    "items": [
      {
        "item": "A",
        "price": "12.50",
        "quantity": 2,
        "line_value": "25.00"
      },
      {
        "item": "B",
        "price": "7.99",
        "quantity": 4,
        "line_value": "31.96"
      }
    ],
    "event_value": "56.96",
    "events_for_all_properties_count": 10,
    "online_sales_events_count": 12
  },
  "verification": "Figures recomputed in Python 3 with decimal arithmetic, 2026-11-11. No live GA4 run."
}