Posts by: GetAdRotator

The ultimate AdRotating solution for your Apps and Games, with an entire powerhouse of new features coming in V2

AdRotator 2.1 release – Universal support is a go

AdRotator Universal support with Version 2.1

AdRotator adds support for Universal apps

AdRotator adds support for Universal apps

A couple of days ago we pushed up a new version of AdRotator to Nuget, this new 2.1 release (thanks to our awesome new team member Rob Irving) adds the much anticipated Universal app support, this now means that AdRotator supports:

  • Windows Phone 7

  • Windows Phone 8

  • Windows Phone 8.1

  • Windows 8

  • Windows 8.1

  • Windows Universal apps

So yet again we support the full range of Microsoft’s offerings (not including the XBOX again yet sadly)

Granted this is still using only the native controls provided from each of the Ad Networks we support, but we are working diligently on migrating the WepAPI from V1 but bigger, brighter and better!

Also now that Rob has Joined us, he’s also looking in to full Xamarin / Xamarin forms support.

No timeline as yet for these new features as we all only do this in our spare time but we’ll keep you notified.

There were a few other bugfixes included as well to keep things moving along but no other big features, check the release notes for more info.

Unity Support

We have also just updated our Unity plugin to support the new 2.1 release and add 8.1/Universal support to your Unity games.

Note, we were recently told of a limitation in the Unity plugin that means the control HAS to be on your 1st scene, this is so it can register properly with the native platform.  We are now looking in to ways to remove this dependency as we understand this isn’t favourable for some projects.  For now, if you don’t want to display ads in your first scene, just disable the control at start-up and enable it later.

We will continue to support and grow out Unity support and if you have any suggestions or things you want to work differently, then either log an issue on our GitHub page or on the VoteIt backlog page 😀

The updated Unity asset can be found here on our GitHub releases page

The only thing of note with Unity’s Universal app support is that it puts BOTH the App.XAML and MainPage.XAML in the shared project, however for Ads to work you do need project specific configuration, so just copy these to each of the universal projects and remove them from the shared project before implementing the control and providers.

Welcome Rob Irving

Rob Irving – New AdRotator member

(Rob’ll probably kill me for this)

I’d like to introduce Rob Irving our new full fledge member of the AdRotator team, If you want to know more details about him, check out his site here:

http://robwirving.com/

We’d like to say a big thank you for the addition of the Universal support, allowing us to support it a lot sooner than we would have.

Thanks Rob! And welcome aboard.

AdRotator V2.0.1 release plus updated Unity editor plugin

We’re back baby

ID-100185850

It’s been a while since we were able to dedicate any serious time to the project, we can only apologise for that but both Gergely’s and my time is short these days, still we do what we can.  Issues are always answered, comments and feedback are always responded to and if you pester us on twitter we usually retort with some witty comment (well mostly me since I’m British)

But anyway, here we are today and finally some action.

AdRotator V2.0.1 release

It’s all Unity’s fault but it did give me a kick to update AdRotator with a few things.  The major stuff was to resolve some issues that arose with our old Unity plugin and what Unity changed that stopped it working, however we didn’t stop there.

Here’s a summary of what has been updated:

Ad Order (AdOrder) is now works

Due to popular demand we have now given you even greater control over how your ads are served in your app or game, there are three modes:

  • Random
    Exactly as before, random selection of ads based on the Probability you provide per provider
  • Ordered (new)
    Will use a fixed order for your ads, it will continue to display ads for your first Ad Provider until it is unable to do so, then it falls back to your second provider and so on.  Guarantee’s that you always push your most profitable provider first.  Mixed with the region / culture setting, this gives you maximum control.  Just set the AdOrder property in your configuration xml for each provider.
  • Stepped (new)
    Like the Ordered mode, it uses the AdOrder property on your ad providers to walk through in order, the main difference is that it will get an Ad from Provider 1, then move straight on to provider 2 until it loops back to 1.  Should be very useful with your own house Ads.

To use this new mode, simply decorate your Ad Providers with the new AdOrder property (as shown below) from 1 onwards (AdOrder of 0 means do not include, same as not setting AdOrder)

