Requirements
- An encryption key (.p8 file) and its key ID
- Your team ID and bundle ID/APNs topic
- APNs user device tokens
Setup
Aampe will essentially establish a token-based connection to APNs and use that to trigger notifications on your behalf.Generating Key
- Login to your Apple developer account.
- In Certificates, Identifiers & Profiles, click Keys in the sidebar, then click the add button (+) on the top left.
- Under Key Name, enter a unique name for the key.
- Select the checkbox next to the services you want to enable, then click Continue.
- If the Media Services checkbox is disabled, you need to register a media identifier first.
- If you register more than one media identifier, click Configure next to the checkbox.
- On the next page, choose the media identifier you want to use from the pop-up menu, then click Continue.
- Review the key configuration, then click Confirm.
- Click Download to generate and download the key. This is the key you will share with Aampe.
- Click Done.
APNs User Device Tokens
For Aampe to be able to trigger push notifications for your users, it needs to have a device token for each user. You can share those directly using a daily dump to an S3/GCP bucket. If you are already sharing user properties data with Aampe, the APNs device token for each user can simply be added as a column to the shared attribute table. See Properties. If you are not sharing attribute data with Aampe then the easiest way to share APNs device tokens is by setting up a daily job that dumps a file with the tokens to a storage bucket. Aampe will take care of ingesting those tokens and always taking the latest value for each user in case of token updates.Data Format
| Name | Data Type | Description |
|---|---|---|
| contact_id | String | A unique user identifier |
| notification_token | String | APNs device token |