설명서AEM 6.4관리 안내서

Adobe Analytics를 위한 비디오 추적 구성 configuring-video-tracking-for-adobe-analytics

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • Admin
CAUTION
AEM 6.4가 확장 지원이 종료되었으며 이 설명서는 더 이상 업데이트되지 않습니다. 자세한 내용은 기술 지원 기간. 지원되는 버전 찾기 여기.

비디오 이벤트를 추적하는 데 사용할 수 있는 방법에는 몇 가지가 있으며, 그 중 2가지는 이전 버전의 Adobe Analytics에 대한 레거시 옵션입니다. 이러한 기존 옵션은 다음과 같습니다. 이전 이정표 및 이전 초.

NOTE
계속하기 전에 재생 가능한 비디오 AEM 내에 업로드되었습니다.
페이지에서 비디오가 재생되도록 하려면 다음을 참조하십시오 이 자습서 AEM에서 비디오 파일을 코드 변환하는 방법에 대한 자세한 정보.

다음 절차를 사용하여 각 메서드를 사용하여 비디오 추적에 대한 프레임워크를 설정합니다.

NOTE
새로운 구현의 경우 다음을 수행하는 것이 좋습니다 사용하지 않음 비디오 추적을 위한 기존 옵션입니다. 다음 코드를 사용하십시오 이정표 메서드를 사용하십시오.

