[可用性限制]{class="badge informative" title="僅限已移轉Campaign Standard的使用者使用"}
建議與限制 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會傳回空白值。 所有捨棄的欄位都將被取代和移除。
使用連結的資源張貼
使用下列要求內文格式時,「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工作流程GET API會傳回引數名稱,例如工作流程例項變數及其資料型別(布林值、字串等)。 用來在透過POST API呼叫觸發訊號時建立適當格式化的JSON要求內文。
Campaign v8不支援廣告工作流程執行個體變數,但預期開發人員會知道這些變數。 因此,在移轉後,若沒有GET API回應中的引數資訊,就必須建構POST要求內文中的引數資訊。