ビジター削除ジョブ(早期アクセス)
この記事では、Tealium Customer Data Hubからビジターレコードを削除するための自動化されたビジター削除ジョブの構成方法について説明します。
ビジター削除ジョブ機能は現在早期アクセス中で、現時点では一部のお客様のみが利用可能です。この機能を試してみたい場合は、アカウントマネージャーに早期アクセスについての情報をお問い合わせください。
仕組み
ビジター削除ジョブは、Tealium Customer Data Hubのすべての製品から複数のビジターレコードを削除するための自動化されたプロセスです。ビジター削除ジョブは、アカウントのS3バケット(TealiumのS3バケットまたは自分のS3バケット)にアップロードしたCSVファイルを処理します。これらのCSVファイルには、削除するビジターレコードを指定するビジターIDが含まれています。
ビジター削除ジョブが有効になると、新しいCSVファイルがあるかどうかを毎時S3バケットをチェックします。新しいファイルが見つかると、ジョブはCSVファイルを処理し、各ビジターIDについて、Customer Data Hubの以下のエリアからビジタープロフィールデータを削除します。
- Tealium AudienceStream
- Tealium AudienceStore
- Tealium AudienceDB
- Tealium EventStore
- Tealium EventDB
ビジター削除ジョブインターフェースを使用して、処理された各CSVファイルのステータスと結果を確認することができます。ファイルが処理された後、結果のログファイルをインターフェースからダウンロードして、法的な記録保持とGDPRコンプライアンス監査を行うことができます。
また、ビジタールックアップツールやビジタールックアップAPIを使用してビジターレコードを削除することもできますが、これらの方法では一度に1つのビジターしか削除できません。ビジター削除ジョブを使用すると、一度に複数のビジターを削除することができます。
要件
- 必要な権限: パブリッシャーの役割。
詳細については、サーバーサイドユーザー権限の管理を参照してください。 - CSVファイルをアップロードするためのAmazon S3バケットへのアクセス。
ファイル処理の制限
ファイルのアップロードとファイルの処理には以下の制限があります。
- CSVファイルの最大サイズは10MBです。
- 1時間あたりに処理できる削除データの最大量は1GB(各10MBのCSVファイル100個)です。1GBの最大量を超えると、それらのファイルは後の時間に処理されます。
- リージョンでの需要が高いと、処理時間が遅くなる可能性があります。
ファイル形式
入力ファイル
ビジター削除ジョブは、ヘッダーラインとビジターID値を含むCSV(カンマ区切り値)ファイルを処理します。最初の行は、削除するビジターレコードを識別するために使用されるビジターID属性の名前を指定します。ジョブはこの行を処理するときに無視します。ファイルの他のすべての行には、単一のビジターID属性値が含まれています。
例えば:
"customer_id"
"00003579"
"00035728"
"00000352"
...
ファイルプレフィックス
入力ファイルは以下の形式で名前を付ける必要があります:
{prefix}_{version}.csv
フォーマット | 説明 |
---|---|
prefix |
特定のビジター削除ジョブのための一意の識別子。 |
version |
プレフィックス内のファイルの一意の識別子、通常はタイムスタンプとオプションのバージョン番号。 |
重複するファイル名のファイルがアップロードされると、それは処理されません。
ファイル名は大文字と小文字を区別し、ハイフン ‘-’ とアンダースコア ‘_’ 以外の特殊文字を含むことはできません。
例えば、ジョブがcustomer_id
属性に基づいてビジターデータを削除する場合、CSVファイルのプレフィックスはcustomer_id_deletes
となり、バージョンはmmddyyyy
形式の月、日、年となることができます。
このプレフィックスとバージョンを持つファイル名は以下のようになります:
customer_id_deletes_03152021.csv
customer_id_deletes_03172021.csv
customer_id_deletes_03212021.csv
...
結果ファイル
入力ファイルが処理された後、結果はログファイルとしてダウンロード可能な形で利用できます。結果ファイルの各行には、以下のフィールドを含むビジター削除確認レコードが含まれています:
- ビジターID値(入力ファイルと同じ値)
- 確認UID
- ステータス、以下のいずれか:
- 成功 - ビジタープロフィールが見つかり、削除されました。
- 失敗 - 見つからない - ビジタープロフィールが見つかりませんでした。
- 失敗 - エラー - ビジタープロフィールは削除されませんでした。削除が失敗した理由についての詳細を含みます。
- タイムスタンプ、ステータス = 成功の場合、ビジターが削除された日時。
ビジター削除ジョブの管理
ビジター削除ジョブの追加
ビジター削除ジョブを追加する前に、まず削除するビジターレコードを識別するためにどのビジターID属性を使用するかを決定します。
ビジター削除ジョブを作成するには:
- Server-Side Tools > Visitor Deletion Jobsに移動し、+ Add Visitor Deletion Jobをクリックします。
- ジョブの名前を入力します。
- リストからFile Serviceを選択します。
- このジョブのファイル名のプレフィックスを入力します。
このジョブのすべてのCSVファイルはこのプレフィックスで始まる必要があります。 - CSVファイルで使用されるVisitor ID Attributeを選択します。
- ビジター削除の処理を開始する準備ができている場合は、Enable/Disable Visitor Deletion JobをONに切り替えます。
- Saveをクリックします。
ビジター削除ジョブを追加した後、CSVファイルを作成し、ジョブのAmazon S3バケットにアップロードすることでビジターデータを削除することができます。
CSVファイルのアップロードについての詳細は、ファイルサービスにファイルをアップロードするを参照してください。
ビジター削除ジョブの編集
ビジター削除ジョブを変更するには:
- Visitor Deletion Jobsリストでジョブを選択します。
Job Summaryが表示され、S3バケット内の各ファイルについて以下の情報が表示されます:- Date - ジョブが実行された日付。
- File Name - 処理された入力ファイルの名前。
- Status - ステータスは以下のいずれかになります:
- Processing - CSVファイルが処理中です。削除が処理されている間、ジョブは最大6日間
In Progress
のステータスを持つことができます。大きなファイルはより長い処理時間を必要とします。 - Completed - CSVファイルが処理され、結果がダウンロード可能です。
- Failed - CSVファイルの処理中にエラーが発生しました。ジョブは、AWSサービスの問題やデータソースの権限不足など、さまざまな理由で失敗することがあります。
- Processing - CSVファイルが処理中です。削除が処理されている間、ジョブは最大6日間
- Job ID - このファイルと処理結果の一意のID。
- Rows - 入力ファイルの行数。
- Success - 成功した削除の数。
- Errors - エラーと失敗した削除の数。結果ファイルは削除エラーについての詳細情報を提供します。
- Editをクリックします。
- 編集が完了したら、Saveをクリックします。
ビジター削除ジョブの有効化
定期的に(毎日または毎週)CSV削除ファイルをアップロードする予定の場合は、ジョブを有効にしておくことができます。ファイルをそれほど頻繁にアップロードしない場合は、不必要にジョブがCSVファイルをチェックするのを避けるために、ジョブを無効にすることを検討してみてください。
ビジター削除ジョブを有効にするには:
- Visitor Deletion Jobsリストでジョブを選択します。
- OffをOnに切り替えます。
- 確認ダイアログでEnableをクリックします。
ビジター削除ジョブの削除
ジョブとその処理済みファイルの履歴を削除すると、それは永久的なものとなります。この操作は元に戻すことはできません。
ビジター削除ジョブを削除するには:
- Visitor Deletion Jobsリストでジョブを選択します。
- Summary画面でDeleteをクリックします。
- 確認ダイアログでDeleteをクリックします。
ビジター削除ジョブの結果の表示
処理済みファイルの結果を表示するには:
- Visitor Deletion Jobsリストでジョブを選択します。
- ビジター削除ジョブを選択します。
SummaryページのFilesセクションには、処理済みファイルのリストが表示され、ファイルのステータスが含まれています。 - 処理済みファイルを探し、Downloadをクリックします。
最終更新日 :: 2024年March月29日