Selligent by Marigoldコネクタ構成ガイド
この記事では、Selligent by Marigoldコネクタの構成方法について説明します。
Selligent APIの詳細については、Selligent Marketing Cloud API Explorerを参照してください。
バッチ制限
このコネクタは、ベンダーへの大量データ転送に対応するため、バッチリクエストを使用します。並列処理により、イベントが順不同でベンダーに到達する場合があります。順序が重要な場合は、イベントにシーケンス値を追加してください。詳細については、バッチアクションを参照してください。次のいずれかのしきい値に達するか、プロファイルがパブリッシュされるまで、リクエストはキューに格納されます。
- リクエストの最大数:2500
- 最も古いリクエストからの最大経過時間:10分
- リクエストの最大サイズ:20 MB
構成
コネクタマーケットプレイスに移動し、新しいコネクタを追加します。詳細については、コネクタについてを参照してください。
コネクタを追加したら、次の構成を行います。
- サーバーURL
SelligentのベースURL。サーバーURLにはhttpsを含めます。例:https://example.sIgnt.eu - 組織
組織名。Selligent Admin Configuration画面の右上隅に表示されている組織名と一致している必要があります。 - APIキー
Selligent Admin Configurationから生成します。 - APIシークレット
コネクタを構成したら、完了をクリックします。 Selligent Admin Configurationから生成します。
アクション
| アクション名 | 訪問プロファイル | イベントデータ |
|---|---|---|
| リストへのアップサート | ✓ | ✓ |
| リストから削除 | ✓ | ✓ |
| セグメントに追加 | ✓ | ✓ |
| セグメントから削除 | ✓ | ✓ |
| カスタムジャーニーをトリガー | ✓ | ✓ |
| トランザクションメッセージをトリガー | ✓ | ✓ |
リストへのアップサート
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 Marketing Cloudのリスト内で作成された静的セグメントのみが表示され、そのセグメントからユーザーが削除されます。 |
| データ | マッピングするデータは、取得してリスト選択項目から選択したリストに必要なデータによって異なります。取得されたリストフィールドでは、リストテーブル内のフィールドまたは列に想定されるデータ型を指定する必要があります。 |
カスタムジャーニーをトリガー
APIエンドポイント:https://partners.slgnt.eu/Portal/Api/swagger/ui/index#!/Custom/Custom_TriggerEntryPoint
このアクションは、カスタムジャーニー内の特定の開始コンポーネントをトリガーします。このアクションを使用して、ユーザーをカスタムカスタマージャーニーに追加し、そのユーザーを挿入するエントリポイントのステップを選択します。
パラメータ
| パラメータ | 説明 |
|---|---|
| ジャーニー | Selligentのカスタムジャーニーを選択します。このジャーニーは、Selligentプラットフォーム内で作成されたカスタマージャーニーに基づいて取得されます。Journeyでは、作成されたカスタマージャーニーのうちcustomタイプのみが返されます。 |
| ジャーニーのエントリポイント | ユーザーを追加するジャーニーのエントリポイントを選択します。 |
| ユーザーID | キャンペーンをトリガーする対象ユーザーのID。 |
トランザクションメッセージをトリガー
APIエンドポイント:https://partners.slgnt.eu/Portal/Api/swagger/ui/index#!/Transactional/Transactional_Send
このエンドポイントを使用すると、指定された組織内で、指定されたAPI名を持つトランザクションメッセージをトリガーできます。このアクションを使用して、指定した受信者に特定の言語でトランザクションメールを送信します。このアクションを使用して、特定のジャーニーを開始することもできます。たとえば、Tealiumから直接メールを送信する場合に使用します。このアクションは、Selligentプラットフォーム内で作成されたトランザクションジャーニーを通じてメッセージを送信します。トランザクションカスタマージャーニーがすでに作成されており、そのトランザクションジャーニーのユーザーにメッセージを送信する場合に使用できます。
パラメータ
| パラメータ | 説明 |
|---|---|
| トランザクションジャーニー | Selligentのトランザクションジャーニーを選択します。トランザクションカスタマージャーニーが取得され、このフィールドに入力されます。 |
| 受信者 | (必須)コンテンツの送信先となる受信者。 |
| 言語 | (必須)メールの送信に使用する言語。 |
| ルックアップ | Selligentが受信者の検索に使用するプロファイルフィールドを決定します。マッピングしない場合、lookupフィールドはリクエストから省略され、Selligentはサーバー側のデフォルトであるMASTER.MAIL(メインオーディエンスのメールフィールド)を適用します。トランザクション構成で別のフィールドまたは関連プロファイルスコープによって連絡先を識別する場合にのみ、SCOPE.FIELD形式の値をマッピングしてください。 |
| 外部ID | このメッセージ送信に使用するオプションの外部ID。リクエストの追跡に使用されます。 |
最終更新日 :: 2026年November月18日