コア拡張機能の概要

Core 拡張機能は、Adobe Experience Platform Launch でリリースされたデフォルトの拡張機能です。

このリファレンスは、この拡張機能を使用してルールを作成するときに使用できるオプションに関する情報です。

Core 拡張機能のイベントタイプ

このトピックでは、Core 拡張機能で使用できるイベントのタイプについて説明します。

複数のイベントタイプに設定できるオプションについては、オプションを参照してください。

Browser

Tab Blur

タブがフォーカスを失ったときにアクションをトリガーします。

このイベントタイプに関する設定はありません。

Tab Focus

タブがフォーカスされたときにアクションをトリガーします。

このイベントタイプに関する設定はありません。

フォーム

Blur

フォームがフォーカスを失ったときにアクションをトリガーします。

次のオプションを参照してください。

Focus

フォームがフォーカスされたときにアクションをトリガーします。

次のオプションを参照してください。

Submit

フォームが送信されたときにアクションをトリガーします。

次のオプションを参照してください。

キーボード

Key Press

キーが押されると、イベントをトリガーします。

次のオプションを参照してください。

メディア

Media Ended

メディアが終了すると、イベントをトリガーします。

次のオプションを参照してください。

Media Loaded Data

メディアがデータを読み込むと、イベントをトリガーします。

次のオプションを参照してください。

Media Pause

メディアが一時停止されると、イベントをトリガーします。

次のオプションを参照してください。

Media Play

メディアが再生されると、イベントをトリガーします。

次のオプションを参照してください。

Media Stalled

メディアが停止すると、イベントをトリガーします。

次のオプションを参照してください。

Media Time Played

メディアが一定の時間再生されると、イベントをトリガーします。

次のオプションを参照してください。

さらに、一定の時間が経過するとイベントをトリガーするように指定します。

Media Volume Changed

ボリュームが増加または減少すると、イベントをトリガーします。

次のオプションを参照してください。

モバイル

Orientation Change

デバイスの向きが変更されたら、イベントをトリガーします。

このイベントタイプに関する設定はありません。

さらに、一定の時間が経過するとイベントをトリガーするように指定します。

Zoom Change

ユーザーがズームインまたはズームアウトすると、イベントをトリガーします。

このイベントタイプに関する設定はありません。

マウス

Click

指定した要素が選択（クリック）されると、イベントをトリガーします。

オプションとして、イベントがトリガーされる前に、要素で true となる必要があるプロパティ値を指定できます。

要素がリンク（<a>タグ）の場合は、ナビゲーションを一定の期間遅らせるかどうかを指定することもできます。 これは、ルールの実行に余分な時間が必要で、通常ページナビゲーションがおこなわれる前に実行が完了しない場合に便利です。

リンク遅延を使用すると、Platform Launch はブラウザーがページ外に移動するのを防ぎ、指定されたタイムアウト後に元の宛先への JavaScript リダイレクトを実行します。これは、ページのマークアップに <a> タグがあり、意図したとおりに機能しても実際にはユーザーがページから移動しない場合は特に危険です。 問題を他の方法で解決できない場合は、セレクターの定義を正確に指定して、このイベントが必要な場所でのみトリガーするようにしてください。

デフォルトのリンク遅延値は 100 ミリ秒です。 Platform Launch は常に指定の時間待機し、ルールのアクションの実行には一切関与しないことに注意してください。 遅延のせいでユーザーの待機時間が必要以上に長くなる可能性があります。また、逆に、遅延が十分に長くないためルールの必ずしもすべてのアクションが正常に完了することができない可能性もあります。遅延が長くなると、ルールの実行にかかる時間が長くなるだけでなく、ユーザーエクスペリエンスも低下します。

さらに、一定の時間が経過するとイベントをトリガーするように指定します。

高度なオプションについては、次のオプションを参照してください。

Hover

指定した要素にユーザーがマウスポインターを置くと、イベントをトリガーします。

次のオプションを参照してください。

また、ルールがすぐにトリガーされるか、指定した時間（ミリ秒）が経過した後でルールがトリガーされるかを設定します。

その他

Custom Event

カスタムイベントタイプが発生すると、イベントをトリガーします。

