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

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

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

若要存取「實作」頁面,請按一下​管理 > 實作

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

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

帳戶詳細資料

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

設定
說明
使用者端代碼
使用者端代碼是使用Target API時通常需要的使用者端專用字元序列。
IMS組織ID
此ID會將您的實施連結至Adobe Experience Cloud帳戶。
裝置上決策

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

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

在成品中包含所有現有的裝置上決策合格活動

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

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

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

實作方法

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

全域設定

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

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

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

逾時(秒)

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

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

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

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

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

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

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

設定檔存留期

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

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

主要實作方法

NOTE
Adobe Target同時支援at.js 1.x​和at.js 2.x。 升級至任一主要版本的at.js最新更新,以確保您執行的是支援的版本。

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

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

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偵錯工具。 按一下​產生新驗證權杖

產生新驗證權杖

隱私權

這些設定可讓您在遵守適用資料隱私權法律的情況下使用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.x。 請升級至任一主要版本at.js的最新更新,以確保您執行的是支援的版本。 如需每一個版本有何功能的詳細資訊,請參閱 at.js 版本詳細資料

使用Target介面下載at.js

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

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

使用Target下載API下載at.js

若要使用API下載at.js。

  1. 取得用戶端程式碼。

    您的使用者端代碼可在Target介面的​管理 > 實作​頁面最上方取得。

  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>取代為您自己的使用者端代碼,您可以從​管理 > 實作​頁面取得此代碼。
  • 如果有資料層,最好在 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
target-dev-help-dev