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

# Track Page View Events

> Send page view events and page-specific properties to Zeotap.

<Warning>
  **Important:** Please ensure your CMP configuration includes new **Vendor ID 1469** for 1st Party data tracking. Additionally, include **Vendor ID 301** if cookie sync is enabled. [Learn more](/articles/sdks/web-js/configurations/consent-options#shouldcheckzeotapvendorconsent)
</Warning>

After integrating the SDK, you can log the users' page view events by calling `setPageProperties(properties)` and sending all page related information as key=value properties.

**How persistence works:**

The SDK does not store or persist any default page properties. However, once `setPageProperties` is called with values, those properties are **persisted and automatically included** in the `page` node of all subsequent SDK calls — including events, user properties, and other payloads — until they are explicitly changed. To update page properties, call `setPageProperties` again with the new values. To remove page properties, pass empty values.

**Why use it?**

* **Page Context:** Provides context about what page or screen the user is viewing when events occur.
* **User Journey Tracking:** Enables tracking user navigation patterns through your app.
* **Content Analytics:** Helps analyze which pages/screens are most engaging for users.

<Tip>
  **Note**

  If page properties are never set, no `page` property is included in the event payload. Once set, they persist across subsequent calls until updated or cleared.
</Tip>

## Syntax

```java theme={null}
Collect.getInstance().setPageProperties(Map<String, ?> pageProperties, SDKCallback callback)
```

## Parameters

| Parameter      | Type             | Required | Description                                 |
| -------------- | ---------------- | -------- | ------------------------------------------- |
| pageProperties | `Map<String, ?>` | Yes      | This indicates the page specific properties |
| callback       | `SDKCallback`    | Optional | Callback to handle function response        |

## Usage Examples

```java theme={null}
Map<String, Object> pageProperties = new HashMap<>();
pageProperties.put("name", "Product Details");
pageProperties.put("category", "E-commerce");

Collect.getInstance().setPageProperties(pageProperties);
```

The detailed page properties will be passed in the payload:

```json title="Detailed page properties in payload" {10-13} theme={null}
    "events": [
        {
        "event": {
            "eventName": "pageView",
            "eventTimestamp": 1745959356443
        },
        "user": {
            "zi": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
        },
        "page": {
            "name": "Product Details",
            "category": "E-commerce"
        },
        "version": "2.2.8"
        }
    ]
```

## Set page properties with callbacks

You can also set page properties with Callback function as shown below. The data parameter is an object that contains `status` and `message` which helps to debug the status of the function call.

```java theme={null}
Map<String, Object> pageProperties = new HashMap<>();
pageProperties.put("name", "Product Details");
pageProperties.put("category", "E-commerce");

Collect.getInstance().setPageProperties(pageProperties, (response) -> {
    // {status: "SUCCESS", message: "Page properties set successfully"}
});
```

## Best Practices

1. **Call on Screen Load**: Set page properties when a new screen/view becomes visible to the user.

2. **Consistent Naming**: Use consistent naming conventions for similar screens across your app.

3. **Relevant Context**: Include properties that provide meaningful context about the current screen.

4. **Avoid Sensitive Data**: Don't include sensitive information like passwords or personal details.

5. **Update on Navigation**: Update page properties each time the user navigates to a different screen.