<AdDuplex AppId="xxxx" Probability="10" AdOrder="1"/>

 

With your config XML updated you simple need to set the AdRetrievalMode property of the AdRotator control, either in XAML or in code. (also settable in Unity)

Sliding Ads now start off screen

A minor tweak that was requested on the Vote it forums.  Now when your app / game starts using the Sliding Ad option, the Ad will both start and refresh off screen.  Ads will then start sliding in and our based on your timing settings.

A few minor bug fixes and tweaks

Nothing of too much note, just some performance tweaks and simple bug fixes.

Unity Plugin works again!

The root cause for the 2.0.1 update was Unity.  In testing we found that our plugin we developed had stopped working.  This didn’t stop you using AdRotator in your Unity projects for Windows Phone and Windows 8, but it did mean you lost some control in Unity to access / deploy it.

Now it’s back and working and can be found here: http://bit.ly/UnityAdRotator

Using the plugin is very simple:

  1. In your Unity project, import the custom asset via (Assets -> Import Package -> Custom Package)
  2. Select the plugin you downloaded from the above link and select OK to the information window.
  3. Open the scene you want to add Ads to and create a new AdRotatorManagement component using the Create menu
  4. Select the AdRotatorManagement entity in your scene (there can be only one) and you will see the following in the inspector:
    AdRotatorUnity
  5. Configure the placement and ad settings as you wish.  Note you can enter the remote URL for the configuration file here.
  6. Edit the default configuration file xml’s located in the AdRotator folder (defaultAdSettingsWin8.xml for Windows 8 and defaultAdSettingsWP8.xml for Windows Phone), these are your default start up config
  7. Save your scene / project
  8. Build your project for Windows 8 / Windows Phone
  9. Open up the exported project in visual studio
  10. Right click on the References folder in your project and select the Manage NuGet packages option (welcome to NuGet if you’ve never seen it)
  11. Search for AdRotator in the top right hand box and click install on the AdRotator item when it’s found (check you have Stable builds selected and you are searching from NuGet.org if you don’t find it)
  12. You will see a license window popup, this is just for some Opensource Microsoft libraries we depend on, click yes/ok when you are ready. (if you select no, then you can’t use AdRotator)
  13. Install any additional Ad Providers you need, either by downloading their SDK, or through NuGet (AdDuplex (win 8 and WP8) and Inneractive (wp8 only) are on NuGet as well)
  14. Run your project!

It may sound like a lot but it only takes a few mins.

Note: if you are installing on Windows 8, there is an extra step to reference certain providers in your App.XAML.cs, check the read-me that opens when you install NuGet for more details

Now AdRotator will run and be controlled from Unity.  If you prefer you can always do it manually (everyone has a preference)

End of the show show

That’s all for now, any comments / questions or queries, just post them on the GitHub site as per normal https://github.com/Adrotator/AdrotatorV2 (Feel free to contribute too)

If you have any comments, suggestions then drop them in to the VoteIt page http://www.voteit.com/v/HiHC8jq1MV8wxEW

And as a last call, if you like, use and make money using AdRotator, please think of us and if you can donate to the project.  Completely optional of course.

Bye Bye and back to work.

Enter AdRotator V2


AdRotator is a premium advertising solution that is able to integrate with several Ad Providers for windows platforms, take the Ads for those providers and then rotate or flip through them in a controlled and configured way. It also provides a fall back capability where if any Ad Provider fails to deliver an ad, it will intelligently move on to the next, ensuring that the app or game is always displaying ads.

What really makes AdRotator stand out is that it’s configuration can also be hosted externally to the app on a website or hosting area so that it can be updated without rebuilding or redistributing your application, you can change the ad configuration to match the best paying advertisers at any time and all apps will then be updated to use the new configuration on next use. (A by-product of this, is that you can also use this facility to deliver messages / notices to your apps and keep users informed)

AdRotator primarily targets the major Windows platforms including Windows Phone (7 & 8) and Windows 8, however there are plans to incorporate web based solutions through WinJS and Mono support.

