setConsent
setConsent
コマンドは、データを送信(オプトイン)、データを破棄(オプトアウト)または使用(同意は不明)する必要があ defaultConsent
かどうかを Web SDK に指示します。
Web SDK は、次の標準をサポートしています。
-
Adobe標準: 1.0 と 2.0 の両方の標準がサポートされています。
-
IAB の透明性および同意フレームワーク:この標準を使用すると、実装が正しく設定されている場合、訪問者のリアルタイム顧客プロファイルが同意情報で更新されます。
- XDM 個人プロファイルスキーマには、IAB TCF 2.0 同意フィールドグループが含まれます。
- エクスペリエンスイベントスキーマには、IAB TCF 2.0 同意フィールドグループが含まれています。
- IAB 同意情報をイベント XDM オブジェクトに含めます。 Web SDK は、イベントデータを送信する際に、同意情報を自動的に含めません。
このコマンドを使用すると、Web SDK はユーザーの環境設定を Cookie に書き込みます。 ユーザーが次にブラウザーで web サイトを読み込むときに、SDK はこれらの永続的な環境設定を取得し、イベントをAdobeに送信できるかどうかを判断します。
Adobeでは、Web SDK の同意とは別に、同意ダイアログの環境設定を保存することをお勧めします。 Web SDK には、同意を取得する方法はありません。 ユーザーの環境設定と SDK の同期が確実に保たれるように、ページが読み込まれるたびに setConsent
コマンドを呼び出すことができます。 Web SDK は、同意が変更された場合にのみサーバー呼び出しを行います。
defaultConsent
と setConsent
の併用 using-consent
Web SDK には、2 つの補完的な同意設定コマンドがあります。
defaultConsent
:このコマンドは、Web SDK を使用して、Adobeのお客様の同意環境設定を取得することを目的としています。setConsent
:このコマンドは、サイト訪問者の同意環境設定を取り込むためのものです。
これらの設定を一緒に使用すると、設定された値に応じて、異なるデータ収集および cookie 設定結果になる可能性があります。
同意設定に基づいてデータ収集が発生するタイミングと cookie が設定されるタイミングについて理解するには、次の表を参照してください。
in
in
in
out
in
pending
in
pending
out
pending
out
in
out
out
out
同意設定で許可されている場合、次の Cookie が設定されます。
idMigrationEnabled
が有効な場合に表示されます。 サイトの一部がまだ visitor.js
を使用している場合に Web SDK に移行すると役立ちます。s_ecid=MCMID|<ECID>
という構文に従うキーと値のペアとして保存されます。Web SDK タグ拡張機能を使用した同意の設定
同意の設定は、Adobe Experience Platform Data Collection タグインターフェイスのルール内のアクションとして実行されます。
- Adobe IDの資格情報を使用して experience.adobe.com にログインします。
- データ収集/タグ に移動します。
- 目的のタグプロパティを選択します。
- ルール に移動し、目的のルールを選択します。
- アクション で、既存のアクションを選択するか、アクションを作成します。
- 拡張機能 ドロップダウンフィールドを Adobe Experience Platform Web SDK に設定し、 アクションタイプ を 同意を設定 に設定します。
- 標準 および 一般同意 を含む、右側の目的のフィールドを設定します。
- 「変更を保持」をクリックして、公開ワークフローを実行します。
このアクション内に複数の同意オブジェクトを含めることができます。
Web SDK JavaScript ライブラリを使用して同意を設定
設定済みの Web SDK インスタンスを呼び出す際に、setConsent
コマンドを実行します。 このコマンドには、次のオブジェクトを含めることができます。
consent[]
:consent
オブジェクトの配列。 同意オブジェクトの形式は、選択した標準とバージョンに応じて異なります。 同意標準に応じた、各同意オブジェクトの例については、以下のタブを参照してください。identityMap
:ECID の生成方法と、同意情報が関連付けられている ID を制御するオブジェクト。 Adobeでは、sendEvent
などの他のコマンドの前にsetConsent
を実行する場合、このオブジェクトを含めることをお勧めします。edgeConfigOverrides
: データストリーム設定の上書きを含むオブジェクト。
Adobe 2.0 標準 consent
オブジェクト
Adobe Experience Platformを使用している場合は、プロファイルスキーマにプライバシースキーマフィールドグループを含める必要があります。 Adobe 2.0 標準について詳しくは、Adobe Experience Platformにおけるガバナンス、プライバシー、セキュリティを参照してください。 同意および環境設定 プロファイルフィールドグループの consents
フィールドのスキーマに対応する、以下の値オブジェクト内にデータを追加できます。
-
standard
:選択する同意標準。 Adobe 2.0 標準の場合、このプロパティを"Adobe"
に設定します。 -
version
:同意標準のバージョンを表す文字列。 Adobe 2.0 標準の場合、このプロパティを"2.0"
に設定します。 -
value
:同意値を含むオブジェクト。value.collect.val
:同意値。 これを「ユーザーがオプトインする際に"y"
」および「ユーザーがオプトアウトする際に"n"
」に設定します。value.metadata.time
:ユーザーが同意設定を最後に更新した際のタイムスタンプ。
code language-js |
---|
|
IAB TCF 2.0 標準 consent
オブジェクト
Interactive Advertising Bureau Europe (IAB)の Transparency and Consent Framework (TCF)標準で提供されるユーザー同意環境設定を記録するには、以下に示すように同意文字列を設定します。
この方法で同意が設定されると、リアルタイム顧客プロファイルが同意情報で更新されます。 これを機能させるには、プロファイル XDM スキーマに プロファイルプライバシースキーマフィールドグループを含める必要があります。 イベントを送信する場合、IAB 同意情報をイベント XDM オブジェクトに手動で追加する必要があります。 Web SDK は、イベントに同意情報を自動的に含めません。
イベントで同意情報を送信するには、Profile 対応の XDM ExperienceEvent スキーマに Experience Event Privacy フィールドグループを追加する必要があります。 これを設定する手順については、データセット準備ガイドの ExperienceEvent スキーマの更新に関する節を参照してください。
standard
:選択する同意標準。 IAB TCF 2.0 標準の場合、このプロパティを"IAB TCF"
に設定します。version
:同意標準のバージョンを表す文字列。 IAB TCF 2.0 標準の場合、このプロパティを"2.0"
に設定します。value
:同意値を含む文字列。gdprApplies
:この同意値に GDPR が適用されるかどうかを決定するブール値。 デフォルト値はtrue
です。gdprContainsPersonalData
:このユーザーに関連付けられたイベントデータに個人データが含まれているかどうかを判断するブール値。 デフォルト値はfalse
です。
code language-js |
---|
|
Adobe 1.0 標準 consent
オブジェクト
standard
:選択する同意標準。 Adobe 1.0 標準の場合、このプロパティを"Adobe"
に設定します。version
:同意標準のバージョンを表す文字列。 Adobe 1.0 標準の場合、このプロパティを"1.0"
に設定します。value.general
:同意値。 これを「ユーザーがオプトインする際に"in"
」および「ユーザーがオプトアウトする際に"out"
」に設定します。
code language-js |
---|
|
1 回の要求で複数の規格を送信する multiple-standards
また、Web SDK は、次の例に示すように、リクエストでの複数の同意オブジェクトの送信もサポートしています。
alloy("setConsent", {
consent: [{
standard: "Adobe",
version: "2.0",
value: {
collect: {
val: "y"
},
metadata: {
time: "2021-03-17T15:48:42-07:00"
}
}
}, {
standard: "IAB TCF",
version: "2.0",
value: "CO1Z4yuO1Z4yuAcABBENArCsAP_AAH_AACiQGCNX_T5eb2vj-3Zdt_tkaYwf55y3o-wzhhaIse8NwIeH7BoGP2MwvBX4JiQCGBAkkiKBAQdtHGhcCQABgIhRiTKMYk2MjzNKJLJAilsbe0NYCD9mnsHT3ZCY70--u__7P3fAwQgkwVLwCRIWwgJJs0ohTABCOICpBwCUEIQEClhoACAnYFAR6gAAAIDAACAAAAEEEBAIABAAAkIgAAAEBAKACIBAACAEaAhAARIEAsAJEgCAAVA0JACKIIQBCDgwCjlACAoAAAAA.YAAAAAAAAAAA",
gdprApplies: true
}]
});
同意設定の保持 persistence
setConsent
コマンドを使用して Web SDK にユーザーの環境設定を伝えると、SDK はユーザーの環境設定を Cookie に保持します。 ユーザーが次回ブラウザーで web サイトを読み込むと、Web SDK はこれらの永続化された環境設定を取得し、使用して、イベントをAdobeに送信できるかどうかを決定します。
現在の環境設定で同意ダイアログを表示するには、ユーザーの環境設定を個別に保存する必要があります。 Web SDK からユーザー環境設定を取得する方法はありません。 ユーザーの環境設定と SDK の同期が確実に保たれるように、ページが読み込まれるたびに setConsent
コマンドを呼び出すことができます。 Web SDK は、環境設定が変更された場合にのみ、サーバー呼び出しを行います。
同意の設定中の ID の同期 sync-identities
デフォルトの同意(defaultConsent パラメーターを使用して設定)が pending
または out
に設定されている場合、setConsent
の設定が、最初に送信されて ID を確立するリクエストになる場合があります。 このため、最初のリクエストで ID を同期することが重要な場合があります。 sendEvent
コマンドの場合と同様に、ID マップを setConsent
コマンドに追加できます。 コマンドに ID マップを含める方法の例については、identityMap の使用を参照してください。