일반적인 단계 common-steps

  1. 웹 페이지를 끌어서 설정 비디오 구성 요소 사이드 킥에서 플레이가능 추가 자산으로 비디오 구성 요소에 대해

  2. Adobe Analytics 구성 및 프레임워크 만들기.

    • 다음에 나오는 섹션의 예에서 이름은 다음과 같습니다 my-sc-configuration 구성 및 videofw 참조하십시오.

  3. 프레임워크 페이지에서 RSID를 선택하고 사용을 모두 로 설정합니다. (http://localhost:4502/cf#/etc/cloudservices/sitecatalyst/videoconf/videofw.html)

  4. 사이드 킥의 일반 구성 요소 카테고리에서 비디오 구성 요소를 프레임워크로 드래그합니다.

  5. 추적 메서드를 선택합니다.

  6. 추적 방법을 선택하면 그에 따라 CQ 변수 목록이 변경됩니다. 구성 요소를 추가로 구성하고 CQ 변수를 Adobe Analytics 속성에 매핑하는 방법에 대한 자세한 내용은 다음에 나오는 섹션을 사용합니다.

이정표 milestones

Milestones 메서드는 비디오에 대한 가장 많은 정보를 추적하며, 사용자 지정이 가능하고, 구성하기에 쉽습니다.

이정표 방법을 사용하려면 시간 기반 추적 오프셋을 지정하여 이정표를 정의합니다. 비디오 재생이 이정표를 지나면 페이지에서 Adobe Analytics을 호출하여 이벤트를 추적합니다. 정의한 각 이정표에 대해 구성 요소는 Adobe Analytics 속성에 매핑할 수 있는 CQ 변수를 만듭니다. 이러한 CQ 변수의 이름은 다음 형식을 사용합니다.

eventdata.events.milestoneXX

XX 접미사는 이정표를 정의하는 추적 오프셋입니다. 예를 들어 4, 8, 16, 20 및 28초의 추적 오프셋을 지정하면 다음 CQ 변수가 생성됩니다.

  • eventdata.events.milestone4
  • eventdata.events.milestone8
  • eventdata.events.milestone16
  • eventdata.events.milestone20
  • eventdata.events.milestone28

다음 표는 Milestones 메서드에 제공된 기본 CQ 변수를 설명합니다.

CQ 변수
Adobe Analytics 속성
eventdata.videoName
여기에 매핑된 변수에는 다음이 포함됩니다 사용자에게 친숙한 이름 (제목) 내의 아무 곳에나 삽입할 수 있습니다. 설정되지 않은 경우 비디오의 파일 이름 대신 가 전송됩니다. 비디오 재생 시작 시 한 번만 전송됩니다.
eventdata.videoFileName
여기에 매핑된 변수에는 파일 이름이 포함됩니다. eventdata.events.a.media.view와 함께 전송됩니다.
eventdata.videoFilePath
이 변수에 매핑된 변수에는 서버의 파일 경로가 포함됩니다. eventdata.events.a.media.view와 함께 전송됩니다.
eventdata.events.a.media.segmentView
세그먼트 이정표를 전달할 때마다 전송됩니다
eventdata.events.a.media.timePlayed
이정표가 트리거될 때마다 전송되며 사용자가 주어진 세그먼트를 보는 데 걸린 시간(초)도 이 이벤트와 함께 전송됩니다. 예: eventX=21
eventdata.events.a.media.view
비디오 보기 초기화 시 전송됩니다.
eventdata.events.a.media.complete
비디오 재생이 완료되면 전송됩니다.
eventdata.events.milestoneX
지정된 이정표가 통과되면 X는 이정표가 트리거되는 두 번째 이정표를 나타냅니다.
eventdata.a.contentType
모든 이정표에 전송 는 Adobe Analytics 호출에서 pev3로 표시되며, 일반적으로 "비디오"로 전송됩니다
eventdata.a.media.name
eventdata.videoName과 정확히 일치합니다
eventdata.a.media.segment
본 세그먼트에 대한 정보(예: 2)를 포함합니다.4-8
NOTE
DAM에서 편집할 비디오를 열고 을 설정하여 비디오의 사용자에게 친숙한 ​ 이름을 설정할 수 있습니다. 제목 메타데이터 필드를 원하는 이름으로 지정합니다.

  1. 추적 방법으로 이정표를 선택한 후 오프셋 추적 상자에 쉼표로 구분된 추적 오프셋 목록을 초 단위로 입력합니다. 예를 들어 다음 값은 비디오 시작 후 4, 8, 16, 20 및 28초에 이정표를 정의합니다.

    code language-xml 
    4,8,16,20,24

    오프셋 값은 0보다 큰 정수여야 합니다. 기본값은 10,25,50,75입니다.

  2. CQ 변수를 Adobe Analytics 속성에 매핑하려면 구성 요소의 CQ 변수 옆에 있는 ContentFinder에서 Adobe Analytics 속성을 드래그합니다.

    매핑 최적화에 대한 자세한 내용은 Adobe Analytics에서 비디오 측정 안내서.

  3. 프레임워크 추가 페이지를 클릭합니다.

  4. 에서 설정을 테스트하려면 미리 보기 모드 ​에서 비디오를 재생하여 트리거할 Adobe Analytics 호출을 가져옵니다.

다음에 오는 Adobe Analytics 추적 데이터 예는 4,8,16,20 및 24의 추적 오프셋을 사용하여 이정표 추적과 CQ 변수에 대해 다음 매핑을 적용하는 것입니다.

CQ 변수
Adobe Analytics 속성
eventdata.videoName
prop2
eventdata.videoFileName
prop3
eventdata.videoFilePath
prop4
eventdata.events.a.media.segmentView
event1
eventdata.events.a.media.timePlayed
event2
eventdata.events.a.media.view
event3
eventdata.events.a.media.complete
event4
eventdata.events.milestone4
event10
eventdata.events.milestone8
event11
eventdata.events.milestone16
event12
eventdata.events.milestone20
event13
eventdata.events.milestone24
event14
eventdata.a.contentType
eVar3
eventdata.a.media.name
eVar1, prop1
eventdata.a.media.segment
eVar2

이 예제에서 비디오 구성 요소는 프레임워크 페이지에 다음과 같이 나타납니다.

video1

NOTE
Adobe Analytics에 대한 호출을 보려면 DigitalPulse Debugger 또는 Fiddler와 같은 적절한 도구를 사용하십시오.

제공된 예제를 사용하는 Adobe Analytics 호출은 DigitalPulse Debugger를 사용하여 볼 때 다음과 같이 표시됩니다.

chlimage_1-156

이것은​ 첫 번째 호출 ​다음 값이 포함된 Adobe Analytics에 대해 수행:

  • eventdata.a.media.name,
  • prop2-4, contentType(비디오) 및 세그먼트(1)가 포함된 eVar2 및 eVar3과 함께 사용됩니다.1-4)
  • event3. events.a.media.view에 매핑되었습니다.

