このページでは、Server SDK configure メソッドのdefaultConsentについて説明します。 Web SDKについては、defaultConsentを参照してください。
defaultConsent プロパティは、保存された同意設定を持たない訪問者のデータをServer SDKが収集するかどうかを決定します。 setConsentで記録した訪問者の保存された環境設定は、常にこのデフォルトよりも優先されます。
configureを呼び出すときにdefaultConsent文字列プロパティを設定します。 次の値をサポートします。
"in"：訪問者がオプトアウトするまで、SDKはデータを送信します。 これがデフォルト値です。"out"：訪問者がオプトインするまで、SDKはデータを送信しません。sendEventなどのメソッドは、Adobeに連絡せずに空のオブジェクトで解決されます。
await alloy.configure({
datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
edgeCredentials: {
clientId: process.env.ADOBE_CLIENT_ID,
clientSecret: process.env.ADOBE_CLIENT_SECRET,
scopes: process.env.ADOBE_SCOPES.split(",")
},
defaultConsent: "out"
});
この値は、大文字と小文字を区別します。 その他の値は、configureに拒否されます。 このプロパティは、インスタンスに同意コンポーネントが含まれている場合にのみ使用できます。このコンポーネントは、createInstanceにデフォルトで含まれています。
同意の保留中はサポートされていません pending
Web SDKは"pending"もサポートしており、訪問者が選択するまでブラウザーにイベントを保持します。 Server SDKは"pending"をサポートしておらず、configureはそれを拒否します。
ブラウザーでは、訪問者が決定している間もページは開いたままになるので、Web SDKは後で保持されたイベントを送信できます。 サーバーでは、各forRequest ハンドルは1つのリクエストに対してのみ有効です。 同じ訪問者からの後のリクエストでは、以前のリクエストが保持したイベントをリリースできないため、送信されることはありません。
代わりに、各訪問者が自身のアプリケーションで同意決定を行ったかどうかを追跡してください。 決定していない訪問者には、sendEventを呼び出さないでください。
保存された同意がデフォルトに与える影響 stored-consent
訪問者が同意を設定すると、SDKはforRequestに渡すCookie サービスを通じて、kndctr_<orgId>_consent Cookieに保存します。 後のリクエストでは、訪問者のID Cookieが存在する限り、SDKはdefaultConsentではなく保存された環境設定を使用します。 ID Cookieがない場合、同意は訪問者のIDに関連付けられているため、SDKは保存された同意を破棄します。
Server SDKは、Web SDKと同じCookie名を使用します。 Cookie サービスが訪問者のブラウザーCookieを読み取る場合、ブラウザーに記録された訪問者がサーバーにも適用されることに同意します。
Cookie サービスをforRequestに渡さない場合、SDKはリクエスト間の訪問者の同意を記憶できません。 この場合、すべてのリクエストはdefaultConsentから始まります。