顧客の同意設定のサポート

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

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

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

同意の設定

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

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

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

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

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

Adobe Experience Platform Standard を使用した同意設定の伝達

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 Experience Platformのガバナンス、プライバシー、セキュリティ を参照してください。Adobestandard バージョン 2.0 の詳細データを値オブジェクト内の、のスキーマに対応する以下の値オブジェクト内に追加できます。 consents フィールドの 同意および環境設定 プロファイルフィールドグループを使用します。

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

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

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

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

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"
      }
    }]
});

IAB TCF 標準を使用した同意設定の伝達

SDK は、Interactive Advertising Bureau Europe(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 は、1 回のリクエストでの複数の同意オブジェクトの送信もサポートしています。

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 マップは、 setConsent ～と同じように命令する sendEvent コマンドを使用します。 詳しくは、 Experience CloudID を取得中