chlimage_1-157

이것은​ 3차 통화 ​Adobe Analytics 제작:

  • prop1 및 eVar1에 포함a.media.name;
  • event1. 세그먼트를 보았으므로
  • event2 sent with time played = 4
  • eventdata.events.milestones8에 도달했으므로 event11이 전송되었습니다.
  • prop2를 4로 전송하지 않습니다(eventdata.events.a.media.view가 트리거되지 않았으므로).

비레거시 이정표 non-legacy-milestones

비레거시 이정표 방법은 추적 길이 백분율을 사용하여 이정표를 정의한다는 점을 제외하면 이정표 메서드와 유사합니다. 일반적인 내용은 다음과 같습니다.

  • 비디오 재생이 이정표를 지나면 페이지에서 Adobe Analytics을 호출하여 이벤트를 추적합니다.
  • 다음 CQ 변수의 정적 집합 Adobe Analytics 속성을 사용한 매핑에 대해 정의됩니다.
  • 정의한 각 이정표에 대해 구성 요소는 Adobe Analytics 속성에 매핑할 수 있는 CQ 변수를 만듭니다.

이러한 CQ 변수의 이름은 다음 형식을 사용합니다.

XX 접미사는 이정표를 정의하는 추적 길이의 백분율입니다. 예를 들어 10, 25, 50 및 75의 백분율을 지정하면 다음 CQ 변수가 생성됩니다.

  • eventdata.events.milestone10
  • eventdata.events.milestone25
  • eventdata.events.milestone50
  • eventdata.events.milestone75
eventdata.events.milestoneXX

  1. 추적 방법으로 비레거시 이정표를 선택한 후 오프셋 추적 상자에 쉼표로 구분된 추적 길이 백분율 목록을 입력합니다. 예를 들어 다음 기본값은 트랙 길이의 10, 25, 50 및 75%에서 이정표를 정의합니다.

    code language-xml 
    10,25,50,75

    오프셋 값은 0보다 큰 정수여야 합니다.

  2. CQ 변수를 Adobe Analytics 속성에 매핑하려면 구성 요소의 CQ 변수 옆에 있는 ContentFinder에서 Adobe Analytics 속성을 드래그합니다.

    매핑 최적화에 대한 자세한 내용은 Adobe Analytics에서 비디오 측정 안내서.

  3. 프레임워크 추가 페이지를 클릭합니다.

  4. 에서 설정을 테스트하려면 미리 보기 모드 ​에서 비디오를 재생하여 트리거할 Adobe Analytics 호출을 가져옵니다.

이전 이정표 legacy-milestones

이 메서드는 Milestones 메서드와 유사하며, 추적 오프셋 필드는 비디오 내의 설정 지점 대신 백분율입니다.

NOTE
추적 오프셋 필드는 1과 100 사이의 정수가 포함된 쉼표로 구분된 목록만 허용합니다.

  1. 트랙 오프셋을 설정합니다.

    • e.g.10,50,75,100

    또한 Adobe Analytics으로 전송된 정보는 사용자 지정이 덜 됩니다. 매핑에 사용할 수 있는 변수는 3개뿐입니다.

