Unity SDK Walkthrough

SDK Version:

2.8.264

Oldest Supported version of Unity:

2020.3

Below you’ll find our handy SDK walkthrough guide to using the AdInMo SDK with your game project within Unity.

Register with AdInMo

To begin using the AdInMo SDK, you need to create an account on our developer portal.

1. Go to AdInMo Website , select the ‘Portal’ dropdown and click Sign Up. You can sign up using your email address or your Google account.

2. Fill in the appropriate details and confirm your account using the instructions given. If signing up via email you will be asked to confirm your account.

Portal: Creating a Game

A Game is a representation of your game within AdInMo. During this process you will create a Game Key that is required to work with the AdInMo SDK, please keep this information private.

1. Login to your developer account on AdInMo and Click the + Add New Game button.

2. Fill in the details of your game and click Save. These details can be edited at any time.

3. Each game has its own game key, this can be viewed on the details page of a game. You will need this game key later on in the process.

4. To view the details of your game, simply click the name of the game you want to view, either on the overview or game list page.

Portal: Creating a Placement

This part requires at least one game on the portal.

Placements are simply objects which will display an advertisement, they must contain a Unity 2D texture. One game can support multiple placements.

During this process you will create a Placement Key that is required to work with the AdInMo SDK, please keep this information private.

1. View the game you wish to create a placement for on the portal and click the, + Add New Placement button, if you already have any placements they can be viewed here.

2. Fill out the details of your placement and select an aspect ratio. Placements can be edited at any time.

3. Each placement has its own placement key, this can be found on the placement list. You will need this placement key later on in the walkthrough.

Portal: Adding a test device

Adding a test device will enable us to look in more details on our side if you experiense any issues.

1. To add a test device, go your profile on the portal and select the game you wish to add the device on.

2. From the menu, choose Test devices and then ‘Add test device’. You’ll be presented with a list of devices which have accessed your app, along with their UID, session start and IP address.

3. Choose a device and click Add Device.

Portal: Cross Promotion Ads

Cross Promotion Ads allow you to use unfilled ad placements to promote other games in your portfolio. Remember these are immersive non-clickable ads so simple creatives focused on logos and character art will work best.

1. Choose an image in accordance with the supported aspect ratios.

2. The image must be in JPEG or PNG format and should not exceed 1MB in size.

When you’re ready for the campaign to go live please drop us a quick email to support@adinmo.com. We will then do a quick brand safety and copyright check and then put your campaign live.

Setting up the SDK within Unity

After you’ve set up the account, you can then download our latest SDK here

Oldest Supported version of Unity 2018.4

Release notes for the AdInMo SDK can be found here

When updating an older version of the AdInMo SDK, the best practice is to delete the existing AdInMo folder in assets before importing the latest version of the SDK.

1. After you’ve downloaded the SDK, create or open a project within Unity Editor. If you’ve downloading from the Unity Asset Store, you can either import from the package manager or through the asset store tab depending on the unity version.

2. From the top menu, click Assets > Import Package > Custom Package and locate the Unity package containing the SDK. Ensure all the items are selected and click Import.

3. You should now see a folder called Adinmo displayed in the Unity Assets window.

AdInMo Manager

1. First, the AdinmoManager prefab needs to be added to the scene. Next, copy and paste the game key of your game into the AdinmoManager.

2. From the Assets window, select Adinmo > Prefabs and click and drag the prefab called Adinmo Manager into the scene hierarchy.

3. If you are working on a development build, please check this box on the Adinmo Manager.

4. Navigate back to the portal and to the appropriate game, view the details of the game on the portal and copy the game key (starts with gk…). In Unity Editor, click on the AdinmoManager prefab and paste the copied game key in the game key field.

5. You can report your application version through the Adinmo Manager inspector by adding it in the Application Version field.

Adding placements

AdInMo SDK 2.0 supports game objects templates (image, quad and sprites) of different aspect ratios that you can add to your scene without the need to manually create them.

1. Go to the AdInMo folder in the assets window and select prefabs.

2. From here, you can select the appropriate game folder for the game object you want to add. Each game object is named with its aspect ratio.

3. Paste the placement key of the placement from the portal into the placement key field. Placement keys start with ‘pk…’

4. Test your project directly in editor by hitting Play. You can enable AdInMo’s Debug tool from Adinmo>Manager which will give you important information about your placement setting.

