[UPDATED] tutorial: Attaching Admob to RenPy

A place for Ren'Py tutorials and reusable Ren'Py code.
Forum rules
Do not post questions here!

This forum is for example code you want to show other people. Ren'Py questions should be asked in the Ren'Py Questions and Announcements forum.
Message
Author
i_jemin
Regular
Posts: 80
Joined: Sat Apr 11, 2015 3:14 pm
Github: i_jemin
Contact:

[UPDATED] tutorial: Attaching Admob to RenPy

#1 Post by i_jemin »

Android only. for now.

(Updated in 2019.10.05)

I create video tutorial which works with Ren'Py 7.3.3



---- Old version (before Ren'Py 7) ----
Anyway, let's start.

1. Preparations.

Install latest release of RenPy and Rapt.

Install latest release of Android Studio and make sure you install these SDK from SDK manager on Android Studio:
Android SDK which API is numbered as 19.
Google Play Services.
Google Repository.

Make Admob account and make new banner ad for Android.


2. Gathering Source Files from Rapt folder.

Export apk file from your RenPy Project by using RenPy Launcher.
* Don't use expansion APK option!
But we won't use exported apk file.

We gonna use temporary files on Rapt Folder.

After using Android Build Function on RenPy launcher, you gonna found that many files and folder added on Rapt Folder.

These files are converted source file which rapt use for export APK file.

Gathering these files and folders from Rapt and move these to new folder:

Files:
AndroidManifest.xml
build.xml
local.properties
proguard-project.txt
project.properties

Folders:
android-sdk-r23
assets
gen
libs
res
src
templates

3. Make Project for Android Studio

after you moved these files to new folder.
Open your Android Studio, select
"Import Project (Eclipse ADT, Griddle...."

and select your new folder.

Don't care about options checked.
Just press next button, and Android Studio make new Project from your folder.

After new window for new project pop up, you have to wait some minutes until Gradle sync is done.
If there are error message on console, make sure you install all SDK you need.

4. Now add ad on main activity.
Android RenPy use only one activity. PythonSDLActivity which inheriting SDLActivity.
You gonna add your ad object on PythonSDLActivity.

I won't explain about source codes. Just follow these codes.

1. open "build.gradle (Module: yourGameName)" and paste these code inside "dependencies" block.

Image

Code: Select all

compile 'com.google.android.gms:play-services:6.+'
and Press "Sync Now" button.

2. add these code on "AndroidManifest.xml".

Code: Select all

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

Code: Select all

<meta-data android:name="com.google.android.gms.version"
android:value="@integer/google_play_services_version" />

Code: Select all

<activity android:name="com.google.android.gms.ads.AdActivity"
android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|uiMode|screenSize|smallestScreenSize"
android:theme="@android:style/Theme.Translucent" />
if you don't know where to add these code. Check my codes.

Code: Select all

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
          package="applemint.com.yandere"
          android:versionCode="104"
          android:versionName="1.04"
          android:installLocation="auto"
          >

  <application android:label="@string/appName"
               android:icon="@drawable/icon"
               android:allowBackup="true"
               android:theme="@android:style/Theme.NoTitleBar.Fullscreen"
               android:hardwareAccelerated="true" >
               >


      <meta-data android:name="com.google.android.gms.version"
          android:value="@integer/google_play_services_version" />


      <meta-data android:name="wakelock" android:value="1" />
    <meta-data android:name="surface.transparent" android:value="0" />
    <meta-data android:name="fullscreen" android:value="1" />

    <activity android:name="org.renpy.android.PythonSDLActivity"
              android:label="@string/iconName"
              android:launchMode="singleTop"
              android:screenOrientation="portrait"
              android:configChanges="keyboardHidden|orientation|screenSize"
              >


      <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
        <category android:name="tv.ouya.intent.category.GAME" />
        </intent-filter>


    </activity>




      <activity android:name="com.google.android.gms.ads.AdActivity"
          android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|uiMode|screenSize|smallestScreenSize"
          android:theme="@android:style/Theme.Translucent" />



  </application>

  <uses-feature android:glEsVersion="0x00020000" android:required="true" />
  <uses-sdk android:minSdkVersion="10" android:targetSdkVersion="14"/>

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





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



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


</manifest>
3. edit codes on SDLActivity.java and PythonSDLActivity.java


Image

Add these code on top of SDLActivity.java file.

Code: Select all

import com.google.android.gms.ads.AdRequest;
import com.google.android.gms.ads.AdSize;
import com.google.android.gms.ads.AdView;
Add this codes inside of SDLActivity class.
just copy and paste this code at line after "public class SDLActivity extends Activity {"

Code: Select all

public AdView mAdView;
Image

Copy and paste these code on "OnCreat" function inside of SDLActivity class.
Replace "YOUR AD ID" with your ad's id.

Code: Select all

        AdRequest adRequest = new AdRequest.Builder()
                .build();

        //광고 시작점
        mAdView = new AdView(this);
        mAdView.setAdSize(AdSize.SMART_BANNER);

        mAdView.setAdUnitId("YOUR AD ID");


        mAdView.loadAd(adRequest);

4. add this code on top of PythonSDLActivity.java

Code: Select all

import android.widget.RelativeLayout;
change this code

Code: Select all

/**
	 * A layout that contains mLayout. This is a 3x3 grid, with the layout
	 * in the center. The idea is that if someone wants to show an ad, they
	 * can stick it in one of the other cells..
	 */
	public LinearLayout mVbox;
to this.

Code: Select all

	/**
	 * A layout that contains mLayout. This is a 3x3 grid, with the layout
	 * in the center. The idea is that if someone wants to show an ad, they
	 * can stick it in one of the other cells..
	 */
	public RelativeLayout mVbox;
change these code

Code: Select all

	// GUI code. /////////////////////////////////////////////////////////////


	public void addView(View view, int index) {
		mVbox.addView(view, index, new LinearLayout.LayoutParams(LinearLayout.LayoutParams.MATCH_PARENT, LinearLayout.LayoutParams.WRAP_CONTENT, (float) 0.0));
	}

	public void removeView(View view) {
		mVbox.removeView(view);
	}

	@Override
	public void setContentView(View view) {
		mFrameLayout = new FrameLayout(this);
		mFrameLayout.addView(view);

		mVbox = new LinearLayout(this);
		mVbox.setOrientation(LinearLayout.VERTICAL);
		mVbox.addView(mFrameLayout, new LinearLayout.LayoutParams(LinearLayout.LayoutParams.MATCH_PARENT, 0, (float) 1.0));

		super.setContentView(mVbox);
	}
to these.

Code: Select all

	public void addView(View view, int index) {
		mVbox.addView(view, index);
	}

	public void removeView(View view) {
		mVbox.removeView(view);
	}

	@Override
	public void setContentView(View view) {
		mFrameLayout = new FrameLayout(this);
		mFrameLayout.addView(view);

		mVbox = new RelativeLayout(this);
		mVbox.addView(mFrameLayout);

		super.setContentView(mVbox);
	}
Image

last, add these codes on "OnCreate" function of PythonSDLActivity class.

Code: Select all


        ///


        RelativeLayout.LayoutParams lay = new RelativeLayout.LayoutParams(
                RelativeLayout.LayoutParams.WRAP_CONTENT,
                RelativeLayout.LayoutParams.WRAP_CONTENT);

        lay.addRule(RelativeLayout.ALIGN_PARENT_BOTTOM);



        mVbox.addView(mAdView, lay);

        mAdView.bringToFront();


Done.

Now you can use build menu of Android Studio to make new APK file.
Hope you like this tutorial. Good luck.


/// 1.20.2016 updated


# IF YOU WANT TO USE EXPANSION APK.


Mostly same as when you do not use expansion apk.
1. Select "Yes" when RenPy ask you would you like to create an expansion APK.
(Make sure you set Playstore Public Key in your rpy file)
2. Build it, and prepare Android Studio Project from rapt folder same as above tutorial.
3. Follow above tutorial and build new APK file.
4. Upload APK file you just build with Android Studio with OBB file which RenPy builded.

In fact, only thing you have to care about when you use "Expansion APK" is "Constants.java" file in Project.

Code: Select all

package org.renpy.android;

public class Constants {
	// Used by the google play store.
    public static String PLAY_BASE64_PUBLIC_KEY = "SOME_KEY_FROM_GOOGLE_PLAY";
    public static byte[] PLAY_SALT = new byte[] { 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20 };

    // Used by the expansion downloader.
    public static int fileVersion = 1260;
    public static int fileSize = 240049003;

    // Used by the in-app purchasing code.
    public static String store = "play";
}
You don't need to make every new Android Studio project whenever you make new version of game.
When you already have Android Studio Project of previous version of game,
Build new APK,OBB file from RenPy. We won't use new APK file from RenPy.

1. Change Version information on AndroidManifest.xml same as you set on RenPy Android build setting.
2. Change fileVersion and fileSize value on Constants.java. (You may can check or replace with Updated Constants.java file from Rapt folder).
3. Upload APK file from Android Studio with OBB fie from RenPy.

# You can control Size and Position of ads by change this value.

1. Change AdSize.SMART_BANNER gonna change ad size. There are preset values(constant values) like "SMART_BANNER" under AdSize classes.

Code: Select all

mAdView.setAdSize(AdSize.SMART_BANNER);
2. Change input of addRule function gonna change ad Position. You can use preset values under "RelativeLayout".

Code: Select all

lay.addRule(RelativeLayout.ALIGN_PARENT_BOTTOM);

# You can turn off Ads when Player pay for inapp purchase. It's super easy.

1. Collect codes for ad from oncreate Function, bound them as one function under PythonSDLActivity class.
In my case:

Code: Select all

    public void adToLife()
    {
            AdRequest adRequest = new AdRequest.Builder()
                    .build();

            //광고 시작점
            mAdView = new AdView(this);
            mAdView.setAdSize(AdSize.SMART_BANNER);

            mAdView.setAdUnitId("ADS_CODE");


            mAdView.loadAd(adRequest);

            ///


            RelativeLayout.LayoutParams lay = new RelativeLayout.LayoutParams(
                    RelativeLayout.LayoutParams.WRAP_CONTENT,
                    RelativeLayout.LayoutParams.WRAP_CONTENT);

            lay.addRule(RelativeLayout.ALIGN_PARENT_BOTTOM);


            mVbox.addView(mAdView, lay);
            mAdView.bringToFront();
    }

2. Go to "Store.java" file, Add these codes to Store class.

Code: Select all

    static public PythonSDLActivity pAct;

    static public void getAct(PythonSDLActivity aa)
    {
        pAct = aa;
    }

3. Go to "Playstore.java" file, Add these code to last line of restorePurchases Function.

Code: Select all

        if (purchased.contains("PACKAGE NAME OF YOU INAPP PRODUCT") == false) {
            activity.runOnUiThread(new Runnable() {
                @Override
                public void run() {
                    pAct.adToLife();

                }
            });

4. Add this code to oncreate function of PythonSDLActivity class.
Write this code under "Store.create(this);"

Code: Select all

Store.getAct(this);
This mean your oncreate function of PythonSDLActivity class must be like this.

Code: Select all

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);


        Store.create(this);

        Store.getAct(this);



    }
