Photo by
qutakuta
【第106回】 1 リクエストで最大 100 件の連絡先をジャーニーにエントリーさせる Batch Event API が新リリース
Salesforce Marketing Cloud の Journey Builder において API で連絡先をエントリーさせる場合、コマーシャルメールにおいて 1 リクエストに含めることができる連絡先は 1 件のみでしたが、Winter '24 のリリースで 1 リクエストにつき 100 件までエントリー可能な Batch Event API が発表されました。
Interaction: Enter Contacts into a Journey in Batches
こちら私の方で早速試してみましたが、簡単に実装することができました。実装手順は過去に記事にした Salesforce Marketing Cloud で REST API を叩いてみよう Part.1～3 の手順に近いので、以下より確認してください。
今回のリクエストでは、以下のように情報を入力してください。1 リクエストで 3 つの連絡先をエントリーさせる例となります。
--- メソッド
POST
--- ヘッダー
Content-Type：application/json
Authorization：Bearer [アクセストークン]
--- エンドポイント
[REST ベース URL].rest.marketingcloudapis.com/interaction/v1/async/events
--- ボディ（サンプル）
{
"eventDefinitionKey": "[イベント定義キー]",
"members": [
{
"contactKey": "[購読者キー 1]",
"data": {
"id": "[購読者キー 1]",
"email": "[メールアドレス 1]",
"firstName": "[名 1]",
"lastName": "[姓 1]"
}
},
{
"contactKey": "[購読者キー 2]",
"data": {
"id": "[購読者キー 2]",
"email": "[メールアドレス 2]",
"firstName": "[名 2]",
"lastName": "[姓 2]"
}
},
{
"contactKey": "[購読者キー 3]",
"data": {
"id": "[購読者キー 3]",
"email": "[メールアドレス 3]",
"firstName": "[名 3]",
"lastName": "[姓 3]"
}
}
]
}結果としてデータエクステンションには、下記の通り 1 リクエストで複数の連絡先が格納されました。
このリクエスト時の注意点としては、下図のようにヘルプドキュメントには interactions/v1 と記載がありますが interaction/v1 で実行しないとリクエストが失敗します。このドキュメントは近々で修正されるとは思いますが、直近で処理される方は注意してください。
間違い：POST /interactions/v1/async/events
正しい：POST /interaction/v1/async/events
今回は以上です。
