uniapp 如何接入穿山甲广告SDK

在uniapp项目中接入穿山甲广告SDK时遇到困难，具体步骤如下：

  1. 如何在uniapp中引入穿山甲SDK的依赖？
  2. 是否需要单独配置Android和iOS的原生配置？
  3. 如何正确初始化SDK并获取广告位ID？
  4. 在uniapp中调用激励视频、插屏广告等广告形式的示例代码是什么？
  5. 调试时出现广告加载失败或无法展示的问题，可能是什么原因导致的？

希望有经验的朋友能分享一下具体的实现步骤或提供demo参考，谢谢！

2 回复

在uniapp中接入穿山甲广告SDK，需先安装官方插件，配置广告位ID。然后在页面引入广告组件，调用相关API展示广告。注意配置隐私权限和测试模式。


在 UniApp 中接入穿山甲广告 SDK，需通过自定义基座方式集成 Android/iOS 原生插件。以下是详细步骤：

一、准备工作

  1. 注册穿山甲开发者账号
    访问穿山甲官网注册账号，创建应用和广告位，获取 App ID 和 代码位 ID。

  2. 安装 HBuilderX
    确保使用最新版 HBuilderX（支持原生插件配置）。

二、Android 平台接入步骤

1. 获取穿山甲 SDK

  • 从穿山甲官网下载 Android 版 SDK（AAR 文件）。

2. 创建 UniApp 原生插件

  • 在 UniApp 项目中创建 nativeplugins 目录，结构如下：

    nativeplugins/
└── Pangle-Android/
    ├── android
    │   ├── libs
    │   │   └── open_ad_sdk.aar  // 穿山甲 SDK 文件
    │   └── AndroidManifest.xml  // 配置权限和组件
    └── package.json             // 插件配置文件

  • package.json 内容：

    {
  "name": "Pangle-Android",
  "id": "Pangle-Android",
  "version": "1.0.0",
  "description": "穿山甲广告插件",
  "_dp_type": "nativeplugin",
  "_dp_nativeplugin": {
    "android": {
      "integrateType": "aar",
      "plugins": [
        {
          "type": "module",
          "name": "Pangle-Android",
          "class": "com.bytedance.sdk.openadsdk.TTAdSdk"
        }
      ]
    }
  }
}

  • AndroidManifest.xml 配置（添加权限和 Activity）：

    <!-- 必要权限 -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

<!-- 穿山甲广告 Activity -->
<activity
  android:name="com.bytedance.sdk.openadsdk.activity.TTDelegateActivity"
  android:configChanges="orientation|keyboardHidden|screenSize" />

3. 注册插件

  • 在 HBuilderX 中：manifest.json → App原生插件配置 → 选择本地插件 → 勾选 Pangle-Android。

4. 制作自定义基座

  • 运行菜单选择 “制作自定义基座”，打包后用于调试。

三、UniApp 中调用广告

1. 初始化 SDK

在 App.vue 的 onLaunch 中初始化：

// #ifdef APP-PLUS
const pangle = uni.requireNativePlugin('Pangle-Android');
pangle.initSDK({
  appId: '你的穿山甲 App ID', // 从后台获取
  debug: true // 测试模式
});
// #endif

2. 展示激励视频广告

export default {
  methods: {
    showRewardedVideo() {
      const pangle = uni.requireNativePlugin('Pangle-Android');
      pangle.showRewardedVideo({
        codeId: '你的激励视频代码位 ID',
        orientation: 'vertical' // 竖屏方向
      }, (res) => {
        if (res.code === 1000) {
          console.log('广告奖励生效');
        } else {
          console.log('广告未完成', res.msg);
        }
      });
    }
  }
}

四、iOS 平台配置（类似步骤）

  1. 下载 iOS SDK（.framework 文件）。
  2. 创建 iOS 原生插件目录，将 SDK 放入 ios 文件夹。
  3. 在 package.json 中配置 iOS 模块。
  4. 初始化及调用方式与 Android 一致。

注意事项

  1. 自定义基座限制：调试必须使用自定义基座，正式云打包需在 manifest 中勾选插件。
  2. 广告位审核：确保穿山甲后台广告位审核通过，否则无法加载。
  3. 隐私合规：初始化前需获取用户同意，参考穿山甲合规指南。

通过以上步骤即可在 UniApp 中集成穿山甲广告。具体广告形式（开屏、信息流等）需根据穿山甲文档调整调用方法。

回到顶部