リンクデコレーション

現在、リンクデコレーションは、Fanplayrのカスタマーサクセスチームが設定する必要がある機能です。この機能を使用したい場合は、担当マネージャーにお問い合わせください。

Fanplayrは、同じアカウントに属する複数のドメインに統合できます。通常、各ドメインは個別のキャンペーンとそのキャンペーン専用のブラウジングセッションに対応します。ただし、複数のドメインにわたって1つのキャンペーンとブラウジングセッションを使用する方が良いシナリオもあります。

リンクデコレーションは、Fanplayrセッションを複数のドメインにわたって継続できるようにする機能です。これは、ページ上のリンクを拡張し、Fanplayrセッション識別子を含めることで機能し、この情報が次のドメインに引き継がれるようにします。

ページ上のリンクをデコレートするために、複数の技術を用いることができます。これらの技術は、ページ上のすべてのリンクに広範囲に適用することも、特定のリンクのみを対象に限定的に適用することも可能です。それぞれの技術には利点とトレードオフがあり、その使用はウェブサイトのニーズと設計方法によって異なります。

• 通常のリンク（<a href="...">タグ）の書き換え。
• フォームアクションURLの書き換え。
• ページ上のクリックを監視し、リンクがクリックされた場合、ナビゲーションの前にそのリンクを書き換える。
• window.open()のようなブラウザAPIの拡張。

リンクデコレーションは、以下のJSON構造をlinkAugmentConfigアカウント設定として構成することで有効にできます。

[
  {
    // この正規表現パターンに一致するホスト名でのみ設定が適用されます。
    domainPattern: 'store\\.com',
    // この正規表現パターンに一致するリンクのみがデコレートされます。
    linkPattern: 'other-store\\.com',
    // `window.open()` をラップし、最初の引数をデコレートします。
    windowOpen: true,
    // リンクパターンに一致するhrefを持つすべてのアンカーをデコレートします。
    rewriteHrefs: false,
    // リンクパターンに一致するactionを持つすべてのフォームをデコレートします。
    rewriteForms: false,
    // ページ上のすべてのクリックをリッスンし、最も近いリンクをデコレートします。
    monitorClicks: true,
    // Xミリ秒だけ初期化を遅延させます。
    delay: 1000
  }
];

domainPattern

• タイプ: string
• 必須: はい

ブラウザの現在のURLがこのパターンに一致する場合、設定内のルールが現在のページビューに適用されます。一致した最初の設定のみが使用されます。

linkPattern

• タイプ: string（正規表現）
• 必須: はい

このパターンに一致するリンクのみがデコレート（変更）され、ナビゲーション後にセッションを継続させるためのパラメータが付加されます。

delay

• タイプ: integer
• デフォルト: 0

リンクデコレーション設定メソッドを実行するまでに待機するミリ秒数。

windowOpen

• タイプ: boolean
• デフォルト: false

デコレーションメソッド このブラウザAPIへの呼び出しを監視するために、window.open()メソッドをラップします。linkPatternに一致するURLは、ネイティブブラウザメソッドに渡される前にデコレートされます。

rewriteHrefs

• タイプ: boolean
• デフォルト: false

デコレーションメソッド ページ上のすべての<a>タグを検索し、href属性がlinkPatternに一致する場合、それらをインプレースでデコレートします。

rewriteForms

• タイプ: boolean
• デフォルト: false

デコレーションメソッド ページ上のすべての<form>タグを検索し、action属性がlinkPatternに一致するものをデコレートします。

monitorClicks

• タイプ: boolean
• デフォルト: false

デコレーションメソッド キャプチャフェーズを使用して、clickおよびtouchstartイベントリスナーをドキュメントにアタッチします。ユーザーがドキュメントの任意の要素とインタラクションすると、最も近い<a>タグが検索され、そのhref属性がlinkPatternに一致する場合、それがデコレートされます。