Push Messaging

This troubleshooting guide requires Adobe Experience Platform Assurance. For more information about access and how to set up Assurance, see the documentation.
When implementing push messaging via the Adobe Experience Platform Mobile SDK, you can validate the client-side implementation by verifying that you completed the following steps:
1.​Pass the device's push token to the SDK.
2.​Verify push token sync with the Experience Cloud Identity service.
3.​Ensure user opt in for push in Adobe Analytics.
4.​Confirm user ID is correctly set (and is same from steps 2 and 3, above.
Pass the Push Identifier to the SDK
The setPushIdentifier API sets the device token for push notifications in the SDK. This results in a few network calls made to the requisite Adobe servers to associate the user with the push token.
If SDK privacy status isoptedout, the push identifier will not be set.
setPushIdentifier
Android
iOS
React Native
Java
Syntax
public static void setPushIdentifier(final String pushIdentifier);
Example
// retrieve the token from either GCM or FCM, and pass it to the SDK
MobileCore.setPushIdentifier(token);
Objective C
Syntax
+ (void) setPushIdentifier: (nullable NSData*) deviceToken;
Example
// pass the deviceToken that the APNS has assigned to the device
[ACPCore setPushIdentifier:deviceToken];
Swift
Syntax
Void setPushIdentifier(deviceToken: Data?)
Example
// pass the deviceToken that the APNS has assigned to the device
ACPCore.setPushIdentifier(deviceToken)
Javascript
Example
ACPCore.setPushIdentifier("pushIdentifier");
Verify push token sync with the Experience Cloud Identity service
Launch your app with the device connected to an Adobe Experience Platform Assurance session.
In the list of events, verify that you have an event with type SetPushIdentifier. In the details panel on the right, verify the value of the push token for this device. The value in pushIdentifier is the same value that is sent to the Adobe servers.
Ensure user opt-in for push in Adobe Analytics
Launch your app with the device connected to an Assurance session.
In the resulting list of events, verify that you have an event with type AnalyticsForIdentityRequest. In the details panel on the right, you can see that there is a value that was sent to Analytics that opts this user in to receive push notifications.
Confirm that the user ID is correctly set
Launch your app with the device connected to an Adobe Experience Platform Assurance session.
In the list of events, verify that you have an event with type UPDATED_IDENTITY_RESPONSE. In the details panel on the right, confirm that the following values are correct:
The value for pushidentifier should match the value that was sent in step 2 above.
The value for mid should match the value for mid that is sent to Analytics. If you are using a custom visitor identifier, this payload should also contain a vid variable with a value that matches the value that was used to identify this user.
After completing these steps, your app is correctly configured and is ready to send push messages via the SDK and Adobe.

Resources - Previous

Troubleshooting Guides

Campaign Push Notifications

Last modified 4d ago

Export as PDF

Copy link

Edit on GitHub

On this page

Pass the Push Identifier to the SDK

setPushIdentifier

Verify push token sync with the Experience Cloud Identity service

Ensure user opt-in for push in Adobe Analytics

Confirm that the user ID is correctly set