QuickStartGuide

This guide takes you through the steps required to integrate the AdInMo SDK in your game so you can start monetizing with InGamePlay brand ads. It should take no more than 10 minutes to integrate the AdInMo SDK in your game project within Unity and Unreal Engine. It really is that easy!

AdInMo SDK

Download SDK here.

For more details on SDK integration, please see Technical Documentation.

Developer Portal

1. Click here to sign up to AdInMo’s developer portal to get started.

2. Create a game on the AdInMo portal by clicking the ‘+ Add New Game’ button. This will create a game key for your game that is required in a later step.

3. Create a placement by clicking on the ‘+ Add New Placement’ button on the game page. Note: a game is required to create a placement. This will also create a placement key for your placement that is required in a later step.

4. Download the AdInMo SDK, click here to be taken to the download page.

App-ads.txt

The app-ads.txt mechanism was designed by the Interactive Advertising Bureau(IAB) to combat fraud. It enables developers and publishers to identify themselves as the legitimate owner of the game. You must implement app-ads.txt in order to monetize with in-game advertising.

If you already have an existing app-ads.txt file, simply add AdInMo’s details. 

If you don’t have an app-ads.txt file, you can follow the steps below:

1. Download the latest app-ads.txt file from the main page of AdInMo’s developer portal 

  1. You need to add app-ads.txt to the root directory of your website so it can be viewed by all our demand partners. The root directory of your website or the web root is the folder where the index.html file is stored and is publicly accessible. If you don’t have a developer website or your hosting company doesn’t give you root access, you can host the file on a third party platform.

3. Add your app-ads.txt URL to the company details on the developer portal, so we can verify it. URL should look something like this: www.developer_website.com/app-ads.txt

Unity Editor

5. Create/open a project within Unity.

6. Import the AdInMo SDK into Unity, by clicking, ‘Assets’, ‘Import Package’, ‘Custom Package’ and selecting the unity package you just downloaded.

7. Add the AdInMo manager prefab to the scene. From ‘Assets, go to: ‘Adinmo’, ‘Prefabs’, then click and drag the ‘AdinmoManager’ prefab into your scene.

8. Add your game key to the Adinmo Manager.

9. Drag and drop one of the pre-made prefabs into your scene – TV, Square, Landscape or Portrait, making sure they match your portal setup.

10. Add your placement key to the component.

11. Once you have added both the game key and the placement key, run your game within Unity Editor to see ads.

Please note

You will not be able to see impressions using a development build, uncheck this option if you are building a release.

Unity Editor also has its own development build option under ‘File’, ‘Build Settings’. Ensure the ‘Development Build’ option is not checked when building for release.

The Audio prefab does not require a placement key. You will simply need to set a canvas, set the correct reference resolution on it and drag/drop the prefab. In case you already have a canvas in your hierarchy, you can use that one instead.

Unreal Engine

5. Create/open a project within Unreal Engine. Please note that the AdInMo Unreal Engine SDK will only work as an engine plugin or in a c++ project.

6. Import the AdInMo SDK plugin to your UE4 project. Find the plugins folder for your project, ‘/[Project Root]/Plugins/[Plugin Name]/’ in your project files then add the AdInMo SDK folder. You may have to create a plugins folder if one doesn’t exist.

7. Go to Place Actors > Adinmo and place the AdinmoManager into the level.

8. Add your game key to the Adinmo Manager.

9. Go to Place Actors > Adinmo, here you will find quads of different aspect ratios.

10. Once you have added at least one quad, add in your placement key from the developer portal (starts with pk…).

11. Once you have added both the game key and the placement key, run your project to see ads.

Ad Placement Types

Our InGamePlay SDK supports four Ad Placement Types:

  • Square
  • TV
  • Portrait
  • Landscape.

They map to IAB’s Fixed Size Ad Specifications and support all display and video ad units including Banners, Skyscrapers and Leaderboards for maximum advertising opportunities.