Set up push notifications in Portal

Set push notifications as your review collection method, and then create a sender profile in the Bazaarvoice Portal. A sender profile is one registered app that holds your Firebase credentials and your app's identifiers. Create one profile for each app. If the same app ships on Android and iOS from the same Firebase project, one profile covers both. Create separate profiles for different apps or brands.

Before you begin

Complete the steps in the Prepare your Firebase and mobile platforms article. Have the following ready:

  • All platforms: The Firebase service-account .json file and your app name.
  • Android: The Play Integrity service-account .json file and your Android package name.
  • iOS: Your iOS bundle ID and 10-character Apple Developer Team ID.

Setup overview

To create a sender profile in Portal, complete the following steps:

  1. Set the review collection method to push notification
  2. Create a sender profile for push notifications

Set the review collection method to push notification

Account Administrator or  Technical Administrator

To start using push notifications, select the review collection method as Push Notification & Email or Push Notification by following these steps:

  1. Sign in to the Bazaarvoice Portal. 
  2. Select the required client instance name from the Instance Selector drop-down list in the upper-right corner. 
  3. From the upper-right corner, select the settings icon Portal Settings icon. 
  4. Go to the Configuration section and select Ratings & Reviews.
  5. Go to Configure Messages > Messages.
  6. Select Edit next to Review Request.
  7. Select Push Notification & Email or Push Notification under Review Collection Method.
  8. Repeat steps 6 and 7 for Review Request Reminder message type.
  9. From the upper-left corner, select Home to go to the Site Manager page.
  10. Select Deploy next to the required implementation.
  11. On the Select zone step, select the target Deployment zone and Environment (staging or production), then select Next.
  12. On the Select changes step, review your updates and select Confirmchanges.
  13. On the Confirm step, review the validation results and select Start deployment.

Create a sender profile for push notifications

Account Administrator or  Technical Administrator

  1. Switch to the Portal tab.
  2. Go to the Configuration section and select Sender Profiles.
  3. On the Sender Profiles page, do one of the following:
    • If you have not added a sender profile, select Set up push notifications.
    • If a table of sender profiles appears, select + Add sender profile in the upper-right corner.
  4. On the Push notification setup page, select Android, iOS, or Both, and then select Continue.
  5. Under Upload service account, upload your Firebase service-account .json file.
  6. For Android or Both, under Upload play integrity service account, upload your Play Integrity service-account .json file.
  7. Complete the following fields. The fields you see depend on the platform you selected.
    1. Android app name and iOS app name: A name your team recognizes. It appears in the profile list and in the template editor.
    2. Android package name: Your package name exactly as it appears in Google Play Console, for example com.yourcompany.shop. It must match the build that registers devices. A .debug build is a different package.
    3. iOS Bundle ID: Your bundle ID from Xcode or App Store Connect.
    4. iOS Team ID: Your 10-character Apple Developer Team ID, using uppercase letters and digits, for example ABCDE12345.
  8. Select Generate API key. The Portal validates your credentials with Google and registers your app.
  9. Select Copy and store the App ID and the secret API key in your secrets manager. The key starts with bv_push_. The Portal doesn't display it again for security reasons.
  10. Select Continue.

Give the App ID to your developers. It's an 8-digit number that identifies the sender profile, for example 10000001.

After you select Continue, the Implementation & Verify step lets you verify the sender profile by allowing you to send a test notification. You cannot send a test notification until your developers add the SDK and have a Device ID, so most teams select Finish now and test later.

In the Create your notification template dialog, enter a Template name and select Create template, or select Cancel to create the template later.

View sender profiles

On the Sender Profiles page, select the Push notification tab. The Sender profile details table lists each profile with its App name, Platform, Added on, Created by, and Status.

Status Meaning What to do
Pending The profile exists, but no test notification has succeeded yet. Send a test notification.
Verified A test notification was accepted for delivery. Nothing. You can publish templates that use this profile.
Failed Verification failed, the profile was deleted, or it stayed Pending for more than 48 hours. Fix the problem and send a successful test notification.

Edit a sender profile

  1. In the Sender profile details table, select the action menu (⋯) next to the profile, and then select Edit.
  2. Change the app name, the identifiers, or the credential files. You can't change the platform. The Portal never displays saved credentials, so upload the key files again.
  3. Select Generate API key to save. Your API key doesn't change.

Delete a sender profile

  1. In the Sender profile details table, select the action menu (⋯) next to the profile, and then select Delete.
  2. In the confirmation dialog, select Delete.

Caution
You cannot undo a deletion. Push notifications stop for that app, and you cannot register the same package name or bundle ID again under your account. To fix a mistake or rotate keys, use Edit instead.
Provide feedback button