비디오 사용자 지정 큐 추적기: 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)을 포함합니다.

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

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('|');