V2関数をV3ランタイムに移行する

V3とV2関数の違い

V3ランタイムを使用するイベントと訪問関数は、以下のようにV2関数と異なります：

パラメータと名前付きエクスポート – 入力データはパラメータとして提供され、名前付きエクスポートではありません。
- イベント関数にはeventとhelperの2つのパラメータがあります。
- 訪問関数にはvisitor、visit、helperの3つのパラメータがあります。
ヘルパー関数 – helperオブジェクトは、認証トークンIDを取得したり、グローバル変数を取得するために使用されます。
- auth.get()はhelper.getAuth()に置き換えられました。
- store.get()はhelper.getGlobalVariable()に置き換えられました。
イベントの収集
- tealium.sendCollectEvent()はtrack()に置き換えられ、名前付きパラメータを使用します。

データ変換関数はTransformation V0ランタイムを使用し、V3ランタイムのリリースによって影響を受けません。

V2関数の例

以下のコード例は、収集エンドポイントにイベントを送信するV2イベント関数と、このイベント関数のV3バージョンを示しています。

import { event, tealium } from "tealium";
(async () => {
    const searchQuery = new URLSearchParams({ path: event.data.dom.pathname, query: event.data.dom.search_query });
    
    const newEvent = await fetch(`https://getnew.event.com?${searchQuery}`)
        .then(response => {
            if (!response.ok) {
                throw new Error(`Network response was not ok. Status code: ${response.status}.`);
            }
            return response.json();
        });
    
    tealium.sendCollectEvent(
        newEvent,
        event.account,
        event.profile,
        'abc123')
        .then(response => {
            if(!response.ok){
                throw new Error(`Network response was not ok. Status code: ${response.status}.`);
            }
            return response.text();
        })
        .then(data => console.log('Result : ', data))
        .catch(error => console.error('Error:', error.message));
})();

activate(async ({ event }) => {  
    const searchQuery = new URLSearchParams({ path: event.data.dom.pathname, query: event.data.dom.search_query });
        
    const newEvent = await fetch(`https://getnew.event.com?${searchQuery}`)
        .then(response => {
            if (!response.ok) {
                throw new Error(`Network response was not ok. Status code: ${response.status}.`);
            }
            return response.json();
        });
        
    track(newEvent, {
        tealium_account: event.account,
        tealium_profile: event.profile,
        tealium_datasource: 'abc123'
        })
        .then(response => {
            if(!response.ok){
                throw new Error(`Network response was not ok. Status code: ${response.status}.`);
            }
            return response.text();
        })
        .then(data => console.log('Result : ', data))
        .catch(error => console.error('Error:', error.message));
})();

V3関数を作成する

イベントまたは訪問関数をV3に移行するには、移行する関数のタイプに応じてV3イベントまたは訪問関数を作成します。詳細については、関数を作成するを参照してください。次に、次のことを行います：

コードエディタでV3関数のデフォルトコードをすべて削除し、次のイベントまたは訪問コードを追加します。これは空の関数です。次のステップで関数コードを追加し、コードを変更します。
activate(async ({ event }) => { });
activate(async ({ visitor, visit }) => { });
V2関数のコードを、以下に示す関数の最初の行の後からコピーします：
```
(async (event, helper) => {
```
そして、関数の最後の行の上で終了します：
```
})();
```
コピーしたコードを空のV3関数に貼り付けます。activate行と終了行});の間です。

関数コードを更新する

関数がライブラリやヘルパー関数を使用している場合、またはTealium Collectにイベントを送信している場合、空の関数にコピーされたコードは、以下のセクションで説明するように変更する必要があります。

Tealium Collectにイベントを送信する

例の関数はtealium.sendCollectEvent()を使用しています。この呼び出しはtrack()呼び出しに置き換える必要があります。以下の例は、V2のtealium.sendCollectEvent()呼び出しとV3のtrack()呼び出しを示しています。

import { event, tealium } from 'tealium';

(async () => {
    const newEvent = { data: event.data.udo };

    tealium.sendCollectEvent(newEvent,
        event.account,
        event.profile,
        'abc123')
    ...
})();

activate(({ event }) => {
    const newEvent = { data: event.data.udo };

    track(newEvent, {
        tealium_account: event.account,
        tealium_profile: event.profile,
        tealium_datasource: 'abc123'
    })
    ...
})

track()呼び出しでは、'abc123'をデータソースキーに置き換えます。

ライブラリの使用

V2関数がライブラリ、例えばCrytpoESを使用している場合、activate行の前にインポート行を追加します。

import { event, tealium } from "tealium";
import CryptoES from 'crypto-es';
...

import CryptoES from 'crypto-es';
activate(async ({ event, helper }) => {  
    ...
});

認証トークンとグローバル変数

V2関数が認証トークンまたはグローバル変数を使用している場合、V3関数のactivate行にhelperを関数パラメータに追加します。例えば：

activate(async ({ event, helper }) => {
});

V2コード内のauth.get()のすべてのインスタンスをhelper.getAuth()に置き換えます。例えば：

import { auth } from 'tealium';

const token = auth.get("myAuthToken");

activate(({event, helper }) => {
    const token = helper.getAuth("myAuthToken");
})

認証トークンはHTTPリクエスト内の関数によってのみ参照できます。HTTPリクエストの外でトークンを参照しようとすると、トークンはUUIDプレースホルダーに置き換えられます。

store.get()のすべてのインスタンスをhelper.getGlobalVariable()に置き換えます。例えば：

import {store } from 'tealium';

const gVar = store.get("myGlobalVar");

activate(({event, helper }) => {    
    const gVar = helper.getGlobalVariable("myGlobalVar");
})