ゲスト削除データモデル

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

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

ゲストの識別方法は組織によって異なります。一部の組織では、providerやidなど、identifiersのみを使用してIDを特定します。他の組織では、ゲストを識別するためにのみゲスト属性(firstName、lastName、emailなど)を使用します。これらの組織のうち、IDを実行するために必要なゲスト属性の数はオプションですが、一致する可能性のあるゲストレコードを識別するのに十分なゲスト属性を指定する必要があります。たとえば、firstNameとlastNameでは、削除対象のゲストレコードに一致するのに十分な識別情報が提供されていません。

使用可能なモードには、deleteとgdpr_deleteの2つがあります。ゲストには忘れられる権利があり、ゲストを削除する場合は、GDPRコンプライアンスを満たすためにgdpr_deleteモードを使用する必要があります。

バッチ・ファイルを作成するときは、フォーマット要件に従い、次の表の属性を含めてください。

属性	形容	種類	使用例	必須/オプション
ref	組織がSitecore CDPの外部で識別するために生成するレコードの一意のID。	文字列UUID	"17AC5C03-F7A1-461F-A3B1-C96F43143522"	必須
schema	削除されるvalueフィールドに含まれるレコードの種類。	糸	"guest"	必須
mode	レコードを削除するために使用する必要があるメカニズムまたはメカニズムを示します。	糸	"delete", "gdpr_delete"	必須
value	識別子のコンテナ、またはゲストの削除に必要なID値。	コンテナ	該当なし	必須
identifiers	削除の可能性についてゲストを照合するために使用されるID属性のコンテナ。	コンテナ	該当なし	組織で識別子を使用してIDを実行する場合に必要です。
email	ゲストのメールアドレス。	string (小文字を推奨)	"[email protected]"	組織がemail属性を使用してIDを実行する場合に必要です。
firstName	ゲストの名。	string (タイトルケース)	"John"	組織がfirstName属性を使用してIDを実行する場合に必要です。
lastName	ゲストの姓。	string (推奨タイトルケース)	"Doe"	組織でゲストを識別するためにlastName属性を使用している場合は必須です。
provider	識別子のプロバイダー。	糸	"IDENTITY_SYSTEM"	組織で識別子を使用してIDを実行する場合に必要です。
id	識別子の一意のID。	糸	"BX_201504"	組織が識別子を使用してゲストを識別する場合は必須です。

次に、identifiersを使用してゲストを識別するJSON例を示します。

{
  "ref": "17AC5C03-F7A1-461F-A3B1-C96F43143522",
  "schema": "guest",
  "mode": "delete",
  "value": {
    "identifiers": [
      {
        "provider": "IDENTITY_SYSTEM",
        "id": "BX_201504"
      }
    ]
  }
}

以下は、個人を特定できる識別子(PII)を使用してゲストを識別するJSONの例です。

{  
   "ref":"17AC5C03-F7A1-461F-A3B1-C96F43143522",
   "schema":"guest",
   "mode":"delete",
   "value":{  
      "email":"[email protected]",
      "firstName":"John",
      "lastName":"Doe"
   }
}

応答の例

以下は、一致するゲストが1つ見つかった場合の応答です。

{"ref":"<UUID>","code":"200","message":"Guest and associated entities deleted"}

以下は、一致するゲストが複数見つかったレスポンスです。

{"ref":"<UUID>","code":"200","message":"3 matches found for this guest, 1st match deleted"}

以下は、一致するゲストが見つからなかった場合の応答です。

{"ref":"<UUID>","code":"404","message":"Guest not found"}

次に、一致するゲストを見つけるのに十分なID情報が提供されなかった場合の応答を示します。

{"ref":"<UUID>","code":"400","message":"Not enough identifying information"}

以下は、ゲストが現在オンラインであったためにゲストを削除できなかった場合の応答です。

{"ref":"<UUID>","code":"403","message":"Unable to delete Guest: Guest has an open session"}

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

ゲスト削除データ モデル

応答の例

ゲスト削除データモデル