Insiderコネクタ構成ガイド | サーバーサイドコネクタ | Tealium開発者ドキュメントプレビュー

API情報

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

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

コネクタアクション

アクション名	AudienceStream	EventStream
Upsert and Subscribe (Batched)	✓	✓
Upsert and Subscribe (Real-Time)	✓	✓
Delete Attribution (Batched)	✓	✓
Delete Attribution (Real-Time)	✓	✓
Delete User	✓	✓

バッチ制限

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

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

構成の構成

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

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

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

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

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

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

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

パラメータ

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

アクション — Delete Attribution (Batched or Real-Time)

パラメータ

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

アクション — Delete User

パラメータ

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

API情報

コネクタアクション

バッチ制限

構成の構成

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

アクション — Upsert and Subscribe (Batched or Real-Time)

パラメータ

アクション — Delete Attribution (Batched or Real-Time)

パラメータ

アクション — Delete User

パラメータ