Selligentマーケティングクラウドコネクタ構成ガイド

SelligentマーケティングクラウドのAudienceStreamコネクタを活用して、リアルタイムでリストやセグメントからユーザーを追加・削除したり、カスタムジャーニーやトランザクションメッセージをトリガーします。

Selligent APIについての詳細は、SelligentマーケティングクラウドAPIエクスプローラーをご覧ください。

バッチ制限

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

• リクエストの最大数：2500
• 最古のリクエストからの最大時間：10分
• リクエストの最大サイズ：20MB

コネクタアクション

アクション名	AudienceStream	EventStream
リストへのアップサート	✓	✓
リストからの削除	✓	✓
セグメントへの追加	✓	✓
セグメントからの削除	✓	✓
カスタムジャーニーのトリガー	✓	✓
トランザクションメッセージのトリガー	✓	✓

構成の構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法については、コネクタについての記事をご覧ください。

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

• サーバーURL
  Selligentマーケティングクラウド（SMC）のサーバーアドレス。サーバーURLにはhttpsの値を含めてください。例：https://example.sIgnt.eu。
• 組織
  あなたの組織。SMC管理構成画面の右上隅に表示される組織と一致する必要があります。
• APIキー
  SMC管理構成 > アプリから生成されます。
• APIシークレット
  SMC管理構成 > アプリから生成されます。

コネクタの構成が完了したら、完了をクリックします。

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

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

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

アクション - リストへのアップサート

APIエンドポイント：https://partners.slgnt.eu/Portal/Api/swagger/ui/index#!/Data/Data_LoadData

このエンドポイントは、指定された組織内の指定されたAPI名のリストにユーザーデータをロードします。これは、特定のリスト内でユーザーを登録または更新するのに似ています。リストはオーディエンスと比較できます。リストは、構成画面で入力した資格情報と組織に基づいて取得されます。

パラメータ

パラメータ	説明
リスト	Selligentマーケティングクラウドのリストを選択します。リストは、データ構成セクションでのデータマッピングに必要な特定のフィールドを取得します。
データ	マッピングするデータは、取得して選択したリストから必要なデータに依存します。取得されたリストフィールドは、リストテーブル内のフィールドまたは列の予想されるデータタイプを指定する必要があります。マッピングについての追加の質問は、あなたのSelligentおよびTealiumアカウントマネージャーにお問い合わせください。

アクション - リストからの削除

APIエンドポイント：https://partners.slgnt.eu/Portal/Api/swagger/ui/index#!/Data/Data_DeleteData

このエンドポイントは、指定された組織内の指定されたAPI名のリストからデータを削除します。このアクションを使用して、ユーザーを削除し、それにより特定のリストから退会させます。例えば、誰かがオーディエンスを離れたときなどです。

パラメータ

パラメータ	説明
リスト	Selligentマーケティングクラウドのリストを選択します。リストは、データ構成セクションでのデータマッピングに必要な特定のフィールドを取得します。
データ	マッピングするデータは、取得して選択したリストから必要なデータに依存します。取得されたリストフィールドは、リストテーブル内のフィールドまたは列の予想されるデータタイプを指定する必要があります。顧客レコードを更新する場合は、アップサートアクションを使用してください。

アクション - セグメントへの追加

APIエンドポイント：https://partners.slgnt.eu/Portal/Api/swagger/ui/index#!/Data/Data_LoadSegmentData

このエンドポイントは、指定された組織内の指定されたAPI名のリスト内の指定されたセグメントAPI名のセグメントにデータをロードします。このアクションを使用して、リスト内のセグメントにユーザーデータをサブセットとしてロードします。このアクションは、Selligentプラットフォーム内のリスト内のターゲット指定された静的セグメントにユーザーを追加するために使用できます。

パラメータ

パラメータ	説明
リスト	Selligentマーケティングクラウドのリストを選択します。リストは、データ構成セクションでのデータマッピングに必要な特定のフィールドを取得します。
セグメント	セグメントを選択します。ユーザーをそのセグメントに登録するために使用できる静的セグメントのみを提供します。
データ	マッピングするデータは、取得して選択したリストから必要なデータに依存します。取得されたリストフィールドは、リストテーブル内のフィールドまたは列の予想されるデータタイプを指定する必要があります。

アクション - セグメントからの削除

APIエンドポイント： https://partners.slgnt.eu/Portal/Api/swagger/ui/index#!/Data/Data_DeleteSegmentData

このエンドポイントは、指定された組織内の指定されたAPI名のリスト内の指定されたセグメントAPI名のセグメントからJSON経由でデータを削除します。このアクションを使用して、ユーザーをセグメントから退会させます。削除アクションはセグメントを削除するのではなく、サポートされるセグメントからユーザーを削除します。

パラメータ

パラメータ	説明
リスト	Selligentマーケティングクラウドのリストを選択します。リストは、データ構成セクションでのデータマッピングに必要な特定のフィールドを取得します。
セグメント	Selligentマーケティングクラウドのリスト内に作成された静的セグメントのみを提供し、ユーザーをセグメントから削除します。
データ	マッピングするデータは、取得して選択したリストから必要なデータに依存します。取得されたリストフィールドは、リストテーブル内のフィールドまたは列の予想されるデータタイプを指定する必要があります。

アクション - カスタムジャーニーのトリガー

APIエンドポイント：https://partners.slgnt.eu/Portal/Api/swagger/ui/index#!/Custom/Custom_TriggerEntryPoint

このアクションは、カスタムジャーニーの特定の開始コンポーネントをトリガーします。このアクションを使用して、ユーザーをカスタムな顧客ジャーニーに追加し、ユーザーが挿入されるエントリーポイントステップを選択します。

パラメータ

パラメータ	説明
ジャーニー	Selligentマーケティングクラウドのカスタムジャーニーを選択します。このジャーニーは、あなたのSelligentプラットフォーム内で作成された顧客ジャーニーに基づいて取得されます。ジャーニーは、作成された顧客ジャーニーのカスタムタイプのみを返します。
ジャーニーエントリーポイント	ユーザーを追加するジャーニーエントリーポイントを選択します。
ユーザーID	キャンペーンがトリガーされるユーザーのID。

アクション - トランザクションメッセージのトリガー

APIエンドポイント：https://partners.slgnt.eu/Portal/Api/swagger/ui/index#!/Transactional/Transactional_Send

このエンドポイントは、指定された組織内の指定されたAPI名のトランザクションメッセージをトリガーするために使用できます。このアクションを使用して、指定された受信者に対して特定の言語でトランザクションメールを送信します。また、特定のジャーニーを開始するためにもこのアクションを使用できます。例えば、Tealiumから直接メールを送信したい場合などです。このアクションは、Selligentプラットフォーム内で作成されたトランザクションジャーニーを通じてメッセージを送信します。このアクションは、トランザクションの顧客ジャーニーがすでに作成されており、そのトランザクションジャーニーのユーザーにメッセージを送信するシナリオで使用できます。

パラメータ

パラメータ	説明
トランザクションジャーニー	Selligentマーケティングクラウドのトランザクションジャーニーを選択します。トランザクションの顧客ジャーニーはこのフィールドに取得され、表示されます。
受信者	(必須) コンテンツを送信する対象の受信者。
言語	(必須) メールを送信する言語。