Show Menu
トピック×

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

Adobeは、データ処理装置として、会社の権限および指示に従って個人データを処理します。 データ管理者であるお客様は、アドビに処理および保管を委任する個人データを決めます。Adobe Experience Cloudソリューションで送信する情報に応じて、アドビは、General Data Protection Regulation(GDPR)やCalifornia Consumer Privacy Act(CCPA)などのプライバシー規制に適用される個人情報を保存できます。 Experience Cloudソリューションがプライベートデータを収集する方法について詳しくは、Adobe Experience Cloud のプライバシーに関するドキュメントを参照してください
データコントローラーは、 AdobeプライバシーJavaScriptライブラリ (JavaScriptライブラリ)を使用して、特定のドメイン用にExperience Cloudソリューションで生成されたすべてのデータ件名IDの取得を自動化できます。 これらのIDは、 Adobe Experience Platformプライバシーサービスが提供するAPIを使用して 、データサブジェクトに属するプライベートデータに対するアクセス要求や削除要求を作成できます。
プライバシーJSライブラリは、通常、プライバシー関連のページにのみインストールする必要があり、Webサイトやドメインのすべてのページにインストールする必要はありません。

関数

プライバシーJSライブラリは、プライバシーサービスでIDを管理するための機能をいくつか提供します。 これらの関数は、特定の訪問者用にブラウザーに保存されているIDの管理にのみ使用できます。 Experience Cloud Central Serviceに直接情報を送信する場合は使用できません。
次の表に、ライブラリが提供する様々な機能の概要を示します。
関数
説明
retrieveIdentities
プライバシーサービスから取得された一致するID( validIds )の配列と、見つからなかったIDの配列( failedIds )を返します。
removeIdentities
一致する(有効な)各IDをブラウザーから削除します。 一致するID( validIds )の配列を返します。各IDには、このIDが削除されたかどうかを示す isDeleteClientSide ブール値が含まれます。
retrieveThenRemoveIdentities
一致するIDの配列( validIds )を取得し、ブラウザーからそれらのIDを削除します。 この関数はと似ていますが removeIdentities 、削除が可能な場合(削除要求で提供する前に一意の識別子を取得する必要がある場合など)に、使用するAdobeソリューションでアクセス要求が必要な場合に使用するのが最適です。
removeIdentities また、IDをサポートする特定のアドビソリューションのIDのみをブラウザーから削除し retrieveThenRemoveIdentities ます。 例えば、Adobeオーディエンスマネージャーでは、サードパーティcookieに保存されているdemdex IDは削除されませんが、Adobeターゲットでは、IDが保存されているすべてのcookieを削除します。
3つの関数はすべて非同期プロセスを表すので、取得したIDはすべてコールバックまたは約束を使用して処理する必要があります。

設置

プライバシーJSライブラリを使用して開始を行うには、次のいずれかの方法を使用して、JSライブラリをマシンにインストールする必要があります。
  • 次のコマンドを実行して、npmを使用してインストールします。 npm install @adobe/adobe-privacy
  • 名前の下にAdobe Launch Extensionを使用 AdobePrivacy
  • https://github.com/Adobe-Marketing-Cloud/adobe-privacyからダウンロ ード

プライバシーJSライブラリのインスタンス化

プライバシーJSライブラリを利用するすべてのアプリでは、新しい AdobePrivacy オブジェクトをインスタンス化する必要があります。このオブジェクトは、特定のアドビソリューションに設定する必要があります。 例えば、Adobe Analyticsのインスタンス化は次のようになります。
var adobePrivacy = new AdobePrivacy({
    imsOrgID: "{IMS_ORG}",
    key: "{DATA_SUBJECT_ID}",
    reportSuite: "{REPORT_SUITE_ID}",
    trackingServer: "{SERVER_URL}",
    clientCode: "{TARGET_CLIENT_CODE}"
});

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

コードサンプル

LaunchまたはDTMを使用しない場合を除き、次のコードサンプルで、いくつかの一般的なシナリオでプライバシーJSライブラリを使用する方法を示します。

Retrieve identities

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

JavaScript

次のコードは、によって取得されたIDを処理するコールバック handleRetrievedIDs として使用する関数、またはを定義 retrieveIdentities します。
function handleRetrievedIDs(ids) {
    const validIDs = ids.validIDs;
    const failedIDs = ids.failedIDs;
}

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

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

変数
説明
validIds
正常に取得されたすべてのIDを含むJSONオブジェクト。
failedIDs
プライバシーサービスから取得されなかった、または見つからなかったIDをすべて含むJSONオブジェクト。

結果

コードが正常に実行されると、取得した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"
}

Remove identities

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

JavaScript

次のコードは、がブラウザーから削除さ handleRemovedIDs れた後に取得したIDを処理するコールバックとして使用する関数、または約束する関数 removeIdentities を定義します。
function handleRemovedIDs(ids) {
    const validIDs = ids.validIDs;
    const failedIDs = ids.failedIDs;
}

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

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

変数
説明
validIds
正常に取得されたすべてのIDを含むJSONオブジェクト。
failedIDs
プライバシーサービスから取得されなかった、または見つからなかったIDをすべて含むJSONオブジェクト。

結果

コードが正常に実行されると、取得した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
}

次の手順

このドキュメントを読むと、プライバシーJSライブラリのコア機能が紹介されます。 ライブラリを使用してIDのリストを取得した後、これらのIDを使用してPrivacy Service APIへのデータアクセスおよび削除要求を作成できます。 詳しくは、「 プライバシーサービス開発者ガイド 」を参照してください。

付録

この節では、プライバシーJSライブラリの使用に関する補足情報を説明します。

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

Adobe Analytics
パラメーター
説明
cookieDomainPeriods
cookieトラッキング用のドメイン内のピリオド数(デフォルトは2)。
dataCenter
アドビのデータ収集データセンター。 これは、JavaScript Webビーコンで指定されている場合にのみ含める必要があります。 有効な値は次のとおりです。
  • "d1": サンノゼデータセンター。
  • "d2": ダラスデータセンター。
reportSuite
JavaScript Webビーコンで指定されたレポートスイートID(「s_code.js」や「dtm」など)
trackingServer
データ収集ドメイン(SSL以外)。 これは、JavaScript Webビーコンで指定されている場合にのみ含める必要があります。
trackingServerSecure
データ収集ドメイン(SSL)。 これは、JavaScript Webビーコンで指定されている場合にのみ含める必要があります。
visitorNamespace
訪問者のグループ化に使用する名前空間。 これは、JavaScript Webビーコンで指定されている場合にのみ含める必要があります。
Adobe Target
パラメーター
説明
clientCode
Adobeターゲットシステムでクライアントを識別するクライアントコード。
Adobe Audience Manager
パラメーター
説明
aamUUIDCookieName
Adobe User Managerから返される一意のオーディエンスIDを含むファーストパーティCookieの名前。
Adobe IDサービス(ECID)
パラメーター
説明
imsOrgID
IMS組織ID。