Web上でOracle Infinityでカート追加を追跡

イントロダクション

このチュートリアルでは、Oracle InfinityとOracle CXタグを使用してWebサイトのカート追加アクションにトラッキングを追加して、Webサイトのユーザーのカートへの追加を追跡する方法を示します。

目的

チュートリアルの目的は次のとおりです。

前提条件

このチュートリアルの前提条件については、次を参照してください。

タグの作成(Oracle CXタグ用)

Webサイトのタグを作成して構成しておく必要があります。

WebサイトにはすでにOracle CXタグがありますか?

Webサイトで使用されているタグを作成している場合は、このユースケース用に新しい特定のタグを作成する必要はありません。(a)既存のタグが必要なページにすでに実装されていることを確認するか、(b)新しいタグを作成して必要なページに実装する必要があります。

ステップ1:ページへのOracle CXタグの実装

目的のページにCXタグを実装していない場合は、Oracle Infinityへのトラッキング・リクエストを開始できるように、CXタグ・ライブラリをロードするために、これをページに追加する必要があります。

  1. 次の形式を使用する前提条件に従ってタグURLが必要です:

    //c.oracleinfinity.io/acs/account/{YOUR_ACCOUNT_GUID}/js/{YOUR_TAG_ID}/odc.js?_ora.config={_ora.config}

    アカウントGUID、タグIDおよび構成

    {Account GUID}は、アカウントを識別します。すべてのタグが同じアカウントGUIDを使用して、アカウントに収集されたすべてのデータがまとめて格納されるようにします。

    {Tag ID}では、Oracle Infinityタグにアクセス権を割り当てて、階層形式にすることができます。

    {_ora.config}は、タグが指す環境を示します(たとえば、環境ごとに異なるタグ構成(たとえば、テストおよび本番)を指すようにanalytics:test)。詳細は、環境を参照してください。

  2. 追跡するすべてのページの<head>*に次のコード・ブロックを実装します(タグURLに従って{Account GUID}、{Tag ID}および{_ora.config}を置き換えます)。例:

    同期実装

    <head>
...
<!-- CX Tag - Library Load -->
<script type="text/JavaScript" src="//c.oracleinfinity.io/acs/account/{Account GUID}/js/{Tag ID}/odc.js?_ora.config={_ora.config}"></script>
...
</head>

    非同期実装

    	<head>
	...
	<script type="text/JavaScript">
	(function() {

	    var accountGUID = "{Account GUID}";
	    var tagID = "{Tag ID}";
	    var config = "{_ora.config}";

	    // DO NOT EDIT BELOW THIS LINE
	    for(var odc_requested=!1,scripts=document.getElementsByTagName("SCRIPT"),s=0;s<scripts.length;s++)scripts[s].src&&/oracleinfinity.*odc\.\js/.test(scripts[s].src)&&(odc_requested=!0);if(!odc_requested){var sc_scripts=document.getElementsByTagName("script")[0],sc=document.createElement("script");if(sc.async=!0,void 0===config)var config="";config&&(config="?_ora.config="+config),sc.src="//c.oracleinfinity.io/acs/account/"+accountGUID+"/js/"+tagID+"/odc.js"+config,sc_scripts.parentNode.insertBefore(sc,sc_scripts)}
	}());
	</script>
	...
	</head>

    *同期または非同期

    Oracle Maxymiserを使用する場合は、ページ・コンテンツをユーザーに表示する前に操作できるように、前述の<head>同期にこれを実装する必要があります。ただし、Oracle Maxymiserを使用していない場合、これは非同期であり、<head>に必ずしも含まれていない可能性があります。

    これが不可能な場合は、Oracle Maxymiser CXタグ・ガイドラインを参照するか、非同期実装のタグ付け要件をサポートするためのエンゲージメントについてOracle Consulting Servicesに問い合せてください。

ステップ2:カート追加アクションでのクリック・コールの追加

使用可能パラメータ

パラメータの選択:送信するパラメータの選択に関するガイダンスは、パラメータの選択を参照してください:

カート追加用にOracle Infinityに送信するパラメータを決定する必要があります。

カート追加で送信できるパラメータの表を次に示します。

使用可能なカート追加関連パラメータ

