Recommendations 常見問題集

關於Adobe Target Recommendations活動的常見問題(FAQ)清單。

當我搜尋具有數值的自訂屬性時，目錄搜尋為何無法顯示正確的結果？

當您對具有數值的自訂屬性執行目錄搜尋時，結果會將自訂屬性視為字串類型，而非數值。

目前，沒有可讓客戶變更屬性類型的功能。 要進行更改，請開啟一個客戶問題，該問題引用需要將類型從字串更改為數字的屬性。

目錄中的項目更新要多久時間才會反映在網站上?

匯入摘要檔案之後，或是透過 API 或 mbox 收到實體更新之後，將會在 60 分鐘以內反映下列變更:

• 設計範本中傳回的項目屬性。
• 全域排除規則中使用的項目屬性，可防止傳回的建議中包含該項目。
• 條件的包含規則中使用的項目屬性，這會影響是否要再傳回的建議中包含或排除項目。

在下一個演算法執行作業發生之前 (在 12 至 24 小時內)，不會反映下列變更:

• 用於活動的收集規則中使用的項目屬性。
• 促銷活動中使用的項目屬性，根據與活動相關聯的屬性或集合。
• 項目類別，項目會出現在最暢銷商品或檢視次數最多演算法中的「目前類別」或「最喜愛類別」。
• 建議項目排名 (在已變更的屬性是用來作為演算法自訂金鑰的自訂屬性的情況下)。
• 根據已變更屬性的建議項目排名 (在建議邏輯為「具有類似屬性的項目」、已使用「內容相似度」加權因數，或是在已使用「屬性加權」因數的情況下)。

如果特殊字元破壞陣列，怎麼辦?

