Monetateパーソナライゼーションエンジンコネクタ構成ガイド
この記事では、Monetateコネクタの構成方法について説明します。
必要条件
- Monetateアカウント
- APIユーザー名&APIキー
- データスキーマ
サポートされているアクション
アクション名 | オーディエンスにトリガー | ストリームにトリガー |
---|---|---|
データレコードの作成または更新 | ✓ | ✓ |
構成の構成
コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法の一般的な指示については、コネクタについての記事を参照してください。
ベンダーを構成するには、次の手順に従います:
- 構成タブで、コネクタインスタンスにタイトルを提供します。
- APIユーザー名を入力します。これは、アカウントの構成>サイト>APIキーの下で見つけることができます。
- アカウントに登録された公開キーに一致するプライベートキーを提供します。プライベートキーは、RSAアルゴリズムで生成し、PEM PKCS #8形式に変換する必要があります。詳細については、APIキーの概要と以下のAPIキーの生成セクションを参照してください。
- APIクライアントIDを提供します。これは、アカウントの構成>APIドキュメンテーション>MonetateデータAPI>ベースURLの下で見つけることができます。たとえば、URLが
https://api.monetate.net/api/data/v1/abc/production/
の場合、クライアントIDはabc
です。 - 接続テストをクリックして、提供された資格情報で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ビット)。
- 伝統的な形式のキーをPEM PKCS #8形式に変換します。これがあなたのプライベートキーです。
- 伝統的な形式のキーからPEM形式の公開キーを出力します。これがあなたの公開キーです。
上記の例では、生成されたキーファイルの名前をmy_key.pem
、my_private_key.pem
、my_public_key.pem
としていますが、これらは任意で、あなたが適切と思う名前をつけることができます。
生成したら、テキストエディタでファイルを開き、キーの値をそれぞれコピーします。公開キーをMonetateアカウントに登録し、そのプライベートキーをコネクタ構成画面に提供します。
アクション構成 - パラメータとオプション
次へをクリックするか、アクションタブに移動します。ここでアクションをトリガーする構成を行います。
このセクションでは、各アクションのパラメータとオプションの構成方法について説明します。
アクション:データレコードの作成または更新(リアルタイム)
パラメータ
パラメータ | 説明 |
---|---|
スキーマ | (必須) レコードを作成または更新するスキーマを選択します。 |
データレコード | (必須) 属性をデータレコードフィールドにマッピングします。主キーフィールドの値がすでにスキーマに存在する場合、そのデータが更新されます。event タイプのスキーマでは、event time タイプのフィールドが必要です。明示的にマッピングされていない場合、フィールド値はデフォルトで現在の時間になります。日付属性はISO 8601形式:YYYY-MM-DDThh:mm:ss に変換されます。 |
詳細については、エンジンAPI:データの送信を参照してください。
アクション:データレコードの作成または更新(バッチ)
パラメータ | 説明 |
---|---|
スキーマ | (必須) レコードを作成または更新するスキーマを選択します。 |
データレコード | (必須) 属性をデータレコードフィールドにマッピングします。主キーフィールドの値がすでにスキーマに存在する場合、そのデータが更新されます。event タイプのスキーマでは、event time タイプのフィールドが必要です。明示的にマッピングされていない場合、フィールド値はデフォルトで現在の時間になります。日付属性はISO 8601形式:YYYY-MM-DDThh:mm:ss に変換されます。 |
ベンダードキュメンテーション
最終更新日 :: 2020年January月24日