プロファイルインポート
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
!重要機能の利用可能性は段階的に展開される一環です。あなたの組織はまだこの機能に気づいていないかもしれません。環境が導入された際に利用可能になります。
プロファイルインポートでは、すべてのレコードを含むJSONライン(JSONL)ファイルをアップロードしてSitecoreAIに プロファイル データを追加できます。このドキュメントでは、そのようなファイルを バッチファイルと呼んでいます。
必要に応じてプロファイルインポートを使います:
- Migrate data 外部CRMや顧客データプラットフォームからSitecoreAIへと移行します。
- パートナーやサードパーティシステムからの新しいデータをオンボードすること。
- Bulk update 新しい連絡先情報やカスタム属性を付けた既存のプロフィール。
- Synchronize data 定期的に外部の真実の情報源から。
仕組み
APIや プロファイルインポート ページを使ってデータをインポート・監視できます。本番環境では「 アップロードバッチ 」ボタンは利用できません。バッチファイルはAPIを通じてしかアップロードできません。
ユーザーが追加バッチを提出する前に処理エラーを特定し解決できるようにするため、一度に処理できるバッチは1つだけです。これにより、ユーザーが多くのファイルをアップロードし、根本原因を特定する前に何度も失敗するのを防ぎます。
プロファイルインポートは以下の方法でデータをインポートします:
- Upload - JSONLファイルをプロファイルインポートAPIにアップロードするか、非本番環境ではSitecoreAI UIを通じてアップロードします。APIはファイルを検証し、バッチを追跡するために使う batchId を返します。バッチは QUEUED 状態に入ります。
- Processing - システムがキューに待たれたバッチを取得し、ファイル内の各レコードを処理する。処理中、バッチは RUNNING 状態にあります。各レコードは アイデンティティ解決 を経て、新しいプロファイルを作成するか既存のプロファイルを更新するかを判断します。
- Completion - 処理が完了するとバッチは最終状態に移行します。すべてのレコードが成功した場合は COMPLETED 、 COMPLETED_WITH_ERRORS 一部のレコードが失敗した場合、またはシステムエラーに遭遇した場合は FAILED となります。
- Results - プロファイルインポート ページで結果を閲覧するか、各レコードの結果ファイルをダウンロードします。成功したレコードにはプロファイルID、失敗レコードにはエラーコードが含まれます。
対応データ
プロファイルインポートは現在、以下のレコードタイプをサポートしています:
- Profiles - /v1/batches エンドポイントを通じてプロファイルを作成または更新すること。各レコードは既存プロフィールと照合したり、新しいプロファイルを作成したりするためにアイデンティティ解決を経ます。
プロファイルインポートページ
!注セキュリティ上の理由から、アップロード バッチボタンは非本番環境でのみ利用可能です。本番環境のインポートには認証済みAPIアクセスが必要です。
Profileインポートページはインポートの状況と履歴を示し、Profile Import APIの認証情報を管理できます。本番環境でない環境では、ページから直接バッチファイルをアップロードすることも可能です。
SitecoreAIのプロファイルインポートページにアクセスするには、プロファイルインポート>パフォーマンス>設定へ行ってください。
制限
- File size - バッチファイルあたり最大100MB。
- Concurrent batches - 環境ごとに一度に1バッチしか、 QUEUED または RUNNING の状態に存在できません。次の投稿は現在のバッチが完了するまで待つ必要があります。
- File format - 入力ファイルはUTF-8エンコードされたJSONライン(JSONL)形式で、1行あたり1つのJSONオブジェクトでなければなりません。
- Retry attempts - システムエラーによりバッチ全体が処理されない場合、システムは自動的に最大3回までバッチを再試行します。3回の失敗後、そのロットは永久 FAILEDマークされます。個別の記録失敗は再試行されません。
- Writable fields - プロファイルレコードの場合、 contact フィールドと extensions フィールドのみがプロファイルに書き込まれます。その他のフィールドはレコードの検証、プロファイルの照合、識別子の更新に使用されます。
- 本番環境では、Profileインポートページを使ってバッチファイルをアップロード できません。非本番環境では、 Profileインポートページ や Profile Import APIを通じてバッチファイルをアップロードできます。セキュリティ上の理由から、 アップロード バッチボタンは本番環境では利用できないため、APIを使用する必要があります。