ÃÛ¶¹ÊÓƵ

About push notifications about-push-notifications

CAUTION
Push notification implementation has to be performed by expert users. If you need to be assisted, contact your ÃÛ¶¹ÊÓƵ Account executive or Professional services partner. Push notification is an optional feature. Please check your license agreement and contact your account executive to activate it.

ÃÛ¶¹ÊÓƵ Campaign allows you to send personalized and segmented push notifications to iOS and Android mobile devices.

These messages are received on mobile applications that you set up in ÃÛ¶¹ÊÓƵ Campaign by leveraging the Experience Platform SDK. For more information on this, refer to Configuring a mobile application using ÃÛ¶¹ÊÓƵ Experience Platform SDKs.

In ÃÛ¶¹ÊÓƵ Campaign, mobile profile attributes data sent from mobile device are stored in Subscriptions to an application (appSubscriptionRcp) resource which allows you to define the data that you want to collect from your applications’ subscribers.

This resource needs to be extended to collect data you intend to send from the mobile device to ÃÛ¶¹ÊÓƵ Campaign. To do so, refer to this page for the detailed steps.

Two types of push notification are available in ÃÛ¶¹ÊÓƵ Campaign:

  • Alert/Message/Badge type notifications enable you to send standard text-based messages with additional content (sound, badge, deeplink, etc.) that you can define in the Advanced options section.

    This notification types allow you to add a title and a message in which you can use personalization fields. To be able to personalize your message, make sure you select the Send push on profiles template.

  • Silent push type notifications are used to silently notify the application without any message or content for the end user. A typical use case for this type of message would be to make the application aware that there is content available on the server to be downloaded.

Some specific configurations can be set up to define notifications behavior. For more on this, refer to this section.

NOTE
Laws concerning privacy differ by country. Some countries require that you inform users of the types of data collected by mobile applications. Please check the laws pertaining to mobile applications in your country. Make sure push notifications sent to mobile applications comply with the prerequisites and conditions specified by Apple (Apple Push Notification Service) and Google (Google Cloud Messaging or Firebase Cloud Messaging).

Related content:

Prerequisites prerequisites

NOTE
To leverage the push notification feature from Campaign, you need to provide a valid push certificate in .pem format with no passwords.
If you have a valid p12 certificate, you can convert it easily into a .pem file using online resources.

Before sending your push notifications, you should:

  1. In ÃÛ¶¹ÊÓƵ Campaign, make sure you can access the Push notification channel. If you cannot access these channels, contact your account team.

  2. Verify that your user has the necessary permissions in ÃÛ¶¹ÊÓƵ Campaign Standard and tags in ÃÛ¶¹ÊÓƵ Experience Platform.

  3. In the Data Collection UI , create a mobile property. For more information, see .

  4. In the Data Collection UI , install the ÃÛ¶¹ÊÓƵ Campaign Standard extension.

  5. In ÃÛ¶¹ÊÓƵ Campaign Standard, configure the mobile property that you created in the Data Collection UI. For more information, see Setting up your tag application in ÃÛ¶¹ÊÓƵ Campaign.

  6. Add the channel-specific configuration to your mobile application set up. For more information, see Channel-specific application configuration in ÃÛ¶¹ÊÓƵ Campaign.

  7. To support mobile use case implementations, see the detailed instructions about extensions, tag rules, and the SDK implementation in Mobile use cases supported in ÃÛ¶¹ÊÓƵ Campaign Standard by using the ÃÛ¶¹ÊÓƵ Experience Platform SDKs.

Push notification FAQ push-faq

What would be some useful resource recommendations to learn more about Push channel? resource-push

Check out the resources below:

What do I have to do to acquire a Push token in Campaign? push-token-acquisition

Ensure that the provisioning team has completed the provisioning of Push channel in ÃÛ¶¹ÊÓƵ Campaign Standard. Implement setPushIdentifier API from SDK. For more on this, refer to this .

Once I have Push token and ECID in Campaign, what else do I need to send a Push notification? sending-push

Customers need to provide a valid Push certificate in .pem format in order to send a Push notification. You do not require a password for this certificate.

What if I have a .p12 certificate instead of .pem certificate? certificates

You can convert a .p12 certificate into a .pem certificate by running the below command in terminal. There are several online resources also available for conversion instructions.

openssl pkcs12 -in pushcert.p12 -out pushcert.pem -nodes -clcerts

How do I know if the certificate upload is successful? certificate-upload

You will see the following message.

Can I upload both Production and Sandbox certificates at the same time for iOS App (N/A for Android)? prod-sandbox-certificate

No, apps will work in either sandbox or production mode and cannot be changed to the other (i.e. sandbox to production app) once set up. We recommend that you test your app in sandbox mode first and then transition to production mode.

To change to production mode, you will have to create another app. Also be sure to not check the sandbox checkbox and to upload a production certificate.

Can I upload both iOS and Android credentials at the same time? ios-android-credentials

Yes, Campaign supports both platforms at the same time and allows you to upload credentials for both platforms.

I have uploaded Push certificates successfully, yet no Push messages are sent. push-certificates-upload

Please make sure that your push certificates are valid by testing them .

I am able to send Push notifications successfully from pushtry.com but not through Campaign. push-not-sending

Please ensure that you are following the Push payload instructions provided here.

Note that for Android, Campaign only supports Data payload not notification payload

I have configured an app in the Administration section of ÃÛ¶¹ÊÓƵ Campaign Standard but the Mobile App is not available in the Delivery properties. mobile-app-unavailable

An app has to have a valid Push certificate uploaded as well before it could be made available in the delivery properties.

I have tried all the instructions on this page and yet I am not able to send Push from Campaign. push-troubleshoot

Please open a customer care ticket.

Push notifications are getting delivered from Campaign but the media file is not showing up. media-file-unavailable

Mobile App developers need to handle the support for media files in the App. Sometimes network bandwidth may also prevent a media file from rendering. Refer to this page for additional pointers.

What do I have to do to enable Push reporting in Campaign? push-reporting-enable

Follow the steps below:

  • Configure a Push tracking postback. Instructions can be found here.
  • Implement trackAction API from Mobile Core. Refer to this for more information.

More detailed instructions can be found in this page.

Which reports are available for Push channel? push-report-available

An out-of-the-box report is available in ÃÛ¶¹ÊÓƵ Campaign for Push channel. Refer to this documentation.

See this page to understand how each push metrics are calculated.

Yes, deeplinks are supported in Push messages. Deeplinks should include:

  • Language that states that delivery tracking needs to be disabled in order for the deeplinks to work.
  • Appsflyer with Branch as partners that can do the deeplink tracking. For more information on Branch and ÃÛ¶¹ÊÓƵ Campaign Standard integration, refer to this .
recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff