Getting Started With Appnext

Welcome to the Appnext developer hub. You'll find comprehensive guides and documentation to help you start working with Appnext as quickly as possible, as well as support if you get stuck. Let's jump right in!

Start Now!

Unity Plugin

Appnext Unity plugin

Download the Unity Plugin

You can download the Unity plugin from here.

Android Unity Integration

Requirements

  • Google Play Services (Location and Basement) are mandatory in order to use this plugin, please make sure to add them to your Unity project before you begin
  • The Appnext Unity3D PlugIn was tested on Unity version 5.3.5
  • The Appnext Unity3D PlugIn supports Android API 17+ when building for Android.
  • The Appnext Unity3D PlugIn requires internet access to pull ads information for your game.

The process of integrating Appnext is fairly straightforward and does not require heavy programming. The required steps for using Appnext in your applications are outlined below:

  • Add the files to your assets folder
  • Edit the AndroidManifest.xml File
  • Show the ad unit

Step 1: Import the Files to Your Assets Folder

Click on Assets> Import Package > Custom Package…
And select the downloaded appnextUnitySDK.unitypackage file.

Otherwise import all:

Step 2: Add Google Play Services to your Unity project

It is required to integrate the latest version of Google Play Services in your Unity project.
In case you do not wish to integrate all Google Play Services APIs, make sure to include the following APIs:

  • Google Actions, Base Client Library - Basement com.google.android.gms:play-services-basement:10.2.0
  • Google Location and Activity Recognition com.google.android.gms:play-services-location:10.2.0

You can find more information in this link.

Step 3: ProGuard (Optional)

Exclude Appnext from your proguard by using the line:

-keep class com.appnext.** { *; }
-dontwarn com.appnext.**

Important Note!

  • Each placement has a Placement ID. If you integrate multiple placements, you will need to use a different Placement ID for each.
  • The implementation should be tested on a device and not in a unity simulator.
  • Make sure to use Android Placement IDs in Android project and iOS Placement IDs in iOS project

iOS Unity Integration

Integrating Appnext with your iOS game or app

Requirements

  • The Appnext Unity3D PlugIn was tested on Unity version 5.3.5
  • The Appnext Unity3D PlugIn supports iOS 7.0 and higher when building for iOS.
  • The Appnext Unity3D PlugIn requires internet access to pull ads information for your game.

The process of integrating Appnext is fairly straightforward and does not require heavy programming. The required steps for using Appnext in your applications are outlined below:

  • Add the files to your assets folder
  • Edit the project settings and add frameworks
  • Show the ad unit

The actual code-level integration is described in the sections below. Should you have any problems integrating the product, log a ticket with us by emailing support@appnext.com.

Step 1: Import the Files to Your Assets Folder

Click on Assets> Import Package > Custom Package…
And select the downloaded appnextUnitySDK.unitypackage file.

Otherwise import all:

Step 2: Edit the project settings

In the iOS player settings make sure to check the Allow downloads over HTTP.

Step 3: Add additional Frameworks

After building the project for iOS, in the xcode project add additional system frameworks to your project:
These frameworks are required for the work of the SDK.
Click on your project in the ‘Project navigator’->’Build Phases’->’Link Binary With Libraries’->’+’ and add the following frameworks if not included already:

  • ‘QuartzCore.framework’
  • ‘Security.framework’
  • ‘CFNetwork.framework’
  • ‘AVFoundation.framework’
  • ‘SystemConfiguration.framework’
  • ‘MobileCoreServices.framework’
  • ‘CoreGraphics.framework’
  • ‘CoreMedia.framework’
  • ‘AdSupport.framework’
  • ‘UIKit.framework’
  • ‘Foundation.framework’
  • ‘CoreTelephony.framework’

Step 4: Add additional Linker flags

Add ‘-ObjC’ linker flag. Go to ‘Build Settings’->‘Other Linker Flags’ and add ‘-ObjC’ flag

Important Note

  • Each placement has a Placement ID. If you integrate multiple placements, you will need to use a different Placement ID for each.
  • The implementation should be tested on a device and not in a unity simulator.
  • Make sure to use Android Placement IDs in Android project and iOS Placement IDs in iOS project

What's Next

Integrate one of the following plugin's ad units

Interstitial
Rewarded and Fullscreen Video