實作Target而不使用標籤管理員

不使用標籤管理員或Adobe Experience Platform中的標籤實作Adobe Target的相關資訊。

NOTE
Adobe Experience Platform中的標籤是實作Target和at.js程式庫的偏好方法。 使用Adobe Experience Platform中的標籤來實作Target時,下列資訊不適用。

若要存取實作頁面,請按一下​ Administration > Implementation

您可以在此頁面指定下列設定:

  • 帳戶詳細資料
  • 實作方法
  • 設定檔API
  • 偵錯工具
  • 隱私權
NOTE
您可以覆寫at.js資料庫中的設定,而非在Target Standard/Premium UI中或使用REST API進行設定。 如需詳細資訊,請參閱 targetGlobalSettings()

帳戶詳細資料

您可以檢視下列帳戶詳細資料。 無法變更這些設定。

設定
說明
Client Code
使用者端代碼是使用Target API時通常需要的使用者端專用字元序列。
IMS Organization ID
此ID會將您的實施連結至Adobe Experience Cloud帳戶。
On-Device Decisioning

若要啟用裝置上決策,請將切換開關滑動至「開啟」位置。

裝置上決策可讓您在伺服器上快取A/B和體驗鎖定目標(XT)行銷活動,並以幾乎零延遲的執行記憶體內決策。 如需詳細資訊,請參閱裝置上決策簡介

Include all existing on-device decisioning qualified activities in the artifact

(視條件而定)如果您啟用裝置上決策,便會顯示此選項。

如果您希望所有符合裝置上決策資格的即時Target活動自動包含在成品中,請將切換滑至「開啟」位置。

若將此切換保持關閉,表示您必須重新建立並啟動任何裝置上決策活動,才能將其納入產生的規則成品中。

實作方法

您可在「實作方法」面板中設定下列設定:

全域設定

NOTE
這些設定會套用至所有Target .js資料庫。 在「實作方法」區段中執行變更後,您必須下載程式庫並在實作中更新。
設定
說明
Page load enabled (Auto-create global mbox)
選擇是否將全域 mbox 呼叫內嵌在 at.js 檔案中,以便每次載入頁面時自動觸發。
Global mbox

選取全域 mbox 的名稱。依預設,此名稱為 target-global-mbox。

對於at.js,mbox名稱中可以使用特殊字元(包括&)。

Timeout (seconds)

如果 Target 在已定義的期間內沒有回應內容,伺服器呼叫會逾時,並顯示預設內容。在訪客工作階段期間會繼續嘗試其他呼叫。預設值為 5 秒。

at.js程式庫使用XMLHttpRequest中的逾時設定。 逾時是在觸發要求時開始,並在Target從伺服器收到回應時停止。 如需詳細資訊,請參閱Mozilla開發人員網路上的XMLHttpRequest.timeout

如果在收到回應之前就發生指定的逾時,則會顯示預設內容,而訪客可能算為活動的參與者,因為所有資料收集都發生在Target邊緣。 如果請求到達Target邊緣,訪客即納入計算。

設定逾時設定時,請考量下列事項:

  • 如果值太低,即使訪客應該算為活動的參與者,使用者還是可能幾乎都看到預設內容。
  • 如果值太高,而如果您長時間使用本文隱藏,訪客可能會在網頁上看到空白區域或空白頁面。

若要充分瞭解 mbox 回應時間,請在瀏覽器的開發人員工具中查看「網路」標籤。您也可以使用第三方 Web 效能監控工具,例如 Catchpoint。

注意visitorApiTimeout設定可確保Target不會為了訪客API回應而等待太久。 此設定和這裡說明的 at.js 逾時設定不影響彼此。

Profile Lifetime

此設定會決定訪客設定檔儲存多久。依預設,訪客設定檔會儲存兩週。此設定最多可增加90天。

若要變更設定檔存留期設定,請連絡客戶服務

主要實作方法

NOTE
Adobe Target同時支援at.js 1。x 和 at.js 2 中的 Hide Body 和 Show Body 呼叫。x 使用供跨網域追蹤功能時。 升級至任一主要版本的at.js最新更新,以確保您執行的是支援的版本。

若要下載所需的at.js版本,請按一下適當的「下載」按鈕。

若要編輯at.js設定,請按一下所需at.js版本旁的​ Edit

WARNING
在變更這些預設設定之前,請先洽詢客戶服務,以免影響您目前的實作。

除了上述設定以外,您也可以使用下列特定的at.js設定:

設定
說明
跨網域
針對at.js v1。x,藉由選取enabled (瀏覽器同時設定第一方和第三方Cookie),指定跨網域功能是disabled (僅瀏覽器在您的網域中設定Cookie (第一方Cookie))、x only (僅瀏覽器在Target的網域中設定Cookie)或兩者皆有。 針對at.js v2.10和更新版本,請指定跨網域功能是enabled (瀏覽器同時設定第一方和第三方Cookie)還是disabled (瀏覽器未設定第三方Cookie)。
自訂資料庫標題
新增任何自訂 JavaScript 以包括在資料庫頂端。
自訂資料庫頁尾
新增任何自訂 JavaScript 以包含在程式庫底部。

設定檔API

啟用或停用透過 API 批次更新的驗證,並產生設定檔驗證 Token。

如需詳細資訊,請參閱設定檔API設定

偵錯工具

產生授權權杖以使用進階Target偵錯工具。 按一下 Generate New Authentication Token

產生新驗證權杖

隱私權

這些設定可讓您在遵守適用資料隱私權法律的情況下使用Target。

從「模糊化訪客IP位址」下拉式清單中選擇所需的設定:

  • 最後一個八位元模糊化
  • 整個IP模糊化

