メインコンテンツへスキップ
見出し画像
Photo byqutakuta

【第106回】 1 リクエストで最大 100 件の連絡先をジャーニーにエントリーさせる Batch Event API が新リリース

    Nobuyuki Watanabe

    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

    今回は以上です。


    Click here for English version

    次の記事はこちら

    前回の記事はこちら

    私の note のトップページはこちら

     
     
     
    Salesforce Marketing Cloud、Agentforce、Data Cloud、Salesforce 認定資格に関する実践的な情報を発信しています。これらの記事が、皆さまの学習や日々の業務に少しでもお役に立てば幸いです。