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 メソッドに移動されることを確認します。