Tealium Collect HTTP APIについて

動作原理

Tealium Collect HTTP APIは、データ収集のためのGETおよびPOSTメソッドをサポートする認証済みエンドポイントです。認証されていないエンドポイントについては、HTTP API v1を参照してください。

https://collect.tealiumiq.com/v3/collect/event

セッションは訪問スコープ属性プロパティに基づいて決定されます。

地域およびグローバルエンドポイント

HTTP APIは、アカウントとプロファイルの地域を認識するクロスリージョナルエンドポイントです。

HTTP APIは以下の2つのホストをサポートしています：

• collect.tealiumiq.com
  最も近いサーバー（最も低い遅延を持つサーバー）にイベントを送信します。
• collect-<region>.tealiumiq.com
  プロファイルの地域のサーバーにイベントを送信します。

認証済みエンドポイントの場合、グローバルエンドポイントは内部的にcollect.tealiumiq.comに、地域エンドポイントはcollect-<region>.tealiumiq.comにマッピングされます。

レート制限

HTTP APIは、最大100イベント/秒のレート制限をサポートしています。

例えば、以下のように送信する場合：

• 1回の呼び出しにつき1イベントの場合、100回/秒を送信できます。
• 1回の呼び出しにつき10イベントの場合、10回/秒を送信できます。

レート制限を超えると、TealiumはHTTP 429レスポンスを返して、リクエストが多すぎることを示します。

イベントの上限を増やす必要がある場合は、Tealiumアカウントマネージャーに連絡してください。

エンドポイント

さまざまなデータ収集目的のために提供されるエンドポイントは以下の通りです：

イベント

標準データ収集のためのGETおよびPOSTリクエストをサポートするRESTfulエンドポイントです。

バルクイベント

複数のイベント（最大10）を単一のリクエストでサポートするPOSTリクエストのRESTfulエンドポイントです。

インテグレーション

incoming webhooksによって使用されるRESTfulエンドポイントです。

訪問識別子

以下の組み合わせを使用して訪問を識別します：

• 匿名ID：訪問を匿名で追跡するために使用されるID（例えば、デバイスやブラウザから）。既知の訪問の場合は、ユーザー識別子に基づいて値を使用します。
• ユーザー識別子：訪問が既知の場合に送信されます。特定のデバイスではなくユーザーを識別する値に基づいています。

匿名ID

匿名IDは、Tealiumがイベントと訪問の間で訪問を関連付けるために使用する匿名識別子です。この値がGUIDであり、訪問に対して一貫性があることを確認してください。

匿名IDのキー名はtealium_visitor_idです。

ビジネスケースに応じて、匿名値または既知のユーザー識別子に基づく値を使用します。

匿名値

Tealium iQタグ管理を使用してAPIコールをサーバー間で送信し、匿名訪問プロファイルをエンリッチする場合、tealium_visitor_idの値はutag_main_v_idクッキーの値と一致する必要があります。utag.jsの組み込み変数についての詳細は、JavaScript (Web) > Data Layerを参照してください。

Adobe LaunchまたはGoogle Tag Managerを使用している場合、値はTEALクッキーのv部分と一致する必要があります。

既知の訪問サーバー間

訪問ID属性（例：email_address）の値が存在する既知の訪問のデータを送信する場合、以下の値を__ACCOUNT_PROFILE__ATTRIBUTE-ID_ATTRIBUTE-VALUE__の形式で連結します：

• アカウント
• プロファイル
• 訪問ID属性IDおよび値

  訪問ID属性IDは、属性リストの属性名の隣または詳細情報内で見つけることができます。詳細については、属性についてを参照してください。

例えば、以下の値がある場合：

• アカウント名：my-account
• プロファイル：main
• 訪問ID属性ID：7688
• 訪問ID属性値：45653454

連結された値は：

"tealium_visitor_id":"__my-account_main__7688_45653454__"

tealium_visitor_idが正しくフォーマットされていることを確認してから進めてください。フォーマットが正しくないパラメータはAudienceStreamでの追跡にエラーを引き起こし、適切に追跡されない可能性があります。

例 JSON：

{
    "tealium_account"    : "my-account",
    "tealium_profile"    : "main",
    "tealium_event"      : "user_login",
    "email_address"      : "user@example.com",
    "tealium_visitor_id" : "__my-account_main__7688_45653454__"
}

匿名訪問または既知の訪問を使用する場合でも、APIコールに一貫したtealium_visitor_idが含まれていないと、各イベントが新しい訪問を生成し、訪問のスティッチングが不可能になります。

ユーザー識別子

AudienceStreamを使用する場合、トラッキングコールに既知のユーザー識別子（例：email_addressまたはlogin_id）を渡します。

EventStreamを使用していて、ベンダーコネクタにIDを提供する必要がある場合も、ユーザー識別子が必要です。

AudienceStreamでは、これらのユーザー識別子を使用して訪問ID属性を豊かにします。

権限要件

• サーバーサイドパブリッシャーの権限

認証

すべてのAPIコールを認証するためにはベアラートークンが使用され、APIキーは認証コールでのみ使用されます。ベアラートークンに加えて、認証レスポンスには、後続のサーバーサイドAPIコールで使用する必要がある地域固有のホスト名が含まれています。

APIキーからベアラートークンを生成する方法については、認証を参照してください。