Adobe 外掛程式：getTimeSinceLastVisit

重要

此外掛程式由 Adobe Consulting 提供，協助您從 Adobe Analytics 中獲得更多價值。Adobe 客戶服務不提供此外掛程式的支援，包括安裝或疑難排解在內。如果您需要與此外掛程式有關的協助，請聯絡貴組織的客戶經理。客戶經理可安排您與顧問會面以尋求協助。

getTimeSinceLastVisit 外掛程式可用來追蹤訪客從上次造訪到下次回訪您網站經過的時間長度。

使用 Adobe Experience Platform Launch 擴充功能安裝外掛程式

Adobe 提供一個擴充功能，可讓您使用最常用的外掛程式。

  1. 使用您的 AdobeID 憑證登入 launch.adobe.com。
  2. 按一下所需的屬性。
  3. 前往擴充功能標籤，然後按一下「目錄」按鈕
  4. 安裝並發佈常用 Analytics 外掛程式擴充功能
  5. 如果您尚未執行上述步驟，請使用下列設定建立標示為「初始化外掛程式」的規則：
    • 條件：無
    • 事件：核心 - 已載入程式庫 (頁面頂端)
  6. 使用下列設定將動作新增至上述規則：
    • 擴充功能：常用 Analytics 外掛程式
    • 動作類型：初始化 getTimeSinceLastVisit
  7. 儲存並發佈規則的變更。

使用 Launch 自訂程式碼編輯器安裝外掛程式

如果您不想使用外掛程式擴充功能，可以使用自訂程式碼編輯器。

  1. 使用您的 AdobeID 憑證登入 launch.adobe.com。
  2. 按一下所需的屬性。
  3. 前往擴充功能標籤，然後按一下 Adobe Analytics 擴充功能底下的「設定」按鈕。
  4. 展開使用自訂程式碼設定追蹤摺疊式功能表，便會顯示「開啟編輯器」按鈕。
  5. 開啟自訂程式碼編輯器，並將下方提供的外掛程式程式碼貼入編輯視窗中。
  6. 儲存並發佈 Analytics 擴充功能的變更。

使用 AppMeasurement 安裝外掛程式

Analytics 追蹤物件實例化 (使用 s_gi) 後，將下列程式碼複製並貼到 AppMeasurement 檔案中的任何位置。保留您實施中的程式碼備註和版本號碼，有助於 Adobe 疑難排解任何可能問題。

/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: getTimeSinceLastVisit v1.0 (Requires formatTime and inList plug-ins) */
s.getTimeSinceLastVisit=function(){var s=this,a=new Date,b=a.getTime(),c=s.c_r("s_tslv")||0,d=Math.round((b-c)/1E3);a.setTime(b+63072E6);s.c_w("s_tslv",b,a);return c?1800<d&&s.formatTime?s.formatTime(d):"":"New Visitor"};

/* Adobe Consulting Plugin: formatTime v1.1 (Requires inList plug-in) */
s.formatTime=function(ns,tf,bml){var s=this;if(!("undefined"===typeof ns||isNaN(ns)||0>Number(ns))){if("string"===typeof tf&&"d"===tf||("string"!==typeof tf||!s.inList("h,m,s",tf))&&86400<=ns){tf=86400;var d="days";bml=isNaN(bml)?1:tf/(bml*tf)} else"string"===typeof tf&&"h"===tf||("string"!==typeof tf||!s.inList("m,s",tf))&&3600<=ns?(tf=3600,d="hours", bml=isNaN(bml)?4: tf/(bml*tf)):"string"===typeof tf&&"m"===tf||("string"!==typeof tf||!s.inList("s",tf))&&60<=ns?(tf=60,d="minutes",bml=isNaN(bml)?2: tf/(bml*tf)):(tf=1,d="seconds",bml=isNaN(bml)?.2:tf/bml);ns=Math.round(ns*bml/tf)/bml+" "+d;0===ns.indexOf("1 ")&&(ns=ns.substring(0, ns.length-1));return ns}};

/* Adobe Consulting Plugin: inList v2.1 */
s.inList=function(lv,vtc,d,cc){if("string"!==typeof vtc)return!1;if("string"===typeof lv)lv=lv.split(d||",");else if("object"!== typeof lv)return!1;d=0;for(var e=lv.length;d<e;d++)if(1==cc&&vtc===lv[d]||vtc.toLowerCase()===lv[d].toLowerCase())return!0;return!1};
 /******************************************** END CODE TO DEPLOY ********************************************/

使用外掛程式

getTimeSinceLastVisit 方法不使用任何引數。它會傳回自訪客上次造訪網站以來經過的時間長度，並以下列格式分組：

  • 自上次造訪後 30 分鐘至 1 小時之間的時間設為最接近的半分鐘基準。例如："30.5 minutes"、"53 minutes"
  • 一小時至一天之間的時間會捨入至最接近的四分之一小時基準。例如："2.25 hours"、"7.5 hours"
  • 大於一天的時間會捨入至最接近的天數基準。例如："1 day"、"3 days"、"9 days"、"372 days"
  • 如果訪客之前未造訪過，或經過的時間超過兩年，則值會設為 "New Visitor"。
注意

此外掛程式只會傳回造訪首次點擊時的值。

此外掛程式會建立名為 "s_tslv" 的第一方 Cookie，並設為目前時間的 Unix 時間戳記。閒置兩年後 Cookie 便會到期。

呼叫範例

範例 #1

如果新訪客造訪網站，而下列程式碼在造訪的第一頁上執行…

s.prop1 = s.getTimeSinceLastVisit();
s.linkTrackVars = s.apl(s.linkTrackVars, "prop1") //ensures that prop1 will be included on the first hit of the visit

…s.prop1 的值將設為等於「New Visitor」。

如果閒置 35 分鐘後在相同網域上執行相同的程式碼，s.prop1 的值將設為等於「35 分鐘」。

如果閒置 4 天後在相同網域上執行相同的程式碼，s.prop1 的值將設為等於「4 天」。

版本記錄

1.0 (2018 年 4 月 16 日)

  • 單點發行 (重新編譯程式碼且大小較小)。
  • 衍生自 getDaysSinceLastVisit 外掛程式的程式碼 (現已過時並重新命名)。
  • 現在請使用 formatTime 和 inList 外掛程式來傳回值。

本頁內容