ZJSDK

应用内竞价

应用内竞价

说明

ZJSDK提供应用内竞价功能，当您使用ZJSDK进行实时竞价时，需要将竞价的结果调用相应接口回传。

当前版本仅支持激励广告&插全屏广告。

获取价格

在预加载方法调用后 action 为ZJEventAction.onAdLoaded的回调时，可以通过ret.code参数获取当前预加载广告的实时价格并进行比价。

注意

  • 获取价格需要联系商务开通权限，默认返回价格为0

  • 仅预加载广告且需要进行比价时，才需要调用以下借口回传竞价信息。若仅为预加载，并不与外部其他广告源进行比价，不要调用回传接口回传错误的竞价信息

  • 错误的竞价信息会影响广告收益，请如实填写尽可能多的内容

回传竞胜

ZJSDK返回的广告对象竞胜后展示前，需要根据请求的广告类型调用onRewardVideoBidSuccess或onInterstitialAdBidSuccess方法，回传竞败方最高出价的相关信息

方法及参数说明

class ZJAndroid {
  /// 通知SDK激励广告竞胜
  static void onRewardVideoBidSuccess(
    /// 竞败方最高价
    int secondECPM, {
    /// 竞败方出价类型
    /// 1-分层保价
    /// 2-固定价格
    /// 3-实时竞价
    /// 4-其他
    int secondType = 0,

    /// 竞败方最高价的AdnID
    BidAdnId secondAdnId = BidAdnId.OTHER,
  })
}

回传竞败

ZJSDK返回的广告对象竞败后，需要根据请求的广告类型调用onRewardVideoBidFailed或onInterstitialAdBidFailed方法，回传竞胜方的相关信息

方法及参数说明

class ZJAndroid {
  /// 插全屏广告广告竞败后，上报失败原因
  static void onInterstitialAdBidFailed(
    /// 竞价失败原因码
    BidFailedReasonCode reasonCode,

    /// 竞胜方出价
    int firstECPM, {
    /// 竞胜方出价类型
    /// 1-分层保价
    /// 2-固定价格
    /// 3-实时竞价
    /// 4-其他
    int bidType = 0,

    /// 竞胜方的AdnID
    BidAdnId firstAdnId = BidAdnId.OTHER,

    /// 竞胜方广告主名称
    String adUserName = "",

    /// 竞胜方广告标题
    String adTitle = "",

    /// 竞胜方物料类型
    BidMaterialType adnMaterialType =
        BidMaterialType.REPORT_MATERIAL_TYPE_OTHER,

    /// 竞胜方物料URL
    String adnMaterialUrl = "",

    /// 是否已展示
    bool isShow = false,

    /// 是否已点击
    bool isClick = false,

    /// 竞价发生的时间戳，单位毫秒
    int ts = 0,
  })
}

枚举值说明

BidAdnId

/// 竞价回传时的ADN_ID枚举
enum BidAdnId {
  /// ZJSDK
  ZJ,

  /// 穿山甲/头条广告
  PANGLE,

  /// 优量汇/广点通/腾讯广告
  GDT,

  /// 百度联盟/百青藤
  BD,

  /// Mintegral
  MINTEGRAL,

  /// 快手联盟
  KS,

  /// 阿里Tanx
  TANX,

  /// 趣盟/趣头条
  QM,

  /// Sigmob
  SIGMOB,

  /// 其他
  OTHER;
}

BidFailedReasonCode

/// 竞价失败原因码
enum BidFailedReasonCode {
  /// 价格低于媒体侧底价
  BID_FLOOR,

  /// 竞价失败
  LOW_PRICE,

  /// 请求超时
  TIMEOUT,

  /// 主动屏蔽（物料原因、竞品、频控）
  BLOCK,

  /// 其他原因
  OTHER;
}

BidMaterialType

/// 竞价广告的素材类型
enum BidMaterialType {
  /// 横版图片
  REPORT_MATERIAL_TYPE_IMG_HORIZONTAL,

  /// 竖版图片
  REPORT_MATERIAL_TYPE_IMG_VERTICAL,

  /// 组图
  REPORT_MATERIAL_TYPE_IMG_GROUP,

  /// 横版视频
  REPORT_MATERIAL_TYPE_VIDEO_HORIZONTAL,

  /// 竖版视频
  REPORT_MATERIAL_TYPE_VIDEO_VERTICAL,

  /// 直播
  REPORT_MATERIAL_TYPE_STREAMING,

  /// 横幅
  REPORT_MATERIAL_TYPE_BANNER,

  /// 未知
  REPORT_MATERIAL_TYPE_OTHER;
}
目录