Bloomreachコネクタ構成ガイド
この記事では、Bloomreachコネクタの構成方法について説明します。
API情報
このコネクタは、次のベンダーAPIを使用します。
- API名:Bloomreach API
- APIバージョン:v2.0
- APIエンドポイント:
https://api-engagement.bloomreach.com - ドキュメント:Bloomreach API
構成
コネクタマーケットプレイスに移動し、新しいコネクタを追加します。詳細については、コネクタについてを参照してください。
コネクタを追加した後、次の項目を構成します。
- APIキー
APIキー。 - APIシークレット
APIシークレット。 - プロジェクトトークン
プロジェクトトークン。Engagement Webアプリのプロジェクト構成 > アクセス管理 > APIで確認できます。 - APIドメイン
コネクタを構成したら、完了をクリックします。
Bloomreach APIドメイン。デフォルト値はhttps://api-engagement.bloomreach.comです。
バッチ制限
このアクションでは、ベンダーへの大容量データ転送に対応するため、リクエストをバッチ処理します。詳細については、「バッチアクション」を参照してください。次のいずれかのしきい値に達するか、プロファイルが公開されるまで、リクエストはキューに格納されます。
- リクエストの最大数:50
- 最も古いリクエストからの最大経過時間:5分
- リクエストの最大サイズ:30 MB
アクション
| アクション名 | 訪問プロファイル | イベントデータ |
|---|---|---|
| 顧客プロパティを更新 | ✓ | ✗ |
| 顧客プロパティを一括更新 | ✓ | ✗ |
| イベントを追加 | ✓ | ✓ |
| イベントを一括追加 | ✓ | ✓ |
| トランザクションメールをトリガー | ✓ | ✓ |
| トランザクションSMSをトリガー | ✓ | ✓ |
アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。
以降のセクションでは、各アクションのパラメータとオプションを構成する方法について説明します。
顧客プロパティを更新
顧客ID
| パラメータ | 説明 |
|---|---|
| 登録済み | (必須)ハードIDまたはソフトID。 |
プロパティ
(必須)更新する顧客プロパティ。
| パラメータ | 説明 |
|---|---|
| メールアドレス | 顧客のメールアドレス。 |
| 名 | 顧客の名。 |
| 姓 | 顧客の姓。 |
オプション
| パラメータ | 説明 |
|---|---|
| 更新タイムスタンプ | 秒単位のUnixタイムスタンプ。更新時刻がこれより古いプロパティのみが更新されます。 |
顧客プロパティを一括更新
顧客ID
| パラメータ | 説明 |
|---|---|
| 登録済み | (必須)ハードIDまたはソフトID。 |
プロパティ
(必須)更新する顧客プロパティ。
| パラメータ | 説明 |
|---|---|
| メールアドレス | 顧客のメールアドレス。 |
| 名 | 顧客の名。 |
| 姓 | 顧客の姓。 |
オプション
| パラメータ | 説明 |
|---|---|
| 更新タイムスタンプ | 秒単位のUnixタイムスタンプ。更新時刻がこれより古いプロパティのみが更新されます。 |
イベントを追加
パラメータ
| パラメータ | 説明 |
|---|---|
| イベントタイプ | イベントのタイプ。入力されたプロパティに基づくイベントタイプによって、選択したプロパティカテゴリーに応じて必要な数のイベントがトリガーされます。
|
顧客ID
| パラメータ | 説明 |
|---|---|
| 登録済み | (必須)ハードIDまたはソフトID。 |
プロパティ
| パラメータ | 説明 |
|---|---|
| タイムスタンプ | イベントが作成された時刻を示すUNIXタイムスタンプ(秒)。指定しない場合は、現在時刻が使用されます。タイムスタンプには、ISO 8601形式の日時を指定できます。文字数に基づいてミリ秒が自動認識されることはないため、値は秒単位で指定する必要があります。 |
イベントを一括追加
パラメータ
| パラメータ | 説明 |
|---|---|
| イベントタイプ | イベントのタイプ。入力されたプロパティに基づくイベントタイプによって、選択したプロパティカテゴリーに応じて必要な数のイベントがトリガーされます。
|
顧客ID
| パラメータ | 説明 |
|---|---|
| 登録済み | (必須)ハードIDまたはソフトID。 |
プロパティ
| パラメータ | 説明 |
|---|---|
| タイムスタンプ | イベントが作成された時刻を示すUNIXタイムスタンプ(秒)。指定しない場合は、現在時刻が使用されます。タイムスタンプには、ISO 8601形式の日時を指定できます。文字数に基づいてミリ秒が自動認識されることはないため、値は秒単位で指定する必要があります。 |
トランザクションメールをトリガー
パラメータ
| パラメータ | 説明 |
|---|---|
| インテグレーションID | メールサービスプロバイダーとのインテグレーションのID。選択したインテグレーションのURLで確認できます。 |
インテグレーション
| パラメータ | 説明 |
|---|---|
| ID | (必須)メールサービスプロバイダーとのインテグレーションのID。 |
| 送信者アドレス | (必須)このインテグレーションでメールの送信者として使用するメールアドレス。このパラメータを指定する他の方法よりも優先されます。 |
メールコンテンツ
| パラメータ | 説明 |
|---|---|
| テンプレートID | 送信するメールテンプレートのID。選択した定義済みテンプレートのURLで確認できます。 |
| 件名 | メールの件名を定義します。このフィールドではJinjaは評価されません。 |
| 送信者アドレス | 送信者のメールアドレス。 |
| 送信者名 | 通常は送信者の名です。 |
| 添付ファイル名 | 添付ファイルの名前。 |
| 添付ファイルのコンテンツ | Base64でエンコードされたファイルのコンテンツ。 |
| 添付ファイルのコンテンツタイプ | 添付ファイルの形式。 |
| HTML | <html>タグと</html>タグの間に配置するメールコンテンツを定義します。CSSコンテンツを含めることもできます。このフィールドではJinjaは評価されません。 |
| メールコンテンツパラメータ | テンプレートで使用するメールのパーソナライズに必要なすべてのデータを指定します。形式:param_name:“value”。例:first_name:“Marian” |
| キャンペーン名 | メールキャンペーンの名前。 |
受信者
| パラメータ | 説明 |
|---|---|
| メールアドレス | 顧客のメールアドレスを指定します。メールアドレスを指定しない場合は、顧客IDに基づいてBloomreach Engagementの顧客プロファイルから取得されます。 |
| 言語 | テンプレートの言語バージョン。テンプレートに複数の言語バージョンが作成されている場合は、このメールで使用するバージョンを選択できます。 |
受信者の顧客ID
| パラメータ | 説明 |
|---|---|
| ID転送 | リンクによるID転送機能を有効にするかどうか。指定可能な値:
|
メールテンプレート構成
| パラメータ | 説明 |
|---|---|
| ユーザーIDを転送 | リンクによるID転送機能を有効にするかどうか。指定可能な値:
transferidentityパラメータと同じです。指定できるのはいずれか一方のみであることに注意してください。構成内と単独の両方でID転送を指定すると、エラーになります。 |
| 同意カテゴリー | Engagementプラットフォームの同意構成を尊重するには、顧客の同意カテゴリーを指定します。 |
| トラッキング同意カテゴリー | Engagementプラットフォームのトラッキング同意構成を尊重するには、顧客のトラッキング同意カテゴリーを指定します。 |
| メールテンプレートのカスタムイベントプロパティ | カスタム属性。 |
| メールテンプレートのカスタムヘッダー | メールプロバイダーに送信するリクエストヘッダー。 |
| メールテンプレートのURLパラメータ | セッション開始イベントのトラッキングに使用するURLパラメータ。 |
トランザクションSMSをトリガー
SmsContent
| パラメーター | 説明 |
|---|---|
| Template ID | 送信するSMSテンプレートのID。選択した事前定義済みテンプレートのURLで確認できます。 |
| Message | SMSメッセージの内容。 |
| Max Message Parts | 許可されるメッセージパート数の上限。この値を超えた場合、SMSメッセージは送信されません。最小値:1、最大値:8、デフォルト値:8。 |
| Sender | 送信者の電話番号。 |
| Sms Content Parameters | テンプレートで使用するSMSのパーソナライズに必要なすべてのデータを指定します。形式:param_name:“value”。例:first_name:“Marian”。 |
| Campaign Name | SMSキャンペーンの名前。 |
Recipient
| パラメーター | 説明 |
|---|---|
| Phone | 顧客の電話番号を指定します。電話番号が指定されていない場合は、顧客IDに基づいてBloomreach Engagementの顧客プロファイルから取得されます。 |
| Language | テンプレートの言語バージョン。テンプレートに複数の言語バージョンが作成されている場合、このSMSに使用するバージョンを選択できます。 |
Recipient Customer IDs
| パラメーター | 説明 |
|---|
SMS Template Settings
| パラメーター | 説明 |
|---|---|
| Transfer User Identity | リンクによるID転送機能を有効にするかどうか。指定可能な値:
transferidentityパラメーターと同じです。いずれか一方のみ指定できることに注意してください。構成の一部としてID転送を指定し、さらに単独でも指定すると、エラーが発生します。 |
| Consent Category | Engagementプラットフォームの同意構成を尊重するため、顧客の同意カテゴリーを指定します。 |
| Consent Category Tracking | Engagementプラットフォームのトラッキング同意構成を尊重するため、顧客のトラッキング同意カテゴリーを指定します。 |
| SMS Template Custom Event Properties | カスタム属性。 |
| SMS Template Custom Headers | SMSプロバイダーに送信するリクエストヘッダー。 |
| SMS Template URL Parameters | セッション開始イベントのトラッキングに使用されるURLパラメーター。 |
最終更新日 :: 2026年November月18日