Show Menu
主題×

不使用標籤管理程式實作 Target

不使用標籤管理程式 (Adobe Launch 或動態標籤管理) 實作 Adobe Target 的相關資訊。

不使用標籤管理程式實作 Target

不使用標籤管理程式 (Adobe Launch 或動態標籤管理) 實作 Adobe Target 的相關資訊。
推薦使用 Adobe Launch 實作 Target 和 at.js 程式庫。下列資訊不適用於使用 Adobe Launch 實作 Target。

at.js configurations

可協助您在 at.js「設定」頁面上設定數個設定的資訊。
推薦使用 Adobe Launch 實作 Target 和 at.js 程式庫。下列資訊不適用於使用 Adobe Launch 實作 Target。
您可以覆寫 at.js 資料庫中的設定,而非在 Target Standard/Premium UI 中或使用 REST API 進行設定。如需詳細資訊,請參閱 targetGlobalSettings()
若要開啟「設定」頁面:
  1. 按一下​ 「設定」 > 「實作」 ​。
  2. 選取「​ at.js > ​編輯 at.js 設定 ​」。

內容傳送設定

變更這些設定之前,請洽詢客戶服務。多數實作均需要這些設定。
設定
說明
自動建立全域 mbox
選擇是否將全域 mbox 呼叫內嵌在 at.js 檔案中,以便每次載入頁面時自動觸發。
變更此設定會同時影響 at.js 和 mbox.js。
全域 Mbox 名稱
選取全域 mbox 的名稱。依預設,此名稱為 target-global-mbox。
對於 at.js,mbox 名稱中可以使用特殊字元 (包括 &)。
變更此設定會同時影響 at.js 和 mbox.js。

進階設定

設定
說明
用戶端代碼
用戶端代碼是使用 Target API 時通常需要的用戶端專用字元序列。
無法變更此設定。
IMS 組織 ID
此 ID 會將您的實施連結至 Adobe Experience Cloud 帳戶。
無法變更此設定。
設定檔存留期
此設定會決定訪客設定檔儲存多久。依預設,訪客設定檔會儲存兩週。最多可增加至 90 天。
若要變更「設定檔存留期」設定,請聯絡 客戶服務
X-Domain
判斷瀏覽器設定 Cookie 的位置,是設定在您的專屬網域中 (第一方 Cookie),還是在 Target 的網域中,還是兩者都有。
變更此設定會同時影響 at.js 和 mbox.js。
逾時
如果 Target 在已定義的期間內沒有回應內容,伺服器呼叫會逾時,並顯示預設內容。在訪客工作階段期間會繼續嘗試其他呼叫。預設值為 5 秒。
變更此設定會同時影響 at.js 和 mbox.js。
at.js 程式庫會使用 XMLHttpRequest 中的逾時設定。逾時是在觸發請求時開始計時,而於 Target 從伺服器收到回應時停止。如需詳細資訊,請參閱 Mozilla 開發人員網路上的 XMLHttpRequest.timeout
如果在收到回應之前就發生指定的逾時,則會顯示預設內容,而訪客可能算為活動的參與者,因為所有資料收集都發生在 Target 邊緣。如果請求到達 Target 邊緣,訪客即納入計算。
設定逾時設定時,請考量下列事項:
  • 如果值太低,即使訪客應該算為活動的參與者,使用者還是可能幾乎都看到預設內容。
  • 如果值太高,而如果您長時間使用本文隱藏,訪客可能會在網頁上看到空白區域或空白頁面。
