コネクタについて

動作原理

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

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

用語

• コネクタ
  コネクタはベンダーへの接続を表します。接続は、アカウントID、ユーザー名とパスワード、APIキー、または他の認証方法を使用して構成されます。
• アクション
  アクションは、コンバージョンの追跡、カスタムオーディエンスの構築、リードの管理などのベンダー操作です。アクションはベンダーサービスによって異なります。単一のコネクタに複数のアクションを関連付けることができます。
• トリガー
  • イベントコネクタの場合、フィード内のすべてのリアルタイムイベントに対してアクションがトリガーされます。
  • オーディエンスコネクタの場合、アクションはオーディエンス内の訪問のステータスに基づいてトリガーされます：
    • Joined Audience: 訪問がこの訪問中にオーディエンスに参加しました。
    • Left Audience: 訪問がこの訪問中にオーディエンスを離れました。訪問が削除された場合、このアクションは発生しません。詳細については、訪問の削除を参照してください。
    • In Audience at start of visit: 訪問の開始時に訪問はオーディエンスにいました。
    • In Audience at end of visit: 訪問の終了時に訪問はオーディエンスにいました。
• コネクタメタデータ
  コネクタのコンテキストを説明するマッピング可能な値（オーディエンス名、アクションIDなど）。これらを使用して、手動でコピー＆ペーストすることなく、コネクタ情報を下流に渡します。詳細については、コネクタメタデータを参照してください。
• Frequency Cap
  コネクタアクションはリアルタイムで実行されますが、トリガーされる前に待機期間が設計されているアクションもあります。頻度キャップを構成することで、アクションが直ちにトリガーされないようにダウンタイム期間を構成できます。詳細については、アクションの頻度制限と優先順位を参照してください。
• ソース
  ソースは、対象となるデータの起源を示します。ソースは、オーディエンスまたはイベントフィードである可能性があります。

同意カテゴリ

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

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

リトライ

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

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

• 408 – Forbidden
• 429 – Too Many Requests
• 500 – Internal Server Error
• 502 – Bad Gateway
• 503 – Service Unavailable
• 504 – Gateway Timeout

Response Timeout - Vendor API did not respond within 5000 millisecondsの応答が受信された場合、リトライは試みられません。リクエストペイロードは送信されましたが、ベンダーは許可された5秒以内に応答を送信しませんでした。ベンダー側でリクエストが成功している可能性がありますが、応答を得るのに5秒以上かかったため、失敗として扱います。

過負荷保護

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

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

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

制限データ

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

IP許可リスト

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

訪問IDの同期

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

画面ナビゲーション

概要画面

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

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

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

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

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

詳細画面

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

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

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

コネクタアクションのエラー情報を表示するには、以下の手順を使用します：

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

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

コネクタのサンプルエラーをエクスポートするには、以下の手順を使用します：

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

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

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

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

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