カートへの適用

Fanplayrウィジェットは、サポートされている場合、オファーコードをストアのカートに直接適用することができます。この機能をサポートすることで、訪問者が有料の顧客へとコンバージョンする際の容易さが向上します。

仕組み

1. ユーザー追跡の実装の一部として、Fanplayrに特別なapplyToCartUrl URLを提供します。

   例：https://example.com/applyOffer.php?code=%c

2. カート適用機能を使用するオファーウィジェットは、ブラウザをこのURLにリダイレクトし、%c変数を適用するオファーコードに置き換えます。

3. このURLに移動すると、カートソフトウェアは以下のことを行う必要があります。

   1. 指定されたオファーコードをカートに適用します。
   2. ユーザーをカートページにリダイレクトします。
   3. ベストプラクティス: オファーがカートに正常に適用されなかった場合、その理由を説明する情報メッセージをユーザーに表示します。

例

次の例は、カート適用機能をサポートするためにFanplayrのユーザー追跡設定を行う方法を示しています。

ユーザーにFREESHIPというコードのターゲットフリーシッピングオファーが表示された場合、この機能が有効になると、ウィジェットはブラウザをhttps://example.com/applyOffer.php?code=FREESHIPに誘導します。

{
  type: 'st',
  accountKey: '7e43c8cddccade2b95ee5286ba89758a',
  applyToCartUrl: 'https://example.com/applyOffer.php?code=%c',
  data: {
    // ユーザー追跡データ
  }
}

カスタムハンドラ

クーポンを適用するために単純にURLをヒットできない場合があります。この場合、ユーザーが_適用ボタン_をクリックしたときにFanplayrプラットフォームで使用する関数ハンドラを提供できます。

シンプルなハンドラ

// `fanplayr_ready`関数は、主要なFanplayrスクリプトが読み込まれた後に呼び出されます。
window.fanplayr_ready = function () {
  window.fanplayr.platform.capabilities.applyToCart = function (event) {
    // `event.code`に対して何かを行う
    console.log(event.code);
  };
};

コールバック付きハンドラ

// `doneFn()`コールバック関数は、2番目の引数として受け入れることができます。
// これは、ハンドラが処理を完了した後に呼び出す必要があります。
// これにより、Fanplayrはハンドラが複数回呼び出されるのを防ぎ、
// ハンドラにアタッチされたUIを無効にすることができます。
window.fanplayr_ready = function () {
  window.fanplayr.platform.capabilities.applyToCart = function (event, doneFn) {
    // `event.code`は適用するクーポンコード
    $.ajax({
      type: 'GET',
      url: '/api/apply-code-to-cart',
      data: {
        code: event.code
      },
      complete: function () {
        // ハンドラが完了したことをFanplayrに通知します。
        doneFn();
      }
    });
  };
};