若要充分瞭解 mbox 回應時間,請在瀏覽器的開發人員工具中查看「網路」標籤。您也可以使用第三方 Web 效能監控工具,例如 Catchpoint。
注意​ : visitorApiTimeout 設定可確保Target不會為了訪客 API 回應而等待太久。此設定和這裡說明的 at.js 逾時設定不影響彼此。
舊版瀏覽器支援
注意: at.js 0.9.3 版和更舊版本中提供「舊版瀏覽器支援」選項。at.js 0.9.4 版中移除了此選項。如需 at.js 支援的瀏覽器清單,請參閱 支援的瀏覽器
舊版瀏覽器是指不完全支援 CORS (跨來源資源共用) 的舊型瀏覽器。這些瀏覽器包括 Internet Explorer 瀏覽器 11 版以前的版本,以及 Safari 6 版及更舊版本。如果停用「舊版瀏覽器支援」,Target 不會在這些瀏覽器上傳送內容或將訪客算入報表中。如果啟用此選項,建議對舊型瀏覽器採取品質保證措施,以確保良好的客戶體驗。

程式碼設定

設定
說明
資料庫標題
新增任何自訂 JavaScript 以包括在資料庫頂端。
資料庫頁尾
新增任何自訂 JavaScript 以包含在程式庫底部。

下載 at.js

使用 Target 介面或下載 API 來下載 資料庫的指示。
推薦使用 Adobe Launch 實作 Target 和 at.js 程式庫。下列資訊不適用於使用 Adobe Launch 實作 Target。
Target 團隊只會維護兩個 at.js 版本: 最新版本和次新版本。請視需要升級 at.js,以確保您執行的是支援的版本。如需每一個版本有何功能的詳細資訊,請參閱 at.js 版本詳細資料

Download at.js using the Target interface

若要從 at.js 介面下載 Target:
  1. 按一下​ 「設定」 > 「實作」 ​。
  2. 選取​ 「at.js」 ​。
  3. 按一下​ 「下載 at.js」 ​。

Download at.js using the Target Download API

若要使用 API 來下載 at.js:
  1. 取得用戶端程式碼。
    用戶端程式碼位於 介面的「 ​設定​ > ​實施​ > ​編輯 at.js 設定Target」頁面頂端。
  2. 取得您的管理員編號。
    載入此 URL:
    https://admin.testandtarget.omniture.com/rest/v1/endpoint/<varname>client code</varname>
    
    
    Replace client code with the client code from Step 1.
    載入此 URL 的結果應該類似下列範例:
    { 
      "api": "https://admin6.testandtarget.omniture.com/admin/rest/v1" 
    }
    
    
    在此範例中,"6" 是管理員編號。
  3. 下載 at.js。
    使用下列結構載入此 URL:
    https://admin<varname>admin number</varname>>.testandtarget.omniture.com/admin/rest/v1/libraries/atjs/download?client=<varname>client code </varname>version=<version number>
    
    
    • Replace admin number with your admin number.
    • Replace client code with the client code from Step 1.
    • Replace version number with the desired at.js version number (for example, 2.2).
    Target 團隊只會維護兩個 at.js 版本: 最新版本和次新版本。請視需要升級 at.js,以確保您執行的是支援的版本。如需每一個版本有何功能的詳細資訊,請參閱 at.js 版本詳細資料
    載入此 URL 會開始下載自訂的 at.js 檔案。

at.js implementation

at.js 應實作於網站上每個頁面的 <head> 元素中。
一般 Target 實作 (不使用 Adobe Launch 動態標籤管理 這類標籤管理程式) 看起來就像這樣:
<!doctype html> 
<html> 
 
