更新记录

1.0.1(2021-08-05)

新增facebook隐私政策.


平台兼容性

Android Android CPU类型 iOS
适用版本区间:5.0 - 11.0 armeabi-v7a:支持,arm64-v8a:支持,x86:支持 ×

原生插件通用使用流程:

  1. 购买插件,选择该插件绑定的项目。
  2. 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
  3. 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
  4. 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
  5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项:使用HBuilderX2.7.14以下版本,如果同一插件且同一appid下购买并绑定了多个包名,提交云打包界面提示包名绑定不一致时,需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择


Facebook广告插件使用说明文档

一、插件集成

请参考云端插件集成文档


二、集成说明文档

  • 注意:组件(component)的引用必须是基于nvue的页面,moudle的引用可以使用vue进行调用!

    Banner广告:

    调用:

    <sunny-facebookadsMobileADBannerAd style="width:750rpx;height:90px;background-color: #555555;margin-top: 10upx;"  adUnitID="517600929352975_517623196017415" adSize="LargeBanner" ></sunny-facebookadsMobileADBannerAd>

组件形式调用:

广告尺寸的设置adSize有四种模式: 不设置默认是50px高度,支持的尺寸有如下几种

  • StandardBanner 50px
  • LargeBanner 90px
  • MediumRectangle 250px

其他参数:

  • adUnitID 广告ID

原生广告的使用:

<sunny-facebookadsNativeMobileAD style="width:750rpx;background-color: #555555;margin-top: 10upx;height: 280upx;"  adUnitID="550575559455306_551159226063606" ></sunny-facebookadsNativeMobileAD>

其他参数:

  • adUnitID 广告ID

原生横幅

  <sunny-facebookadsNativeBannerMobileAd style="width:750rpx;background-color: #555555;margin-top: 10upx;height: 200upx;"  adUnitID="550575559455306_551170216062507" ></sunny-facebookadsNativeBannerMobileAd>

其他参数:

  • adUnitID 广告ID

插屏广告的使用:

</template>
   </div>
    <button  type="default" @click="showInterstitialAd()">插屏广告</button>
   </div>
</template>

var facebookInterstitialAd = uni.requireNativePlugin('sunny-facebookadsInterstitialAd');

        showInterstitialAd(){
            facebookInterstitialAd.showInterstitialAd("550575559455306_551143862731809",res=>{
                console.log(JSON.stringify(res));
                uni.showToast({
                    icon:'none',
                    title:res.data
                })
            })
        },

插屏广告的所有事件:

插屏广告所有事件统一通过一个callback回调String回来,

  • onInterstitialDisplayed // Interstitial ad displayed callback
  • onInterstitialDismissed // Interstitial dismissed callback
  • adError // Ad error callback
  • onAdLoaded //Interstitial ad is loaded and ready to be displayed
  • onAdClicked // Ad clicked callback
  • onLoggingImpression // Ad impression logged callback

激励广告的使用:

</template>
   </div>
        <button type="default" @click="showInterstitialRewardedAd()">激励视频</button>
   </div>
</template>

    var facebookInterstitialRewardedAd = uni.requireNativePlugin('sunny-facebookadsInterstitialRewardedAd');

        facebookInterstitialRewardedAd.showInterstitialRewardedAd("550575559455306_551178079395054",res=>{
            uni.showToast({
                icon:'none',
                title:res.data
            })
        });

激励广告的所有事件:

激励广告所有事件统一通过一个callback回调String回来,

  • onError // Rewarded video ad failed to load
  • onAdLoaded // Rewarded video ad is loaded and ready to be displayed
  • onAdClicked // Rewarded video ad clicked
  • onLoggingImpression // Rewarded Video ad impression - the event will fire when the video starts playing
  • onRewardedVideoCompleted // Rewarded Video View Complete - the video has been played to the end.You can use this event to initialize your reward
  • onRewardedVideoClosed // The Rewarded Video ad was closed - this can occur during the video by closing the app, or closing the end card.

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

facebook广告sdk 可能会采集用户数据, 具体参考facebook相关隐私政策:https://opensource.fb.com/legal/privacy/

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问