Unity
Contents |
Android Unity
Publishers
Download Android SDK
Download the [Android SDKv2.0 publishers for Unity]. Decompress the zip file and extract the files to your development computer.
The Android SDK for Unity is provided as two frameworks files (AndroidSDKPublisher.jar et A4GPublisherUnity.jar), making it easy to include in your Android project.
Setup the Unity Project
Create a ‘Plugins’ folder and within this create another folder called ‘Android’ (Assets>Plugins>Android).
Copy the AndroidSDKPublisher.jar and the A4GPublisherUnity.jar into this folder.
Build the project for Android and then go into the ‘Temp\StagingArea’ folder with your project folder and copy the AndroidManifest.xml file into the ‘Android’ folder.
This manifest file now needs to be edited to look like this:
Display Mobile Ads
You will create a C# file that will attach to a Unity GameObject as a script. The C# file need to be under the Assets folder.
You'll then need to call the loadTopAds or loadBottomAds (you can call the both methods to display two ads (one on the top, and the other on the bottom of the
screen) methods in the Awake() function of an empty GameObject in your startup scene:
Now, go to File >Build Settings >Player Settings, and change the Bundle Identifier to com.a4gpublisherunity.
Build the Unity project for Android platform and run it on your device to see the ads.
Display Android Editorials
To display Android Editorials inside your unity project, you need to use one of the three methods (you can use all of them) bellow:
1- showA4GEditos : If you want to display the editorials once the activity's started.
2- showA4GEditosWithStartTime : If you want to display the editorials after certain time.
3- showA4GEditosWithStartAndEndTime : If you want to display the editorials after certain time and close them automatically after certain time.
4- showA4GEditosOnClick : If you want to display the editorials when the user click on a button.
valid from android 2.3 or above.
Advertisers
Download Android SDK
Download the [Android SDKv1.0 advertisers for Unity]. Decompress the zip file and extract the files to your development computer.
The Android SDK for Unity is provided as two frameworks files (AndroidSDKTracker.jar et A4GTrackerUnity.jar), making it easy to include in your Android project.
Setup the Unity Project
Create a ‘Plugins’ folder and within this create another folder called ‘Android’ (Assets>Plugins>Android).
Copy the AndroidSDKTracker.jar and the A4GTrackerUnity.jar into this folder.
Build the project for Android and then go into the ‘Temp\StagingArea’ folder with your project folder and copy the AndroidManifest.xml file into the ‘Android’ folder.
This manifest file now needs to be edited to look like this:
You will then create a C# file that will attach to a Unity GameObject as a script. The C# file need to be under the Assets folder.
You'll then need to call the loadTrack method in the Awake() function of an empty GameObject in your startup scene:
Now, go to File >Build Settings >Player Settings, and change the Bundle Identifier to com.a4gtrackerunity.
iOS Unity
Publishers
Download iOS SDK
Download the [iOS SDKv2.0 publishers for Unity]. Decompress the zip file and extract the files to your development computer.
The iOS SDK for Unity is provided as a single framework file (A4GPubUnity.framework), making it easy to include in your iOS project.
Include the A4GPubUnity.framework
Build your Unity project for iOS, then open the generated xcode project.
To include the A4GPubUnity.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 A4GPubUnity.framework saved on your computer.
Include the AdSupport.framework
You need to include the AdSupport.framework to your project target to enable the Advertiser Identifier functionality. Go to Build Phases → Link Binary With
Libraries, then click on the + sign to add the AdSupport.framework.
Then, change the value of AdSupport.framework from Required to Optional.
Include the SystemConfiguration.framework
You need to include the SystemConfiguration.framework to your project target to enable the detection of the connection type. Go to Build Phases → Link Binary With Libraries, then click on the + sign to add the SystemConfiguration.framework.
Display Mobile Ads
To display ads on your iOS project, you need to follow the steps bellow:
– You need to add this line into your appController.h file
@property (strong , nonatomic) UIWindow *window;
In your appController.mm file
– You need to import the A4GPubUnity.framework, after the last #import.
#import <A4GPubUnity/A4GPubUnityViewController.h>
– Go to startUnity method and do these steps :
– Instantiate the window declared inside appController.h file.
– Instantiate an object of A4GPubUnityViewController.
– Add a imageView and Button with the same size of the ad to display (the button need to be above the imageView and need to be transparent).
– call the different method to display ads. The methods are:
* setZoneID method allows you to set the zoneID.
* getRefresh method to refresh the display of banners.
* loadAds method to get banners from ad4game servers.
Your code need to be similar to this:
Display iOS Editorials
To display mobile Editorials on your iOS project developed by Unity, you need to follow the steps bellow:
– You need to add this line into your appController.h file
@property (strong , nonatomic) UIWindow *window;
In your appController.mm file
– You need to import the A4GPubUnity.framework, after the last #import.
#import <A4GPubUnity/A4GPubUnityViewController.h>
#import <A4GPubUnity/A4GEdito.h>
– Go to startUnity method and do these steps :
– Instantiate the window declared inside appController.h file.
– Instantiate an object of A4GEdito.
– You need to add a UIButton if you want to launch the editorials when the user clicks on that button.
– call the different method to display mobile Editorials. The methods are:
* setZoneID method allows you to set the zoneID.
* showA4GEditos method, to display directly the Editorials when the app started.
* showA4GEditosWithStartTime method, to display the Editorials after a certain time.
* showA4GEditosWithStartAndEndTime method, to display the Editorials after a certain time, and close them automatically after a certain time.
Your code need to be similar to this:
-(void) startUnity:(UIApplication*)application {
self.window = [[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]];
A4GEdito *a4gEdito = [[A4GEdito alloc]init];
[a4gEdito setZoneID:@"32593"]; // set ZoneID
UIButton *button = [UIButton buttonWithType:UIButtonTypeRoundedRect];
button.frame = CGRectMake(20, 20, 50, 50); // Create a button where x=20, y=20, width=50, height=50;
[button setTitle:@”Editorials” forState:UIControlStateNormal];
[button addTarget:a4gEdito action:@selector(showA4GEditos) forControlEvents:UIControlEventTouchUpInside];
[self.window addSubview:button];
[self.window makeKeyAndVisible];
[a4gEdito showA4GEditos]; // Show Editorials when the app started.
[a4gEdito showA4GEditosWithStartTime : 10]; // Show Editorials after 10 seconds.
[a4gEdito showA4GEditosWithStartAndEndTime : 10 withArg2 : 20]; // Show Editorials after 10 seconds and close it automatically after 20 seconds.
Advertisers
Download iOS SDK
Download the [iOS SDKv1.0 advertisers for Unity]. Decompress the zip file and extract the files to your development computer.
The iOS SDK for Unity is provided as a single framework file (A4GUnityTracker.framework), making it easy to include
in your iOS project.
Setup the Unity project
To integrate the Ad4game iOS plugin in your Unity app, you will be creating a C# file that will attach to a Unity GameObject as a script.
The C# file need to be under the Assets folder.
In the C# scripts, DllImport attribute needs to be set for the trackInstall method to be imported from the plugin code.
Remember that you need to add this line on the top of the C# file:
You'll then need to call the trackInstall function in the Awake() function of an empty GameObject in your startup scene:
Build the Unity project for iOS platform. Note that a new iOS Xcode project is generated.
Include the A4GUnityTracker.framework
Open the iOS project in Xcode.
To include the A4GUnityTracker.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 A4GUnityTracker.framework saved on your computer.
Include the AdSupport.framework
You need to include the AdSupport.framework to your project target to enable the Advertiser Identifier functionality.
Go to Build Phases → Link Binary With Libraries, then click on the + sign to add the AdSupport.framework.
Then, change the value of AdSupport.framework from Required to Optional.
Include the SystemConfiguration.framework
You need to include the SystemConfiguration.framework to your project target to enable detection of the internet availability.
Go to Build Phases → Link Binary With Libraries, then click on the + sign to add the SystemConfiguration.framework.
Contact
If you've got questions, we've got answers! Please Contact Us at tech@ad4game.com with any technical queries.
