ドキュメントExperience PlatformTarget を at.js 2.x から Web SDK に移行する

Target at.js から Platform Web SDKへの移行の概要

Last update: Sun Feb 16 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • 中級
  • 経験者
  • 開発者

at.js から Platform Web SDKへの移行に必要な労力のレベルは、現在の実装と使用されている製品機能の複雑さによって異なります。

実装がどんなに単純でも、複雑でも、移行前に現在の状態を完全に理解することが重要です。 このガイドを使用すると、現在の実装のコンポーネントを分類し、各コンポーネントを移行する管理可能な計画を作成できます。

移行プロセスには、次の主な手順が含まれます。

  1. 現在の実装を評価し、移行アプローチを決定
  2. Adobe Experience Platform Edge Networkに接続するための初期コンポーネントの設定
  3. at.js を Platform Web SDKに置き換えるために、基本的な実装を更新します。
  4. 特定の使用例に合わせて Platform Web SDKの実装を強化します。 これには、追加のパラメーターの受け渡し、単一ページアプリ（SPA）ビューの変更の課金、応答トークンの使用などが含まれる場合があります。
  5. プロファイルスクリプト、アクティビティ、オーディエンス定義など、Target インターフェイスのオブジェクトを更新します
  6. 実稼動環境に切り替える前に、最終的な実装を検証します

at.js と Platform Web SDKの主な違い

移行プロセスを開始する前に、at.js と Platform web SDKの違いを理解することが重要です。

運用の違い

Platform Web SDKは、複数のAdobe アプリケーションの機能を 1 つのライブラリに組み合わせます。 この統一されたアプローチにより、健全な実装を確保するために、チーム間の責任とプロセスを考慮する必要があります。

Target at.js 2.x
Platform Web SDK
所有権
at.js ライブラリは、他のアプリケーションライブラリとは独立しています。 これらの異なるライブラリのカスタマイズと所有権は、組織内の異なるチームに一致する場合があります。
Platform Web SDK ライブラリと渡されるデータは、すべてのAdobe アプリケーション用に統合されます。 Platform Web SDK実装の所有権は、すべてのダウンストリームアプリケーションの関係者を表す必要があります。
メンテナンス
Target や Analytics など、Adobe アプリケーションごとに個別のチームが実装機能強化に取り組むこともあります。
Platform Web SDKの実装に影響を与える機能強化については、1 つのチームが担当するのが理想的です。
プロセス
Target 実装に対する変更は、Analytics などの他のアプリケーションとは異なるケイデンスや QA 要件を持つプロセスに従う場合があります。
Platform Web SDKの実装を変更する場合は、すべてのダウンストリームアプリケーションを考慮し、それに応じて QA および公開プロセスを調整する必要があります。
コラボレーション
Target に固有のデータは、Target 呼び出しで直接渡すことができます。 実装によっては、追加の Target 呼び出しが存在する場合があります。 これは、Adobe Analyticsのデータに直接影響せず、分析チームとの調整はそれほど重要ではありません。
Platform Web SDK呼び出しで渡されるデータは、Target と Analytics の両方に転送できます。 変更が特定のアプリケーションに悪影響を与えないようにするには、チーム間の調整が必要です。

技術的違い

Platform Web SDKは、Target at.js ライブラリを進化させたものではありません。 これは、web チャネル用のすべてのAdobe アプリケーションを実装するための新しい統一されたアプローチです。 注意すべき技術的な違いがいくつかあります。

Target at.js 2.x
Platform Web SDK
ライブラリ機能
at.js が提供する Target 機能。 Visitor.js およびAppMeasurement.js が提供するその他のアプリケーションとの統合
1 つの Platform Web SDK ライブラリで提供されるすべてのAdobe アプリケーションの機能：alloy.js
パフォーマンス
at.js は、アプリケーション間で適切に統合するために読み込む必要がある複数のライブラリの 1 つです。 その結果、最適な読み込み時間に満たない。
Platform Web SDKは、複数のアプリケーション固有のライブラリを必要としない、単一の軽量ライブラリであり、ページの読み込みパフォーマンスを向上させます。
リクエスト
Adobe アプリケーションごとに個別の呼び出し。 Target 呼び出しは、他のネットワーク呼び出しとは大きく独立しています。
すべてのAdobe アプリケーションが 1 回で呼び出されます。 これらの呼び出しで渡されるデータに変更を加えると、複数のダウンストリームアプリケーションに影響を与える可能性があります。
読み込み順序
他のAdobe アプリケーションと適切に統合するには、ライブラリとネットワーク呼び出しの特定の読み込み順序が必要です。
適切な統合は、異なるアプリケーション固有のネットワークコールからのデータのステッチに依存しないので、読み込み順序は問題になりません。
Edge Network
オプションで、Target 固有の CNAME を使用して、Adobe Experience Cloud Edge Network（tt.omtrdc.net）を使用します。
オプションで、単一の CNAME でAdobe Experience Platform Edge Network（edge.adobedc.net）を使用します。
基本用語
at.js の名前：
- mbox
- pageLoad イベント（グローバル mbox）
- offer
Platform Web SDKと同等の機能：
- decisionScope
- __view__ decisionScope
- proposition

ビデオの概要

次のビデオでは、Adobe Experience Platform Web SDKとAdobe Experience Platform Edge Networkの概要を説明します。

video poster

https://video.tv.adobe.com/v/37263/?learn=on&enablevpops&captions=jpn

at.js と Platform Web SDKの大きな違いを理解したら、 移行を計画できます。

NOTE
アドビは、at.js から web SDKへの Target の移行を成功させるために取り組んでいます。 移行の際に問題が発生した場合、またはこのガイドに重要な情報が欠落していると感じる場合は、 このコミュニティのディスカッションに投稿してお知らせください。
recommendation-more-help
a69e1b51-9545-4d8a-822d-319242c29110