5. To set Audio ads: | - Drag and drop the Audio prefab to an existing or a new canvas. | - You will now see the Audio icon present in your scene. The prefab is disabled by default and the icon will not be visible during runtime until an ad is ready to play. | - From within the prefab you can move the icon to where you want it to show in-game. It will remain hidden until an ad is ready to play. The icon is set to scale with the reference resolution on the canvas and by default is set to 100x100 pixels.

NOTE The icon should be placed in an area of the game that is visible to the user but not disruptive to the game experience.

6. To set Rewarded InGamePlay | - Create a canvas or use an existing one. Icon and popup will scale with Reference Resolution. We suggest 1920x1080 for portrait or 1080x1920 for landscape, | - Drag and drop the ZebedeePrefab onto the canvas - you can choose Portrait or Landscape based on your setup.

Make sure to set the canvas to match width for portrait or height for landscape. From within the prefab you can decide whether to put the icon left or right side on your screen based on your preference.

Your scene should look like this:

During runtime, when clicking on the icon you will be presented with this popup:

By default the icon, popup and success screen are in green however you can adjust the colour to suit your game.

SDK 2.5.253 simplifies how ad placement sizes are managed with four Placement Types supported:

• Square (min 250 x 250 pixels)

• TV (min 480 x 320 pixels)

• Portrait (min 320 x 480 pixels)

• Landscape (min 320 x 50 pixels)

The four Ad Placement Types map to IAB’s Fixed Size Ad Specifications and support all display and video ad units for maximum demand opportunities. Aspect ratios that do not match these Placement Types are deprecated and no longer be added to your game. Existing ad placements will continue to serve ads but will generate less revenue and we recommend editing all placements to use one of the four Ad Placement Types.

Make sure to set your texture quality High. You can set it by going to Project Settings>Quality>Texture Settings. This will allow you to scale the placement if your project requires it and still have a high quality ad. This will not affect your app’s performance.

AdinmoTexture Component

If you want to create your own game object from scratch, you can use the AdInMo texture component on the game object that will act as the advertising placement within your game.

1. Create a game object, either an image, quad or sprite, select the game object in the scene and click Add Component in the inspector window.

2. In the search box, type and select Adinmo Texture.

3. Paste the placement key of the placement from the portal into the Adinmo Texture component, Placement keys start with pk…

NOTE Keep in mind this method is prone to errors and it’s always best to use the prefabs.

App-ads.txt

App.ads.txt is an industry mechanism developed by IAB to help combat ad fraud. Demand partners check your app-ads.txt file to verify that bid requests are coming from authorized sellers.

It is essential to keep your app-ads.txt file updated to maximize monetization.

Existing app-ads.txt file:

If you already have an app-ads.txt file on your website, you just need to add AdInMo’s details which you can download from the developer portal main page.

Non-existing app-ads.txt file:

1. Download the latest app-ads.txt file from your portal page.

2. Ensure your web server can serve your developer url as plain text.

3. Place the app-ads.txt file provided in the root directory of your website.

4. Add the URL containing your app-ads.txt file on your Company profile in the portal. This step is crucial so we can verify it.

The URL should look something like this: www.developer_name.com/app-ads.txt

NOTE

In case you don’t have a website yet or your hosting company doesn’t give you access, you can use a third party service to host your app-ads.txt file.

NOTE

The root directory of your website or the web root is the folder where the index.html file is stored and it is publicly accessible.

Anyone typing your URL followed by /app-ads.txt should be able to view your app-ads.txt file.

User Consent GDPR

From January 16, 2024, Google requires publishers and developers to use a Consent Management Platform (CMP) that has been certified by Google and has integrated with the IAB’s Transparency and Consent Framework (TCF) when serving ads to users in the European Economic Area or the UK.

Using a CMP enables you to pass the required TCF2.2 to monetize your traffic in Europe.

AdInMo’s SDK supports any CMP.

Please see further information below on how to pass the TCF2.2 string using:

AdMob UMP

Usercentrics

Accessing the advertising ID in Android API33 and above

In version 33 of the Android SDK it is no longer possible to access the advertising id without adding an additional permission to the Android Manifest. In this case there will be an warning in logcat like this:- Package <your app_id> failed Ad Id permission check. Apps that target Android SDK 33 or higher should declare com.google.android.gms.permission.AD_ID in the app manifest to access Ad Id. And result in AdInMo not being sent the correct advertising id during the bidding process, which could result in reduced income for Android devices. Of course, you could fix this by compiling against an earlier version of the Android SDK, but this is not recommended. The preferred fix is to add the missing permission to the Android Manifest

