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

アドビプラグイン：getPageName

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

作成対象：

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

getPageName プラグインは、読みやすく、わかりやすい形式の現在の URL を作成します。レポートで設定しやすく理解しやすい pageName 値が必要な場合は、このプラグインを使用することをお勧めします。このプラグインは、データレイヤーを介してなど、pageName 変数の命名構造が既にある場合は不要です。この変数は、pageName 変数を設定する別のソリューションがない場合に最適です。

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
    • データ要素：getPageName

  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 getPageName

  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 ファイルの任意の場所に次のコードをコピーして貼り付けます。実装時のコードのコメントとバージョン番号を記録しておくと、アドビが潜在的な問題のトラブルシューティングを行う際に役立ちます。

/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: getPageName v4.2 */
var getPageName=function(si,qv,hv,de){var a=si,b=qv,f=hv,e=de;if("-v"===a)return{plugin:"getPageName",version:"4.2"};a:{if("undefined"!==typeof window.s_c_il){var d=0;for(var g;d<window.s_c_il.length;d++)if(g=window.s_c_il[d],g._c&&"s_c"===g._c){d=g;break a}}d=void 0}"undefined"!==typeof d&&(d.contextData.getPageName="4.2");var c=location.hostname,h=location.pathname.substring(1).split("/"),l=h.length,k=location.search.substring(1).split("&"),m=k.length;d=location.hash.substring(1).split("&");g=d.length;e=e?e:"|";a=a?a:c;b=b?b:"";f=f?f:"";if(1===l&&""===h[0])a=a+e+"home";else for(c=0;c<l;c+\+)a=a+e+decodeURIComponent(h[c]);if(b&&(1!==m||""!==k[0]))for(h=b.split(","),l=h.length,c=0;c<l;c++)for(b=0;b<m;b++)if(h[c]===k[b].split("=")[0]){a=a+e+decodeURIComponent(k[b]);break}if(f&&(1!==g||""!==d[0]))for(f=f.split(","),k=f.length,c=0;c<k;c++)for(b=0;b<g;b++)if(f[c]===d[b].split("=")[0]){a=a+e+decodeURIComponent(d[b]);break}return a.substring(a.length-e.length)===e?a.substring(0,a.length-e.length):a};
/******************************************** END CODE TO DEPLOY ********************************************/

プラグインの使用

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

  • si（オプション、文字列）：サイトの ID を表す文字列の先頭に挿入される ID。この値は、数値 ID またはわかりやすい名前にすることができます。設定しない場合は、デフォルトで現在のドメインが使用されます。
  • qv（オプション、文字列）：URL 内にある場合に文字列に追加されるクエリ文字列パラメーターのコンマ区切りリストです。
  • hv（オプション、文字列）：URL ハッシュに含まれるパラメーターのコンマ区切りリストです。URL 内に含まれる場合は文字列に追加されます。
  • de（オプション、文字列）：文字列の個々の部分を分割する区切り文字です。デフォルトはパイプ（|）です。

この関数は、わかりやすい形式の URL を含む文字列を返します。この文字列は通常 pageName 変数に割り当てられますが、他の変数でも使用できます。

例

// Given the URL https://mail.example.com/mail/u/0/#inbox, sets the page variable to "mail.example.com|mail|u|0".
s.pageName = getPageName();

// Given the URL https://mail.example.com/mail/u/0/#inbox, sets the page variable to "example|mail|u|0".
s.pageName = getPageName("example");

// Given the URL https://www.example.com/, sets the page variable to "www.example.com|home".
// When the code runs on a URL that does not contain a path, it always adds the value of "home" to the end of the return value.
s.pageName = getPageName();

// Given the URL https://www.example.com/, sets the page variable to "example|home".
s.pageName = getPageName("example","","","|");

// Given the URL https://www.example.com/en/booking/room-booking.html?cid=1235#/step2&arrive=05-26&depart=05-27&numGuests=2
// Sets the page variable to "www.example.com|en|booking|room-booking.html".
s.pageName = getPageName();

// Given the URL https://www.example.com/en/booking/room-booking.html?cid=1235#/step2&arrive=05-26&depart=05-27&numGuests=2
// Sets the page variable to "example: en: booking: room-booking.html: cid=1235: arrive=05-26: numGuests=2"
s.pageName = getPageName("example","cid","arrive,numGuests",": ");

以前のバージョンからのアップグレード

getPageName プラグインのバージョン 4.0 以降は、Adobe Analytics の AppMeasurement オブジェクト（s オブジェクト）の存在に依存しません。このバージョンにアップグレードする場合は、呼び出しから s オブジェクトの任意のインスタンスを削除し、プラグインを呼び出すコードを変更してください。例えば、s.getPageName(); を getPageName(); に変更します。

バージョン履歴

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

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

4.1（2019 年 9 月 17 日（PT））

  • デフォルトの区切り文字の値を（コロン+スペースから）パイプ文字に変更しました。

4.0（2018 年 5 月 22 日（PT））

  • プラグインの完全な再分析と書き換え
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690