eventdata.videoName
여기에 매핑된 변수에는 다음이 포함됩니다 사용자에게 친숙한 이름 (제목) 내의 아무 곳에나 삽입할 수 있습니다. 제목이 설정되지 않은 경우 비디오의 파일 이름 대신 가 전송됩니다. 비디오 재생 시작 시 한 번만 전송됩니다.
eventdata.videoFileName
여기에 매핑된 변수에는 파일 이름이 포함됩니다. 비디오 재생 시작 시 한 번만 전송됩니다.
eventdata.videoFilePath
이 변수에 매핑된 변수에는 서버의 파일 경로가 포함됩니다. 비디오 재생 시작 시 한 번만 전송됩니다.
NOTE
DAM에서 편집할 비디오를 열고 Title ​ 메타데이터 필드를 원하는 이름으로 설정하여 비디오의 사용자에게 친숙한 ​ 이름을 설정할 수 있습니다. 또한 완료되면 변경한 내용을 저장해야 합니다.

  1. 이러한 변수를 prop 1에서 3에 매핑합니다

    다음 관련 정보의 나머지 호출에서 로 변환되어 하나 이름이 지정된 변수 pev3.

    샘플 호출 제공된 예제를 사용하여 Adobe Analytics에 제출하는 방법은 DigitalPulse Debugger를 사용하여 볼 때 다음과 같습니다.

    lmilestones1

    다음​ pev3 ​호출에서 전송된 변수에는 다음 정보가 포함됩니다.

    • 이름 - 비디오 파일의 이름(film.avi)
    • 길이 - 비디오 파일의 길이(초)입니다(100년)
    • 플레이어 이름 - 비디오 파일을 재생하는 데 사용되는 비디오 플레이어(HTML5 비디오)
    • 재생된 총 시간(초) - 비디오가 재생되는 총 시간(초 수)입니다(25년)
    • 시작 타임스탬프 - 비디오 재생이 시작되는 시기를 식별하는 타임스탬프입니다(1331035567)
    • 재생 세션 - 재생 세션의 세부 정보입니다. 이 필드는 사용자가 비디오와 상호 작용한 방식을 나타냅니다. 여기에는 비디오 재생을 시작한 위치, 비디오 슬라이더를 사용하여 비디오를 진행했는지 여부, 비디오 재생을 중지한 위치 등의 데이터가 포함될 수 있습니다(L10E24S58L58 - 비디오가 초 단위로 중지되었습니다. L10 섹션 25을 건너뛰고 초 단위로 건너뛰었습니다. 48)

이전 초 legacy-seconds

​ 이전 초 메서드를 사용할 때 Adobe Analytics 호출이 N초마다 트리거되며, 여기서 N은 추적 오프셋 필드에 지정됩니다.

  1. 트랙 오프셋을 초 단위로 설정합니다.

    • 예: 6
    note note
    NOTE
    추적 오프셋 필드는 0보다 큰 정수만 허용합니다

    Adobe Analytics으로 전송된 정보는 사용자 지정이 덜 됩니다. 매핑에 사용할 수 있는 변수는 3개뿐입니다.

eventdata.videoName
여기에 매핑된 변수에는 다음이 포함됩니다 사용자에게 친숙한 이름 (제목) 내의 아무 곳에나 삽입할 수 있습니다. 제목이 설정되지 않은 경우 비디오의 파일 이름 대신 가 전송됩니다. 비디오 재생 시작 시 한 번만 전송됩니다.
eventdata.videoFileName
여기에 매핑된 변수에는 파일 이름이 포함됩니다. 비디오 재생 시작 시 한 번만 전송됩니다.
eventdata.videoFilePath
이 변수에 매핑된 변수에는 서버의 파일 경로가 포함됩니다. 비디오 재생 시작 시 한 번만 전송됩니다.
NOTE
DAM에서 편집할 비디오를 열고 을 설정하여 비디오의 사용자에게 친숙한 ​ 이름을 설정할 수 있습니다. 제목 메타데이터 필드를 원하는 이름으로 지정합니다. 또한 완료되면 변경한 내용을 저장해야 합니다.

  1. 이러한 변수를 prop1, prop2 및 prop3에 매핑

    다음 관련 정보의 나머지 호출에서 로 변환되어 하나 이름이 지정된 변수 pev3.

    제공된 예제를 사용하는 Adobe Analytics 호출은 DigitalPulse Debugger를 사용하여 볼 때 다음과 같이 표시됩니다.

    lseconds

    호출은 위의 이전 이정표 호출과 유사합니다. pev3에 대한 정보를 참조하십시오​ 여기서.

이 자습서에 사용된 참조:

[0] https://experienceleague.adobe.com/docs/media-analytics/using/sdk-implement/setup/setup-overview.html?lang=ko?lang=ko

recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8