Page Contents

    Sending App Notifications

    In this topic, you will learn how to use Firebase to send notifications to iOS and Android apps.


    For iOS and Android apps you can send notifications using Google Firebase. This document will walk you through the process. The configuration of the iOS and/or Android apps to enable this functionality is done by Brightcove.

    Sending a notification

    The implementation tasks to send a notification are detailed in the remainder of this document. Those steps are:

    1. Configure the notification
    2. Define the target
    3. Schedule when the notification will be sent
    4. Add options for the video asset to which the notification is linked

    Example notifications follow:

    • iOS
    • Android Closed
      notification android closed
    • Android Expanded
      notification android expanded

    Configure the notification

    If this section you define the content in the notification.

    1. Navigate to the Firebase Console and select your project.
    2. In the left navigation select:
      1. Engage
      2. Cloud Messaging
    1. Click Send your first message.
    2. Supply the Notification title and Notification text. Note that you can see a preview on the bottom right of the screen.
    3. Add an optional notification image, if desired. Note that this feature is only supported by Android apps.
      notification image
    4. Add an optional notification name, if desired.
      notification name
    5. Click Next.

    Define the target

    When you define the target you configure which app(s) should receive the notification and also define any further restrictions on whom should receive the notification.

    1. Select the app or apps to which you wish to send the notification. Note that to add another app you need to click the Target another app button, which is disabled currently in the screenshot.
    2. Add any filters for each app to which you are sending the notification by clicking the and button.
      target restrictions
    3. Click Next.

    Schedule when the notification will be sent

    You have the option to send the notification immediately or have it sent repeatedly.

    1. Choose when you will send the notification.

    Add options for the video asset to which the notification is linked

    You will often link to a video asset that will be displayed when the viewer clicks a link in your notification. The video asset is defined in the Addition options section. The options from which you can choose are defined in this table:

    Key Value Data Type
    action show_asset The actual string show_asset
    • episode
    • season
    • tvshow
    • movie
    • event
    One of the strings from the possible value list
    asset_id asset_id Numeric value retrieved from Beacon Classic
    season_id season_id Numeric value retrieved from Beacon Classic
    series_id series_id Numeric value retrieved from Beacon Classic

    To find the IDs of the video assets, in Beacon Classic select the asset, season for series for which you need the ID. The ID will be part of the name information, as highlighted in the screenshots below.

    get asset IDs
    1. Complete the additional options for the video asset to which you wish to link. An example is shown here:
      additional options
    2. Finalize the process by clicking Review, confirm the information in the Review message dialog, then click Publish.

    Note the following:

    • The season_id and series_id are optional and only used in the case when asset_type is episode.
    • The series_id is also used if the asset_type is season.
    • If you have the Explore option disabled and user has not authenticated, when the the app opens from a notification and the user authenticates the details page for the video asset is displayed to the user.
    • When a asset is opened from a push notification, the workflow is the same as opening an asset from a carousel regarding:
      • Entitlements checks and buttons displayed
      • Continuous Play (applicable when the asset in the notification is a series/seasons)

    Page last updated on 18 May 2022