Show Menu
TOPICS×

オプトインサービスの設定

Experience Cloud ソリューション(オプトインでは「カテゴリー」と呼ばれます)で使用される単一の参照ポイントとしてオプトインサービスを実装し、訪問者のデバイスに Cookie を作成するかどうかを決定します。
オプトインサービスは、Experience Cloud ID(ECID)にバンドルされた JavaScript ライブラリであり、Visitor JS のグローバルな
adobe
オブジェクトに
adobe.optIn
オブジェクトとして存在します。インストールされたオプトインサービスを使用すると、訪問者が複数のアドビソリューションのオプトインを一度に実行するか、それぞれの権限に合わせてソリューションを順番に表示するかを指定できます。オプトインサービスの同意管理機能を使用すると、固有のプライバシー要件に応じたさまざまな設定での実装が可能になります。
オプトインサービスを使用すると、訪問者が複数のアドビソリューションのオプトインを一度に実行するか、それぞれの権限に合わせてソリューションを順番に表示するかを指定できます。承認プロセスが完了し、顧客によって記録されると、CMP の訪問者の承認は、関連する同意の要求に対応するためにすべてのアドビソリューションで取得できます。

前提条件

  1. ECID バージョン 4.0。
    最新の ECID リリースを ダウンロード してください。
  2. サポートしているライブラリ:
    • ECID 4.0 以降
    • AppMeasurement 2.11 以降
    • DIL 9.0
    • AT.js バージョン 1.7.0
    • AT.js Launch 拡張のバージョン 9.0
    • (Analytics の場合)拡張 1.6 を含む AppMeasurement 2.11
    • (Target の場合)拡張 0.9.1
  3. オプトインで使用する同意管理フレームワークを熟知し、その他の前提条件を把握します。
  4. 会社のプライバシー要件は、GDPR に準拠し続けるために選んだ方法に対して特異的になります。社内のプライバシー担当チームから同意前の状態での使用が認められているライブラリに注意してください。
Adobe Launch を使用すると、 Opt-in extension to configure Opt-in service.

オプトインのカテゴリー

訪問者のオプトインの環境設定は Adobe Experience Cloud ソリューションとは相対的で、各ソリューションがカテゴリーとして表されます。カテゴリーは
adobe.OptInCategories
オブジェクトで指定されます。例えば、ECID コンポーネントは
adobe.OptInCategories
となります。
ECID
をインストールします。以下は、
adobe.OptInCategories
の定義です。
オプトインの設定は、カテゴリーごとに管理されます。ここでは、各 Experience Cloud ソリューションはカテゴリーで表されます。
adobe.OptInCategories = { AAM: "aam", TARGET: "target", ANALYTICS: "aa", ECID: "ecid", };
オプトインサービスにより、サイトで使用されるアドビソリューションごとに訪問者の権限設定を設定できます。このオブジェクトでは、承認済みのカテゴリーごとに訪問者の設定を保存するライブラリが用意されており、承認プロセスで各カテゴリーの「確認」または「拒否」設定を 1 つずつ受け取るシーケンシャルフローがサポートされています。複数のソリューション(カテゴリー)をまとめてオプトインするか、個別のソリューションとしてオプトインするかを設定できます。アドビソリューションのクライアント側ライブラリはすべて、オプトインサービスに依存しており、ソリューションに権限が付与されない限り Cookie を生成しません。オプトインでは、現在の訪問者の同意設定をさまざまな方法で指定および更新できます。このセクションでは、オプトインサービスの設定例を示します。機能とパラメーターのリストについては、 オプトイン API リファレンス を参照してください。
オプトインサービスの設定は、グローバルな
getInstance()
オブジェクトをインスタンス化する Visitor JS
adobe
関数で指定します。以下に、オプトインサービス用の Visitor JS 設定 を示します。
グローバルな
Visitor
オブジェクトの初期化におけるオプトインの設定例
// FORMAT: Object<adobe.OptInCategories enum: boolean> var preOptInApprovalsConfig = {}; preOptInApprovals[adobe.OptInCategories.ANALYTICS] = true; // FORMAT: Object<adobe.OptInCategories enum: boolean> // If you are storing the OptIn permissions on your side (in a cookie you manage or in a CMP), // you have to provide those permissions through the previousPermissions config. // previousPermissions will overwrite preOptInApprovals. var previousPermissionsConfig = {}; previousPermissionsConfig[adobe.OptInCategories.AAM] = true; previousPermissionsConfig[adobe.OptInCategories.ANALYTICS] = false; Visitor.getInstance("YOUR_ORG_ID", { "doesOptInApply": true, // NOTE: This can be a function that evaluates to true or false. "preOptInApprovals": preOptInApprovalsConfig, "previousPermissions": previousPermissionsConfig, "isOptInStorageEnabled": true });
同意に対する変更の処理
訪問者は、サイトを訪問中にいつでも、CMP を使用して初めて環境設定を設定したり、設定した設定を変更したりできます。Visitor JS が初期設定で初期化された後、訪問者の権限を変更できます。同意を管理するための関数の一覧については、 同意の変更 を参照してください。

