セッションオファー
Fanplayrは、簡単な連携手順を追加することで、不正なユーザーがストアで割引を請求するのを防ぐことができます。
このメカニズムは、Coupons.comやRetailMeNotのようなクーポン共有サイトが多くのオンラインストアで直面してきた問題を解決することを目的としています。Fanplayrは、ユーザーに提示するオファーを現在の訪問中にのみ有効であるように制限することで、これを実現します。
仕組み
システム内でFanplayr専用のオファーコードを識別する方法を考案します。
- オファーがユーザーに提示されると、Fanplayrはシステムに通知します。システムは、ユーザーのセッション期間中、これらのオファーを記憶します。
- ユーザーがFanplayrオファーコードを適用しようとすると、システムは前のステップでコードを記憶している場合にのみそれを許可します。
フローの例
Fanplayr専用のオファーコードを識別する簡単な方法の1つは、特別なプレフィックスをそれらに付加することです。
たとえば、プレフィックスとして
"FP_"を使用し、システムで送料無料コード"FP_FREESHIP"を定義できます。ユーザー追跡の実装の一部として、Fanplayrに
sessionOfferUrlを提供します。たとえば、セッションオファーURLは次のようになる場合があります。 https://example.com/allowOffer.php?code=%c
Fanplayrがユーザーにオファーを提示すると、URL（GETリクエストとして）を呼び出し、オファーコードが現在のセッションで有効であることをシステムに通知します。
システムは、ユーザーセッション期間中永続化される配列にオファーコードを保存する必要があります。これを
validSessionCodes配列と呼びます。Fanplayrは、URL内の
%cパラメーターを実際のオファーコードに置き換えます。例: https://example.com/allowOffer.php?code=FP_FREESHIPシステムは、オファーコードをカートに適用する前に検証する必要があります。Fanplayrコード（例：
"FP_"プレフィックスで始まるコード）を適用しようとする場合、validSessionCodes配列にコードが存在する場合にのみカートに適用する必要があります。Fanplayrコードが配列に存在しない場合、そのコードは無効と見なされ、システムによって拒否されなければなりません。
実装例
1. 設定
このプロセスの最初のステップは、sessionOfferUrlをFanplayrユーザー追跡スニペットに提供することです。このURLは、ユーザーに提示される各オファーコードとともに呼び出されます。%cパラメーターは実際のオファーコードに置き換えられます。
例: https://example.com/allowOffer.php?code=%c は https://example.com/allowOffer.php?code=FP_FREESHIP になります
この設定手順は、当社が構築したカスタムJavaScriptアダプターには適用されません。この場合、統合を更新できるよう、sessionOfferUrlを当社に提供していただく必要があります。
{
type: 'st',
accountKey: '7e43c8cddccade2b95ee5286ba89758a',
sessionOfferUrl: 'https://example.com/allowOffer.php?code=%c', // セッションオファーURL
data: {
// ユーザートラッキングデータ
}
}2. システムへのセッションオファーの保存
次に、Fanplayrオファーコードがユーザーに提示されたときにそれを取得し、ユーザーセッション期間中配列に追加する新しいエンドポイントをシステムに実装する必要があります。
sessionOfferUrl変数で指定するURLは、FanplayrウィジェットによってGETリクエストとして呼び出されます。
3. カートに適用されるオファーの検証
最終ステップとして、システムを少し変更し、割引を適用する前にすべてのオファーコードを検証するようにする必要があります。
FP_プレフィックスで始まるコードを検証するために使用できるメソッドの実装例を提供しました。このプレフィックスで始まるコードのみが、ユーザーのセッション中に実際にFanplayrによって提示されたかどうかを確認されます。その他のプレフィックスのないコードはすべて直ちに有効と見なされます。
このメソッドは、オファーコードがカートに適用できるシステム内のあらゆる場所で使用されるべきです。
JavaScriptによる代替
サーバーサイドのURLが適さない場合（たとえば、localStorageにセッションオファーコードを保存する必要がある場合や、クライアントサイドのカートAPIを呼び出す必要がある場合）は、sessionOfferUrlを提供する代わりに、JavaScriptでsessionOffer機能を実装できます。
詳細と例については、機能 — セッションオファーを参照してください。