Configuring Store Technologies (Optional)

When apps are distributed through the App Store or Mac App Store, they can take advantage of Apple store technologies such as Game Center and In-App Purchase. If you implement any of these store technologies in your app, you use iTunes Connect to configure the interaction between your app and the Apple services. You also use iTunes Connect to register any additional content that you want to make available through one of these technologies. The store technologies that may require additional configuration in iTunes Connect include:

Adding Configurations for Store Technologies to the App Record

After you create an iTunes Connect record for your app, you have access to pages for configuring store technology assets used by the app. You access each store technology page from buttons on the App Summary page for the app.

../Art/apps_appsum_st-buttons_2x.png../Art/apps_appsum_st-buttons_2x.png

iCloud Display Sets

Your apps can use iCloud to store related documents and data. The documents and data are stored in containers that you configure in the app’s Info.plist. No iTunes Connect configuration is required to enable an app to use iCloud containers.

In addition to iCloud containers, iCloud supports display sets that allow multiple iCloud apps to use a single entry in the iCloud Documents & Data user settings. Each app still writes data to its container; the display set references the storage used for all the containers. To use iCloud display sets, you need to configure the display set in iTunes Connect, identify the apps that use it, and reference the display set from each app’s Info.plist.

For example, you might provide a custom calendar app, a task-list app, and an alarm clock app that have their own iCloud containers, each of which shows up in users’ Documents & Data settings in iCloud. If you wanted to have users configure data storage for these apps in a single setting, you could create an iCloud display set called “NotifyMe” that included the containers for all three apps. You would set up iCloud containers for each app:

Each app would still write to its container, but the user would see only the NotifyMe display set when configuring iCloud to store data for these apps.

Viewing iCloud Display Sets in iTunes Connect

iTunes Connect users with Admin or Technical roles can access the Manage Your iCloud Display Sets page.

bullet
To view iCloud display sets
  1. As an iTunes Connect user with an Admin or Technical role, sign in to iTunes Connect.

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

    ../Art/module_icon_apps_2x.png
  3. At the bottom of the page, click iCloud Manage Display Sets.

    ../Art/icl_button_2x.png

The Manage Your iCloud Display Sets page opens, showing any display sets that are already configured for your organization. The table lists each display set, its reference name, display set ID, and the number of apps attached to it. Apps appear in this count after they are configured to use this display set and are uploaded to iTunes Connect.

../Art/icl_home_2x.png../Art/icl_home_2x.png

Creating iCloud Display Sets

For each display set, you must enter the following values:

  • Reference Name. An internal name. It must be at least two characters and can be up to 255 bytes, assuming single-byte characters. It’s displayed in iTunes Connect only.

  • Display Set ID. A unique identifier used to associate your app with the display set. Use the same ID in your binary’s Info.plist file, NSUbiquitousDisplaySet key. This string must be a uniform type identifier (UTI) and can contain only alphanumeric characters, hyphens, and periods. The string should also be in reverse-DNS format and can’t end in .test.

  • Display Set Name. The label that users see when they configure iCloud settings for your apps. Localize this label for each of the languages your apps support.

bullet
To create a new display set in iTunes Connect
  1. Open the Manage Your iCloud Display Sets page for the app, as described in “To open the App Summary page for an app.”

  2. Click Create New.

  3. Enter a reference name and display set ID.

  4. Click Add Language.

  5. Select the default language for your apps.

  6. In the Display Name field, enter the display set label that users see.

    The display name must be at least two characters and can be up to 75 bytes, assuming single-byte characters.

  7. Click Save to save the language.

  8. Repeat the language configuration from steps 4 through 7 for each language your apps support.

  9. Click Save.

Managing iCloud Display Sets

The display sets created for your organization appear listed in a table on the Manage Your iCloud Display Sets page. From this page, you can do the following:

  • View or edit a display set’s details.

    Click the row containing the display set. The detail page lists the apps that are attached to this display set. From this page you can change the Reference Name or add or delete Display Name languages.

    ../Art/icl_details_2x.png../Art/icl_details_2x.png
  • Delete a display set.

    In the row containing the display set, click Delete.

    You can delete a display set unless there is an app attached to it.

iAd App Network

iAd is Apple’s digital advertising platform. As an iOS app developer, you can take advantage of iAd in two ways:

The following sections describe how to join the iAd App Network and start generating revenue through ads in your iOS app. If you need more information, see “iAd App Network” in the iTunes Connect FAQ, available by clicking FAQ at the bottom of any iTunes Connect page.

Setting Up an App to Display iAd Ads

To join the iAd App Network and allow an app to access the iAd App Network, follow these steps:

Disabling the iAd App Network for an App

To remove ads from an app, you must submit a new binary without the iAd Framework. See “Replacing Your App with a New Version” in iTunes Connect Developer Guide.

Monitoring iAd Performance and Revenue

iAd reporting in iTunes Connect allows you to monitor ad performance and track revenue.

bullet
To review ad performance for an app
  1. Integrate the iAd Framework for at least one app and submit it for review, as described in “Setting Up an App to Display iAd Ads.”

  2. On the iTunes Connect homepage, click Grow Your Business With iAd.

    ../Art/itc_home_iad_2x.png../Art/itc_home_iad_2x.png
  3. On the iAd page that opens, in the Monetize section, click View Your iAd Reports.

    Use this module to track iAd ad performance.

