|
|
| Line 1: |
Line 1: |
| | <br><img>http://ad4gamewiki.local/download/unity/androidUnity.png</img> | | <br><img>http://ad4gamewiki.local/download/unity/androidUnity.png</img> |
| − | = <font color='green'>Publishers</font> = | + | = <font color='green'>Android</font> = |
| − | == <font color='#2D95DB'>Download iOS SDK</font> == | + | === <font color='#2D95DB'>Publishers</font> === |
| − | Download the [[http://ad4gamewiki.local/download/iOS/Pub_IOS_SDK_2.0.zip iOS SDK for publishers]]. Decompress the zip file and extract the files to your development mac.
| + | |
| − | <br>The Ad4game iOS SDK is provided as a single framework file ('''A4GPub.framework'''), making it easy to include in your iOS project.
| + | |
| − | == <font color='#2D95DB'>Include the A4GPub.framework</font> == | + | |
| − | To include the A4GPub.framework to your xcode project, you need to select your target project, and then go to '''Build Phases → Link Binary With Libraries''',
| + | |
| − | <br>then click on the '''+''' sign → '''Add Other''', and select the A4GPub.framework saved on your mac as shown below:
| + | |
| − | <br><img>http://ad4gamewiki.local/download/unity/androidUnity.png</img>
| + | |
| − | | + | |
| − | == <font color='#2D95DB'>Include the AdSupport.framework</font> == | + | |
| − | You need to include the '''AdSupport.framework''' to your project target to enable the Advertiser Identifier functionality.
| + | |
| − | <br>Go to '''Build Phases → Link Binary With Libraries''', then click on the '''+''' sign to add the AdSupport.framework as shown below:
| + | |
| − | <br><img>http://ad4gamewiki.local/download/iOS/AdSupport.png</img>
| + | |
| − | <br>Then, change the value of AdSupport.framework from Required to '''Optional'''.
| + | |
| − | | + | |
| − | == <font color='#2D95DB'>Include the SystemConfiguration.framework</font> ==
| + | |
| − | You need to include the '''SystemConfiguration.framework''' to your project target to enable detection of the connection type.
| + | |
| − | Go to '''Build Phases → Link Binary With Libraries''', then click on the '''+''' sign to add the SystemConfiguration.framework.
| + | |
| − | | + | |
| − | == <font color='#2D95DB'>Include the QuartzCore.framework</font> ==
| + | |
| − | You need to include the '''QuartzCore.framework''' to your project target to customize the interface.
| + | |
| − | <br>Go to '''Build Phases → Link Binary With Libraries''', then click on the '''+''' sign to add the QuartzCore.framework.
| + | |
| − | | + | |
| − | == <font color='#2D95DB'>Display Mobile Ads</font> ==
| + | |
| − | To display ads on your iOS project, you need to follow the steps bellow:
| + | |
| − | <br>In your '''ViewController.xib'''
| + | |
| − | <br>– You need to add an '''UIImageView''' with the size of the ad.
| + | |
| − | <br>– You need to add an '''UIButton''' above the UIImageView with the same size of the ad.
| + | |
| − | <br>Connect the UIImageView and the UIButton to your ViewController.h file.
| + | |
| − | <br><br>In your '''ViewController.h''' file
| + | |
| − | <br>– You need to import the A4GPub.framework.
| + | |
| − | <br>– Declare an Object of A4GPubViewController.
| + | |
| − | <br>Your code need to be similar to this:
| + | |
| − | <dd><font color='brown'>#import</font> <font color='red'><A4GPub/A4GPubViewController.h></font>
| + | |
| − | <font color='magenta'>@interface</font> TestViewController : <font color='#9A2EFE'>UIViewController</font> {
| + | |
| − | <font color='magenta'>IBOutlet</font> <font color='magenta'>UIImageView</font> *image;
| + | |
| − | <font color='#9A2EFE'>A4GPubViewController</font> *a4g;
| + | |
| − | }
| + | |
| − | - (<font color='magenta'>IBAction</font>)button : (<font color='magenta'>id</font>)sender;
| + | |
| − | <font color='magenta'>@end</font>
| + | |
| − | In your '''ViewController.m''' file
| + | |
| − | <br>– You need to import the A4GPub.framework.
| + | |
| − | <br>– In your '''viewDidLoad''' method, you need to instantiate the object created on viewController.h file and call the different method to display ads.
| + | |
| − | <br>The methods are:
| + | |
| − | <br>'''* setZoneID''' method allows you to set the zoneID.
| + | |
| − | <br>'''* setImageView''' method allows you to set your UIImageView.
| + | |
| − | <br>'''* getRefresh''' method to refresh the display of banners.
| + | |
| − | <br>'''* loadAds''' method to get banners from ad4game servers.
| + | |
| − | <br><br>Your code need to be similar to this:
| + | |
| − | <dd><font color='magenta'>#import</font> <font color='red'><A4GPub/A4GPubViewController.h></font>
| + | |
| − | <font color='magenta'>@implementation</font> TestViewController
| + | |
| − | –
| + | |
| − | (<font color='magenta'>void</font>)viewDidLoad
| + | |
| − | {
| + | |
| − | [<font color='magenta'>super</font> <font color='#9A2EFE'>viewDidLoad</font>];
| + | |
| − | <font color='green'>a4g</font> = [[<font color='#9A2EFE'>A4GPubViewController</font> alloc] init];
| + | |
| − | [<font color='green'>a4g</font> <font color='#9A2EFE'>setZoneID</font> : @"yourZoneID"];
| + | |
| − | [<font color='green'>a4g</font> <font color='#9A2EFE'>setImageView</font> : yourUIImageView]; <font color='green'>//in this example, its name is image</font>
| + | |
| − | [<font color='green'>a4g</font> <font color='#9A2EFE'>getRefresh</font>];
| + | |
| − | [<font color='green'>a4g</font> <font color='#9A2EFE'>loadAds</font>];
| + | |
| − | }
| + | |
| − | – In your '''(IBAction)button : (id)sender''' method, you need to call the '''loadClick''' method allowing you to get the click associate to the ad displayed.
| + | |
| − | <dd>– (<font color='magenta'>IBAction</font>)button : (<font color='magenta'>id</font>)sender
| + | |
| − | {
| + | |
| − | [<font color='green'>a4g</font> <font color='#9A2EFE'>loadClick</font>];
| + | |
| − | }
| + | |
| − | | + | |
| − | <dd><font color='red'>'''Note:'''</font> You can add many zones as you want, just instantiate the A4GPubViewController object as follow :
| + | |
| − | | + | |
| − | In your '''ViewController.h''' :
| + | |
| − | <dd><font color='brown'>#import</font> <font color='red'><A4GPub/A4GPubViewController.h></font>
| + | |
| − | <font color='magenta'>@interface</font> TestViewController : <font color='#9A2EFE'>UIViewController</font> {
| + | |
| − | <font color='magenta'>IBOutlet</font> <font color='#9A2EFE'>UIImageView</font> *imageOne;
| + | |
| − | <font color='magenta'>IBOutlet</font> <font color='#9A2EFE'>UIImageView</font> *imagetwo;
| + | |
| − | <font color='#9A2EFE'>A4GPubViewController</font> *a4gObject;
| + | |
| − | <font color='#9A2EFE'>A4GPubViewController</font> *secondObject;
| + | |
| − | }
| + | |
| − | – (<font color='magenta'>IBAction</font>)buttonOne : (<font color='magenta'>id</font>)sender;
| + | |
| − | – (<font color='magenta'>IBAction</font>)buttonTwo : (<font color='magenta'>id</font>)sender;
| + | |
| − | <font color='magenta'>@end</font>
| + | |
| − | | + | |
| − | In your '''ViewController.m''' :
| + | |
| − | <dd><font color='brown'>#import</font> <font color='red'><A4GPub/A4GPubViewController.h></font>
| + | |
| − | <font color='magenta'>@implementation</font> TestViewController
| + | |
| − | -(<font color='magenta'>void</font>)viewDidLoad
| + | |
| − | {
| + | |
| − | [<font color='magenta'>super</font> <font color='#9A2EFE'>viewDidLoad</font>];
| + | |
| − | <font color='green'>a4gObject</font> = [[<font color='#9A2EFE'>A4GPubViewController</font> alloc] init];
| + | |
| − | <font color='green'>secondObject</font> = [[<font color='#9A2EFE'>A4GPubViewController</font> alloc] init];
| + | |
| − | [<font color='green'>a4gObject</font> <font color='#9A2EFE'>setZoneID</font> : @"FirstZoneID"];
| + | |
| − | [<font color='green'>a4gObject</font> <font color='#9A2EFE'>setImageView</font> : yourUIImageView];
| + | |
| − | [<font color='green'>a4gObject</font> <font color='#9A2EFE'>getRefresh</font>];
| + | |
| − | [<font color='green'>a4gObject</font> <font color='#9A2EFE'>loadAds</font>];
| + | |
| − | [<font color='green'>secondObject</font> <font color='#9A2EFE'>setZoneID</font> : @"SecondZoneID"];
| + | |
| − | [<font color='green'>secondObject</font> <font color='#9A2EFE'>setImageView</font> : yourUIImageView];
| + | |
| − | [<font color='green'>secondObject</font> <font color='#9A2EFE'>getRefresh</font>];
| + | |
| − | [<font color='green'>secondObject</font> <font color='#9A2EFE'>loadAds</font>];
| + | |
| − | }
| + | |
| − | – (<font color='magenta'>IBAction</font>)buttonOne : (<font color='magenta'>id</font>)sender
| + | |
| − | {
| + | |
| − | [<font color='green'>a4gObject</font> <font color='#9A2EFE'>loadClick</font>];
| + | |
| − | }
| + | |
| − | – (<font color='magenta'>IBAction</font>)buttonTwo : (<font color='magenta'>id</font>)sender
| + | |
| − | {
| + | |
| − | [<font color='green'>secondObject</font> <font color='#9A2EFE'>loadClick</font>];
| + | |
| − | }
| + | |
| − | == <font color='#2D95DB'>Display iOS Editorials</font> ==
| + | |
| − | To display iOS Editorials on your iOS project, you need to follow the steps bellow:
| + | |
| − | <br><br>In your '''ViewController.xib'''
| + | |
| − | <br>You need to add a '''UIButton''' if you want to launch the editorials when the user clicks on that button.
| + | |
| − | <br>Connect the UIButton to your ViewController.h file.
| + | |
| − | <br><br>In your '''ViewController.h''' file
| + | |
| − | <br>– You need to import the '''A4GEdito.h''' header file.
| + | |
| − | <br>– Declare an Object of A4GEdito.
| + | |
| − | <br>Your code need to be similar to this:
| + | |
| − | <dd><font color='brown'>#import</font> <font color='red'><A4GPub/A4GEdito.h></font>
| + | |
| − | <font color='magenta'>@interface</font> TestViewController : <font color='#9A2EFE'>UIViewController</font> {
| + | |
| − | <font color='magenta'>IBOutlet</font> <font color='#9A2EFE'>UIButton</font> *editoButton;
| + | |
| − | <font color='#9A2EFE'>A4GEdito</font> *a4gEdito;
| + | |
| − | }
| + | |
| − | <font color='magenta'>@end</font>
| + | |
| − | | + | |
| − | In your '''ViewController.m''' file
| + | |
| − | <br>– In your '''viewDidLoad''' method, you need to instantiate the object created on your ViewController.h file and call the different method to display Editorials.
| + | |
| − | <br>The methods are:
| + | |
| − | <br>'''* setZoneID''' method, allows you to set the zoneID.
| + | |
| − | <br>* '''setButton''' method, allows you to set your UIButton.
| + | |
| − | <br>'''* showA4GEditos''' method, to display directly the Editorials when the app started.
| + | |
| − | <br>'''* showA4GEditosWithStartTime''' method, to display the Editorials after a certain time.
| + | |
| − | <br>'''* showA4GEditosWithStartAndEndTime''' method, to display the Editorials after a certain time, and close them automatically after a certain time.
| + | |
| − | <br><br>Your code need to be similar to this:
| + | |
| − | | + | |
| − | <dd><font color='magenta'>@implementation</font> TestViewController
| + | |
| − | –(<font color='magenta'>void</font>)viewDidLoad
| + | |
| − | {
| + | |
| − | [<font color='magenta'>super</font> <font color='#9A2EFE'>viewDidLoad</font>];
| + | |
| − | <font color='green'>a4gEdito</font> = [[<font color='#9A2EFE'>A4GEdito</font> alloc] init];
| + | |
| − | [<font color='green'>a4gEdito</font> <font color='#9A2EFE'>setZoneID</font> : @"yourZoneID"];
| + | |
| − | [<font color='green'>a4gEdito</font> <font color='#9A2EFE'>setButton</font> : yourUIButton]; <font color='green'>//in this example, its name is editoButton</font>.
| + | |
| − | [[<font color='green'>a4gEdito</font> <font color='#9A2EFE'>getButton</font>] <font color='#9A2EFE'>addTarget</font> : <font color='green'>a4gEdito</font> <font color='#9A2EFE'>action</font> : <font color='red'>@selector</font>(<font color='#9A2EFE'>showA4GEditos</font>) <font color='#9A2EFE'>forControlEvents:UIControlEventTouchUpInside</font>];
| + | |
| − | <font color='green'> //this line add “showA4GEditos” action to your UIButton</font>.
| + | |
| − | [<font color='green'>a4gEdito</font> <font color='#9A2EFE'>showA4GEditos</font>]; <font color='green'>//Display Editorials directly when the app started</font>.
| + | |
| − | [<font color='green'>a4gEdito</font> <font color='#9A2EFE'>showA4GEditosWithStartTime</font>:<font color='blue'>15</font>]; <font color='green'>//Display Editorials after 15 seconds</font>.
| + | |
| − | [<font color='green'>a4gEdito</font> <font color='#9A2EFE'>showA4GEditosWithStartAndEndTime</font> : <font color='blue'>10</font> <font color='#9A2EFE'>withArg2</font> : <font color='blue'>30</font>]; <font color='green'>//Display Editorials after 10 seconds and close it automatically after 30 seconds</font>.
| + | |
| − | }
| + | |
| − | | + | |
| − | = <font color='green'>Advertisers</font> =
| + | |
| − | == <font color='#2D95DB'>Download iOS SDK</font> ==
| + | |
| − | Download the [[http://ad4gamewiki.local/download/iOS/Track_IOS_SDK_1.0.zip iOS SDK for advertisers]]. Decompress the zip file and extract the files to your development mac.
| + | |
| − | <br>The Ad4game iOS SDK is provided as a single framework file ('''A4GTrack.framework'''), making it easy to include in your iOS project.
| + | |
| − | == <font color='#2D95DB'>Include the A4GTrack.framework</font> ==
| + | |
| − | To include the A4GTrack.framework to your xcode project, you need to select your target project, and then go to '''Build Phases → Link Binary With Libraries''', then
| + | |
| − | click on the '''+''' sign '''→ Add Other''', and select the A4GTrack.framework saved on your mac as shown below:
| + | |
| − | <br><img>http://ad4gamewiki.local/download/iOS/A4GFramework.png</img>
| + | |
| − | == <font color='#2D95DB'>Include the AdSupport.framework</font> ==
| + | |
| − | You need to include the AdSupport.framework to your project target to enable the Advertiser Identifier functionality.
| + | |
| − | <br>Go to '''Build Phases → Link Binary With Libraries''', then click on the '''+''' sign to add the AdSupport.framework as shown below:
| + | |
| − | <br><img>http://ad4gamewiki.local/download/iOS/AdSupport.png</img>
| + | |
| − | <br>Then, change the value of AdSupport.framework from Required to '''Optional'''.
| + | |
| − | == <font color='#2D95DB'>Include the SystemConfiguration.framework</font> ==
| + | |
| − | You need to include the '''SystemConfiguration.framework''' to your project target to enable detection of the internet availability.
| + | |
| − | <br>Go to '''Build Phases → Link Binary With Libraries''', then click on the '''+''' sign to add the SystemConfiguration.framework.
| + | |
| − | == <font color='#2D95DB'>Tracking installations</font> ==
| + | |
| − | In your '''appDelegate.m''', you need to import the '''A4GTrack.framework'''
| + | |
| − | <br><font color='brown'>#import</font> <font color='brown'><A4GTrack/A4GTrackViewController.h></font>
| + | |
| − | <br>In your '''didFinishLaunchingWithOptions''' method, you need to call the '''trackInstall''' method thatallow you tracking installations once per user.
| + | |
| − | <br>[ <font color='#9A2EFE'>A4GTrackViewController</font> <font color='blue'>trackInstall</font>:<font color='red'>@"yourTrackerID"</font>].
| + | |
| | = <font color='#2D95DB'>Contact</font> = | | = <font color='#2D95DB'>Contact</font> = |
| | | | |
| | If you've got questions, we've got answers! | | If you've got questions, we've got answers! |
| | Please Contact Us at <font color='blue'>tech@ad4game.com</font> with any technical queries. | | Please Contact Us at <font color='blue'>tech@ad4game.com</font> with any technical queries. |
