I NEED YOUR HELP UPDATE: Thanks to someone that wants to keep anonymous, for my new Dev Machine! Hope there its more people like You out here! Please be like that ononymous person, Donate if you can!.

What happend that time: During the first weekend of september (Saturday, September 3rd 2022, just to document it), a thunderstorm burn my development PC. Every File on it its safe, but the mainboard got fried and Unusable. Please help me with a donation to get a new development PC, so I can continue updating this project and other's, as soon as posible. I will be very greatfull. Thanks in Advance ]

UnityAds 4 Plugin

Cordova Plugin for UnityAds ver 4.x

The Documentation here its out of date, please refere to the new work in progress page.

• New Documentation Page

Contents

1. Description

2. Plugin Background

3. Features

4. Quick Start

5. Installation

6. Usage

7. Methods

8. Android ARCore Setup

9. Credits

10. Donations

11. Legal

WHAT'S NEW IN THIS VERSION (4.12.0)

• Updated to UnityAds SDK 4.12.0
• From now on you can just UnityAds SDK change log on the following website: text

DESCRIPTION

This Cordova / PhoneGap plugin enables the integration of Unity Ads video ads into your cordova mobile games or apps in a way that both increases player engagement and puts more money in your pocket over the gamer’s lifetime. Unity Ads offers the highest Average Revenue Per User (ARPU) of any global rewarded video ad network.

PLUGIN BACKGROUND

A couple of years ago, and after a great mistake, I got banned from Google AdsMob network. After appels to the mercy of Google, explaining what happens... I remain banned for life. This put me on a very bad situation those days, with a very short list of good monetizing alternatives. This ends the day I learn about UnityAds

After the end of the UnityAds 1.x and 2.x Api era, I have to move forward and Implement UnityAds 3.x on my projects. Implement it on the Unity Game Engine was a breeze, But then I didn't found any solutions to implement version 3.x on my html5, cordova, construct 2 or 3 projects. That my friends, makes this cordova plugin a reality. Oh well, it was basically, necessity!

FEUTURES

Platforms supported:

• [x] iOS, via SDK v4.x.x (see Release Notes)
• [x] Android, via Android SDK v4.x.x (see Release Notes)

Ad Types:

• [x] Non Rewarded Video
• [x] Rewarded Video
• [x] Banner Ads
• [x] AR Ads (If you have try this, let me know if works, because my MetaQuest never arrives)

QUICK START

# create a demo project 

cordova create test1 com.yournamehere.test1 Test1  

cd test1  

cordova platform add android  

cordova platform add ios

# now add the plugin, cordova CLI will handle dependency automatically

cordova plugin add com-artemisoftnian-plugins-unityads3

# now remove the default www content, copy the demo html file to www
rm -r www/*;

cp plugins/com-artemisoftnian-plugins-unityads3/example/basic/* www/;

  
# now build and run the demo in your device or emulator  

cordova prepare; 
cordova run android;
cordova run ios;  

# or import into Xcode / eclipse

INSTALLATION

• If use with Cordova CLI:

cordova plugin add com-artemisoftnian-plugins-unityads3

• Using NPM

npm install com-artemisoftnian-plugins-unityads3

USAGE

Step 1: Go and create a new project for the desire platform in UnityAds portal,

Step 2: Write the specified id's in your javascript code.

  

// select the right Ad Id according to platform

  

var  gameId = "Android or iOS Game ID";

var  videoAdPlacementId = "Video Placement ID";  

var  rewardedVideoAdPlacementId = "Rewarded Placement ID";  

var  arAdPlacementId = "AR AD Placement ID";  

• Important (9-15-2021) - app-ads.txt

• If you are using Banner Ads, be sure to implement app-ads.txt as described in the app-ads.txt support page.

Otherwise, banner demand may be significantly decreased.

• Important: Enabling AR content through Unity:

Contact Unity Ads to enable AR content, providing the following information:

• Your Project ID

• The ID for the dedicated Placement to display AR content

After playing around and complete your tests, remember to put isTest = false when building for production.

METHODS

// Initialize UnityAds
UnityAdsInit(gameId, isTest, isDebug, fn);

// Video Ads Related (Regular Placement ID|Rewarded Placement ID)

ShowVideoAd(videoPlacementId, fn);

//Long Live GetPlacementStatus, Deprecated Method ... RIP... FINITO... REMOVED FROM UNITYADS SDK 4.0 and later
GetPlacementState(videoAdPlacementId, fn); 
//Banner Related

ShowBannerAd(bannerAdPlacementId, bannerPosition, fn);
  
//Manually Set UnityAds Privacy and GDPR consent (true|false)
ManualGdprOpts( consent, fn);
anualCcpaOpts( consent, fn);
ManualCustomAgeGates( useroveragelimit, fn);

//Gets The UnitySDK Version Using at the moment.
GetUnityAdsSdkVersion(fn);

Android ARCore Setup

UnityAds SDK Allows AR Ads on Android, but for this to work You will need to manually add the following entries on the AndroidManifest.xml on your project.

Permissions:

<uses-permission  android:name="android.permission.CAMERA"  />

ARCore Entries inside the section

  

<application>
  

<meta-data  android:name="com.google.ar.core.min_apk_version"  android:value="24"  />
<meta-data  android:name="com.google.ar.core"  android:value="optional"  />

  

</application>

  

Note: Before You can use any Related AR Ads you need to ask to permissions to the Unity Teams. Use the following guide as reference:

UnityAds AR Ads Documentation

Credits

This project is created and maintained by Waldemar Medina.

Available for project outsourcing and or consulting services. Let me hear about it. I can help in your project.

Check Out my UnityAdsX addon for Construct 3

Legal

Unity, GDPR and Data Privacy – FAQ

Donations

Now that You end your reading, (I know You where curious) please consider supporting Artemisoftnian with a donation, a cup of coffee ☕ or maybe a slice of pizza 🍕.. Please I'm begging you for money!!! sorry for a donation, excuse my manners. 😊

or You can become a Patreon and support even more deeply, mysterious and secret stuff:

• Get acess to the Cordova Plugin Source Code

• Get acess to the Construct 3 UnityAds3 Plugin Source Code

• Important DON'T GET BANNED (Remember my little mistake): Please read carfully the Unity Monetization Services Terms of Service. And most important: DON'T CLICK ON YOUR OWN APP ADS. Don't said I haven't warn You!

Social

If you have isssues, want to check what's new, have constructive comments, please visit my Discord Server below:

I'm not always there, but I will see your message eventually.