B4A Library AdColony Library

Pendrush · Jul 28, 2020

Original library: https://github.com/AdColony/AdColony-Android-SDK
Based on AdColony Library v4.6.5 (21 October 2021).
Banner, Interstitial and Rewarded Interstitial.

AdColonyAds

Author: Author: AdColony - B4a Wrapper: Pendrush
Version: 4.65

AdColonyBanner

Events:

OnClicked

OnClosed

OnLeftApplication

OnOpened

OnRequestFilled

OnRequestNotFilled

Fields:

AD_BANNER As Object
Supported Sizes:
320×50 standard
Min: 300×50
Max: 450×75

AD_LEADERBOARD As Object
Supported Sizes:
970×90 standard
Min: 600×75
Max: 1200×150
8:1 aspect ratio

AD_MEDIUM_RECTANGLE As Object
Supported Sizes:
300×250 standard
Min: 300×300
Max: 450×450

AD_SKYSCRAPER As Object
Supported Sizes:
160×600 standard
Min: 160×640
Max: 240×960

Functions:

BringToFront

Destroy
Destroy banner Ad.

Initialize (arg1 As String)

InitializeBanner (EventName As String, AppID As String, ZoneID As String, GDPR As Boolean, GDPRConsent As String, COPPA As Boolean, COPPAConsent As String, CCPA As Boolean, CCPAConsent As String)
GDPR - The value passed via setPrivacyFrameworkRequired() will determine the GDPR requirement of the user. If it's set to true, the user is subject to the GDPR laws.
GDPRConsent - A value of "1" implies the user has given consent to store and process personal information and a value of "0" means the user has declined consent. Please note that this is not compliant with IAB standards and may reduce your ad fill rate for demand providers which accept IAB consent signals exclusively.
COPPA - The value passed via setPrivacyFrameworkRequired() will determine whether COPPA is applicable for the user. If it's set to true, AdColony will behave with the understanding COPPA is applicable for the user.
COPPAConsent - A value of "1" implies the user has not opted-out to the sale of their data, as defined by the COPPA, and AdColony should continue with our standard processing of user information. A value of "0" means the user has opted-out to the sale of their data.
CCPA - The value passed via setPrivacyFrameworkRequired() will indicate to AdColony whether CCPA is applicable legislation for the user.
If it's set to true, the user is subject to the CCPA. Note that IAB US Privacy String has information embedded into the string to
indicate whether CCPA is applicable. In the event of conflicting signals between the IAB US Privacy String and setPrivacyFrameworkRequired(),
we will interpret as CCPA being applicable.
CCPAConsent - A value of "1" implies the user has not opted-out to the sale of their data, as defined by the CCPA, and AdColony should continue with our standard processing of user information. A value of "0" means the user has opted-out to the sale of their data.
AdColony.InitializeBanner("AdColony", "YOUR_APP_ID", "YOUR_ZONE_ID", False, "1", False, "1", False, "1")
AdColony.RequestBannerAd(AdColony.AD_BANNER)

Invalidate

Invalidate2 (arg0 As android.graphics.Rect)

Invalidate3 (arg0 As Int, arg1 As Int, arg2 As Int, arg3 As Int)

IsInitialized As Boolean

RemoveView

RequestBannerAd (AdSize As com.adcolony.sdk.AdColonyAdSize)
Request banner Ad, onRequestFilled event will fire when request is successful.

RequestFocus As Boolean

SendToBack

SetBackgroundImage (arg0 As android.graphics.Bitmap) As BitmapDrawable

SetColorAnimated (arg0 As Int, arg1 As Int, arg2 As Int)

SetLayout (arg0 As Int, arg1 As Int, arg2 As Int, arg3 As Int)

SetLayoutAnimated (arg0 As Int, arg1 As Int, arg2 As Int, arg3 As Int, arg4 As Int)

SetVisibleAnimated (arg0 As Int, arg1 As Boolean)

Properties:

Background As android.graphics.drawable.Drawable

Color As Int [write only]

Enabled As Boolean

Height As Int

Left As Int

Padding As Int()

Parent As Object [read only]

Tag As Object

Top As Int

Visible As Boolean

Width As Int

AdColonyInterstitial

Events:

OnExpiring

OnOpened

OnRequestFilled

OnRequestNotFilled

Functions:

