---
title: 訪問者検索 (旧称 訪問者検索ツール)
description: この記事では、訪問者検索APIのグラフィカルインターフェースである訪問者検索ツールについて説明します。訪問者検索は、訪問者ID属性と検索値を使用してシステム内の訪問者レコードを特定します。
url: https://docs.tealium.com/ja/server-side/visitor-search/
---
レコードが見つかると、その訪問者の既知の属性がすべて表示され、確認できます。訪問者レコードは削除することもできます。インターフェースには、APIの動作を示すためのREST API画面も提供されています。

## 検索

訪問者レコードを見つけるには、[訪問者スティッチング]()が有効になっている必要があり、アカウントで定義されている訪問者ID属性の既知の値が必要です。

訪問者検索を行うには、以下の手順に従ってください：

1. **サーバーサイドツール > 訪問者** **検索**に移動します。
1. ドロップダウンリストから属性を選択します。
1. 選択した属性の既知の値を入力します。
1. **検索**をクリックします。  
訪問者レコードが存在する場合、結果が表示されます。

![](https://docs.tealium.com/images/server-side/whiteui-audiencestream-visitorlookuptool.png)

### 訪問者レコードの表示

訪問者レコードが見つかると、情報は二つのパネルに表示されます：左側の属性フィルターパネルと、メインのJSONオブジェクトパネルです。

#### JSONオブジェクト

メインパネルでは、訪問者レコードの生のJSONオブジェクトが表示されます。各属性データタイプはオブジェクト内のキーとして表されます。訪問者オブジェクトで利用可能なフィールドについての詳細は、[訪問者プライバシーAPIオブジェクト](https://docs.tealium.com/ja/api/v3/visitor-privacy/objects/)を参照してください。

![](https://docs.tealium.com/images/server-side/whiteui-audiencestream-visitorlookuptool-jsonoject.png)

#### 属性フィルター

左パネルは、表示される属性のリストを調整するための属性フィルターを提供します。**フィルター**メニューを使用して、**すべての属性**または**割り当てられた属性**を表示するかを選択します。**割り当てられた**を選択すると、現在見つかった訪問者プロファイルに割り当てられた値がある属性のみが表示されます。各属性タイプの見出しをクリックして、その属性リストを展開します。

| すべての属性をフィルター | 割り当てられた属性をフィルター |
|---| ---|
| ![](https://docs.tealium.com/images/server-side/whiteui-audiencestream-visitorlookuptool-filter-audience-by-all-attributes.png) | ![](https://docs.tealium.com/images/server-side/whiteui-audiencestream-visitorlookuptool-filter-by-assigned-attributes.png)|

### 訪問者の削除

訪問者レコードが見つかった場合、そのレコードを削除するオプションがあります。このプロセスは24時間以上かかる場合があり、行動は元に戻すことができません。

訪問者レコードを削除すると、そのデータはカスタマーデータハブのすべてのコンポーネントから永久に削除されます。

**訪問者削除**をクリックすると、訪問者レコードを削除するためのリクエストがシステムに記録され、リクエストを記録するトランザクションIDが返されます。削除リクエストは処理のためのキューに入ります。同じ訪問者を再検索してレコードが見つからない場合は、削除プロセスが完了したことを知ることができます。


<blockquote>
訪問者レコードが削除されても、「オーディエンスを離れる」アクションはコネクタでトリガーされません。コネクタのオーディエンスアクションは、ルールが再評価され、訪問者のステータスがオーディエンスに含まれることから除外されるときにのみ実行されます。
</blockquote>



<blockquote>
トランザクションIDは、[訪問者検索API](https://docs.tealium.com/ja/api/v3/visitor-privacy/endpoints/)でリクエストの状態を確認するために使用できます。
</blockquote>


## REST API

**REST API**タブは、[訪問者検索API](https://docs.tealium.com/ja/api/v3/visitor-privacy/endpoints/)へのインターフェースを提供します。API呼び出しは、アプリケーションで同じ機能を実装する方法の例として事前にフォーマットされています。行いたいAPI呼び出しを選択し、リクエストURLのプレースホルダー値を調整します。

各API呼び出しは、**リクエストタイプ**ドロップダウンリストで利用可能です。リクエストタイプを選択して、そのAPI呼び出しの詳細を表示します。

![](https://docs.tealium.com/images/server-side/whiteui-audiencestream-visitorlookuptool-select-rest-api-request-type.png)