Display类型曝光接口, 当APP中某广告需要进行曝光监测时, 由APP调用该接口. 如传递adView则包含可见曝光监测功能, 若不需监测可见曝光需传递“null”.

public static long adTrackDisplay(Context context, String trackingURL, View adView)

Parameters

context
    参见Context

trackingURL
    广告对应的曝光监测代码

adView
    可见曝光监测时传入广告视图对象, 用来计算广告曝光面积和持续曝光时间. 普通曝光监测时传null.

Return

    可见曝光监测活动的id, 需要APP保存变量, 并在广告结束时作为调用adTrackStop接口的参数停止对广告的可见曝光监测. 普通曝光监测返回0, 无需处理.

Discussion

    trackingURL来源: 广告开始投放前, 由秒针为广告主需要监测的广告分配对应的曝光监测代码. 媒体需要将监测代码录入到其投放系统中并与广告保持一一对应的关系. 投放系统在响应APP发送的投放请求时, 不仅需要返回广告创意本身, 还需返回与广告对应的曝光监测代码. APP从中解析出广告以及对应监测代码, 并在后续相应广告曝光行为产生时调用adTrackDisplay接口, 将监测代码当作参数传给该接口.

    adview来源: 媒体投放系统在响应APP发送的投放请求时, 返回广告创意本身, APP需要将广告 对象所在的view作为参数传给该接口.

Related Sample Code

long trackId = 0;
HttpURLConnection connection = null;
try {
    trackId = MZMonitor.adTrackDisplay(context, trackingURL, adView);
} catch (Exception e) {
    Log.e("unhandled exception happened");

    URL url = new URL(trackingURL);
    connection = (HttpURLConnection) url.openConnection();
    if (connection != null) {
        connection.setUseCaches(false);
        connection.setInstanceFollowRedirects(true);
        connection.connect();
    }
} finally {
    if (connection != null) {
        connection.disconnect();
        connection = null;
    }
}

WARN:
    为防止运行时因未知异常抛错, 建议媒体在调用第三方SDK接口时进行保护性异常捕获. 出现异常时, 可通过非SDK的方式将监测请求发出. 这样既能防止抛错而导致APP崩溃, 同时也能避免因该问题而引发的数据GAP

Video类型曝光接口, 当APP中视频广告需要进行曝光监测时, 由APP在视频开始播放时调用该接口. 如传递adView则包含可见曝光监测功能，若不需监测可见曝光需传递“null”.

public static long adTrackVideo(Context context, String trackingURL, View adView, int playType)

Parameters

context
    参见Context

trackingURL
    广告对应的曝光监测代码

adView
    可见曝光监测时传入广告视图对象, 用来计算广告曝光面积和持续曝光时间. 普通曝光监测时传null.

playType
    视频播放类型, 1-自动播放, 2-手动播放, 0-无法识别.

Return

    可见曝光的监测id, 需要APP保存变量, 并在广告结束时作为调用adTrackStop接口的参数停止对广告的可见曝光监测. 普通曝光监测返回0, 无需处理.

Discussion

    trackingURL来源: 广告开始投放前, 由秒针为广告主需要监测的广告分配对应的曝光监测代码. 媒体需要将监测代码录入到其投放系统中并与广告保持一一对应的关系. 投放系统在响应APP发送的投放请求时, 不仅需要返回广告创意本身, 还需返回与广告对应的曝光监测代码. APP从中解析出广告以及对应监测代码, 并在后续相应广告曝光行为产生时调用adTrackVideo接口, 将监测代码当作参数传给该接口.

    adview来源: 媒体投放系统在响应APP发送的投放请求时, 返回广告创意本身, APP需要将广告对象所在的view作为参数传给该接口.

Related Sample Code

long trackId = 0;
HttpURLConnection connection = null;
try {
    int videoPlayType = 1;
    trackId = MZMonitor.adTrackVideo(context, trackingURL, adView, videoPlayType);
} catch (Exception e) {
    Log.e("unhandled exception happened");

    URL url = new URL(trackingURL);
    connection = (HttpURLConnection) url.openConnection();
    if (connection != null) {
        connection.setUseCaches(false);
        connection.setInstanceFollowRedirects(true);
        connection.connect();
    }
} finally {
    if (connection != null) {
        connection.disconnect();
        connection = null;
    }
}

WARN:
    为防止运行时因未知异常抛错, 建议媒体在调用第三方SDK接口时进行保护性异常捕获. 出现异常时, 可通过非SDK的方式将监测请求发出. 这样既能防止抛错而导致APP崩溃, 同时也能避免因该问题而引发的数据GAP

display或video广告结束时停止可见曝光监测的接口. 用于手动停止可见曝光的监测, 例如当视频贴片广告已经播放完毕或切换到其他广告, 应调用此接口停止对可见曝光状态的监听. 普通曝光或点击不需调用该接口.

public static void adTrackStop(long trackId)

Parameters

trackId
    接口adTrackDisplay或adTrackVideo的返回值, 表示可见曝光监测活动的id.

Discussion

    可见曝光监测时需要调用, 普通曝光或点击监测时不需要.

Related Sample Code

MZMonitor.adTrackStop(trackId);

旧版遗留接口, 仅支持非可见曝光和点击的监测. 建议曝光优先使用adTrackDisplay和adTrackVideo接口, 等同于adTrackDisplay(context, trackingURL, null) 或adTrackVideo(context, trackingURL, null, 0), 点击使用adTrackClick接口.

public static void adTrack(Context context, String trackingURL)

Parameters

context
    参见Context

trackingURL
    广告对应的曝光或点击监测代码

重试缓存的监测请求.

public static void retryCachedRequests(Context context)

Parameters

context
    参见Context

Discussion

    SDK在网络状况不好或断网情况下会缓存发送失败的监测请求, 缓存的监测请求数据需要由APP主动调用该接口才会完成重试发送, SDK本身并不会主动尝试重发.

Related Sample Code

try {
    MZMonitor.retryCachedRequests(context);
} catch (Exception e) {
    Log.e("unhandled exception happened");
}

当前SDK版本

public static void version()