Monetate Personalization Engine コネクタ構成ガイド

要件

• Monetate アカウント
• API ユーザー名と API キー
• データスキーマ

構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。詳細については、コネクタについてを参照してください。

コネクタを追加したら、次の項目を構成します。

• API ユーザー名：（必須）API ユーザー名を入力します。API ユーザー名は、アカウントの Settings > Sites > API Keys で確認できます。
• 秘密鍵：（必須）アカウントに登録されている公開鍵に対応する秘密鍵を指定します。秘密鍵は RSA アルゴリズムで生成し、PEM PKCS #8 形式に変換する必要があります。詳細については、Monetate：API キーの概要および API キーの生成を参照してください。
• クライアント ID：（必須）クライアント ID を指定します。クライアント ID は、アカウントの Settings > API Documentation > Monetate Data API > Base URL で確認できます。たとえば、URL が https://api.monetate.net/api/data/v1/abc/production/ の場合、クライアント ID は abc です。

コネクタを構成したら、Done をクリックします。

Test Connection をクリックし、指定した認証情報で API に接続できることを確認します。

API キーの生成

安全な通信を確保するため、Monetate API では公開鍵と秘密鍵のペアを使用します。キーペアは、無料で広く利用されている OpenSSL コマンドラインツールを使用して生成できます。

次のコマンドを実行します。

openssl genrsa -out my_key.pem 4096
openssl pkcs8 -topk8 -inform PEM -outform PEM -in my_key.pem -out my_private_key.pem -nocrypt
openssl rsa -in my_key.pem -pubout -outform PEM -out my_public_key.pem

これらのコマンドは、RSA アルゴリズム（キーサイズ 4096 ビット）を使用して新しいキーを生成し、暗号化せずに PKCS#8 形式へ変換します。これが秘密鍵です。最後の行では、公開鍵が PEM 形式で出力されます。

生成したら、各ファイルをテキストエディターで開き、対応するキーと値をコピーします。Monetate アカウントに公開鍵を登録し、コネクタ構成画面で秘密鍵を指定します。

アクション

Continue をクリックして、コネクタのアクションを構成します。アクション名を入力し、リストからアクションタイプを選択します。

データレコードの更新（リアルタイム）

パラメーター

詳細については、Engine API：データの送信を参照してください。

データレコードの作成または更新（バッチ）

バッチ制限

このアクションでは、ベンダーへの大量のデータ転送に対応するため、バッチリクエストを使用します。次のいずれかのしきい値に達するまで、リクエストはキューに追加されます。

• リクエストの最大数：500
• 最も古いリクエストからの最大経過時間：10 分
• リクエストの最大サイズ：5 MB

パラメーター

ベンダーのドキュメント

• Monetate：API キーの概要