JavaScript 3.x를 사용하여 광고 추적 track-ads-on-javascript
다음은 3.x SDK를 사용하는 구현과 관련된 지침입니다.
광고 추적 상수
AdBreakStart
AdBreakComplete
AdStart
AdComplete
AdSkip
구현 단계
-
프리롤을 포함하여 광고 브레이크 경계가 시작되는 시점을 식별하고 광고 브레이크 정보를 사용하여
AdBreakObject
를 생성합니다.AdBreakObject
참조:table 0-row-3 1-row-3 2-row-3 3-row-3 변수 이름 유형 설명 name
문자열 광고 브레이크 이름(프리롤, 미드롤 및 포스트롤)을 나타내는 빈 문자열이 아닙니다. position
숫자 1로 시작하는 광고 브레이크의 번호 위치입니다. startTime
숫자 광고 브레이크의 시작 위치에 있는 플레이헤드 값입니다. 광고 브레이크 개체 작성:
code language-js var adBreakObject = ADB.Media.createAdBreakObject(<ADBREAK_NAME>, <POSITION>, <START_TIME>);
-
광고 브레이크 추적을 시작하려면
MediaHeartbeat
인스턴스에서AdBreakStart
를 사용하여trackEvent()
를 호출합니다.code language-js tracker.trackEvent(ADB.Media.Event.AdBreakStart, adBreakObject);
-
광고가 시작되는 시기를 식별하고, 광고 정보를 사용하여
AdObject
인스턴스를 만듭니다.AdObject
참조:table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 변수 이름 유형 설명 name
문자열 광고 이름을 나타내는 빈 문자열이 아닙니다. adId
문자열 광고 식별자를 나타내는 빈 문자열이 아닙니다. position
숫자 광고 브레이크 내 광고 번호 위치로서 1로 시작합니다. length
숫자 광고 길이를 나타내는 양수입니다. 광고 개체 작성:
code language-js var adObject = ADB.Media.createAdObject.createAdObject(<AD_NAME>, <AD_ID>, <POSITION>, <LENGTH>);
-
(선택 사항) 컨텍스트 데이터 변수를 통해 표준 및/또는 광고 메타데이터를 미디어 추적 세션에 첨부합니다.
-
사용자 지정 광고 메타데이터 - 사용자 지정 메타데이터의 경우 사용자 지정 데이터 변수에 대한 변수 개체를 만들고, 현재 광고의 데이터로 채웁니다.
code language-js /* 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";
-
광고 재생 추적을 시작하려면
MediaHeartbeat
인스턴스에서AdStart
이벤트를 사용하여trackEvent()
를 호출합니다.사용자 지정 메타데이터 변수(또는 빈 개체)에 대한 참조를 이벤트 호출의 세 번째 매개 변수로 포함하십시오.
code language-js _onAdStart = function() { tracker.trackEvent(ADB.Media.Event.AdStart, adObject, adMetadata); };
-
광고 재생이 광고 끝에 도달하면
AdComplete
이벤트를 사용하여trackEvent()
를 호출합니다.code language-js _onAdComplete = function() { tracker.trackEvent(ADB.Media.Event.AdComplete); };
-
사용자가 광고를 건너뛰도록 선택했기 때문에 광고 재생이 완료되지 않은 경우
AdSkip
이벤트를 추적합니다.code language-js _onAdSkip = function() { tracker.trackEvent(ADB.Media.Event.AdSkip); };
-
같은
AdBreak
내에 추가 광고가 있는 경우 3~7단계를 다시 반복합니다. -
광고 브레이크가 완료되면
AdBreakComplete
이벤트를 사용하여 추적합니다.code language-js _onAdBreakComplete = function() { tracker.trackEvent(ADB.Media.Event.AdBreakComplete); };
자세한 내용은 추적 시나리오 프리롤 광고와 함께 VOD 재생을 참조하십시오.
세분화된 광고 추적
기본 광고 Ping 간격은 10 seconds
입니다.
세분화된 광고 추적을 설정하여 1 second
광고 추적을 활성화할 수 있습니다.
구문
ADB.Media.MediaObjectKey = {
GranularAdTracking: "media.granularadtracking"
}
예
var mediaObject = ADB.Media.createMediaObject("media-name", "media-id", 60, ADB.Media.StreamType.VOD, ADB.Media.MediaType.Video);
// Enable granular ad tracking
mediaObject[ADB.Media.MediaObjectKey.GranularAdTracking] = true;
tracker.trackSessionStart(mediaObject);