🍻 👩🏾‍🌾 🧜🏽 GA測定プロトコル-完全ガイド 🌯 👞 👸🏻

Habré の Measurement Protocolのレビューはすでに1つありますが、多数の追加とケースの存在があるため、完全なガイドを作成することにしました。

内容

技術面
- 必須パラメーター
- インタラクションをGAに転送する
- パラメーターcid、uid、ni
実際の測定プロトコル
- GA標準トラッキングコード
- CRM統合
- トランザクション追跡
- 払い戻しまたは一部払い戻し
- オフラインPOS
- オープニングレター
追加のリソース
結論

測定プロトコル（MP）は、Googleアナリティクス（GA）が情報を収集するための基本的なツールです。つまり、ページビューやその他のイベントに関する情報をGAに送信するために使用される技術です。

技術面

プロトコルはHTTP経由で機能し、単一のエントリポイントwww.google-analytics.com/collectを持ちます。

データは、POSTおよびGET要求によって送信できます。

必須パラメーター

v-現時点1のプロトコルバージョン（v = 1）。

tidはGAのリソースの識別子です。

cid-ユーザーの一意の識別子（標準のGA JSコードをCookieに入れるか、個別に生成する必要があります-以下で詳細に検討します）。

tは、ページビュー/イベントなどのインタラクションのタイプです（t =イベント）。

つまり、リクエストは次のようになります。

v=1&tid=UA-123456-1&cid=1482535147.1490885188&t=event

なぜなら相互作用イベントのタイプを選択した場合、イベントを説明する必須パラメーターを追加する必要があります。

ec （イベントカテゴリ）-イベントカテゴリ（ec =登録）。

ea （イベントアクション）-イベントアクション（ea =フォーム）。

 v=1&tid=UA-123456-1&cid=1482535147.1490885188&t=event&ec=registration&ea=form

パラメータの全リスト

GAへのイベント転送

次のいずれかの方法を使用してリクエストを送信できます。

投稿

 User-Agent: user_agent_string // https://en.wikipedia.org/wiki/User_agent#Format POST /collect HTTP/1.1 Host: www.google-analytics.com v=1&tid=UA-123456-1&cid=1482535147.1490885188&t=event&ec=registration&ea=form

ゲット

キャッシュの問題を回避するために、最後のパラメーターとして、各リクエストに一意の値を持つzを追加することをお勧めします。

 GET /collect?v=1&tid=UA-123456-1&cid=1482535147.1490885188&t=event&ec=registration&ea=form&z=12345 HTTP/1.1 Host: https://www.google-analytics.com User-Agent: user_agent_string

送信されたデータの正確性をチェックするサービス

パラメーターcid、uid、ni

これらのパラメーターに関してよく質問がありますので、詳しく見てみましょう。

CID

cid-クライアントID、ユーザーのクライアントアプリケーション（Webブラウザーなど）の一意の識別子。cidは特定のドメインの_ga Cookieに保存されます。

_ga Cookieには、GA1.2.602320690.1474476467のようなものが保存されます

cidパラメーターでは、2番目のポイントの後にあるすべてのものを渡す必要があります。つまり、この場合：

 &cid=602320690.1474476467

_ga Cookieは 、Google Analytics Trackerが初期化されたときにスタンプされます。

 <script> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','https://www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-12345678-1', 'auto'); //      ga('send', 'pageview'); //         Google Analytics </script>

cidパラメーターは、Measurement Protocolのすべてのクエリに必要です。 MPを介してGAにイベントを送信するのを遅らせた場合、バックエンド側でユーザーcidを保存する必要があります。

cidがそうでない場合

事例の例：

1）以前にcidユーザーを保存していない

2）ユーザーのCookieが無効になっているか、一部のブラウザー拡張機能がgoogle分析スクリプトの実行をブロックしています。

cidパラメーターはデータをGAに送信するために必要なので、そのような場合、バックエンド側でcidを生成する必要があります。

このようにしてcidを生成します：

 $cookieId = rand(1000000000, 2147483647) . '.' . time();

cidの自己生成を脅かすもの

送信されたデータは、Googleアナリティクス側のユーザーには連絡しません。

しかし、イベントの数の全体像を把握できます。なぜなら、バックエンドから測定プロトコルに関する情報を送信していなかった場合、通常は統計に合格していたからです。

uid

システム内のユーザーの一意の識別子（たとえば、サイト上）。このパラメーターは、ユーザーID機能を有効にするために必要です。

これにより、ログインしているすべてのユーザーの統計情報を含む個別のビューを作成し、各ユーザーのアクション（ビュー、ページ、イベント、支払い）のシーケンスを追跡できます。クロスデバイスレポートも利用できます。

