Web SDKへのカスタムコードの移行

最終更新日： 2025年1月14日
  • トピック：

作成対象：

  • 中級
  • 経験者
  • 開発者

この演習では、Adobe Analytics拡張機能からExperience PlatformタグのAdobe Experience Platform Web SDK拡張機能にカスタムコードを移行する方法を説明します。

重大な免責事項

コードを操作する最適で最も簡単で最も効果的な方法を説明するドキュメントにこのような内容を追加するのであれば、ご安心ください。 コードの記述、編集、処理には、明らかに様々な方法があります。 この演習では、既存のルール内のコードを簡単に取得してコピーし、変更を追加して、移行したルールで機能させる方法を提供します。 より良い使い方を考えれば、素晴らしいことです。それを使ってもらえるだけでなく、Experience Leagueコミュニティ（特にこのチュートリアルに関するコミュニティの投稿）で、私たちや同業者と共有できることを歓迎します。 実装プラグインを操作するページの下半分についても同じことが言えます。 私がここに道を提案しましょう、そしてあなたはあなたに気分が良いことをします。 それでは、詳しく見ていきましょう。

IMPORTANT
最後の段落の考え方では、Web SDKに移行する際にこの機会を利用して、コードをよく見て、コードが更新または削除される必要があるかどうかを確認することもお勧めします。 以下の段落と手順では、コードの移行方法を確認できます。すべてを 1 回で動かすのが簡単であっても、春のクリーニングをお勧めしないことをお勧めします。

どのコードを移行しますか？

この節で最初に取り上げるコードは、「変数を設定 アクションを含むすべてのAdobe Analyticsアクションの「カスタムコード」ウィンドウに表示されるコード す。 つまり、ルールの 1 つを開き、「アクション」セクションを見下ろします。 「Adobe Analytics – 変数を設定」アクションがある場合は、クリックして開きます。

変数を設定コード

次に、右下にスクロールすると、カスタムコードウィンドウの「エディターを開く」ボタンが表示されます。 クリックして開きます。

カスタムコードエディターを開く

コードが含まれている場合は、Web SDKでコードを実行してAdobe Analyticsに送信できるように、移行する必要があります。
ここでの主な考え方は、「s」オブジェクトを「コンテンツ」に変換するということです。__adobe.analytics」に、

Web SDKで理解および処理できるように、s オブジェクトに対する最初の呼び出しの前にコードを追加するだけです。 新しく変更したコードを追加する場所は、「Adobe Experience Platform Web SDK – 変数を更新」アクションの「カスタムコード」ウィンドウにあります。

例えば、カスタムコードウィンドウに次のコードブロックがあるとします。

const products = window.digitalData.products;
const productIndex = event.element.dataset.productIndex;
const product = products[productIndex];
s.products = [
product.cat3Tag,
product.id,
1,
product.price
].join(";");

含める必要があるコードは次のとおりです。

content.__adobe = content.__adobe || {};
content.__adobe.analytics = content.__adobe.analytics || {};
const s = content.__adobe.analytics;

そのため、次の手順に従ってカスタムコードを移行します。

  1. 「Adobe Analytics変数を設定」アクションのウィンドウからカスタムコードをコピーします。

  2. そのコードウィンドウを閉じ、アクションを閉じる（キャンセルアウトする）ことができます。

  3. 「Web SDK – 変数を更新」アクションをクリックして開きます（まだ追加していない場合は追加します）。

    変数の更新アクションを開く

  4. 右側のウィンドウの上部にある Analytics オブジェクトを選択します

    Analytics オブジェクトの選択

  5. 一番下までスクロールし、カスタムコード ウィンドウを開きます

    sdk カスタムコードウィンドウを開きます 。

  6. Analytics カスタムコードウィンドウから取り込んだコードを貼り付けます。

  7. 次に、以下の例のように、新しいコード行を既存のコードの中央に配置して、s オブジェクトの最初のメンションの上になるようにします。

新規 s コード

これで、「カスタムコード」ウィンドウでコードを保存して、「変数を更新」アクションの変更を維持できます。 また、ルールを保存して、作業ライブラリで新しい変更を公開する必要もあります。