コネクタについて

仕組み

コネクタは、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ホワイトリスト

使用しているコネクタがどのシステムからのリクエストを受け入れるかについて厳格なルールを持っている場合、Customer Data HubのIPアドレスをホワイトリストに登録できます。コネクタリクエストを行うIPアドレスは、Customer Data HubのIPアドレスで見つけることができます。

画面ナビゲーション

概要画面

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

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

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

廃止されたコネクタとアクション

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

廃止には次の2つのタイプがあります：

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

コネクタまたはアクションが廃止されると、コネクタリストのコネクタまたはアクションの隣にアイコンが表示されます。アイコンにマウスを置くと、廃止されたコネクタまたはアクションがまだ動作しているかどうかを指定するメッセージが表示されます。

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

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

チャートの表示

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

サンプルエラーの表示

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

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

サンプルエラーのダウンロード

コネクタのサンプルエラーをダウンロードするには、次の手順を使用します：

1. 表示したいコネクタのアクションをクリックします。
2. コネクタのサマリーから、ローリングデイ、ローリングウィーク、またはローリングマンスを選択します。
3. サンプルエラーのダウンロードをクリックします。
   CSVファイルがデフォルトのダウンロード場所に保存されます。
4. CSVファイルを開いて詳細を確認するか、他の人とファイルを共有してさらなる共同作業を行います。