他の場所で定義した JavaScript 関数に名前を付けて、イベントに使用することができます。

カスタムイベントタイプの名前を指定し、次のオプションで説明するように、その他の設定をおこないます。

Data Element Changed

指定したデータ要素が変更されると、イベントをトリガーします。

データ要素名を入力します。リストからデータ要素を選択するには、アイコンを選択してからデータ要素を選択します。

Direct Call

イベント検出およびルックアップシステムをバイパスするために設計されました。

Direct Call ルールは、Platform Launchに対して、何がおこなわれるかを正確に伝えたい場合に最適です。また、Adobe Flash を使用しているなど、Platform Launch が DOM でイベントを検出できない場合にも最適です。

_satellite.track 文字列を指定します。

Element Exists

指定した要素が存在する場合は、イベントをトリガーします。

次のオプションを参照してください。

Enters Viewport

ユーザーが指定したビューポートに入ると、イベントをトリガーします。

次のオプションを参照してください。

また、ルールがすぐにトリガーされるか、指定した時間（ミリ秒）が経過した後でルールがトリガーされるかを設定します。

History Change

pushState または hashchange が発生すると、イベントをトリガーします。

このイベントタイプに関する設定はありません。

Time Spent on Page

ユーザーが指定した秒数の間ページに留まると、イベントをトリガーします。

イベントがトリガーされるまでに経過する必要がある時間（秒数）を指定します。

ページ読み込み

DOM Ready

DOM の準備が完了し、ユーザーがページを操作できるようになるとトリガーします。

このイベントタイプに関する設定はありません。

Library Loaded（Page Top）

Platform Launch ライブラリが読み込まれ次第、イベントをトリガーします。

このイベントタイプに関する設定はありません。

Page Bottom

_satellite.pageBottom(); が呼び出されたら、イベントを実行します。Platform Launch ライブラリを非同期で読み込む場合、このイベントタイプは使用しないでください。

このイベントタイプに関する設定はありません。

Window Loaded

onLoad がブラウザーによって呼び出され、ページの読み込みが完了すると、イベントをトリガーします。

このイベントタイプに関する設定はありません。

オプション

各フォームイベントタイプでは、次の設定を使用します。

Specific Elements | Any Element

• Specific Elements を選択すると、要素とプロパティの値を選択するオプションが表示されます。
• Any Element を選択した場合、要素を絞り込むための追加オプションはありません。

Elements matching the CSS selector

イベントをトリガーする要素を識別する CSS セレクターを入力します。

And having certain property values

このオプションを選択すると、次のパラメーターを使用できるようになります。

• property=value

  Specify the value for the property

• Regex

  property=value が正規表現の場合は有効にします。

• Add

  別の property=value ペアを追加します。

Advanced options (Bubbling)

• イベントが子孫要素から開始した場合でも、このルールを実行します
• 既に子孫要素をターゲットとしているルールがトリガーされている場合でも、このルールを実行できます
• ルールが実行された後に、親要素のターゲティングルールをトリガーしないようにしてください

Core 拡張機能の条件のタイプ

ここでは、Core 拡張機能で使用できる条件のタイプについて説明します。これらの条件タイプは、標準ロジックと例外ロジックのどちらででも使用できます。

データ

Cookie

アクションをトリガーするためにイベントで使用する必要がある cookie の名前と値を指定します。

1. Cookie 名を指定します。
2. イベントでアクションをトリガーする場合に、cookie に存在している必要がある値を入力します。
3. （オプション）正規表現の場合は、正規表現を有効にします。

カスタムコード

イベントの条件として使用する必要があるカスタムコードを指定します。組み込みコードエディターを使用してカスタムコードを入力します。

1. Open Editor を選択します。
2. カスタムコードを入力します。
3. Save を選択します。

カスタムコード内から参照できる event という名前の変数が自動的に使用可能になります。この event オブジェクトには、ルールをトリガーしたイベントに関する便利な情報が含まれます。どのイベントを使用できるかを判断する最も簡単な方法として、カスタムコード内からコンソールに event を記録します。

console.log(event);
return true;

ブラウザーでルールを実行し、ブラウザーのコンソールでログに記録されたイベントオブジェクトを調べます。利用可能な情報を把握したら、その情報をカスタムコード内でプログラム判定に使用できます。

