アップグレード準備ガイド

Adobe Experience Platform Launch は DTM とまったく異なるシステムです。概念上は同じ目標を達成しますが、それを実現するための方法が異なります。

  • Platform Launch の _satellite オブジェクトは DTM のものとは異なります。
  • また、拡張機能と、ルール、データ要素の関係も以前とは異なります。
  • 両方のシステムに存在するコンテンツには、別の場所に移動したものや、アクセス方法が変わったものもあります。

Upgrade Assistant は、DTM でのページ上の動作とできるだけ近くなるよう Platform Launch プロパティを作成します。動作が期待とは異なった場合、何をどこに移動するかについて詳しくは、次を参照してください。

詳細に定義される違いの例:

  • DTM プロパティで何も実行しないルールコンポーネントとデータ要素は、Platform Launch にはコピーされません。例:存在しないデータ要素によって定義された Data Element 条件はコピーされません。
  • 多くの条件が更新されたので、Platform Launch の条件で利用可能なオプションは少し異なります。例:Operating System 条件は Blackberry のサポートを終了しました。
  • Platform Launch では、多くのリソースは新機能と呼ばれ、新しい名前でコピーされます。例:Page Top イベントは Library Loaded イベントに移動します。
  • 多くの非常に具体的な条件が、Platform Launch では、より一般的な Value Comparison 条件に置き換えられました。これにより、より多くのオプションが可能となり、すべての比較演算子の一貫性を確保し、メンテナンスも簡素化します。例:Cart Amount 条件が Value Comparison 条件に置き換えられました。

プロパティ

名前

DTM プロパティの名前は Platform Launch にコピーされます。Platform Launch プロパティの最後に (DTM - yyyy-mm-dd hh:mm:ss) が追加され、移行時に正確に把握できるようになります。このタイムスタンプは、Platform Launch プロパティ名から削除できます。

ドメイン

DTM プロパティのドメインは Platform Launch にコピーされます。

DTM で同じドメインが複数回表示されていた場合、Platform Launch プロパティには 1 回のみ表示されます。Platform Launch のドメインは、小文字で表示されます。

DTM プロパティで 1 つ以上の有効なドメインが定義されていない場合、そのドメインはコピーされません。

詳細設定

DTM プロパティの詳細設定が Platform Launch にコピーされます。

ツール

Platform Launch にアップグレードすると、最もよく使用する DTM ツールがプロパティ上のインストール済み Platform Launch 拡張機能に変換されます。

Adobe Analytics ツール

ツール選択

DTM を使用すると、Analytics ツールの複数のインスタンスをプロパティにインストールできます。Platform Launch では、拡張機能 1 つに対して 1 つのインスタンスのみをインストールできます。そのため、アップグレード時には、Analytics ツールが 1 つだけ Platform Launch にコピーされます。

コピーされたツールインスタンスは、名前を小文字に変換してから、アルファベット順に並べ替えられます。順番が最初のツールがコピーされます。

ツールの名前を変更して、コピーするツールインスタンスを制御できます。

App Measurement バージョン

DTM には、App Measurement をデプロイするための様々なオプションが用意されています。それぞれが Platform Launch でサポートされているので、どのメソッドを使用していても、Platform Launch で同じメソッドを使用できます。

DTM ツールで Managed by Adobe を使用している場合は、App Measurement の最新 5 つのバージョンのいずれかを選択できます。Platform Launch 用の Adobe Analytics 拡張機能では最新バージョンのApp Measurement が使用されるので、選択内容に応じて、Platform Launch にコピーすると、異なるバージョンの App Measurement が使用される可能性があります。バージョンを一致させるには、アップグレードする前に、Platform Launch と同じバージョンを使用するよう DTM ツールを変更してください。

Initial Beacon

DTM では、ルールが定義されていない場合でも、App Measurement が読み込まれると Analytics ビーコンがすべてのページで実行されます。Platform Launch では、このビーコン呼び出しはルールによって制御され、自動的には発生しません。DTMの Page code is already present オプションを使用している場合を除き、アップグレードプロセスによってこのルールが作成されます。このルールは「Migrated from DTM: Adobe Analytics - Send beacon on every page」と呼ばれ、次のように定義されます。

  • イベント:Page Bottom(ほとんどの場合、Platform Launch が Page Bottom ではなく、Library Load を推奨している場合でも、DTM の動作を最も厳密に照合します。)
  • 条件:なし
  • 例外:なし
  • アクション:Adobe Analytics - Send Beacon

DTM に Analytics ツールがインストールされている限り、アップグレードアシスタントは Platform Launch にこのルールを作成します。DTM のカスタムコード内で return false を使用して初期ビーコン呼び出しを抑制していた場合、アップグレードが完了した後で Platform Launch ルールをライブラリから除外(または削除)する必要があります。

その他

実稼動用レポートスイートを定義していない Analytics ツールは、Platform Launch にコピーされません。

