설명서Analytics스트리밍 미디어 컬렉션 안내서

챕터 매개변수 chapter-parameters

Last update: Fri Oct 04 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 주제:

작성 대상:

  • 사용자
  • 관리자
  • 개발자

이 항목에서는 컨텍스트 데이터 값을 포함하여 Adobe에서 솔루션 변수를 통해 수집하는 챕터 및/또는 세그먼트 데이터의 목록을 제공합니다.

테이블 데이터 설명:

  • 구현: 구현 값 및 요구 사항에 대한 정보

    • 키 - 앱에서 수동으로 설정하거나 Adobe Media SDK에 의해 자동으로 설정된 변수.
    • 필수 - 기본 비디오 추적에 매개변수가 필요한지 여부를 나타냅니다.
    • 유형 - 설정할 변수의 유형을 문자열 또는 숫자로 지정합니다.
    • 전송 시점 - 데이터가 전송되는 시점을 나타냅니다. 미디어 시작 ​은 미디어 시작 시 분석 호출이 전송되고, 광고 시작 ​은 광고 시작 시 분석 호출이 전송됩니다. 닫기 호출은 미디어 세션 종료 시 또는 광고, 챕터 종료 시 하트비트 서버에서 Analytics 서버로 컴파일된 분석 호출이 직접 전송됩니다. 닫기 호출은 네트워크 패킷 호출에 사용할 수 없습니다.
    • 최소. SDK 버전 - 매개변수에 액세스하는 데 필요한 SDK 버전을 나타냅니다.
    • 샘플 값 - 일반적인 변수 사용의 예를 제공합니다.

  • 네트워크 매개변수: Adobe Analytics 또는 하트비트 서버에 전달되는 값을 표시합니다. 이 열에는 Adobe Media SDK에서 생성한 네트워크 호출에 표시되는 매개변수의 이름이 표시됩니다.

  • 보고: 비디오 데이터를 보고 분석하는 방법에 대한 정보입니다.

    • 사용 가능 - 데이터가 기본적으로(예) 보고 시 사용할 수 있는지 아니면 사용자 정의 설정(사용자 정의)을 필요로 하는지 여부를 지정합니다.
    • 예약된 변수 - 데이터가 예약된 변수에 이벤트, eVar, prop 또는 분류로 캡처되는지 여부를 나타냅니다.
    • 보고서 이름 - 변수에 대한 Adobe Analytics 보고서의 이름
    • 컨텍스트 데이터 - 보고 서버에 전달되고 처리 규칙에 사용되는 Adobe Analytics 컨텍스트 데이터의 이름
    • 데이터 피드 - 클릭스트림 또는 라이브 스트림 데이터 피드에 있는 변수의 열 이름
    • Audience Manager - Adobe Audience Manager의 특성 이름
IMPORTANT
보고/예약 변수 아래에 “분류”로 설명되어 있는 변수의 분류 이름을 변경하지 마십시오.
미디어 분류는 보고서 세트가 미디어 추적에 사용될 때 정의됩니다. Adobe는 수시로 새 속성을 추가하며, 이 경우 고객이 보고서 세트를 다시 활성화하여 새로운 미디어 속성에 액세스해야 합니다. 업데이트 프로세스 중에 Adobe는 변수의 이름을 확인하여 분류를 사용할지 여부를 결정합니다. 누락된 항목이 있을 경우 Adobe가 다시 추가합니다.

챕터 메타데이터 chapter-metadata

챕터 이름

구현
네트워크 매개변수
보고
  • SDK 키:
    name
  • API 키:
    media.chapter.friendlyName
  • 필수:
    ​아니요
  • 유형:
    문자열
  • 전송 시점:
    챕터 닫기
  • 최소. SDK 버전: 1.3
  • 샘플 값:
    "The Big Bang Chapter 2 - Dating"
  • 설명:
    ​챕터 및/또는 세그먼트의 이름입니다.
  • Adobe Analytics:
    (a.media.chapter.
    friendlyName)
  • 하트비트:
    (s:stream:chapter_name).
  • 사용 가능:
    ​기본적으로 작성됨…
  • 예약된 변수:
    ​분류
  • 보고서 이름:
    ​챕터 이름
  • 컨텍스트 데이터:
    (a.media.chapter.
    friendlyName)
  • 데이터 피드:
    ​해당 사항 없음
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    friendlyName)
  • XDM 필드 패스:
    media.mediaTimed.mediaChapter.
    chapterAssetReference.dc:title
  • 컬렉션 XDM 필드 패스:
    mediaCollection.chapterDetails.friendlyName
  • 보고 XDM 필드 패스:
    mediaReporting.chapterDetails.friendlyName

