---
title: インサイダーコネクタ構成ガイド
description: この記事では、インサイダーコネクタの構成方法について説明します。
url: https://docs.tealium.com/ja/server-side-connectors/insider-connector/
---
## API情報
このコネクタは以下のベンダーAPIを使用します：
* API名：Insider API
* APIバージョン：v1
* APIエンドポイント：`https://unification.useinsider.com/api/user/v1`
* ドキュメント：[Insider APIs](https://academy.useinsider.com/docs/api-reference-insider-apis)
## コネクタアクション
| **アクション名** | **AudienceStream** | **EventStream** |
| --- | --- | --- |
| アップサートおよびサブスクライブ（バッチ処理） | ✓ | ✓ |
| アップサートおよびサブスクライブ（リアルタイム） | ✓ | ✓ |
| 削除帰属（バッチ処理） | ✓ | ✓ |
| 削除帰属（リアルタイム） | ✓ | ✓ |
| ユーザー削除 | ✓ | ✓ |
### バッチ制限
このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、[バッチアクション](https://docs.tealium.com/batched-actions/)を参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：
* 最大リクエスト数：1000
* 最古のリクエストからの最大時間：10分
* リクエストの最大サイズ：5 MB
## 構成の構成
コネクタマーケットプレイスに移動して、新しいコネクタを追加します。コネクタを追加する一般的な手順については、[コネクタについて](https://docs.tealium.com/about-connectors/)を参照してください。
コネクタを追加した後、以下の構成を構成します：
* **パートナー名**
**Inone > Inone Settings > [Account Preferences](https://academy.useinsider.com/docs/account-preferences)** に移動して、パートナー名をコピーして貼り付けます。
* **APIキー**
リクエストを認証するためにAPIキーが必要です。トークンの生成については、[API認証トークン](https://academy.useinsider.com/docs/api-authentication-tokens)を参照してください。
コネクタの構成が完了したら、**完了**をクリックします。
## アクション構成 — パラメータとオプション
コネクタアクションを構成するために**続行**をクリックします。アクションの名前を入力し、アクションタイプを選択します。
このセクションでは、各アクションのパラメータとオプションの構成方法について説明します。
### アクション — アップサートおよびサブスクライブ（バッチまたはリアルタイム）
#### パラメータ
| **パラメータ** | **説明** |
| --- | --- |
| | **ユーザー識別子** |
| 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。 |
| 単価 | 割引なしの製品価格。 |
| 単価販売価格 | 製品の単価。 |
| 色 | ユーザーが選択した製品の色。 |
| サイズ | ユーザーが選択した製品のサイズ。 |
| 配送料 | カート内のアイテムの配送料。 |
| プロモーション名 | プロモーションの名前。 |
| プロモーション割引 | プロモーションによって適用された割引の総額。 |
| イベントカスタムパラメータ | カスタムイベントパラメータを選択します |
| | 複数のイベントを追加するには、配列属性を提供します。配列タイプの属性は同じ長さでなければなりません。イベントパラメータ配列とイベントカスタムパラメータ配列は同じ長さでなければなりません。単一値属性は使用でき、各イベントに適用されます。 |
| | **テンプレートとテンプレート変数** |
| イベントテンプレート変数 | **イベントテンプレート**のデータ入力としてテンプレート変数を提供します。詳細および使用例については、[connector-template-variables](https://docs.tealium.com/connector-template-variables/)を参照してください。ドット表記を使用してネストされたテンプレート変数に名前を付けます。例：`items.name`。ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。 |
| イベントテンプレート | ネストされたオブジェクトをサポートするために、変数のJSON配列でテンプレートを定義します。**イベントテンプレート変数**セクションでマップされたテンプレート変数をテンプレートで使用できます。テンプレートが定義されている場合、**イベントパラメータ**および**イベントカスタムパラメータ**セクションの構成は無視されます。テンプレートについての詳細は、[テンプレートガイド]()を参照してください。|
### アクション — 削除帰属（バッチまたはリアルタイム）
#### パラメータ
| **パラメータ** | **説明** |
| --- | --- |
| | **ユーザー識別子** |
| Email | ユーザーのメールアドレス。 |
| 電話番号 | ユーザーの電話番号（E.164形式）。例：+6598765432。 |
| UUID | ユーザーのUUIDパラメータ。 |
| ユーザーカスタム識別子 | ユーザーのカスタム識別情報を提供します。デフォルトまたはカスタムのユーザー識別子のうち少なくとも1つを提供する必要があります。 |
| | **ユーザー属性** |
| デフォルトユーザー属性の完全削除 | 対応するユーザーから完全に削除されるデフォルトユーザー属性を選択します。 |
| カスタムユーザー属性の完全削除 | 対応するユーザーから完全に削除されるカスタムユーザー属性を選択します。 |
| デフォルトユーザー属性の部分削除 | 部分的に削除されるデフォルトユーザー属性を選択します。例えば、配列属性からの値の1つを削除する場合です。部分的に削除できるのは配列タイプの属性のみです。配列タイプの属性をマップして複数の値を削除します。単一値属性は単一値を含む配列に変換されます。 |
| カスタムユーザー属性の部分削除 | 部分的に削除されるカスタムユーザー属性を選択します。例えば、配列属性からの値の1つを削除する場合です。部分的に削除できるのは配列タイプの属性のみです。配列タイプの属性をマップして複数の値を削除します。単一値属性は単一値を含む配列に変換されます。 |
| リストID | （オプション）部分削除のみ。ニュースレター連絡先リストID（ユーザーが直接追加されます）。 |
### アクション — ユーザー削除
#### パラメータ
| **パラメータ** | **説明** |
| --- | --- |
| Email | ユーザーのメールアドレス。 |
| 電話番号 | ユーザーの電話番号（E.164形式）。例：+6598765432。 |
| UUID | ユーザーのUUIDパラメータ。 |
| ユーザーカスタム識別子 | ユーザーのカスタム識別情報を提供します。デフォルトまたはカスタムのユーザー識別子のうち少なくとも1つを提供する必要があります。 |