[PaaS のみ]{class="badge informative" title="Adobe Commerce on Cloud プロジェクト（Adobeが管理する PaaS インフラストラクチャ）およびオンプレミスプロジェクトにのみ適用されます。"}

Privacy JavaScript Library

Privacy JavaScript Libraryは、Adobe Commerceによって収集されたプライベートデータにアクセスして削除するためのプロセスを構築するのに役立つ一連のツールです。

Commerce データトラッキングサービスは、一般データ保護規則（GDPR） ​および​ カリフォルニア州消費者プライバシー法（CCPA） ​などのプライバシー規制に適用される個人情報を保存できます。

このライブラリは、プライバシーデータリクエストを作成し、その応答を収集するための一連の機能を提供します。 このライブラリを使用すると、Adobe Commerce データトラッキングサービスによってブラウザーに保存されているデータを取得および削除できます。

インストール

Privacy JavaScript ライブラリは、次のCDNの場所で利用できます：commerce.adobe.net/magentoprivacy.js

ファイルを用意したら、Adobe Commerce インスタンスにインストールされているカスタムモジュールまたはテーマにファイルを追加する必要があります。 「​ カスタム JavaScriptを使用」のトピックに記載されている手順に従って、このタスクを実行します。

初期化

新しいMagentoPrivacy オブジェクトを読み込んでインスタンス化するか、window オブジェクトを使用してPrivacy JavaScript関数にアクセスします。

importを使用する例：

import MagentoPrivacy from "./MagentoPrivacy"

const magePriv = new MagentoPrivacy()

windowを使用する例：

const magePriv = new window.MagentoPrivacy()

使用状況

プライバシーJS ライブラリには、ブラウザーに保存されているID データを管理するための様々な機能が用意されています。

retrieveIdentity()
：ブラウザーのサービスからID オブジェクトのJavaScript Promiseを返します。

magePriv.retrieveIdentity().then((ids)=>console.log(ids))
// {"value":"1ccfd8c2-5159-433c-98d7-e937ce3b13f3"}

removeIdentity()
：ブラウザーのサービスからID データを削除します。
この関数は、データが削除されたかどうかを示すisDeleted ブール値プロパティを持つID オブジェクトに対するJavaScript Promiseを返します。

magePriv.removeIdentity().then((ids)=>console.log(ids))
// {"value":"1ccfd8c2-5159-433c-98d7-e937ce3b13f3","isDeleted":true}