Selligent by Marigold コネクタ構成ガイド

Selligent APIについての詳細は、Selligent Marketing Cloud API Explorerをご覧ください。

バッチ制限

このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。並列処理により、イベントがベンダーに順不同で到達する可能性があります。順序が重要な場合は、イベントにシーケンス値を追加してください。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：

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

構成

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

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

サーバーURL
あなたのSelligentベースURL。サーバーURLにはhttps値を含めてください。例：https://example.sIgnt.eu。
組織
あなたの組織。Selligent管理構成画面の右上隅にある組織と一致する必要があります。
APIキー
Selligent管理構成から生成されます。
APIシークレット
Selligent管理構成から生成されます。

アクション

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

リストへのアップサート

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名のリスト内のセグメントにデータをロードします。このアクションを使用して、リスト内のセグメントにユーザーデータをサブセットします。このアクションは、Selligentプラットフォーム内のリスト内のターゲット静的セグメントにユーザーを追加するために使用できます。

パラメータ

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

セグメントからの削除

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

このエンドポイントは、指定された組織の指定されたAPI名のリスト内のセグメントからJSONを介してデータを削除します。このアクションを使用して、セグメントからユーザーを登録解除します。削除アクションはセグメントを削除しませんが、サポートされているセグメントからユーザーを削除します。

パラメータ

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

カスタムジャーニーのトリガー

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トランザクショナルジャーニーを選択します。トランザクショナルカスタマージャーニーは、このフィールドで取得され、表示されます。
受信者	(必須) コンテンツを送信する受信者。
言語	(必須) メールを送信する言語。
Lookup	Selligentが受信者を見つけるために使用するプロファイルフィールドを決定します。マッピングされていない場合、`lookup`フィールドはリクエストから省略され、Selligentはサーバーサイドのデフォルト`MASTER.MAIL`（メインのオーディエンスメールフィールド）を適用します。トランザクショナル構成が別のフィールドまたは関連プロファイルスコープで連絡先を識別する場合のみ、`SCOPE.FIELD`の形式で値をマッピングします。
外部ID	このメッセージ送信のためのオプションの外部ID。リクエストを追跡するために使用されます。