TAPIDクッキーについて | ビジターのスティッチング | Tealium開発者ドキュメントプレビュー

動作原理

TAPIDはHTTP専用のブラウザクッキーです。元々はクロスドメインの識別を容易にするために設計され、Tealiumのサーバーサイド製品（例：AudienceStream）で使用される匿名IDを保存します。

訪問のコンピュータにTAPIDクッキーがCollectタグのターゲットドメインに構成されていない場合、ドメインはCollectタグのペイロードに基づいてTAPIDクッキーを生成します。

TAPIDクッキーの値は、ユーザーの訪問IDに構成されます。この値は通常、クライアントデバイスから取得されます。TAPIDは、ユーザーのデバイスが訪れたアカウントとプロファイルの値を、次の形式で連結された値のリストとして保存します。

account-1/profile-1>visitor_id_value-1|account-2/profile-2>visitor_id_value-2

TAPIDは通常、サードパーティのクッキーですが、ファーストパーティドメインではファーストパーティのクッキーになることもあります。

一度構成されたら、クッキー内のvisitor_id_valueは通常変更されません。

TAPID内のアカウントとプロファイルの値

WebページのTAPIDクッキーのアカウントとプロファイルの値を見つけるには、次の手順を実行します。

ブラウザでTealium Collectタグを読み込むWebページを開きます。
ブラウザの開発者コンソールを開きます。
tealという名前のNetworkリクエストをフィルタリングします。
ページをリフレッシュします。
Collectタグの参照（i.gifまたは/event）を見つけます。
リクエストヘッダーを調べて、ターゲットのアカウントとプロファイルを特定します。
レスポンスを調べて、TAPIDクッキーの値を確認します。
TAPIDクッキーのアカウントとプロファイルに関連する部分を抽出します。

IDの解決

AudienceStreamは、次の順序で訪問プロファイルIDを決定します。

TAPIDクッキー（tealium_thirdparty_visitor_idとも呼ばれます）。
tealium_visitor_idイベント属性。
utag_main v_id cookie（tealium_firstparty_visitor_idとも呼ばれます）。

AudienceStreamは、TAPID識別子が受信リクエストに存在する場合、常に主要な識別子として使用します。ユーザーが2つのドメインを跨いで追跡されている場合、AudienceStreamは2番目のドメインのファーストパーティクッキーを使用してユーザーを識別しません。したがって、AudienceStreamでは、2番目のドメインのファーストパーティクッキーを使用してユーザーを検索することはできません。

訪問スティッチングの問題

訪問のプロファイルデータは、共有スマートテレビや公共のキオスクなどのデバイスを複数の訪問が使用する場合、汚染される可能性があります。2番目のユーザーが匿名クッキーでそのデバイスにログインした場合、AudienceStreamは引き続き最初のユーザーにアクティビティを記録します。デバイス上のすべての匿名ユーザーのトラフィックは、TAPIDクッキー内の最初のユーザーに記録されます。

詳細については、訪問スイッチングを参照してください。

ブラウザのサポート

サードパーティクッキーのブラウザサポートが続けば、ドメイン間での匿名ユーザーの追跡能力はますます困難になります。訪問スティッチングを使用すると、ユーザーがデータレイヤーで自分自身を識別した場合、AudienceStreamは2つ以上のドメインを跨いでユーザーを解決できます。

ファーストパーティドメインとTAPID

ファーストパーティドメインを使用すると、Tealiumサービスはファーストパーティリクエストを使用できるため、広告ブロッカーや同様の技術によるデータの損失を軽減できます。

ファーストパーティドメインは、ユーザーが訪れているウェブサイトをホストするドメインです。サードパーティドメインは、現在のウェブサイトのドメインと一致しないすべてのドメインです。

ファーストパーティドメインを使用する場合、TAPIDクッキーは引き続きHTTP専用のブラウザクッキーですが、Tealiumのサードパーティドメインではなく、ウェブサイトをホストするファーストパーティドメインに割り当てられます。したがって、ファーストパーティドメインでは、TAPIDクッキーはクロスドメインのトラッキング機能を失います。

詳細については、ファーストパーティドメインについてを参照してください。

TAPIDクッキーデータの変更

APIリクエストには、TAPIDクッキーの値を変更するための3つのパラメータが含まれています。これらのパラメータは、現在の受信APIリクエストに関連するTAPID内のアカウントとプロファイルの値のみに影響します。他のアカウントとプロファイルの値は変更されません。

パラメータは次のエンドポイントに対してサポートされています。

i.gif - Tealium Collectタグ
/event - HTTP API
vdata - Visitor Data Enrichment

パラメータ	タイプ	アクション	ノート
`tealium_override_tapid`	文字列	AudienceStreamとサーバーサイド製品が、このイベントで提供された値を訪問IDとして使用するようにします。 `i.gif`および`vdata`に対してのみ、`Set-Cookie`レスポンスヘッダーを変更して、指定した値を使用してTAPIDを変更します。	このパラメータを使用すると、TAPIDをクロスドメインのトラッキングに保持しながら、最後に知られているユーザーに基づいて訪問スイッチングを有効にすることができます。
`tealium_delete_3rd_party_vid_cookies`	ブール値	AudienceStreamとサーバーサイド製品が、このイベントの訪問プロファイルIDの優先順位を確認する際に、TAPIDクッキーの受信リクエスト値を無視するようにします。 `i.gif`および`vdata`に対してのみ、`Set-Cookie`レスポンスヘッダーを変更して、現在のアカウントとプロファイルのTAPIDを削除します。
`tealium_skip_3rd_party_vid_cookies`	ブール値	AudienceStreamとサーバーサイド製品が、このイベントのTAPID値を無視します。