如需詳細資訊,請參閱隱私權

NOTE
「舊版瀏覽器支援」選項可在at.js版本0.9.3和更早版本中取得。 at.js 0.9.4 版中移除了此選項。如需 at.js 支援的瀏覽器清單,請參閱支援的瀏覽器
舊版瀏覽器是指不完全支援 CORS (跨來源資源共用) 的舊型瀏覽器。這些瀏覽器包括 Internet Explorer 瀏覽器 11 版以前的版本,以及 Safari 6 版及更舊版本。如果停用舊版瀏覽器支援,Target就不會在這些瀏覽器的報表中傳送內容或計算訪客。 如果已啟用此選項,建議在舊版瀏覽器上執行品質保證,以確保良好的客戶體驗。

下載 at.js

使用Target介面或下載API來下載程式庫的指示。

NOTE
Adobe Experience Platform是實作Target和at.js程式庫的偏好方法。 使用Adobe Experience Platform中的標籤來實作Target時,下列資訊不適用。
Adobe Target同時支援at.js 1。x 和 at.js 2 中的 Hide Body 和 Show Body 呼叫。x 使用供跨網域追蹤功能時。 請升級至任一主要版本at.js的最新更新,以確保您執行的是支援的版本。 如需每一個版本有何功能的詳細資訊,請參閱 at.js 版本詳細資料

使用Target介面下載at.js

若要從Target介面下載at.js:

  1. 按一下​ Administration > Implementation
  2. 在「實作方法」區段中,按一下所需at.js版本旁的​ Download ​按鈕。

使用Target下載API下載at.js

若要使用API下載at.js。

  1. 取得用戶端程式碼。

    您的使用者端代碼可在Target介面的​ Administration > Implementation ​頁面最上方取得。

  2. 取得您的管理員編號。

    載入此 URL:

    code language-none
    https://admin.testandtarget.omniture.com/rest/v1/endpoint/<varname>client code</varname>
    

    以步驟1中的使用者端代碼取代client code

    載入此 URL 的結果應該類似下列範例:

    code language-none
    {
      "api": "https://admin6.testandtarget.omniture.com/admin/rest/v1"
    }
    

    在此範例中,"6" 是管理員編號。

  3. 下載at.js。

    使用下列結構載入此URL。 載入此URL會開始下載自訂的at.js檔案。

    code language-none
    https://admin<varname>admin number</varname>.testandtarget.omniture.com/admin/rest/v1/libraries/atjs/download?client=<varname>client code</varname>&version=<version number>
    
    • admin number取代為您的管理員編號。
    • 以步驟1中的使用者端代碼取代client code
    • 以所需的at.js版本號碼(例如2.2)取代version number
WARNING
Target團隊只會維護兩個版本的at.js:最新版本和次新版本。 請視需要升級at.js,以確保您執行的是支援的版本。 如需每一個版本有何功能的詳細資訊,請參閱 at.js 版本詳細資料

at.js 實作

at.js 應實作於網站上每個頁面的 <head> 元素中。

未使用標籤管理程式(例如Adobe Experience Platform中的標籤)的典型Target實作如下所示:

<!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>)。 不受支援或較舊的doctypes可能會導致Target無法發出請求。
  • 「預先連結」和「預先擷取」可能有助於加速網頁載入。如果您使用這些組態,請確定您將<client code>取代為您自己的使用者端代碼,您可從​ Administration > Implementation ​頁面取得此代碼。
  • 如果有資料層,最好在 at.js 載入前,盡可能在網頁的 <head> 中詳細定義。此位置提供在Target中使用此資訊進行個人化的最大能力。
  • 特殊Target函式(例如targetPageParams()targetPageParamsAll()、資料提供者和targetGlobalSettings())應在資料層載入後和at.js載入前定義。 或者,這些函式可以儲存在「編輯at.js設定」頁面的「資料庫標題」區段中,並儲存為at.js資料庫本身的一部分。 如需這些函式的詳細資訊,請參閱at.js函式
  • 如果您使用JavaScript協助程式庫(例如jQuery),請在Target之前加入這些程式庫,以便在建置Target體驗時使用這些程式庫的語法和方法。
  • 在網頁的 <head> 中加入 at.js。

追蹤轉換

訂購確認 mbox 會記錄關於您的網站上訂單的詳細資料,並允許根據收入和訂單報告。訂購確認 mbox 也可以促進建議演算法,例如「購買了產品 x、也購買了產品 y 的使用者」

NOTE
如果使用者在您的網站上進行購買,Adobe建議您實作訂單確認mbox,即使您對報表使用Analytics for Target (A4T)亦然。
  1. 在訂單詳細資料頁面中,請依照下方的模式插入 mbox 指令檔。

  2. 使用目錄中的動態或靜態值來取代大寫的字母。

    note tip
    TIP
    您也可以在任何mbox中傳遞訂單資訊(名稱不需是orderConfirmPage)。 您也可以將訂單資訊傳遞至同一個促銷活動中的多個 mbox。
    code language-none
    <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>
    
NOTE
在訂單確認mbox中,使用逗號分隔多個產品ID。

「訂購確認」mbox 會使用下列參數:

參數
說明
orderId

要進行轉換計算之訂單的唯一識別值。

orderId 必須是唯一的。報表中會忽略重複的訂單。

orderTotal

購買貨幣值。

請勿傳遞貨幣符號。請使用小數點 (而非逗點) 表示小數值。

productPurchasedId (選用)

訂單中購買之產品 ID 的逗點分隔清單。

這些產品 ID 會顯示在稽核報表中,以支援其他報表分析。

recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3