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

at.js と Platform Web SDK の比較

Last update: Thu Oct 03 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

中級
経験者
開発者

スタンドアロンのAdobe Target at.js ライブラリは、Platform Web SDK とは大きく異なります。次の表は、移行プロセスの間に注意が必要になる実装領域を評価する際に役立つリファレンスです。

以下の情報を確認し、現在の at.js の技術的実装を評価すると、次のことを理解できるようになります。

Platform Web SDK でサポートされている Target 機能
Platform Web SDK と同等の機能を持つ at.js 関数
Platform Web SDK での Target 設定の適用方法
at.js と Platform Web SDK のデータフローの違い

Platform Web SDK を初めて使用する場合は、心配はいりません。以下の項目については、このチュートリアル全体でより詳しく説明します。

機能の比較

Target at.js 2.x

Platform Web SDK

ターゲットプロファイルを更新

サポートあり

SPAのトリガービュー

サポートあり

Target Recommendations

サポートあり

フォームベースのオファーの取得

サポートあり

トラックイベント

サポートあり

A4T：単一ページアプリケーション

サポートあり

A4T：クリックの追跡

サポートあり

A4T：クライアントサイドログ

サポートあり

A4T：サーバーサイドログ

サポートあり

オファーの適用

サポートあり

通知を使用しないSPAでのビューの再レンダリング

サポートあり

ハイブリッドアプリケーション

サポートあり

QA の URL

サポートあり

Mbox サードパーティ ID

サポートあり

顧客属性

サポートあり

リモートオファー

サポートあり

リダイレクトオファー

サポートあり

サポート。ただし、Platform Web SDK を含むページから at.js を含むページ（およびその逆方向）へのリダイレクトはサポートされていません。

オンデバイス判定

サポートあり

現在サポートされていません

Mbox をプリフェッチ

カスタムスコープおよびSPA VEC でサポート

プリフェッチは、Web SDK のデフォルトのモードです

カスタムイベント

サポートあり

サポート対象外現在のステータスについては、パブリックロードマップを参照してください。

レスポンストークン

サポートあり

サポート。コード例と at.js と Platform Web SDK の違いについては、専用の応答トークンドキュメントを参照してください

データプロバイダー

サポートあり

サポート対象外カスタムコードを使用すると、別のプロバイダーからデータを取得した後に、Platform Web SDK sendEvent コマンドをトリガーできます。

注目のコールアウト

Target at.js 2.x

Platform Web SDK

ちらつき軽減

非同期実装の事前非表示スニペットでは、at-body-style のスタイル ID を使用します。 at.js は、応答を受信したらスタイルを削除するためにこの要素 ID を探します。

デフォルトの事前非表示スニペットでは、alloy-prehiding のスタイル ID を使用します。 Web SDK は at.js 事前非表示スニペットと互換性がないので、移行プロセスの一環として変更する必要があります。

ページ読み込み時にコンテンツを自動的にレンダリング

Target グローバル設定で制御します。 pageLoadEnabled が true に設定されている場合に有効になります。

Platform Web SDK sendEvent コマンドで指定されます。有効にするには、renderDecisions オプションを true に設定します。

コンテンツの手動レンダリング

applyOffer() 関数と applyOffers() 関数は、設定HTMLのみをサポートしています

applyPropositions コマンドでは、HTMLの設定、置換、追加をサポートしているので、柔軟性が向上しています

カスタムイベントの追跡

trackEvent() 関数と sendNotifications() 関数でサポートされます。これらの関数は、Target に固有で、Adobe Analyticsの指標には影響しません。

Platform Web SDK sendEvent 呼び出しからのすべてのデータは、Target に転送されます。 Adobe Analytics指標が影響を受けないように、Target に特別に必要な追加データを、eventType を decisioning.propositionDisplay または decisioning.propositionInteract に指定して sendEvent コマンドに含める必要があります。

