iOS에서 코어 재생 추적 track-core-playback-on-ios

초기 추적 설정

사용자가 재생 의도를 트리거하는 시기(사용자가 재생을 클릭하거나 자동 재생이 켜짐)를 식별하고 MediaObject 인스턴스를 만듭니다.

createMediaObjectWithName API

StreamType상수:

MediaType상수:

MediaObject를 작성하는 데 필요한 일반적인 형식:

ADBMediaObject *mediaObject =
  [ADBMediaHeartbeat createMediaObjectWithName:<MEDIA_NAME>
                                       mediaId:<MEDIA_ID>
                                        length:<MEDIA_LENGTH>
                                    streamType:<STREAM_TYPE>
                                     mediaType: <MEDIA_TYPE>];

비디오 메타데이터 첨부

필요한 경우 컨텍스트 데이터 변수를 통해 표준 및/또는 사용자 지정 비디오 메타데이터 개체를 비디오 추적 세션에 첨부합니다.

• 표준 비디오 메타데이터

  • iOS에서 표준 메타데이터 구현

  • 비디오 메타데이터 키
    iOS 메타데이터 키

  • 오디오 및 비디오 매개 변수에서 비디오 메타데이터에 대한 종합 목록을 참조하십시오.

  note note
  NOTE
  표준 비디오 메타데이터 개체를 미디어 개체에 첨부하는 것은 선택 사항입니다.

• 사용자 지정 메타데이터

  사용자 지정 변수에 대한 변수 개체를 만들고, 이 비디오의 데이터로 채웁니다. 예:

  code language-none
  NSMutableDictionary *videoMetadata = [[NSMutableDictionary alloc] init]; [videoMetadata setObject:@"false" forKey:@"isUserLoggedIn"]; [videoMetadata setObject:@"Sample TV station" forKey:@"tvStation"];

재생을 시작하려는 의도 추적

미디어 세션 추적을 시작하려면 미디어 하트비트 인스턴스에서 trackSessionStart를 호출합니다.

- (void)onMainVideoLoaded:(NSNotification *)notification {
//    [_mediaHeartbeat trackSessionStart:mediaObject data:nil];
    [_mediaHeartbeat trackSessionStart:mediaObject data:videoMetadata];
}

실제 재생 시작 추적

비디오 플레이어에서 비디오의 첫 번째 프레임이 화면에서 렌더링되는 비디오 재생 시작에 대한 이벤트를 식별하고, trackPlay()를 호출합니다.

- (void)onVideoPlay:(NSNotification *)notification {
    [_mediaHeartbeat trackPlay];
}

재생 완료 추적

비디오 플레이어에서 사용자가 콘텐츠의 끝까지 시청한 비디오 재생 완료에 대한 이벤트를 식별하고, trackComplete()를 호출합니다.

- (void)onVideoComplete:(NSNotification *)notification {
    [_mediaHeartbeat trackComplete];
}

세션의 끝 추적

비디오 플레이어에서 사용자가 비디오를 닫거나 비디오가 완료 및 업로드된 비디오 재생 업로드/종료에 대한 이벤트를 식별하고, trackSessionEnd()를 호출합니다.

- void)onMainVideoUnloaded:(NSNotification *)notification {
    [_mediaHeartbeat trackSessionEnd];
}

가능한 모든 일시 중지 시나리오 추적

비디오 플레이어에서 비디오 일시 중지에 대한 이벤트를 식별하고 trackPause를 호출합니다.

- (void)onVideoPause:(NSNotification *)notification {
    [_mediaHeartbeat trackPause];
}

시나리오 일시 정지

비디오 플레이어에서 일시 정지할 시나리오를 식별하고 trackPause가 제대로 호출되는지 확인하십시오. 다음 시나리오에서는 모두 앱 호출 trackPause()가 필요합니다.

• 사용자가 앱에서 일시 정지를 명시적으로 실행합니다.
• 플레이어가 일시 정지 상태로 전환됩니다.
• (모바일 앱) - 백그라운드로 전환된 애플리케이션의 세션을 열어 두려고 합니다.
• (모바일 앱) - 애플리케이션을 백그라운드로 전환하는 시스템 인터럽트 유형이 발생합니다. 예를 들어 사용자가 호출을 받거나 다른 애플리케이션에서 팝업이 발생하지만 애플리케이션이 중단 지점에서 사용자가 비디오를 재개할 수 있도록 세션을 라이브로 유지할 수 있습니다.

플레이어에서 비디오 재생 및/또는 일시 정지에서 비디오 재개에 대한 이벤트를 식별하고 trackPlay를 호출합니다.

- (void)onVideoPlay:(NSNotification *)notification {
    [_mediaHeartbeat trackPlay];
}