注文追跡

サイトに配置された注文を追跡します。

Fanplayrは、お客様のeコマースストアで行われたコンバージョンを簡単に追跡できます。これは、ユーザー行動追跡と合わせて、お客様のストアを分析し、コンバージョンしない顧客プロファイルをターゲットにすることでビジネスを改善する機会を特定するために使用できます。

追跡コードテンプレート

コンバージョンを追跡するためには、以下のJavascriptコードテンプレートを注文確認ページに配置する必要があります。これは、注文プロセスが完了した後に顧客が閲覧するページであるべきです。例えば、PayPalのような外部決済ゲートウェイから顧客が戻されるページがこれに該当します。

<!-- Fanplayr コンバージョン追跡の開始 -->
<script>
  (function (d, w, s) {
    if (!w.fp_sales_orders) {
      w.fp_sales_orders = {
        version: 3,
        accountKey: '',
        storeDomain: '',
        userConsentMode: false,
        // userConsentStatus: true
        // allowNegativeCurrencyAmounts: true
        data: {
          orderId: '',
          orderNumber: '',
          gross: 0.0,
          total: 0.0,
          discount: 0.0,
          discountCode: '',
          shipping: 0.0,
          tax: 0.0,
          currency: '',
          orderEmail: '',
          firstName: '',
          lastName: '',
          customerEmail: '',
          customerId: '',
          products: [
            {
              id: '',
              sku: '',
              price: 0.0,
              qty: 1,
              name: ''
            }
          ],
          cartAction: 'override',
          custom_data: {
            // ...
          }
        }
      };
      var js = d.createElement(s);
      var fjs = d.getElementsByTagName(s)[0];
      js.async = true;
      js.src = 'https://cdn.fanplayr.com/client/production/fp_custom_orders.js';
      fjs.parentNode.insertBefore(js, fjs);
    }
  })(document, window, 'script');
</script>
<!-- Fanplayr コンバージョン追跡の終了 -->

設定

version

• タイプ: integer
• スコープ: すべてのページ
• 必須

Fanplayrプラットフォームが使用する追跡フォーマットのバージョン識別子です。3に設定する必要があります。

accountKey

• タイプ: string
• スコープ: すべてのページ
• 必須

Fanplayrプラットフォームであなたのアカウントを識別するために使用される一意の文字列です。

storeDomain

• タイプ: string
• スコープ: すべてのページ
• デフォルト: window.location.hostname の値

Fanplayrが注文と関連付けるドメインを任意で上書きするために使用できます。

一部のストアでは、チェックアウトシステムに異なるドメインを使用する場合があります。例えば、ユーザーはhttps://www.example.comでストアを閲覧するかもしれませんが、チェックアウトと注文はhttps://www.checkout.com/exampleで行われる場合があります。この場合、Fanplayrプラットフォームがこれらのドメイン間でユーザーと彼らが行う注文をシームレスに追跡できるように、storeDomainを「example.com」（あなたのFanplayrキャンペーンにリンクされているのと同じドメイン）に設定する必要があります。

connect

• タイプ: object
• スコープ: すべてのページ
• デフォルト: undefined

Enhanced User Identificationのサーバーサイドページへのパスです。

userConsentMode

• タイプ: boolean
• スコープ: すべてのページ
• デフォルト: undefined

Fanplayrがユーザーのデータを保存するために、ユーザーの同意を考慮する必要があるかどうかを決定します。

詳細については、user-consent-for-dataをご覧ください。

userConsentStatus

• タイプ: boolean
• スコープ: すべてのページ
• デフォルト: undefined

userConsentModeがtrueに設定されている場合、これはユーザーがデータ保存に同意したかどうかを定義します。

詳細については、user-consent-for-dataをご覧ください。

allowNegativeCurrencyAmounts

• タイプ: boolean
• スコープ: All pages
• デフォルト: false

デフォルトでは、通貨変数に負の値を指定することは許可されておらず、 常にその絶対的な正の値に変換されます。例えば、grossに-100.00と指定すると、 100.00（正）に変換されます。

この動作を無効にし、負の通貨金額（負の注文合計の追跡など）を 追跡できるようにしたい場合は、allowNegativeCurrencyAmountsをtrueに設定します。

この動作は、以下の追跡変数に影響します：

• gross
• total
• discount
• shipping
• tax

追跡変数

以下の変数はdataオブジェクトで提供されなければなりません。例:

