Bidding Android iOS 快应用 SDK H5 SDK Media API 常见问题

断点续安装或激活弹窗提示

基本信息

4.390.1260新增

用户在和广告交互的过程中,会存在下载了应用并未安装或者安装了应用并未打开的情况,这时可以通过弹窗提示用户,最大化广告收益。

该功能是断点续安装提示功能的升级,开发者不需要处理应用解析和弹窗的具体逻辑,只要调用接口就可以实现在指定时机弹窗提醒用户完成安装或激活的操作。

权限等级:开放

接口详情

showOpenOrInstallAppDialog

int GDTAdSdk.getGDTAdManger().showOpenOrInstallAppDialog(GDTAppDialogClickListener listener)

通过该接口可以检查通过广告sdk下载完成未安装或已安装未激活的应用,通过弹窗的方式提示用户安装或打开激活。
重复调用该接口会按时间循序循环返回未安装或已安装未激活的应用。

返回值 说明
GDTAppDialogClickListener.NO_DLG 没有可以安装或激活的应用
GDTAppDialogClickListener.INSTALL_APP_DLG 弹窗提示用户安装应用
GDTAppDialogClickListener.OPEN_APP_DLG 弹窗提示用户打开应用激活

GDTAppDialogClickListener

com.qq.e.ads.dfa.DownloadConfirmListener

开发者调用接口传入的listener,开发者需要实现对应的接口.

方法名 方法介绍
onButtonClick(int buttonType) showOpenOrInstallAppDialog返回值为INSTALL_APP_DLG或者OPEN_APP_DLG时会有弹窗,用户点击点击弹窗的结果回调

buttonType的值为

参数值 说明
GDTAppDialogClickListener.CONFIRM_BUTTON 弹窗用户点击确认
GDTAppDialogClickListener.CANCEL_BUTTON 弹窗用户点击取消

接入代码示例

建议开发者在用户退出应用时进行提示,也可以在任意场景调用,具体可以参考demo中的实现代码。

(关键代码展示,详细请参考压缩包的代码)

// DemoListActivity.java

public class DemoListActivity extends AppCompatActivity {
  @Override
  public void onBackPressed() {
    showOpenOrInstallAppDialog(true);
  }

  private void showOpenOrInstallAppDialog(boolean isFromBackPress) {
    int result =
        GDTAdSdk.getGDTAdManger().showOpenOrInstallAppDialog(new GDTAppDialogClickListener() {

      @Override
      public void onButtonClick(int buttonType) {
        Log.d(TAG, "onButtonClick:" + buttonType);
        if (isFromBackPress) {
          finish();
        };
      }
    });
    Log.d(TAG, "showOpenOrInstallAppDialog result:" + result);
    if (result == GDTAppDialogClickListener.NO_DLG) {
      if (isFromBackPress) {
        finish();
      } else {
        Toast.makeText(DemoListActivity.this, "没有可以安装或激活的应用", Toast.LENGTH_SHORT).show();
      }
    }
  }
}

 文档反馈

腾讯公司 版权所有