条件の順序付け

プロパティ設定の「Run rule components in sequence」オプションを有効にすると、条件によって非同期タスクが実行される間、後続のルールコンポーネントを待機させることができます。

条件によって Promise が返される場合、ルール内の次の条件は、返されたプロミスが解決されるまで実行されません。プロミスが拒否された場合、Platform Launch はその条件を失敗と見なし、そのルールからのそれ以上の条件やアクションは実行されません。

プロミスを返す条件の例を次に示します。

return new Promise(function(resolve, reject) {
  setTimeout(function() {
    if (new Date().getDay() === 5) {
      resolve();
    } else {
      reject();
    }
  }, 1000);
});

Value Comparison

2 つの値を比較して、この条件が true を返すかどうかを判断します。

複数の条件を持つルールがある場合、この条件で true が返されても、他の条件が false と評価されるか、いずれかの例外が true と評価されて、ルールが実行されない可能性があります。

1. 値を指定します。
2. 演算子を選択します。詳細については、次の値比較演算子のリストを参照してください。
3. （必要な場合）比較で大文字と小文字を区別するかどうかを選択します。
4. 比較用に別の値を指定します。

次の値比較演算子を使用できます。

Equal：​厳密でない比較を使用して 2 つの値が等しい場合（JavaScript では == 演算子）、true を返します。値には任意のタイプを指定できます。値フィールドに true、false、null​または undefined などの単語を入力すると、その単語は文字列として比較され、同等の JavaScript には変換されません。

Does Not Equal：​厳密でない比較で 2 つの値が等しくない場合（JavaScript では= 演算子）、条件は true を返します。値には任意のタイプを指定できます。値フィールドに true、false、null​または undefined などの単語を入力すると、その単語は文字列として比較され、同等の JavaScript には変換されません。

Contains：​最初の値に 2 番目の値が含まれている場合、条件は true を返します。数値は文字列に変換されます。数値または文字列以外の値を指定すると、条件は false を返します。

Does Not Contain：​最初の値に 2 番目の値が含まれていない場合、条件は true を返します。数値は文字列に変換されます。数字または文字列以外の値を指定すると、条件は true を返します。

Starts With：​最初の値が 2 番目の値で開始する場合、条件は true を返します。数値は文字列に変換されます。数値または文字列以外の値を指定すると、条件は false を返します。

Does Not Start With：​最初の値が 2 番目の値で始まらない場合、条件は true を返します。数値は文字列に変換されます。数値または文字列以外の値を指定すると、条件は true を返します。

Ends With：​最初の値が 2 番目の値で終わる場合、条件は true を返します。数値は文字列に変換されます。数値または文字列以外の値を指定すると、条件は false を返します。

Does Not End With：​最初の値が 2 番目の値で終わらない場合、条件は true を返します。数値は文字列に変換されます。数値または文字列以外の値を指定すると、条件は true を返します。

Matches Regex：​最初の値が正規表現と一致する場合、条件は true を返します。数値は文字列に変換されます。数値または文字列以外の値を指定すると、条件は false を返します。

Does Not Match Regex：​最初の値が正規表現と一致しない場合、条件は true を返します。数値は文字列に変換されます。数値または文字列以外の値を指定すると、条件は true を返します。

Is Less Than：​最初の値が 2 番目の値より小さい場合、条件は true を返します。数字を表す文字列は数値に変換されます。数値または変換可能な文字列以外の値を指定すると、条件は false を返します。

Is Less Than Or Equal To：​最初の値が 2 番目の値以下の場合、条件は true を返します。数字を表す文字列は数値に変換されます。数値または変換可能な文字列以外の値を指定すると、条件は false を返します。

Is Greater Than：​最初の値が 2 番目の値以上の場合、条件は true を返します。数字を表す文字列は数値に変換されます。数値または変換可能な文字列以外の値を指定すると、条件は false を返します。

Is Greater Than Or Equal To：​最初の値が 2 番目の値以上の場合、条件は true を返します。数字を表す文字列は数値に変換されます。数値または変換可能な文字列以外の値を指定すると、条件は false を返します。

