Setting Up Your App Stores for Amego

Introduction & Background

Amego offers branded apps for companies to publish under their own app store accounts. Your branded icon is on the user's device and you have total control over the app's appearance and behavior: it's a representation of your brand on the attendee's device. Moreover, the app can be used year round to support your whole event portfolio, adding efficiency for how your event team can bring events online.

Apple and Google app stores require that apps like Amego are not published by Amego, but by the company they're representing: you! In fact, if anyone but you tried to publish your app it would be flagged for 'impersonation'. This is a protection for you and your brand - you would not want random apps being created that seem to imply they are yours.

For that reason, Amego cannot publish your event apps in the Amego store. Each Amego customer needs to provide a way to help Amego publish your app on your Organization/Company app store. We provide 3 methods in this document, in order of ease and convenience. Please note, personal app store accounts can not be used.

Please review these options and once we've heard from you, we will work with your team to get the apps set up immediately. Once initially set up, subsequent steps are greatly reduced.

Don't have any app store presence yet? See Appendix A at the end of this document for more information on how to establish your Organization/Company app store presence.

Understanding Amego's Role

Amego will be the app administrator in both app stores. You grant access to our user account – appdeveloper@amego.com – using the instructions below, one time. With these instructions and permissions, Amego will be able to administer your published app moving forward.

Amego manages your app store listing, screenshots, and distributes new releases on your behalf. In some cases, Amego may need your input for branding decisions, marketing copy, etc., and Amego will be responsible for communicating with any app store personnel. Amego does not respond to app store reviews on your behalf.

How We Publish Apps

Amego sets up your initial app store presence with a combination of manual and automatic activities. Items that require app store releases include:

• New Amego functionality, which is rolled out on a regular basis
• Changes to your app icon or app icon label
• Changes to fonts inside your app
• Some changes to your app store listing

Almost every other element of your app is dynamically updated through the Amego CMS of your app. After your app's initial release, every submission is automated. Our typical screenshots included are:

• Home
• Agenda
• Library
• Session Detail

*Changes to screenshots require new app builds.

Restricting Our Access

Once your apps are initially set up, you can edit our user record and remove any access to apps other than the Amego app, where we will need to remain an app manager indefinitely.

If your organization prohibits third parties from accessing your app stores, the process becomes much more complicated. Please refer to Appendix B - manual app setup.

Distributing Your App Store Links

Once your apps are live, you can view their status and get links at app.amego.com/app-status

If You Have Existing Apps

Replacing an existing app is the easiest path. Your users will be updated with Amego's app and you will maintain any continuity from prior app builds. To transfer the app, just go into Google and remove the old app admins then add appdeveloper@amego.com as the new app admin. Then, do the same in Apple, adding appdeveloper@amego.com as the new app manager.

Finally, check the end of this document to generate and send us a new .p8 key for sending push notifications.

New Apps: Steps to Create App Store Access

Each app store follows a different process for setting up your company's app store presence, and we've outlined both below. There are 3 steps:

1. Set up Apple access
2. Set up Google access
3. Set up Push Keys

Apple iTunes Store (appstoreconnect.apple.com)

With Apple, you grant us access and we create the app for you.

STEP 1: Sign in to App Store Connect and click on Users and Access

STEP 2: Click on the plus sign to add a New User

STEP 3: Fill in the New User section

Fill in our info:

• First Name: Amego
• Last Name: Developer
• Email: appdeveloper@amego.com

Then click "App Manager." Below, under Additional Resources, check:

• "Access to Reports"
• "Access to Certificates, Identities & Profiles"
• "Access to Cloud Managed Distribution Certificate"
• "Create Apps"

Apple setup is completed.

Google Play Store (play.google.com/console)

With Google, you create your app first, then give us access to only that specific app.

STEP 1: Go to Google Play Console and Create an App

Click on All apps, then click Create app.

STEP 2: Edit App Details

Complete the form, using the app name preferred by your events marketing team.

STEP 3: Go to Users and Permissions to invite our user

Go back to All apps on the left, and click Users and permissions, then Invite new users.

STEP 4: Invite our email address

At the top of the form, enter appdeveloper@amego.com as the email and leave the box unchecked.

In App permissions, select the app you created in Step 1 by clicking Add app at the bottom.

STEP 5: Make our user an admin for the Amego app

