管理自訂條件

有時Recommendations提供的演演算法無法呈現您想要促銷的特定專案。 在這種情況下,自訂條件提供了一種方法,可讓您為指定的關鍵專案或類別傳送一組特定的建議專案。

若要建立自訂條件,請定義並匯入關鍵專案或類別與建議專案之間的所需對應。 此程式在自訂條件檔案中說明。 如檔案中所述,您可以透過Target使用者介面(UI)建立、編輯和刪除自訂條件。 不過,Target也提供一組自訂條件API,讓您能夠對自訂條件進行更詳細的管理。

WARNING
對於自訂條件,請使用API針對指定的自訂條件執行所有動作(建立、編輯、刪除),或使用UI執行所有動作(建立、編輯、刪除)。 透過UI和API的組合管理您的自訂條件可能會導致資訊衝突或意外結果。 例如,在UI中建立自訂條件,但接著透過API編輯它,將不會在UI中反映您的更新,即使它將在後端更新,如透過API看到的一樣。

建立自訂條件

若要使用建立自訂條件API建立自訂條件,語法為:

POST https://mc.adobe.io/{{TENANT_ID}}/target/recs/criteria/custom

WARNING
使用建立自訂條件API建立的自訂條件(如本練習所述)將會顯示在UI中,且會持續存在。 您將無法從UI編輯或刪除它們。 您可以透過API 編輯或刪除它們,但無論如何它們將繼續出現在Target UI中。 若要保留從UI編輯或刪除的選項,請使用檔案中的UI來建立自訂條件,而不是使用「建立自訂條件API」。

閱讀上述警告並熟悉如何建立後續無法從UI刪除的新自訂條件後,才可繼續下列步驟。

  1. 驗證​ Create custom criteria ​的TENANT_IDAPI_KEY參考先前建立的Postman環境變數。 使用下圖來比較。

    CreateCustomCriteria1

  2. 將您的​ 內文 ​新增為定義自訂條件CSV檔案位置的​ 原始 JSON。 使用建立自訂條件API檔案中提供的範例作為範本,視需要提供您的environmentId和其他值。 在此範例中,我們使用LAST_PURCHASED作為索引鍵。

    CreateCustomCriteria2

  3. 傳送要求並觀察回應,其中包含您剛才建立的自訂條件詳細資料。

    CreateCustomCriteria3

  4. 若要確認您的自訂條件已建立,請在Adobe Target中導覽至​ Recommendations > Criteria ​並按名稱搜尋條件,或在下一個步驟中使用​ List Custom Criteria API

    CreateCustomCriteria4

在此案例中,我們有一個錯誤。 讓我們使用​ List Custom Criteria API ​更仔細地檢查自訂條件來調查錯誤。

清單自訂條件

若要擷取您所有自訂條件的清單,以及每個條件的詳細資訊,請使用清單自訂條件API。 語法為:

GET https://mc.adobe.io/{{TENANT_ID}}/target/recs/criteria/custom

  1. 像之前一樣驗證TENANT_IDAPI_KEY,並傳送要求。 在回應中,請記下自訂條件ID以及有關先前所述錯誤訊息的詳細資訊。
    ListCustomCriteria

在此情況下,發生錯誤是因為伺服器資訊不正確,表示Target無法存取包含自訂條件定義的CSV檔案。 讓我們編輯自訂條件來更正這個問題。

編輯自訂條件

若要變更自訂條件定義的詳細資料,請使用編輯自訂條件API。 語法為:

POST https://mc.adobe.io/{{TENANT_ID}}/target/recs/criteria/custom/:criteriaId

  1. 像之前一樣驗證TENANT_IDAPI_KEY
    EditCustomCriteria1

  2. 指定要編輯的(單一)自訂條件的條件ID。
    EditCustomCriteria2

  3. 在Body中,提供更新的JSON以及正確的伺服器資訊。 (對於此步驟,請指定您可存取之伺服器的FTP存取權。)
    EditCustomCriteria3

  4. 傳送要求並記下回應。
    EditCustomCriteria4

讓我們使用​ Get Custom Criteria API ​驗證更新後的自訂條件是否成功。

取得自訂條件

若要檢視特定自訂條件的自訂條件詳細資料,請使用取得自訂條件API。 語法為:

GET https://mc.adobe.io/{{TENANT_ID}}/target/recs/criteria/custom/:criteriaId

  1. 指定要取得其詳細資訊之自訂條件的條件ID。 傳送要求並檢閱回應。
    GetCustomCriteria.png
  2. 驗證成功。 (在此情況下,請確認沒有進一步的FTP錯誤。)
    GetCustomCriteria1.png
  3. (選用)驗證更新是否正確反映在UI中。
    GetCustomCriteria2.png

刪除自訂條件

使用先前所述的條件ID,使用刪除自訂條件API刪除您的自訂條件。 語法為:

DELETE https://mc.adobe.io/{{TENANT_ID}}/target/recs/criteria/custom/:criteriaId

  1. 指定您要刪除的(單一)自訂條件的條件ID。 按一下 Send
    DeleteCustomCriteria1

  2. 使用「取得自訂條件」確認已刪除條件。
    DeleteCustomCriteria2
    在這種情況下,預期的404錯誤表示找不到已刪除的條件。

NOTE
提醒您,即使條件已刪除,也不會從Target UI中移除,因為它是使用建立自訂條件API所建立。

恭喜!您現在可以使用Recommendations API建立、列出、編輯、刪除自訂條件,以及取得詳細資訊。 在下一節中,您將使用Target Delivery API來擷取建議。

<!—下堂課「使用伺服器端傳送API擷取Recommendations」> —>

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