コネクタについて（レガシー）

これはコネクタインターフェースのレガシーバージョンであり、間もなく非推奨となります。新しいインターフェースについては、コネクタについてを参照してください。

動作原理

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

用語

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

同意カテゴリ

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

AudienceStreamはCDP同意カテゴリに、DataAccessはBig Data同意カテゴリに分類されます。サーバーサイドの同意についての追加情報は、Consent Preferences Managerを参照してください。

リトライ

コネクタアクションが失敗すると、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は、顧客の最大の成功とパフォーマンスを確保するために、必要に応じて各レベルでの閾値を活性化および調整します。

制限データ

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

IP許可リスト

ベンダーがどのシステムからのリクエストを受け入れるかに厳格なルールを持っている場合、TealiumのIPアドレスを許可リストに追加します。詳細については、許可するTealiumのIPアドレスを参照してください。

画面ナビゲーション

概要画面

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

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

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

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

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

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

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

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

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

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

チャートの表示

コネクタアクションをクリックすると、チャートにはそのアクションが実行された日ごとの回数が表示されます。グラフは、過去1日、1週間、または1ヶ月のデータを表示することができます。成功したアクションは灰色で表示され、エラーは赤色で表示されます。チャートの任意の部分をクリックすると、その表示のデータのサマリーが表示されます。

サンプルエラーの表示

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

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

サンプル化されたエラーのダウンロード

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

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