챕터 위치

구현
네트워크 매개변수
보고
  • SDK 키:
    position
  • API 키:
    media.chapter.index
  • 필수:
    SDK:아니요. API: 예.
  • 유형:
    ​숫자
  • 전송 시점:
    챕터 닫기
  • 최소. SDK 버전: 1.3
  • 샘플 값:
    2
  • 설명:
    ​콘텐츠 내에서 챕터의 위치(색인, 정수)입니다.
  • Adobe Analytics:
    (a.media.chapter.
    position)
  • 하트비트:
    (l:stream:chapter_pos).
  • 사용 가능:
    ​예
  • 예약된 변수:
    ​분류
  • 보고서 이름:
    ​챕터 위치
  • 컨텍스트 데이터:
    (a.media.chapter.
    position)
  • 데이터 피드:
    ​해당 사항 없음
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    position)
  • XDM 필드 패스:
    media.mediaTimed.mediaChapter.
    chapterAssetViewDetails.index
  • 컬렉션 XDM 필드 패스:
    mediaCollection.chapterDetails.index
  • 보고 XDM 필드 패스:
    mediaReporting.chapterDetails.index

챕터 오프셋

구현
네트워크 매개변수
보고
  • SDK 키:
    startTime
  • API 키:
    media.chapter.offset
  • 필수:
    SDK: 아니요. API: 예.
  • 유형:
    ​숫자
  • 전송 시점:
    챕터 닫기
  • 최소. SDK 버전: 1.3
  • 샘플 값:
    58
  • 설명:
    ​처음부터 콘텐츠 내에 있는 챕터의 오프셋(초)입니다.
  • Adobe Analytics:
    (a.media.chapter.
    offset)
  • 하트비트:
    (l:stream:chapter_offset).
  • 사용 가능:
    ​예
  • 예약된 변수:
    ​분류
  • 보고서 이름:
    ​챕터 오프셋
  • 컨텍스트 데이터:
    (a.media.chapter.
    offset)
  • 데이터 피드:
    ​해당 사항 없음
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    offset)
  • XDM 필드 패스:
    media.mediaTimed.mediaChapter.
    chapterAssetViewDetails.offset
  • 컬렉션 XDM 필드 패스:
    mediaCollection.chapterDetails.offset
  • 보고 XDM 필드 패스:
    mediaReporting.chapterDetails.offset

챕터 길이

구현
네트워크 매개변수
보고
  • SDK 키:
  • API 키:
    media.chapter.length
  • 필수:
    SDK:아니요. API: 예.
  • 유형:
    ​숫자
  • 전송 시점:
    챕터 닫기
  • 최소. SDK 버전: 1.3
  • 샘플 값:
    486
  • 설명:
    ​챕터의 길이(초)입니다.
  • Adobe Analytics:
    (a.media.chapter.
    length)
  • 하트비트:
    (l:stream:chapter_length).
  • 사용 가능:
    ​예
  • 예약된 변수:
    ​분류
  • 보고서 이름:
    ​챕터 길이
  • 컨텍스트 데이터:
    (a.media.chapter.
    length)
  • 데이터 피드:
    ​해당 사항 없음
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    length)
  • XDM 필드 패스:
    media.mediaTimed.mediaChapter.
    chapterAssetReference.xmpDM:duration
  • 컬렉션 XDM 필드 패스:
    mediaCollection.chapterDetails.length
  • 보고 XDM 필드 패스:
    mediaReporting.chapterDetails.length

챕터

