信息流/详情页插入/视频贴片/沉浸式视频流 广告

简介

信息流广告/详情页插入广告/视频贴片/沉浸式视频流广告，都可使用优量汇提供的接入文档进行广告接入

权限等级：开放

适用场景：优量汇为您提供了多种的广告模板样式，在新建广告位时支持只出图文广告或只出视频广告，也支持图文和视频广告混出。为保证广告位填充率，建议尽量选择图文和视频广告混出。如样式满足您的诉求，您可直接使用展示

分类：广告具体布局，可参考下方图片：

上图下文	上文下图	双图双文	三小图双文

左图右文	左文右图	横版纯图片	竖版纯图片

单图单文（文字浮层）	上文下图（文字浮层）	上图下文（文字浮层）	沉浸式视频流

自定义模板调参标准如下：

注意：以下接入代码示例只适用于上述广告位。误用其他广告位 ID 使用该接口，则会导致无广告返回。

主要 API

NativeExpressAD

• com.qq.e.ads.nativ.NativeExpressAD:
  平台模板广告入口，用于初始化并加载广告数据。

NativeExpressADListener

• com.qq.e.ads.nativ.NativeExpressAD.NativeExpressADListener：
  平台模板广告加载、渲染、点击状态的回调。

NativeExpressMediaListener

• com.qq.e.ads.nativ.NativeExpressMediaListener
  平台模板视频广告播放状态回调接口，专用于带有视频素材的广告对象

NativeExpressADView

• com.qq.e.ads.nativ.NativeExpressADView:
  用于展示平台模板广告的 View，可以被动态添加在开发者的布局中（注意：NativeExpressADView 不可以在 XML 中静态写入，也不可以由开发者手动创建，只可以由 SDK 返回）。

AdData

• com.qq.e.comm.pi.AdData
  广告数据接口

VideoPlayer

• com.qq.e.comm.pi.AdData.VideoPlayer
  播放器接口

接入注意事项

如果您的平台模板广告位支持视频，您会在新建广告位时在广告素材栏看到视频选项。您需要注意以下几点：

1. 您可以按需进行视频广告播放的个性化配置。
2. 您需要处理好 Activity 的运行时变更，由于视频广告可以跟随手机屏幕的方向旋转和全屏播放，请处理好 Activity 的运行时变更（最简单的方式就是在 AndroidManifest 文件中给您的 Activity 加上 android:configChanges="keyboard|keyboardHidden|orientation|screenSize" 属性），不要让播放视频广告的 Activity 被销毁重建，具体代码可以参考 GDTUnionDemo。
3. 如果广告位支持视频广告，强烈建议在拉取广告前，调用setVideoOption设置视频广告的播放策略，有助于提高eCPM

