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

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

バッチ制限

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

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

コネクタアクション

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

構成の構成

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

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

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

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

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

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

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

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

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トランザクショナルジャーニーを選択します。トランザクショナルカスタマージャーニーは、このフィールドで取得され、表示されます。
受信者	必須。コンテンツを送信する受信者。
言語	必須。メールを送信する言語。