ターゲット CNAME

サポート。これは、Analytics で使用される CNAME やExperience CloudID サービスとは別のものです。

関係がなくなりました。 1 つの CNAME をすべての Platform Web SDK 呼び出しに使用できます。

デバッグ

mboxDisable、mboxDebug、mboxTrace の URL パラメーターは、ブラウザーの開発者ツールでのデバッグに使用できます。

Adobe Experience Platform Debuggerはサポートされているデバッグツールでもあります。

mboxDisable、mboxDebug、mboxTrace の URL パラメーターはサポートされていません。

Web SDK のデバッグを有効にするには、クエリ文字列に alloy_debug=true を追加するか、開発者コンソールで alloy("setDebug", { "enabled": true }); を実行します。

Adobe Experience Platform Debuggerブラウザー拡張機能を使用して、デバッグ用のエッジトレースを開始できます。

詳しくは、Platform Web SDK のデバッグドキュメントを参照してください。

Analytics for Target（A4T）

SDID 値を使用して、Target と Analytics の呼び出しをステッチします

ステッチを必要とせずにネイティブにサポートされる

NOTE

特定のページに既存の Platform Web SDK 実装を保持したままAppMeasurementをAdobe Analyticsに移行することは、サポートされていません。

at.js （および platform.js）実装を 1 ページずつAppMeasurement Web SDK に移行することが可能です。この方法を使用する場合は、configure のコマンドで、idMigrationEnabled および targetMigrationEnabled オプションを true に設定することをお勧めします。

at.js 関数と Platform Web SDK の同等機能

多くの at.js 関数は、次の表に示す Platform Web SDK を使用した同等のアプローチを備えています。 at.js 関数について詳しくは、Adobe Target開発者ガイドを参照してください。

at.js 2.x 関数

Platform Web SDK の同等機能

getOffer() および getOffers()

Target VEC ベースのエクスペリエンスをリクエストし自動的にレンダリングするには、sendEvent コマンドを使用して、renderDecisions オプションを true に設定します。

フォームベースのエクスペリエンスをリクエストしたり、コンテンツを手動でレンダリングしたりするには、sendEvent コマンドで decisionScopes （mbox）の配列を指定します。

applyOffer() および applyOffers()

applyPropositions コマンドを使用してコンテンツを適用します。特定のセレクターに対して、HTMLの設定、置換、追加を行うことができます。

triggerView()

sendEvent コマンドの xdm オプションで web.webPageDetails.viewName プロパティがトリガーされている場合、Platform Web SDK はSPA VEC 用にビューの変更を自動的に設定します。

trackEvent() および sendNotifications()

sendEvent コマンドを特定の eventType set:

decisioning.propositionDisplay と共に使用すると、アクティビティのレンダリングを示し

decisioning.propositionInteract マウスクリックなどのアクティビティに対するユーザー操作を示します。

targetGlobalSettings()

直接同等の手段はありません。詳しくは、ターゲット設定の比較を参照してください。

targetPageParams() および targetPageParamsAll()

sendEvent コマンドの xdm オプションで渡されたすべてのデータは、Target mbox パラメーターにマッピングされます。 mbox パラメーターにはシリアル化されたドット表記を使用して名前を付けるので、Platform Web SDK に移行する場合は、新しい mbox パラメーター名を使用するように既存のオーディエンスとアクティビティを更新する必要が生じる場合があります。

sendEvent コマンドの data.__adobe.target の一部として渡されたデータは、Target プロファイルおよびRecommendations固有のパラメーターにマッピングされます。

at.js カスタムイベント

サポート対象外現在のステータスについては、パブリックロードマップを参照してください。レスポンストークンは、sendEvent 呼び出しの応答で propositions の一部として公開されます。

at.js の設定および Platform Web SDK の同等の機能