オプトインワークフロー

オプトインサービスでは、複数回のリクエストサイクルで権限を収集でき、環境設定が 1 つずつおこなわれるワークフローがサポートされています。以下の関数を使用して
true
shouldWaitForComplete
を指定すると、ソリューションでは、1 つのソリューションまたは全カテゴリーのサブセットに対する同意を収集してから、次のソリューションまたは全カテゴリーの別のサブセットに対する同意を収集することができます。最初の呼び出しから、フローの最後に
adobe.optIn.status
が呼び出されるまで、
プロパティは
pending
adobe.optIn.complete()
になります。この呼び出し後、ステータスは
complete
に設定されます。
adobe.optIn.approve(['AAM', 'ECID'], true); adobe.optIn.deny(['ANALYTICS'], true); adobe.optIn.complete();
ワークフローの設定 を参照してください。

訪問者のオプトイン権限の確認

訪問者が自身の権限を変更した場合は、変更後の権限を調査して、オプトインサービスでおこなわれた変更を同意ストアと同期する必要があります。訪問者の設定を確認するには、次の例のように 権限関数 を使用します。
fetchPermissions のサンプル
optIn.fetchPermissions(function (permissions) { // Here you can check if your category has been approved or not. // We recommend using optIn.isApproved() to check for permissions because it abstracts out the details of knowing exactly how the permissions list looks like. if (adobe.optIn.isApproved(MY_CATEGORY) { sendBeacon(); // Or something } }); OR: You can pass in shouldAutoSubscribe as true, your callback will be used to subscribe to all OptIn events going forward: function callback() { if (adobe.optIn.isApproved(MY_CATEGORY) { sendBeacon(); // Or something } } optIn.fetchPermissions(callback, true);
上記のサンプルおよびこのドキュメントで取り上げている関数、プロパティおよび設定の詳細については、 API ドキュメント を参照してください。

訪問者の設定の保存

オプトインサービスでは、開発環境や CRM を使用できない環境に適した同意設定を保存することができます。
isOptInStorageEnabled
設定プロパティを
true
として指定すると、オプトインサービスにより、ドメイン内の訪問者のシステムに Cookie が作成されます。
adobe.optIn
オブジェクトはステートレスであり、保存メカニズムは備えていません。その代わり、既存の同意管理プラットフォーム(CMP)でカスタムデータの保存が許可されている場合にそのプラットフォームでアドビの同意設定を管理することを目的としています。また、訪問者のブラウザーの Cookie に訪問者の設定を保存することもできます。オプトインサービスにユーザーの環境設定を指定する方法は 2 つあります。
  • CMP か訪問者のブラウザーの Cookie かに関わらず、同意保持ソリューションで訪問者の設定をタイムリーに取得できる場合は、Visitor の初期化中にこれらの設定をオプトインサービスに指定できます。
  • ただし、取得プロセスに時間がかかる場合や、非同期プロセスとして最善の役割を果たしている場合には、サービスの
    approve()
    関数を使用して、読み込みに成功したときにこれらの設定を指定できます。