注文追跡
サイトで行われた注文を追跡します。
Fanplayrは、お客様のECストアで行われたコンバージョンを簡単に追跡できます。これは、弊社のユーザー行動追跡と合わせて、ストアを分析し、コンバージョンに至らない顧客プロファイルをターゲットとすることでビジネスを改善する機会を特定するために使用できます。
トラッキングコードテンプレート
コンバージョンを追跡するには、以下の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,
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
強化されたユーザー識別のためのサーバーサイドページのパス。
userConsentMode
- タイプ:
boolean
- スコープ: 全ページ
- デフォルト:
undefined
Fanplayrがユーザーのデータを保存するために、ユーザーの同意を考慮する必要があるかどうかを決定します。
詳細はデータに関するユーザーの同意を参照してください。
userConsentStatus
- タイプ:
boolean
- スコープ: 全ページ
- デフォルト:
undefined
userConsentMode
がtrue
に設定されている場合、これはユーザーがデータ保存に同意しているかどうかを定義します。
詳細はデータに関するユーザーの同意を参照してください。
allowNegativeCurrencyAmounts
- タイプ:
boolean
- スコープ:
全ページ
- デフォルト:
false
デフォルトでは、通貨変数の負の値は許可されておらず、代わりに 常に絶対正の値に変換されます。例えば、gross
に -100.00
を指定すると、100.00
(正)に変換されます。
この動作を無効にし、負の通貨額の追跡(負の注文合計の追跡など)を許可したい場合は、 allowNegativeCurrencyAmounts
をtrue
に設定してください。
この動作は以下のトラッキング変数に影響します:
トラッキング変数
以下の変数はdata
オブジェクト内に提供する必要があります。 例:
{
version: 3,
accountKey: '7e43c8cddccade2b95ee5286ba89758a',
data: {
orderId: '005921',
orderNumber: '005921',
gross: 89.90,
discount: 10.00
}
}
orderId
- タイプ:
string
- 必須
システム内で内部的に使用される一意の注文識別子です。これは後で内部システムのトランザクションを参照するために使用できます。
これはユーザーに提供される注文確認番号であるorderNumber
とは異なる場合があります。
orderNumber
- タイプ:
string
- 必須
ユーザーが目にする注文確認番号。これはorderId
と同じである場合も、異なる場合もあります。
gross
- タイプ:
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米ドルの注文。
- 以下の単一の商品で構成される:
- レッドシューズ、価格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>