Managing Your App in iTunes Connect

iTunes Connect is a marketing and business web tool that iOS and Mac developers use to sign contracts, set up tax and banking information, submit versions of their app, and obtain sales and finance reports. During development, you enter metadata about your app, technologies that it uses, and any version information in iTunes Connect. This chapter teaches you tasks you perform in iTunes Connect during development and distribution to the store.

Initially, only the individual who joins the developer program has access to iTunes Connect. Because iTunes Connect is primarily used to manage the business aspects of your app, and people performing those types of tasks are typically not developers, you can tightly control access to iTunes Connect separately from your Member Center account. For example, you can add nondeveloper iTunes Connect users and control access to metadata by assigning roles and privileges.

iTunes Connect users with admin and technical roles perform a number of tasks, explained in this chapter, in support of the development team and related to submitting your app to the store:

  1. Add iTunes Connect users to give other team members access to iTunes Connect.

  2. Create your app record so you can configure key technologies and services, and submit your app.

  3. View the status of your app when you’re ready to submit it or waiting for approval.

  4. Change the availability date of an app to release it.

  5. View crash reports and customer reviews after your app is available.

  6. Create a new version of your app.

For complete documentation on using iTunes Connect, refer to iTunes Connect Developer Guide.

About iTunes Connect User Roles and Privileges

The person who enrolls in the developer program—called the team agent—manages access privileges to iTunes Connect. For example, changing the price of an app is a task you likely want to limit to a small number of people in your organization. Access to the iTunes Connect tool is configured separately and is designed to be more fine-grained than the access you set for team members. In iTunes Connect, each user can be assigned one or more roles; each role has different privileges. Table 9-1 describes the roles at a high level.

Table 9-1  iTunes Connect roles and responsibilities

Role

Responsibilities

Legal

The legal role is automatically assigned to the team agent, and only the team agent is permitted to have this access. The legal role allows the team agent to sign legal contracts and other agreements.

Admin

The admin role grants access to all tasks in iTunes Connect except for those assigned to the legal role. A team agent is always assigned the admin role, and this access can’t be revoked without changing which person on the team acts as the team agent. An admin can assign iTunes Connect roles to other people on the team.

Technical

The technical role grants the ability to edit the app information stored in iTunes Connect and to view test accounts for certain technologies and services.

Finance

The finance role grants access to financial reports and sales information. The finance role also authorizes the person to view contract, tax, and banking information.

Sales

The sales role grants access only to sales data.

Table 9-2 lists the most common modules (areas of iTunes Connect) you need to access, along with the roles that have access to each module. The legal role isn’t shown, because only the team agent has those rights. All participants can edit their own personal details stored in their accounts in iTunes Connect.

Table 9-2  Abbreviated list of iTunes Connect modules, including availability by role

Responsibility

Legal

Admin

Technical

Finance

Sales

Manage Users

../Art/checkmark_2x.png

../Art/checkmark_2x.png

../Art/x_2x.png

../Art/x_2x.png

../Art/x_2x.png

Manage Test Users

../Art/checkmark_2x.png

../Art/checkmark_2x.png

../Art/checkmark_2x.png

../Art/x_2x.png

../Art/x_2x.png

Manage Your Apps

../Art/checkmark_2x.png

../Art/checkmark_2x.png

../Art/checkmark_2x.png

../Art/x_2x.png

../Art/x_2x.png

Sales and Trends

../Art/checkmark_2x.png

../Art/checkmark_2x.png

../Art/x_2x.png

../Art/checkmark_2x.png

../Art/checkmark_2x.png

Tax and Banking

../Art/checkmark_2x.png

../Art/checkmark_2x.png

../Art/x_2x.png

../Art/checkmark_2x.png

../Art/x_2x.png

Contracts

../Art/checkmark_2x.png

../Art/x_2x.png

../Art/x_2x.png

../Art/x_2x.png

../Art/x_2x.png

Payments and Financial Reports

../Art/checkmark_2x.png

../Art/checkmark_2x.png

../Art/x_2x.png

../Art/checkmark_2x.png

../Art/x_2x.png

Catalog Reports

../Art/checkmark_2x.png

../Art/checkmark_2x.png

../Art/checkmark_2x.png

../Art/checkmark_2x.png

../Art/checkmark_2x.png

Accessing iTunes Connect

iTunes Connect is the repository for all store-related assets, including your app binaries. You use iTunes Connect to market and distribute your app, check the status of your contracts, set up tax and banking information, get sales and finance reports, and manage your app’s metadata. You can give another set of users access to your iTunes Connect account. You access iTunes Connect from Member Center or by going directly to the iTunes Connect website.

