使用API管理您的Recommendations目錄

最後更新： 2024年7月20日
  • 主題：

建立對象：

  • undefined

在確保您符合使用Recommendations API的要求時，您已瞭解如何使用JWT驗證流程來產生存取權杖，以便在Adobe Developer Console上使用Adobe Target管理API。

您現在可以使用Recommendations API來新增、更新或刪除建議目錄中的專案。 與其他Adobe Target Admin API一樣，Recommendations API需要驗證。

NOTE
每當您需要重新整理存取權杖以進行驗證時，請傳送​ IMS: JWT Generate + Auth via User Token ​請求，因為它會在24小時後過期。 如需指示，請參閱設定AdobeAPI驗證。

JWT3ff

繼續之前，請先取得Recommendations Postman集合。

使用儲存實體API建立和更新專案

若要使用API （而非CSV產品摘要或產品頁面上引發的Target請求）填入您的Recommendations產品資料庫，請使用儲存實體API。 此請求會在單一Target環境中新增或更新專案。 語法為：

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

例如，「儲存實體」可用於在達到某些臨界值時（例如存貨或價格的臨界值）更新專案，以標示這些專案並防止它們被建議。

  1. 導覽至「Target > Setup > Hosts > CONTROL Environments」以取得您要在其中新增或更新專案的目標環境ID。

    SaveEntities1

  2. 驗證TENANT_ID和API_KEY參考先前建立的Postman環境變數。 使用下圖來比較。 如有必要，請修改API請求中的標題和路徑，使其與以下影像中的標題和路徑相符。

    SaveEntities3

  3. 在​ 內文 ​中輸入您的JSON作為​ 原始 ​程式碼。 別忘了使用environment變數指定您的環境ID。 （在以下範例中，環境ID為6781。）

    SaveEntities4.png

    以下是將entity.id kit2001與Toaster Oven產品的關聯實體值新增到環境6781中的範例JSON。

        {
    "entities": [{
            "name": "Toaster Oven",
            "id": "kit2001",
            "environment": 6781,
            "categories": [
                "housewares:appliances"
            ],
            "attributes": {
                "inventory": 77,
                "margin": 23,
                "message": "crashing helicopter",
                "pageUrl": "www.foobar.foo.com/helicopter.html",
                "thumbnailUrl": "www.foobar.foo.com/helicopter.jpg",
               "value": 19.2
            }
        }]
    }

  4. 按一下​ Send。 您應會收到下列回應。

    SaveEntities5.png

    JSON物件可以調整規模，以傳送多個產品。 例如，此JSON會指定兩個實體。

        {
        "entities": [{
                "name": "Toaster Oven",
                "id": "kit2001",
                "environment": 6781,
                "categories": [
                    "housewares:appliances"
                ],
                "attributes": {
                    "inventory": 89,
                    "margin": 11,
                    "message": "Toaster Oven",
                    "pageUrl": "www.foobar.foo.com/helicopter.html",
                    "thumbnailUrl": "www.foobar.foo.com/helicopter.jpg",
                    "value": 102.5
                }
            },
            {
                "name": "Blender",
                "id": "kit2002",
                "environment": 6781,
                "categories": [
                    "housewares:appliances"
                ],
                "attributes": {
                    "inventory": 36,
                    "margin": 5,
                    "message": "Blender",
                    "pageUrl": "www.foobar.foo.com/helicopter.html",
                    "thumbnailUrl": "www.foobar.foo.com/helicopter.jpg",
                    "value": 54.5
                }
            }
        ]
    }

  5. 現在輪到你了！ 使用​ Save Entities API將下列專案新增至您的目錄。 使用上述範例JSON作為起點。 （您需要擴充JSON以包含其他實體。）

    SaveEntities6.png

看來最後兩個專案並不屬於。 讓我們使用​ Get Entity API檢查這些專案，必要時請使用​ Delete Entities API刪除它們。