Is True：​値が true のブール値の場合、条件は true を返します。他のタイプの場合、指定した値はブール値に変換されません。値が true のブール値以外の値を指定すると、条件は false を返します。

Is Truthy：​ブール値に変換した後、値が true の場合、条件は true を返します。Truthy な値の例については、MDN の Truthy に関するドキュメントを参照してください。

Is False：​値が false のブール値の場合、条件は true を返します。他のタイプの場合、指定した値はブール値に変換されません。値が false のブール値以外の値を指定すると、条件は false を返します。

Is Falsy：​ブール値に変換した後、値が false の場合は、条件は true を返します。Falsy な値の例については、MDN の Falsy に関するドキュメントを参照してください。

Variable

アクションをトリガーするためにイベントで使用する必要がある JavaScript変数名と値を指定します。

1. JavaScript 変数名を指定します。
2. イベントの条件に必要な変数値を指定します。
3. （オプション）正規表現の場合は、正規表現を有効にします。

Engagement

Landing Page

イベントをトリガーするためにユーザーがランディングする必要があるページを指定します。

1. ランディングページを指定します。
2. （オプション）正規表現の場合は、正規表現を有効にします。

New/Returning Visitor

アクションをトリガーするには、訪問者がイベントの新規訪問者または再訪問者である必要があるかどうかを指定します。

次のいずれかを選択します。

• New Visitor
• Returning Visitor

Page Views

アクションがトリガーされる前に訪問者がページを何回表示する必要があるかを設定します。

1. ページビュー数を、指定した値より大きい、指定した値と等しい、または指定した値未満のどれにする必要があるかを選択します。
2. 条件が満たされているかどうかを判断するページビュー数を指定します。
3. 次のいずれかを選択して、ページビューをカウントするタイミングを設定します。
   • Lifetime
   • Current Session

Sessions

ユーザーのセッション数が指定した条件を満たす場合、アクションをトリガーします。

1. セッション数を、指定した値より大きい、指定した値と等しい、または指定した値未満のどれにするかを選択します。
2. 条件が満たされているかどうかを判断するセッション数を指定します。

Time On Site

ユーザーのセッション数が指定した条件を満たす場合、アクションをトリガーします。

訪問者がどの程度の時間サイトに滞在したらアクションをトリガーするかを設定します。

1. 訪問者がサイトに滞在している時間（分）を、指定した値より大きい、指定した値と等しい、または指定した値未満のどれにする必要があるかを選択します。
2. 条件が満たされているかどうかを判断する時間（分）を指定します。

Traffic Source

ユーザーのセッション数が指定した条件を満たす場合、アクションをトリガーします。

アクションをトリガーするために、true となっている必要がある訪問者のトラフィックのソースを指定します。

1. トラフィックソースを指定します。
2. （オプション）正規表現の場合は、正規表現を有効にします。

技術

Browser

アクションをトリガーするために、訪問者が使用する必要があるブラウザーを選択します。

次のブラウザーを 1 つ以上選択します。

• Chrome
• Firefox
• Internet Explorer/Edge
• Internet Explorer Mobile
• Mobile Safari
• OmniWeb
• Opera
• Opera Mini
• Opera Mobile
• Safari

Device Type

アクションをトリガーするために、訪問者が使用する必要があるデバイスのタイプを選択します。

次のデバイスタイプを 1 つ以上選択します。

• Android
• BlackBerry
• Desktop
• iPad
• iPhone
• iPod
• Nokia
• Windows Phone

Operating System

アクションをトリガーするために、訪問者が使用する必要があるオペレーティングシステムを選択します。

次のオペレーティングシステムを 1 つ以上選択します。

• Android
• BlackBerry
• iOS
• Linux
• MacOS
• Maemo
• Symbian OS
• Unix
• Windows

Screen Resolution

アクションをトリガーするために、訪問者がデバイスで使用する必要がある画面解像度を選択します。

1. 画面解像度の幅を、指定した値より大きい、指定した値と等しい、または指定した値未満のどれにするかを選択します。
2. 画面解像度の幅に必要なピクセル数を指定します。
3. 画面解像度の高さを、指定した値より大きい、指定した値と等しい、または指定した値未満のどれにするかを選択します。
4. 画面解像度の高さに必要なピクセル数を指定します。