eVar\#\# のパターンが一致しない eVar は、Platform Launch にはコピーされません。

Experience Cloud ID ツール

Experience Cloud ID ツールは Platform Launch にコピーされます。そのツールについては、次の点に注意してください。

拡張機能の設定

DTM ツールの一部の変数は、Platform Launch 拡張機能ではサポートされていません。Platform Launch にコピーされる変数:

  • audienceManagerServer
  • audienceManagerServerSecure
  • cookieDomain
  • cookieLifetime
  • cookieName
  • disableThirdPartyCalls
  • idSyncAfterIDCallResult
  • idSyncAttachIframeOnWindowLoad
  • idSyncContainerID
  • idSyncDisable3rdPartySyncing
  • disableThirdPartyCookies
  • idSyncDisableSyncs
  • disableIdSyncs
  • idSyncIDCallResult
  • idSyncSSLUseAkamai
  • isCoopSafe
  • loadSSL
  • loadTimeout
  • marketingCloudServer
  • marketingCloudServerSecure
  • overwriteCrossDomainMCIDAndAID
  • resetBeforeVersion
  • sdidParamExpiry
  • serverState
  • sessionCookieName
  • takeTimeoutMetrics
  • trackingServer
  • trackingServerSecure
  • allowlistIframeDomains
  • allowlistParentDomain

値がない変数は、Platform Launch にコピーされません。

顧客 ID の設定

DTM の ECID ツール設定に Customer Settings セクションのデータが含まれている場合、そのデータは Platform Launch ルールにコピーされます。Platform Launch ルールの定義は次のとおりです。

  • イベント:Library Loaded
  • 条件:なし
  • 例外:なし
  • アクション:Experience Cloud ID - Set Customer IDs

名前や値のない顧客 ID はコピーされません。

有効な顧客 ID が見つからない場合、Platform Launch ルールは作成されません。

Google Universal Analytics

ツール選択

DTM を使用すると、Google Universal Analytics ツールの複数のインスタンスをプロパティにインストールできます。Platform Launch では、拡張機能 1 つに対して 1 つのインスタンスのみをインストールできます。そのため、アップグレード時には、ツールが 1 つだけ Platform Launch にコピーされます。

コピーされたツールインスタンスは、名前を小文字に変換してから、アルファベット順に並べ替えられます。順番が最初のツールがコピーされます。

ツールの名前を変更して、コピーするツールインスタンスを制御できます。

Initial Beacon

DTM では、ルールが定義されていない場合でも、すべてのページでビーコンが起動されます。Platform Launch では、このビーコン呼び出しはルールによって制御され、自動的には発生しません。Google Universal Analytics page code is already present オプションを使用している場合を除き、アップグレードプロセスでこのルールが作成されます。このルールは「Migrated from DTM: Google Universal Analytics - Send beacon on every page」と呼ばれ、次のように定義されます。

  • イベント:Core - Page Bottom(ほとんどの場合、Platform Launch が Page Bottom ではなく、Library Load を推奨している場合でも、DTM の動作を最も厳密に照合します。)
  • 条件:なし
  • 例外:なし
  • アクション:Google Univeral Analytics - Send Page View

ヒットコールバック

Google Universal Analytics ツール内の「ヒットコールバック」セクションに JavaScript コードを追加した場合、アップグレードアシスタントにより、Platform Launch で一致ルールが作成されます。ルールは「Migrated from DTM: Google Universal Analytics - Hit Callback」と呼ばれ、次のように定義されます。

  • イベント:Google Universal Analytics - Hit Callback
  • 条件:なし
  • 例外:なし
  • アクション:Core - Custom Code

ルール定義

DTM で Event Category または Event Action がないルールを定義した場合、これらのイベントの詳細は Platform Launch にはコピーされません。

DTM で Event Value が数値ではないルールを定義した場合、これらのイベントの詳細は Platform Launch にはコピーされません。

コピーされないツール

プロパティにインストールされた次の DTM ツールは、Platform Launch 拡張機能にコピーされません。

  • Adobe Audience Manager
  • Adobe Media Manager
  • Adobe Target
  • AEM ContextHub
  • Nielsen
  • Google Analytics

データ要素

DTM で、データ要素が falsy(例:""0falsenullundefined)な値に解決されると、データ要素は設定済みのデフォルト値にフォールバックされます。Platform Launch では、データ要素は、解決された値が null または undefined の場合に のみ、設定されたデフォルト値にフォールバックされます。

cookie 名を含まない Cookie データ要素タイプは、Platform Launch にコピーされません。

CSS セレクター

Platform Launch では、CSS セレクターのデータ要素タイプは DOM 属性と呼ばれ、CSS セレクターのデータ要素タイプが DOM 属性データ要素タイプにコピーされます。

セレクターを含まない CSS Selector データ要素タイプは、Platform Launch にコピーされません。

get the value of Other Attribute を使用しているが空の文字列を指定している CSS Selector データ要素タイプは、Platform Launch にコピーされません。

