How to set up Android push notifications

You will learn

Learn how to set up push notifications for Android in your Klaviyo account. After you've completed the steps in this article, you'll be able to send push notifications in your flows and campaigns. For notifications to actually be delivered to devices, you additionally need to install the appropriate Klaviyo mobile SDK in your mobile app code and then release a new app version with the SDK installed.

Before you begin

To use Android push notifications in Klaviyo, you must:

1. Have your own native mobile Android app.
2. Create a Google service account for your app’s Firebase project. Follow the linked guide to enable the Firebase Cloud Messaging API and assign the service account permission to create messages.
3. Generate a Google service authentication key that will be uploaded to Klaviyo (more details below).
4. Install the appropriate Klaviyo mobile SDK (Android, React Native, or Flutter) and set up event tracking and push notifications in your Android app.

You must be an Owner, Admin, or Manager to edit push notification settings, or have a custom role that includes the push permission under account settings.

Set up Android push notifications in Klaviyo

1. Click your organization name in the lower left-hand corner.
2. Navigate to Settings > Push notifications.
3. On the Mobile app settings page, click Enable next to the Android option.
4. Fill out the required information:
   • Package Name
     Enter your package name, which you can find in the URL of your Google Play store listing or in your app’s module-level Gradle file. It looks like: com.yourcompany.yourproject.
   • Google Service Account Key
     Create your Google service account key and then upload the JSON file to Klaviyo. The JSON file for the key should look like:
     { "type": "service_account",
"project_id": "PROJECT_ID",
"private_key_id": "KEY_ID",
"private_key": "-----BEGIN PRIVATE KEY-----\nPRIVATE_KEY\n-----END PRIVATE KEY-----\n",
"client_email": "SERVICE_ACCOUNT_EMAIL",
"client_id": "CLIENT_ID",
"auth_uri": "https://accounts.google.com/o/oauth2/auth",
"token_uri": "https://accounts.google.com/o/oauth2/token",
"auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
"client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/SERVICE_ACCOUNT_EMAIL"}
5. Click Save to finish setting up push notifications for your Android app.
   

A success notification confirms that your Android push configuration was saved. You can now create push notifications in campaigns and flows.

Test sending a push notification

Before testing, configure Android push notifications in your Klaviyo account and install a version of your app that includes the Klaviyo SDK and its push notification setup on your test device:

1. Log into your mobile app, ideally with an email address or phone number that will make it easy to find your profile in Klaviyo. Confirm with your developer that the app passes this identifier to Klaviyo through the SDK.
2. If prompted, enable push notifications for your app. If you are not prompted, confirm that push notifications are enabled for the app in your device’s settings app.
3. In Klaviyo, go to Audience > Profiles and find your test profile.
4. Under Channel consent, confirm that your profile is subscribed to mobile push notifications.

5. Create a list or segment with only your profile.
6. Create a push notification campaign for that list or segment. In the message editor, select Standard as the notification type, then finish configuring and send the campaign. A Standard notification appears on your device and can be tapped.
7. Confirm that the notification appears on the device.
8. Tap the notification on your device to open your app.
9. Check your profile’s Activity feed to confirm that you see both a Received Push event and an Opened Push event.

Troubleshooting

• Why do I not see a push token on my profile in Klaviyo? Similar to an email address for emails, push notifications are sent to push tokens. Your mobile app needs to forward a device’s push token to Klaviyo for you to be able to send push notifications to that device. Confirm with your app developer that they have implemented the code outlined in the Push Notifications section of our SDK documentation.
• Why am I not seeing Opened Push events even when I tap on a notification? Your app must be configured to track Opened Push events in Klaviyo. For the Android SDK, your developer can enable automatic open tracking or implement manual open tracking. Confirm with your app developer that they have followed the Push Notifications section of our SDK documentation.

Additional resources

• Also have an iOS app? Learn how to set up iOS push notifications.
• Is your app built with React Native? Learn how to set up push notifications for a React Native app.
• Learn how to use push notifications for campaigns.
• Check out how to use deep links in push notifications.