Last edited by i_jemin on Sat Oct 05, 2019 1:27 pm, edited 6 times in total.

Jibus
Regular
Posts: 135
Joined: Tue May 26, 2015 9:45 am
Contact:

Re: Tutorial: Attaching Admob to RenPy and earn some money.

#2 Post by Jibus »

Excellent tutorial ! Thanks for sharing this !

Did you add admob on ios too ?

i_jemin
Regular
Posts: 80
Joined: Sat Apr 11, 2015 3:14 pm
Github: i_jemin
Contact:

Re: Tutorial: Attaching Admob to RenPy and earn some money.

#3 Post by i_jemin »

Jibus wrote:Excellent tutorial ! Thanks for sharing this !

Did you add admob on ios too ?
Not yet. Cause iOS uers are very low in Korea.
But I guess adding admob on ios is way easier than android cuz RenPy officially support exporting iOS project.

I will update how to make expansion apk of renpy game which contain admob,
and iOS admob tutorial in this week. (I lost my mac charger. need to buy one)

User avatar
Karl_C
Veteran
Posts: 232
Joined: Sun Mar 31, 2013 6:18 am
Contact:

Re: Tutorial: Attaching Admob to RenPy and earn some money.

#4 Post by Karl_C »

Very interesting.

Do you have a screenshot or photo?

