[可用性限制]{class="badge informative" title="僅限Campaign Standard已移轉的使用者"}
Recommendations與限制 limitations
許可權與安全性 permissions
產品設定檔對應
在Campaign Standard中,無論您獲指派的產品設定檔為何,皆已授予您較高許可權的API管理員角色存取權。 Campaign v8引入一組不同的產品設定檔,需要從Campaign Standard對應到Campaign v8產品設定檔。
移轉後,會將兩個產品設定檔新增至您現有或預先建立的技術帳戶:管理員和訊息中心(用於存取交易API)。 如果您不希望管理員產品設定檔對應至您的技術帳戶,請檢閱產品設定檔對應,並指派所需的產品設定檔。
租使用者ID
移轉後,對於未來的任何整合,建議在REST URL中使用您的 Campaign v8租使用者ID,取代您之前的Campaign Standard租使用者ID。
金鑰使用方法
Campaign Standard和Campaign v8的PKey值管理方式不同。 如果您使用Campaign Standard儲存PKeys,請確定您的實作會使用從先前API呼叫取得的PKeys或href,以動態方式形成後續API呼叫。
可用的API deprecated
目前,下列REST API可供使用:
- 設定檔
- 服務與訂閱
- 自訂資源
- 工作流程
- 行銷歷史記錄
- 組織單位
- 隱私權管理
篩選
-
若要在REST API裝載中使用篩選器,您需要在Campaign v8中編輯篩選器,並提供要在裝載中使用的名稱。 若要這麼做,請從 引數 索引標籤存取篩選器的其他引數,並在REST API 欄位的 篩選名稱中提供所需的名稱。
-
使用自訂篩選器所需的「by」首碼已不再需要。 篩選器名稱的使用方式應與請求相同。
範例:
GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServicesExt/<resourceName>/<customFilterName>?<customFilterparam>=<customFilterValue>
捨棄的資料庫欄位
移轉期間會捨棄資料庫中的部分欄位。 使用下拉欄位時,REST API會傳回空白值。 所有捨棄的欄位都將被取代和移除。
使用連結的資源POST
使用以下要求內文格式時,「vehicleOwner」代表「nms:recipient」的連結:
{
"vehicleNumber": "20009",
"vehicleName": "Model E",
"vehicleOwner":{
"firstName":"tester 11",
"lastName":"Smith 11"
}
}
連結資訊會被忽略。 因此,「cusVehicle」下會產生只包含「vehicleNumber」和「vehicleName」值的新記錄。 不過,連結仍保持空值,導致「vehicleOwner」設定為null。
在Campaign v8中,當使用相同的要求內文結構且「vehicle」連結至設定檔時,會發生錯誤。 發生此錯誤是因為「firstName」屬性無法辨識為「cusVehicle」有效。 不過,請求內文僅包含屬性,卻不包含連結函式,且沒有任何問題。
PATCH作業
- Campaign v8不支援具有空白請求本文的PATCH:它會傳回204無內容狀態。
- 雖然Campaign Standard支援對結構描述中的元素/屬性進行PATCH,但請注意,Campaign v8不支援對位置進行PATCH操作。 嘗試在位置PATCH將導致500內部伺服器錯誤,並出現錯誤訊息,指出「zipCode」屬性對「profile」資源無效。
REST回應
下節列出Campaign Standard和v8 REST回應之間的細微差異。
- 對於單一GET記錄,回應會將href納入回應中。
- 使用屬性查詢時,Campaign v8會在回應中提供計數和分頁。
- POST作業後,回應中會傳回連結資源的值。
錯誤碼和訊息
下節列出Campaign Standard與Campaign v8錯誤代碼和訊息之間的差異。
設定檔 — 時區
透過Campaign Standard,時區會顯示為 profileAndServices/profile REST API呼叫的JSON回應的一部分。
使用Campaign v8時,時區只會顯示為 profileAndServicesExt/profile REST API呼叫的一部分。 它不是 profileAndServices/profile REST API呼叫的一部分,因為它已新增至擴充型結構描述。
工作流程 — 外部訊號觸發
Campaign Standard工作流程GETAPI會傳回引數名稱,例如工作流程例項變數及其資料型別(布林值、字串等)。 當透過POSTAPI呼叫觸發訊號時,可用來建立適當格式化的JSON要求內文。
Campaign v8不支援廣告工作流程執行個體變數,但預期開發人員會知道這些變數。 因此,在移轉後,若沒有POSTAPI回應中的引數資訊,就必須建構GET要求內文中的引數資訊。