ドキュメントAnalytics実装ガイド

アドビプラグイン：getPreviousValue

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • 管理者
  • 開発者
IMPORTANT
このプラグインはアドビコンサルティングによって提供されており、Adobe Analytics からより多くの価値を引き出すのに役立ちます。アドビカスタマーケアは、インストールやトラブルシューティングを含め、このプラグインに対するサポートを行いません。このプラグインに関するヘルプが必要な場合は、組織のアドビアカウントチームにお問い合わせください。担当コンサルタントとのミーティングを手配してもらってください。

getPreviousValue プラグインを使用すると、変数を以前のヒットに設定された値に設定できます。このプラグインは、現在のヒットに必要な値がすべて含まれている場合は不要です。

Web SDK 拡張機能を使用したプラグインのインストール

Adobeでは、Web SDK で最も一般的に使用されるプラグインを使用できる拡張機能を提供しています。

  1. Adobe ID 資格情報を使用して、Adobe Experience Platform Data Collection にログインします。

  2. 左側の タグ をクリックしてから、目的のタグプロパティをクリックします。

  3. 左側の 拡張機能 をクリックしてから、「カタログ」タブをクリックします

  4. Common Web SDK Plugins 拡張機能を見つけてインストールします。

  5. 左側の データ要素 をクリックしてから、目的のデータ要素をクリックします。

  6. 次の設定で、目的のデータ要素名を設定します。

    • 拡張機能：Common Web SDK Plugins
    • データ要素：getPreviousValue

  7. 必要なパラメーターを右側に設定します。

  8. 変更を保存してデータ要素に公開します。

Web SDK を手動で実装するプラグインのインストール

このプラグインは、Web SDK の手動実装内での使用はまだサポートされていません。

Adobe Analytics拡張機能を使用してプラグインをインストールします

Adobeでは、Adobe Analyticsで最も一般的に使用されるプラグインを使用できる拡張機能を提供しています。

  1. Adobe ID 資格情報を使用して、Adobe Experience Platform Data Collection にログインします。

  2. 目的のタグプロパティをクリックします。

  3. 「拡張機能」タブに移動し、「カタログ」ボタンをクリックします。

  4. Common Analytics Plugins 拡張機能をインストールして公開します。

  5. まだ「Initialize Plug-ins」というルールを作成していない場合は、次の設定を使用してルールを作成します。

    • Condition：なし
    • Events：Core – 読み込まれたライブラリ（ページ上部）

  6. 次の設定を使用して、上記のルールにアクションを追加します。

    • Extension：Common Analytics Plugins
    • Action Type：Initialize getPreviousValue

  7. ルールに対する変更を保存して発行します。

カスタムコードエディターを使用したプラグインのインストール

Common Analytics Plugins プラグイン拡張機能を使用しない場合は、カスタムコードエディターを使用できます。

  1. Adobe ID 資格情報を使用して、Adobe Experience Platform Data Collection にログインします。
  2. 目的のプロパティをクリックします。
  3. 「拡張機能」タブに移動し、Adobe Analytics 拡張機能の下にある「設定」ボタンをクリックします。
  4. 「カスタムコードを使用してトラッキングを設定」アコーディオンを展開すると、「エディターを開く」ボタンが表示されます。
  5. カスタムコードエディターを開き、下に示すプラグインコードを編集ウィンドウに貼り付けます。
  6. 変更を保存し、Analytics 拡張機能に公開します。

AppMeasurement を使用したプラグインのインストール

Analytics トラッキングオブジェクトをインスタンス化（s_gi を使用）した後、AppMeasurement ファイルの任意の場所に次のコードをコピーして貼り付けます。実装時のコードのコメントとバージョン番号を記録しておくと、アドビが潜在的な問題のトラブルシューティングを行う際に役立ちます。

