---
title: コネクタについて（レガシー）
description: この記事では、Tealium EventStream API HubおよびTealium AudienceStream CDP用のコネクタを追加および構成する方法について説明します。
url: https://docs.tealium.com/ja/server-side/connectors/connectors-legacy/about/
---

<blockquote>
これはコネクタインターフェースのレガシーバージョンであり、間もなく非推奨となります。新しいインターフェースについては、[about-connectors](https://docs.tealium.com/about-connectors/)を参照してください。
</blockquote>


## 動作原理

コネクタは、Tealiumと他のベンダー間でリアルタイムにデータを転送する統合です。コネクタは、ベンダーがサポートするAPIを表すアクションを提供します。アクションは、フィードからの受信イベントや訪問がオーディエンスに参加または離脱することによってリアルタイムでトリガーされます。アクションは、Tealiumの属性をベンダーの期待するパラメータに関連付けるマッピングに基づいてデータを送信します。

### 用語

* **コネクタ**  
  コネクタは、ベンダーアカウントへの接続を表します。これは、アカウントID、ユーザー名とパスワード、またはAPIキーを使用して構成されます。
* **アクション**  
  アクションは、メールのトリガー、カスタムオーディエンスの構築、リードの管理などのベンダー操作です。アクションはベンダーサービスによって異なります。単一のコネクタに複数のアクションを関連付けることができます。
* **頻度上限**  
  コネクタアクションはリアルタイムで実行されますが、トリガーされる前に待機期間が設計されているアクションもあります。頻度上限を構成することで、アクションが即座にトリガーされないようにすることができます。[頻度上限と優先順位についての詳細を学ぶ]()
* **ソース**  
  ソースは、アクション対象となるデータの起源を示します。ソースはオーディエンスまたはイベントフィードである可能性があります。

### 同意カテゴリ

マーケットプレイスの各コネクタには、利用可能なアクションごとに1つ以上の同意カテゴリが割り当てられています。特定のコネクタの同意カテゴリを表示するには、コネクタアクションの横にある情報アイコンをクリックします。

![](https://docs.tealium.com/images/server-side/eventstream-connector-consent-categories.png)

AudienceStreamは**CDP**同意カテゴリに、DataAccessは**Big Data**同意カテゴリに分類されます。サーバーサイドの同意についての追加情報は、[Consent Preferences Manager](https://docs.tealium.com/ja/iq-tag-management/consent-management/consent-preferences-dialog/manage/)を参照してください。

### リトライ

コネクタアクションが失敗した場合、1分、5分、30分の間隔で3回リトライされます。後続のリトライ試行のいずれかでリクエストが成功した場合、UIでリクエストが成功したと報告されます。3回のリトライがすべて失敗した場合、リクエストはドロップされ、UIでエラーとして報告されます。

次のエラーコードが発生した場合にリトライが試みられます：

* 408 – 禁止されています
* 429 – リクエストが多すぎます
* 500 – サーバー内部エラー
* 502 – 不正なゲートウェイ
* 503 – サービス利用不可
* 504 – ゲートウェイタイムアウト

**応答タイムアウト - ベンダーAPIが5000ミリ秒以内に応答しなかった**という応答が受信された場合、リトライは試みられません。リクエストペイロードは送信されましたが、ベンダーからの応答が許可された5秒以内に送信されなかったため、リクエストは失敗として扱われます。ベンダー側でリクエストが成功している可能性がありますが、5秒を超えて応答が得られなかったため、失敗とみなします。

### 過負荷保護

コネクタは、複数のデータハンドラーインスタンスを通じてアクションを実行します。時には、データハンドラーがベンダーとの通信エラーに遭遇することがあります。エラーが構成された閾値を超えると、Tealiumはエラー率が下がるまでベンダーへのデータ送信を一時停止または制限することができます。

例えば、インスタンスの全体的な失敗率が100回の試行につき40%を超えた場合、そのインスタンスは1分間アクションの処理を一時停止します。その後、キュー内のアクションの半分を処理しようとします。これら50回の試行の失敗率が20%を超える場合、インスタンスはさらに60秒間一時停止し、その後再試行します。それ以外の場合は、インスタンスは完全な操作を再開します。

Tealiumは、顧客の最大の成功とパフォーマンスを確保するために、必要に応じて各レベルでの閾値を活性化および調整します。

### 制限データ

制限データの構成はコネクタには適用されません。制限データとしてマークされた属性は、マッピングを通じて送信される場合でも、訪問プロファイルの一部として送信される場合でも常に含まれます。これを変更することはできません。[制限データについての詳細を学ぶ](https://docs.tealium.com/about-restricted-data/).

### IP許可リスト

ベンダーがどのシステムからのリクエストを受け入れるかに厳格なルールを持っている場合、TealiumのIPアドレスを許可リストに追加します。詳細については、[list-of-tealium-ip-addresses-for-whitelist](https://docs.tealium.com/list-of-tealium-ip-addresses-for-whitelist/)を参照してください。

## 画面ナビゲーション

### 概要画面

コネクタの概要画面のサマリーには、以下のメトリックが列として表示されます：

* **合計**  
  トリガーされたアクションの合計。情報（i）アイコンをクリックすると、この列の合計のタイムラインが表示されます。
* **成功**  
  アクションの成功数。
* **エラー**  
  アクションのエラー数。
* **データソース（EventStream）またはオーディエンス（AudienceStream）**  
  コネクタに関連するデータソースまたはオーディエンス。
* **フィード（EventStream）またはトリガー（AudienceStream）**  
  アクションのフィードまたはトリガーの名前。

**アクション追加**メニューを展開して、**編集**、**複製**、**コネクタIDの取得**、または**削除**機能にすばやくアクセスします。

![](https://docs.tealium.com/images/server-side/screenoverviewaddactionoptions.png)

### 非推奨のコネクタとアクション

コネクタとアクションは非推奨となることがあり、将来的にサポートされなくなるか削除される可能性があります。コネクタまたはアクションが新しいバージョンや新しいコネクタまたはアクションに置き換えられた場合、通常、非推奨となります。

非推奨には次の2つのタイプがあります：

* **機能的非推奨** – コネクタまたはアクションは非推奨とされ、将来的に削除される可能性がありますが、まだ動作しています。
* **完全非推奨** – コネクタまたはアクションは非推奨とされ、もはや動作しません。完全に非推奨のコネクタのアクションは実行されません。

コネクタまたはアクションが非推奨の場合、コネクタリストのコネクタまたはアクションの横にアイコンが表示されます。アイコンにカーソルを合わせると、非推奨のコネクタまたはアクションがまだ動作しているかどうかを指定するメッセージが表示されます。

![](https://docs.tealium.com/images/server-side/deprecatedconnector.png)

### アクションのレポートチャート

次のセクションでは、レポートチャートの表示方法、エラーの詳細の表示方法、エラーレポートのダウンロード方法について説明します。

![](https://docs.tealium.com/images/server-side/connector-reporting-graph-overview.png)

#### チャートの表示

コネクタアクションをクリックすると、チャートにはそのアクションが実行された日ごとの回数が表示されます。グラフは、過去1日、1週間、または1ヶ月のデータを表示することができます。成功したアクションは灰色で表示され、エラーは赤色で表示されます。チャートの任意の部分をクリックすると、その表示のデータのサマリーが表示されます。
![](https://docs.tealium.com/images/server-side/successful-connector-triggers.png)

#### サンプルエラーの表示

コネクタのサンプルエラーを表示するには、次の手順を実行します：

1. 表示したいコネクタのアクションをクリックします。
1. コネクタのサマリーから**過去1日**、**過去1週間**、または**過去1ヶ月**を選択します。
1. グラフの下に、エラーメッセージのリストビューが表示されます。リストの各エントリには、エラーカテゴリ、レポートに含まれるサンプルエラーの数、エラーの説明を含むメッセージ、およびエラーの発生回数が表示されます。
1. エラーの詳細を表示するには、カテゴリの横にある右矢印をクリックして展開します。
詳細ビューには、週の曜日、日付、時間を含むタイムスタンプで影響を受けたコードのサンプルが含まれます。
#### サンプル化されたエラーのダウンロード

コネクターのサンプル化されたエラーをダウンロードするには、以下の手順に従ってください：

1. 表示したいコネクターのアクションをクリックします。
1. コネクターの概要から、**Rolling Day**、**Rolling Week**、または **Rolling Month** を選択します。
1. **Download Sampled Errors** をクリックします。  
CSVファイルがデフォルトのダウンロード場所に保存されます。
1. CSVファイルを開いて詳細を確認するか、他の人と共有してさらなる協力を行います。