API イベントを使用した注文状況の使用
注文が実行、処理、更新された場合など、外部コマースシステムで注文状況が変更されたときに自動化フローをトリガーします。
必要なエディション
サポートされているエディションを表示する。
| 必要なユーザー権限 | |
|---|---|
| フローを作成および管理する | 「Marketing Cloud 管理者」権限セット または 「Marketing Cloud マネージャー」権限セット |
API イベントを介した注文状況では、注文状況の変更に基づいてマーケティングアクションを自動化できます。このイベントを使用して、購入が完了したときに注文確認を送信したり、処理の更新を顧客に通知したり、コマースシステムで注文状況が変更されたときに他の自動コミュニケーションをトリガーしたりします。
- Marketing Cloud Next で、[フロー] に移動します。
-
Order Status (注文状況) イベントを使用してフローを作成します。
- 新しいフローを作成し、[Automation Event-Triggered Flow] を選択します。
- イベントライブラリで、[Order Status via API] を検索して選択します。
-
使用可能な注文状況データ項目を理解するには、ペイロードの例を確認します。
ペイロードには、次の DMO の必須項目が含まれます。
データモデルオブジェクト (DMO) 必須項目 販売注文 DMO - Order ID (
ssot__Id__c) (注文 ID) - 販売先顧客 ID (
ssot__SoldToCustomerId__c)
個人 DMO 個人 ID ( ssot__Id__c)連絡先メール DMO メール ID ( ssot__Id__c)連絡先電話 DMO 電話番号 ( ssot__Id__c)販売注文商品 DMO Sales Order Product ID (販売注文商品 ID) ( ssot__Id__c)製品 DMO 商品 ID ( ssot__Id__c)ペイロードは次のとおりです。
{ "inputs": [ { "$Event": { "ssot__CreatedDate__c": "DateTime", "ssot__DataSourceId__c": "String", "ssot__DataSourceObjectId__c": "String", "ssot__Id__c": "String", "ssot__InternalOrganizationId__c": "String", "ssot__Name__c": "String", "ssot__OrderNumber__c": "String", "ssot__OrderStartDate__c": "DateTime", "ssot__SalesOrderStatusId__c": "String", "ssot__SoldToCustomerId__c": "String", "ssot__TotalAmount__c": "Number", "KQ_Id__c": "String", "ssot__Individual__dlm": { "ssot__BirthDate__c": "DateTime", "ssot__CreatedDate__c": "DateTime", "ssot__DataSourceId__c": "String", "ssot__DataSourceObjectId__c": "String", "ssot__ExternalRecordId__c": "String", "ssot__ExternalSourceId__c": "String", "ssot__FirstName__c": "String", "ssot__Id__c": "String", "ssot__LastModifiedDate__c": "DateTime", "ssot__LastName__c": "String", "ssot__PersonName__c": "String", "ssot__Salutation__c": "String", "ssot__TitleName__c": "String", "KQ_Id__c": "String", "ssot__ContactPointEmail__dlm": [ { "ssot__DataSourceId__c": "String", "ssot__DataSourceObjectId__c": "String", "ssot__EmailAddress__c": "String", "ssot__Id__c": "String", "ssot__PartyId__c": "String", "KQ_Id__c": "String", "KQ_PartyId__c": "String" } ], "ssot__ContactPointPhone__dlm": [ { "ssot__DataSourceId__c": "String", "ssot__DataSourceObjectId__c": "String", "ssot__FormattedE164PhoneNumber__c": "String", "ssot__Id__c": "String", "ssot__PartyId__c": "String", "ssot__TelephoneNumber__c": "String", "KQ_Id__c": "String", "KQ_PartyId__c": "String" } ] }, "ssot__SalesOrderProduct__dlm": [ { "ssot__CreatedDate__c": "DateTime", "ssot__DataSourceId__c": "String", "ssot__DataSourceObjectId__c": "String", "ssot__Id__c": "String", "ssot__OrderedQuantity__c": "Number", "ssot__ProductId__c": "String", "ssot__SalesOrderId__c": "String", "ssot__TotalPriceAmount__c": "Number", "ssot__UnitPriceAmount__c": "Number", "KQ_Id__c": "String", "KQ_SalesOrderId__c": "String", "KQ_ProductId__c": "String", "ssot__Product__dlm": { "ssot__CreatedDate__c": "DateTime", "ssot__DataSourceId__c": "String", "ssot__DataSourceObjectId__c": "String", "ssot__Description__c": "String", "ssot__Id__c": "String", "ssot__Name__c": "String", "ssot__PrimaryProductCategory__c": "String", "ssot__PrimaryProductImageURL__c": "String", "ssot__PrimaryProductSubCategoryName__c": "String", "ssot__ProductCode__c": "String", "ssot__ProductFamily__c": "String", "ssot__ProductSKU__c": "String", "ssot__ProductType__c": "String", "KQ_Id__c": "String" } } ] } } ] } - Order ID (
-
フロー要素を追加して、注文状況が変更されたときに実行するアクションを定義します。
たとえば、状況固有の通知を顧客に送信する [Send Email Message (メールメッセージを送信)] 要素を追加します。イベントのペイロード項目をメールの差し込み項目に対応付けるか、ペイロードの顧客メールデータを使用して受信者アドレスを設定できます。
-
必要に応じて、決定要素を追加して、特定の注文状況に基づいて異なるアクションを作成します。
たとえば、[購入済み] 状況と [キャンセル] 状況で異なるメールテンプレートを送信します。
- フローをわかりやすい名前で保存し、インテグレーションの API 参照名をメモします。
- フローを有効化して、API トリガーを受信できるようにします。
POST 要求で注文状況が変更されたときにフローをトリガーするように外部コマースシステムを設定します。
POST /services/data/<api_version>/actions/custom/flow/flowApiNameこの記事で問題は解決されましたか?
ご意見をお待ちしております。