接入代码示例

  // 仅展示部分代码，完整代码请参考 GDTUnionDemo 工程
  // 1.加载广告，先设置加载上下文环境和条件
  private void refreshAd() {
    nativeExpressAD = new NativeExpressAD(this, new ADSize(340, ADSize.AUTO_HEIGHT), Constants.NativeExpressPosID, this); // 传入Activity
    // 注意：如果您在平台上新建平台模板广告位时，选择了支持视频，那么可以进行个性化设置（可选）
    nativeExpressAD.setVideoOption(new VideoOption.Builder()
      .setAutoPlayPolicy(VideoOption.AutoPlayPolicy.WIFI) // WIFI 环境下可以自动播放视频
      .setAutoPlayMuted(true) // 自动播放时为静音
      .build()); //
    nativeExpressAD.loadAD(1);
  }

  // 2.设置监听器，监听广告状态
  @Override
  public void onNoAD(AdError error) {
    Log.i("AD_DEMO", String.format("onADError, error code: %d, error msg: %s", error.getErrorCode(), error.getErrorMsg()));
  }

  @Override
  public void onADLoaded(List<NativeExpressADView> adList) {
    Log.i(TAG, "onADLoaded: " + adList.size());
    // 释放前一个 NativeExpressADView 的资源
    if (nativeExpressADView != null) {
      nativeExpressADView.destroy();
    }
    // 3.返回数据后，SDK 会返回可以用于展示 NativeExpressADView 列表
    nativeExpressADView = adList.get(0);
    if (nativeExpressADView.getBoundData().getAdPatternType() == AdPatternType.NATIVE_VIDEO) {
      nativeExpressADView.setMediaListener(mediaListener);
    }
    nativeExpressADView.render();
    if (container.getChildCount() > 0) {
      container.removeAllViews();
    }

    // 需要保证 View 被绘制的时候是可见的，否则将无法产生曝光和收益。
    container.addView(nativeExpressADView);
  }

  @Override
  public void onRenderFail(NativeExpressADView adView) {
    Log.i(TAG, "onRenderFail");
  }

  @Override
  public void onRenderSuccess(NativeExpressADView adView) {
    Log.i(TAG, "onRenderSuccess");
  }

  @Override
  public void onADExposure(NativeExpressADView adView) {
    Log.i(TAG, "onADExposure");
  }

  @Override
  public void onADClicked(NativeExpressADView adView) {
    Log.i(TAG, "onADClicked");
  }

  @Override
  public void onADClosed(NativeExpressADView adView) {
    Log.i(TAG, "onADClosed");
  }

  @Override
  public void onADLeftApplication(NativeExpressADView adView) {
    Log.i(TAG, "onADLeftApplication");
  }

  @Override
  public void onADOpenOverlay(NativeExpressADView adView) {
    Log.i(TAG, "onADOpenOverlay");
  }

  @Override
  public void onADCloseOverlay(NativeExpressADView adView) {
    Log.i(TAG, "onADCloseOverlay");
 }

  @Override
  protected void onDestroy() {
    super.onDestroy();
    // 4.使用完了每一个 NativeExpressADView 之后都要释放掉资源
    if (nativeExpressADView != null) {
      nativeExpressADView.destroy();
    }
  }

private NativeExpressMediaListener mediaListener = new NativeExpressMediaListener() {
@Override
public void onVideoInit(NativeExpressADView nativeExpressADView) {
  Log.i(TAG, "onVideoInit: "
      + getVideoInfo(nativeExpressADView.getBoundData().getProperty(AdData.VideoPlayer.class)));
}

@Override
public void onVideoLoading(NativeExpressADView nativeExpressADView) {
  Log.i(TAG, "onVideoLoading");
}

@Override
public void onVideoReady(NativeExpressADView nativeExpressADView, long l) {
  Log.i(TAG, "onVideoReady");
}

@Override
public void onVideoStart(NativeExpressADView nativeExpressADView) {
  Log.i(TAG, "onVideoStart: "
      + getVideoInfo(nativeExpressADView.getBoundData().getProperty(AdData.VideoPlayer.class)));
}

@Override
public void onVideoPause(NativeExpressADView nativeExpressADView) {
  Log.i(TAG, "onVideoPause: "
      + getVideoInfo(nativeExpressADView.getBoundData().getProperty(AdData.VideoPlayer.class)));
}

@Override
public void onVideoComplete(NativeExpressADView nativeExpressADView) {
  Log.i(TAG, "onVideoComplete: "
      + getVideoInfo(nativeExpressADView.getBoundData().getProperty(AdData.VideoPlayer.class)));
}

@Override
public void onVideoError(NativeExpressADView nativeExpressADView, AdError adError) {
  Log.i(TAG, "onVideoError");
}

@Override
public void onVideoPageOpen(NativeExpressADView nativeExpressADView) {
  Log.i(TAG, "onVideoPageOpen");
}

@Override
public void onVideoPageClose(NativeExpressADView nativeExpressADView) {
  Log.i(TAG, "onVideoPageClose");
}
};