Window Size

アクションをトリガーするために、訪問者がデバイスで使用する必要があるウィンドウサイズを選択します。

1. ウィンドウサイズの幅を、指定した値より大きい、指定した値と等しい、または指定した値未満のどれにするかを選択します。
2. ウィンドウサイズの幅に必要なピクセル数を指定します。
3. ウィンドウサイズの高さを、指定した値より大きい、指定した値と等しい、または指定した値未満のどれにするかを選択します。
4. ウィンドウサイズの高さに必要なピクセル数を指定します。

URL

Domain

訪問者のドメインを指定します。

Hash

URL に必要な 1 つ以上のハッシュパターンを指定します。

1. ハッシュパターンを指定します。
2. （オプション）正規表現の場合は、正規表現を有効にします。
3. その他のハッシュパターンを追加します。

Path And Query String

URL に存在する必要がある 1 つ以上のパスを指定します。パスとクエリー文字列が含まれます。

1. パスを指定します。
2. （オプション）正規表現の場合は、正規表現を有効にします。
3. 他のパスを追加します。

Path Without Query String

URL に存在する必要がある 1 つ以上のパスを指定します。これにはパスが含まれますが、クエリー文字列は含まれません。

1. パスを指定します。
2. （オプション）正規表現の場合は、正規表現を有効にします。
3. 他のパスを追加します。

Protocol

URL で使用するプロトコルを指定します。

次のいずれかを選択します。

• HTTP
• HTTPS

クエリー文字列パラメーター

URL で使用する URLパラメーターを指定します。

1. URL パラメーター名を指定します。
2. URL パラメーターに使用する値を指定します。
3. （オプション）正規表現の場合は、正規表現を有効にします。

Subdomain

URL に存在する 1 つまたは複数のサブドメインを指定します。

1. サブドメインを指定します。
2. （オプション）正規表現の場合は、正規表現を有効にします。
3. 他のサブドメインを追加します。

その他

Date Range

日付範囲を指定します。イベントが発生する前または後の日時、タイムゾーンを選択します。

Max Frequency

条件が true を返す最大回数を指定します。選択できる項目は次のとおりです。

• Page view
• Sessions
• Visitor
• Seconds
• Minutes
• Days
• Weeks
• Months

条件の最大頻度 1 セッションあたり、これら 2 つの localStorage 項目が比較されます。 visitorTracking.sessionCount が maxFrequency.session カウントより大きい場合、サンプリング条件は true です。 これらが等しい場合、条件は false です。

sessionCount が visitorTracking 項目である場合は、訪問者 API を有効にして、サンプリング条件が機能するようにする必要があります。

Sampling

条件が true を返す時間のパーセンテージを指定します。

Core 拡張機能のアクションタイプ

ここでは、Core 拡張機能で使用できるアクションタイプについて説明します。

カスタムコード

イベントのトリガー後に実行して条件を評価するコードを提供します。

1. アクションコードに名前を付けます。
2. アクションの定義に使用する言語を選択します。
   • JavaScript
   • HTML
3. アクションコードをグローバルに実行するかどうかを選択します。
4. Open Editor を選択します。
5. コードを編集して、「Save」を選択します。

言語として「JavaScript」を選択すると、カスタムコード内から参照できる event という名前の変数が自動的に使用可能になります。この event オブジェクトには、ルールをトリガーしたイベントに関する便利な情報が含まれます。どのイベントを使用できるかを判断する最も簡単な方法として、カスタムコード内からコンソールに event を記録します。

console.log(event);

ブラウザーでルールを実行し、ブラウザーのコンソールでログに記録されたイベントオブジェクトを調べます。利用可能な情報を把握したら、カスタムコード内でその情報をプログラム判定に使用したり、event オブジェクトの一部をサーバーに送信したりできます。

「Custom Code」アクションの処理

Core 拡張機能は、すべての Platform Launch ユーザーが使用でき、ユーザー指定の JavaScript または HTML を実行するためのカスタムコードアクションが含まれています。「Custom Code」アクションを使用するルールの処理方法を理解すると便利です。

「Page Top」または「Page Bottom」イベントを使用するルール

