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

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

AdobeプライバシーJavaScript ライブラリを使用すると データ管理者は、特定のドメインの 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 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 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 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 ServiceAPI ガイドを参照してください。

付録

この節では、Privacy JS Library の使用に関する補足情報を提供します。

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

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

すべてのソリューション

Adobe Analytics

Adobe Audience Manager

Adobe Experience Cloud ID サービス （ECID）

Adobe Target