InitializeInterstitial (EventName As String, AppID As String, ZoneID As String, GDPR As Boolean, GDPRConsent As String, COPPA As Boolean, COPPAConsent As String, CCPA As Boolean, CCPAConsent As String)
GDPR - The value passed via setPrivacyFrameworkRequired() will determine the GDPR requirement of the user. If it's set to true, the user is subject to the GDPR laws.
GDPRConsent - A value of "1" implies the user has given consent to store and process personal information and a value of "0" means the user has declined consent. Please note that this is not compliant with IAB standards and may reduce your ad fill rate for demand providers which accept IAB consent signals exclusively.
COPPA - The value passed via setPrivacyFrameworkRequired() will determine whether COPPA is applicable for the user. If it's set to true, AdColony will behave with the understanding COPPA is applicable for the user.
COPPAConsent - A value of "1" implies the user has not opted-out to the sale of their data, as defined by the COPPA, and AdColony should continue with our standard processing of user information. A value of "0" means the user has opted-out to the sale of their data.
CCPA - The value passed via setPrivacyFrameworkRequired() will indicate to AdColony whether CCPA is applicable legislation for the user.
If it's set to true, the user is subject to the CCPA. Note that IAB US Privacy String has information embedded into the string to
indicate whether CCPA is applicable. In the event of conflicting signals between the IAB US Privacy String and setPrivacyFrameworkRequired(),
we will interpret as CCPA being applicable.
CCPAConsent - A value of "1" implies the user has not opted-out to the sale of their data, as defined by the CCPA, and AdColony should continue with our standard processing of user information. A value of "0" means the user has opted-out to the sale of their data.
AdColony.InitializeInterstitial("AdColony", "YOUR_APP_ID", "YOUR_ZONE_ID", False, "1", False, "1", False, "1")
AdColony.RequestInterstitial

IsInitialized As Boolean

RequestInterstitial
Request Interstitial Ad, OnRequestFilled event will fire when request is successful.

Show
Show Interstitial Ad
DO NOT Show Ad before OnRequestFilled event fire.

AdColonyRewardedInterstitial

Events:

OnExpiring

OnOpened

OnRequestFilled

OnRequestNotFilled

OnReward (Reward As Map)

Functions:

InitializeRewarded (EventName As String, AppID As String, ZoneID As String, GDPR As Boolean, GDPRConsent As String, COPPA As Boolean, COPPAConsent As String, CCPA As Boolean, CCPAConsent As String)
GDPR - The value passed via setPrivacyFrameworkRequired() will determine the GDPR requirement of the user. If it's set to true, the user is subject to the GDPR laws.
GDPRConsent - A value of "1" implies the user has given consent to store and process personal information and a value of "0" means the user has declined consent. Please note that this is not compliant with IAB standards and may reduce your ad fill rate for demand providers which accept IAB consent signals exclusively.
COPPA - The value passed via setPrivacyFrameworkRequired() will determine whether COPPA is applicable for the user. If it's set to true, AdColony will behave with the understanding COPPA is applicable for the user.
COPPAConsent - A value of "1" implies the user has not opted-out to the sale of their data, as defined by the COPPA, and AdColony should continue with our standard processing of user information. A value of "0" means the user has opted-out to the sale of their data.
CCPA - The value passed via setPrivacyFrameworkRequired() will indicate to AdColony whether CCPA is applicable legislation for the user.
If it's set to true, the user is subject to the CCPA. Note that IAB US Privacy String has information embedded into the string to
indicate whether CCPA is applicable. In the event of conflicting signals between the IAB US Privacy String and setPrivacyFrameworkRequired(),
we will interpret as CCPA being applicable.
CCPAConsent - A value of "1" implies the user has not opted-out to the sale of their data, as defined by the CCPA, and AdColony should continue with our standard processing of user information. A value of "0" means the user has opted-out to the sale of their data.
AdColony.InitializeRewarded("AdColony", "YOUR_APP_ID", "YOUR_ZONE_ID", False, "1", False, "1", False, "1")
AdColony.RequestRewarded

IsInitialized As Boolean

RequestRewarded
Request Rewarded Ad, OnRequestFilled event will fire when request is successful.

Show
Show Rewarded Ad
DO NOT Show Ad before OnRequestFilled event fire.

For Interstitial Ad and for Rewarded Interstitial Ad you need to add this in your manifest:

B4X:

AddApplicationText(<activity
            android:name="com.adcolony.sdk.AdColonyInterstitialActivity"
            android:configChanges="keyboardHidden|orientation|screenSize"
            android:hardwareAccelerated="true" />
        <activity
            android:name="com.adcolony.sdk.AdColonyAdViewActivity"
            android:configChanges="keyboardHidden|orientation|screenSize"
            android:hardwareAccelerated="true" />)

For GDPR, COPPA and CCPA please read: https://github.com/AdColony/AdColony-Android-SDK/wiki/Privacy-Laws

Download library zip file and extract archive to Additional Libraries folder.

chris ash · Aug 4, 2020

