限制

字元限制和其他限制清單 (選件大小、對象、設定檔、值、參數等)會對 Adobe Target 中的活動和其他元素造成影響的資訊。

活動

活動名稱

• 上限：250 個字元。

每個帳戶的活動數

• 建議的限制；10,000 個使用中的上線活動。

• 建議的限制；10,000 個使用中的已儲存 (未結束) 活動。

Target API 呼叫

• 限制：管理、報告和大量設定檔更新 API 每分鐘 50 次呼叫。此限制不適用於傳送和單一設定檔更新 API。

  如果您每分鐘進行超過 50 次 API 呼叫，Target 會傳回「503 HTTP 狀態」錯誤訊息。

對象

對象名稱

• 上限；255 個字元。

對象，可依每個帳戶重複使用

• 建議的限制；20,000 個對象。

每個 mbox、量度或體驗的對象數

• 限制：50 個對象。

categoryId 參數

• 上限：256 個字元。

內容傳遞

• 上限：每個用戶工作階段 100 個同時 Target 內容傳遞請求。

  如果客戶超過指定用戶工作階段的 100 個同時 Target 內容傳遞請求，則該用戶工作階段的所有後續請求都將被封鎖。如果在收到任何請求的回應之前，向 Target 伺服器傳送兩個或多個請求，則這些請求均視為同時。Target 會依序處理相同工作階段的同時請求。

• 錯誤行為：

  • Delivery API 和批次 mbox v2：
    • 錯誤碼：HTTP 420 請求數太多
    • 錯誤訊息：「相同工作階段 ID 的請求數太多」
  • 舊版 mbox API：
    • 預設內容與註解：「相同工作階段 ID 的請求數太多」
  • at.js:
    • 顯示預設內容

客戶屬性

客戶屬性名稱

• 上限；250 個字元，透過摘要或 API。

客戶屬性別名 ID

• 上限 50 個字元。

客戶屬性，上載

• 使用HTTP方法的每個上載檔案大小上限：100 MB。
• 使用FTP方法每次上載的檔案大小上限：4 GB。
• 允許訂閱的屬性數：Target Standard 5個，Target Premium 200個。

實體

實體數

• 可在設計中參照 (明確寫在程式碼中或透過迴圈) 的實體數上限是 99。
• 為獲得最佳效能，建議的限制是在每個環境中讓目錄少於一百萬個項目，並在所有環境中讓目錄少於一千萬個項目。
• 每個環境的上限為一千萬個項目，所有環境的上限為一億個項目。 如果您在每個環境中擁有的項目介於一百萬個和一千萬個之間，目錄搜尋 UI 的效能會受到影響。 然而，Target Recommendations 會持續產生及傳送建議。

實體自訂屬性

• 自訂實體屬性：100。

• 字元限制：字元長度上限視語言而定。

  • 15,000 個字元 (單值、單位元和雙位元語言)
  • 500 個值，每個值 100 個字元 (多值)

  單值實體自訂屬性的長度上限為 15,000 個字元 (適用於單位元組和雙位元組 UTF-8 編碼語言，例如英文和其他拉丁字母) 或 10,000 個字元 (適用於三位元組 UTF-8 編碼語言，例如中文、日文和韓文)。

  多值實體自訂屬性不得包含超過 500 個值。每個個別值限定為 100 個字元以內。所有值的總字元數必須符合單值實體自訂屬性之長度上限的限制 (如上所述)。

entity.id

• 需要擷取購買資訊的實施限制：50 個字元

  由於 productPurchasedId mbox 參數會擷取 entity.ids，其字元計數限制為 50，因此會強制執行此限制。

• 僅需檢視型演算法的實施限制：1,000 個字元

  檢視型演算法包括檢視/檢視、最常檢視、最近檢視等。

excludedIds

• 上限：5 KB (適用於 POST 要求)。2,083 個字元減去 GET 要求的 URL 的長度。

  若為 GET 要求，雖然後端的上限為 5 KB，由於事實上 Microsoft Internet Explorer 將 URL 限制為 2,083 個字元，實際上限為 2,083 個字元減去目前的 URL 長度。

體驗

體驗名稱

• 上限；50 個字元。

每個活動的體驗

• 上限：每個體驗鎖定目標 (XT)、A/B 測試、多變數測試 (MVT) 和自動鎖定目標活動最多 2,000 個體驗。

  每個 Automated Personalization (AP) 活動最多 30,000 個體驗。

根據體驗進行修改

• 上限：任何活動的每個體驗 50 次修改

mboxes

