このページは Cloud Translation API によって翻訳されました。

Measurement Protocol イベントを Google アナリティクスに送信する

このガイドでは、Google Chat のメッセージ履歴を Google アナリティクス Measurement Protocol のウェブおよびアプリストリームイベントを Measurement Protocol イベントを表示するための Google アナリティクスのレポート。

このガイドで説明を希望するプラットフォームを選択してください。

リクエストの形式を設定

Google アナリティクス Measurement Protocol は、HTTP POST リクエストのみをサポートしています。

イベントを送信するには、次の形式を使用してください。

POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>

リクエスト URL に次の情報を必ず含めてください。

api_secret: Google アナリティクス管理画面で生成される API Secret。

新しい Secret を作成するには、[管理] > [データストリーム] > ストリームを選択 > [Measurement Protocol] > [作成] の順にクリックします。

measurement_id: ストリームに関連付けられた測定 ID。この ID は、Google アナリティクス管理画面の [管理] > [データストリーム] > ストリームを選択 > [測定 ID] で確認できます。

measurement_id は、ストリーム ID ではありません。

詳しくは、クエリパラメータをご覧ください。

リクエスト本文には、次の情報を必ず含めてください。

client_id: クライアントの一意の識別子。これは、Firebase の app_instance_id とは異なります。gtag.js('get') を使用してください。

user_id: 省略可。ユーザーの一意の識別子。使用できるのは UTF-8 のみですあります。この識別子について詳しくは、クロスプラットフォーム分析用の User-ID をご覧ください。
consent: 省略可。同意設定の設定方法をご確認ください。
timestamp_micros: 省略可。マイクロ秒単位の Unix エポック時刻。リクエスト内のイベントとユーザープロパティ。指定しない場合、リクエスト時刻。
events: イベント項目の配列。1 つのイベントに複数のイベントを含めることができるリクエストできます。

ユーザーアクティビティをレポートに表示する方法はリアルタイム、 engagement_time_msec と session_id は、 event は params。engagement_time_msec パラメータは次のようになります。イベントのエンゲージメント時間（ミリ秒単位）。

次の例をご覧ください。

  {
   "client_id": "123456.7654321",
   "events": [
     {
        "name": "campaign_details",
        "params": {
          "campaign_id": "google_1234",
          "campaign": "Summer_fun",
          "source": "google",
          "medium": "cpc",
          "term": "summer+travel",
          "content": "logolink",
          "session_id": "123",
          "engagement_time_msec": "100"
        }
     }
   ]
  }

session_start は予約済みのイベント名ですが、新しい session_id を作成すると、session_start を送信しなくても新たなセッションを作成できます。セッション数のカウント方法を理解しましょう。

試してみる

以下の例では、tutorial_begin イベントを Google 分析サーバー:

const measurement_id = `G-XXXXXXXXXX`;
const api_secret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurement_id}&api_secret=${api_secret}`, {
  method: "POST",
  body: JSON.stringify({
    client_id: 'XXXXXXXXXX.YYYYYYYYYY',
    events: [{
      name: 'tutorial_begin',
      params: {},
    }]
  })
});

タイムスタンプをオーバーライド

Measurement Protocol では、次のリストで見つかった最初のタイムスタンプが使用されます。リクエストの各イベントに対して行われます。

イベントの timestamp_micros。
リクエストの timestamp_micros。
Measurement Protocol がリクエストを受信した時刻。

次の例では、リクエストレベルのタイムスタンプを渡されます。そのため、Measurement Protocol では測定対象と tutorial_begin イベントと join_group イベントのタイムスタンプ: requestUnixEpochTimeInMicros。

{
  "timestamp_micros": requestUnixEpochTimeInMicros,
  "events": [
    {
      "name": "tutorial_begin"
    },
    {
      "name": "join_group",
      "params": {
        "group_id": "G_12345",
      }
    }
  ]
}

次の例では、リクエストレベルのタイムスタンプとイベントレベルのタイムスタンプの両方を送信します。あります。そのため、Measurement Protocol は tutorial_begin を割り当てます。タイムスタンプ tutorialBeginUnixEpochTimeInMicros、join_group をイベントにタイムスタンプ requestUnixEpochTimeInMicros を付加します。

{
  "timestamp_micros": requestUnixEpochTimeInMicros,
  "events": [
    {
      "name": "tutorial_begin",
      "timestamp_micros": tutorialBeginUnixEpochTimeInMicros
    },
    {
      "name": "join_group",
      "params": {
        "group_id": "G_12345",
      }
    }
  ]
}

制限事項

Measurement Protocol イベントを Google アナリティクスに送信する際には、次の制限が適用されます。

リクエスト内で指定できるイベントは 25 個までです。
イベント内で指定できるパラメータは 25 個までです。
イベント内で指定できるユーザープロパティは 25 個までです。
ユーザープロパティ名は半角 24 文字（全角 12 文字）以下にする必要があります。
ユーザープロパティ値は半角 36 文字（全角 18 文字）以下にする必要があります。
イベント名は半角 40 文字以下にして、先頭を英字にする必要があります。使用できる文字は英数字とアンダースコアのみです。
アイテムパラメータなどのパラメータ名は半角 40 文字以下にして、先頭を英字にする必要があります。使用できる文字は英数字とアンダースコアのみです。
アイテムパラメータなどのパラメータ値は半角 100 文字（全角 50 文字）通常の Google アナリティクスプロパティの場合は 500 文字以下、 Google アナリティクス 360 のプロパティの一例です
アイテムパラメータに指定できるカスタムパラメータの数は 10 個までです。
POST 本文は 130 KB 未満にする必要があります。
Google アナリティクスに送信されたアプリの Measurement Protocol イベントで、Google 検索にデータが入力されない Google 広告でアプリユーザーを対象にできます

各ユースケースの追加要件については、一般的なユースケースをご覧ください。