在 Android 中跟踪广告 track-ads-on-android

识别广告时间（包括前置广告）边界开始的时间，然后使用广告时间信息创建 AdBreakObject。

AdBreakObject 引用：

广告时间对象创建：

MediaObject adBreakInfo =
  MediaHeartbeat.createAdBreakObject(<ADBREAK_NAME>,
                                     <POSITION>,
                                     <START_TIME>);

在 MediaHeartbeat 实例中使用 AdBreakStart 调用 trackEvent()，以开始跟踪广告时间：

public void onAdBreakStart(Observable observable, Object data) {
    _heartbeat.trackEvent(MediaHeartbeat.Event.AdBreakStart,
                          adBreakInfo,
                          null);
}

识别广告的开始时间，然后使用广告信息创建 AdObject 实例。

AdObject 引用：

广告对象创建：

MediaObject adInfo =
  MediaHeartbeat.createAdObject(<AD_NAME>
                                <AD_ID>,
                                <POSITION>,
                                <LENGTH>);

（可选）通过上下文数据变量将标准和/或广告元数据附加到媒体跟踪会话。

• 在 Android 中实施标准广告元数据

help/use-cases/track-ads/impl-std-ad-metadata/impl-std-ad-metadata-android.md

• 自定义广告元数据 – 对于自定义元数据，请为自定义数据变量创建变量对象，然后使用当前广告的数据进行填充：

  code language-java
  // Setting Ad Metadata HashMap<String, String> adMetadata = new HashMap<String, String>(); adMetadata.put("affiliate", "Sample affiliate"); adMetadata.put("campaign", "Sample ad campaign");

在 MediaHeartbeat 实例中使用 AdStart 事件调用 trackEvent()，以开始跟踪广告播放。

在事件调用中添加对自定义元数据变量（或空对象）的引用，以将其作为第三个参数：

public void onAdStart(Observable observable, Object data) {
    _heartbeat.trackEvent(MediaHeartbeat.Event.AdStart,
                          adInfo,
                          adMetadata);
}

当广告播放到达广告结尾时，使用 AdComplete 事件调用 trackEvent()：

public void onAdComplete(Observable observable, Object data) {
    _heartbeat.trackEvent(MediaHeartbeat.Event.AdComplete, null, null);
}

如果由于用户选择跳过广告而使广告播放未能完成，则跟踪 AdSkip 事件：

public void onAdSkip(Observable observable, Object data) {
    _heartbeat.trackEvent(MediaHeartbeat.Event.AdSkip, null, null);
}

如果同一个 AdBreak 中存在任何其他广告，请重复执行步骤 3 至 7。

当广告时间结束时，使用 AdBreakComplete 事件进行跟踪：

public void onAdBreakComplete(Observable observable, Object data) {
    _heartbeat.trackEvent(MediaHeartbeat.Event.AdBreakComplete, null, null);
}