カスタムアクションからのコードは、メイン Platform Launch ライブラリに埋め込まれます。コードは、document.write を使用してドキュメントに書き込まれます。ルールに複数のカスタムコードアクションがある場合、コードはルール内で設定されている順序で記述されます。

Page Top または Page Bottom 以外のイベントを使用するルール

カスタムアクションのコードはサーバーから読み込まれ、Postscribe を使用してドキュメントに書き込まれます。ルールに複数のカスタムコードアクションがある場合、コードはサーバーから平行して読み込まれますが、ルール内で設定されている順序で記述されます。

ページの読み込み後に document.write を使用すると、通常は問題が発生しますが、これはカスタムコードアクションによって提供されるコードの場合は問題になりません。コードを実行するタイミングに関係なく、カスタムコードアクション内で document.write を使用できます。

カスタムコードの検証

Platform Launch コードエディターで使用されるバリデーターは、開発者が作成したコードの問題を識別するように作られています。縮小処理をおこなったコード（コードマネージャーからダウンロードした AppMeasurement.js コードなど）は、バリデーターによって、誤って「問題あり」とフラグ付けされることがありますが、通常は無視できます。

アクションの順序付け

プロパティ設定の「Run rule components in sequence」オプションを有効にすると、アクションによって非同期タスクが実行される間、後続のルールコンポーネントを待機させることができます。JavaScript と HTML カスタムコードでは、動作は異なります。

JavaScript

JavaScript のカスタムコードアクションを作成する場合、アクションから Promise を返すことがあります。ルール内の次のアクションは、返されたプロミスが解決された場合にのみ実行されます。プロミスが拒否された場合、ルールの次のアクションは実行されません。

メモ：これは、JavaScript がグローバルに実行されないよう設定されている場合にのみ機能します。グローバルスコープでカスタムコードアクションを実行している場合、Platform Launch はプロミスが直ちに解決されたものと見なし、処理キュー内の次の項目に移動します。

プロミスを返す JavaScript カスタムコードアクションの例を次に示します。

return new Promise(function(resolve, reject) {
  setTimeout(function() {
    if (new Date().getDay() === 5) {
      resolve();
    } else {
      reject();
    }
  }, 1000);
});

HTML

HTML のカスタムコードアクションを作成する場合、onCustomCodeSuccess() という関数をカスタムコード内で使用することができます。この関数を呼び出して、カスタムコードが完了し、Platform Launch が以降のアクションの実行に進むことができると示すことができます。一方、カスタムコードが何らかの方法で失敗した場合は、onCustomCodeFailure() を呼び出すことができます。これにより、そのルールから後続のアクションを実行しないように Platform Launch に通知します。

新しいコールバックを使用する HTML カスタムコードアクションの例を次に示します。

<script>
setTimeout(function() {
  if (new Date().getDay() === 5) {
    onCustomCodeSuccess();
  } else {
    onCustomCodeFailure();
  }
}, 1000);
</script>

Core 拡張機能データ要素のタイプ

データ要素のタイプは、拡張機能によって決まります。タイプはいくつでも作成することができます。

以降の節では、Core 拡張機能で使用できるデータ要素のタイプについて説明します。その他の拡張機能は、他のタイプのデータ要素を使用します。

Cookie

使用可能なドメイン cookie は、「cookie name」フィールドで参照できます。

例：

cookieName

定数

アクションまたは条件で参照できる任意の定数文字列値。

例：

string

カスタムコード

カスタム JavaScript を UI に入力するには、「エディターを開く」を選択してエディターウィンドウにコードを挿入します。

データ要素の値として使用する値を示すために、エディターウィンドウで return ステートメントを記述する必要があります。return ステートメントが含まれていない場合や、値 null または undefined が返された場合は、データ要素のデフォルト値がデータ要素の値として使用されます。

例：

var pageType = $('div.page-wrapper').attr('class').split('')[1];
if (window.location.pathname == '/') {
  return 'homepage';
} else {
  return pageType;
}

カスタムコードデータ要素がルールの実行中に取得される場合、カスタムコード内から参照できる event という名前の変数が自動的に使用可能になります。この event オブジェクトには、ルールをトリガーしたイベントに関する便利な情報が含まれます。どのイベントを使用できるかを判断する最も簡単な方法として、カスタムコード内からコンソールに event を記録します。

