• Docs
  • Releases
  • API Reference
  • Login
  • Languages iconEnglish
    • 日本語

›Tutorials

Getting Started

  • Admix Quickstart
  • How It Works
  • Register a Developer Account
  • Download the Plugin
  • Install the Unity Plugin
  • Updating Plugin Version

Admix Plugin

  • Adding Placements
  • Banner Placements
  • Video Placements
  • Placement Settings
  • Adding Shaders
  • Understanding Gaze Tracking
  • Plugin Settings
  • Projects management
  • Dynamically Generated Content
  • About AdmixLocalConfig file
  • Consent Management Platform
  • PlayerInfo popup
  • Graphics API requirements
  • Admix Obfuscation rules

Developer Platform

  • My Apps
  • OFF Mode
  • SANDBOX Mode
  • Going LIVE
  • Placements setup
  • App versions
  • Publish page
  • Reporting
  • Forecast page
  • User Profile
  • App-ads.txt

Optimization

  • Choosing Your Ad Format
  • Starting to Generate Revenue
  • Increase My Revenue
  • Optimizing the Experience

Data

  • Admix and User Privacy

Tutorials

  • Sandbox mode on Android

Test your ads using the Admix Sandbox on Android devices using Unity

This is a quick, step by step guide that shows you how to build and run a Unity project using Admix for monetisation on Android.

By the end of this tutorial, you'll be able to run your Unity project on Android and see how your Admix ads are looking in our Sandbox mode. This mode lets you see how ads will appear in your game using pre-made placeholder ads, so is a great penultimate step to check that everything is working and looks great.

In this tutorial, we used the Admix SDK v1.8.5 and it should be applicable to our future versions too.

What you'll need for this tutorial:

Requirements Description
An Admix Developer Platform Account Settings needed - App Status: Sandbox; Placements Status: ON status: ON
Android Device and Cable The Android device must be connected to the computer during the Build and Run process
Android SDK, NDK Minimum Android version - 6, API level 23
Unity Test Project Place any Admix banners that you want to the scene
Admix SDK plugin The latest plugin from Admix, check your version here
The Unity Editor Unity 2017.4.X, Unity 2018.4.X, Unity 2019.1.X, Unity 2019.2.X.

Step-by-Step Guide

1. Prepare the Unity Project

In our case, we created a totally new project and called it “Testing Admix on Android“. We installed the Admix SDK plugin and added all kinds of Admix banners to the scene, but feel free to place what you need. The Admix SDK currently has 2 kinds of video banners and 6 image with different sizes.

For more information on how to get started with Admix - refer to this article: https://docs.admix.in/docs/getting-started/admix-quickstart.

Prepared Unity Project

2. Save your Admix placements

Simply save the scene AND save the ad placements that you added from the Admix plugin.

Save Placements

3. Enable Sandbox mode in the Admix Developer Platform

Once you save your placements, you have to enable Sandbox mode for your project in the Admix Developer platform.

After saving your placements, simply click “Finish setup” and it will redirect you to https://app.admix.in/myapps where you can switch the status for your project from 'OFF' to 'Sandbox'. It's as simple as that.

4. Check your Admix placements

With Admix you can turn OFF or turn ON each specific placement from the Developer Platform online. By default all newly added placements are active, but let’s double-check that.

5. Test Admix ads in the Unity Editor

Now, let’s go back to Unity and run your project to see if the Admix ads are working.

In our case, it worked right after we enabled Sandbox mode but keep in mind that it could take ~10 minutes for the placements to be activated after they are set up in Sandbox mode for the first time. This is also true for any newly added placements being tested in Sandbox for the first time, even when your app already has working placements.

6. Preparing to test on the Android device

Now we can prepare everything for testing on your Android device. The whole process is simple, but Admix requires a few things that you have to know about. Let’s take it step-by-step:

  • Click 'File' - 'Build Settings'
    Unity Build Settings
  • Choose 'Android' and click 'Switch Platform'
    Switch Platform
  • Click 'Add Open Scenes'
    Unity add open scene
  • For Android Admix SDK supports OpenGLES2 and OpenGLES3 and Vulkan as Graphic API. Please refer to this for more information about what is supported by the Admix Graphics API.
    Supported Graphics API
  • Then you can choose where you want to run your app in the 'Run Device' section.
    • Attach your Android device using USB. Make sure that “USB debugging” is ON on your device.
    • Click 'Refresh' and you should see your Android device on the list Attach Android Device
  • Before hitting the “Build and Run” button you have to set up a company and product name, and include them in a package name in order to avoid errors during the building process. Also, make sure that the chosen Minimum API level is supported by your Android device (Minimum Android 5.1 API level 22)
    identification

7. Finally, we can proceed with the “Build and Run“ process. Here how the final result looks on Android:

← Admix and User Privacy
  • What you'll need for this tutorial:
  • Step-by-Step Guide
    • 1. Prepare the Unity Project
    • 2. Save your Admix placements
    • 3. Enable Sandbox mode in the Admix Developer Platform
    • 4. Check your Admix placements
    • 5. Test Admix ads in the Unity Editor
    • 6. Preparing to test on the Android device
    • 7. Finally, we can proceed with the “Build and Run“ process. Here how the final result looks on Android:
Documentation
TutorialsReleasesAPI Reference
Admix
Admix HomepageLogin
Copyright © 2022 Admix