1. xConnect Data ToolsのWeb API

連絡先データエクスポートタスクを登録する

Version:
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

xConnect Web APIを使って連絡先データをエクスポートできます。これを行うには、データエクスポートタスクを登録する必要があります。

連絡先データエクスポートタスクの登録方法:

  • 以下のAPIをご利用ください:

    /sitecore/api/datatools/export/tasks/contacts

    タスク登録リクエストが成功すると、ステータス監視に使用されるタスクIDが返されます。例えば:

    {     "TaskId": "049cd8b3-b120-4949-a42f-cdc2fe4f3086" }

パラメータ

以下は、データエクスポートタスクを登録するためにWeb APIに送信できるPOSTパラメータについて説明します。

パラメータ

オプション

デフォルト値

種類

概要

BatchSize

はい

100

整数

接点のデータ抽出バッチサイズ

BatchSizeシステムパラメータは、各カーソル読み取りごとにコレクションデータベースから抽出されるデータ量を制御します。

DefaultSplitItemCount

はい

100

整数

接触データ抽出カーソル分割カウント。

DefaultSplitItemCountシステムパラメータは、接触データ抽出の分割プロセスを制御します。

ExpiresAfterHours

はい

24

整数

最終的な状態での課題の期限切れ。

最終タスクの状態は成功または失敗となり、期限切れ後にシステムから削除されます。

StorageProfile

いいえ

-

ストリング

ネットワークフォルダの位置やストレージアカウントの接続文字列など、あらかじめ定義されたストレージプロバイダー設定を持つプロファイルの名前。ストレージプロファイルはCortex処理エンジンに登録しなければならず、Sitecoreタスクが登録されず、 ModelValidationException エラーが発生します。

CutoffDays

はい

ヌル

無効化可能

整数

最後の接触活動は指定された日数以上でなければなりません。範囲制限は0の int.MaxValueです。

CutoffDaysパラメータは、その接触がブランドと接触しない日数を指定します。

データ抽出プロセスでは、このパラメータを用いて LastModified 値に基づいて接点をフィルタリングします。 LastModified の日付時刻は、接点の最後の相互作用を反映しています。

StartPercentile

はい

ヌル

ヌル可能な二重

開始サンプリングの範囲値。範囲制限は0から1です。

パーセンタイルの範囲は抽出すべきデータの部分セットを指定します。このパラメータを使って少量のバッチでパージを行い、システムに過度な負荷をかけないようにしてください。

データ抽出プロセスは、パーセンタイル範囲と CutOffDays パラメータに基づいて接点をフィルタリングします。

EndPercentile

はい

ヌル

ヌル可能な二重

終端サンプリングの範囲値。範囲制限は0から1です。

パーセンタイルの範囲は抽出すべきデータの部分セットを指定します。このパラメータを使って少量のバッチでパージを行い、システムに過度な負荷をかけないようにしてください。

データ抽出プロセスは、パーセンタイル範囲と CutOffDays パラメータに基づいて接点をフィルタリングします。

この記事を改善するための提案がある場合は、 お知らせください!