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 タグマネージャーソリューションを使用しないDTM、Adobe Cloud Platform Launch、および実装について説明します。
概要 overview
Audience ManagerのData Integration Library （DIL） コードを使用すると、Web サイトにAAMを実装できます*。 以前のバージョンのDILを実装する場合、AdobeのExperience Cloud ID サービス（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の詳細については、メソッドの ドキュメント を参照してください。
簡単なヒント：以前に上記のいずれかの方法を使用していた場合、AAM Data SourceをData Source ID （別名「DPID」）で参照していました。 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 Cloud ID サービス拡張機能がバージョン 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）
-
変更を公開します。
Adobe DTMでのDIL 8.0へのアップデート updating-to-dil-in-adobe-dtm
- AAM ツールをバージョン 8.0以降に更新します。 このバージョン設定は、AAM ツールの「一般」セクションにあります。
- 8.0より前のAAM ツールのDIL用カスタムコードに含まれていた非推奨のメソッドやエレメント（
disableIDSyncsなど）については、（ECID ツールに追加できるように）そのメソッドをメモし、AAM ツールのカスタム DIL codeから削除します。 - Experience Cloud ID サービス拡張機能をバージョン 3.3.0以降に更新する
- AAM ツールのカスタムコードから削除したECID ツールに、詳細オプションを追加します。
- 変更を公開
Adobe Tag Management ソリューションを使用しないDIL 8.0へのアップデート additional-resources
ページ上で直接コードを更新する場合は、上記のようにDILからECIDにメソッド/エレメントを移動する必要がある場合を除いて、古いアイテムを新しいアイテムに置き換えるだけです。 この場合は、DILの場所の古いmethod/elementを、ECIDの場所のECID method/elementに置き換えるだけです。
Adobeのタグ管理者以外の場合も同様です。 そのタグ管理ソリューションの古いバージョンがある場合は、次の手順に従って、そのバージョンを新しいコードに置き換えます。
-
DIL ライブラリを最新バージョン（8.0以上）に更新する – 現在、公開場所では利用できないため、最新のDIL コードをAdobe ConsultingまたはAdobe カスタマーケアから取得する必要があります。 次に、古いDILライブラリコードを新しいDILライブラリコードに置き換え、次のステップに進みます（今すぐ停止しないでください。または、問題が発生します）。
-
ECID Serviceをインストールするか、既存のバージョンを3.3.0以降に更新してください。 最新のExperience Cloud ID サービス リリース は、GitHub ページ からダウンロードできます。 この問題についてサポートが必要な場合は、 ドキュメント を参照するか、Adobe コンサルタントにお問い合わせください。
-
DILのカスタムコードに含まれている非推奨のメソッドまたはエレメントが、ECID メソッドに移動されていることを確認します。