bullet
To go to iTunes Connect from Member Center
  1. Sign in to Member Center.

  2. Click the icon or text for iTunes Connect in the App Store Distribution section under Developer Program Resources.

  3. Enter your Apple ID and password, and click Sign In.

    ../Art/10_itunesconnectlogin_2x.png../Art/10_itunesconnectlogin_2x.png

Adding iTunes Connect Users

To add an iTunes Connect user, read “Setting Up User Accounts” in iTunes Connect Developer Guide.

Creating an App Record

Certain technologies and services require you to create an app record and enter the bundle ID using iTunes Connect during development. Later, you also need to create an app record in iTunes Connect to submit your app to the store. When you’re ready to create your app record, read “Adding New Apps” in iTunes Connect Developer Guide.

Viewing the Status of Your App

To submit your app to the store, the status of the app record needs to be “Waiting for Upload” or later. You can view the status of your app in iTunes Connect.

bullet
To view the status of your app
  1. Sign in to iTunes Connect.

  2. On the iTunes Connect homepage, click Manage Your Apps.

  3. Locate the app you want to edit, and click the large icon or app name.

    The status of each version of your app appears below in the Versions section below the version number.

    ../Art/10_apps_ball_maze_2x.png../Art/10_apps_ball_maze_2x.png

For details on each status, refer to “Viewing and Changing Your App’s Status and Availability” in iTunes Connect Developer Guide.

Changing the Status to Enable Uploading

If you are ready to upload a binary—that is, validate or submit your app using Xcode—and the status of your app version is “Prepare for Upload”, you need to provide more information to iTunes Connect to change the status to “Waiting for Upload” before continuing.

bullet
To change the status from “Prepare for Upload” to “Waiting for Upload”
  1. Sign in to iTunes Connect.

  2. On the iTunes Connect homepage, click Manage Your Apps.

  3. Under Versions, click View Details below the current version.

    ../Art/10_apps_ball_maze_2x.png../Art/10_apps_ball_maze_2x.png
  4. On the Versions Details page, click “Ready to Upload Binary.”

  5. If a message appears at the top of the page indicating that additional configuration is required, resolve the issue before continuing.

  6. Then answer questions about Export Compliance, and if needed, upload encryption authorization documents.

  7. Click Save.

Changing the Availability Date of Your App

Use iTunes Connect to set a date when the app is available on the store. For example, you can choose a date that immediately releases the app to the store after it’s approved, or you can set a later date. Using a later availability date allows you to arrange other marketing activities around the launch of your app.

bullet
To set the availability date
  1. Sign in to iTunes Connect.

  2. Select Manage Your Apps.

  3. Select your app in the Recent Activity section.

  4. Click Rights and Pricing.

  5. Choose a date from the Availability Date pop-up menus.

    ../Art/10_rightsandpricing_2x.png../Art/10_rightsandpricing_2x.png
  6. Optionally, edit the other fields in this form.

  7. Click Save.

Changes you make to Rights and Pricing go live immediately (expect 24 hours for a full refresh of the changes on the store).

Viewing Crash Reports

All crash logs contain stack traces for each thread at the time of termination. To view a crash log, open it from the Xcode Organizer window. As long as your Mac computer has the archive corresponding to the version of the app that generated the crash log, Xcode automatically resolves any addresses in the crash log with the actual classes and functions in the app.

You view and save crash reports in iTunes Connect from the version details page.

bullet
To view crash reports
  1. Sign in to iTunes Connect.

  2. On the iTunes Connect homepage, click Manage Your Apps.

  3. Locate the app you want to edit, and click the large icon or app name.

  4. Click View Details for the version of your app.

  5. Click Crash Reports in the upper-right corner.

    ../Art/10_apps_crash_report_button_2x.png../Art/10_apps_crash_report_button_2x.png
  6. Click Refresh Now to retrieve any new available crash reports.

  7. Select the crash report you want to view, and save the crash report you want to retain.

To view the crash reports in Xcode, follow the steps in “Analyzing Crash Reports.”

Viewing Customer Reviews

You view customer reviews in iTunes Connect in the same way that you view crash reports, described in “Viewing Crash Reports,” except that you select Customer Reviews in the upper-right corner.

bullet
To view customer reviews
  1. Sign in to iTunes Connect.

  2. On the iTunes Connect homepage, click Manage Your Apps.

  3. Locate the app you want to edit, and click the large icon or app name.

  4. Click View Details for the version of your app.

  5. Select Customer Reviews under Links.

    If this link isn’t displayed, customer reviews aren’t available for this version of your app.

    ../Art/10_customer_reviews_button_2x.png../Art/10_customer_reviews_button_2x.png

Creating New Versions of Your App

To create new versions of your app, read “Replacing Your App with a New Version” in iTunes Connect Developer Guide.

Recap

In this chapter, you learned how to grant access to iTunes Connect and perform common iTunes Connect tasks performed by technical team members.