SKStoreProductViewContro ller Class Reference
Inherits from |
UIViewController
|
Conforms to |
NSCoding (UIViewController)
UIAppearanceContainer (UIViewController) NSObject (NSObject) |
Framework |
/System/Library/Frameworks/
StoreKit.framework
|
Availability |
Available in iOS 6.0 and later.
|
Companion guide | |
Declared in |
SKStoreProductViewContro |
Overview
A SKStoreProductViewContro
To display a store, create a new SKStoreProductViewContro
To choose a specific product, call the loadProductWithParameter
Tasks
Setting a Delegate
delegate property
Loading a New Product Screen
–
loadProductWithParameter s:completionBlock: -
Properties
delegate
The store view controller’s delegate.
@property(nonatomic, assign) id< SKStoreProductViewControllerDelegate> delegate Discussion
Your application must set the delegate before presenting the store view controller.
Availability
- Available in iOS 6.0 and later.
Declared In
SKStoreProductViewContro
ller.h Instance Methods
loadProductWithParameter
s:completionBlock: Loads a new product screen to display.
- (void)loadProductWithParameters:( NSDictionary *) parameters completionBlock:(void (^)(BOOL result, NSError *error)) block Parameters
-
parameters
-
A dictionary describing the content you want the view controller to display. See
“Product Dictionary Keys.”
block
-
A block to be called when the product information has been loaded from the App Store. The completion block is called on the main thread and receives the following parameters:
-
result
-
YES
if the product information was successfully loaded, otherwise NO
.
error
-
If an error occurred, this object describes the error. If the product information was successfully loaded, this value is
nil
.
-
Discussion
In most cases, you should load the product information and then present the view controller. However, if you load new product information while the view controller is presented, the contents of the view controller are replaced after the new product data is loaded.
Availability
- Available in iOS 6.0 and later.
Declared In
SKStoreProductViewContro
ller.h Constants
Product Dictionary Keys
Keys supported in the product dictionary.
NSString * const SKStoreProductParameterI
TunesItemIdentifier; Constants
Next
Promoting Apps with Smart App Banners
Safari has a new Smart App Banner feature in iOS 6 and later that provides a standardized method of promoting apps on the App Store from a website, as shown in
Smart App Banners vastly improve users’ browsing experience compared to other promotional methods. As banners are implemented in iOS 6, they will provide a consistent look and feel across the web that users will come to recognize. Users will trust that tapping the banner will take them to the App Store and not a third-party advertisement. They will appreciate that banners are presented unobtrusively at the top of a webpage, instead of as a full-screen ad interrupting the web content. And with a large and prominent close button, a banner is easy for users to dismiss.
If the app is already installed on a user's device, the banner intelligently changes its action, and tapping the banner will simply open the app. If the user doesn’t have your app on his device, tapping on the banner will take him to the app’s entry in the App Store. When he returns to your website, a progress bar appears in the banner, indicating how much longer the download will take to complete. When the app finishes downloading, the View button changes to an Open button, and tapping the banner will open the app while preserving the user’s context from your website.
Smart App Banners automatically determine whether the app is supported on the user’s device. If the device loading the banner does not support your app, or if your app is not available in the user's location, the banner will not display.
Implementing a Smart App Banner on Your Website
To add a Smart App Banner to your website, include the following meta
<meta name="apple-itunes-app" content="app-id=myAppStoreID, affiliate-data=myAffiliateData, app-argument=myURL"> |
You can include three comma-separated parameters in the content
-
app-id: (Required.) Your app's unique identifier. To find your app ID from the
iTunes Link Maker, type the name of your app in the Search field, and select the appropriate country and media type. In the results, find your app and select iPhone App Link in the column on the right. Your app ID is the nine-digit number in between id
and ?mt
. -
affiliate-data: (Optional.) Your iTunes affiliate string, if you are an iTunes affiliate. If you are not, find out more about becoming an iTunes affiliate at
http://www.apple.com/itunes/affiliates/. -
app-argument: (Optional.) A URL that provides context to your native app. If you include this, and the user has your app installed, she can jump from your website to the corresponding position in your iOS app. Typically, it is beneficial to retain navigational context because:
-
If the user is deep within the navigational hierarchy of your website, you can pass the document’s entire URL, and then parse it in your app to reroute her to the correct location in your app.
-
If the user performs a search on your website, you can pass the query string so that she can seamlessly continue the search in your app without having to retype her query.
-
If the user is in the midst of creating content, you can pass the session ID to download the web session state in your app so she can nondestructively resume her work.
You can generate the
app-argument of each page dynamically with a server-side script. You can format it however you'd like, as long as it is a valid URL. -
Providing Navigational Context to Your App
In your app, implement the application:openURL:sourceApplication:annotation:
NSURL
The example in /profile
. If it does, then open the profile view controller and pass the profile ID number that is in the query string.
Listing 7-1
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation |
{ |
// in this example, the URL from which the user came is http://example.com/profile/?12345 |
// determine if the user was viewing a profile |
if ([[url path] isEqualToString:@"/profile"]) { |
// switch to profile view controller |
[self.tabBarController setSelectedViewControlle |
// pull the profile id number found in the query string |
NSString *profileID = [url query]; |
// pass profileID to profile view controller |
[profileViewController loadProfile:profileID]; |
} |
return YES; |
} |