集成插屏广告

David Kim

2024年09月17日 17:35

请先根据文档 basic integration article集成，再进行ad format部分集成.

插屏广告属于全屏广告。一般在关卡过渡，应用开始等节点出现。

创建并加载插屏广告

import com.vungle.ads.InterstitialAd
  private var interstitialAd: InterstitialAd? = null
  interstitialAd = InterstitialAd(requireContext(), placementId, AdConfig().apply {
  }).apply {
   adListener = this@InterstitialFragment
   load()
  }

import com.vungle.ads.InterstitialAd
  private InterstitialAd interstitialAd;
  interstitialAd = new InterstitialAd(requireContext(), placementId, new AdConfig());
  interstitialAd.setAdListener(this);
  interstitialAd.load(null);

播放插屏广告

当插屏广告缓存好后，您就可以调用以下代码来进行播放了：

if (interstitialAd?.canPlayAd() == true) {
   interstitialAd?.play()
  }

if (interstitialAd != null && interstitialAd.canPlayAd()) {
     interstitialAd.play();
  }

当插屏广告展示出来后，您就可以监听广告的整个声明周期(详情请查看 Register for Callbacks )。
广告会在用户点击关闭按钮时，自动关闭。无需用户再额外控制。

Register for Callbacks

您可以通过添加并实现 InterstitialAdListener来获取回调事件。

override fun onAdLoaded(baseAd: BaseAd) {
  Log.d(TAG, "Creative id:" + baseAd.creativeId)
  }
  
  
  override fun onAdStart(baseAd: BaseAd) {
  }
  
  
  override fun onAdImpression(baseAd: BaseAd) {
  }
  
  
  override fun onAdEnd(baseAd: BaseAd) {
  }
  
  
  override fun onAdClicked(baseAd: BaseAd) {
  }
  
  
  override fun onAdLeftApplication(baseAd: BaseAd) {
  }
  
  
  override fun onAdFailedToLoad(baseAd: BaseAd, adError: VungleError) {
  }
  
  
  override fun onAdFailedToPlay(baseAd: BaseAd, adError: VungleError) {
  }

@Override
  public void onAdClicked(@NonNull BaseAd baseAd) {
  }
  
  
  @Override
  public void onAdEnd(@NonNull BaseAd baseAd) {
  }
  
  
  @Override
  public void onAdFailedToLoad(@NonNull BaseAd baseAd, @NonNull VungleError vungleError) {
  }
  
  
  @Override
  public void onAdFailedToPlay(@NonNull BaseAd baseAd, @NonNull VungleError vungleError) {
  }
  
  
  @Override
  public void onAdImpression(@NonNull BaseAd baseAd) {
  }
  
  
  @Override
  public void onAdLeftApplication(@NonNull BaseAd baseAd) {
  }
  
  
  @Override
  public void onAdLoaded(@NonNull BaseAd baseAd) {
  Log.d(TAG, "Creative id:" + baseAd.getCreativeId());
  }
  
  
  @Override
  public void onAdStart(@NonNull BaseAd baseAd) {
  }

以下列出了AdConfig中所有选项：

选项	说明
`setAdOrientation`	`AdConfig.AUTO_ROTATE`: 广告将自动旋转适配方向 `AdConfig.LANDSCAPE`: 强制广告横屏 `AdConfig.PORTRAIT`: 强制广告竖屏
`setBackButtonImmediatelyEnabled`	设置是否安卓设备物理返回键可用。当为true时，则在广告播放开始时，即可用。当为false时，则需要在广告出现关闭按钮时，可用（默认为false）。
`setWatermark`	展示水印。一般该方法会由mediation来调用。

测试插屏广告

您可以通过两种方式测试插屏广告：将您的应用在dashboard中设置为测试模式；将您的设备gaid添加到dashboard的测试设备中，并使用该设备测试。请查看该文档 Test Your Integration: Test Mode and Test Devices来进一步了解。

创建并加载插屏广告

播放插屏广告

Register for Callbacks

测试插屏广告

Questions?