YouTube 비디오 추적 확장 개요

전제 조건

각 Adobe Experience Platform Launch 속성을 사용하려면 확장 화면에서 다음 확장 프로그램이 설치 및 구성되어 있어야 합니다.

  • Adobe Analytics
  • Experience Cloud Visitor ID 서비스
  • 코어 확장

https://developers.google.com/youtube/player_parameters에 따라 비디오 플레이어가 렌더링되는 각 웹 페이지의 HTML에 ”태그를 사용하여 플레이어 포함” 코드 조각을 사용하십시오.

이 확장 버전 1.0.1은 iframe 태그에 고유한 값이 있는 id 특성을 삽입하고 src특성 값 끝에 ?enablejsapi=1을 추가하여 단일 웹 페이지에 하나 이상의 YouTube 비디오를 포함하도록 지원합니다. 예:

<iframe id="player1" width="560" height="315" src="https://www.youtube.com/embed/xpatB77BzYE?enablejsapi=1" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

확장 프로그램은 id 필드 및 enablejsapi=1 쿼리 문자열 매개 변수를 동적으로 iFrame에 추가하므로 iFrame에 수동으로 추가하지 마십시오.

하나 이상의 비디오가 있는 페이지의 경우 각 비디오는 해당 페이지에서 실행되는 Platform Launch 규칙에 동일한 구성 세트를 사용합니다. 예를 들어, 비디오 50%에서 완료되는 이벤트를 트리거하는 규칙을 만드는 경우 페이지의 각 비디오가 50% 큐 포인트에서 규칙을 트리거합니다.

확장은 iFrames를 다시 작성하는 다음 로직을 사용합니다.

document.onreadystatechange = function () {
 if (document.readyState === 'complete') {

따라서 페이지가 로드된 후 약간 깜박임이 발생합니다. 이 동작은 예상되었습니다.

데이터 요소

확장에는 5개의 데이터 요소가 있으며 그 중 어느 것도 구성을 필요로 하지 않습니다.

  • 재생 헤드 위치: Launch 규칙 내에서 호출될 때 비디오 타임라인에서 재생 헤드 위치의 위치를 초 단위로 기록합니다.
  • 비디오 ID: 비디오와 연결된 YouTube ID를 지정합니다.
  • 비디오 이름: 비디오의 설명적이거나 친숙한 이름을 지정합니다.
  • 비디오 URL: 현재 로드되거나 재생되는 비디오에 대한 YouTube.com URL을 반환합니다.
  • 비디오 지속 시간: 비디오 컨텐츠의 총 지속 시간을 초 단위로 기록합니다.

이벤트

확장에는 8개의 이벤트를 사용할 수 있으며, 사용자 지정 큐 포인트 추적에만 구성이 필요합니다.

  • 비디오 준비: 비디오가 시작될 때 트리거되며 재생할 준비가 되었습니다.
  • 비디오 시작: 비디오가 처음 시작될 때와 player.getCurrentTime() === 0의 경우 트리거됩니다.
  • 비디오 재생: 비디오가 시작될 때 트리거되고 초기 시작 후 재생됩니다. 이 트리거는 재생 때마다 실행됩니다.
  • 비디오 일시 중지: 비디오가 일시 중지되면 트리거됩니다.
  • 비디오 다시 시작: 비디오가 다시 시작될 때와 player.getCurrentTime() !== 0의 경우 트리거됩니다.
  • 사용자 지정 큐 추적: 비디오가 지정된 비디오 임계값 비율에 도달하면 트리거됩니다.
    예를 들어 비디오가 60초이고 지정된 큐 포인트가 50%인 경우 재생 헤드 위치가 30초일 때 트리거가 있는 이벤트가 발생합니다. 큐 포인트 추적은 초기 재생과 재생 모두에 적용됩니다. 사용자가 큐 포인트를 검색하는 경우 이벤트가 실행되지 않습니다. 큐 포인트 이벤트는 재생 헤드가 타임라인에서 계산된 큐 포인트 위치를 교차하고 비디오 플레이어가 재생되는 경우에만 발생합니다.
  • 비디오 버퍼: 플레이어가 비디오 재생을 시작하기 전에 일정 양의 데이터를 다운로드하는 경우 트리거됩니다.
  • 비디오 종료: 비디오가 완전히 완료되는 경우 트리거됩니다.

사용

모든 비디오 이벤트(위에 나열됨)에 대해 하나의 Platform Launch 규칙이 있습니다. 추적할 각 이벤트에 대해 특정 규칙을 만들어야 합니다. 즉, 비디오 일시 중지를 추적하지 않으려면 규칙을 만들지 않습니다.

규칙에는 다음의 세 가지 작업이 있습니다.

  • 변수 설정: Adobe Analytics 변수를 설정합니다(일부 포함 데이터 요소에 매핑).
  • 비콘 보내기: Adobe Analytics 비콘을 사용자 지정 링크 추적 호출로 보내고 "링크 이름" 값을 제공합니다.
  • 변수 지우기: Adobe Analytics 변수를 지웁니다.

"비디오 시작"에 대한 Platform Launch 규칙 예

다음 비디오 확장 개체가 포함될 예정입니다.

이벤트:

비디오 시작(이 이벤트는 방문자가 YouTube 비디오를 재생하기 시작할 때 규칙이 실행됩니다.)

조건: 없음

작업: Analytics 확장 기능을 사용하여 다음을 수행할 수 있습니다.

매핑할 "변수 설정" 작업:

  • 비디오 시작용 이벤트
  • 비디오 지속 시간 데이터 요소에 대한 prop/eVar
  • 비디오 ID 데이터 요소에 대한 prop/eVar
  • 비디오 이름 데이터 요소에 대한 prop/eVar
  • 비디오 URL 데이터 요소에 대한 prop/eVar

그런 다음, "변수 지우기" 작업 다음에 나오는 링크 이름 "비디오 시작"과 함께 "비콘 보내기" 작업(s.tl)을 포함합니다.

각 비디오 요소에 대해 여러 개의 eVar 또는 prop을 사용할 수 없는 구현의 경우, 데이터 요소 값을 Platform Launch 내에서 연결하고, 분류 규칙 빌더 도구를 사용하여 분류 보고서로 구문 분석한 다음, https://docs.adobe.com/content/help/ko-KR/analytics/components/classifications/classifications-rulebuilder/classification-rule-builder.html에서 설명한 바와 같이 Analysis Workspace에서 세그먼트로 적용할 수 있습니다.

비디오 정보 값을 연결하려면 ”비디오 메타 데이터”라는 새 데이터 요소를 만든 후 이를 프로그래밍하여 모든 비디오 데이터 요소(위에 나열됨)를 가져와서 함께 조합합니다. 예:

var r = ””;

r.push('YouTube'); //Player Name
r.push(_satellite.getVar('Video ID'));
r.push(_satellite.getVar('Video Name'));
r.push(_satellite.getVar('Video Duration'));

return r.join('|');

이 페이지에서는

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now