Show Menu
トピック×

Core 拡張機能

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

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

このトピックでは、Core 拡張機能で使用できるイベントのタイプについて説明します。
複数のイベントタイプに設定できるオプションについては、 オプション を参照してください。

ブラウザー

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 となる必要があるプロパティ値を指定できます。
また、要素がリンクの場合、ルールが実行されるまでナビゲーションを遅らせるかどうかを指定することもできます。このチェックボックスをクリックすると、フィールドが開き、目的の遅延をミリ秒単位で入力できます。リンクがクリックされてから次のページに移動するまでの間に Launch がタグの実行を待機する時間を指定します。デフォルト値は 100 ミリ秒です。この時間を長くするとトラッキングの精度が向上します。アドビでは、ユーザーに遅延を意識させないよう 500 ミリ秒以下の設定値を推奨しています。この値は Launch が待機する時間の上限値であり、ビーコンが早く起動した場合には遅延が短くなります。(つまり、ユーザーの待ち時間は必ずしもこの設定値ほど長くはなりません)。
さらに、一定の時間が経過するとイベントをトリガーするように指定します。
高度なオプションについては、以下の オプション を参照してください。

Hover

指定した要素にユーザーがカーソルを重ねると、イベントをトリガーします。
以下の オプション を参照してください。
また、ルールがすぐにトリガーされるか、指定した時間(ミリ秒)が経過した後でルールがトリガーされるかを設定します。

その他

Custom Event

カスタムイベントタイプが発生すると、イベントをトリガーします。
他の場所で定義した JavaScript 関数に名前を付けて、イベントに使用することができます。
カスタムイベントタイプの名前を指定し、以下の オプション で説明するように、その他の設定をおこないます。

Data Element Changed

指定したデータ要素が変更されると、イベントをトリガーします。
データ要素名を入力します。リストからデータ要素を選択するには、アイコンをクリックしてからデータ要素を選択します。

Direct Call

イベント検出およびルックアップシステムをバイパスするために設計されました。
ダイレクト型ルールは、Launch に対して、何がおこなわれるかを正確に伝えたい場合に最適です。また、Adobe Flash を使用しているなど、Launch が DOM でイベントを検出できない場合にも最適です。
_satellite.track 文字列を指定します。

Element Exists

指定した要素が存在する場合は、イベントをトリガーします。
以下の オプション を参照してください。

Enters Viewport

ユーザーが指定したビューポートに入ると、イベントをトリガーします。
以下の オプション を参照してください。
また、ルールがすぐにトリガーされるか、指定した時間(ミリ秒)が経過した後でルールがトリガーされるかを設定します。

History Change

pushState または hashchange が発生すると、イベントをトリガーします。
このイベントタイプに関する設定はありません。

Time Spent on Page

ユーザーが指定した秒数の間ページに留まると、イベントをトリガーします。
イベントがトリガーされるまでに経過する必要がある時間(秒数)を指定します。

ページ読み込み

DOM Ready

DOM の準備が完了し、ユーザーがページを操作できるようになるとトリガーします。
このイベントタイプに関する設定はありません。

Library Loaded(Page Top)

Launch ライブラリが読み込まれ次第、イベントをトリガーします。
このイベントタイプに関する設定はありません。

Page Bottom

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

Window Loaded

onLoad がブラウザーによって呼び出され、ページの読み込みが完了すると、イベントをトリガーします。
このイベントタイプに関する設定はありません。

オプション

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

特定の要素 \| 任意の要素

  • 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 拡張機能で使用できる条件のタイプについて説明します。

データ

Custom Code

イベントの条件として使用する必要があるカスタムコードを指定します。組み込みコードエディターを使用してカスタムコードを入力します。
  1. Open Editor 」をクリックします。
  2. カスタムコードを入力します。
  3. Save 」をクリックします。
カスタムコード内から参照できる event という名前の変数が自動的に使用可能になります。この event オブジェクトには、ルールをトリガーしたイベントに関する便利な情報が含まれます。どのイベントを使用できるかを判断する最も簡単な方法として、カスタムコード内からコンソールに event を記録します。
console.log(event);
return true;

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

値の比較

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 を返します。
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 に関するドキュメント を参照してください。

変数

アクションをトリガーするためにイベントで使用する必要がある 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. (オプション)正規表現の場合は、正規表現を有効にします。

その他

Date Range

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

Max Frequency

条件が true を返す最大回数を指定します。選択できる項目は以下のとおりです。
  • Page view
  • Sessions
  • Visitor
  • Seconds
  • Minutes
  • Days
  • Weeks
  • Months

Sampling

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

技術

ブラウザー

アクションをトリガーするために、訪問者が使用する必要があるブラウザーを選択します。
次のブラウザーを 1 つ以上選択します。
  • Chrome
  • Firefox
  • Internet Explorer/Edge
  • Internet Explorer Mobile
  • Mobile Safari
  • OmniWeb
  • Opera
  • Opera Mini
  • Opera Mobile
  • Safari