パラメータ パラメータ名 必須 サンプル値 ノート
wt.tx_e Eコマース処理 必須 ひとつの 事前設定値
wt.currency Currency 必須 GBP 通貨コード
wt.tx_s 製品ライン・アイテム価格 必須 20.00 ';'区切りリスト/明細項目(製品数量 * 製品単価)
wt.product_price 製品単価 必須 10.00 製品ごとに';'区切りリスト(ライン・アイテム別)
wt.tx_u 製品ユニット 必須 2 ';'区切りリスト(明細項目別)
wt.pn_sku 製品SKU 必須* SKU1 ';'区切りリスト(明細項目別)
wt.cg_n コンテンツ・グループ 推奨 アクセサリ ';'区切りリスト(明細項目別)
wt.cg_s コンテンツ・サブグループ 推奨 靴 ';'区切りリスト(明細項目別)
wt.si_p ステップ名 推奨 バスケット追加 ファンネルのステップの名前
wt.si_x ステップ番号 推奨 2 ファンネルのステップ
wt.si_n シナリオ名 推奨 バスケットファンネル ファネルの名前
wt.pn_id 製品ID オプション* 232432 ';'区切りリスト(明細項目別)
wt.product_name 製品名 オプション ビッグトレーナー ';'区切りリスト(明細項目別)
wt.product_discount 製品割引 オプション 0.00 製品ごとに';'区切りリスト(ライン・アイテム別)
wt.pn_ma 製品ブランド オプション 素数 ';'区切りリスト(明細項目別)

*製品SKUまたは製品ID?

製品SKU (wt.pn_sku)は、Oracle Infinityで製品を宣言するために必要な標準パラメータです。必要に応じて、実装で製品ID (wt.pn_id)を宣言することもできます(製品SKUをスキップしてもかまいませんが、これは、Oracle Infinity内の一部の機能をカスタマイズしたワークフローなしで使用できないことを意味します)。

クリック・コールの起動

「パラメータ」を選択したら、ユーザーがカートにアイテムを追加するときに、次のJavaScript関数をトリガーして宣言する必要があります。

クリック・コールの実装例

(function(){
 
    // Declare Your Parameters
    var cxDataObject = {};
    cxDataObject["wt.tx_e"] = "a"; // Transaction Event - Purchase
    cxDataObject["wt.currency"] = "GBP"; // Currency
    cxDataObject["wt.pn_sku"] = "SKU1;SKU2"; // Product SKUs (‘;’ delimited list - by line item)
    cxDataObject["wt.product_price"] = "20.00"; // Product Price (‘;’ delimited list - by line item)
    cxDataObject["wt.tx_u"] = "2	"; // Units (‘;’ delimited list - by line item)
    cxDataObject["wt.tx_s"] = "40.00"; // Transaction Subtotal (‘;’ delimited list per line item (Product Quantity * Product Unit Price))
    cxDataObject["wt.cg_n"] = "accessories"; // Content Group (‘;’ delimited list per line item)
    cxDataObject["wt.cg_s"] = "shoes"; // Content Sub Group (‘;’ delimited list per line item)
    
    // DO NOT EDIT BELOW THIS LINE - ORA.click()
    window.ORA = window.ORA || {productReady: []};
    ORA.productReady.push(['analytics', function(cxDataObject) {return function() {return ORA.click({"data": cxDataObject})}}(cxDataObject)]);
})();

パラメータの選択

「使用可能なパラメータ」では、様々なパラメータに対して「必須」が表示されます。理想的には、使用可能なすべてのパラメータが表示されますが、古いブラウザ(Internet Explorerなど)での最大リクエスト長のサポートに関心がある場合は、これを使用して、実装する必要があるパラメータを優先順位付けできます。

何ですか? 摘要
必須 通常、Oracle Infinityおよび接続されたCX製品のコア機能に必要です。
推奨 通常、Oracle InfinityおよびコネクテッドCX製品の推奨機能に必要です。
オプション 通常、Oracle Infinityおよび接続されたCX製品のオプション機能に必要です。

ページがデータを送信していることをテスト

すべてのカート追加のOracle Infinityトラッキングが追加されると、Chrome DevToolsネットワーク・デバッガを開いてリクエストを検証できます。

  1. Chrome DevToolsネットワーク・デバッガを開きます。
  2. カート追加を実行します(たとえば、「カートに追加」ボタンをクリックします)。
  3. デバッガでdcsによってフィルタします。
  4. dcs.gifリクエストを選択します(これはOracle Infinityデータ収集コールです)。
  5. 送信されるパラメータを表示します。

Oracle Infinityデータ収集コールの表示

Oracle Infinityデータ収集コールの表示

ステップ3: Oracle Infinityがデータを受信しているかどうかの確認

上のクリック・コール(data.wt.tx_e=aなど)で定義されたパラメータに従って、購入データのOracle Infinity内の使用可能なデータをチェックできるようになりました。

その他の学習リソース

docs.oracle.com/learnの他のラボを調べるか、Oracle Learning YouTubeチャネルでさらに無料の学習コンテンツにアクセスします。さらに、education.oracle.com/learning-explorerにアクセスしてOracle Learning Explorerにします。

製品ドキュメントは、Oracleヘルプ・センターを参照してください。