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

API情報

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

API名：Insider API
APIバージョン：v1
APIエンドポイント：https://unification.useinsider.com/api/user/v1
ドキュメント：Insider APIs

コネクタアクション

アクション名	AudienceStream	EventStream
アップサートおよびサブスクライブ（バッチ処理）	✓	✓
アップサートおよびサブスクライブ（リアルタイム）	✓	✓
削除帰属（バッチ処理）	✓	✓
削除帰属（リアルタイム）	✓	✓
ユーザー削除	✓	✓

バッチ制限

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

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

構成の構成

コネクタマーケットプレイスに移動して、新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについてを参照してください。

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

パートナー名
Inone > Inone Settings > Account Preferences に移動して、パートナー名をコピーして貼り付けます。
APIキー
リクエストを認証するためにAPIキーが必要です。トークンの生成については、API認証トークンを参照してください。

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

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

コネクタアクションを構成するために続行をクリックします。アクションの名前を入力し、アクションタイプを選択します。

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

アクション — アップサートおよびサブスクライブ（バッチまたはリアルタイム）

パラメータ

パラメータ	説明
	ユーザー識別子
Email	ユーザーのメールアドレス。
電話番号	ユーザーの電話番号（E.164形式）。例：+6598765432。
UUID	ユーザーのUUIDパラメータ。
ユーザーカスタム識別子	ユーザーのカスタム識別情報。デフォルトまたはカスタムのユーザー識別子のうち少なくとも1つを提供する必要があります。
	ユーザー属性
メールオプトイン	マーケティングメールの許可。trueの場合、メールが許可されます。falseの場合、メールは許可されません。
GDPRオプトイン	Insiderキャンペーン、データ収集および処理の許可。trueまたは空の場合、Insiderはパーソナライゼーションキャンペーンを通じてユーザーと対話することができます。falseの場合、ユーザーはInsiderキャンペーンを見ることができず、どのチャンネルからもメッセージを受け取ることはありません。
SMSオプトイン	SMSメッセージの許可。trueの場合、SMSが許可されます。falseの場合、SMSは許可されません。
WhatsAppオプトイン	WhatsAppメッセージの許可。trueの場合、WhatsAppメッセージが許可されます。falseの場合、WhatsAppメッセージは許可されません。
名前	ユーザーの名前。
姓	ユーザーの姓。
誕生日	ユーザーの誕生日（RFC 3339形式）。例：1993-03-12T00:00:00Z。
性別	ユーザーの性別。
年齢	ユーザーの年齢。
言語	ユーザーの言語情報。
国	ユーザーの国情報（ISO 3166-1 alpha-2形式）。
市	ユーザーの市。
リストID	ニュースレター連絡先リストID（ユーザーが直接追加されます）。
ユーザーカスタム属性	カスタム属性を選択します。デフォルトまたはカスタムのユーザー属性、または1つのイベントのうち少なくとも1つを提供する必要があります。
	イベントパラメータ
イベント名	必須。イベントの名前。
イベント時間	必須。購入イベントの購入日（RFC 3339形式）。例：2021-01-10T21:35:20Z。
イベントグループID	イベントグループID。
製品ID	製品の一意のID。
名前	製品の名前。
通貨	製品価格に使用される通貨（ISO 4217形式）。例：USD。
単価	割引なしの製品価格。
単価販売価格	製品の単価。
色	ユーザーが選択した製品の色。
サイズ	ユーザーが選択した製品のサイズ。
配送料	カート内のアイテムの配送料。
プロモーション名	プロモーションの名前。
プロモーション割引	プロモーションによって適用された割引の総額。
イベントカスタムパラメータ	カスタムイベントパラメータを選択します
	複数のイベントを追加するには、配列属性を提供します。配列タイプの属性は同じ長さでなければなりません。イベントパラメータ配列とイベントカスタムパラメータ配列は同じ長さでなければなりません。単一値属性は使用でき、各イベントに適用されます。
	テンプレートとテンプレート変数
イベントテンプレート変数	イベントテンプレートのデータ入力としてテンプレート変数を提供します。詳細および使用例については、コネクターテンプレート変数を参照してください。ドット表記を使用してネストされたテンプレート変数に名前を付けます。例：`items.name`。ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。
イベントテンプレート	ネストされたオブジェクトをサポートするために、変数のJSON配列でテンプレートを定義します。イベントテンプレート変数セクションでマップされたテンプレート変数をテンプレートで使用できます。テンプレートが定義されている場合、イベントパラメータおよびイベントカスタムパラメータセクションの構成は無視されます。テンプレートについての詳細は、テンプレートガイドを参照してください。

アクション — 削除帰属（バッチまたはリアルタイム）

パラメータ

パラメータ	説明
	ユーザー識別子
Email	ユーザーのメールアドレス。
電話番号	ユーザーの電話番号（E.164形式）。例：+6598765432。
UUID	ユーザーのUUIDパラメータ。
ユーザーカスタム識別子	ユーザーのカスタム識別情報を提供します。デフォルトまたはカスタムのユーザー識別子のうち少なくとも1つを提供する必要があります。
	ユーザー属性
デフォルトユーザー属性の完全削除	対応するユーザーから完全に削除されるデフォルトユーザー属性を選択します。
カスタムユーザー属性の完全削除	対応するユーザーから完全に削除されるカスタムユーザー属性を選択します。
デフォルトユーザー属性の部分削除	部分的に削除されるデフォルトユーザー属性を選択します。例えば、配列属性からの値の1つを削除する場合です。部分的に削除できるのは配列タイプの属性のみです。配列タイプの属性をマップして複数の値を削除します。単一値属性は単一値を含む配列に変換されます。
カスタムユーザー属性の部分削除	部分的に削除されるカスタムユーザー属性を選択します。例えば、配列属性からの値の1つを削除する場合です。部分的に削除できるのは配列タイプの属性のみです。配列タイプの属性をマップして複数の値を削除します。単一値属性は単一値を含む配列に変換されます。
リストID	（オプション）部分削除のみ。ニュースレター連絡先リストID（ユーザーが直接追加されます）。

アクション — ユーザー削除

パラメータ

パラメータ	説明
Email	ユーザーのメールアドレス。
電話番号	ユーザーの電話番号（E.164形式）。例：+6598765432。
UUID	ユーザーのUUIDパラメータ。
ユーザーカスタム識別子	ユーザーのカスタム識別情報を提供します。デフォルトまたはカスタムのユーザー識別子のうち少なくとも1つを提供する必要があります。