デバイスタイプ

アクションをトリガーするために、訪問者が使用する必要があるデバイスのタイプを選択します。
次のデバイスタイプを 1 つ以上選択します。
  • Android
  • BlackBerry
  • デスクトップ
  • iPad
  • iPhone
  • iPod
  • Nokia
  • Windows Phone

オペレーティングシステム

アクションをトリガーするために、訪問者が使用する必要があるオペレーティングシステムを選択します。
次のオペレーティングシステムを 1 つ以上選択します。
  • Android
  • BlackBerry
  • iOS
  • Linux
  • MacOS
  • Maemo
  • Symbian OS
  • Unix
  • Windows

画面解像度

アクションをトリガーするために、訪問者がデバイスで使用する必要がある画面解像度を選択します。
  1. 画面解像度の幅を、指定した値より大きい、指定した値と等しい、または指定した値未満のどれにするかを選択します。
  2. 画面解像度の幅に必要なピクセル数を指定します。
  3. 画面解像度の高さを、指定した値より大きい、指定した値と等しい、または指定した値未満のどれにするかを選択します。
  4. 画面解像度の高さに必要なピクセル数を指定します。

ウィンドウサイズ

アクションをトリガーするために、訪問者がデバイスで使用する必要があるウィンドウサイズを選択します。
  1. ウィンドウサイズの幅を、指定した値より大きい、指定した値と等しい、または指定した値未満のどれにするかを選択します。
  2. ウィンドウサイズの幅に必要なピクセル数を指定します。
  3. ウィンドウサイズの高さを、指定した値より大きい、指定した値と等しい、または指定した値未満のどれにするかを選択します。
  4. ウィンドウサイズの高さに必要なピクセル数を指定します。

URL

ドメイン

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

ハッシュ

URL に必要な 1 つ以上のハッシュパターンを指定します。
複数のハッシュパターンは OR で結合されます。
  1. ハッシュパターンを指定します。
  2. (オプション)正規表現の場合は、正規表現を有効にします。
  3. その他のハッシュパターンを追加します。

パス

URL に存在する必要がある 1 つ以上のパスを指定します。
複数のパスは OR で結合されます。
  1. パスを指定します。
  2. (オプション)正規表現の場合は、正規表現を有効にします。
  3. 他のパスを追加します。

Protocol

URL で使用するプロトコルを指定します。
次のいずれかを選択します。
  • HTTP
  • HTTPS

サブドメイン

URL に存在する 1 つまたは複数のサブドメインを指定します。
複数のサブドメインは、OR で結合されます。
  1. サブドメインを指定します。
  2. (オプション)正規表現の場合は、正規表現を有効にします。
  3. 他のサブドメインを追加します。

URL パラメーター

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

Core 拡張機能の例外のタイプ

ここでは、Core 拡張機能で使用できる例外のタイプについて説明します。

データ

Custom Code

イベントの条件として使用する必要があるカスタムコードを指定します。組み込みコードエディターを使用してカスタムコードを入力します。
  1. Open Editor 」をクリックします。
  2. カスタムコードを入力します。
  3. Save 」をクリックします。
カスタムコード内から参照できる event という名前の変数が自動的に使用可能になります。この event オブジェクトには、ルールをトリガーしたイベントに関する便利な情報が含まれます。どのイベントを使用できるかを判断する最も簡単な方法として、カスタムコード内からコンソールに event を記録します。
console.log(event);
return true;

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

値の比較

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 を返します。
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 に関するドキュメント を参照してください。

変数

アクションをトリガーする、イベントで使用するべきでない 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. (オプション)正規表現の場合は、正規表現を有効にします。

その他

Date Range

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

Max Frequency

条件が true を返す最大回数を指定します。選択できる項目は以下のとおりです。
  • Page view
  • Sessions
  • Visitor
  • Seconds
  • Minutes
  • Days
  • Weeks
  • Months

Sampling

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

技術

ブラウザー

訪問者が使用している場合、アクションがトリガーされないブラウザーを選択します。
次のブラウザーを 1 つ以上選択します。
  • Chrome
  • Firefox
  • Internet Explorer/Edge
  • Internet Explorer Mobile
  • Mobile Safari
  • OmniWeb
  • Opera
  • Opera Mini
  • Opera Mobile
  • Safari

デバイスタイプ

訪問者が使用していない場合にアクションをトリガーするデバイスのタイプを選択します。
次のデバイスタイプを 1 つ以上選択します。
  • Android
  • BlackBerry
  • デスクトップ
  • iPad
  • iPhone
  • iPod
  • Nokia
  • Windows Phone

オペレーティングシステム

