Adobe Audience Manager DILバージョン 8.0 （またはそれ以降）へのアップデート updating-to-adobe-audience-manager-s-dil-version-or-greater
この記事では、Adobe Audience Manager（AAM） Data Integration Library （DIL）コードをバージョン 8.0 以降に更新する手順と推奨事項を説明します。 これは、Adobe Analytics データのサーバーサイド転送ではなく、「クライアントサイド」のDIL実装を指し、Adobeの Tag Manager ソリューションを使用しない DTM、Launch by Adobe、実装について説明します。
概要 overview
Audience Managerの Data Integration Library （DIL）コードを使用すると、web サイトにAAMを実装できます*。 以前のバージョンのDILを実装する場合、AdobeのExperience CloudID サービス（ECID）も実装する必要はありませんでした（ただし、非常に良い考えでした）。 DILバージョン 8.0 以降、ECID バージョン 3.3 以降には強い依存関係があります。 ECID 3.3 を使用せずに、または以前のDILでバージョン 8.0 以降を実装する場合、エラーが発生し、機能しません。 AAMを実装する方法は複数あるので、このページを作成して、いくつかの手順と推奨事項を説明しました。 以下に、これらの手順と推奨事項をプラットフォーム/実装方法別に示します。 DILについて詳しくは、 ドキュメントを参照してください。
- このページの説明に記載されているように、ここでは、Adobe Analyticsを持たないAAMのお客様が使用する「クライアントサイド」のDIL実装についてのみ説明します。 Adobe Analyticsがある場合は、AAMのサーバーサイド転送方式を使用する必要があります。 このメソッドについては、 ドキュメントを参照してください。
重複する非推奨（廃止予定）の要素とメソッド duplicate-and-deprecated-elements-and-methods
従来のDILと ECID には、DILと ECID の両方で同じ機能を果たす手法が重複しており、どちらを使用するかで混乱が生じていました。 通常は、両方を使用してマッチングする必要があり、そのメッセージはお客様によく伝えられていませんでした。 DIL 8.0 以降、これらの重複するメソッドおよび要素はDILで非推奨となったので、ECID バージョンを使用することをお勧めします。
例：
- DIL.create を使用する場合、いくつかの要素は非推奨となっており、代わりに ECID 要素を使用する必要があります。 これらの要素は、DIL.create ドキュメントで呼び出されます。
- idSync インスタンスレベルのメソッドも非推奨（廃止予定）となり、メソッドの ドキュメントで呼び出されています。
顧客 ID との ID 同期 id-syncing-with-a-customer-id
AAMでは、マシン上の UUID （匿名の一意のユーザー ID）を顧客 ID と同期させることができます。これにより、その顧客に関するオフラインデータをアップロードし、オンライン行動と結び付けて、顧客を深く理解できます。 これまでは、次の 2 つの方法のいずれかでおこなわれてきました。
- idSync インスタンスレベルのメソッド
- DIL.create の declaredId 要素
これらの古い方法のいずれかを使用して顧客 ID と同期している場合は、ECID サービスの一部である setCustomerIDs メソッドを使用して、に更新することを強くお勧めします。 setCustomerIDs について詳しくは、メソッドの ドキュメントを参照してください。
クイックヒント： 上記のいずれかの方法を以前に使用した際には、Data Source ID （別名「DPID」）を持つAAM Data Source を参照していました。 setCustomerIDs に更新する場合は、代わりにAAM Data Source の「Integration Code」を使用する必要があります。 同じ Data Source を指していますが、単に別の識別子です。 これを以下のビデオで示します。
次の節では、実装方法に基づいてDIL 8.0 にアップデートする際の手順と推奨事項を説明します。
Adobe Experience Platform タグのDIL 8.0 への更新 updating-to-dil-in-experience-platform-launch
DIL 8.0 に更新するための基本的な手順
-
8.0 より前のDILを使用している場合は、アップグレードの前にAAM拡張機能のDIL設定に移動し、使用している詳細設定オプションをメモします（その後の手順で使用します）。
-
AAM拡張機能をバージョン 8.0 以降に更新します。
-
お使いのExperience CloudID サービスの拡張機能がバージョン 3.3.0 以降であることを確認します。
-
8.0 より前のAAM拡張機能またはDIL用のカスタムコードに含まれていた非推奨のメソッドや要素（
disableIDSyncsなど）については、ECID 拡張機能で ECID メソッドを有効にします。- （DIL）
disableDestinationPublishingIframe-> （ECID）disableIdSyncs - （DIL）
disableIDSyncs-> （ECID）disableIdSyncs - （DIL）
iframeAkamaiHTTPS-> （ECID）dSyncSSLUseAkamai - （DIL）
declaredId-> （ECID）setCustomerIDs
- （DIL）
-
変更内容をPublishします。
DTMAdobeのDIL 8.0 への更新 updating-to-dil-in-adobe-dtm
- AAM ツールをバージョン 8.0 以降に更新します。 このバージョン設定は、AAM ツールの「一般」セクションにあります。
- 8.0 より前のAAM ツールのDIL用カスタムコードに含まれていた非推奨のメソッドや要素（
disableIDSyncsなど）については、それらをメモして（ECID ツールに追加できるように） AAM ツールのカスタムコ DIL code ドから削除します。 - Experience CloudID サービス拡張機能をバージョン 3.3.0 以降に更新します
- AAM ツールのカスタムコードから削除した ECID ツールに詳細オプションを追加します。
- 変更内容をPublish
AdobeのTag Management ソリューションを使用しないDIL 8.0 への更新 additional-resources
ページ上で直接コードを更新する場合は、前述のようにメソッドや要素をDILから ECID に移動する必要がある場合を除き、古い項目を新しい項目に置き換えるだけです。 その場合は、DILの場所の古いメソッドや要素を、ECID の場所の ECID メソッドや要素に置き換えるだけです。
Adobe以外のタグマネージャーについても同じことが言えます。 そのタグ管理ソリューションに古いバージョンがある場合は、次の手順に従って、そのバージョンを新しいコードに置き換えます。
-
DILライブラリを最新バージョン（8.0 以降）に更新 – 現在、公開されている場所では利用できないので、最新のDILコードをAdobe ConsultingまたはAdobeカスタマーケアから取得する必要があります。 その後、古いDILライブラリコードを新しいDILライブラリコードに置き換え、次の手順に進みます（今すぐ停止しないでください。そうしないと、問題が発生します）。
-
ECID Service をインストールするか、既存のバージョンを 3.3.0 以降に更新します。 最新のExperience CloudID サービスリリースを GitHub ページからダウンロードできます。 これに関するヘルプが必要な場合は、 ドキュメントを参照するか、Adobeコンサルタントにお問い合わせください。
-
DIL用のカスタムコードに含まれている非推奨のメソッドや要素が、ECID メソッドに移動されることを確認します。