Hi matey just giving this a try.

Have you got anything or any advice for dealing with the that GDPR side of things?

Thanks
CAsh

Pendrush · Aug 4, 2020

Check this link.
I will add support for GDPR in next version, also in next version I will update library to newer version.

chris ash · Aug 4, 2020

Pendrush said:
Check this link.
I will add support for GDPR in next version, also in next version I will update library to newer version.

Ahhh nice one. Not being pushy but do you have any rough idea on time scale for the next version?

No rush of course and thanks for your time and efforts thus far.
CAsh

Pendrush · Aug 4, 2020

chris ash said:
Not being pushy but do you have any rough idea on time scale for the next version?

Just now.

chris ash · Aug 15, 2020

Pendrush said:
Just now.

Did we manage to get anywhere with the GDPR side of this?

Pendrush · Aug 15, 2020

chris ash said:
Did we manage to get anywhere with the GDPR side of this?

B4X:

InitializeBanner (EventName As String, AppID As String, ZoneID As String, GDPR As Boolean, GDPRConsent As String, COPPA As Boolean, COPPAConsent As String, CCPA As Boolean, CCPAConsent As String)

Privacy Laws

AdColony Mobile Ads SDK for Android. Contribute to AdColony/AdColony-Android-SDK development by creating an account on GitHub.

github.com

chris ash · Aug 15, 2020

Pendrush said:
B4X:

InitializeBanner (EventName As String, AppID As String, ZoneID As String, GDPR As Boolean, GDPRConsent As String, COPPA As Boolean, COPPAConsent As String, CCPA As Boolean, CCPAConsent As String)

Privacy Laws

AdColony Mobile Ads SDK for Android. Contribute to AdColony/AdColony-Android-SDK development by creating an account on GitHub.

github.com

Apologies if that was there all along.

Updated the Library and the code and seems to work like a charrm

Thankyou

Douglas Farias · Aug 17, 2020

Hi @Pendrush.

First thanks for making the library.

Only one report:
If you start the banner and the interstitial in the same activity the banner always fails. (Banner_OnRequestNotFilled).

If you start only one there are no errors, but the two together cause problems for the banner.

thxx

Pendrush · Aug 18, 2020

First you need to try with real APP ID and ZONE ID.
If above don't work, try example attached to this post.
You need to initialize banner and delay initialize Interstitial ad for 20 sec.

Almora · Sep 25, 2020

hi

What should I do to return to a different activity after closing the ad?
Is there a feature like admob?

sample..

B4X:

Sub tm_AdClosed  'admob
    Activity.Finish
    StartActivity(xxx)
End Sub

How can I return to the main activity after the ad is shown

B4X:

Sub activity_KeyPress (KeyCode As Int) As Boolean 'Return True to consume the event
 
    If KeyCode = KeyCodes.KEYCODE_BACK   Then
        
        If AdColony.IsInitialized  Then
            AdColony.Show       
        Else
            Activity.Finish
            StartActivity(Main)
        End If

        Return True
    End If
    Return False
End Sub

Pendrush · Sep 25, 2020

If you talk about Interstitial ad, event AdColony_OnOpened will fire after Ad is closed.
You can test it in example app attached to first post.

Almora · Sep 25, 2020

thanks..

B4X:

Sub AdColony_OnOpened
    Log("OnOpened")
    Activity.Finish
    StartActivity(Main)
End Sub

pemulanih · Apr 19, 2021

AdColony Android SDK
Modified: April 2nd, 2021
SDK Version: 4.5.0

someone already have new version?

Pendrush · Apr 20, 2021

pemulanih said:
AdColony Android SDK
Modified: April 2nd, 2021
SDK Version: 4.5.0

someone already have new version?

New version in post #1

pemulanih · Apr 21, 2021

thanks @Pendrush ✌

bollanog · Jun 17, 2021

Hello, good afternoon, is the library up and running? Because it has not wanted to work for me, I put the real AdColony App UUID and Zone ID and nothing appears yet.

Pendrush · Jun 19, 2021

Maybe there is no fill for you.

shadowdevfr · Aug 8, 2021

Hello @Pendrush ! Is there any way you can update this library to use the latest adcolony sdk (3rd of august 2021)?

Pendrush · Aug 8, 2021

New version in post #1

B4A Library AdColony Library

Attachments

Member

Well-Known Member

Member

Well-Known Member

Member

Well-Known Member

Member

Expert

Well-Known Member

Attachments

Active Member

Well-Known Member

Active Member

Member

Well-Known Member

Member

Member

Well-Known Member

Member

Well-Known Member

Similar Threads

Privacy & Transparency

Privacy & Transparency