<head> 
    <meta charset="utf-8"> 
    <title>Title of the Page</title> 
    <!--Preconnect and DNS-Prefetch to improve page load time--> 
    <link rel="preconnect" href="//<client code>.tt.omtrdc.net"> 
    <link rel="dns-prefetch" href="//<client code>.tt.omtrdc.net"> 
    <!--/Preconnect and DNS-Prefetch--> 
    <!--Data Layer to enable rich data collection and targeting--> 
    <script> 
        var digitalData = { 
            "page": { 
                "pageInfo": { 
                    "pageName": "Home" 
                } 
            } 
        }; 
    </script> 
    <!--/Data Layer--> 
    <!-- targetPageParams(), targetPageParamsAll(), Data Providers or targetGlobalSettings() functions to enrich the visitor profile or modify the library settings--> 
    <script> 
        targetPageParams = function() { 
            return { 
                "a": 1, 
                "b": 2, 
                "pageName": digitalData.page.pageInfo.pageName, 
                "profile": { 
                    "age": 26, 
                    "country": { 
                        "city": "San Francisco" 
                    } 
                } 
            }; 
        }; 
    </script> 
    <!--/targetPageParams()--> 
 
    <!--jQuery or other helper libraries should be implemented before at.js if you would like to use their methods in Target--> 
    <script src="jquery-3.3.1.min.js"></script> 
    <!--/jQuery--> 
    <!--Target's JavaScript SDK, at.js--> 
    <script src="at.js"></script> 
    <!--/at.js--> 
</head> 
 
<body> 
    The default content of the page 
</body> 
 
</html>

請考量下列重要注意事項:
  • 應使用 HTML5 Doctype (如 <!doctype html> )。不支援或舊版 doctype 可能會造成 Target 無法提出要求。
  • 「預先連結」和「預先擷取」可能有助於加速網頁載入。If you use these configurations, ensure that you replace <client code> with your own client code, which you can obtain from the Setup > Implementation > Edit at.js Settings ​page.
  • 如果有資料層,最好在 at.js 載入前,盡可能在網頁的 <head> 中詳細定義。這個位置能讓您在 Target 最大限度運用這類資料進行個人化。
  • 特殊 Target 函數 (如 targetPageParamsAll() targetPageParams() 、資料提供者和 targetGlobalSettings() ),應在資料層載入後和 at.js 載入前定義。此外,這些函數亦可儲存於「編輯 at.js 設定」頁面的「程式庫標題」部分,並存入 at.js 程式庫本身。如需特殊函數的詳細資訊,請參閱  at.js 函數
  • 如果使用 jQuery 等 JavaScript 輔助函式庫,請在 Target 前加入這些函式庫,以便在建立 Target 體驗時使用這些函式庫的語法和方法。
  • 在網頁的 <head> 中加入 at.js。

Track conversions

訂購確認 mbox 會記錄關於您的網站上訂單的詳細資料,並允許根據收入和訂單報告。訂購確認 mbox 也可以促進建議演算法,例如「購買了產品 x、也購買了產品 y 的使用者」
如果使用者在您的網站上進行購買,建議您實作訂購確認 mbox,即便您對報表使用 Analytics for Target (A4T) 亦然。
  1. 在訂單詳細資料頁面中,請依照下方的模式插入 mbox 指令檔。
  2. 使用目錄中的動態或靜態值來取代大寫的字母。
    請使用逗號來隔開多個產品 ID。
    提示: 您也可以在任何 mbox 中傳遞訂單資訊 (名稱不需是 orderConfirmPage )。您也可以將訂單資訊傳遞至同一個促銷活動中的多個 mbox。
    <script type="text/javascript"> 
    adobe.target.trackEvent({ 
        "mbox": "orderConfirmPage", 
        "params":{  
            "orderId": "ORDER ID FROM YOUR ORDER PAGE",  
            "orderTotal": "ORDER TOTAL FROM YOUR ORDER PAGE",  
            "productPurchasedId": "PRODUCT ID FROM YOUR ORDER PAGE, PRODUCT ID2, PRODUCT ID3"  
        } 
    }); 
    </script> 
    
    
「訂購確認」mbox 會使用下列參數:
參數
說明
orderId
要進行轉換計算之訂單的唯一識別值。
orderId 必須是唯一的。報表中會忽略重複的訂單。
orderTotal
購買貨幣值。
請勿加上貨幣符號。請使用小數點 (而非逗點) 表示小數值。
productPurchasedId (選用)
訂單中購買之產品 ID 的逗點分隔清單。
這些產品 ID 會顯示在稽核報表中,以支援其他報表分析。