console.log(event);
return true;

ブラウザーでルールを実行し、ブラウザーのコンソールでログに記録されたイベントオブジェクトを調べます。データ要素を使用できる様々なルールにおいて使用可能な情報を把握したら、カスタムコード内でその情報をプログラム判定に使用したり、event オブジェクトの一部をデータ要素の値として返すことができます。

DOM 属性

div または H1 タグなど、任意の要素の値を取得できます。

例：

CSS セレクターチェーン：

id#dc logo img

値を取得する要素：

src

JavaScript 変数

使用可能な JavaScript オブジェクトまたは変数は、パスフィールドを使用して参照できます。

マークアップに JavaScript 変数またはオブジェクトプロパティがあり、これらの値を Platform Launch で収集して拡張機能やルールで使用する場合、Platform Launch のデータ要素を使用してこれらの値を収集できます。この方法を使用すると、ルール全体でデータ要素を参照でき、データのソースが変更された場合でも、Platform Launch の 1 か所でソース（データ要素）への参照を変更するだけで済みます。

例えば、次のように、マークアップに「Page_Name」という JavaScript 変数が含まれているとします。

<script>
  //data layer
  var Page_Name = "Homepage"
</script>

Platform Launch でデータ要素を作成する場合は、この変数へのパスを指定するだけです。

データレイヤーでデータコレクターオブジェクトを使用している場合は、パスに、データ要素に取得するオブジェクトおよびプロパティを参照するドット表記を使用します（例：_myData.pageName や digitalData.pageName など）。

例：

window.document.title

ローカルストレージ

「Local Storage Item Name」フィールドにローカルストレージ項目の名前を入力します。

ローカルストレージを使用すると、ブラウザーはページからページへと情報を保存できます（https://www.w3schools.com/html/html5_webstorage.asp）。ローカルストレージは cookie のように機能しますが、cookie よりも大きく、柔軟です。

指定したフィールドを使用して、ローカルストレージ項目用に作成した値（例：lastProductViewed.）を指定します。

ページ情報

これらのデータポイントを使用して、ルールロジックで使用するページ情報をキャプチャしたり、Analytics や外部トラッキング システムに情報を送信したりできます。

次のいずれかのページ属性を選択してデータ要素で使用できます。

• URL
• Hostname
• Pathname
• Protocol
• リファラー
• Title

クエリー文字列パラメーター

単一の URL パラメーターを「URL Parameter」フィールドで指定します。

名前セクションのみが必要で、特殊な指定子（「?」や「=」など）は、省略する必要があります。

例：

contentType

乱数

乱数を生成するには、このデータ要素を使用します。多くの場合、データのサンプリングや、ID の作成（ヒット ID など）に使用されます。乱数は、難読化または salt 機密データに使用できます。例として次のようなものが挙げられます。

• ヒット ID の生成
• 数字をユーザートークンまあはタイムスタンプと連結して一意性を確保する
• PII データでの単方向ハッシュの実行
• サイトでサーベイリクエストをいつ表示するかをランダムに決定する

乱数の最小値と最大値を指定します。

デフォルト：

最小：0

最大：1000000000

セッションストレージ

「Session Storage Item Name」フィールドにセッションストレージ項目の名前を入力します。

セッションストレージは、ローカルストレージと似ていますが、セッションの終了後はデータが破棄されるという点が異なります。ローカルストレージや cookie はデータを保持することがあります。

訪問者行動

ページ情報と同様、このデータ要素は、ルールまたはデータ収集において、共通の動作タイプを使用して論理を強化します。

次のいずれかの訪問者行動属性を選択します。

• Landing page
• Traffic source
• Minutes on site
• Session count
• Session page view count
• Lifetime page view count
• Is new visitor

一般的なユースケースには次のものが含まれます。

• 訪問者がサイトに 5 分間滞在した後にサーベイを表示する
• 訪問のランディングページの場合は、Analytics 指標を生成する
• 「Session Counts」の数が X に到達したら訪問者に新しいオファーを表示する
• 初回訪問者にニュースレターへの新規登録を表示する