アドビのプライバシー JavaScript ライブラリの概要

アドビは、データプロセッサーとして、お客様の許可と指示に従って個人データを処理します。 データ管理者であるお客様は、アドビに処理および保管を委任する個人データを決めます。 Adobe Experience Cloud ソリューションを通じて送信する情報に応じて、Adobeでは、General Data Protection Regulation （GDPR）やCalifornia Consumer Privacy Act （CCPA）などのプライバシー規制に適用される個人情報を保存できます。 Experience Cloud ソリューションによる個人データの収集について詳しくは、Adobe Experience Cloud のプライバシーに関するドキュメントを参照してください。

Adobe Privacy JavaScript Library​を使用すると、データ管理者は、特定のドメインに対してExperience Cloud ソリューションによって生成されたすべてのデータ主体IDの取得を自動化できます。 Adobe Experience Platform Privacy Service が提供する API では、これらの ID を使用して、データサブジェクトに属する個人データへのアクセスリクエストと削除リクエストを作成できます。

関数

Privacy JS Libraryには、Privacy ServiceのIDを管理するための複数の機能が用意されています。 これらの関数は、ブラウザーに保存されている、特定の訪問者の ID を管理する場合にのみ使用できます。 これらは、Experience Cloud Central Serviceに直接情報を送信するために使用することはできません。

次の表に、ライブラリが提供する様々な関数の概要を示します。

これら 3 つの関数はすべて非同期プロセスを表すので、取得した ID はコールバックまたは promise を使用して処理する必要があります。

インストール

Privacy JS Libraryの使用を開始するには、次のいずれかの方法を使用してコンピューターにインストールする必要があります。

また、タグ拡張機能を使用してライブラリをインストールすることもできます。 詳しくは、Adobe Privacy tag extensionの概要を参照してください。

Privacy JS Libraryのインスタンス化

Privacy JS Libraryを使用するすべてのアプリは、新しいAdobePrivacy オブジェクトをインスタンス化する必要があります。これは、特定のAdobe ソリューションに設定する必要があります。 例えば、Adobe Analytics でインスタンス化する場合は、次のようになります。

var adobePrivacy = new AdobePrivacy({
    imsOrgID: "{ORG_ID}",
    reportSuite: "{REPORT_SUITE_ID}",
    trackingServer: "{SERVER_URL}",
    clientCode: "{TARGET_CLIENT_CODE}"
});

様々なアドビソリューションのためにサポートされている全パラメーターのリストについては、付録の、サポートされているアドビソリューションの設定パラメーターに関する節を参照してください。

コードサンプル samples

次のコードサンプルは、タグを使用していない場合に限り、いくつかの一般的なシナリオでPrivacy JS Libraryを使用する方法を示しています。

ID の取得

この例では、Experience CloudからIDのリストを取得する方法を示します。

JavaScript

次のコードは、関数 handleRetrievedIDs を定義します。これは、retrieveIdentities で取得された ID を処理するコールバックまたは promise として使用されます。

function handleRetrievedIDs(ids) {
    const validIDs = ids.validIDs;
    const failedIDs = ids.failedIDs;
}

// If using callbacks:
adobePrivacy.retrieveIdentities(handleRetrievedIDs);

// If using promises:
adobePrivacy.retrieveIdentities().then(handleRetrievedIDs);

結果

コードが正常に実行された場合は、取得された ID のリストが validIDs に表示されます。

{
    "company": "adobe",
    "namespace": "ECID",
    "namespaceId": 4,
    "type": "standard",
    "name": "Experience Cloud ID",
    "description": "This is the ID generated by the Visitor ID Service.",
    "value": "79352169365966186342525781172209986543"
},
{
    "company": "adobe",
    "namespace": "gsurfer_id",
    "namespaceId": 411,
    "type": "standard",
    "value": "WqmIJQAAB669Ciao"
}

ID の削除

この例では、ブラウザーから ID のリストを削除する方法を示しています。

JavaScript

次のコードは、関数 handleRemovedIDs を定義します。これは、ブラウザーから削除された後に、removeIdentities で取得された ID を処理するコールバックまたは promise として使用されます。

function handleRemovedIDs(ids) {
    const validIDs = ids.validIDs;
    const failedIDs = ids.failedIDs;
}

// If using callbacks:
adobePrivacy.removeIdentities(handleRemovedIDs);

// If using promises:
adobePrivacy.removeIdentities().then(handleRemovedIDs)…

結果

コードが正常に実行された場合は、取得された ID のリストが validIDs に表示されます。

{
    "company": "adobe",
    "namespace": "ECID",
    "namespaceId": 4,
    "type": "standard",
    "name": "Experience Cloud ID",
    "description": "This is the ID generated by the Visitor ID Service.",
    "value": "79352169365966186342525781172209986543",
    "isDeletedClientSide": false
},
{
    "company": "adobe",
    "namespace": "AMO",
    "namespaceId": 411,
    "type": "standard",
    "value": "WqmIJQAAB669Ciao",
    "isDeletedClientSide": true
}

次の手順

このドキュメントでは、Privacy JS Libraryの主な機能について説明しました。 ライブラリを使用してIDのリストを取得した後、それらのIDを使用して、Privacy Service APIへのデータアクセス要求とデータ削除要求を作成できます。 詳しくは、Privacy Service API ガイド ​を参照してください。

付録

このセクションには、Privacy JS Libraryを使用するための補足情報が含まれています。

アドビソリューションの設定パラメーター config-params

次のリストは、サポートされているアドビソリューションで受け入れ可能な、AdobePrivacy オブジェクトのインスタンス化に使用される設定パラメーターを示しています。

すべてのソリューション

Adobe Analytics

Adobe Audience Manager

Adobe Visitor ID サービス （ECID）

Adobe Target