訪問者が使用している場合、アクションがトリガーされないオペレーティングシステムを選択します。
次のオペレーティングシステムを 1 つ以上選択します。
  • Android
  • BlackBerry
  • iOS
  • Linux
  • MacOS
  • Maemo
  • Symbian OS
  • Unix
  • Windows

画面解像度

訪問者がデバイス使用している場合、アクションがトリガーされない画面解像度を選択します。
  1. 画面解像度の幅を、指定した値より大きい、指定した値と等しい、または指定した値未満のどれにするかを選択します。
  2. 画面解像度の幅に必要なピクセル数を指定します。
  3. 画面解像度の高さを、指定した値より大きい、指定した値と等しい、または指定した値未満のどれにするかを選択します。
  4. 画面解像度の高さに必要なピクセル数を指定します。

ウィンドウサイズ

アクションをトリガーするために、訪問者がデバイスで使用すべきでないウィンドウサイズを選択します。
  1. ウィンドウサイズの幅を、指定した値より大きい、指定した値と等しい、または指定した値未満のどれにするかを選択します。
  2. ウィンドウサイズの幅に必要なピクセル数を指定します。
  3. ウィンドウサイズの高さを、指定した値より大きい、指定した値と等しい、または指定した値未満のどれにするかを選択します。
  4. ウィンドウサイズの高さに必要なピクセル数を指定します。

URL

ドメイン

アクションがトリガーされないようにする訪問者のドメインを指定します。

ハッシュ

URL に存在すべきでない 1 つ以上のハッシュパターンを指定します。
複数のハッシュパターンは OR で結合されます。
  1. ハッシュパターンを指定します。
  2. (オプション)正規表現の場合は、正規表現を有効にします。
  3. その他のハッシュパターンを追加します。

パス

URL に存在すべきでない 1 つ以上のパスを指定します。
複数のパスは OR で結合されます。
  1. パスを指定します。
  2. (オプション)正規表現の場合は、正規表現を有効にします。
  3. 他のパスを追加します。

Protocol

URL で使用できないプロトコルを指定します。
次のいずれかを選択します。
  • HTTP
  • HTTPS

サブドメイン

URL に存在すべきでない 1 つ以上のサブドメインを指定します。
複数のサブドメインは、OR で結合されます。
  1. サブドメインを指定します。
  2. (オプション)正規表現の場合は、正規表現を有効にします。
  3. 他のサブドメインを追加します。

URL パラメーター

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

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

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

カスタムコード

イベントのトリガー後に実行して条件を評価するコードを提供します。
  1. アクションコードに名前を付けます。
  2. アクションの定義に使用する言語を選択します。
    • JavaScript
    • HTML
  3. アクションコードをグローバルに実行するかどうかを選択します。
  4. 「Open Editor」をクリックします。
  5. コードを編集し、「Save」をクリックします。
言語として「JavaScript」を選択すると、カスタムコード内から参照できる event という名前の変数が自動的に使用可能になります。この event オブジェクトには、ルールをトリガーしたイベントに関する便利な情報が含まれます。どのイベントを使用できるかを判断する最も簡単な方法として、カスタムコード内からコンソールに event を記録します。
console.log(event);

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

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

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

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

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

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

カスタムアクションのコードはサーバーから読み込まれ、 Postscribe を使用してドキュメントに書き込まれます。ルールに複数のカスタムコードアクションがある場合、コードはサーバーから平行して読み込まれますが、ルール内で設定されている順序で記述されます。
ページの読み込み後に document.write を使用すると、通常は問題が発生しますが、これは「Custom Code」アクションによって提供されるコードの場合は問題になりません。コードを実行するタイミングに関係なく、「Custom Code」アクション内で document.write を使用できます。

カスタムコードの検証

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

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

データ要素のタイプは、拡張機能によって決まります。タイプはいくつでも作成することができます。
以下の節では、Core 拡張機能で使用できるデータ要素のタイプについて説明します。その他の拡張機能は、他のタイプのデータ要素を使用します。

定数

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

例:

string

カスタムコード

カスタム JavaScript は、「Open Editor」をクリックしてエディターウィンドウにコードを挿入することで、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 変数またはオブジェクトプロパティがあり、これらの値を Launch で収集してかくちょうきのうやルールで使用する場合、Launch のデータ要素を使用してこれらの値を収集できます。この方法を使用すると、ルール全体でデータ要素を参照でき、データのソースが変更された場合でも、Launch の 1 か所でソース(データ要素)への参照を変更するだけで済みます。
例えば、次のように、マークアップに「 Page_Name 」という JavaScript 変数が含まれているとします。
<script>
  //data layer
  var Page_Name = "Homepage"
</script>

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
  • Referrer
  • 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 に到達したら訪問者に新しいオファーを表示する
  • 初回訪問者にニュースレターへの新規登録を表示する