# dev.cartridge.analytics.listMyGamesAnalytics

> Published by [cartridge.dev](https://lexicon.garden/identity/did:plc:4mrwcmxk266itsdn33leqljq)

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:4mrwcmxk266itsdn33leqljq/dev.cartridge.analytics.listMyGamesAnalytics)
- [Documentation](https://lexicon.garden/lexicon/did:plc:4mrwcmxk266itsdn33leqljq/dev.cartridge.analytics.listMyGamesAnalytics/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:4mrwcmxk266itsdn33leqljq/dev.cartridge.analytics.listMyGamesAnalytics/examples)

## Definitions

### `dev.cartridge.analytics.listMyGamesAnalytics`

**Type**: `query`

Headline analytics for every game the authenticated caller owns. Powers the multi-game dashboard overview. Fractional metrics use `unknown` because atproto lexicons have no float type.

#### Parameters

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `range` | `string` | No | Reporting window ending today (UTC). |

#### Output

**Encoding**: `application/json`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `games` | `array` | Yes |  |
| `range` | `string` | Yes |  |

### `dev.cartridge.analytics.listMyGamesAnalytics#gameSummary`

**Type**: `object`

One row in the multi-game overview.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `ctr` | `unknown` | Yes | clicks / impressions, 0..1 (float; unknown-typed). |
| `name` | `string` | Yes |  |
| `slug` | `string` | Yes |  |
| `pageviews` | `integer` | Yes |  |
| `sparkline` | `array` | Yes | Pageviews per day for a compact sparkline. |
| `avgDwellMs` | `unknown` | Yes | Mean dwell time in milliseconds (float; unknown-typed). |
| `impressions` | `integer` | Yes |  |

### `dev.cartridge.analytics.listMyGamesAnalytics#timeseriesPoint`

**Type**: `object`

A single day's value in a time series. `date` is 'YYYY-MM-DD' (UTC).

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `date` | `string` | Yes |  |
| `value` | `integer` | Yes |  |

## Raw Schema

```json
{
  "id": "dev.cartridge.analytics.listMyGamesAnalytics",
  "defs": {
    "main": {
      "type": "query",
      "output": {
        "schema": {
          "type": "object",
          "required": [
            "range",
            "games"
          ],
          "properties": {
            "games": {
              "type": "array",
              "items": {
                "ref": "#gameSummary",
                "type": "ref"
              }
            },
            "range": {
              "type": "string",
              "knownValues": [
                "7d",
                "30d",
                "90d"
              ]
            }
          }
        },
        "encoding": "application/json"
      },
      "parameters": {
        "type": "params",
        "properties": {
          "range": {
            "type": "string",
            "default": "30d",
            "description": "Reporting window ending today (UTC).",
            "knownValues": [
              "7d",
              "30d",
              "90d"
            ]
          }
        }
      },
      "description": "Headline analytics for every game the authenticated caller owns. Powers the multi-game dashboard overview. Fractional metrics use `unknown` because atproto lexicons have no float type."
    },
    "gameSummary": {
      "type": "object",
      "required": [
        "slug",
        "name",
        "impressions",
        "pageviews",
        "ctr",
        "avgDwellMs",
        "sparkline"
      ],
      "properties": {
        "ctr": {
          "type": "unknown",
          "description": "clicks / impressions, 0..1 (float; unknown-typed)."
        },
        "name": {
          "type": "string"
        },
        "slug": {
          "type": "string"
        },
        "pageviews": {
          "type": "integer"
        },
        "sparkline": {
          "type": "array",
          "items": {
            "ref": "#timeseriesPoint",
            "type": "ref"
          },
          "description": "Pageviews per day for a compact sparkline."
        },
        "avgDwellMs": {
          "type": "unknown",
          "description": "Mean dwell time in milliseconds (float; unknown-typed)."
        },
        "impressions": {
          "type": "integer"
        }
      },
      "description": "One row in the multi-game overview."
    },
    "timeseriesPoint": {
      "type": "object",
      "required": [
        "date",
        "value"
      ],
      "properties": {
        "date": {
          "type": "string"
        },
        "value": {
          "type": "integer"
        }
      },
      "description": "A single day's value in a time series. `date` is 'YYYY-MM-DD' (UTC)."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```