# Page and Auth Events

Events related to page views and authentication.

## Page Viewed

- Event Name: `page-viewed`
- Triggered when a user views a standard page on the site.
- Used to track general page impressions and user navigation across the site.
- This is not raised from single-card, embedded, or survey views.

| Field | Type | Description | Required |
| --- | --- | --- | --- |
| timestamp | String (TimeStamp) | The timestamp of the event | Yes |
| pageTitle | String | The title of the page where the event occurred | Yes |
| hostName | String | The hostname of the page where the event occurred | Yes |
| pathName | String | The path of the page where the event occurred | Yes |
| queryString | String | The query string of the page where the event occurred | Yes |
| url | String | The URL of the page where the event occurred | Yes |
| referrer | String | The URL that linked to the page where the event occurred | Yes |
| languages | Array | The languages of the browser that made the request | Yes |
| userAgent | String | The user agent of the browser that made the request | Yes |
| siteId | String (GUID) | The ID of the hub where the event occurred | Yes |
| siteName | String | The name of the hub where the event occurred | Yes |
| userId | String (GUID) | The ID of the user that performed the action | Yes |
| contactId | String (GUID) | The ID of the contact that performed the action | Yes |
| pageId | String (GUID) | The ID of the page that was viewed | Yes |
| pageSlug | String | The slug of the page that was viewed | Yes |

## Single Card Page Viewed

- Event Name: `single-card-page-viewed`
- Triggered when a user views a single card page on the site.
- This event is raised when a user views a page on a "Visit single card" link copied from the portal.

| Field | Type | Description | Required |
| --- | --- | --- | --- |
| timestamp | String (TimeStamp) | The timestamp of the event | Yes |
| pageTitle | String | The title of the page where the event occurred | Yes |
| hostName | String | The hostname of the page where the event occurred | Yes |
| pathName | String | The path of the page where the event occurred | Yes |
| queryString | String | The query string of the page where the event occurred | Yes |
| url | String | The URL of the page where the event occurred | Yes |
| referrer | String | The URL that linked to the page where the event occurred | Yes |
| languages | Array | The languages of the browser that made the request | Yes |
| userAgent | String | The user agent of the browser that made the request | Yes |
| siteId | String (GUID) | The ID of the hub where the event occurred | Yes |
| siteName | String | The name of the hub where the event occurred | Yes |
| userId | String (GUID) | The ID of the user that performed the action | Yes |
| contactId | String (GUID) | The ID of the contact that performed the action | Yes |
| cardId | String (GUID) | The ID of the card that was viewed | Yes |
| cardName | String | The name of the card that was viewed | Yes |

## Embedded Card Page Viewed

- Event Name: `embedded-card-page-viewed`
- Triggered when a user views an embedded card page on the site.
- This event is raised when a user views a card page via the Embed SDK - either from React Native or the web.

| Field | Type | Description | Required |
| --- | --- | --- | --- |
| timestamp | String (TimeStamp) | The timestamp of the event | Yes |
| pageTitle | String | The title of the page where the event occurred | Yes |
| hostName | String | The hostname of the page where the event occurred | Yes |
| pathName | String | The path of the page where the event occurred | Yes |
| queryString | String | The query string of the page where the event occurred | Yes |
| url | String | The URL of the page where the event occurred | Yes |
| referrer | String | The URL that linked to the page where the event occurred | Yes |
| languages | Array | The languages of the browser that made the request | Yes |
| userAgent | String | The user agent of the browser that made the request | Yes |
| siteId | String (GUID) | The ID of the hub where the event occurred | Yes |
| siteName | String | The name of the hub where the event occurred | Yes |
| userId | String (GUID) | The ID of the user that performed the action | Yes |
| contactId | String (GUID) | The ID of the contact that performed the action | Yes |
| cardId | String (GUID) | The ID of the card that was viewed | Yes |
| cardName | String | The name of the card that was viewed | Yes |

---

## Auth View

- Event Name: `auth-view`
- Triggered when a user views an authentication form (sign in, sign up, or forgot password) on the site.
- Used to track authentication-related page impressions and flows.

| Field | Type | Description | Required |
| --- | --- | --- | --- |
| timestamp | String (TimeStamp) | The timestamp of the event | Yes |
| pageTitle | String | The title of the page where the event occurred | Yes |
| hostName | String | The hostname of the page where the event occurred | Yes |
| pathName | String | The path of the page where the event occurred | Yes |
| queryString | String | The query string of the page where the event occurred | Yes |
| url | String | The URL of the page where the event occurred | Yes |
| referrer | String | The URL that linked to the page where the event occurred | Yes |
| languages | Array | The languages of the browser that made the request | Yes |
| userAgent | String | The user agent of the browser that made the request | Yes |
| siteId | String (GUID) | The ID of the hub where the event occurred | Yes |
| siteName | String | The name of the hub where the event occurred | Yes |
| userId | String (GUID) | The ID of the user that performed the action | Yes |
| contactId | String (GUID) | The ID of the contact that performed the action | Yes |
| source | String (Site \| Competition \| LiveTriviaGame) | Where the auth screen was triggered from | Yes |
| type | String (Unknown \| SignInForm \| SignUpForm \| ForgotPasswordForm) | The type of auth screen that was viewed | Yes |
| isContactVerification | Boolean | Whether the auth screen was triggered from a contact verification | No |