コネクター

データ収集または活性化のためのAPIを提供していますか？クライアントサイドのJavaScriptタグに相当するサーバーサイドがありますか？もしそうなら、このガイドではTealium Customer Data HubでのアウトバウンドデータのAPI統合の仕組みを説明します。

コネクターの仕組み

コネクター は、データを送信するためのTealiumとベンダー間の統合です。コネクターはベンダーのAPIからのメソッドを表す アクション を提供します。コネクターはTealiumユーザーにデータをリアルタイムで活性化し、直接ベンダーに送信するための簡素化されたワークフローを提供します。

イベントと顧客データ

イベントデータ を送信するコネクターは、Tealium EventStreamで使用されます。

顧客データ を送信するコネクターは、Tealium AudienceStreamで使用されます。

構成

コネクターは以下の部分で管理されます：

• コネクター
  コネクターは、通常APIキーやアカウントID、または認証資格情報を使用してベンダーに接続を確立します。
• アクション
  アクションは特定のベンダーAPIメソッドを実装します。各アクションにはデータのソース（イベントまたは顧客）、データマッピング、および必要なベンダー構成が必要です。複数のアクションが単一のコネクターに関連付けられています。
• データマッピング
  データマッピングは、イベントまたは顧客からの動的値がベンダーに送信されるかを決定します。

アクションの例

以下の例は、さまざまなベンダーカテゴリーからの一般的なコネクターアクションを示しています：

• アナリティクス
  ページビュー、注文購入、またはユーザー登録などのアナリティクスイベントを送信します。
• ディスプレイ広告
  広告セグメントの追加または削除。
• メール
  リストへの追加または削除、トリガーメール、または購読者の関連データの追加。
• CRM
  リードやコンタクトの作成、リードの変換、またはレコードのアップサート（挿入または更新）。
• モバイル
  SMSやプッシュ通知の送信、アプリのインストールの追跡、またはアプリ内イベントの送信。

コネクターについてもっと学ぶ.

例：Facebook Audiences Connector

Facebook Audiences Connectorを使用すると、Facebook広告ユーザーは、一つ以上のデータソースから収集されたユーザー行動に基づいてリアルタイムでカスタムオーディエンスを管理できます。

このコネクターは以下のアクションを提供します：

• ユーザーをカスタムオーディエンスに追加
• ユーザーをカスタムオーディエンスから削除
• ユーザーをすべてのカスタムオーディエンスからオプトアウト

各アクションには、Facebookカスタムオーディエンスのデータマッピングに必要なフィールドのリストが用意されています。

認証

ベンダーAPIが認証を必要とする場合、Tealiumは次の2つのソリューションを提供します：

• Tealium提供の資格情報
  Tealiumは、ユーザーを代表して行動するサーバーサイドアプリを作成および管理します。Tealiumはベンダーとの認証関係を維持します。
• 顧客提供の資格情報
  Tealiumユーザーは、接続を認証するために必要なAPIアクセスをベンダーから取得します。

両方のソリューションにおいて、Tealiumは次の認証タイプをサポートします：

• Basic Auth（ユーザー名とパスワード）
• OAuth 2.0
• JSON Web Tokens (JWT)

APIが同時に発行できるトークン数に制限がある場合、Tealiumユーザーは、私たちが世界中の数十のサーバーに分散しているため、問題に直面する可能性があります。

ベストプラクティス

アセット作成

アセット作成は、TealiumユーザーがTealium Customer Data Hub (CDH)を離れることなくコネクターで使用するリソースを作成する能力です。たとえば、Facebook Audiencesコネクターでは、ユーザーは新しいFacebookカスタムオーディエンスを作成し、そのオーディエンスを新しいコネクターアクションのターゲットとして選択することができます。

このオプション機能は、APIメソッドをサポートするすべてのベンダーに提供されます。リソース作成メソッドの一般的な例には次のものがあります：

• ディスプレイ広告
  広告主セグメントまたはオーディエンスを作成します。
• メール
  購読者リストまたは連絡先リストを作成します。

動的ベンダーオプション

Tealiumは、ベンダープラットフォームから直接取得したデータを使用してコネクターアクションのオプションを動的に構成することで、ユーザーを支援します。

たとえば、Facebook Audiencesコネクターの構成画面では、TealiumはユーザーのFacebook広告アカウントからカスタムオーディエンスのリストを取得するAPIコールを行います。これにより、ユーザーは外部リソースを熟知した名前と役立つメタデータで閲覧でき、正しいリソースを選択していることを確認できます。

これらの動的構成オプションは、時には連続したコールとして実行する必要がある場合があります。たとえば、CRMコネクターでは、CRMオブジェクトの主キーフィールドを取得するために、まずCRMオブジェクトのリストを取得する必要があります。

デフォルトでアップサート

ベンダープラットフォームでレコードを作成または更新するAPIメソッドについては、Tealiumは単一のリクエストでupsertをネイティブでサポートすることを好みます。これにより、Tealiumからの発信APIコールの数が最小限に抑えられます。たとえば、レコードを作成または更新する前に、APIユーザーはまずレコードが存在するかどうかを確認する必要があります。レコードが存在しない場合、次のAPIコールでレコードが作成されます。レコードが存在する場合、次のAPIコールで既存のレコードが更新されます。

バッチ処理とレート制限

Tealiumの目標はリアルタイムパフォーマンスを提供することですが、一部のベンダーはデータを小さなバッチで送信することを好むことがあります。これは、大量のデータを扱う場合に特に当てはまります。

APIを使用する個々のアカウントに対してベンダーがレート制限を構成することをお勧めします。これにより、高ボリュームの少数のアカウントがシステム全体に影響を与えるのを防ぎます。

Tealiumコネクターは、使用するAPIエンドポイントの望ましいしきい値に準拠します。レート制限の例は次のとおりです：

• 1秒あたりのリクエスト数が最大10で、リクエストごとに50イベント = 秒あたり500リクエスト
• 分あたり10,000イベントで、リクエストごとに最大10KB = 秒あたり約167リクエスト

制限事項

Tealiumコネクターは現在、以下をサポートしていません：

• ファイル転送
• 5000ms以内に接続しないベンダーAPI
• 5000ms以内にリクエストに応答しないベンダーAPI（バッチリクエストの場合は10秒）

パートナーになる

お問い合わせください して、技術を統合しましょう。