The Apple page (under Manage > Platforms) shows the configuration options for Apple mobile apps and connected TV devices:
How to Use
The configuration options available on this page can be somewhat technical in nature, and are explained in more detail below and during account onboarding. Questions about individual fields can be directed to your onboarding specialist or at appsupport@zype.com.
General Information
This tab includes general information about your Apple app. We will use this info to fill in all the details on App Store Connect, during app submission.
App Store name: This is the name of your app, that is displayed on the App Store. It has to be 22 characters or less.
Description: Use this text to let the user know about your app even before they download it. This will be displayed on your App Store listing.
Primary Category: Choose from a list of available Primary Categories. This list is maintained by Apple.
Secondary Category: Choose from a list of available Secondary Categories. This list is maintained by Apple.
Keywords: These are used as search terms for your apps, on the App Store.
Copyright: Add your copyright text for your brand here.
Content Rating: Provide a suitable and accurate age rating for your app.
App Tracking: After the release of iOS 14, Apple made it compulsory to ask the app users for permission to share their ads-related information with third parties. Turning on this toggle will show a pop-up message to the user (only on the first app launch) asking for their permission. It is mandatory to turn this toggle on if you plan to use Ads functionality in your Apps.
iOS Image Assets
Please provide all Image assets for iOS, as per the required specifications. These assets are mandatory for final submissions. Screenshots can be skipped during the test build creation process. However, these will be required during the final app submission.
Learn more about Apple's App Screenshot Specification here.
iOS Video Assets
These videos will be displayed next to your app screenshots, in the App Store. This is a creative way to showcase your apps on the App Store. However, these are not mandatory.
Learn more about Apple's App Preview Specifications here.
tvOS Image Assets
Please provide all Image assets for tvOS, as per the required specifications. These assets are mandatory for final submissions. Screenshots can be skipped during the test build creation process. However, these will be required during the final app submission.
App Store Connect Developer Access
Granting Access to Your Apple Developer Account - It is required to grant access to your Apple Developer account by adding devaccounts@mazsystems.com as an Admin user. This access allows us to create, submit, and maintain your Apple apps on your behalf. For more information on creating an Apple Developer account and providing access, [click here].
Dev Team ID and Developer Account Name - To find your Dev Team ID and Developer Account name, log into developer.apple.com and navigate to the Membership Details tab.
iTunes Connect (ITC) Team ID - You do not need to provide the iTunes Connect (ITC) Team ID. We will obtain this on your behalf.
Apple ID - Apple ID is the email address associated with your Apple Developer account. Providing this is not mandatory, so you can skip this step.
Apple Shared Secret - The Apple Shared Secret is only required if your app offers paid content across multiple platforms. If this does not apply to your app, you may skip this step.
Note: For new app submissions, you cannot generate or add this key until the App Shell is created. You can skip this step, and we will obtain the key for you.
To retrieve the Apple Shared Secret, follow these steps:
- In Apple App Store Connect, navigate to Apps and select your app. From the sidebar, under General, click on App Information.
- In the App-Specific Shared Secret section, click Manage.
- You can generate a shared secret for individual apps, or regenerate a shared secret.
Note: Clicking Regenerate will automatically generate a new shared secret, and any previously generated shared secret for this app will be invalidated.
-
To generate a shared secret, click Generate or Regenerate in the dialog.
-
Then click Done.
- Copy the code and paste it into the Apple Shared Secret field.
Configuration Settings
App Store ID: You can skip filling in this as we will procure this, for you.
iOS Google Analytics Tracking ID: With the transition from Universal Analytics to Google Analytics 4 (GA4), the UA tracking ID is no longer required. You can safely leave the tracking ID field unchanged, as it is no longer applicable under GA4.
tvOS Google Analytics Tracking ID: With the transition from Universal Analytics to Google Analytics 4 (GA4), the UA tracking ID is no longer required. You can safely leave the tracking ID field unchanged, as it is no longer applicable under GA4.
App Bundle ID: This is a unique identifier for your app on the Apple Store Connect. Our system auto-generates a new Bundle ID for each Apple app created in our system.
If you already have an old app on the App Store and want us to submit an app update over that with a new Zype app, please send us the old Bundle ID of your app to submissions@mazsystems.com, to get it updated in our system. Your old app's developer can help you find this bundle identifier. You can also find it in App Store Connect.
Firebase Settings
We rely on Firebase to provide you with Analytics and Push notification services. Therefore, it is mandatory to register your iOS app with Firebase.
You can follow this guide to register your iOS app on Firebase.
App Store API Settings
These settings enable our automation servers and scripts to connect with your App Store Connect account and perform important tasks on your account. Please follow the below steps to provide us with this information.
Step 1: Log in to App Store Connect at appstoreconnect.apple.com and navigate to Users and Access >> Integrations >> Team Keys.
Step 2: Click on the plus icon to add a new key. If this is your first key, you may see another button that says "Add key".
Step 3: You will be shown a pop, provide a name for the key (eg. Zype) and choose Access as Admin. Click on Generate.
Upon generating a key, it will appear on the same page.
Step 4: Grab the Issuer ID, Key ID, and the p8 certificate file from the above step and add it to the Apps Creator Dashboard. Please note that the p8 certificate file can only be downloaded once, if you lose this file, you will need to generate a new key. Therefore, please keep it safe for future use.
Enabling Push Notifications on iOS
We use Firebase Cloud Messaging to power Push notifications in our apps. In order to connect the Apple Push Notification service to your Firebase account, please follow this article.
Congratulation! You have successfully configured your iOS and tvOS apps. If all the above steps are completed, we are ready to create builds for your Apple apps. Write to us at submissions@mazsystems.com to request test builds. Please note, that generating test builds may take 5-7 business days after we receive the request.