ユーザーIDの詳細： support.google.com/analytics/answer/3123662

このパラメーターを使用すると、この対話が特定のユーザーによって実行されたことをGAに通知できます。パラメーターには任意の文字列値を使用できますが、ユーザーの身元を明らかにする情報（電子メールや姓、名など）は送信できません。

ログインしているすべてのユーザーのユーザーIDを接続しました。しかし、彼らはuidをベースパラメータだけでなく、カスタムディメンション1でも複製しました（これにより、ユーザーIDビューでセグメントを使用できるようになりました）。

メインのGA JSコードでは、これは次のように行われます。

 ga('create', 'UA-XXXXX-Y', 'auto', { userId: USER_ID, 'dimension1': USER_ID }); ga('send', 'pageview');

これはGoogle Tag Managerを使用してよりエレガントに行うことができますが、これは別の記事のトピックです。

バックエンドからリクエストを送信するには、パラメーターを追加します。

 &uid=USER_ID&cd1=USER_ID

に

パラメータがあると、新しいセッションを初期化できません。

このパラメーターを使用しない場合、遅延イベントの場合、送信時に新しいセッションが空のパラメーターでGAに作成されます（トラフィックソースはdirect / noneになり、デバイスは（設定されていない）になり、地理はサーバーのIPに対して構築されます）。つまり、値を持たないセッションであり、統計カウンターを終了し、トラフィックソースに関するレポートを分解します。

たとえば、これが保留中のイベントである場合、CRMでトランザクションステータスが変更されます。通常、このトランザクションに割り当てられているユーザーがサイトでアクティブなセッションを持っていない場合に発生します。したがって、＆ni = 1を使用しないと、新しいセッションが作成されます。

一般的に、保留中のイベントには、＆ni = 1を使用します。

実際の測定プロトコル

GA標準トラッキングコード

実行中の最も標準的なJS GAコードでさえ、Measurement Protocolを使用します。仕組みを見てみましょう。

[開発ツール]パネル（CTRL + Shift + IまたはF12）でGoogle Chromeウィンドウを開きます。
アドレスバーにhabrahabr.ruと入力します。
開発者向けのパネルでは、[ネットワーク]タブに注目しています。開発者向けに最初にパネルを開いてからサイトを開いた場合-このタブには情報が含まれます。シーケンスが異なる場合、タブは空白になります。F5キーを押してページを再度開きます。
「Filter」行にwww.google-analytics.com/collectを書き込みます
リクエストの詳細を開きます。

同様の情報が表示されます。

リクエストURL：

 https://www.google-analytics.com/collect?v=1&_v=j50&a=643761009&t=pageview&_s=1&dl=https%3A%2F%2Fhabrahabr.ru%2F&ul=en-us&de=UTF-8&dt=%D0%9B%D1%83%D1%87%D1%88%D0%B8%D0%B5%20%D0%BF%D1%83%D0%B1%D0%BB%D0%B8%D0%BA%D0%B0%D1%86%D0%B8%D0%B8%20%D0%B7%D0%B0%20%D1%81%D1%83%D1%82%D0%BA%D0%B8%20%2F%20%D0%A5%D0%B0%D0%B1%D1%80%D0%B0%D1%85%D0%B0%D0%B1%D1%80&sd=24-bit&sr=1920x1080&vp=1109x966&je=0&fl=25.0%20r0&_u=QCCAgEAB~&jid=1630561303&cid=774042187.1492148509&tid=UA-726094-1&cd1=guest&cd4=no&cd5=other&z=1998272259

クエリ文字列パラメーター

 v:1 _v:j50 a:643761009 t:pageview _s:1 dl:https://habrahabr.ru/ ul:en-us de:UTF-8 dt:    /  sd:24-bit sr:1920x1080 vp:1109x966 je:0 fl:25.0 r0 _u:QCCAgEAB~ jid:1630561303 cid:774042187.1492148509 tid:UA-726094-1 cd1:guest cd4:no cd5:other z:1998272259

ここで何が見えますか？

GAに送信された多数のパラメーター。これは標準のページビューです。各パラメーターの説明については、公式ドキュメントを参照してください。

CRM統合

目標のコンバージョン率では、トラフィックソースの品質を完全に把握できないという状況に直面しています。

当社のウェブサイトの目標の1つは、無料の入門レッスンを申し込むことです。ユーザーがそれが何であるかを理解していないが、それでもフォームに記入する場合があります。当然、すべてのアプリケーションがCRMに分類され、営業チームに負荷がかかります。

