連絡先の消去APIタスクの登録
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
xConnect Web APIを使用して、連絡先から不要なデータを削除できます。これを行うには、パージ タスクを登録する必要があります。
タスクを登録するには:
-
次のAPIを使用します。
タスク登録要求が成功すると、ステータス監視に使用されるタスクIDが返されます。
パラメーター
次に、パージ タスクを登録するためにWeb APIに送信できるPOSTパラメータについて説明します。
|
パラメーター |
随意 |
デフォルト |
種類 |
形容 |
|---|---|---|---|---|
|
BatchSize |
はい |
100 |
整数 |
連絡先のデータ抽出バッチサイズ。 BatchSizeシステム・パラメータは、カーソルの読み取りごとにコレクション・データベースから抽出されるデータ量を制御します。 大事な パージ プロセスには小さなバッチ サイズを使用して、システムに過度の負荷をかけないようにし、影響を抑えてタスクをキャンセルできるようにします。タスクのキャンセルは即時のプロセスではなく、進行中のバッチをキャンセルしません。 |
|
DefaultSplitItemCount |
はい |
100 |
整数 |
連絡先データ抽出カーソルの分割カウント。 DefaultSplitItemCountシステムパラメータは、連絡先データ抽出の分割プロセスを制御します。 |
|
ExpiresAfterHours |
はい |
24 |
整数 |
最終状態でのタスクの有効期限。 最終的なタスクの状況は、成功または失敗のいずれかであり、有効期限が切れるとシステムから削除されます。 |
|
CutoffDays |
いいえ |
- |
Null許容整数 |
最後のコンタクト・アクティビティは、指定した日数以上である必要があります。範囲制限は0からint.MaxValueです。 CutoffDaysパラメータは、コンタクトがブランドとやり取りしていない日数を指定します。 データ抽出プロセスでは、このパラメーターを使用して、LastModified値に基づいて連絡先をフィルタリングします。 LastModified日時は、連絡先の最後のインタラクションを反映しています。 |
|
StartPercentile |
はい |
ヌル |
null許容double |
サンプリング範囲の開始値。範囲の制限は0から1です。 パーセンタイル範囲は、抽出するデータのサブセットを指定します。このパラメータを使用して、システムに過度のストレスがかからないように、パージを小さなバッチで実行します。 データ抽出プロセスでは、パーセンタイル範囲とCutOffDaysパラメーターに基づいて連絡先をフィルタリングします。 |
|
EndPercentile |
はい |
ヌル |
null許容double |
終了サンプリング範囲の値。範囲の制限は0から1です。 パーセンタイル範囲は、抽出するデータのサブセットを指定します。このパラメータを使用して、システムに過度のストレスがかからないように、パージを小さなバッチで実行します。 データ抽出プロセスでは、パーセンタイル範囲とCutOffDaysパラメーターに基づいて連絡先をフィルタリングします。 |
|
Conditions |
はい |
"" |
糸 |
条件名のリスト。複数の条件はAND論理演算子で実行されます。 Conditionsパラメータを使用すると、パージする連絡先を識別するために使用するカスタム条件キーを指定できます。カスタム条件はCortex Processing Engineに登録する必要があります。 Conditions IDはカンマで区切ります。 パラメーターの合計長は2019文字未満である必要があります。 条件によるフィルタリングは、データベースレベルではなく、メモリ内で実行されます。接触がすべての条件に合格すると、パージ ツールで接触をパージできます。 |