TAPIDクッキーについて | ビジターのスティッチング

仕組み

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

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

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

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

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

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

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

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

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

アイデンティティ解決

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つのパラメータが含まれています。これらのパラメータは、現在の入力リクエストに関連するTAPIDのアカウントとプロファイルの値のみに影響を与えます。それ以外のアカウントとプロファイルの値は変更されません。

パラメータは以下のエンドポイントをサポートします：

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

/eventエンドポイントは、事前に構成されたTAPIDの値を読み取ることができますが、TAPIDクッキー内の値を変更することはできません。

パラメータ	タイプ	アクション	ノート
`tealium_override_tapid`	String	このイベントの訪問IDとして提供された値をAudienceStreamとサーバーサイド製品が使用するようにします。 `i.gif`と`vdata`では、しかし`/event`ではなく、`Set-Cookie`レスポンスヘッダーを変更して、TAPIDを変更するために渡す値を使用します。	このパラメータは、クロスドメイン追跡のためのTAPIDを保持しながら、最後に知られているユーザーに基づいて訪問の切り替えを可能にします。
`tealium_delete_3rd_party_vid_cookies`	Boolean	このイベントの訪問プロファイルIDの優先順位を見るときに、AudienceStreamとサーバーサイド製品がTAPIDクッキーの入力リクエスト値を無視します。 `i.gif`と`vdata`では、しかし`/event`ではなく、現在のアカウントとプロファイルのTAPIDを削除するために`Set-Cookie`レスポンスヘッダーを変更します。
`tealium_skip_3rd_party_vid_cookies`	Boolean	このイベントのTAPID値をAudienceStreamとサーバーサイド製品が無視します。

パラメータは現在のイベントのみに影響します。例えば、一つのイベントでskipパラメータを渡し、次のイベントでは渡さない場合、次のイベントはTAPIDクッキーをスキップしません。しかし、overrideパラメータを一度構成すると、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|;

レスポンス

Set Cookie (オーバーライド): i.gifとvdataのみ、/eventではない

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|;

レスポンス

Set Cookie: i.gifとvdataのみ、/eventではない

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|;

レスポンス

Set Cookie (リセット): i.gifとvdataのみ、/eventではない

TAPID=tealium/main>12345|;

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

イベント

{
  "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のみ、/eventは除く

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のみ、/eventは除く

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のみ、/eventは除く

TAPID=tealium/main>12345|;

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

イベント

{
  "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のみ、/eventは除く

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" // 上書きされます
}