In-mbox 設定檔屬性值

• 上限：256 個字元。

  超過限制的值會遭截斷。

In-mbox 設定檔名稱

• 上限：128 個字元。

mbox 名稱

• 上限：250 個字元。

mbox 參數

• 上限：下列上限適用於 mbox 參數:

  對於標準 mbox 呼叫：

  • mbox 參數；每個 mbox 500 個參數。
  • 設定檔參數：每個 mbox 有 500 個參數設定檔參數。
  • 其他參數 (URL、參照的 URL 等)：各參數類型每個 mbox 50 個。

  除非要求因網頁瀏覽器限制而縮短，否則適用上述限制。

  如果您使用「批次傳送API」，則每個批次請求的限制為 50 個 mbox。

  如果您在 Mobile Services SDK 使用批次傳送 API，50 個 mbox 參數、50 個設定檔參數和 50 個其他參數類型限制，即為 API 本身限制。無法使用批次傳送 API，傳送超過上述數量限制的要求。如果請求包含的限制超過這些限制，API會傳回下列錯誤訊息：

  「mboxParameters 的數目不能超過 50。」

  端點限制集：

  批次 mbox v2:

  • mbox 參數 100
  • mbox 參數名稱最大長度 128
  • mbox 參數值不能為 null
  • mbox 參數值 5000
  • 設定檔參數 50
  • 設定檔參數名稱最大長度 128
  • 設定檔參數值不能為 null
  • 設定檔參數值最大長度 256

  傳送 API 端點：

  • mbox 參數 100
  • mbox 參數名稱最大長度 128
  • mbox 參數值不能為 null
  • mbox 參數值 5000
  • 設定檔參數 50
  • 設定檔參數名稱最大長度 128
  • 設定檔參數值不能為 null
  • 設定檔參數值最大長度 256

mbox 要求 URL

• 上限：2,083 個字元。

  此上限是因為 Microsoft Internet Explorer URL 長度限制。

mbox3rdPartyId 參數

• 上限：60 個字元。

選件

選件名稱

• 上限：250 個字元。

實體數

• 建議的限制；總共 50,000 個選件。

選件大小

下列大小限制適用於選件：

• HTML 選件為 1024 KB。

• UI 提供的視覺化選件有 1024 KB (每個體驗)。

• 來自 API 1024 KB.

  如果使用全域 mbox，此上限適用於針對頁面傳回的整組內容。限制選件大小可改進頁面載入時間。如果超過限制，會顯示下列訊息：

  「體驗的內容過大，無法傳送。請修改體驗，降低影響的頁面代碼。」

orderId 參數

• 建議的限制：120 個字元。

orderTotal 參數

• 建議的限制：120 個字元。

productPurchasedId 參數

• 限制：每個逗號分隔值 50 個字元，總共 250 個字元。超過 50 個字元的個別值會被系統截斷。超過 250 個字元的總長度會導致 400 錯誤。

設定檔指令碼

• 建議的作用中設定檔指令碼限制 (已啟用者)：300

• 建議的每個帳戶設定檔指令碼總數限制：2,000

• Recommendations 限制設定檔指令碼複雜度：設定檔指令碼可執行有限數量的指令。如需詳細資訊，請參閱​設定檔屬性​中的最佳實務。

屬性

• 建議的限制：5,000 個屬性。

報表對象/區段

• 上限：每個活動 50 個報表對象/區段。

Target UI 中的指令碼設定檔輸入方塊

• 建議的限制：2,000 個字元。

  依編碼字串的大小而定，可能比原始字串大許多。如果字串太長，還未送到 Adobe Target 就會失敗。

設定檔指令碼

指令碼設定檔名稱

• 上限：50 個字元。

指令碼設定檔值

• 上限：2,048 個字元。

  基於效能考量，我們建議傳回的值不要超過 256 個字元。

  針對字串傳回值，如果傳回值的大小超過 2,048 個字元，系統會停用指令碼。

  針對陣列傳回值，如果陣列的連接值大小超過 2,048 個字元，系統會停用指令碼。

成功量度

• 上限：每個活動 200 個。

目標定位

Target 條件

• 建議的限制：1,000 個值。

  這是指定位文字區域中以行分隔之值的數目。例如，在郵遞區號定位中輸入 1,000 個郵遞區號。

鎖定目標規則

• 建議的限制：每個定位規則值2,500個字元。
• 建議的限制：各個鎖定目標規則中每個對象 30,000 個不重複的值。
• 建議的限制：每個活動 100,000 個不重複的鎖定目標規則值。