tl

tl() メソッドは、Adobe Analytics の重要なコアコンポーネントです。ページで定義されているすべての Analytics 変数を取得し、それらをイメージリクエストにコンパイルして、そのデータをアドビのデータ収集サーバーに送信します。このメソッドは t() メソッドと同じように機能しますが、このメソッドではページビューが増分されません。完全なページ読み込みとは見なされないリンクやその他の要素を追跡する場合に便利です。

trackDownloadLinks または trackExternalLinks が有効な場合、AppMeasurement は自動的に tl() メソッドを呼び出して、ダウンロードリンクと離脱リンクトラッキングデータを送信します。組織で、追跡するリンクとその動作をより詳細に制御する必要がある場合は、手動で tl() メソッドを呼び出すことができます。カスタムリンクは手動でのみ追跡できます。

Web SDK を使用したリンクトラッキング

Web 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の s.tl （） メソッドと Analytics 拡張機能のカスタムコードエディター

アドビにトラッキングコールを送信する場合は、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");

リンクタイプ （必須）

リンクタイプ引数は、リンクトラッキングコールのタイプを決定する 1 文字の文字列です。有効な値は 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");

変数のオーバーライド（任意）

1 回の呼び出しに対する変数の値を変更できます。詳しくは、変数のオーバーライドを参照してください。

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() を手動でも呼び出すと、重複したデータをアドビに送信する場合があります。重複したデータは、レポート数を水増しし、正確性を低下させます。

例えば、次の関数は、同じリンククリックに対して 2 つのリンクトラッキングコール（手動および自動ダウンロードリンク）を送信します。

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では、web ページが読み込まれるときにその要素のオーバーレイを表示できます。 次に例を示します。

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

HTML要素のクリック時のイベントから直接 tl() メソッドが呼び出されない場合、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>