Configure web push notification channel push-notification-configuration

Journey Optimizer allows you to create your journeys and send messages to targeted audience. Before beginning to send Web push notifications with Journey Optimizer, you need to ensure configurations and integrations are in place in Adobe Experience Platform. To understand the Push Notifications data flow in Adobe Journey Optimizer please refer to this page.

AVAILABILITY
The new Mobile onboarding quick start workflow is now available. Use this new product feature to rapidly configure the Mobile SDK to start collecting and validating mobile event data, and to send mobile push notifications. This capability is accessible via the Data Collection home page as a public beta. Learn more

Before starting start-push

Set up permissions setup-permissions

Before creating a mobile application, you first need to make sure that you have or assign the correct user permissions for tags in Adobe Experience Platform. Learn more in Tags documentation.

CAUTION
Push configuration must be performed by an expert user. Depending on your implementation model and personas involved in this implementation, you might need to assign the full set of permissions to a single product profile or share permissions between the app developer and the Adobe Journey Optimizer administrator. Learn more about Tags permissions in this documentation.

To assign Property and Company rights, follow the steps below:

  1. Access the Admin Console.

  2. From the Products tab, select the Adobe Experience Platform Data Collection card.

  3. Select an existing Product Profile or create a new one with the New profile button. Learn how to create a new New profile in the Admin console documentation.

  4. From the Permissions tab, select Property rights.

  5. Click Add all. This will add the following right to your product profile:

    • Approve
    • Develop
    • Manage Environments
    • Manage Extensions
    • Publish

    These permissions are required to install and publish the Adobe Journey Optimizer extension and publish the app property in Adobe Experience Platform Mobile SDK.

  6. Then, select Company rights in the left-hand menu.

  7. Add the following rights:

    • Manage App Configurations
    • Manage Properties

    These permissions are required for the mobile app developer to set up push credentials in Adobe Experience Platform Data Collection and define Push Notification channel configurations (i.e. message presets) in Adobe Journey Optimizer.

  8. Click Save.

To assign this Product profile to users, follow the steps below:

  1. Access the Admin Console.

  2. From the Products tab, select the Adobe Experience Platform Data Collection card.

  3. Select your previously configured Product profile.

  4. From the Users tab, click Add user.

  5. Type in your user’s name or email address and select the user. Then, click Save.

    note note
    NOTE
    If the user was not previously created in the Admin console, refer to the Add users documentation.

Check your datasets push-datasets

The following schemas and datasets are available with the push notification channel:

Schema
Dataset
Group of fields
Operation
CJM Push Profile Schema
CJM Push Profile Dataset
Push Notification Details
Adobe CJM ExperienceEvent - Message Profile Details
Adobe CJM ExperienceEvent - Message Execution Details
Application Details
Environment Details
Register Push Token
CJM Push Tracking Experience Event Schema
CJM Push Tracking Experience Event Dataset
Push Notification Tracking
Track interactions and provide data for the reporting UI
NOTE
When push tracking events are ingested into the CJM Push Tracking Experience Event dataset, some failures can happen, even though data is partly ingested successfully. This can occur if some fields in your mapping do not exist in incoming events: the system logs warnings but does not prevent ingestion of valid portions of the data. These warnings appear in batch status as ‘failed’ but reflect partial ingestion success.
To view the complete list of fields and attributes for each schema, consult the Journey Optimizer schema dictionary.

Configure the pushNotification property push-property

To enable Web push notifications, you must first ensure that the pushNotifications property is properly configured within the Web SDK. This property controls how push notifications are handled by your web application.

Additionally, you need to generate VAPID keys, required to configure your app push credentials in Journey Optimizer.

Step 1: Add your app push credentials in Journey Optimizer push-credentials-launch

After granting the correct user permissions, you now need to add your mobile application push credentials in Journey Optimizer.

The mobile app push credential registration is required to authorize Adobe to send push notifications on your behalf. Refer to the steps detailed below:

  1. Access the Channels > Push settings > Push credentials menu.

  2. Click Create push credential.

  3. From the Platform drop-don, select Web.

  4. Provide the App ID.

  5. Enter your VAPID public key and private key.

  6. Click Submit to create your app configuration.

Step 2: Create a channel configuration for push message-preset

Once creating your push credentials, you need to create a configuration to be able to send push notifications from Journey Optimizer.

  1. Access the Channels > General settings > Channel configurations menu, then click Create channel configuration.

  2. Enter a name and a description (optional) for the configuration.

    note note
    NOTE
    Names must begin with a letter (A-Z). It can only contain alpha-numeric characters. You can also use underscore _, dot. and hyphen - characters.
  3. To assign custom or core data usage labels to the configuration, you can select Manage access. Learn more about Object Level Access Control (OLAC).

  4. Select Push channel.

  5. Select Marketing action(s) to associate consent policies to the messages using this configuration. All consent policies associated with the marketing action are leveraged in order to respect the preferences of your customers. Learn more

  6. Choose your Platform: Android, iOS and/or Web.

  7. Select the same App id as for your push credential configured above.

  8. Save your changes.

You can now select your configuration when creating your push notifications.

Step 3: Configure the sendPushSubscription property sendPushSubscription-property

Once your push credentials and channel configuration are set up, you need to implement the sendPushSubscription command in your web application. This command registers user push subscriptions with Adobe Experience Platform, enabling the system to track which users have opted in to receive push notifications and maintain their subscription status. This registration is essential for Journey Optimizer to send targeted push notifications to your users.

Step 4: Test your mobile app with an event mobile-app-test

After completing the web push configuration in both Adobe Experience Platform and Adobe Experience Platform Data Collection, you can test your implementation before sending web push notifications to your profiles. Testing ensures that subscriptions are properly registered and that notifications are delivered correctly to your users’ browsers.

For detailed instructions on creating a test journey with events to validate your web push setup, refer to the mobile app push notification configuration documentation, which provides a comprehensive testing workflow applicable to both mobile and web push channels.

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76