これらのパラメータは現在のイベントのみに影響します。たとえば、1つのイベントでskipパラメータを構成し、次のイベントで構成しない場合、次のイベントではTAPIDクッキーはスキップされません。ただし、overrideパラメータを1度構成すると、TAPIDが指定した値に変更されます。

例

以下の例は、3つのパラメータがTAPIDデータをどのように変更するかを示しています。

オーバーライド

リクエスト

ボディ:

{
  "tealium_account": "tealium",
  "tealium_profile": "alt",
  "tealium_visitor_id": "user@tealium.com",
  "tealium_override_tapid": "user"
}

クッキー:

TAPID=tealium/main>12345|tealium/alt>67890|;

レスポンス

クッキーの構成（オーバーライド）：i.gifおよびvdataのみ

TAPID=tealium/alt>user|tealium/main>12345|;

イベント

{
  "visitorId": "user", // オーバーライド
  "firstPartyCookieId": "user@tealium.com",
  "thirdPartyCookieId": "user" // オーバーライド
}

スキップ

リクエスト

ボディ:

{
  "tealium_account": "tealium",
  "tealium_profile": "alt",
  "tealium_visitor_id": "user@tealium.com",
  "tealium_skip_3rd_party_vid_cookies": true
}

クッキー:

TAPID=tealium/main>12345|tealium/alt>67890|;

レスポンス

クッキーの構成：i.gifおよびvdataのみ

TAPID=tealium/alt>67890|tealium/main>12345|;

イベント

{
  "visitorId": "user@tealium.com", // TAPIDスキップ
  "firstPartyCookieId": "user@tealium.com",
  "thirdPartyCookieId": "67890"
}

削除

リクエスト

ボディ:

{
  "tealium_account": "tealium",
  "tealium_profile": "alt",
  "tealium_visitor_id": "user@tealium.com",
  "tealium_delete_3rd_party_vid_cookies": true
}

クッキー:

TAPID=tealium/main>12345|tealium/alt>67890|;

レスポンス

クッキーの構成（リセット）：i.gifおよびvdataのみ

TAPID=tealium/main>12345|;

TAPIDのaccount/profile部分を削除した後、TAPIDが空になった場合、クライアントからクッキーを削除するためにset-cookie maxAge=0が返されます。i.gifおよびvdataのみ

イベント

{
  "visitorId": "user@tealium.com",
  "firstPartyCookieId": "user@tealium.com"
}

オーバーライドとスキップ

リクエスト

ボディ:

{
  "tealium_account": "tealium",
  "tealium_profile": "alt",
  "tealium_visitor_id": "user@tealium.com",
  "tealium_override_tapid": "user",
  "tealium_skip_3rd_party_vid_cookies": true
}

クッキー:

TAPID=tealium/main>12345|tealium/alt>67890|;

レスポンス

クッキーの構成（オーバーライド）：i.gifおよびvdataのみ

TAPID=tealium/alt>user|tealium/main>12345|;

イベント

{
  "visitorId": "user@tealium.com", // TAPIDスキップ
  "firstPartyCookieId": "user@tealium.com",
  "thirdPartyCookieId": "user" // オーバーライド
}

オーバーライドと削除

リクエスト

ボディ:

{
  "tealium_account": "tealium",
  "tealium_profile": "alt",
  "tealium_visitor_id": "user@tealium.com",
  "tealium_override_tapid": "user",
  "tealium_delete_3rd_party_vid_cookies": true
}

クッキー:

TAPID=tealium/main>12345|tealium/alt>67890|;

レスポンス

クッキーの構成：i.gifおよびvdataのみ

TAPID=tealium/alt>user|tealium/main>12345|;

tealium_override_tapidはtealium_delete_3rd_party_vid_cookiesよりも優先されます。

イベント

{
  "visitorId": "user", 
  "firstPartyCookieId": "user@tealium.com",
  "thirdPartyCookieId": "user" // オーバーライド
}

スキップと削除

リクエスト

ボディ:

{
  "tealium_account": "tealium",
  "tealium_profile": "alt",
  "tealium_visitor_id": "user@tealium.com",
  "tealium_skip_3rd_party_vid_cookies": true,
  "tealium_delete_3rd_party_vid_cookies": true
}

クッキー:

TAPID=tealium/main>12345|tealium/alt>67890|;

レスポンス

クッキーの構成（リセット）：i.gifおよびvdataのみ

TAPID=tealium/main>12345|;

イベント

{
  "visitorId": "user@tealium.com", // TAPID削除され、スキップされる
  "firstPartyCookieId": "user@tealium.com"
}

オーバーライド、スキップ、および削除

リクエスト

ボディ:

{
  "tealium_account": "tealium",
  "tealium_profile": "alt",
  "tealium_visitor_id": "user@tealium.com",
  "tealium_override_tapid": "user",
  "tealium_skip_3rd_party_vid_cookies": true,
  "tealium_delete_3rd_party_vid_cookies": true
}

クッキー:

TAPID=tealium/main>12345|tealium/alt>67890|;

レスポンス

クッキーの構成：i.gifおよびvdataのみ

TAPID=tealium/alt>user|tealium/main>12345|;

tealium_override_tapidはtealium_delete_3rd_party_vid_cookiesよりも優先されます。

イベント

{
  "visitorId": "user@tealium.com", // TAPIDスキップ
  "firstPartyCookieId": "user@tealium.com",
  "thirdPartyCookieId": "user" // オーバーライド
}