---
title: "Push Payload Details"
slug: "push-payload-details"
updated: 2024-12-10T13:22:02Z
published: 2024-12-10T13:22:02Z
canonical: "docs.mapp.com/push-payload-details"
---

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

# Push Payload Details

## Overview

Push Payload Details in Android allow developers to manage and utilize the notification payload to trigger various actions and handle events like notification receipt, opening, or dismissal. These payloads facilitate dynamic and personalized user experiences.

## Use Case

1. **Purpose**:
  - Extract and utilize data from push notifications to enhance app functionality.
  - Track user interactions with notifications (e.g., open, dismiss).
2. **Benefits**:
  - Drive engagement with rich, actionable notifications.
  - Provide detailed analytics on user interaction with notifications.

#### **Implementation Details**

1. **Manifest Configuration**:
  - Add a broadcast receiver in `AndroidManifest.xml` to handle push events:

```xml
<receiver
    android:name=".MyPushBroadcastReceiver"
    android:enabled="true"
    android:exported="false">
    <intent-filter>
        <action android:name="com.appoxee.PUSH_OPENED"/>
        <action android:name="com.appoxee.PUSH_RECEIVED"/>
        <action android:name="com.appoxee.PUSH_DISMISSED"/>
        <category android:name="${applicationId}"/>
    </intent-filter>
</receiver>
```
2. **Receiver Implementation**:
  - Extend `PushDataReceiver` to handle push notification events:

```java
public class MyPushBroadcastReceiver extends PushDataReceiver {

    @Override
    public void onPushReceived(PushData pushData) {
        Log.d("PushNotification", "Push received: " + pushData);
    }

    @Override
    public void onPushOpened(PushData pushData) {
        Log.d("PushNotification", "Push opened: " + pushData);
    }

    @Override
    public void onPushDismissed(PushData pushData) {
        Log.d("PushNotification", "Push dismissed: " + pushData);
    }

    @Override
    public void onSilentPush(PushData pushData) {
        Log.d("PushNotification", "Silent push received: " + pushData);
    }
}
```
3. **Notification Payload Handling**:
  - Extract and utilize payload data within the overridden methods.
  - Access push metadata to trigger app-specific actions.

> [!NOTE]
> Keep in mind:
> 
> - Ensure the `PushDataReceiver` handles all required actions (e.g., custom button clicks, silent push updates).
> - Log payload details for debugging and testing purposes.
> - Test notification events across various Android versions to ensure compatibility.

## Related

- [Push Notifications](/push-notifications.md)
- [Rich Push Notifications](/rich-push-notifications.md)
- [Silent Push](/silent-push.md)
- [Deep Linking](/deep-linking-1.md)
- [Foreground Notifications](/foreground-notifications.md)