Adding Missing Permission

1.If you already have a custom AndroidManifest.xml file continue to step 6, otherwise continue

2.Go to File/Build Settings

3.Select Android

4.Select Player Settings

5.Find the Custom Main Manifest option in Publishing Settings/Build and tick the box. Unity will create a file and tell you where it is:

6.Edit the file indicated and add:

<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

tag just above the closing tag ‘</manifest>’ as indicated below:

or an alternative option would be:

Downgrading Android SDK

If it is preferable instead to downgrade the SDK version used instead. Here is what you would do:

7.Go to File/Build Settings

8.Select Android

9.Select Player Settings

10.Find Target API Level in the Other Settings section

11.Change to an earlier version than API level 33

In both cases the warning should no longer appear in logcat, and AdInMo will now receive the correct advertising id.

Using AdMob’s UMP plugin to validate GDPR consent

Setup Admob

These instructions only work if you have a working Admob account via https://apps.admob.com/ for the game that you want to use. It may be possible to create an Admob account and register your game without actually having integrated Admob into your project, but at the bear minimum this will require your game to be live on the app store. Note that you may need to temporarily disable any adblocker before using the site. Once you have a working Admob account, use the following instructions to setup GDPR verification.

1. From your Apps. Find your game, and make a note of the App ID (starts with ca-app-pub-), you will need this further down the process where it’s mentioned as Admob App Id

2. From Privacy & messaging click GDPR

3. Click Continue

4. Click “Create a GDPR message”

5. Click Select Apps

6. Select your app that you want to apply this too, you will need to set a privacy policy URL, and confirm

7. Set up you language preferences

8. Setup your user consent options, you will need the first option, ‘Consent’ or ‘Manage options’, and the check the Close (do not consent)

9. Targeting should be for Countries subject to GDPR

10. In the Review your account settings section tick both boxes

11. Click Review your ad partners

12. Find Adinmo Ltd in the list and add it

13. Click Confirm

14. Click Add purposes

15. Configure the usages as per your own preferences, but we recommend the following settings will maximise potential earnings

16. Press confirm

17. Press continue and you should be presented with a preview of what your consent dialog will look like

18. Give your message a name and press publish

Android Specific Setup Instructions

1. Get Admob Application id for your android app and add it to AdinmoManager Object like this:

2. Add the required dependencies for UMP to an Android build:

• Install External Dependency Manager

• After installing the unitypackage, it will ask you if you want to auto resolve, if you click ‘Yes’, that is all you need to do

• If you click ‘No’, you can do the resolve by using Assets > External Dependency Manager > Android Resolver > resolve

• After a while when it copies all the missing dependencies to the Plugins/Android folder, it will complete and you can run the build

iOS Specific Setup Instructions

1. Get Admob Application id for your iOS app and add it to AdinmoManager Object like this:

2. Add the required dependencies for UMP to an iOS build:

• Make sure you have CocoaPods installed on your development machine

• Install External Dependency Manager

• Build your app as usual

• Note, this setup will not support bitcode

Using UMP

After AdinmoManager has been initiated, there are 2 functions you can use to trigger UMP events:

static void AdinmoManager.CheckConsent([Optional]UMPCallback resultCallback)

Call this at a convenient time during startup. If consent is required, and hasn’t been determined yet, this will launch a popup asking for consent options, otherwise it will notify adinmo about previously selected options saved in the prefs.

static void AdinmoManager.ResetConsent([Optional]UMPCallback resultCallback)

This will reset the consent received state and bring up a fresh popup. This is designed to be used in the game menus to allow the user to change their mind about their previously selected consent options

Where UMPCallback is an optional delegate of the format:

void UMPCallback(bool consentWasRequired, bool canShowAds, bool canShowPersonalisedAds, string TCF_String);

You can use it to receive the results of the dialog box for your own purposes.

Using UserCentrics

Guides on how to setup Usercentrics can be found here Usercentrics Documentation and a guide to setting up their SDK can be found here Introduction - Usercentrics Apps SDK. While setting up Usercentrics, ensure that AdInMo Ltd is enabled as a vendor

NOTE

Make sure to add ‘using Adinmo;’ at the beginning of your script so you can use any of the methods.

You also need to call the consent methods after the AdinmoManager is created. Depending on your setup it should look something like this:

1.create AdinmoManager

2.do consent popup

Finished!

Run your game and advertisements will appear in your game.

For support, please check our FAQ.

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.