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

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

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

NOTE
この Privacy JS Library 通常は、プライバシー関連のページにのみインストールする必要があり、web サイトやドメインのすべてのページにインストールする必要はありません。

関数

この Privacy JS Library には、で ID を管理するためのいくつかの関数が用意されています。 Privacy Service. これらの関数は、ブラウザーに保存されている、特定の訪問者の ID を管理する場合にのみ使用できます。これらを使用して Experience Cloud Central Service 直接

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

関数
説明
retrieveIdentities
一致する ID の配列 (validIds) Privacy Service、および見つからなかった ID の配列 (failedIds) をクリックします。
removeIdentities
一致する(有効な)各 ID をブラウザーから削除します。一致する ID の配列(validIds)を返します。各 ID には、この ID が削除されたかどうかを示す isDeletedClientSide ブール値が含まれます。
retrieveThenRemoveIdentities
一致する ID の配列(validIds)を取得し、ブラウザーからそれらの ID を削除します。この関数は removeIdentities に似ていますが、削除の前に、使用中の Adobe ソリューションでアクセス要求を実行する必要がある場合(削除リクエストに指定する固有の ID を取得する必要がある場合など)に最も適しています。
NOTE
removeIdentitiesretrieveThenRemoveIdentities では、これらをサポートする特定のアドビソリューションのブラウザーから ID が削除されるだけです。例えば、Adobe Audience Manager では、サードパーティの Cookie に保存されている demdex ID は削除されませんが、Adobe Target では ID を保存しているすべての cookie が削除されます。

これら 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 の取得

この例では、次の ID のリストを取得する方法を示します: Experience Cloud.

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);
変数
説明
validIds
正常に取得されたすべての ID を含む JSON オブジェクト。
failedIDs
から取得されなかったすべての ID を含む JSON オブジェクト Privacy Serviceまたは見つからなかった場合、

結果

コードが正常に実行された場合は、取得された 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)…
変数
説明
validIds
正常に取得されたすべての ID を含む JSON オブジェクト。
failedIDs
から取得されなかったすべての ID を含む JSON オブジェクト Privacy Serviceまたは見つからなかった場合、

結果

コードが正常に実行された場合は、取得された 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 オブジェクトのインスタンス化に使用される設定パラメーターを示しています。

すべてのソリューション

パラメーター
説明
key
ユーザーまたはデータ主体を識別する一意の ID。 このプロパティは、独自の内部トラッキング目的で使用することを目的としており、Adobeでは使用されません。

Adobe Analytics

パラメーター
説明
cookieDomainPeriods
cookie の追跡に使用するドメイン内のピリオドの数 ( デフォルトは 2例: .domain.com) をクリックします。 JavaScript Web ビーコンで指定されていない限り、ここで定義しないでください。
dataCenter

Adobeデータ収集データセンター。 これは、JavaScript Web ビーコンで指定されている場合にのみ、含める必要があります。設定可能な値は次のとおりです。

  • d1:サンノゼデータセンター
  • d2:ダラスデータセンター
reportSuite
JavaScript Web ビーコンで指定されたレポートスイート ID( 例: s_code.js または dtm) をクリックします。
trackingServer
非 SSL データ収集ドメイン。 これは、JavaScript Web ビーコンで指定されている場合にのみ、含める必要があります。
trackingServerSecure
SSL データ収集ドメイン。 これは、JavaScript Web ビーコンで指定されている場合にのみ、含める必要があります。
visitorNamespace
訪問者のグループ化に使用する名前空間。 これは、JavaScript Web ビーコンで指定されている場合にのみ、含める必要があります。

Adobe Audience Manager

パラメーター
説明
aamUUIDCookieName
Adobe Audience Manager から返された一意のユーザー ID を含むファーストパーティ Cookie の名前。

Adobe Experience Cloud ID サービス (ECID)

パラメーター
説明
imsOrgID
組織 ID。

Adobe Target

パラメーター
説明
clientCode
Adobe Target システムでクライアントを識別するクライアントコード。
recommendation-more-help
9cbf7061-a312-49f7-aaf8-a10885d53580