at.js ライブラリは、Target UI の様々な設定を使用して設定およびダウンロードできます。これらの設定は、targetGlobalSettings() 関数で更新することもできます。以下の表は、これらの設定と Platform Web SDK で使用できる設定を比較しています。

at.js の設定

Platform Web SDK の同等機能

bodyHiddenStyle

configure コマンドで prehidingStyle を設定します

bodyHidingEnabled

configure コマンドで prehidingStyle が定義されている場合、この機能は有効になります。スタイルが定義されていない場合、Platform Web SDK はコンテンツの非表示を試みません。

clientCode

自動的に構成

cookieDomain

該当なし

crossDomain

thirdPartyCookiesEnabled オプションを true に設定し、configure コマンドを使用して、クロスドメインの使用例に対してファーストパーティおよびサードパーティ Cookie を有効にします

cspScriptNonce および cspStyleNonce

CSP の設定については、ドキュメントを参照してください。

dataProviders

サポートなし

decisioningMethod

すべての Platform Web SDK sendEvent コマンドは、サーバーサイド判定を使用します。ハイブリッド判定とオンデバイス判定はサポートされていません。

defaultContentHiddenStyle および defaultContentVisibleStyle

at.js 1.x でのみ使用可能です。at.js 2.x と同様に、フォームベースのエクスペリエンスのフリッカーの軽減は、カスタムコードを使用して実現できます。

deviceIdLifetime

サポート対象外 targetMigrationEnabled が configure コマンドで true に設定されている場合、mbox Cookie はデバイスの有効期間が 2 年に設定されます。この値は変更できません。

enabled

データストリーム設定で Target 機能を有効または無効にする

globalMboxAutoCreate

renderDecisions オプションを sendEvent コマンドで true に設定して、VEC ベースのエクスペリエンスを自動的に取得し、レンダリングします。

VEC ベースのエクスペリエンスを手動でレンダリングする場合は、__view__ の decisionScope をリクエストします。

imsOrgId

configure コマンドで orgId を設定します

optinEnabled および optoutEnabled

Platform Web SDK プライバシーオプションを参照してください。 defaultConsent オプションは、Platform Web SDK がサポートするすべてのAdobeソリューションに適用されます。

overrideMboxEdgeServer および overrideMboxEdgeServerTimeout

適用できません。すべての Platform Web SDK リクエストは、Adobe Experience Platform Edge ネットワークを使用します。

pageLoadEnabled

sendEvent コマンドを使用して、renderDecisions オプションを true に設定します

secureOnly

サポート対象外 Platform Web SDK は、secure 属性と sameSite="none" 属性を持つすべての cookie を設定します。

selectorsPollingTimeout

サポート対象外 Platform Web SDK は 5 秒の値を使用します。必要に応じて、カスタムコードを使用してコンテンツを手動でレンダリングできます。

serverDomain

configure コマンドで edgeDomain 設定を使用します

telemetryEnabled

該当なし

timeout

サポート対象外ちらつき軽減コードに適切なタイムアウトが含まれていることを確認することをお勧めします。

viewsEnabled

サポート対象外 Target ビューのコンテンツは、renderDecisions が true に設定されている場合、または __view__ decisionScope がリクエストに含まれている場合、常に最初の sendEvent() 呼び出し時に取得されます。

visitorApiTimeout

該当なし

システム図の比較

次の図は、at.js を使用した Target 実装と、Platform Web SDK を使用した実装のデータフローの違いを理解するのに役立ちます。

at.js 2.x のシステム図

ページ読み込み時の at.js 2.0 の動作 {modal="regular"}

通話

詳細

呼び出しによってExperience CloudID （ECID）が返されます。ユーザーが認証されると、別の呼び出しでその顧客 ID が同期されます。

at.js ライブラリは同期して読み込まれ、ドキュメントの本文を非表示にします（ページに実装されたオプションの事前非表示スニペットを使用して、at.js を非同期で読み込むこともできます）。

