tl

tl() 메서드는 Adobe Analytics의 중요한 핵심 구성 요소입니다. 이 메서드는 페이지에 정의된 모든 Analytics 변수를 가져와 이미지 요청에 컴파일한 다음, 해당 데이터를 Adobe 데이터 수집 서버에 보냅니다. 이것은 t() 메서드와 유사하지만 페이지 보기 수를 증가시키지는 않습니다. 또한 이 메서드는 전체 페이지 로드로 간주되지 않는 링크 및 기타 요소를 추적하는 데 유용합니다.

trackDownloadLinks 또는 trackExternalLinks가 활성화되면 AppMeasurement가 다운로드 링크 및 종료 링크 추적 데이터를 보내는 tl() 메서드를 자동으로 호출합니다. 조직에서 추적할 링크와 그 동작을 보다 세밀하게 제어하는 것을 선호하는 경우 tl() 메서드를 수동으로 호출할 수 있습니다. 사용자 지정 링크는 수동으로만 추적할 수 있습니다.

웹 SDK를 사용한 링크 추적

웹 SDK는 페이지 보기 호출과 링크 추적 호출을 구분하지 않습니다. 둘 다 sendEvent 명령을 사용합니다.

XDM 개체를 사용하고 Adobe Analytics이 주어진 이벤트를 링크 추적 호출로 계산하도록 하려는 경우 XDM 데이터에 다음이 포함되어 있는지 확인하십시오.

alloy("sendEvent", {
  "xdm": {
    "web": {
      "webInteraction": {
        "name": "My Custom Link",
        "URL": "https://example.com",
        "type": "other"
      }
    }
  }
});

데이터 개체를 사용하고 Adobe Analytics에서 특정 이벤트를 링크 추적 호출로 계산하도록 하려면 데이터 개체에 다음이 포함되어 있는지 확인하십시오.

alloy("sendEvent", {
  "data": {
    "__adobe": {
      "analytics": {
        "linkName": "My custom link",
        "linkURL": "https://example.com",
        "linkType": "o"
      }
    }
  }
});

Adobe Analytics 확장을 사용한 링크 추적

Adobe Analytics 확장에는 링크 추적 호출을 설정할 수 있는 전용 위치가 있습니다.

Analytics 확장에서는 선택적 인수를 설정할 수 없습니다.

AppMeasurement 및 Analytics 확장 사용자 지정 코드 편집기의 s.tl() 메서드

추적 호출을 Adobe에 보내려면 s.tl() 메서드를 호출하십시오.

s.tl([Link object],[Link type],[Link name],[Override variable]);

링크 개체 (필수)

링크 개체 인수는 브라우저가 최대 500밀리초를 기다린 후에 페이지에서 나가는지 여부를 결정합니다. 이미지 요청이 500밀리초 이내로 전송되면 페이지가 클릭한 링크로 즉시 이동합니다.

// Include a 500ms delay with an exit link
s.tl(this,"e","Example exit link");

// Do not include a 500ms delay with an exit link
s.tl(true,"e","Example exit link");

링크 유형(필수)

링크 유형 인수는 링크 추적 호출 유형을 결정하는 단일 문자 문자열로서, 3개의 유효한 값이 있습니다.

// Send a custom link
s.tl(true,"o","Example custom link");

// Send a download link
s.tl(true,"d","Example download link");

// Send an exit link
s.tl(true,"e","Example exit link");

링크 이름 (권장)

링크 이름 인수는 링크 추적 차원 항목을 결정하는 문자열로서, 보고에서 사용자 지정 링크, 다운로드 링크 또는 종료 링크 차원을 사용할 때 이 문자열에는 차원 항목이 포함됩니다. 이 인수가 설정되어 있지 않으면 linkURL 변수가 사용됩니다.

// When using the Download link dimension, this method call increases the occurrences metric for "Sea turtle PDF report" by 1.
s.tl(true,"d","Sea turtle PDF report");

변수 무시 (선택 사항)

단일 호출에 대한 변수 값을 변경할 수 있습니다. 자세한 내용은 변수 무시를 참조하십시오.

var y = new Object();
y.eVar1 = "Override value";
y.linkTrackVars = "eVar1";
s.tl(true,"o","Example custom link",y);

예제 및 사용 사례

HTML 링크 내에서 바로 기본 링크 추적 호출을 전송하십시오.

<a href="example.html" onClick="s.tl(true,'o','Example link');">Click here</a>

메서드 인수를 사용하여 기본 링크 추적 호출을 만들도록 JavaScript를 사용합니다.

s.tl(true,"o","Example link");

사용자 지정 함수 내에서 링크 추적 호출 만들기

링크 추적 코드를 자체 포함된 JavaScript 함수에 통합할 수 있습니다. 그런 다음 각 링크의 onClick 함수에서 호출을 수행할 수 있습니다. JavaScript 파일에서 다음을 설정하십시오.

function trackClickInteraction(name){
  s.linkTrackVars = "eVar1,eVar2";
  s.eVar1 = name;
  s.eVar2 = s.pageName;
  s.tl(true,"o",name);
}

그런 다음 주어진 링크를 추적하고 싶을 때마다 이 함수를 호출할 수 있습니다.

<!-- Use wherever you want to track links -->
<a href="example.html" onClick="trackClickInteraction('Example link');">Click here</a>

중복 링크 추적 방지

trackDownloadLinks 또는 trackExternalLinks가 활성화되어 있으면 올바른 필터가 일치하는 경우 AppMeasurement가 자동으로 링크 추적 호출을 생성합니다. 이러한 링크 클릭에 대해 수동으로도 s.tl()을 호출하는 경우 중복 데이터를 Adobe에 보낼 수 있습니다. 중복 데이터는 보고서 수치들을 부풀려서 정확성을 떨어뜨립니다.

예를 들어 다음 함수는 동일한 링크 클릭에 대해 두 개의 링크 추적 호출 (수동 및 자동 다운로드 링크)을 보냅니다.

function trackDownload(obj) {
  s.tl(obj,"d","Example PDF download");
}

다음의 수정된 함수를 사용하여 중복 링크 추적 호출을 방지할 수 있습니다. 이 함수는 먼저 링크 개체가 있는지 확인하고 링크 개체가 빈 문자열인 경우 수동 링크 추적 호출만 보냅니다.

function linkCode(obj) {
  var lt = obj.href != null ? s.lt(obj.href) : "";
  if (lt=="") {
    s.tl(obj,"d","Example PDF download");
  }
}

Activity Map에 tl() 메서드 사용

tl() 메서드를 사용하여 사용자 지정 요소를 추적하고 다이내믹 컨텐츠에 대한 오버레이 렌더링을 구성할 수 있습니다. linkName 매개 변수는 Activity Map 링크 차원을 설정하는 데에도 사용됩니다.

tl() 메서드가 HTML 요소의 클릭 이벤트에서 직접 호출되면 웹 페이지가 로드될 때 Activity Map이 해당 요소에 대한 오버레이를 표시할 수 있습니다. 예:

<a href="index.html" onclick="s.tl(this,'o','Example custom link');">Example link text</a>

tl() 메서드가 HTML 요소의 클릭 이벤트에서 직접 호출되지 않으면 Activity Map은 해당 요소를 클릭한 후에만 오버레이를 표시할 수 있습니다. 예:

<a href="index.html" onclick="someFn(event);">Example link text</a>
<script>
  function someFn (event) {
    s.tl(event.srcElement,'o','Example custom link');
  }
</script>