顧客の同意に関する基本設定のサポート

ユーザーのプライバシーを尊重するため、SDK に対して特定の目的でユーザー固有のデータを使用することを許可する前に、ユーザーの同意を求めることができます。現在、SDK はユーザーに対し、あらゆる目的に対するオプトインまたはオプトアウトのみを許可していますが、アドビでは、将来的に、特定の目的でより詳細な制御を提供したいと考えています。

ユーザーがすべての目的をオプトインした場合、SDK は次のタスクを実行できます。

アドビのサーバーとの間でデータを送信する。
CookieまたはWebストレージー項目を読み取って書き込みます。

ユーザーがすべての目的をオプトアウトした場合、SDK は次のタスクを実行しません。

同意の設定

デフォルトでは、ユーザーはすべての目的に対してオプトインします。ユーザーがオプトインするまで SDK が上記のタスクを実行しないようにするには、次のように、SDK の設定時に "defaultConsent": "pending" を渡します。

alloy("configure", {
  "edgeConfigId": "ebebf826-a01f-4458-8cec-ef61de241c93",
  "imsOrgId": "ADB3LETTERSANDNUMBERS@AdobeOrg",
  "defaultConsent": "pending"
});

一般的な目的のデフォルトの同意が「保留」に設定されている場合、ユーザーのオプトイン設定に依存するコマンド（sendEvent コマンドなど）を実行しようとすると、そのコマンドは SDK 内のキューに追加されます。これらのコマンドは、ユーザーのオプトイン設定を SDK に通知するまで処理されません。

メモ

コマンドは、メモリ内のキューにのみ格納されます。ページの読み込み時には保存されません。

ユーザーのオプトインの環境設定が設定される前に発生したイベントを収集したくない場合は、SDKの設定中に"defaultConsent": "out"を渡すことができます。ユーザーのオプトイン設定に依存するコマンドを実行しようとしても、ユーザーのオプトイン設定がSDKに伝わるまで、何も起こりません。

メモ

現在、SDKは、1つのオールオアナッシングの目的のみをサポートしています。アドビでは、様々な機能や製品に対応する、さらに堅牢な目的やカテゴリのセットを構築する予定ですが、現在の実装アプリーチでは、すべてをオプトインするか、すべてをオプトインしないかのいずれかです。これは、Adobe Experience PlatformWeb SDKにのみ当てはまり、他のAdobeのJavaScriptライブラリには当てはまりません。

この時点で、ユーザーインターフェイス内のどこかでユーザーにオプトインを求めることをお勧めします。ユーザーの環境設定を収集した後、これらの環境設定を SDK に伝えます。

同意設定の連絡 Adobe Experience Platform標準を経て

SDKは、Adobe Experience Platformの同意規格のバージョン1.0と2.0をサポートしています。現在、1.0および2.0の標準は、すべてまたはすべての同意プリファレンスの自動強制のみをサポートしています。 1.0基準は2.0基準に近い段階で廃止されています。 2.0標準では、追加の同意の環境設定を追加できます。この環境設定は、手動で同意の優先順位を強制するのに使用できます。

Adobe標準バージョン2.0の使用

Adobe Experience Platformを使用している場合は、プロファイルスキーマにプライバシーミックスインが必要です。 Adobe標準バージョン2.0の詳細については、Adobe Experience PlatformのGovernance, privacy, and securityを参照してください。Consents & PreferencesプロファイルMixinのconsentsフィールドのスキーマに対応する値オブジェクト内にデータを追加できます。

ユーザーがオプトインする場合は、次のようにcollect preferenceをyに設定してsetConsentコマンドを実行します。

alloy("setConsent", {
    consent: [{
      standard: "Adobe",
      version: "2.0",
      value: {
        collect: {
          val: "y"
        },
        metadata: {
          time: "2021-03-17T15:48:42-07:00"
        }
      }
    }]
});

時間フィールドには、ユーザーが最後に同意の環境設定を更新した日時を指定する必要があります。ユーザーが選択した場合は、次のようにオプトアウトnに設定したcollect環境設定でsetConsentコマンドを実行します。

alloy("setConsent", {
    consent: [{
      standard: "Adobe",
      version: "2.0",
      value: {
        collect: {
          val: "n"
        },
        metadata: {
          time: "2021-03-17T15:51:30-07:00"
        }
      }
    }]
});

メモ

ユーザーがオプトアウトした後、SDKは、ユーザーがyに対する収集同意を設定することを許可しません。

Adobe標準バージョン1.0の使用

ユーザーがオプトインした場合は、次のように、general オプションを in に設定して setConsent コマンドを実行します。

alloy("setConsent", {
    consent: [{
      standard: "Adobe",
      version: "1.0",
      value: {
        general: "in"
      }
    }]
});

ユーザーがオプトアウトを選択した場合は、次のように、general オプションを out に設定して setConsent コマンドを実行します。

alloy("setConsent", {
    consent: [{
      standard: "Adobe",
      version: "1.0",
      value: {
        general: "out"
      }
    }]
});

メモ

ユーザーがオプトアウトすると、SDK では in に対するユーザーの同意を設定できません。

IAB TCF標準を使用して同意の環境設定を伝える

SDKは、Interactive Advertising Bureau(IAB)Transparency and Consent Framework(TCF)標準を通じて提供されるユーザーの同意の環境設定の記録をサポートしています。同意文字列は、上記と同じsetConsentコマンドを使用して次のように設定できます。

alloy("setConsent", {
    consent: [{
      standard: "IAB TCF",
      version: "2.0",
      value: "CO1Z4yuO1Z4yuAcABBENArCsAP_AAH_AACiQGCNX_T5eb2vj-3Zdt_tkaYwf55y3o-wzhhaIse8NwIeH7BoGP2MwvBX4JiQCGBAkkiKBAQdtHGhcCQABgIhRiTKMYk2MjzNKJLJAilsbe0NYCD9mnsHT3ZCY70--u__7P3fAwQgkwVLwCRIWwgJJs0ohTABCOICpBwCUEIQEClhoACAnYFAR6gAAAIDAACAAAAEEEBAIABAAAkIgAAAEBAKACIBAACAEaAhAARIEAsAJEgCAAVA0JACKIIQBCDgwCjlACAoAAAAA.YAAAAAAAAAAA",
      gdprApplies: true
    }]
});

このように同意が設定されると、リアルタイム顧客プロファイルは同意情報で更新されます。この処理を行うには、プロファイルXDMスキーマにプロファイルプライバシーミックスインを含める必要があります。イベントを送信する場合、IABの同意情報をイベントXDMオブジェクトに手動で追加する必要があります。 SDKは、イベントに同意情報を自動的に含めません。同意情報をイベントに送信するには、エクスペリエンスイベントスキーマにエクスペリエンスイベントプライバシーミックスインを追加する必要があります。

1回のリクエストで複数の標準を送信する

また、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
    }]
});

同意設定の保持

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

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

同意の設定時にIDを同期する

デフォルトの同意が保留または送信されている場合、setConsentは、最初に送信され、IDを確立する要求である可能性があります。このため、最初の要求時にIDを同期することが重要な場合があります。 IDマップは、sendEventコマンドと同様にsetConsentコマンドに追加できます。 Experience CloudIDの取得を参照