Recommendationsと制限事項
作成対象:
- 経験者
- 開発者
権限とセキュリティ
製品プロファイルのマッピング
Campaign Standardとして、割り当てられている製品プロファイルに関係なく、API に対する昇格された管理者の役割アクセスが付与されました。 Campaign v8 では、異なる製品プロファイルセットが導入されており、Campaign Standardから Campaign v8 製品プロファイルへのマッピングが必要です。
移行すると、既存または事前作成済みのテクニカルアカウントに、管理者と Message Center (トランザクション API へのアクセス用)の 2 つの製品プロファイルが追加されます。 製品プロファイルのマッピングを確認し、管理者の製品プロファイルがテクニカルアカウントにマッピングされないようにする場合は、必要な製品プロファイルを割り当てます。
テナント ID
移行後、今後の統合では、以前のCampaign Standardテナント ID を置き換えて、REST URL で Campaign v8 テナント ID を使用することをお勧めします。
主な使用方法
PKey 値の管理は、Campaign Standardーと Campaign v8 では異なります。 Campaign Standardを使用して PKeys を保存していた場合は、以前の API 呼び出しから取得した PKeys または href を使用して、以降の API 呼び出しが動的に作成されるようにします。
使用可能な API
現時点では、以下に示す 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"
}
}
リンク情報は無視されます。 その結果、「vehicleNumber」と「vehicleName」の値のみを含んだ新規レコードが「cusVehicle」の下に生成されます。 ただし、リンクは null のままなので、「vehicleOwner」が null に設定されます。
Campaign v8 で同じリクエスト本文構造を使用し、「vehicle」がプロファイルにリンクされると、エラーが発生します。 このエラーは、「firstName」プロパティが「cusVehicle.」に対して有効であると認識されないために発生します。 ただし、リンクのない属性のみで構成されるリクエスト本文は、問題なく機能します。
PATCH操作
- Campaign v8 は、空のリクエスト本文を持つPATCHをサポートしていません。204 コンテンツなしステータスを返します。
- Campaign Standardではスキーマ内の要素/属性のPATCHがサポートされていますが、Campaign v8 では、場所に対するPATCH操作はサポートされていません。 場所でPATCHを試みると、「zipCode」プロパティが「profile」リソースに対して有効でないことを示すエラーメッセージが表示される 500 内部サーバーエラーが発生します。
REST 応答
次の節では、Campaign Standardと v8 REST 応答の小さな違いについて説明します。
- 単一GETレコードの場合、応答には応答に href が含まれます。
- 属性を指定してクエリされると、Campaign v8 はカウントとページネーションを応答で提供します。
- POSTの操作後、リンクされたリソースの値が応答で返されます。
エラーコードとメッセージ
次の節では、Campaign と Campaign v8 のエラーコードおよびCampaign Standardの違いについて説明します。
プロファイル – タイムゾーン
Campaign Standardでは、タイムゾーンは、REST API 呼び出しの profileAndServices/profile JSON 応答の一部として表示されます。
Campaign v8 では、タイムゾーンは、profileAndServicesExt/profile REST API 呼び出しの一部としてユーザーにのみ表示されます。 拡張されたスキーマで追加されるので、profileAndServices/profile REST API 呼び出しの一部ではありません。
ワークフロー – 外部シグナルのトリガー
Campaign StandardワークフローGET API は、ワークフローインスタンス変数などのパラメーター名と、そのデータタイプ(ブール値、文字列など)を返します。 これは、POST API 呼び出しを介してシグナルをトリガーする際に、適切にフォーマットされた JSON リクエスト本文を作成するために使用されます。
Campaign v8 は広告ワークフローインスタンス変数をサポートしていませんが、開発者がそれらが何であるかを知っていることを期待しています。 そのため、移行後に、POSTリクエスト本文のパラメーター情報を、GET API 応答でパラメーター情報を利用することなく構築する必要があります。