JavaScript 3.x를 사용하여 광고 추적

광고 추적 상수

구현 단계

1. 프리롤을 포함하여 광고 브레이크 경계가 시작되는 시점을 식별하고 광고 브레이크 정보를 사용하여 AdBreakObject를 생성합니다.

   AdBreakObject 참조:

   변수 이름	유형	설명
   name	string	adbreak 이름(프리롤, 미드롤 및 포스트롤)을 나타내는 빈 문자열이 아닙니다.
   position	수	1로 시작하는 광고 브레이크의 번호 위치입니다.
   startTime	수	광고 브레이크의 시작 위치에 있는 플레이헤드 값입니다.

   광고 브레이크 개체 작성:

   var adBreakObject =
     ADB.Media.createAdBreakObject(<ADBREAK_NAME>,
                                      <POSITION>,
                                      <START_TIME>);
   

2. 광고 브레이크 추적을 시작하려면 MediaHeartbeat 인스턴스에서 AdBreakStart를 사용하여 trackEvent()를 호출합니다.

   tracker.trackEvent(ADB.Media.Event.AdBreakStart, adBreakObject);
   

3. 광고가 시작되는 시기를 식별하고, 광고 정보를 사용하여 AdObject 인스턴스를 만듭니다.

   AdObject 참조:

   변수 이름	유형	설명
   name	string	광고 이름을 나타내는 빈 문자열이 아닙니다.
   adId	string	광고 식별자를 나타내는 빈 문자열이 아닙니다.
   position	수	광고 내의 광고 번호 위치(1부터 시작).
   length	수	광고의 길이를 나타내는 양수.

   광고 개체 작성:

   var adObject =
     ADB.Media.createAdObject.createAdObject(<AD_NAME>,
                                   <AD_ID>,
                                   <POSITION>,
                                   <LENGTH>);
   

4. 원할 경우 컨텍스트 데이터 변수를 통해 표준 및/또는 광고 메타데이터를 미디어 추적 세션에 첨부합니다.

   • JavaScript에서 표준 광고 메타데이터 구현

   • 사용자 지정 광고 메타데이터 -​사용자 지정 메타데이터의 경우 사용자 지정 데이터 변수에 대한 변수 개체를 만들고, 현재 광고의 데이터로 채웁니다.

     /* Set context data */
     // Standard metadata keys provided by adobe.
     adMetadata[ADB.Media.AdMetadataKeys]  ="Sample Advertiser";
     adMetadata[ADB.Media.AdMetadataKeys] = "Sample Campaign";
     
     // Custom metadata keys
     adMetadata["affiliate"] = "Sample affiliate";
     adMetadata["campaign"] = "Sample ad campaign";
     adMetadata["creative"] = "Sample creative";
     

5. 광고 재생 추적을 시작하려면 MediaHeartbeat 인스턴스에서 AdStart 이벤트를 사용하여 trackEvent()를 호출합니다.

   사용자 지정 메타데이터 변수(또는 빈 개체)에 대한 참조를 이벤트 호출의 세 번째 매개 변수로 포함하십시오.

   _onAdStart = function() {
       tracker.trackEvent(ADB.Media.Event.AdStart, adObject, adMetadata);
   };
   

6. 광고 재생이 광고 끝에 도달하면 AdComplete 이벤트를 사용하여 trackEvent()를 호출합니다.

   _onAdComplete = function() {
       tracker.trackEvent(ADB.Media.Event.AdComplete);
   };
   

7. 사용자가 광고를 건너뛰도록 선택했기 때문에 광고 재생이 완료되지 않은 경우 AdSkip 이벤트를 추적합니다.

   _onAdSkip = function() {
       tracker.trackEvent(ADB.Media.Event.AdSkip);
   };
   

8. 같은 AdBreak 내에 추가 광고가 있는 경우 3~7단계를 다시 반복합니다.

9. 광고 브레이크가 완료되면 AdBreakComplete 이벤트를 사용하여 추적합니다.

   _onAdBreakComplete = function() {
       tracker.trackEvent(ADB.Media.Event.AdBreakComplete);
   };
   

자세한 내용은 추적 시나리오 프리롤 광고와 함께 VOD 재생을 참조하십시오.