すべての設定済みパラメーター、ECID、SDID および顧客 ID を含むページ読み込みリクエストが行われます。

プロファイルスクリプトは、を実行してプロファイルストアに入力します。ストアは、対象オーディエンスをオーディエンスライブラリからリクエストします（例えば、Analytics やAudience Managerなどから共有されたオーディエンス）。顧客属性は、バッチプロセスでプロファイルストアに送信されます。

URL、リクエストパラメーター、プロファイルデータに基づいて、Target は、現在のページと今後の表示で訪問者に返すアクティビティとエクスペリエンスを決定します。

ターゲットコンテンツがページに送り返されます（オプションで、パーソナライゼーションを追加するためのプロファイル値も含む）。

現在のページ上のターゲットコンテンツは、デフォルトコンテンツのちらつきなしでできるだけ早く表示されます。

単一ページアプリケーションの将来のビューのターゲットコンテンツは、ブラウザーにキャッシュされるので、ビューがトリガーされたときに追加のサーバー呼び出しをおこなわずに即座にターゲットコンテンツを適用できます。

ページからデータ収集サーバーに送信された Analytics データ。

ターゲットデータは、SDID を介して Analytics データと照合され、Analytics レポートストレージ内で処理されます。 A4T レポートを使用して、Analytics データが Analytics と Target の両方に表示できるようになります。

詳しくは、開発者ガイドを参照してください単一ページアプリケーション用に at.js を使用して Target を実装する。

Platform Web SDK のシステム図

Platform Web SDK を使用したAdobe Target edge Decisioning の図

通話

詳細

デバイスが Platform Web SDK を読み込みます。 Platform Web SDK は、XDM データ、データストリーム環境 ID、渡されたパラメーター、顧客 ID （オプション）を使用して、Edge ネットワークにリクエストを送信します。ページ（またはコンテナ）は事前非表示になっています。

Edge network は、訪問者 ID、同意、その他の訪問者コンテキスト情報（位置情報やデバイスにわかりやすい名前など）を使用して、リクエストを強化するために edge サービスにリクエストを送信します。

エッジネットワークは、訪問者 ID と渡されたパラメーターを使用して、エンリッチメントされたパーソナライゼーションリクエストを Target エッジに送信します。

プロファイルスクリプトは、を実行して、Target プロファイルストレージにフィードします。プロファイルストレージは、オーディエンスライブラリからセグメントを取得します（例えば、Adobe Analytics、Adobe Audience Manager、Adobe Experience Platformで共有されているセグメント）。

Target は、URL リクエストパラメーターとプロファイルデータに基づいて、現在のページビューと将来の事前読み込みビューで、訪問者に表示するアクティビティとエクスペリエンスを決定します。次に、Target はこれをエッジネットワークに送り返します。

回答：Edge Network は、パーソナライゼーション応答をページに送り返します（オプションで、追加のパーソナライゼーションのプロファイル値も含みます）。現在のページ上のパーソナライズされたコンテンツは、デフォルトコンテンツのちらつきなしでできるだけ早く表示されます。

b.シングルページアプリケーション（SPA）でユーザーアクションの結果として表示されるビューのパーソナライズされたコンテンツは、追加のサーバーコールなしでインスタントレンダリング用にキャッシュされます。

c.Edge Network は、訪問者 ID と cookie のその他の値（同意、セッション ID、ID、Cookie チェック、パーソナライゼーションなど）を送信します。

エッジネットワークは、Analytics for Target （A4T）の詳細（アクティビティ、エクスペリエンスおよびコンバージョンメタデータ）を Analytics エッジに転送します。

詳しくは、開発者ガイドを参照してください単一ページアプリケーション用 Platform Web SDK を使用した Target の実装。

現在の Target 実装と使用する機能について技術的に理解したら、次の手順は初期設定を実行します。

NOTE

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

recommendation-more-help

a69e1b51-9545-4d8a-822d-319242c29110