Insiderコネクタ構成ガイド

API情報

このコネクタは、次のベンダーAPIを使用します。

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

コネクタアクション

アクション名	訪問プロファイル	イベントデータ
アップサートおよび購読（バッチ）	✓	✓
アップサートおよび購読（リアルタイム）	✓	✓
アトリビューションの削除（バッチ）	✓	✓
アトリビューションの削除（リアルタイム）	✓	✓
ユーザーの削除	✓	✓

バッチ制限

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

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

構成の構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。詳細については、コネクタについてを参照してください。

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

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

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

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

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

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

パラメータ

パラメータ	説明
	ユーザー識別子
メールアドレス	ユーザーのメールアドレス。
電話番号	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配列であるテンプレートを定義します。イベントテンプレート変数セクションでマッピングされたテンプレート変数をテンプレート内で使用できます。テンプレートを定義すると、イベントパラメータおよびイベントカスタムパラメータセクションの構成は無視されます。テンプレートの詳細については、テンプレートガイドを参照してください。

アクション — アトリビューションの削除（バッチまたはリアルタイム）

パラメータ

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

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

パラメータ

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