Adobe Audience ManagerDILバージョン 8.0(またはそれ以降)への更新

この記事では、Adobe Audience Manager(AAM) の更新に関する手順と推奨事項を説明します Data Integration Library (DIL) コードをバージョン 8.0 以降に追加しました。 これは、Adobe Analyticsデータのサーバー側転送ではなく、「クライアント側」DILの実装を指し、Adobeタグマネージャーソリューションを使用しない DTM、Launch by Adobe、実装について説明します。

概要

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を実装するサーバー側転送方法を使用する必要があります。 このメソッドについては、 ドキュメント.

重複要素および非推奨要素およびメソッド

以前のバージョンのDILおよび ECID には、重複するメソッド (DILと ECID の両方で同じ機能を実行するメソッド ) があったので、どちらを使用するかに関する混乱が生じていました。 通常は、両方を使用してマッチさせる必要があり、そのメッセージはお客様にうまく伝えられませんでした。 DIL8.0 以降、これらの重複メソッドおよび要素はDILで非推奨となりました。ECID バージョンを使用することをお勧めします。

例:

  • を使用する場合 DIL.createの場合、一部の要素は非推奨となり、代わりに ECID 要素を使用する必要があります。 これらの要素は、 DIL.create ドキュメント.
  • この idSync インスタンスレベルのメソッドも、メソッドの ドキュメント.

顧客 ID との 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 に更新しました。

DIL8.0 への更新の基本手順

  1. 8.0 より前のDILを使用している場合は、アップグレードする前にAAM拡張機能のDIL設定に移動し、使用している高度なオプション(後の手順で使用)を控えておきます。

  2. AAM拡張機能をバージョン 8.0 以降に更新します。

  3. Experience CloudID サービス拡張機能がバージョン 3.3.0 以降であることを確認します。

  4. 非推奨 ( 例: disableIDSyncs) が 8.0 より前のAAM拡張機能にあった場合、またはDIL用のカスタムコードにある場合は、ECID 拡張で ECID メソッドを有効にします。

    1. (DIL) disableDestinationPublishingIframe -> (ECID) disableIdSyncs
    2. (DIL) disableIDSyncs -> (ECID) disableIdSyncs
    3. (DIL) iframeAkamaiHTTPS -> (ECID) dSyncSSLUseAkamai
    4. (DIL) declaredId -> (ECID) setCustomerIDs
  5. 変更を公開します。

AdobeDTM のDIL8.0 への更新

  1. AAMツールをバージョン 8.0 以降に更新します。 このバージョン設定は、AAMツールの「一般」セクションにあります。
  2. 非推奨 ( 例: disableIDSyncs) が 8.0 より前のAAMツールのDIL用カスタムコードに含まれていた場合、それらをメモしておき(ECID ツールに追加できるように)、カスタムから削除します。 DIL code をAAMツールに追加します。
  3. Experience CloudID サービス拡張機能をバージョン 3.3.0 以降に更新します。
  4. AAMツールのカスタムコードから削除した ECID ツールに詳細オプションを追加します。
  5. 変更を公開

DIL8.0 への更新 (AdobeなしTag Managementソリューション )

ページ上でコードを直接更新する場合は、前述のように、メソッドや要素をDILから ECID に移動する必要がある場合を除き、古い項目を新しい項目に置き換えるだけです。 その場合は、DILーの場所にある古いメソッドまたは要素を、ECID の場所にある ECID のメソッドまたは要素に置き換えます。

同じことが、非Adobeのタグ管理者にも当てはまります。 そのタグ管理ソリューションに古いバージョンがある場合は、次の手順に従って、それを新しいコードに置き換えます。

  1. DILライブラリを最新DIL(8.0 以降)に更新します — 現在、公共の場所では利用できないので、AdobeコンサルティングまたはAdobeカスタマーケアから最新のバージョンコードを入手する必要があります。 次に、古いDILライブラリコードを新しいDILライブラリコードに置き換え、次の手順に進みます(今すぐ停止しないでください。問題が発生する場合は、ha)。

  2. インストール ECID Service または、既存のバージョンを 3.3.0 以降に更新します。 最新のExperience CloudID サービスリリースをダウンロードできます アドビの GitHub ページから. 詳しくは、 ドキュメント または、Adobeコンサルタントにお問い合わせください。

  3. カスタムコード内のDIL用の廃止されたメソッドまたは要素が、ECID メソッドに移動されたことを確認します。

    1. (DIL) disableDestinationPublishingIframe -> (ECID) disableIdSyncs

      ドキュメント

    2. (DIL) disableIDSyncs -> (ECID) disableIdSyncs

      ドキュメント

    3. (DIL) iframeAkamaiHTTPS -> (ECID) idSyncSSLUseAkamai

      ドキュメント

    4. (DIL) declaredId -> (ECID) setCustomerIDs

      ドキュメント

このページ