バッチファイルの書式設定要件

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

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

Batch APIは、gzip圧縮されたアーカイブファイル (.gz) のアップロードをサポートしています。gzip圧縮されたファイルの最大サイズは50MBです。

gzip圧縮されたファイルのサイズが50MBの制限を超える場合は、元のJSONファイルを50MBのサイズ制限を超えない2つ以上の圧縮されたファイルに再圧縮します。次に、gzip圧縮したファイルを一度に1つずつアップロードします。

gzip圧縮されたファイルには、JSONファイルが1つだけ含まれている必要があります。たとえば、アップロードするデータがimport.jsonにある場合は、JSONファイルをgzip圧縮してimport.json.gzをアップロードする必要があります。

JSONファイル内のJSONレコード

JSONファイルには、各JSONレコードが別々の行にある必要があります。たとえば、ゲストレコードを含むJSONファイルをアップロードする場合、インポートする各ゲストは、JSONファイル内に独自の行を持つ必要があります。注文レコードを含むJSONファイルをアップロードする場合は、インポートする各注文も個別の行にある必要があります。

各JSONレコードは、次の条件を満たす必要があります。

有効なJSON。
縮小され、1行に含まれています。
キャリッジリターンで終了します。
RFC 4627に従ってエンコードされます。

このサンプルJSONファイル (import.json) には、[email protected]と[email protected]の2つのゲストの2つのJSONレコードが含まれています。各レコードのメールアドレスは、メール入力規則に従う必要があります。各レコードは別々の行にあります。各行は有効なJSONですが、JSONファイル全体は有効ではありません。

{"ref":"ace73c06-b361-11ed-afa1-0242ac120002","schema":"guest","mode":"upsert","value":{"guestType":"customer","identifiers":[{"provider":"email","id":"[email protected]"}],"extensions":[{"name":"ext","key":"default","loyaltyNumber":"1234"}]}}
{"ref":"7e1d404e-9fd5-4df5-acfe-3a64848ec594","schema":"guest","mode":"upsert","value":{"guestType":"customer","identifiers":[{"provider":"email","id":"[email protected]"}],"extensions":[{"name":"ext","key":"default","loyaltyNumber":"5678"}]}}

警告

重複レコードが作成されないようにするには、次のガイドラインに従ってください。

ゲストレコード - JSONファイルに一意のゲストレコードを一度だけ含めるようにしてください。JSONファイルに重複するゲストレコードを含めると、Sitecore CDPに重複するゲストが作成されます。
注文レコード - 同様に、Sitecore CDPで重複する注文が作成されないように、JSONファイルに一意の注文レコードを一度だけ含めるようにしてください。
CDP にプロファイルがない同じゲストに複数の注文がある - Sitecore CDPに既存のプロファイルがないゲストに複数の注文をアップロードする場合は、ゲストが重複する可能性があるため、異なるスレッドを使用して並行してアップロードすることは避けてください。

たとえば、JSONファイルに次のゲストレコードが含まれていて、最初と最後のレコードが重複している場合、同一のレコードはマージされず、2つのゲストが作成されます。

{"ref":"ace73c06-b361-11ed-afa1-0242ac120002","schema":"guest","mode":"upsert","value":{"guestType":"customer","identifiers":[{"provider":"email","id":"[email protected]"}],"extensions":[{"name":"ext","key":"default","loyaltyNumber":"1234"}]}}
{"ref":"7e1d404e-9fd5-4df5-acfe-3a64848ec594","schema":"guest","mode":"upsert","value":{"guestType":"customer","identifiers":[{"provider":"email","id":"[email protected]"}],"extensions":[{"name":"ext","key":"default","loyaltyNumber":"5678"}]}}
{"ref":"ace73c06-b361-11ed-afa1-0242ac120002","schema":"guest","mode":"upsert","value":{"guestType":"customer","identifiers":[{"provider":"email","id":"[email protected]"}],"extensions":[{"name":"ext","key":"default","loyaltyNumber":"1234"}]}}

同様に、JSONファイルに同じ注文参照を持つ2つの注文レコードが含まれている場合、システムには2つの注文レコードが生成されます。

各JSONレコードには、次の必須フィールドが含まれている必要があります。

フィールド名	種類	形容
ref	糸バージョン4 UUID	アップロードプロセス中にJSONレコードを識別する一意のID。このIDは、Sitecore CDP内でゲストやレコードを識別するために使用されるのではなく、アップロードプロセスのみに使用されます。
schema	糸次のいずれかである必要があります。 "guest" "order" "migration"	インポートされるvalueフィールドに含まれるレコードの種類。ゲストを移行するときは、"schema" の値としてのみ "migration" を使用します。「ゲスト移行データモデル」を参照してください。
mode	糸次のいずれかである必要があります。 "insert" "upsert" "guest" "delete"	レコードをシステムにインポートする方法を示します。 insert - 既存のエンティティに属するすべてのものを上書きし、新しいエンティティが作成されます upsert - 既存のエンティティは、要求で設定されたフィールドでのみ更新します。エンティティが存在しない場合は、新しいエンティティが作成されます。 guest- フィールドの更新方法に特定の移行ルールを適用します。ゲストを移行するときは、"mode" の値としてのみ "guest" を使用します。「ゲスト移行データモデル」を参照してください。 delete - エンティティを削除します。
value	JSONオブジェクト	Sitecore CDPエンティティが含まれます。

アップロード中に各オブジェクトのすべてのフィールドが存在する必要はありません。ただし、ゲストデータエクステンションの場合は例外で、ゲストデータエクステンションのタイプによっては、すべてのフィールドが必要な場合があります。

ゲストのupsertモードを使用する場合は、Sitecore CDP内のゲストを識別するのに十分なデータと、更新するフィールドのみを含める必要があります。

ゲストにguestモードを使用する場合、更新によってエンティティが有効になる必要があるため、エンティティを有効と見なすために必要なすべてのフィールドを含める必要があります。

メール検証ルール

バッチインポートファイルのJSONレコードの各メールアドレスは、次の検証基準を満たしている必要があります。

メールアドレスの名前とドメインの部分は、別々の正規表現(RegEx)を使用して個別に検証されます。
メールアドレスには、名前とドメインの間に @ 記号を含める必要があります。例えば： [email protected]
名前もドメインも、ピリオド (.) で開始または終了することはできません。たとえば、[email protected]と[email protected]は無効ですが、[email protected]は有効です。
名前とドメインには、文字 (aからz)、数字 (0から9)、および特殊文字 !、#、$、%、&、'、*、+、/、=、?、^、_、'、{、|、}、~、および - を含めることができます。
ドメインは、有効なドメイン名またはIPアドレスである必要があります。たとえば、[email protected]、[email protected]などです。

有効なメールアドレスの例

無効なメールアドレスの例

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

バッチ ファイルの書式設定要件

JSONファイル内のJSONレコード

メール検証ルール

有効なメールアドレスの例

無効なメールアドレスの例

バッチファイルの書式設定要件