コネクタについて

動作原理

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

用語

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

同意カテゴリ

マーケットプレイスの各コネクタには、利用可能なアクションごとに1つ以上の同意カテゴリが割り当てられています。コネクタアクションの同意情報は、アクション詳細画面の追加詳細の下に表示されます。

AudienceStreamはCDP同意カテゴリに、DataAccessはビッグデータ同意カテゴリに分類されます。サーバーサイド同意についての追加情報は、同意構成マネージャーを参照してください。

リトライ

コネクタアクションが失敗すると、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アドレスリストで見つけることができます。

画面ナビゲーション

コネクタ概要画面

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

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

すべてのコネクタのメトリック（総ボリューム、成功、エラー、リトライ）をエクスポートするには、エクスポートメトリックをクリックします。

コネクタメニューを展開して、ラベルの編集、複製、削除機能にアクセスするには、次の図に示すようにします：

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

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

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

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

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

コネクタ詳細画面

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

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

アクションのサンプルエラーを表示する

コネクタアクションのエラー情報を表示するには、次の手順を実行します：

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

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

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

1. サーバーサイド > コネクタに移動し、コネクタを選択します。
2. アクションタブをクリックし、エラーがあるアクションを選択します。
   アクション詳細 画面が表示されます。
3. エクスポートサンプルエラー をクリックします。
   エラーはCSVファイルにエクスポートされ、デフォルトのダウンロード場所に保存されます。
4. CSVファイルを開いて詳細を確認するか、他の人と共有してさらに協力を進めます。