In Account permissions, check the Admin box, then click Invite user on the bottom-right of the screen.

Google setup is completed.

Keys for Push Notifications

Option 1: p8 Keys

.p8 keys are the newer option, don't expire, and can be used across multiple apps. We prefer to use these when possible.

1. Go to developer.apple.com/account/resources/authkeys/list and create new key
2. Select "Apple Push Notifications service (APNs)"
3. Download .p8 file
4. Send the .p8 file to Amego at appdeveloper@amego.com or through the secure file transfer system of your choice

Option 2: p12 Keys

.p12 keys are the older option, expire after one year, and can only be used by one app. This is a backup option if .p8 is somehow not available.

General Reminder: If you're using a .p12 certificate instead of a .p8, keep in mind that .p12 certificates expire annually and can only be used by one app. They are an older option and should serve as a backup if .p8 is unavailable. To avoid disruptions, set calendar reminders to update the keys before they expire.

Instructions: documentation.onesignal.com/docs/ios-p12-generate-certificates

Appendix A: Creating Apple and Google Accounts

Apple:

1. Join the developer program for your organization at developer.apple.com/programs/enroll
2. Return to the above instructions, log into App Store Connect, and proceed

Google:

1. Create a developer account for your organization at play.google.com/console/u/0/signup
2. Review their 4 step checklist at support.google.com
3. Return to the above instructions, log into Google Play Console, and proceed

Appendix B: Manual App Setup

Requirements

• Amego account
• Apple Developer account

Apple Account Setup

Create App Identifiers

Note: the AMEGO_APP_ID can be any text string you want to use and is usually a shortened version of your app/event name.

1. Go to developer.apple.com/account/resources/identifiers and create a new "App Group" with name: group.com.amego.app{{AMEGO_APP_ID}}.onesignal
2. Go to developer.apple.com/account/resources/identifiers/add/bundleId and create a new app identifier with name: com.amego.app{{AMEGO_APP_ID}}. Create and go back to the newly created identifier and select capabilities: AppGroups, click configure and select the newly created app group group.com.amego.app{{AMEGO_APP_ID}}.onesignal, Associated Domains, Push Notifications.
3. Create a new App Identifier for OneSignal with name: com.amego.app{{AMEGO_APP_ID}}.OneSignalNotificationServiceExtension. Create and go back to the newly created identifier and select capabilities: AppGroups, click it and select the newly created app group group.com.amego.app{{AMEGO_APP_ID}}.onesignal.

Create new app in App Store Connect

1. Go to appstoreconnect.apple.com/apps and click the plus button.
2. Fill in everything in the opened modal: Platform: iOS; Bundle id: com.amego.app{{AMEGO_APP_ID}}; SKU: Amego app id or any value you want.

Create Apple Distribution signing certificate

1. Go to developer.apple.com/account/resources/certificates/list and create a new certificate.
2. Select "Apple Distribution" under the Software section.
3. Upload a Signing Certificate Request (CSR).
4. Download the .cer file.

Extract .p12 key from .cer file

1. Open the .cer file (Keychain Access app will open).
2. Find the newly imported Apple Distribution certificate.
3. Click the expand button and right-click the expanded key.
4. Click Export "Key Name".
5. Enter a new password and click save (save your key password somewhere – you'll need it later).

Create Provision Profiles

1. Go to developer.apple.com/account/resources/profiles and create a provision profile for identifier: com.amego.app{{AMEGO_APP_ID}}. Click plus, select "App Store" under Distribution, select the identifier from the list, select the signing certificate created earlier, enter a Provision profile name (e.g. "YourAppName"), and download the .mobileprovision file.
2. Create a second provision profile for the OneSignal identifier: com.amego.app{{AMEGO_APP_ID}}.OneSignalNotificationServiceExtension, following the same steps and naming it e.g. "YourAppNameOneSignal".

Important Note on Certificates and Provisioning Profiles

To ensure your app builds successfully and features like push notifications function properly, the Amego team may need to create new certificates and provisioning profiles, and remove outdated or conflicting certificates. Please make sure the access you grant allows us to manage these components within your Apple Developer account. Limited or incorrect permissions can delay the setup process. If you're unsure what level of access is required, contact your Customer Success Manager or refer to Apple's documentation on roles and permissions.