Configuring an App in iTunes Connect
Important
Apple has indicated that starting in March 2019, all apps and updates submitted to the App Store must have been built with the iOS 12.1 SDK or later, included in Xcode 10.1 or later. Apps should also support the iPhone XS and 12.9" iPad Pro screen sizes.
iTunes Connect is a suite of web-based tools for, among other things, managing iOS applications on the App Store. A Xamarin.iOS application will need to be properly set up and configured in iTunes Connect before it can be submitted to Apple for review and ultimately released for sale or as a free app in the App Store.
iTunes Connect can be used for the following:
- Set the application's name (as displayed in the App Store).
- Provide screenshots or video of the application in action on the iOS devices it supports.
- Provide a clear, succinct description of the application including it's features and benefit to the end user.
- Provide Categories and Sub-Categories to help the user find the app in the App Store.
- Provide any keyword that can further help a user find the app.
- Provide Contact and Support URLs to your website (required by Apple).
- Set the application's Rating, which is used to inform parental controls on the App Store.
- Select a sale price or specify that the application will be released for free.
- Configure optional App Store technologies such as Game Center and In-App Purchase.
In addition, the app should also have attractive, high-resolution artwork available in case Apple decides to feature it in the App Store. For more information, please see Apple's iTunes Connect Developer Guide.
Managing Agreements, Tax and Banking
The Agreements, Tax, and Banking section of iTunes Connect is used to provide required financial information relating to iTunes developer payments and tax withholdings and to track the status of any agreements you have in place with Apple. Before you can release an iOS application on the App Store (either for free or for sale), you'll need to have the proper agreements in place and have agreed to any modifications to existing agreements.
From here you can:
- Provide a Team Agent and define other user roles for your iTunes Connect account such as Admin or Finance.
- Enroll in and maintain Contracts that allow an organization to distribute applications in the App Store.
- Specify the Legal Entity name (Seller Name in the App Store) used to match contracts, banking information, and tax information that are associated with your organization.
- Provide Banking and Tax information if you are going to sell applications through the App Store.
Again, this information must be properly set up, in place, and up-to-date before an iOS application can be submitted to iTunes Connect for review and release. For more information, please see Apple's Managing Agreements, Tax and Banking documentation.
Creating an iTunes Connect Record
Before a Xamarin.iOS application can be uploaded to iTunes Connect for distribution through the App Store, you will need to create a record for the application in iTunes Connect. This record includes all the information about the application as it will appear in the App Store (in as many languages as required) and all of the information needed to manage the app through the distribution process. Additionally, it will be used to configure App Store technologies such as the iAd App Network or Game Center.
To add an iOS application to iTunes Connect you will need to be the Team Agent or a user with an Admin or Technical role.
Do the following in iTunes Connect:
Click on My Apps:
Click the + in the upper left hand corner and select New iOS App:
iTunes Connect will display the New iOS App dialog:
Enter a Name and Version Number for the application as they should be displayed in the App Store.
Select the Primary Language.
Enter a SKU number, this is a unique, constant, identifier that will be used the track the application. It will not be displayed to the end user and it cannot be changed once the app has been created.
Select the Bundle ID for the application that you created in the developer center when you provisioned the application. This same Bundle ID will need to be used when signing the distribution bundle in Visual Studio for Mac or Visual Studio. For more information, please see our Creating a Distribution Profile and Selecting a Distribution Profile in a Xamarin.iOS Project documentation.
Click the Create button to build the new iTunes Connect Record for the application.
The new application will be created in iTunes Connect and will be ready for you to fill in the required information such as Description, Pricing, Categories, Ratings, etc.:
Managing App Videos and Screenshots
One of the most important elements to successfully marketing your iOS application in the App Store is a great set of screenshots and, optionally, video previews. Use actual views of your application running that highlight user interaction and showcase its unique features. Use application preview videos to give users an idea of what it is like to use the application.
Apple suggests the following when taking screenshots:
- Optimize your screenshot for best presentation on the iOS devices supported by your application and make sure the content is legible.
- Don't frame the screenshot in an iOS device image.
- Show the actual view of your application, using the full screen, without graphics or borders around the screenshot.
- Always remove the status bar from screenshots, iTunes Connect expects screenshots of dimensions that exclude that area.
- When possible, take screenshots on real, high-resolution Retina iOS hardware (not in iOS Simulator).
- The first screenshot appears as a search result in the App Store on iPhone and iPad if no app preview video is available, so place the best screenshot first.
- Use all five screenshots to tell the story of the application while highlighting moments that make it compelling.
Apple requires screenshots and videos be provided at every screen size and resolution that your application supports. Additionally, portrait and landscape versions should be provided, based on the orientations supported.
The following screen sizes and resolutions are currently required:
| Device | Portrait (No Status Bar) | Portrait (Full Screen) | Landscape (No Status Bar) | Landscape (Full Screen) |
|---|---|---|---|---|
| 3.5" Retina | 640 x 920 | 640 x 960 | 960 x 600 | 960 x 640 |
| 4" Retina | 640 x 1096 | 640 x 1136 | 1136 x 600 | 1136 x 640 |
| 4.7" Retina(iPhone 6) | n/a | 750 x 1334 | n/a | 1334 x 750 |
| 5.5" Retina(iPhone 6 Plus) | n/a | 1242 x 2208 | n/a | 2208 x 1242 |
| iPad Standard | 768 x 1004 | 768 x 1024 | 1024 x 748 | 1024 x 768 |
| iPad Retina | 1536 x 2008 | 1536 x 2048 | 2048 x 1496 | 2048 x 1536 |
App Preview Videos are in the following sizes and resolutions:
| iOS Device | Native Resolution | Accepted Landscape | Accepted Portrait |
|---|---|---|---|
| iPhone 5 & 5s | 1136 x 640 (16:9) | 1920 x 1080 1136 x 640 |
1080 x 1920 640 x 1136 |
| iPad | 2048 x 1536 (4:3) | 1200 x 900 | 900 x 1200 |
| iPhone 6 | 1334 x 750 | 1334 x 750 | 750 x 1334 |
| iPhone 6 Plus | 2208 x 1242 (Rendered Pixels)1920 x 1080 (Physical Pixels) | 1920 x 1080 | 1080 x 1920 |
Editing Screenshots in iTunes Connect
Do the following in iTunes Connect:
Click on My Apps.
Click on your application's Icon.
Select the Versions tab.
Scroll to the Screenshots section.
Select the Image Size and drag in the required images (up to 5 per screen size):
Repeat for all required screen sizes.
Click the Save button at the top of the screen to save your changes.
Note
Note: Apple will reject your submission if the screenshots or App Preview Video do not match the current functionality in your application.
Managing Name, Description, What's New, Keywords and URLs
This section of the iTunes Connect Application Record provides localized information about the application, what it does, any modifications to new versions, keywords used in search and iAd support and any supporting URLs.
App Name
Choose a descriptive application name that reflects what your application does. Try to keep it as short and concise as possible. Your application's name plays a critical role in how users search for and discover it, so keep the name simple and easy to remember. Pay particular attention to how the name appears when viewed on an iOS device (iPad, iPhone, and iPod touch).
Apple suggests the following guidelines when choosing an application's name:
- Keep it short, simple, and easy to remember.
- Make sure it doesn't violate the copyright or trademarks of a 3rd party.
- Make it match the functionality of the application.
- Provide localized names for foreign markets where appropriate.
Description
Write a clear, concise, and informative description of the application and its features. The first few lines are the most important and give you a chance to make a great first impression and to draw the user in. Describe what makes your application special and separates it from other, similar apps.
Apple suggests the following for writing an application's description:
- Include a brief opening paragraph or two and a short bulleted list of main features.
- Provide localized descriptions for foreign markets where appropriate.
- Include user reviews, accolades, or testimonials only at the end, if at all.
- Use line breaks and bullets to enhance legibility.
- Be aware of how the app description displays in the App Store on each device type, to make sure the most important sentences in your description are readily visible.
What's New
When uploading a new version of your application, a What’s New in this Version field will be available that should be completed thoroughly and thoughtfully.
Apple suggests the following guidelines when filling in the What's New information:
- Add messaging to encourage users to update.
- List items in order of importance and pinpoint changes and bug fixes.
- Present the changes in plain and authentic language rather than technical jargon.
Keywords
Thoughtful and strategic keywords pertaining to the functionality of your application help users locate your application easily when searching on the App Store. In addition, if your application serves up iAd ads, the iAd App Network uses the keywords when choosing the ads to target in your app.
Apple suggests the following when choosing keywords:
- Don’t use competing app names, company or product names, or trademarked names.
- Don't use generic words or terms.
- Avoid inappropriate or objectionable terms or irrelevant words such as celebrity names.
- Localize keywords for foreign markets when appropriate.
URLs
Apple requires that the developer provide a link to their website to support any issue or questions that a user might have about the application. They also require a link to the application's Privacy Policy (which, again, must be hosted on your website).
Optionally, you can provide a link to marketing information hosted on your website that can be used to provide more information about the application than is provided in the App Store.
Editing Name, Description, What's New, Keywords, and URLs in iTunes Connect
Do the following in iTunes Connect:
Click on My Apps.
Click on your application's Icon.
Select the Versions tab.
Scroll to the Name section.
Fill in all the required information:
Click the Save button at the top of the screen to save your changes.
Important
Note: Apple will reject your submission if the Name, Description, What's New, Keywords or URLs do not match the current functionality in your application.
Maintaining General App Information
This section of the iTunes Connect Application Record provides the unique ID of the application (as assigned by Apple), the categories the application belongs in, rating, copyright and information about the company releasing the application.
App Icon
Important
App Icons are no longer submitted through iTunes Connect. They must be submitted through the AppIcon image set in your project's Assets.xcassets file. For more information, see the App Store Icon guide.
The App Icon is the face of your application to your users, so it must be memorable and display well at a small size. Memorable icons are clean, simple, and immediately recognizable.
Apple suggests the following guidelines when designing your applications icon:
- Make the icon appropriate for your application.
- Create a simple icon that is consistent with the design of your application.
- Avoid using words in your icon.
- Think globally: A single app icon is used in all store territories.
A 1024 x 1024 pixel image is required for the App Icon that will be displayed in the App Store.
For more information, see Apple's iOS Human Interface Guidelines and the description of Large App Icon section in General App Information Documentation
App ID
This is a unique identification number assigned to your application by Apple when the iTunes Connect Record is created. You can use this number when calling several web-based interfaces that Apple provides, including App Store information in your website.
Version Number
This is the current, active version of your application as displayed to the user in the App Store.
Category and Sub Category
One important aspect of discoverability for your application is the category it appears in on the App Store. Categories allow users to browse through a collection of apps and find the ones that they are interested in. iTunes Connect lets you assign up to two different categories when defining your application. Make sure to carefully choose categories that best describe the main function of your application.
Ratings
All applications are required to have a rating in the App Store. This rating is used to inform parental control and limit access to children based on the applications's type and content. When defining your application, iTunes Connect provides a list of content descriptions for which you identify how frequently the content appears in your application. These selections are converted into the rating that is displayed in the App Store.
When creating applications for children, the App Store has a special category for children aged 11 and under. Even if your application isn’t specifically targeted at kids, you help your customers make good choices by providing appropriate content ratings.
Important
Note: Apple will reject any application submission that it finds obscene, pornographic, offensive, or defamatory.
Copyright and Company Information
Apple allow you to provide copyright information for your application and requires information about the company releasing the application such as its address and contact information (which is required for applications released to the Korean App Store). This information will be displayed in the App Store as required.
Editing General App Information in iTunes Connect
Do the following in iTunes Connect:
Click on My Apps.
Click on your application's Icon.
Select the Versions tab.
Scroll to the General App Information section.
Fill in all the required information:
Click on the Edit button by the Rating to set the rating information:
Click the Save button at the top of the screen to save your changes.
Note
Note: Apple will reject your submission if the Categories or Ratings do not match the current functionality in your application.
Maintaining Game Center Information
For iOS game applications that support Apple's Game Center, you can provide information such as the leader boards and in-game achievements that are available to the user and if the application is multiplayer-compatible across a network connection.
Editing Game Center Information in iTunes Connect
Do the following in iTunes Connect:
Click on My Apps.
Click on your application's Icon.
Select the Versions tab.
Scroll to the Game Center section.
Flip the switch by the Game Center section to the On position.
Fill in all the required information:
Click the Save button at the top of the screen to save your changes.
Use the Game Center tab to activate Game Center and maintain any available Leaderboards or Achievements for this application:
Maintaining App Review Information
Use this section to provide required information to the Apple personnel that will be reviewing your application such as the contact information (if the tech has any questions), any demo accounts that might be required, and any notes that can help the tester successfully review your app.
Editing App Review Information in iTunes Connect
Do the following in iTunes Connect:
Click on My Apps.
Click on your application's Icon.
Select the Versions tab.
Scroll to the App Review Information section.
Fill in all the required information:
Select how you wish the application to be released to the App Store after it has been successfully reviewed:
Click the Save button at the top of the screen to save your changes.
Maintaining Pricing Information
If you plan on releasing your application for sale, you'll need to set the sales price by selecting one of Apple's available pricing tiers and the date that the given pricing goes into effect. For example, as of the time of this writing, the Tier 1 pricing looks like the following:
Educational Discount
Check this box if you want your application to be offered at a discount to educational institutions when they purchase multiple copies at once. The details of the discount are found in the latest Paid Application Agreement, which you must sign before this application will be available to education customers.
Custom Business to Business Application
An application that is set up as a Custom Business to Business Application will only be available to the Volume Purchase Program customers that you specify in iTunes Connect, and it will only be available in the applicable territories (for example, U.S. Volume Purchase Program customers must use the U.S. App Store Volume Purchase Program for Business).
Custom Business to Business applications will not be available to educational institutions or general App Store customers.
Editing Pricing Information in iTunes Connect
Do the following in iTunes Connect:
Click on My Apps.
Click on your application's Icon.
Select the Pricing tab:
Select an Availability Date.
Select the desired price from the Price Tier dropdown list.
Optionally enable Educational Discounts.
Optionally define the application as a Custom Business to Business Application.
Click the Save button to save your changes.
Maintaining In-App Purchase Information
If you plan on selling virtual, In-App products from your application (such as new game levels or application features) you will use this section to create and maintain those purchase items.
For more information about working with In-App Purchases in a Xamarin.iOS application, please see our In-App Purchasing documentation.
Viewing Application Reviews
Once your application has been released to the App Store, users who purchase or download the application for free can write reviews of the app and leave star ratings. Use this section to see those reviews. For example:
Summary
This article describes how to use iTunes Connect to prepare a Xamarin.iOS application for release to the App Store and how to maintain all of the information displayed about your application in the store.