I cannot imagine how it looks like on a smartphone with a Ren'Py game.

lyminh99
Regular
Posts: 38
Joined: Sat Jun 14, 2014 1:09 pm
Contact:

Re: Tutorial: Attaching Admob to RenPy and earn some money.

#5 Post by lyminh99 »

How to add the test ad? As i saw the information that if i use the live ads to test, my account maybe ban. :/

Lightworker
Regular
Posts: 104
Joined: Sun Dec 13, 2015 2:06 pm
Projects: Detroit.exe
Discord: Happiness+#1168
Contact:

Re: Tutorial: Attaching Admob to RenPy and earn some money.

#6 Post by Lightworker »

Where would you put the admob at?

User avatar
Kate
Regular
Posts: 197
Joined: Thu Sep 19, 2013 6:10 pm
Projects: Blackout
Organization: Moonlight Otome
Location: United States
Contact:

Re: Tutorial: Attaching Admob to RenPy and earn some money.

#7 Post by Kate »

As a developer, I understand the need for this tutorial. As a human being, I detest ads so much. Ads are truly vile. On mobile devices, they really aggravate users because they BREAK IMMERSION (something many have talked about) and are easily accidentally touched and it takes you out of your game app...keep this in mind when making the choice to implement.
-retreats back into cave-
Current Project:
Blackout [VN][Romance][GxB][Mystery][Suspense] http://lemmasoft.renai.us/forums/viewto ... 43&t=34118
"It is the duty of authors to make the fantastic seem ordinary and the ordinary seem fantastic." - K. Auer