JS オブジェクト

パスを含まない JS Object データ要素タイプは、Platform Launch にコピーされません。

URL パラメーター

パラメーターを含まない URL Parameter データ要素タイプは、Platform Launch にコピーされません。

ルールイベント

Page Top

Platform Launch では、DTM Page Top イベントタイプは Library Load と呼ばれ、Page Top イベントタイプを含むすべての DTM ルールは Library Load イベントを含む Platform Launch ルールとなります。

ルール条件

ブラウザー

Platform Launch のブラウザー条件から、DTM でサポートされていた一部の古いブラウザーに対するサポートが削除されました。サポートされている値のみが Platform Launch にコピーされます。

Platform Launch でサポートされている値:

  • Chrome
  • IE
  • Firefox
  • Safari
  • Mobile Safari

Platform Launch でサポートされていない値:

  • Opera
  • IE Mobile
  • Opera Mini
  • Opera Mobile
  • OmniWeb

現在サポートされていない値のみを含むブラウザー条件を使用している場合、条件は Platform Launch にコピーされません。

買い物かご内の金額

DTM Cart Amount 条件は Value Comparison の Platform Launch 条件に置き換えられました。そのため、Cart Amount 条件は、Platform Launch に Value Comparison 条件としてコピーされます。

データ要素を定義しない(または存在しないデータ要素を定義する)DTM Cart Amount 条件は、Platform Launch にコピーされません。

買い物かごの品目数

DTM Cart Item Quantity 条件は Platform Launch の Value Comparison 条件に置き換えられました。そのため、Cart Item Quantity 条件は、Platform Launch に Value Comparison 条件としてコピーされます。

データ要素を定義しない(または存在しないデータ要素を定義する)DTM Cart Item Quantity 条件は、Platform Launch にコピーされません。

データ要素

DTM Data Element 条件は Platform Launch の Value Comparison 条件に置き換えられました。そのため、Data Element 条件は、Platform Launch に Value Comparison 条件としてコピーされます。

データ要素を定義しない(または存在しないデータ要素を定義する)DTM Data Element 条件は、Platform Launch にコピーされません。

デバイス

この条件は、Platform Launch には存在しないので、コピーされません。

ログイン済み

DTM Logged In 条件は Value Comparison の Platform Launch 条件に置き換えられました。そのため、Logged In 条件は、Platform Launch に Value Comparison 条件としてコピーされます。

データ要素を定義しない(または存在しないデータ要素を定義する)DTM Logged In 条件は、Platform Launch にコピーされません。

オペレーティングシステム

Platform Launch Operating System 条件から、DTM でサポートされていた一部の古いオペレーティングシステムのサポートを削除しました。サポートされている値のみが Platform Launchvにコピーされます。

Platform Launch でサポートされている値:

  • Windows
  • MacOS
  • Linux
  • iOS
  • Android
  • Unix

Platform Launch でサポートされていない値:

  • Symbian OS
  • Maemo
  • BlackBerry

現在サポートされていない値のみを含むオペレーティングシステム条件を使用している場合、条件は Platform Launch にコピーされません。

以前のコンバーター

DTM Previous Converter 条件は Value Comparison の Platform Launch 条件に置き換えられました。そのため、Previous Converter 条件は、Platform Launch に Value Comparison 条件としてコピーされます。

登録ユーザー

DTM Registered User 条件は Value Comparison の Platform Launch 条件に置き換えられました。そのため、Registered User 条件は、Platform Launch に Value Comparison 条件としてコピーされます。

ルールアクション

カスタムスクリプト

カスタムスクリプトの内容は、そのままコピーされます。コードは目的を判断するために検査されません。単純に、Platform Launch のカスタムコードにコピーされます。このプロセスについては、次の点に注意してください。

  • コンテンツのない DTM(非シーケンシャル、シーケンシャル JS、シーケンシャル HTML)のカスタムスクリプトは、Platform Launch にはコピーされません。

  • ES6 は Platform Launch ではサポートされていません。ES6 は DTM ではサポートされていませんが、DTM コンパイラーの開発時には存在しなかったので、コンパイラーはこれを取り込みません。

    重要

    DTM で ES6 コードを使用している場合、コードは Platform Launch にコピーされますが、ビルドの作成時にコンパイルエラーが発生してビルドが失敗します。このエラーは、アップグレードの前または後に修正できます。

  • カスタムコードでは、_satellite オブジェクト、および DTM で提供される様々なプロパティや関数を参照することが一般的です。Platform Launch は satellite オブジェクトを使用しますが、以前と同様、構造化されていません。DTM でサポートされていた関数やプロパティは Platform Launch に移行しましたが、サポートされていなかった多くの機能は移行されていません。DTM でこれらの機能のいずれかを使用する場合は、カスタムコードの更新が必要な可能性が高くなります。新しい Platform Launch satellite オブジェクトで何がサポートされるかを確認するには、Platform Launch オブジェクト参照を参照してください。

このページ

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now