Before you send a push notification to your device as a test, complete all of the steps to set up the SDK.

Use a device to test. You can use an iOS simulator for testing some aspects of the SDK, but the simulator does not receive push notifications as part of the testing process.

  1. Verify that your app is built appropriately for the type of push certificate you uploaded to Marketing Cloud.
    • If you set up the app in Marketing Cloud with an Apple Production certificate, build your app for distribution. Examples include Ad Hoc, TestFlight, and Enterprise.
    • If you set up the app in Marketing Cloud with a Development Certificate, build your app for development. An example is Debug.
  2. Set a temporary contact key in your app for testing. For example, use an email address. This allows you to target the device you are testing on when sending the test push.
  3. In MobilePush in Marketing Cloud, create a filtered list that targets the contact key you set.
    • Tip: When creating the filter criteria, use the Contact Key attribute. Find this attribute under System Data > Contact > Contact Key., Set the attribute equal to the contact key in your iOS app.
    • Tip: It may take up to five minutes for the contact created by your app to show up in the filtered list. Refresh the list until the new contact is returned before proceeding to the next step.
  4. In MobilePush in Marketing Cloud, create a test message and send it to your newly created filtered list.

    Troubleshooting: If the push notification doesn’t arrive on the device, check the filtered list to confirm that the contact’s status is Opted In. If the contact is not opted in, check that you exactly followed the steps to set up the call to config and the other integration steps. Also check that the app is built appropriately for the type of push certificate you uploaded to Marketing Cloud.