YoleWallet-广告版 客户端接入文档

 1.0 接入说明

1.0.1 SDK获取​

SDK当前最新版本1.0.0，建议使用最新的版本号替换掉示例代码中的 X.X.X

1.0.2 SDK客户端配置

在Android Studio项目的根build.gradle中加入maven配置

buildscript {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
    ...
}
allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

在app的build.gradle文件中配置

dependencies {
    ...
    implementation 'com.github.yoletechnology:YoleWalletYoleWalletAD:x.x.x'
    ...
}

在Android Studio项目的AndroidManifest.xml中加入meta-data配置

<manifest xmlns:android="http://schemas.android.com/apk/res/android"

    <application
       
        <!-- Google -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="@string/googleakey"/>
        <meta-data android:name="com.google.android.gms.ads.flag.NATIVE_AD_DEBUGGER_ENABLED"
            android:value="false" />
    </application>
</manifest>

在Android Studio项目的res\values\strings.xml中加入 测试id

<!--测试应用ID-->
    <string name="googleakey" translatable="false">ca-app-pub-3940256099942544~3347511713</string>
    <!--开屏广告-->
    <string name="googlea1" translatable="false">ca-app-pub-3940256099942544/3419835294</string>
    <!--横幅广告-->
    <string name="googlea2" translatable="false">ca-app-pub-3940256099942544/6300978111</string>
    <!--插页式广告-->
    <string name="googlea3" translatable="false">ca-app-pub-3940256099942544/1033173712</string>
    <!--插页式视频广告-->
    <string name="googlea4" translatable="false">ca-app-pub-3940256099942544/8691691433</string>
    <!--激励广告-->
    <string name="googlea5" translatable="false">ca-app-pub-3940256099942544/5224354917</string>
    <!--插页式激励广告-->
    <string name="googlea6" translatable="false">ca-app-pub-3940256099942544/5354046379</string>
    <!--原生高级广告-->
    <string name="googlea7" translatable="false">ca-app-pub-3940256099942544/2247696110</string>
    <!--原生高级视频广告-->
    <string name="googlea8" translatable="false">ca-app-pub-3940256099942544/1044960115</string>

2.0 接口调用流程

2.0.1程序启动时初始化

请求方法：initAd

接口作用：对支付SDK进行初始化

public class MyApplication extends Application {


    @Override
    public void onCreate() {
        super.onCreate();

        HashMap<String,String> list = new HashMap<String,String>();
        list.put("RewardedAdId",this.getString(R.string.googlea5));
        YouleSdkMgr.getsInstance().initAd(this, list,false);
    }

请求参数：

参数名称	必填	类型	说明
var1	Y	Context	上下文对象
var2	Y	HashMap<String,String>	参数列表
isDebugger	Y	Boolean	测试开关

HashMap<String,String>对象说明：

参数名称	必填	类型	说明
RewardedAdId	Y	String	激励广告id

2.0.2 程序预加载广告部分

请求方法：preloadAd

接口作用：对SDK的广告部分进行预加载

ublic class MainActivity extends Activity{


    @Override    
    protected void onCreate(Bundle savedInstanceState) {

	    YouleSdkMgr.getsInstance().preloadAd(this);

    }
}

请求参数：

参数名称	必填	类型	说明
var1	Y	Activity	上下文对象

2.0.3 发起支付

请求方法：startPay

接口作用：支付

public class MainActivity extends Activity{
    public static MainActivity instance;
    public static String TAG = "MainActivity";
    private Activity m_activity = null;
    private Handler handler = new Handler();


    @Override    
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        
        instance = this;
        m_activity = this;
    }
  
    public void m_buyItem() {

        handler.post(new Runnable() {
            @Override
            public void run() {
                startPay();
            }
        });
    }
    public void startPay()  {

		try{
			YouleSdkMgr.getsInstance().startPay(m_activity,new CallBackFunction() {
				@Override
				public void onCallBack(boolean result) {
				}
			});
		}
		catch (Exception e){
		}
	}
}

请求参数：

参数名称	必填	类型	说明
var1	Y	Activity	上下文对象
CallBackFunction	Y	Object	支付结果回调

3.0 广告部分的接入

3.0.1接入banner广告

请求方法：createBanner

接口作用：加载显示Banner

MobileAdsMgr.getsInstance().createBanner(m_activity, m_activity.getString(R.string.googlea2));

请求参数：

参数名称	必填	类型	说明
var1	Y	Activity	上下文对象
var2	Y	String	banner的广告id