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);
}