Adobe Audience ManagerDILバージョン 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タグマネージャーソリューションを使用しない 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 を使用せずにDIL8.0 以降を実装した場合、または以前のバージョンを使用している場合、エラーが表示され、機能しません。 AAMの実装には複数の方法があるので、手順を説明するためにこのページを作成し、推奨事項もいくつか示します。 以下に、これらの手順と推奨事項を、プラットフォーム/実装方法別に示します。 DILの詳細については、 ドキュメント.
- このページの説明に記載されているように、これは、Adobe Analyticsを持たないAAMのお客様が使用する、「クライアント側」のDIL実装のみをカバーします。 Adobe Analyticsを使用している場合、AAMを実装するサーバー側転送方法を使用する必要があります。 このメソッドについては、 ドキュメント.
重複要素および非推奨要素およびメソッド duplicate-and-deprecated-elements-and-methods
以前のバージョンのDILおよび ECID には、重複するメソッド (DILと ECID の両方で同じ機能を実行するメソッド ) があったので、どちらを使用するかに関する混乱が生じていました。 通常は、両方を使用してマッチさせる必要があり、そのメッセージはお客様にうまく伝えられませんでした。 DIL8.0 以降、これらの重複メソッドおよび要素はDILで非推奨となりました。ECID バージョンを使用することをお勧めします。
例:
- を使用する場合 DIL.createの場合、一部の要素は非推奨となり、代わりに ECID 要素を使用する必要があります。 これらの要素は、 DIL.create ドキュメント.
- この idSync インスタンスレベルのメソッドも、メソッドの ドキュメント.
顧客 ID との ID 同期 id-syncing-with-a-customer-id
AAMでは、マシン上の UUID(匿名の一意のユーザー ID)を顧客 ID と同期して、その顧客に関するオフラインデータをアップロードし、オンライン動作と結び付けて、顧客の理解を深めることができます。 これまでは、次の 2 つの方法のいずれかで行われていました。
- この idSync インスタンスレベルのメソッド
- この declaredId 要素 DIL.create
顧客 ID との同期にこれらの古い方法のいずれかを使用している場合は、 setCustomerIDs メソッド(ECID サービスの一部)を使用します。 詳細情報: setCustomerIDs はメソッドの ドキュメント.
クイックヒント: 以前に上記のいずれかのメソッドを使用している場合、AAM Data Source と Data Source ID(別名「DPID」)。 に更新する場合 setCustomerIDsAAM Data Source's "Integration Code「」という代わりに使用します。 それでも同じことを指し示しています Data Source ただ単に別の識別子に過ぎません。 これは以下のビデオで示されます。
次の節では、実装方法に基づいてDIL8.0 に更新するための手順と推奨事項を示します。
Adobe Experience PlatformタグのDIL8.0 に更新しました。 updating-to-dil-in-experience-platform-launch
DIL8.0 への更新の基本手順
-
8.0 より前のDILを使用している場合は、アップグレードする前にAAM拡張機能のDIL設定に移動し、使用している高度なオプション(後の手順で使用)を控えておきます。
-
AAM拡張機能をバージョン 8.0 以降に更新します。
-
Experience CloudID サービス拡張機能がバージョン 3.3.0 以降であることを確認します。
-
非推奨 ( 例:
disableIDSyncs
) が 8.0 より前のAAM拡張機能にあった場合、またはDIL用のカスタムコードにある場合は、ECID 拡張で ECID メソッドを有効にします。- (DIL)
disableDestinationPublishingIframe
-> (ECID)disableIdSyncs
- (DIL)
disableIDSyncs
-> (ECID)disableIdSyncs
- (DIL)
iframeAkamaiHTTPS
-> (ECID)dSyncSSLUseAkamai
- (DIL)
declaredId
-> (ECID)setCustomerIDs
- (DIL)
-
変更を公開します。
AdobeDTM のDIL8.0 への更新 updating-to-dil-in-adobe-dtm
- AAMツールをバージョン 8.0 以降に更新します。 このバージョン設定は、AAMツールの「一般」セクションにあります。
- 非推奨 ( 例:
disableIDSyncs
) が 8.0 より前のAAMツールのDIL用カスタムコードに含まれていた場合、それらをメモしておき(ECID ツールに追加できるように)、カスタムから削除します。 DIL code をAAMツールに追加します。 - Experience CloudID サービス拡張機能をバージョン 3.3.0 以降に更新します。
- AAMツールのカスタムコードから削除した ECID ツールに詳細オプションを追加します。
- 変更を公開
DIL8.0 への更新 (AdobeなしTag Managementソリューション ) additional-resources
ページ上でコードを直接更新する場合は、前述のように、メソッドや要素をDILから ECID に移動する必要がある場合を除き、古い項目を新しい項目に置き換えるだけです。 その場合は、DILーの場所にある古いメソッドまたは要素を、ECID の場所にある ECID のメソッドまたは要素に置き換えます。
同じことが、非Adobeのタグ管理者にも当てはまります。 そのタグ管理ソリューションに古いバージョンがある場合は、次の手順に従って、それを新しいコードに置き換えます。
-
DILライブラリを最新DIL(8.0 以降)に更新します — 現在、公共の場所では利用できないので、AdobeコンサルティングまたはAdobeカスタマーケアから最新のバージョンコードを入手する必要があります。 次に、古いDILライブラリコードを新しいDILライブラリコードに置き換え、次の手順に進みます(今すぐ停止しないでください。問題が発生する場合は、ha)。
-
インストール ECID Service または、既存のバージョンを 3.3.0 以降に更新します。 最新のExperience CloudID サービスリリースをダウンロードできます アドビの GitHub ページから. 詳しくは、 ドキュメント または、Adobeコンサルタントにお問い合わせください。
-
カスタムコード内のDIL用の廃止されたメソッドまたは要素が、ECID メソッドに移動されたことを確認します。