GAでは、フォーム=変換が正常に完了したため、不適切なアプリケーションでも変換カウンターが終了します。

各トラフィックチャネルの品質をより詳細に評価するために、追加のパラメーター（ターゲットアプリケーションと入門レッスン）を導入することにしました。

これらのパラメータは両方とも、CRMのトランザクションのステータスによって判断できます。

トランザクションのステータスを変更するときに、CRMがWebhookをサーバーに送信できるため、以下を構成しました。

トランザクションがIntroductory Assignedステータスに変わると、イベント「Target Request」を送信します（たとえば、ec = Quality＆ea = Good_lead）
トランザクションのステータスがEntry completedになると、イベント「Entry completed」を送信します（たとえば、ec = Quality＆ea = 1Lesson_done）

各イベントに目標追跡を設定しました。その結果、ターゲットアプリケーションの数を見積もることができました。

トランザクション追跡

私たちは、請求だけでなく、支払い受付システムの口座でのお金の受領の事実を直接検討することにしました。

多くの場合、これは遅れたイベントです。彼らは銀行振込または支払い端末で支払うことにしました。また、例は「宅配便への現金支払い」です。

支払い受付システムが資金の受領を通知すると、Googleアナリティクスにトランザクションを送信します。

 v=1&tid=UA-12345678-1&cid=455045511.1409504244&uid=12345&t=event&tr=225&pa=Transaction&ec=Oplata&ea=Individ&ev=225&ni=1&pr1id=12345_individual_id&pr1nm=Individ&pr1pr=225&pr1qt=1

払い戻しまたは一部払い戻し

より正確な統計を得るために、GAには返品（トランザクションのキャンセル）を処理する機能があります。

非常にまれなケースがあるため、自動化しませんでした。

公式ドキュメントの例：

  // Refund an entire transaction and send with a non-interaction event. v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=event // Event hit type. &ec=Ecommerce // Event Category. Required. &ea=Refund // Event Action. Required. &ni=1 // Non-interaction parameter. &ti=T12345 // Transaction ID. Required. &pa=refund // Product action (refund). Required.

詳細はこちら：

developers.google.com/analytics/devguides/collection/protocol/v1/devguide#enhancedecom

オフラインPOS

出席者

Webに情報を送信する機能を備えた店舗訪問者カウンター（オフライン）があります。測定プロトコルを使用して、この情報をGoogleアナリティクスに転送できます。 GAにページビューを送信すると、マーケティング活動がオフラインポイントのトラフィックにどのように影響するかを追跡できます。

取引

すべての支払いはGAに送信することもできます。ここでは、既にUserIDを使用できます。

将来的には、オフラインで買い物をするユーザーとオンラインで買い物をするユーザーをセグメント化できるようになります。

マーケティング担当者はあなたに感謝します。

オープニングレター

Measurement ProtocolはGETリクエストで機能するため、ニュースレターに写真を追加することを妨げるものはありません。

 <img src=”https://www.google-analytics.com/collect?v=1&tid=UA-123456-1&cid=1482535147.1490885188&uid=12345&t=event&ec=email&ea=open&dp=%2Fletter_name&z=12345”>

メッセージを残しているユーザーに応じて、z、uid、cidパラメーターを置き換えます。

dp（ドキュメントパス）-どの文字が開かれたかを明確にします。

追加のリソース

→ 公式ドキュメント

→ パラメーターの詳細な説明

→ 送信されたデータの正確性をチェックするサービス

図書館：

PHP： github.com/theiconic/php-ga-measurement-protocol

Python： github.com/mirumee/google-measurement-protocol

NodeJS： github.com/peaksandpies/universal-analytics

Ruby： github.com/tpitale/staccato

結論

Measurement Protocolは、Googleアナリティクスのインタラクションのアップロードを自動化できる非常に強力なツールです。これは、一般的な分析に役立ち、マーケティング活動にとって大きなボーナスになります。

測定プロトコルも使用する場合-コメントにケースを記入してください！

Habr読者のためのEnglishDomからのボーナス

オンライン講座

「オンラインコース」の独立した学習のために、英語コースに1年間アクセスできます。

アクセスするには、単にリンクをクリックしてください。

Skypeで個別に

ITプロフェッショナル向けの専門英語コース

クラスはいつでも開催できます。

15％割引コード：habra215

5月1日まで有効です。支払い時に入力するか、リンクを使用します。

学生の中には、すでにHabr、GeekBrains、ITVDN、GoIT、BrainBasket、Softengi、Netologyの学生がいます。今すぐ参加しよう！

GA測定プロトコル-完全ガイド

技術面