{
  version: 3,
  accountKey: '7e43c8cddccade2b95ee5286ba89758a',
  data: {
    orderId: '005921',
    orderNumber: '005921',
    gross: 89.90,
    total: 79.90,
    discount: 10.00
  }
}

orderId

• タイプ: string
• 必須

システムで内部的に使用される一意の注文識別子です。これは後で内部システムでのトランザクションを参照するために使用できます。

これはorderNumberとは異なる場合があります。orderNumberはユーザーに提供される注文確認番号です。

orderNumber

• タイプ: string
• 必須

ユーザーに見える注文確認番号です。これはorderIdと同じである場合も、異なる場合もあります。

gross

• タイプ: float
• 必須

注文に含まれる商品の合計金額（指定された通貨で）。より具体的には、割引、送料、税金前の、注文に含まれる商品の合計額です。

total

• タイプ: float
• 必須

これは注文に含まれる商品の合計金額（指定された通貨で）です。より具体的には、送料と税金前、ただし割引後の、注文に含まれる商品の合計額です。

discount

• タイプ: float
• 必須

これはカートに適用された割引の合計額です。これは、無料配送や配送割引などがこの値を変更すべきではないことを意味します。

discountCode

• タイプ: string
• 必須

注文に適用された割引コード（もしあれば）。複数の割引コードが適用されている場合は、コンマで区切ります。

shipping

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

送料割引適用後の合計配送料金。

tax

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

注文に適用されるすべての税金の合計。

currency

• タイプ: string
• デフォルト: "USD"

追跡されている製品および注文金額のISO 4217通貨コード。

orderEmail

• タイプ: string

ユーザーが注文のために提供したメールアドレスです。これはcustomerEmailとは異なる場合があります。

firstName

• タイプ: string

注文を行ったユーザーのファーストネームです。例：「John」。

lastName

• タイプ: string

注文を行ったユーザーのラストネームです。例：「Smith」。

customerEmail

• タイプ: string

現在のユーザーのメールアドレスです。

customerId

• タイプ: string

これはあなたのサイトにとって内部的なユーザーの識別子です。新規ユーザーとリピートユーザーを追跡するために使用されます。

products

• タイプ: Array<Product>| string

注文に含まれる商品を表現するオブジェクト（またはJSON）の配列です。

cartAction

• タイプ: CartAction
• デフォルト: "override"

これは、現在の追跡呼び出しに対するカート関連データ（カート内の合計金額、カート内の商品など）をFanplayrがどのように処理するかを決定する特殊な変数です。現在の追跡呼び出しで利用できない場合、前のページビューからのカート詳細を引き継ぐために使用できます。

カスタムデータ

custom_dataオブジェクトを使用して、追加の注文詳細をカスタムデータとして追跡できます。

{
  accountKey: '<ACCOUNT_ID>',
  data: {
    // ...
  },
  custom_data: {
    // 追跡する追加の詳細のキー/値ペアを追加します
    order_notes: 'Please leave at front door'
  }
}

例

以下の例は、次のものを追跡するために使用できます。

• 10ドルの「SUMMER10」割引が適用された後、合計79.90 USDの注文。
• 1つの商品で構成されています：
  • レッドシューズ、価格89.90ドル

<script>
  (function (d, w, s) {
    if (!w.fp_sales_orders) {
      w.fp_sales_orders = {
        version: 3,
        accountKey: '7e43c8cddccade2b95ee5286ba89758a',
        storeDomain: 'example.com',
        data: {
          orderId: '005921',
          orderNumber: '005921',
          gross: 89.9,
          total: 79.9,
          discount: 10.0,
          discountCode: 'SUMMER10',
          shipping: 0.0,
          tax: 0.0,
          currency: 'USD',
          orderEmail: 'john.smith@gmail.com',
          firstName: 'John',
          lastName: 'Smith',
          customerEmail: 'john.smith@gmail.com',
          customerId: '10204723',
          products: [
            {
              id: 'WRS001',
              sku: 'WRS001',
              price: 89.9,
              qty: 1,
              name: 'Red Shoes'
            }
          ]
        }
      };
      var js = d.createElement(s);
      var fjs = d.getElementsByTagName(s)[0];
      js.async = true;
      js.src = 'https://cdn.fanplayr.com/client/production/fp_custom_orders.js';
      fjs.parentNode.insertBefore(js, fjs);
    }
  })(document, window, 'script');
</script>