Bloomreachコネクタ構成ガイド | サーバーサイドコネクタ

API情報

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

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

構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法の一般的な指示については、About Connectorsを参照してください。

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

APIキー
APIキー
APIシークレット
APIシークレット
プロジェクトトークン
プロジェクトトークン。これは、Engagementウェブアプリのプロジェクト構成 > アクセス管理 > APIで見つけることができます。

バッチ制限

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

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

アクション

アクション名	AudienceStream	EventStream
Update Customer Properties	✓	✗
Update Customer Properties Batch	✓	✗
Add Event	✓	✓
Add Event Batch	✓	✓
Trigger Transactional Email	✓	✓
Trigger Transactional SMS	✓	✓

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

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

アクション構成 - パラメータとオプション

次へをクリックするか、アクションタブに移動します。ここでコネクタアクションを構成します。

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

アクション - Update Customer Properties

顧客ID

パラメータ	説明
Registered	1つ以上のハードIDまたはソフトIDが必要です。

プロパティ

更新したい顧客のプロパティを1つ以上指定する必要があります。

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

オプション

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

アクション - Update Customer Properties Batch

顧客ID

パラメータ	説明
Registered	1つ以上のハードIDまたはソフトIDが必要です。

プロパティ

更新したい顧客のプロパティを1つ以上指定する必要があります。

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

オプション

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

アクション - Add Event

パラメータ

パラメータ	説明
Event Type	イベントのタイプ。選択したプロパティに基づいてイベントタイプがトリガーされ、選択したプロパティカテゴリに基づいて必要な数のイベントがトリガーされます。 Purchase Purchase Item Cart Update Checkout View Item View Category Consent Banner Recommendation

顧客ID

パラメータ	説明
Registered	1つ以上のハードIDまたはソフトIDが必要です。

プロパティ

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

アクション - Add Event Batch

パラメータ

パラメータ	説明
Event Type	イベントのタイプ。選択したプロパティに基づいてイベントタイプがトリガーされ、選択したプロパティカテゴリに基づいて必要な数のイベントがトリガーされます。 Purchase Purchase Item Cart Update Checkout View Item View Category Consent Banner Recommendation

顧客ID

パラメータ	説明
Registered	1つ以上のハードIDまたはソフトIDが必要です。

プロパティ

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

アクション - Trigger Transactional Email

パラメータ

パラメータ	説明
Integration ID	メールサービスプロバイダーの統合ID。これは、選択した統合のURLで見つけることができます。

統合

パラメータ	説明
ID	(必須) メールサービスプロバイダーの統合ID。
Sender Address	必須。この統合のメールの送信者として使用されるメールアドレス。このパラメータの提供方法を上書きします。

メールコンテンツ

パラメータ	説明
Template ID	送信したいメールテンプレートのID。これは、選択した事前定義テンプレートのURLで見つけることができます。
Subject	メールの件名を定義します。このフィールドではJinjaは評価されません。
Sender Address	送信者のメールアドレス。
Sender Name	通常は送信者の名前です。
Attachments Filename	添付ファイルの名前。
Attachments Content	ファイルのBase64エンコードされたコンテンツ。
Attachments Content Type	添付ファイルの形式。
Html	`<html>`と`</html>`タグの間のメールの内容を定義します。CSSコンテンツも含めることができます。このフィールドではJinjaは評価されません。
Email Content Parameters	テンプレートで使用されるメールのパーソナライゼーションに必要なすべてのデータを提供します。形式：`param_name`:“value”。例：`first_name`:“Marian”
Campaign Name	メールキャンペーンの名前。

受信者

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

受信者の顧客ID

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

メールテンプレート構成

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

アクション - トランザクションSMSのトリガー

SmsContent

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

受信者

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

受信者の顧客ID

パラメータ	説明

SMSテンプレート構成

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