setConsent

setConsent コマンドは、データを送信(オプトイン)、データを破棄(オプトアウト)または使用(同意は不明)する必要があ defaultConsent かどうかを Web SDK に指示します。

Web SDK は、次の標準をサポートしています。

このコマンドを使用すると、Web SDK はユーザーの環境設定を Cookie に書き込みます。 ユーザーが次にブラウザーで web サイトを読み込むときに、SDK はこれらの永続的な環境設定を取得し、イベントをAdobeに送信できるかどうかを判断します。

Adobeでは、Web SDK の同意とは別に、同意ダイアログの環境設定を保存することをお勧めします。 Web SDK には、同意を取得する方法はありません。 ユーザーの環境設定と SDK の同期が確実に保たれるように、ページが読み込まれるたびに setConsent コマンドを呼び出すことができます。 Web SDK は、同意が変更された場合にのみサーバー呼び出しを行います。

Web SDK には、2 つの補完的な同意設定コマンドがあります。

  • defaultConsent:このコマンドは、Web SDK を使用して、Adobeのお客様の同意環境設定を取得することを目的としています。
  • setConsent:このコマンドは、サイト訪問者の同意環境設定を取り込むためのものです。

これらの設定を一緒に使用すると、設定された値に応じて、異なるデータ収集および cookie 設定結果になる可能性があります。

同意設定に基づいてデータ収集が発生するタイミングと cookie が設定されるタイミングについて理解するには、次の表を参照してください。

defaultConsent
setConsent
データ収集が発生
Web SDK はブラウザー cookie を設定します
in
in
in
out
×
in
設定なし
pending
in
pending
out
×
pending
設定なし
×
×
out
in
out
out
×
out
設定なし
×
×

同意設定で許可されている場合、次の Cookie が設定されます。

名前
最大経過年数
説明
AMCV_###@AdobeOrg
34128000 (395 日)
idMigrationEnabled が有効な場合に表示されます。 サイトの一部がまだ visitor.js を使用している場合に Web SDK に移行すると役立ちます。
Demdex cookie
15552000 (180 日間)
ID 同期が有効な場合に存在します。 Audience Managerは、この cookie を設定して、サイト訪問者に一意の ID を割り当てます。 demdex cookie は、Audience Manager が訪問者識別、ID 同期、セグメント化、モデリング、レポートなどの基本的な機能を実行するのに役立ちます。
kndctr_orgid_cluster
1800 (30 分)
現在のユーザーのリクエストに対応するEdge Networkリージョンを格納します。 Edge Networkがリクエストを正しいリージョンにルーティングできるように、リージョンは URL パスで使用されます。 ユーザーが別の IP アドレスで接続する場合や、別のセッションで接続する場合は、リクエストは再び最も近いリージョンにルーティングされます。
kndct_orgid_identity
34128000 (395 日)
ECID と、ECID に関連するその他の情報を保存します。
kndctr_orgid_consent
15552000 (180 日間)
Web サイトのユーザー同意設定を格納します。
s_ecid
63115200 (2 年)
Experience CloudID (ECID)または MID のコピーが含まれます。 MID は、s_ecid=MCMID|<ECID> という構文に従うキーと値のペアとして保存されます。

Web SDK タグ拡張機能を使用した同意の設定

同意の設定は、Adobe Experience Platform Data Collection タグインターフェイスのルール内のアクションとして実行されます。

  1. Adobe IDの資格情報を使用して experience.adobe.com にログインします。
  2. データ収集/タグ に移動します。
  3. 目的のタグプロパティを選択します。
  4. ルール に移動し、目的のルールを選択します。
  5. ​ アクション ​ で、既存のアクションを選択するか、アクションを作成します。
  6. ​ 拡張機能 ​ ドロップダウンフィールドを Adobe Experience Platform Web SDK に設定し、​ アクションタイプ ​ を 同意を設定 に設定します。
  7. 標準 および 一般同意 を含む、右側の目的のフィールドを設定します。
  8. 変更を保持」をクリックして、公開ワークフローを実行します。

このアクション内に複数の同意オブジェクトを含めることができます。

Web SDK JavaScript ライブラリを使用して同意を設定

設定済みの Web SDK インスタンスを呼び出す際に、setConsent コマンドを実行します。 このコマンドには、次のオブジェクトを含めることができます。

  • consent[]: consent オブジェクトの配列。 同意オブジェクトの形式は、選択した標準とバージョンに応じて異なります。 同意標準に応じた、各同意オブジェクトの例については、以下のタブを参照してください。
  • identityMap:ECID の生成方法と、同意情報が関連付けられている ID を制御するオブジェクト。 Adobeでは、sendEvent などの他のコマンドの前に setConsent を実行する場合、このオブジェクトを含めることをお勧めします。
  • edgeConfigOverrides: データストリーム設定の上書きを含むオブジェクト。
Adobe 2.0

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
// Set consent using the Adobe 2.0 standard
alloy("setConsent", {
  "consent": [{
    "standard": "Adobe",
    "version": "2.0",
    "value": {
      "collect": {
        "val": "y"
      },
      "metadata": {
        "time": "YYYY-03-17T15:48:42-07:00"
      }
    }
  }]
});
IAB TCF 2.0

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
// Set consent using the IAB TCF 2.0 standard
alloy("setConsent", {
  consent: [{
    "standard": "IAB TCF",
    "version": "2.0",
    "value": "CO052l-O052l-DGAMBFRACBgAIBAAAAABIYgEawAQEagAAAA",
    "gdprApplies": true,
    "gdprContainsPersonalData": true
  }]
});
Adobe 1.0
  • standard:選択する同意標準。 Adobe 1.0 標準の場合、このプロパティを "Adobe" に設定します。
  • version:同意標準のバージョンを表す文字列。 Adobe 1.0 標準の場合、このプロパティを "1.0" に設定します。
  • value.general:同意値。 これを「ユーザーがオプトインする際に "in"」および「ユーザーがオプトアウトする際に "out"」に設定します。
code language-js
// Set consent using the Adobe 1.0 standard
alloy("setConsent", {
  "consent": [{
    "standard": "Adobe",
    "version": "1.0",
    "value": {
      "general": "in"
    }
  }]
});

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 の使用を参照してください。

recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636