With the release of the V2 solution for AdRotator we have now achieved parity with the aging V1 solution. This also brings several key improvements over V1 including:

* Multiple Ad Unit support from the same Ad Supplier (previously you could only support a single AdUnit per provider)

[Ad Units are individual ad configurations for Ad Providers which usually target ages, cultures, market segments, etc. These need to be monitored as different Ad Units have different payouts]

* Reduced dependency on provider DLL’s (previously you had to have all Ad Providers controls in your solution, now you ned only those you use)
* Improvements in the Ad Selection logic and probability (now 20x more random J)
* Many internal improvements to improve performance and scalability

There are many more features which can be discovered on the AdRotator site (http://getadrotator.com) or the GitHub Site (https://github.com/Adrotator/AdrotatorV2)
Additionally, if you want to see the roadmap or request future features, then check out the VoteIt page for AdRotator – http://www.voteit.com/v/HiHC8jq1MV8wxEW

Find the example app for this article here on Dropbox: https://db.tt/2FCgAjCh

 

What Ad Providers does AdRotator support?

AdRotator has always supported a core set of Ad Providers but we are always willing to increase and add more providers with sufficient interest. We do our best to include as many as possible on all platforms (provided the Ad Providers support those platforms)

Currently, AdRotator supports the following AdProviders:

* Microsoft PubCenter
* AdDuplex
* Smaato
* Google AdMob (Windows Phone 8 only)
* MobFox (windows Phone 7 only)
* Inneractive (formally Nokia Ad-Exchange)
* Inmobi
* House Ads

(Platform support is only limited by Ad Provider SDK’s and their supported platforms)

Have a provider you would like to see supported, then check the VoteIt page (http://www.voteit.com/v/HiHC8jq1MV8wxEW) and submit it as a suggestion.

Configuring AdRotator

Part of the power of AdRotator is the configuration file that controls its operation and what ads to display and when, this configuration gives you several levels of configuration:

* Target specific Ad Providers
* Target specific cultures / regions
* Define a probability or order that Ad Providers are displayed
* Deliver individual AdUnits or multiples per provider
* Host your own ads both online and offline

For example here’s a basic multi-cultural configuration file for AdRotator:

<?xml version="1.0" encoding="utf-8"?>
<AdSettings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
 <CultureDescriptors CultureName="en-us">
 <AdDuplex AppId="<ID>" Probability="10"/>
 <PubCenter AppId="<publisherID>" SecondaryId="<AdUnitID>" Probability="80"/>
 <Inmobi AppId="<ID>" Probability="10"/>
 </CultureDescriptors>
 <CultureDescriptors CultureName="fr-fr">
 <AdDuplex AppId="<ID>" Probability="10"/>
 <PubCenter AppId="<publisherID>" SecondaryId="<AdUnitID>" Probability="30"/>
 <Inmobi AppId="<ID>" Probability="60"/>
 </CultureDescriptors>
 <CultureDescriptors CultureName="">
 <AdDuplex AppId="<ID>" Probability="33"/>
 <PubCenter AppId="<publisherID>" SecondaryId="<AdUnitID>" Probability="33"/>
 <Inmobi AppId="<ID>" Probability="33"/>
 </CultureDescriptors>
</AdSettings>

Breaking down this configuration we can see:

Provider sections

<AdDuplex AppId="" Probability="10"/>

 

Each provider has its own configuration block which you can have within a culture block as many times as you wish. In here you configure the ID’s required for that provider to deliver ads (most have only one ID, some have multiple, like PubCentre). You can also then set a probability that AdRotator will pick that provider to display its ads, the higher the probability, the more likely it will try and display an ad from that provider. (setting a probability of 0 or no probability means that ad won’t be displayed)

Culture Settings

<CultureDescriptors CultureName="">

 

These blocks allow you to target several cultures / regions within a single configuration file. This uses the devices native culture to determine which configuration to use for that region.

AdProviders all have their own home regions (PubCentre – US, Smaato – central Europe) where they have a higher likelihood of delivering ads to your customers

[Note, AdProviders won’t deliver ads if they do not have any suitable ads for your demographic, region or culture. Ad delivery is never guaranteed]

By providing different sections you can selectively configure each provider differently, using either different priorities (probabilities) or even if you use that provider in that region. (Providers are optional, you don’t have to use all of your available providers for all cultures, only those that are likely to give you the most impressions and deliver the best pay-out rates

[Ad Providers pay different rates by market or type of Ad. Impressions are when an ad is delivered by the provider and displayed in your app, which gives a minimal pay-out. Clicks are also monitored by providers which offer higher pay-out rates for user clicks]

Additionally to specifying cultures, there is the default culture (as highlighted above) where no culture is provided. This is the fall back position if the region the users device is set to is not available in your configuration. However it is also just as valid to ship a configuration file with only the default culture. This simplifies your configuration but obviously won’t pay as well as customising it per culture.

 

Once you’ve configured your file you need to host it in your solution or make it available to AdRotator

Hosting configuration externally

One of the biggest features of AdRotator is that you can put your configuration file on an external site (even use the same config for all your apps) and AdRotator will attempt to load it on each launch. If for some reason it can’t it will used a cached version of your configuration until it can update it again.

[Even with hosted configuration, we also recommend deploying a default configuration file with your app, this ensures ads will start from day one even if it cannot contact your external web host for some reason]

Nothing special is required for the file hosting, so long as it is available from the internet and isn’t blocked by firewalls and such.

Several free solutions exist for hosting your file if you don’t have your own web server.

* Azure Websites (https://azure.microsoft.com/en-us/) – Azure offer 10 websites free under their basic free plan. Sign up, setup a basic page, upload your configuration file and you are good to go.
* AppHarbour (https://appharbor.com/) offer free hosting, it’s a bit more tricky to setup but you cannot argue with free.

 

Adding AdRotator to your solution

We’ve worked hard over the years to improve the installation of AdRotator and these day’s it’s easier than ever thanks to NuGet.

[If you are not aware of NuGet (where have you been?), then NuGet is a dependency manager able to install and manage external references and dll’s for your solution. It has a vast library of opensource libraries you can access, just check out http://NuGet.Org for more details. Also install the NuGet extension in to Visual Studio or MonoDevelop]

If you open your solution and then Right-Click on References in the Solution Explorer you should see the following dialog:

Clicking on the Manage NuGet Packages option will open the following NuGet package manager (I’ve highlighted some important bits):

Feel free to have a browse through the packages available if you wish. When you’re ready, enter AdRotator in to the search window in the top-right hand corner of the window, ensuring that Stable Only packages are selected in the drop down (NuGet also includes the ability to host dev / alpha / beta backages, to get in progress versions of dependencies). Once you search you should see AdRotator listed in the results. Looking on the right hand side you can see this is the Stable V2 release.

[AdRotator also uses some other dependencies from NuGet itself (Microsoft.bcl references which are portable extensions for .NET), when you see a license prompt appear, simply accept it to continue the installation. The Microsoft.BCL libs use a standard OpenSource license that is free to use.]

On clicking Install, NuGet will download the package and install it directly into your project, adding references and copying important files, including a sample “defaultAdSettings.xml” configuration file for you to modify or replace. Close the NuGet window and when you return to Visual Studio you will also see the implementation instructions for the AdRotator control, these instructions walk you through the rest of the journey to get up and running, here they are in short.

  1. Open the XAML page you want to display ad’s on
  2. Add the xmlns:adRotator=”clr-namespace:AdRotator;assembly=AdRotator” XAML using/namespace reference to the top of the XAML page, in line with the other XAML using/namespace references (note there are different examples for Windows Phone and Windows 8 because the using/namespace references are subtly different
  3. Add the following XAML code to the page where you want it displayed, which is an exampleimplementationfortheAdRotator control:
                <adrotator:AdRotatorControl 
                x:Name="MyAdRotator"
                AdHeight="90"
                AdWidth="728"
                LocalSettingsLocation="defaultAdSettings.xml"
                RemoteSettingsLocation="http://<Your Web Site>/defaultAdSettings.xml"
                AutoStartAds="True" />
  4. If you are hosting your configuration externally as well, replace the website reference in the RemoteSettingsLocation property, also you can rename your configuration file in your project if you wish, if you do so also update the LocalSettingsLocation property

    [If you wish you can also add the AdRotator control through the designer, we support whichever way you want to do it]

  5. Finally, return to the Solution Explorer and add references to all the AdProviders you wish to support. PubCenter is available direct from Visual Studio, AdDuplex and Inneractive are now available through NuGet. For other providers you’ll likely need to visit their websites and download their SDK’s

    [If an Ad Provider does not exist or is not referenced in your solution, then AdRotator will handle it by ignoring that Ad Providers configuration. Can’t use it if it doesn’t exist!]

And you are done. Just run the project and provided the Ad Dll’s are in place and the configuration in your config XML is correct, you should start seeing Ads in your page.

Special considerations for Ad Providers who use WinRT components

Now life would be simple if all providers were just DLL’s like they used to be, however that is not the world of today, now we also have WinRT components.

Because we cannot use standard techniques to discover WinRT components (COM is alive and breathing) we need to do a bit extra for AdRotator to be able to use them, just one line mind.

At present two providers we support have upgraded to use WinRT components, these are:

* Microsoft PubCenter (well, that makes sense)
* AdDuplex

When you use these providers, we need to pass the references for these WinRT components to AdRotator on startup, to do this we simple add an extra line to the Code behind (the .cs files) for the Pages you implement Adrotator on which looks like this:

MyAdRotator.PlatformAdProviderComponents.Add(AdRotator.Model.AdType.PubCenter, typeof(Microsoft.Advertising.Mobile.UI.AdControl));

 

The readme that comes with AdRotator gives you all the details and code for each provider that does this.

[Just check the namespace for the AdControl itself as some providers use different namespaces for different platforms]

 

Multi-page scenarios

A lot of people ask us questions about using AdRotator on multiple pages in their app or in several locations on a page. Now it’s fine to use several controls throughout your app but unless you are using different configurations then it is better to build a user control and then re-use that throughout your app. It is simply more efficient.

To set up AdRotator in a user control, simply:

  1. Create a new User control in your project
  2. Set it’s width and height to your desired ad placement size (this will largely depend on the size of ads you have configured with your Ad Provider)
  3. Repeat the instructions above within the user control.
  4. Save and close it.
  5. Now just Add the user control to each page you wish to display ads on, e.g.
Using: Consolas; color: red;"&gt;xmlns<span style="font-family: Consolas; color: blue;">:</span><span style="font-family: Consolas; color: red;">local</span><span style="font-family: Consolas; color: blue;">="clr-namespace:PhoneApp3"</span>
Control: &amp;lt;span style="font-family: Consolas; color: blue;"&amp;gt;&amp;lt;Consolas; color: #a31515;"&amp;gt;local&lt;span style="font-family: Consolas; color: blue;"&gt;:&lt;/span&gt;&lt;span style="font-family: Consolas; color: #a31515;"&gt;AdRotatorUserControl&lt;/span&gt;&lt;span style="font-family: Consolas; color: blue;"&gt;&nbsp;/&amp;gt;&lt;/span&gt;
This way is more efficient and also means you only need to update the User Control if you wish to change any of the AdRotator properties.

House Ad’s

Another very useful feature of AdRotator is that you can setup your very own Ads, in fact we’ve talked to some implementation that only do their own ads.

[In fact we know if at least one implementation where the developer uses AdRotator to sell ad space in their app, they just host the Ad remotely and rotate each ad in]

Implementing a House ad is very easy, in effect it is just another User control in your project.

  1. Create your UserControl Ad
  2. Note the full namespace identity of the user control (in the example app it is PhoneApp3.MyHouseAd.MyHouseAd1)
  3. Add a DefaultHouseAd entry in to your configuration xml, for example:
<DefaultHouseAd SecondaryId="PhoneApp3.MyHouseAd.MyHouseAd1" Probability="90"/>

[The probability setting is completely optional, if you set a probability it will be included in the ad rotation, if you do not set a probability, then it will only be shown if no other ads could be fetched (fallback)]

If you wish to also then place the HouseAd online, they you just need to host it online and then add the Url to the AppID property for the DefaultHouseAd, for example:

<DefaultHouseAd AppId="http://adrotator.apphb.com/SampleRemoteHouseAd.xaml" SecondaryId=" PhoneApp3.MyHouseAd.MyHouseAd1"/>
For an example online House Ad, check the one we include with our example projects here: <a title="AdRotator Sample remote house ad" href="http://adrotator.apphb.com/SampleRemoteHouseAd.xaml" target="_blank">http://adrotator.apphb.com/SampleRemoteHouseAd.xaml</a>

Unity support

At the time this blog was posted, our Unity editor integration is currently broken, something changed in Unity of late and it no longer works. We are working on it with some help from our community and as soon as it’s working again we’ll update the main site.

That’s NOT to say you cannot use AdRotator in Unity projects, it just means you need to follow the instructions above for adding AdRotator in to the exported Windows Phone or Windows 8 project manually (if you count 5 mins as manual)

 

So AdRotator still works, it is just our editor integration and build process that isn’t working, meaning you cannot just configure it from Unity itself.

We are working hard to remedy this with the time we have, so keep checking.

Onwards

This article has been a brief run through the setup of AdRotator. Ignoring the time it takes you to register on all the ad providers and work out the Ad configuration that works for you, you should be up and running in 5 mins.

There are more features currently in the framework and many more planned for the more advanced edge cases for Ad Configuration and rotation, so feel free to check out the voting page for what people are asking for.

If you have any suggestions / improvements or other AdProviders you want us to support, then add it to our Voting page for AdRotator users here: http://www.voteit.com/v/HiHC8jq1MV8wxEW

If you have any issues or want to get in touch, then log an issue on the GitHub site and either we or one of our growing community will be there to help you: https://github.com/Adrotator/AdrotatorV2/issues

 

Finally, if you are so inclined and want to get involved with this amazing project, then put your hand up, race out and let us know. Were always willing to encourage developers to join in, fork our repo and send us some interesting code!

Here’s hoping you found this little write up useful and happy implementing.

Find the example app for this article here on Dropbox: https://db.tt/2FCgAjCh

AdRotator V2 stable release published

With much trepidation, we are pleased to announce that The V2 branch of AdRotator with all it’s under the hood improvements has now been fully released.

This release brings a host of improvements developed in the beta and we have now reached feature parity with the original V1 XAML release.

We have achieved a lot in the V2 timeline, breaking a lot of the shackles from the V1 branch, including:

  • Removed the dependencies on AdProviders, now you can just use the one’s you want (loose coupling)
  • You can now have multiples of the same provider should you wish to make use of multiple ad units
  • Having multiples of the same providers now also lets you have multiples of house ads, market yourself..
  • A much more streamlined and robust error management and logging logic
  • The AdRotation logic is now improved (more to come on that with Ad Ordering and improved failover options)
  • And Much, Much more!

As ever we strive to improve the framework as much as possible, so we welcome you to add your say in the Feature request page and cast your votes on existing suggestions to help us focus our efforts.

http://www.voteit.com/v/HiHC8jq1MV8wxEW

 

Now this latest release is not without some sorrow, it seems that Unity have changed a few things in their latest releases which has broken our Unity plug-in.  AdRotator will still work with XAML projects as you can implement it natively on the platform but it’s not ideal.  So we will be working hard to restore this functionality next.

One of the biggest comments (issue maybe) has been our implementation documentations, currently it’s all stacked up on ne or two pages which seems to cause confusion.  SO we are also planning on a series of posts to address this documentation gap to cover some of the basic and more sophisticated implementation opions.  have an idea for a post? then put it on our feature request page and well answer you. (http://www.voteit.com/v/HiHC8jq1MV8wxEW)

SO on with the show.

 

One last thing, more of a nice kickback or something to think about.  We are working hard on AdRotator and constantly hear great feedback of the many implementations out there.

All we ask is that you help support us by spreading the word and if you are making good on your ads through the use of our framework, then maybe shoot us a bit of kickback though our Donate option on the homepage.

This is NOT mandatory, all we ask is that you think of use while you are kicking back on your yacht while your ad revenue streams in. It all goes to help fund further improvements in the framework.  Some very generous teams already have and we are always very appreciative of the additional support!

AdRotator V2 updated to Beta & release of the V2 Unity plug-in

*Note, with the release of AdRotator V2.0.1, we have updated the Unity install instructions!! – See here for more info

With a great fanfare and loud Harrumph, we are pleased to announce the first Beta of our new V2 AdRotating solution.

Lots of testing and fixes have gone into the beta and we have also now brought forward the sliding ad solution from V1 which works in exactly the same way it did before.

There are still a few outstanding things we are working that we will include in upcoming releases, such as Local house ad support.

 

In other news Gergely has started work on the WinJS version of AdRotator (now that a certain launch event has passed), so expect more news on that front.

 

Lastly Open-mouthed smile

Were proud to announce the release of our Unity3D plug-in for AdRotator.  This enables you to use our Windows and Windows Phone AdRotator solution in Unity3D projects for those platforms and configure how AdRotator works directly from the Unity editor.

Using this is simple and goes like this:

  • Download the Unity AdRotator asset from our codeplex site (We will look to publishing it on the Unity3D store at some later date)
  • Add the Asset package to your Unity3D project
  • In the scenes where you want AdRotator displayed, Ad the “AdRotatorManagement” manager game object to your scene (needs to be the top most item in the hierarchy), after installing the asset, this will appear in the game object create menu.
  • Use the inspector to configure how you want AdRotator to display in your scene.
  • Edit the AdRotator configuration files in the Assets / AdRotator folder (there is one for WinPhone and one for Win8 at the moment but we may unify that later) – Note don’t touch any of the other files
  • When your ready, deploy your game to a Windows 8 C#/XAML or Windows Phone 8 project (these are the only two supported options at the moment)
  • Lastly, open your generated solution and ad the V2 AdRotator beta to your project through NuGet and any other Ad Providers you wish to use.

And you’re done.

Many thanks to Jared Bienz and his crew over at Microsoft who made the initial release of the Unity plug-in possible!

**Note, check the readme that comes with the AdRotator NuGet package if you intend to use PubCentre, there is an additional step to pass the reference for PubCentre directly to AdRotator which will be needed.

 

Well have fun and enjoy the latest release and be sure to let us know how you get on.

 

As a closing note, we’ve been talking about putting a testimonials page on the site to get some feedback for how everyone is using adrotator, what your feelings are on the project and if possible your own advice on Ad Providers and monetisation.  Just something to help all devs using the platform make the most out of it that they can.  Hopefully everyone will learn something new from everyone else.

 

Laters

Simon (Darkside) Jackson

AdRotator team

 

P.S

AdRotator is now also listed on the Windows 8 Services store, thanks to some great help from Gabriel Valdez Malpartida on the Windows team – Our thanks Gabriel.

Updated V1 release – ready for beta

We’ve just completed a last overhaul of the V1 version of AdRotator.

There have been several improvements / fixes and updates.

The Beta will be available soon on NuGet once NuGet allows us to upload again (some unknown error they are looking into)

We’re just finishing up the release and will let you know how it goes.

XNA version is almost ready with a few more tweaks to go.

New Beta for AdRotator V1 integration for Unity3D

**Update

The Unity Asset plug in for AdRotator V2 is now live, for more details see here:

http://getadrotator.com/adrotator-v2-updated-to-beta-release-of-the-v2-unity-plug-in/


Right, Beta is now up and running on the dropbox link https://www.dropbox.com/sh/q7pyy5fjhcanik2/IrurGpdsqt

Working for Both Windows 8 C# XAML and Windows Phone
Be sure to read the instructions first 😀
Due to an error on NuGet I’ve been unable to upload the NuGet packages, so they have been included on the drop box and instructions for how to use them locally have been included.  Don’t use the one’s on NuGet itself or you will have issues (basically won’t work :D)
Let me know how you get on and if you have any issues.
This Phase of the beta is all about being able to implement and configure AdRotator from within Unity, you edit your config files in Unity (in the Assets\AdRotator folder) and all the integration and bridge will be packaged and shipped with the build. All that remains is to add AdRotator it’self to the compiled solution and the necessary Ad Providers (they are all included in the WP NuGet with the exception of PubCenter but have to be added manually with W8 – don’t ask why :S)
*Note, it’s highlighted in the docs but I’ll repeat it here, you need to all all ad providers to your solution whether you are using them or not due to the way V1 is architected.  This limitation was removed in V2 but this isn’t compatible with that yet.  We plan to work on a full Unity version for V2 in the future.

AdRotator V2 – Alpha 2 has been pushed to NuGet

“Time and Tide will tell” or so I’m told.

Strange words for a strange time, both Gergely and I have been mad busy the last few months with work and other projects so updates have been tricky.

That being said we just pushed up a patch release to the Alpha today to NuGet to resolve the following issues:

  • Added Size property for AdDuplex, hence why AdDuplex wasn’t getting it’s width and height set properly (whoops)
  • Renamed the container that AdRotator sits in from LayoutRoot to AdRotatorRoot to resolve some usage scenarios (may back fill this fix to V1 if there is time)
  • Added some work around code to handle the changes in PubCenter, they have switched from using events to using exceptions when no ad is available, not very friendly at all.  This is just a patch to stop AdRotator from crashing while we try and get it working properly again.

no much but what we could do given time, will update you again when we get some more meat on the bone

 

Later’s  😀

AdRotator V2 – Alpha 1 is out

Well it’s been a long time coming but we are really making progress on AdRotator V2.

So as of this week were announcing the first alpha release of AdRotator V2 which is available on NuGet for:

  • Windows Phone 7.1
  • Windows Phone 8
  • Windows 8

The package is available on NuGet now for you to play and tinker with, it’s stable enough to use in Live projects as far as our testing goes but that’s up to you.


What’s in the release?

Alpha 1 is our first fully stable build which uses the all new and enhanced XML configuration structure and support for all our existing Ad Providers plus 1 new one Inmobi (want more providers then get voting here!!)

The new Configuration XML

xml version="1.0" encoding="utf-8"?>

The new configuration XML breaks compatibility with the old version but for very good reasons, you can now:

  • Have as many instances of an Ad Provider as you wish (useful if you have multiple AdUnits with a provider)
  • More configuration options, almost every configuration option that was available before is available everywhere
  • AdGroup (coming soon), the configuration XML also now allows grouping of Ad Configuration, this will be useful if you want to set the order of provider checking yourself or have groups of House Ads and rotate through them as a group. It’s in the config but we don’t consume it as yet

UnBound Provider dependencies

One of the biggest headaches in V1 was that you had to have every ad provider registered in your project even if you weren’t using them, this was also a headache for us since we had to keep updating the NuGet package every time a provider dll was updated.

In V2 we have broken that dependency (in a good way), now:

  • You only need to have Ad Providers that you use registered
  • If you specify a provider in Configuration that you don’t have, it will be ignored

In the Nuget Package we now only include AdDuplex (since they are on NuGet anyway) by default and you can add as many of the others as you wish.

You can also have just one configuration for all platforms because even if a provider isn’t supported on that platform it will now just ignore it.

Full Async support

Getting on the async bandwagon, AdRotator now fully supports Async on all platforms.  This is a huge performance boon and simplifies how we manage the project.

All calls (inc web) are now offloaded and handled correctly coming back so fewer multi-threading issues and better performance (and no UI blocking issues either)


Yet more to come

Obviously we’re not stopping there, if you check the backlog we have more high priority items to include, such as:

  • Bringing over HouseAds and RemoteHouseAds
  • Compression support (reduce those web calls further)
  • WinJS and Javascript support
  • WebAPI support (similar to what we used for XNA)
  • More platforms
  • More providers
  • Much Much more
Want more? then get over to the voting page and have your say!

In the end this will the best AdRotator we can make it and with any luck you will be able to incorporate it just about anywhere (including on your website) 😀

Please direct any Comments or Queries to the AdRotator V2 codeplex site for all to see / discuss

 Scroll to top