/* Adobe Consulting Plugin: getPreviousValue v3.0 */
function getPreviousValue(v,c){var k=v,d=c;if("-v"===k)return{plugin:"getPreviousValue",version:"3.0"};var a=function(){if("undefined"!==typeof window.s_c_il)for(var c=0,b;c<window.s_c_il.length;c++)if(b=window.s_c_il[c],b._c&&"s_c"===b._c)return b}();"undefined"!==typeof a&&(a.contextData.getPreviousValue="3.0");window.cookieWrite=window.cookieWrite||function(c,b,f){if("string"===typeof c){var h=window.location.hostname,a=window.location.hostname.split(".").length-1;if(h&&!/^[0-9.]+$/.test(h)){a=2<a?a:2;var e=h.lastIndexOf(".");if(0<=e){for(;0<=e&&1<a;)e=h.lastIndexOf(".",e-1),a--;e=0<e?h.substring(e):h}}g=e;b="undefined"!==typeof b?""+b:"";if(f||""===b)if(""===b&&(f=-60),"number"===typeof f){var d=new Date;d.setTime(d.getTime()+6E4*f)}else d=f;return c&&(document.cookie=encodeURIComponent(c)+"="+encodeURIComponent(b)+"; path=/;"+(f?" expires="+d.toUTCString()+";":"")+(g?" domain="+g+";":""),"undefined"!==typeof cookieRead)?cookieRead(c)===b:!1}};window.cookieRead=window.cookieRead||function(c){if("string"===typeof c)c=encodeURIComponent(c);else return"";var b=" "+document.cookie,a=b.indexOf(" "+c+"="),d=0>a?a:b.indexOf(";",a);return(c=0>a?"":decodeURIComponent(b.substring(a+2+c.length,0>d?b.length:d)))?c:""};var l;d=d||"s_gpv";a=new Date;a.setTime(a.getTime()+18E5);window.cookieRead(d)&&(l=window.cookieRead(d));k?window.cookieWrite(d,k,a):window.cookieWrite(d,l,a);return l};
/******************************************** END CODE TO DEPLOY ********************************************/

プラグインの使用

getPreviousValue 関数は次の引数を使用します。

  • v（文字列、必須）：次のイメージリクエストに渡す値を持つ変数。一般的な変数は、前のページ値を取得するために使用される s.pageName です。
  • c（文字列、オプション）：値を格納する Cookie の名前。この引数を設定しない場合、デフォルトは "s_gpv" になります。

この関数を呼び出すと、Cookie に含まれる文字列値が返されます。その後、プラグインは Cookie の有効期限をリセットし、v 引数から変数値を割り当てます。Cookie は、無操作状態が 30 分間続くと有効期限が切れます。

例

// 1. Sets prop7 to the cookie value contained in gpv_Page
// 2. Resets the gpv_Page cookie value to the page variable
// 3. If the page variable is not set, reset the gpv_Page cookie expiration
s.prop7 = getPreviousValue(s.pageName,"gpv_Page");

// Sets prop7 to the cookie value contained in gpv_Page, but only if event1 is in the events variable.
if(inList(s.events,"event1")) s.prop7 = getPreviousValue(s.pageName,"gpv_Page");

// Sets prop7 to the cookie value contained in gpv_Page, but only if the page variable is currently set on the page
if(s.pageName) s.prop7 = getPreviousValue(s.pageName,"gpv_Page");

// Sets eVar10 equal to the cookie value contained in s_gpv, then sets the s_gpv cookie to the current value of eVar1.
s.eVar10 = getPreviousValue(s.eVar1);

万が一の場合

v 引数に関連付けられた変数が新しい値に設定され、getPreviousValue プラグインが実行され、Analytics サーバー呼び出しが同時に送信されない場合、新しい v 引数の値は、次回プラグインが実行されたときに「以前の値」と見なされます。
例えば、次のコードが訪問の最初のページで実行されるとします。

s.pageName = "Home";
s.prop7 = getPreviousValue(s.pageName,"gpv_Page");
s.t();

このコードは、pageName が「Home」で prop7 が設定されていないサーバーコールを生成します。ただし、getPreviousValue の呼び出しによって、pageName の値が gpv_Page Cookie に保存されます。同じページ上で次のコードが直後に実行されたとします。

s.pageName = "New value";
s.prop7 = getPreviousValue(s.pageName,"gpv_Page");

t() 関数はこのコードブロックで実行されないので、別のイメージリクエストは送信されません。ただし、この時点で getPreviousValue 関数コードが実行されると、prop7 は以前の値 pageName (「Home」) に設定され、pageName (「New value」) の新しい値を gpv_Page Cookie に保存します。次に、訪問者が別のページに移動し、このページで次のコードが実行されるとします。

s.pageName = "Page 2";
s.prop7 = getPreviousValue(s.pageName,"gpv_Page");
s.t();

t() 関数を実行すると、pageName が「Page 2」、prop7が「New value」（getPreviousValue の最後の呼び出しが行なわれたときの pageName の値）というイメージリクエストが作成されます。pageName に渡された最初の値が「Home」であったにもかかわらず、 "Home" の prop7 値がイメージリクエストに含まれることはありませんでした。

バージョン履歴

3.0 （2021 年 3 月 19 日（PT））

  • コンテキストデータとしてバージョン番号を追加しました。

v2.0（2019 年 10 月 7 日（PT））

  • ポイントリリース（完全な論理書き換え）。
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690