Android (Android Studio)

SDK INTEGRATION
GUIDE
FOR

v2.3.3

v2.1.7
Notes:

This tutorial is confirmed to work with Buildbox 2.3.3 and should be working for all
remaining updates of Buildbox 2.3.x. For Buildbox v2.2.9 see the Eclipse tutorial instead.

The files provided in this document are all created by developers of the company
Appodeal. The URLs to download those files are owned by Appodeal. Don’t use files
provided from somewhere else (or only at your own risk). Updates for the Appodeal SDK
might be provided once available.

The PDF tutorial in its present form was created by Christoph Müller, February 18th, 2018.

This guide is in no way affiliated with Buildbox.

Page 2 of 12

BUILDBOX SETUP
1. Sign up to Appodeal (https://www.appodeal.com/signup).

2. Create a new app (https://www.appodeal.com/apps/new?apps_filter=0) and make sure you select the
Android platform. Click ‘Create App’ after filling out all the needed information.

After clicking the ‘Create App’ button, the SDK Integration wizard opens automatically. Just ignore it
since your new app already was created.

3. Go back to the Apps tab (https://www.appodeal.com/apps) and copy your app specific Application
Key.

4. Open Buildbox and go to the Advertisement tab in the Project Settings. Select Google Play Store as
your Application Store and add your newly created Appodeal Application Key to the ‘HeyZap Publisher

Page 3 of 12

 ID’ field. Then confirm by clicking on ‘OK’.

Note:
We are going to use ‘HeyZap’ as a placeholder to integrate Appodeal instead. Buildbox doesn’t officially
support Appodeal. But no worries, everything works perfectly fine.

5. Select your UI where you want to appear the ads and select ‘HeyZap’ from the dropdown menu. In this
case, we select Ad Banner and Ad Interstitial for the Game Over UI.

Page 4 of 12

6. For Video Reward select Heyzap as your Ad Network in your Purchase Button. In this case, we setup a
‘Continue’ button:

7. Export your Game for Android by selecting File/Export/Android. Ignore the ‘HeyZap Network Warning’
from the pop-up and click on ‘Continue’ when prompted.

Page 5 of 12

ANDROID STUDIO SETUP
1. Download all necessary extra files to integrate Appodeal into your project from here:
https://s3.eu-central-1.amazonaws.com/appodeal-buildbox/Appodeal-BuildBox-Plugin-2.1.7-140218-
all.zip and extract the ZIP file somewhere.

2. Now we need to replace some files. In the extracted folder go to android/src/com/secrethq/ads and
copy the new PTAdHeyzapBridge.java file.

3. Go to the Android project folder of your game and open android/app/src/main/java/com/secrethq/ads.

Then paste (replace) the original PTAdHeyzapBridge.java file with the new one from the previous step.

4. Go back again to the extracted folder and open android/libs. Select and copy all the jar files.

Page 6 of 12

5. Navigate once more to your project folder and open android/app/libs/ and copy-paste all the new jar
files into it. Some are already there so just select ‘replace’ them when prompted. Then, as a last step,
delete the original file PTAdHeyzap.jar from the same folder.

6. Now open Android Studio 3 and select ‘Open an existing Android Studio project’. Select your
build.gradle file from your exported Android folder in order to open your project.

Page 7 of 12

7. Once the project has loaded completely in Android Studio, right click on your project (app) and
select ‘Open Module Settings’.

8. Click the "+" button in the top left corner of the window to add a new module.

Page 8 of 12

9. Select "Import .JAR or .AAR Package" and click the "Next" button.

10. Click on the ellipsis button "..." beside the "File name" to open up the search window.

Page 9 of 12

11. Navigate to the android folder of your extracted folder and select the ‘adcolony-sdk-3.1.2.aar’ file,
then click on ‘Open’.

12. Keep the app's module selected and click on the Dependencies pane to add the adcolony module as a
dependency. Then click on the ‘+’ button and select ‘Module dependency’.

Page 10 of 12

13. Select the adcolony module and click ‘OK’. Close the Project Structure window by clicking ‘OK’ once
more.

14. Expand the folder structure and open the AndroidManifest.xml by double clicking on it.

Page 11 of 12

15. Highlight all code from <!--Facebook SDK--> all the way to <!--Chartboost--> and delete it.

16. Go to the extracted folder once more and open the file SampleAndroidManifest.xml. Copy the entire
code between the two <!--Appodeal--> tags (it ends just before </application>) and paste it into your
AndroidManifest.xml in Android Studio in the same place where you deleted the old code in the step
before.

17. Run your project on device or simulator. For ad performance, ad networks activation criteria and
disabling ad networks by yourself check out this blog post by Appodeal:
https://blog.appodeal.com/blog/2017/11/06/update-network-monitor-tool-1/
Page 12 of 12