Bloomreachコネクタ構成ガイド

API情報

このコネクタは以下のベンダーAPIを使用します：

API名：Bloomreach API
APIバージョン：v2.0
APIエンドポイント：https://api-engagement.bloomreach.com
ドキュメント：Bloomreach API

構成

コネクタマーケットプレイスにアクセスし、新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについてを参照してください。

コネクタを追加した後、以下の構成を構成します：

APIキー
APIキー。
APIシークレット
APIシークレット。
プロジェクトトークン
あなたのプロジェクトトークン。これは、Engagementウェブアプリのプロジェクト構成 > アクセス管理 > APIで見つけることができます。
APIドメイン
あなたのBloomreach APIドメイン。デフォルト値は https://api-engagement.bloomreach.com です。

バッチ制限

このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：

最大リクエスト数：50
最古のリクエストからの最大時間：5分
リクエストの最大サイズ：30 MB

アクション

アクション名	AudienceStream	EventStream
顧客プロパティの更新	✓	✗
顧客プロパティのバッチ更新	✓	✗
イベントの追加	✓	✓
イベントバッチの追加	✓	✓
トランザクショナルメールのトリガー	✓	✓
トランザクショナルSMSのトリガー	✓	✓

アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

顧客プロパティの更新

顧客ID

パラメータ	説明
登録済み	(必須) ハードまたはソフトID。

プロパティ

(必須) 更新する顧客プロパティ。

パラメータ	説明
メール	顧客のメールアドレス。
名	顧客の名前。
姓	顧客の姓。

オプショナル

パラメータ	説明
更新タイムスタンプ	UNIXタイムスタンプ（秒）。更新時間が古いプロパティのみが更新されます。

顧客プロパティのバッチ更新

顧客ID

パラメータ	説明
登録済み	(必須) ハードまたはソフトID。

プロパティ

(必須) 更新する顧客プロパティ。

パラメータ	説明
メール	顧客のメールアドレス。
名	顧客の名前。
姓	顧客の姓。

オプショナル

パラメータ	説明
更新タイムスタンプ	UNIXタイムスタンプ（秒）。更新時間が古いプロパティのみが更新されます。

イベントの追加

パラメータ

パラメータ	説明
イベントタイプ	イベントのタイプ。選択されたプロパティカテゴリに基づいて必要なだけ多くのイベントをトリガーするイベントタイプ。購入購入アイテムカート更新チェックアウトアイテム閲覧カテゴリ閲覧同意バナー推奨

顧客ID

パラメータ	説明
登録済み	(必須) ハードまたはソフトID。

プロパティ

パラメータ	説明
タイムスタンプ	イベントが作成されたときのUNIXタイムスタンプ（秒）。提供されていない場合は、現在の時間が使用されます。タイムスタンプはISO 8601形式の日時をサポートします。値は秒単位である必要があります。文字数に基づいてミリ秒が自動的に認識されることはありません。

イベントバッチの追加

パラメータ

パラメータ	説明
イベントタイプ	イベントのタイプ。選択されたプロパティカテゴリに基づいて必要なだけ多くのイベントをトリガーするイベントタイプ。購入購入アイテムカート更新チェックアウトアイテム閲覧カテゴリ閲覧同意バナー推奨

顧客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

パラメータ	説明
転送アイデンティティ	リンク転送機能を有効にするかどうか。可能な値： `Enabled` - デフォルト値、すべてのクリックで識別する`iitt`パラメータを追加します。 `Disabled` - リンクに何も追加せず、アイデンティティ転送はありません。 `First Click` - 最初のクリックのみを識別する`xnpe_tifc`を追加します。

メールテンプレート構成

パラメータ	説明
ユーザーアイデンティティの転送	リンク転送機能を有効にするかどうか。可能な値： `enabled` (デフォルト値) `disabled` `iitt` - リンクにアイデンティティを転送しない。この構成は、リクエストの本文に直接指定される`transferidentity`パラメータと同じです。どちらか一方のみを指定する必要があります。構成の一部として転送アイデンティティを指定し、単独で指定するとエラーが発生します。
同意カテゴリ	Engagementプラットフォームでの同意を尊重するために、顧客の同意カテゴリを指定します。
トラッキング同意カテゴリ	Engagementプラットフォームでのトラッキング同意を尊重するために、顧客のトラッキング同意カテゴリを指定します。
メールテンプレートカスタムイベントプロパティ	カスタム属性。
メールテンプレートカスタムヘッダー	メールプロバイダに送信するリクエストヘッダ。
メールテンプレートURLパラメータ	セッション開始イベントでのトラッキングに使用されるURLパラメータ。

トランザクショナルSMSのトリガー

SmsContent

パラメータ	説明
テンプレートID	送信するSMSテンプレートのID。選択した事前定義テンプレートのURLで見つけることができます。
メッセージ	SMSメッセージの内容。
最大メッセージ部分数	メッセージ部分の最大許容数。これを超えると、SMSメッセージは送信されません。最小値: `1`、最大値: `8`、デフォルト値: `8`。
送信者	あなたの送信者電話番号。
Smsコンテンツパラメータ	テンプレートで使用されるSMSのパーソナライゼーションに必要なすべてのデータを提供します。形式: `param_name`:“value”。例: `first_name`:“Marian”。
キャンペーン名	SMSキャンペーンの名前。

受信者

パラメータ	説明
電話	顧客の電話番号を指定します。電話番号が提供されていない場合、顧客IDに基づいてBloomreach Engagementの顧客プロファイルから取得されます。
言語	テンプレートの言語バージョン。テンプレートに複数の言語バージョンが作成されている場合、このSMSに使用するバージョンを選択できます。

受信者顧客ID

パラメータ	説明

SMSテンプレート構成

パラメータ	説明
ユーザーIDの転送	リンク転送機能を有効にするかどうか。可能な値: `enabled` (デフォルト値) `disabled` `iitt` - リンクにIDを転送しない。この構成は、リクエストの本文の `transferidentity` パラメータと同じです。どちらか一方のみを指定する必要があります。構成と単独でのID転送の両方を指定するとエラーになります。
同意カテゴリ	Engagementプラットフォームでの同意を尊重するために、顧客の同意カテゴリを指定します。
トラッキング同意カテゴリ	Engagementプラットフォームでのトラッキング同意を尊重するために、顧客のトラッキング同意カテゴリを指定します。
SMSテンプレートカスタムイベントプロパティ	カスタム属性。
SMSテンプレートカスタムヘッダー	SMSプロバイダーに送信するリクエストヘッダー。
SMSテンプレートURLパラメータ	セッション開始イベントのトラッキングに使用されるURLパラメータ。