Newsstand

Newsstand lets you deliver magazine and newspaper content as issues to iOS users. You enable your app for Newsstand in iTunes Connect. You also use iTunes Connect to set up issues or configure a feed to automate the management of issues.

The Newsstand metadata you set up in iTunes Connect is displayed on the store only. The app itself is responsible for delivering content to users. For information on creating a Newsstand app, see Newsstand Kit Framework Reference.

Newsstand can be enabled for new and existing apps in iTunes Connect. After a Newsstand-enabled version of your app is posted to the store, all future versions of the app are also Newsstand enabled. Newsstand can’t be disabled in the app in later versions.

Configuring a Newsstand-Enabled App in iTunes Connect

When you create an iTunes Connect record for an app designed to deliver newspaper or magazine content, you follow these steps:

To submit a Newsstand app, your app binary needs to include the following:

  • The Info.plist file must include the setting UINewsstandApp=true.

  • The UINewsstandicon attribute must be included in the CFBundleIcons key.

Enabling Newsstand for an App

You can enable your app for Newsstand from the App Summary page.

For the Newsstand button to appear on the App Summary page, your app status must be in one of these pre-binary-upload statuses:

  • Prepare for Upload

  • Rejected

  • Developer Rejected

  • Invalid Binary

  • Waiting For Upload

The Newsstand button appears on the App Summary page for existing apps after a new version is created and that new version is in a pre-binary-upload state.

bullet
To enable Newsstand for an app
  1. Open the App Summary page for the app you want to include in Newsstand, as described in “To open the App Summary page for an app.”

  2. Click Newsstand Status.

    ../Art/ns_newsstand_button_2x.png

    If the button reads Manage Newsstand, Newsstand has already been enabled for the app.

  3. Click Enable.

  4. (Optional) Select a Newsstand subcategory where you want your app to appear.

    Selecting a subcategory enhances its discoverability on the store.

  5. Upload cover art to use on the store if a specific issue isn’t available.

    The default cover art you specify here is used to represent your app on the store when there are no issues available for your app on a given date or you don’t provide issue art for an issue.

    The cover art must be a .png file, at least 72 dpi, with a minimum of 512 pixels on the long edge, and an aspect ratio between 1:2 and 2:1. The artwork must be flat, with no rounded corners. For more information, see “Newsstand Icons” in iOS Human Interface Guidelines.

    ../Art/ns_appstore_callout_2x.png
  6. Click Save.

  7. If you haven’t already configured one or more subscriptions for the app, a message appears prompting you to set up the subscriptions. See “Providing Access to Privacy Policies for Subscriptions” in In-App Purchase Configuration Guide for iTunes Connect.

Managing Newsstand Issues

To configure issues you want to distribute through the store, you either describe each issue in iTunes Connect or identify an atom feed to provide the issue information directly to the store. At any time, you can update the metadata for the issue.

If you choose to configure the issues through iTunes Connect, you need the following information for each issue:

  • Published Date. The date you want this issue to be available on the store (it displays at the beginning of the day).

  • End Date (optional). The date you want this issue to be removed from the store (it’s removed at the beginning of the day). For example, a special one-day issue would be added at the beginning of one day and removed at the beginning of the next day.

  • Issue ID. An internal identifier that isn’t visible on the store.

  • Summary. A summary of the issue that customers see on the store. The summary can be as long as 2000 characters, assuming single-byte characters.

  • Issue Cover Art. The cover art to be displayed on the store while this issue is current. It displays where the app icon appears. The cover art must be a .png file, at least 72 dpi, having a minimum of 512 pixels on the long edge and an aspect ratio between 1:2 and 2:1. The artwork must be flat, with no rounded corners. If you don’t add issue cover art, your Newsstand default cover art is displayed on the store while this issue is current.

bullet
To add an issue
  1. Open the App Summary page for the Newsstand app, as described in “To open the App Summary page for an app.”

  2. Click Manage Newsstand.

    If the button reads Newsstand Status, Newsstand hasn’t been enabled for the app. See “Enabling Newsstand for an App.”

  3. Click Add Issue, and complete the fields.

  4. Click Save.

  5. Click Done.

bullet
To edit an issue
  1. From the App Summary page, click Manage Newsstand.

  2. In the Issues table, click anywhere in the row for the issue you want to change.

  3. In the dialog that appears, make any changes you need and click Save.

bullet
To delete an issue
  1. From the App Summary page, click Manage Newsstand.

  2. In the Issues table, in the row describing the issue you want to remove, click the Delete button.

  3. Click Delete to confirm.

Updating Issues on the Store Automatically

If you want to post issue information to the store directly without itemizing each issue in iTunes Connect, you can provide store metadata through an atom feed by providing a URL for the feed. The store processes the feed once a day, incorporating any new information.

If the store experiences an issue with your atom feed, an email notification is sent to all users in your organization who have an Admin or Technical role.

For more information, see Newsstand Atom Feed Specification.

bullet
To set an atom feed URL for an app
  1. Open the App Summary page for the Newsstand app, as described in “To open the App Summary page for an app.”

  2. On the App Summary page, click Manage Newsstand.

  3. Click Add Atom Feed.

  4. Provide the atom feed URL and, if needed, a user name and password.

  5. Click Save.

    iTunes Connect validates the atom feed URL. If iTunes Connect can’t process the feed, an error message appears indicating the validation issue.