在 JavaScript 中使用逸出值。引號 ( " ) 會破壞陣列。下列程式碼片段是逸出值的範例:

#set($String='') 
#set($escaper=$String.class.forName('org.apache.commons.lang.StringEscapeUtils')) 
<script type="text/javascript"> 
console.log("$escaper.escapeJavaScript($entity1.name)") 
console.log("$escaper.escapeJavaScript($entity2.name)") 
console.log('$escaper.escapeJavaScript($entity3.name)') 
names.push("$escaper.escapeJavaScript($entity4.name)") 
</script>

建立「建議」活動時，為何不是所有條件都可供選擇，包括自訂條件?

可用的條件取決於目前類別。建立建議選件時，演算法選擇器會根據類別 ID 來顯示條件。

如果您套用此條件的位置不含類別 ID，則某些條件不會出現在演算法選擇器中。

如果您使用的位置有類別 ID 存在於 mbox 中，則條件選擇器會包含所有適用的條件。

Target 具有篩選不相容的條件設定，可控制演算法選擇器的智慧型篩選。

若要存取篩選不相容的條件設定，請按一下「建議 > 設定」:

如果「未」啟用篩選不相容的條件設定，Target 就不會篩選「演算法選擇器」中的篩選演算法，所有演算法都會出現。

如果篩選不相容的條件設定已啟用，則在 VEC 活動中，Target 會從選取的位置讀取 entityId 和 categoryId，然後根據 currentItem|currentCategory 來顯示演算法 (如果各自的值存在該位置上)。因此，依預設，演算法選擇器中只會顯示所選位置的相容演算法。

如果篩選不相容的條件設定已啟用，您仍可在選取條件時取消選取「相容」核取方塊，以檢視不相容的演算法。

下列清單包含 Target 未顯示「相容」核取方塊的特殊情況:

• entityId 和 categoryId 都存在位置上，所以完全不篩選。
• 您使用 mbox.js 55 版或更舊版本。
• 未從頁面上觸發任何 mbox (!config.isAutoCreateGlobalMbox && !config.isRegionalMbox)
• Target 參數未定義。

如果「建議」中的集合變成零 (0)，怎麼辦?

如果您看到一個集合原先不是零而現在變成零，請考量下列資訊:

• 您可以重新儲存集合，檢查數字是否會更新。請注意，重新儲存會讓集合重新執行所有用到該集合的演算法。

• 您所看的環境對嗎? 請移至 /target/products.html#recsSettings 仔細檢查 (如下所示)。

  

• 索引是最新的嗎? 請移至 /target/products.html#productSearch，檢查索引是幾小時以前編列的 (例如「3 小時前已編列索引」)。您可以視需要重新整理索引。

• 您是否更動過摘要或資料層，而導致實體不再符合收集規則? 請確定「大小寫」相符 (區分大小寫)。

• 摘要執行成功嗎? 有人變更過 FTP 目錄、密碼…等等嗎?

• Target 會儘力讓傳送儘快更新 (在客戶的頁面/應用程式上)。然而，我們還是必須在 UI 上為市場行銷人員提供一些表示法。我們不一定會為了等待 UI 更新同步而延遲傳送更新。您可以使用 mboxTrace 查看當請求進來時系統中有什麼。

一般「屬性加權」和「內容相似度」特有的屬性加權之間有何差異?

屬性加權有兩種形式:「標準屬性加權」和「內容相似度屬性加權」。

「標準屬性加權」適用於大部分 (但不是全部) 條件類型 (不只是「內容相似度」)。這種加權會給某些屬性值更多權重。在下列範例中，輸出建議中會多一些 Nike 產品。

「內容相似度屬性加權」僅適用於內容相似度條件。

這種加權較動態，而且是根據目前的「建議金鑰」(目前檢視的項目)。在下列範例中 (品牌 x 16)，如果訪客在檢視 Nike 運動鞋，就很可能向該訪客建議其他 Nike 產品 (不一定是運動鞋)，而不是競爭者的運動鞋。如果訪客在檢視 Adidas 運動鞋，則很可能向該訪客建議 Adidas 產品。

為何 Target 有時無法顯示建議?

Target 有時會因為可用的建議數量不夠而無法顯示建議。

每個條件產生的值數量是設計中指定之實體數量的 3 倍。產生 3 倍的值之後會套用執行階段篩選 (例如、詳細目錄、mbox 屬性比對)，最後在傳送時可能會少於 3 倍的值。若要減少這種情況發生，請隱藏其他實體來增加設計中的實體數量。

可以在設計開始時使用以下 JavaScript 來增加請求實體的數量。在此範例中，請求的實體計數為 30 (3x10)。

#foreach($entity in $entities) 
 #if( $foreach.count > 10 ) 
  #break 
 #end 
 #set ($foo = $entity.id) 
#end 

插入/更新產品之 API 呼叫的大小限制是多少? 我是否可以使用 API (而非動態消息) 更新某次呼叫中的 50,000 種產品?

Target 在應用程式層級實施 50 MB 的限制；但是，只有當您傳遞 application/x-www-form-urlencoded 內容類型標頭時才會實施該限制。

您當然可以嘗試在單一呼叫中傳送 50,000 個產品。如果失敗，您應該將其分成幾個批次。我們通常建議客戶將其呼叫分成 5,000 或 10,000 個產品批次，以降低系統負載造成逾時的可能性。

建立建議條件、促銷活動或範本測試規則時，是否需要指定 mbox 名稱?

根據 mbox 參數建立建議條件、促銷活動或範本測試規則時，mboxParameter 不再提示您輸入 mboxName。mbox 名稱現在是可選項目。此變更可讓您使用多個 mbox 中的參數，或參考尚未記錄在 Edge 上的參數。

若要選取需要的參數:

• 建立新條件、促銷活動或範本測試規則時，請從清單中選取參數名稱，開始輸入所需參數名稱的第一個字元，或輸入所需參數名稱的完整名稱。
• 如果您記得 mbox 名稱，但不記得參數名稱，請使用核取方塊來篩選會傳遞所需參數的確定 mbox。

不論使用哪一種方法，mbox 和參數之間並沒有任何連結。條件、促銷活動或範本測試規則將根據傳遞該參數之所有 mbox 的參數運作。

如果編輯現有條件、促銷活動或範本測試規則，則篩選條件將顯示建立期間提供的 mbox 名稱。

定義新對象後，為何無法儲存舊版 Recommendations 活動?

請確定對象有唯一的名稱。若您為對象指定了與現有對象相同的名稱，則無法儲存舊版 Recommendations 活動 (2016 年 10 月以前建立的 Recommendations 活動)。

用於摘要上傳之 CSV 檔案的檔案大小上限是多少?

摘要的 CSV 檔案上傳對於資料列數量或檔案大小並沒有嚴格限制。但是，作為最佳作法，我們建議將 CSV 檔案大小限制為 1 GB，以避免檔案上傳處理期間失敗。若檔案大小超過 1 GB，最好將其分割成多個摘要檔案。自訂屬性欄數的上限為 100，而自訂屬性限制為 4096 個字元。「Target 限制」頁面上提供了對於所需欄長度的其他限制。

是否可以動態地排除實體?

在查詢字串中，您可以傳遞要從建議中排除之實體的實體 ID。例如，您可以排除已在購物車中的項目。

若要啟用排除功能，請使用 excludedIds mbox 參數。此參數指向逗號分隔的實體 ID 清單。例如, mboxCreate(..., "excludedIds=1,2,3,4,5")。要求建議時會傳送值。

排除僅針對目前的Target呼叫執行；後續Target呼叫中不會排除項目，除非再次傳遞excludedIds值。 若要從每個頁面上的建議中排除購物車中的項目，請繼續在每個頁面上傳遞excludedIds值。

若要排除entityIds，請將&excludes=${mbox.excludedIds}代號附加至選件內容URL。 擷取內容 URL 時，目前的 mbox 請求參數會替代必要參數。

依預設，新建立的建議會啟用此功能。必須儲存現有的建議來支援動態排除的實體。

Recommendations內容追蹤中有時傳回的NO_CONTENT回應代表什麼意思？

當請求的演算法和索引鍵組合無法使用建議時，會傳回NO_CONTENT。 一般而言，當演算法的備份停用，且下列一或多個項目也成立時，就會發生此情況：

• 結果尚未準備好。

  這通常發生在首次儲存新建立的活動時，或在變更活動中使用的系列、標準或促銷的設定後。

• 對於請求的演算法／鍵組合，結果已準備就緒，但尚未在最近的邊緣伺服器快取。

  剛提出的請求會啟動快取作業，因此在重新載入數個頁面及／或經過幾分鐘後，應自行解析。

• 結果已就緒，但無法用於提供的鍵值。

  這通常發生在為最近演算法執行後新增至目錄的項目請求建議，並會在下次演算法執行後自行解析時。

• 部分範本轉譯已停用，而且沒有足夠的結果可填滿範本。

  這通常發生在您有動態包含規則時，該規則會從可能的結果中積極篩選許多項目。 要避免此情況，請啟用備份，不要將包含規則應用於備份，或者使用條件順序和不那麼激進的篩選條件。