User avatar
PyTom
Ren'Py Creator
Posts: 16088
Joined: Mon Feb 02, 2004 10:58 am
Completed: Moonlight Walks
Projects: Ren'Py
IRC Nick: renpytom
Github: renpytom
itch: renpytom
Location: Kings Park, NY
Contact:

Re: Tutorial: Attaching Admob to RenPy and earn some money.

#8 Post by PyTom »

I'm not a huge fan of ads, which is why I didn't implement something like this myself. That being said, I think there are times when they could be relatively unobtrusive, like when entering or resuming a game, or perhaps even between chapters. I think interstitials are far better than ads that always take up space.
Supporting creators since 2004
(When was the last time you backed up your game?)
"Do good work." - Virgil Ivan "Gus" Grissom
Software > Drama • https://www.patreon.com/renpytom

lyminh99
Regular
Posts: 38
Joined: Sat Jun 14, 2014 1:09 pm
Contact:

Re: Tutorial: Attaching Admob to RenPy and earn some money.

#9 Post by lyminh99 »

PyTom wrote:I'm not a huge fan of ads, which is why I didn't implement something like this myself. That being said, I think there are times when they could be relatively unobtrusive, like when entering or resuming a game, or perhaps even between chapters. I think interstitials are far better than ads that always take up space.

I know, but in my country the fact is that the habit to support the developer to buy one app nearly 1%, for now the way to survive is only by ads, which still a hard way for them. What should we do pytom ?

Jibus
Regular
Posts: 135
Joined: Tue May 26, 2015 9:45 am
Contact:

Re: Tutorial: Attaching Admob to RenPy and earn some money.

#10 Post by Jibus »

The intregation is tough, since we have to first package the app then unpack it to add the required lines. It's almost the same for iOS (unpack SDL2 then patch it).

Lightworker
Regular
Posts: 104
Joined: Sun Dec 13, 2015 2:06 pm
Projects: Detroit.exe
Discord: Happiness+#1168
Contact:

Re: Tutorial: Attaching Admob to RenPy and earn some money.

#11 Post by Lightworker »

Where would you put an ad mob so you don't break immersion in a visual novel?

User avatar
HB38
Regular
Posts: 57
Joined: Sun Apr 27, 2014 2:14 pm
Contact:

Re: Tutorial: Attaching Admob to RenPy and earn some money.

#12 Post by HB38 »

Lightworker wrote:Where would you put an ad mob so you don't break immersion in a visual novel?
I think the main title screen would be the least obtrusive. You'd hit it overtime you launched the game once, and as you're playing you'd almost never see it. *shrug*

Hseo
Regular
Posts: 38
Joined: Thu Sep 24, 2009 10:42 am
Completed: High School Life:HSL
Deviantart: greeeed
Contact:

Re: Tutorial: Attaching Admob to RenPy and earn some money.

#13 Post by Hseo »

Tried to used your code but failed
True to be told, I Can't find build.gradle (Module:

For now, I only know how to show top banner ads but not to interact with it
like in this game
https://play.google.com/store/apps/deta ... JAAAMM.HSL

So, it's only ads in name :oops:

i_jemin
Regular
Posts: 80
Joined: Sat Apr 11, 2015 3:14 pm
Github: i_jemin
Contact:

Re: Tutorial: Attaching Admob to RenPy and earn some money.

#14 Post by i_jemin »

Sorry guys, I was busy.
I will update tutorial tomorrow.

- How ads looks and how to control position.
- How to use extension APK with ads.
- How to turn off ads after player buy inapp contents. (Use this on 'Lite version of game')

I know use fullscreen ads between scene and scene is better for player and developer both than using small ads which show whole time.
Unfortunately control the timing of ads by game story flow mean you need to control android native codes from renpy script and I did not try this.
Last edited by i_jemin on Fri Jan 15, 2016 5:59 am, edited 1 time in total.

i_jemin
Regular
Posts: 80
Joined: Sat Apr 11, 2015 3:14 pm
Github: i_jemin
Contact:

Re: Tutorial: Attaching Admob to RenPy and earn some money.

#15 Post by i_jemin »

Hseo wrote:Tried to used your code but failed
True to be told, I Can't find build.gradle (Module:

For now, I only know how to show top banner ads but not to interact with it
like in this game
https://play.google.com/store/apps/deta ... JAAAMM.HSL

So, it's only ads in name :oops:

Try Gradle Sync and wait for it ends.
Image

Did you set project view tab as "Android"??
Image

Post Reply

Who is online

Users browsing this forum: No registered users