jv9 / tapromotee

Objective-C library to cross promote iOS apps

TAPromotee

TAPromotee is a pod that allows you to show a cross promotion to a iOS app just by supplying its App Store id. It automatically fetches the info about the app using the iTunes API:

• App name
• App icon
• App price
• Screenshot
• Test

When the user taps the install button, the SKStoreProductViewController is presented.

Requirements

• iOS 7.0+
• iPhone
• Portrait orientation
• The iTunes API references the images via http so you have to disable ATS in your app. In your plist

    <key>NSAppTransportSecurity</key>
    <dict>
        <key>NSAllowsArbitraryLoads</key>
        <true/>
    </dict>

Install

TAPromotee is available through CocoaPods, to install it simply add the following line to your Podfile:

pod 'TAPromotee'

Usage

To run the example project run pod try TAPromotee or clone the repo.

Here's an example of how you should use TAPromotee.

#import "TAPromotee.h"

[TAPromotee showFromViewController:self 
                             appId:822702909 
                           caption:@"Sun clock in your pocket" 
                        completion:^(TAPromoteeUserAction userAction) {
    switch (userAction) {
        case TAPromoteeUserActionDidClose:
            // The user just closed the add
            NSLog(@"User did click close");
            break;
        case TAPromoteeUserActionDidInstall:
            // The user did click on the Install button so here you can for example disable the ad for the future
            NSLog(@"User did click install");
            break;
    }
}];
    

If you don't want to use the App Store screenshot as background, you can supply a custom background image

[TAPromotee showFromViewController:self
                             appId:937151343
                           caption:@"Your Battlefield soldier's companion"
                   backgroundImage:[UIImage imageNamed:@"sample-app-background"]
                        completion:^(TAPromoteeUserAction userAction) {
    switch (userAction) {
        case TAPromoteeUserActionDidClose:
            // The user just closed the add
            NSLog(@"User did click close");
            break;
        case TAPromoteeUserActionDidInstall:
            // The user did click on the Install button so here you can for example disable the ad for the future
            NSLog(@"User did click install");
            break;
    }
}];

Screens

Here is how it looks like

Author

Jan Chaloupecky @TexTwil

License

TAPromotee is available under the MIT license. See the LICENSE file for more info.

Changelog

See the release section