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

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

CloudStreamでは、セグメントデータはTealiumシステムに保存または保持されません。データを取得して構成されたコネクタに送信した後、Tealiumはそれを破棄します。

### 用語

* **コネクタ**  
コネクタは、アカウントID、ユーザー名とパスワード、またはAPIキーなどの資格情報を使用して構成されるベンダーアカウントへの接続を表します。
* **アクション**  
アクションは、メールのトリガー、カスタムオーディエンスの構築、リードの管理などのベンダー操作です。アクションはベンダーサービスによって異なります。単一のコネクタに複数のアクションを関連付けることができます。
* **コネクタメタデータ**  
コネクタのコンテキスト（オーディエンス名、アクションIDなど）を説明するマッピング可能な値です。手動でコピー＆ペーストすることなく、コネクタ情報を下流に渡すために使用します。詳細については、[コネクタメタデータ](https://docs.tealium.com/add-connector/#connector-metadata)を参照してください。
* **頻度キャップ**  
コネクタアクションはリアルタイムで実行されますが、一部のアクションはトリガーされる前に待機期間が設計されています。頻度キャップを構成することで、アクションが即座にトリガーされないようにダウンタイム期間を構成できます。詳細については、[action-frequency-capping-amp-prioritization](https://docs.tealium.com/action-frequency-capping-amp-prioritization/)を参照してください。
* **ソース**  
ソースは、対象となるデータの起源を示します。ソースはオーディエンスまたはイベントフィードである可能性があります。

### 同意カテゴリ

マーケットプレイスの各コネクタには、利用可能な各アクションに対して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許可リスト

使用しているコネクタに特定のシステムからのリクエストを受け入れる厳格なルールがある場合、Customer Data HubのIPアドレスを許可リストに追加することができます。コネクタリクエストを行うIPアドレスは、[Customer Data HubのIPアドレス]()で見つけることができます。

### 訪問IDの同期

Tealiumとサードパーティベンダー間で訪問IDの一致を改善するために、クッキーマッチングタグを使用します。クッキーマッチングタグは、Tealiumとベンダー間で訪問識別子を同期し、サードパーティ識別子を要求し、匿名IDを受け取り、それをクッキーに保存します。これにより、コネクタアクションの追跡とデータの充実が向上します。詳細については、[永続的なクッキーマッチングについて](https://docs.tealium.com/about-persistent-cookie-matching/)を参照してください。

## 画面ナビゲーション

### 概要画面

コネクタの概要画面には、各コネクタについて次のデータが表示されます：

* **アクション**  
各データタイプ（イベントおよび訪問）に構成されたコネクタアクションの数。情報（i）アイコンをクリックすると、この列の合計に関するタイムラインが表示されます。
* **総ボリューム**  
コネクタのトリガーされたアクションの数。
* **成功**  
アクションの成功数。
* **エラー**  
アクションのエラー数。
* **変更日**  
コネクタが最後に変更された日付。
* **ラベル**  
コネクタに適用されたラベル。
* **ステータス**  
コネクタのステータスは、**アクティブ**、**非アクティブ**、または**廃止**のいずれかです。

すべてのコネクタのメトリック（総ボリューム、成功、エラー、リトライ）を**メトリックをエクスポート**をクリックしてエクスポートします。データはCSVファイルとしてダウンロードされます。

コネクタのメニューを展開して、追加のアクションにアクセスします：**ラベルを編集**、**複製**、および**削除**：

![](https://docs.tealium.com/images/server-side/connectors/connector-menu-expanded.png)

詳細については、[コネクタを追加する]()を参照してください。

### 詳細画面

コネクタアクションをクリックすると、コネクタの詳細画面が表示されます。デフォルトでは**概要**タブが表示され、アクションの傾向に関する情報、成功したアクション、エラーのあるアクション、および配信ステータスのグラフが表示されます。

![](https://docs.tealium.com/images/server-side/connectors/connector-details-status.png)

**過去24時間**、**過去7日間**、または**過去30日間**のトレンドデータを表示できます。デフォルトは**過去24時間**です。成功したアクションは緑色で、エラーは青色で表示されます。グラフの任意の部分をクリックすると、その表示のデータの要約が表示されます。
#### アクションのサンプルエラーを表示する

コネクタアクションのエラー情報を表示するには、以下の手順に従ってください：

1. **Connect > Connectors** に移動し、コネクタを選択します。
1. **Actions** タブをクリックし、エラーがあるアクションを選択します。  
**Action Details** 画面が表示されます。
1. **Trends** の下で、**24 Hours**、**7 Days**、**30 Days**、またはカスタムの日付範囲を選択します。
1. グラフの下に、エラーメッセージのリストが表示されます。リストの各エントリーには、エラーカテゴリ、メッセージ、レポートに含まれるエラーの数、エラーの発生総数が表示されます。
1. エラーの詳細を表示するには、リストエントリーをクリックします。  
詳細ビューには、週の日、日付、時間を含むタイムスタンプで影響を受けるコードのサンプルが含まれています。

#### サンプルエラーをエクスポートする

コネクタのサンプルエラーをエクスポートするには、以下の手順に従ってください：

1. **Connect > Connectors** に移動し、コネクタを選択します。
1. **Actions** タブをクリックし、エラーがあるアクションを選択します。  
**Action Details** 画面が表示されます。
1. **Export Sampled Errors** をクリックします。  
エラーはCSVファイルにエクスポートされ、デフォルトのダウンロード場所に保存されます。
1. CSVファイルを開いて詳細を調べるか、他の人と共有してさらなる協力を行います。

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

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

非推奨には以下の2種類があります：

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

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