[Alpha]{class="badge informative"}
Web SDKとの違い
Server SDKとWeb SDKは同じコアを共有しているため、同じフォーマットのデータを同じデータストリームに送信し、同じCookieを使用します。 一方はサーバー上で実行され、もう一方はブラウザー内で実行されるため、いくつかの点で異なります。 このページは、移行を計画したり、ブラウザーとサーバー実装の間でコードを共有したりするために使用します。
比較 comparison
@adobe/alloy npm パッケージ@adobe/alloy-node npm パッケージ。 インストール を参照してください。defaultConsentは"in"、"out"および"pending"を受け入れましたdefaultConsentは"in"と"out"のみを受け入れますReferer ヘッダーのページ URL。 コンテキストと転送ヘッダーを参照してください。sendEventpropositions、inferences、destinationspropositionsdebugEnabled、setDebug、alloy_debug クエリ文字列パラメーター、およびAdobe Experience Platform DebuggerdebugEnabledとsetDebug。メッセージがコンソールに書き込まれますmonitors オプションと__alloyMonitors グローバル変数createInstanceのmonitors オプションメソッド methods
Server SDKは、Web SDKに存在しないforRequest メソッドを追加します。
メソッドとして次のWeb SDK コマンドをサポートしています：appendIdentityToUrl、applyResponse、configure、getIdentity、getLibraryInfo、sendEvent、setConsent、およびsetDebug。
次のWeb SDK コマンドは、ブラウザーまたはServer SDKに含まれていないコンポーネントに依存するため、使用できません。
applyPropositionscreateMediaSessiongetMediaAnalyticsTrackersendMediaEventsendPushSubscriptionsubscribeRulesetItems
設定オプション configuration
- 新規および必須:
edgeCredentials。 - サポートされている:
datastreamId、orgId、debugEnabled、defaultConsent、edgeBasePath、edgeConfigOverrides、edgeDomain、idMigrationEnabled、onBeforeEventSendおよびthirdPartyCookiesEnabled。 サーバー上での動作が異なるものもあります。 各オプションのページを見る。 - サポートされていません：他のすべてのWeb SDK オプション。 1つを含めると、
configure件が却下されます。 Server SDKがサポートしていない オプション を参照してください。
sendEvent オプション sendevent
- サポートされている:
xdm、data、type、personalization.decisionScopesおよびpersonalization.surfaces、トップレベルのdecisionScopes配列、およびedgeConfigOverrides。 - 承認されましたが、効果はありません：
renderDecisions、advertisingおよびその他のpersonalizationプロパティ。 サーバー🔗に影響のない オプションを参照してください。 - 回避:
documentUnloading。
よくある質問 faq
Server SDKとWeb SDKを同じweb サイトで使用できますか？ same-site
はい。 一般的なパターンは、サーバーでパーソナライゼーションをリクエストし、ブラウザーでレンダリングすることです。 ハイブリッドパーソナライゼーション を参照してください。 両方のライブラリは、同じデータストリームにデータを送信できます。その アクセスの種類 が 混合認証 の場合です。 どちらも、IDと同意に同じCookie名を使用します。
すべてのイベントにプライマリ IDが必要な理由？ primary-identity
Server SDKは、認証されたEdge Network Server APIにイベントを送信します。 リクエストはサーバーから送信されるため、Edge Networkでは訪問者のブラウザーCookieを使用して訪問者を識別できません。 代わりに、イベントのプライマリ IDが必要です。 xdmを参照してください。
サーバーレス関数でServer SDKを使用できますか？ serverless
はい。関数のランタイムが要件を満たしている場合です。 関数ハンドラーの外で、モジュールの最上位レベルでインスタンスを作成して設定します。 この方法で、ウォーム呼び出しは、設定されたインスタンスとそのキャッシュされたアクセストークンを再利用します。 呼び出しごとにハンドラー内でforRequestを呼び出します。
Adobe Experience Platform Debuggerは使用できますか？ debugger
いいえ。 Adobe Experience Platform Debuggerは、ページを検査するブラウザー拡張機能です。 Server SDKをデバッグするには、debugEnabledをtrueに設定するか、setDebugを呼び出して、サーバーのコンソール出力を確認します。