Web上のOracle Infinityで認証済ユーザーを追跡

イントロダクション

このチュートリアルでは、ユーザー・レベルのトラッキング・パラメータをトラッキング・コールに追加することで、Oracle InfinityとOracle CXタグを使用してWebサイトの認証済ユーザーを追跡する方法を示します。たとえば、ユーザーの顧客IDを宣言すると、Eコマース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:トラッキング・コールでのユーザー・レベル・パラメータの宣言

ユーザーが認証されると、新規または既存の追跡コールにそれらの詳細を追加できます(たとえば、認証された各訪問者の顧客IDを表示する場合があります)。

使用可能パラメータ

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

次に、認証済ユーザーに送信できる推奨パラメータの表を示します。

推奨ユーザー・レベル・パラメータ

パラメータ パラメータ名 サンプル値 ノート
wt.dcsvid 外部ビジターID CUST123 下記を参照*
wt.customer_id 顧客ID CUST123 顧客のID
wt.email 電子メール・アドレス stevie.nicks@oracle.com 未処理のEメール・アドレス
wt.e_id_s Eメール・アドレス(SHA-256ハッシュ) 9A0FF5B8ADEC41340B433CB2E343DA2DF0DFCBB7447301D97755B6568E41BB8B SHA-256ハッシュ電子メール・アドレス
wt.e_id_m Eメール・アドレス(MD5ハッシュ) 0FED850BA5BC6D3A126270F5DFA43C15 MD5でハッシュEメール・アドレス
wt.mobile_phone 電話番号 +447809839594 RAW電話番号
wt.riid Responsys受信者ID (RIID) 564228225 Responsys受信者ID
wt.customer_type 顧客タイプ 掛金 顧客タイプ

*外部ビジターID

このパラメータは、Oracle Infinityによって訪問者ごとに生成されたデフォルトの訪問者IDをオーバーライドします。詳細は、外部訪問者IDを参照してください。

パラメータの宣言

「パラメータ」を選択すると、新規または既存のコールで宣言できます。例:

ホーム・ページでの認証済ユーザーのサンプル・ビュー・コール

(function(){
 
    // Declare Your Parameters
    var cxDataObject = {};
    cxDataObject["wt.page_name"] = "homepage"; // Custom parameter denoting page name
    cxDataObject["wt.customer_id"] = "EXAMPLECUSTOMERID123"; // Customer ID
    cxDataObject["wt.e_id_s"] = "9A0FF5B8ADEC41340B433CB2E343DA2DF0DFCBB7447301D97755B6568E41BB8B"; // SHA-256 hashed email address
    cxDataObject["wt.customer_type"] = "VIP Customer"; // Custom parameter denoting type of customer
     
    // 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)]);
})();

ステップ3:パラメータが宣言されていることをテストします

ユーザーレベルのパラメータを宣言したら、Chrome DevToolsネットワーク・デバッガを開いてリクエストを検証できます。

  1. Chrome DevToolsネットワーク・デバッガを開きます。
  2. サイトで認証されていることを確認します(または、新しいパラメータを宣言するための基準を満たします)。
  3. ページをリフレッシュします。
  4. デバッガでdcsによってフィルタします。
  5. dcs.gifリクエストを選択します(これはOracle Infinityデータ収集コールです)。
  6. 送信されるパラメータを表示します。

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

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

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

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

その他の学習リソース

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

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