구현
네트워크 매개변수
보고
  • SDK 키:
    ​자동으로 설정됨
  • API 키:
    ​해당 사항 없음
  • 필수:
    ​아니요
  • 유형:
    문자열
  • 전송 시점:
    챕터 닫기
  • 최소. SDK 버전: 1.3
  • 샘플 값:
  • 설명:
    ​자동으로 생성된 챕터의 ID입니다.
  • Adobe Analytics:
    (a.media.chapter.
    name)
  • 하트비트:
    (s:stream:chapter_id).
  • 사용 가능:
    ​예
  • 예약된 변수:
    eVar
  • 만료:
    ​히트 시
  • 보고서 이름:
    ​챕터
  • 컨텍스트 데이터:
    (a.media.chapter.
    name)
  • 데이터 피드:
    videochapter
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    name)
  • XDM 필드 패스:
    media.mediaTimed.mediaChapter.
    chapterAssetReference.@ID
  • 보고 XDM 필드 패스:
    mediaReporting.chapterDetails.ID

챕터 지표 chapter-Metrics

챕터 시작

구현
네트워크 매개변수
보고
  • SDK 키:
    ​자동으로 설정됨
  • API 키:
    ​해당 사항 없음
  • 필수:
    ​예
  • 유형:
    문자열
  • 전송 시점:
    챕터 닫기
  • 최소. SDK 버전: 1.3
  • 샘플 값:
    TRUE
  • 설명:
    ​챕터 시작 횟수입니다. 중요: 이 이벤트가 설정된 경우 TRUE 값만 가능합니다. 이 이벤트가 설정되지 않은 경우에는 값이 전송되지 않습니다.
  • Adobe Analytics:
    (a.media.chapter.
    view)
  • 하트비트:
    (s:event:
    type=chapter_start)
  • 사용 가능:
    ​예
  • 예약된 변수:
    ​이벤트
  • 보고서 이름:
    챕터 시작
  • 컨텍스트 데이터:
    (a.media.chapter.
    view)
  • 데이터 피드:
    ​해당 사항 없음
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    view)
  • XDM 필드 패스:
    media.mediaTimed.chapterCount.
    value > 0 => "TRUE"
  • 보고 XDM 필드 패스:
    mediaReporting.chapterDetails.isStarted

챕터 완료

구현
네트워크 매개변수
보고
  • SDK 키:
    ​자동으로 설정됨
  • API 키:
    ​해당 사항 없음
  • 필수:
    ​예
  • 유형:
    문자열
  • 전송 시점:
    챕터 닫기
  • 최소. SDK 버전: 1.3
  • 샘플 값:
    TRUE
  • 설명:
    ​챕터 완료 횟수입니다. 중요: 이 이벤트가 설정된 경우 TRUE 값만 가능합니다. 이 이벤트가 설정되지 않은 경우에는 값이 전송되지 않습니다.
  • Adobe Analytics:
    (a.media.chapter.
    complete)
  • 하트비트:
    (s:event:
    type=chapter_complete)
  • 사용 가능:
    ​예
  • 예약된 변수:
    ​이벤트
  • 보고서 이름:
    챕터 완료
  • 컨텍스트 데이터:
    (a.media.chapter.
    complete)
  • 데이터 피드:
    ​해당 사항 없음
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    complete)
  • XDM 필드 패스:
    media.mediaTimed.mediaChapter.
    completes.value
  • 보고 XDM 필드 패스:
    mediaReporting.chapterDetails.isCompleted

챕터 체류 시간

구현
네트워크 매개변수
보고
  • SDK 키:
    ​자동으로 설정됨
  • API 키:
    ​해당 사항 없음
  • 필수:
    ​예
  • 유형:
    ​숫자
  • 전송 시점:
    챕터 닫기
  • 최소. SDK 버전: 1.3
  • 샘플 값:
  • 설명:
    ​챕터에서 보낸 시간입니다. 값은 시간 형식(HH:MM:SS)으로 표시됩니다.Analysis Workspace )을 참조하십시오. 데이터 피드, Data Warehouse 및 보고 API에서는 값이 초 단위로 표시됩니다.
    릴리스 날짜: 2018년 9월 13일
  • Adobe Analytics:
    (a.media.chapter.
    timePlayed)
  • 하트비트:
  • 사용 가능:
    ​예
  • 예약된 변수:
    ​이벤트
  • 보고서 이름:
    챕터 체류 시간
  • 컨텍스트 데이터:
    (a.media.chapter.
    timePlayed)
  • 데이터 피드:
    ​해당 사항 없음
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    timePlayed)
  • XDM 필드 패스:
    media.mediaTimed.mediaChapter.
    timePlayed.value
  • 보고 XDM 필드 패스:
    mediaReporting.chapterDetails.timePlayed
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb