コンバージョン レポートの基本

このガイドでは、Google アナリティクス Data API v1 のコンバージョン レポート機能の使用方法について説明します。この機能を使用すると、さまざまなアトリビューション モデルをサポートするコンバージョン イベントに焦点を当てたレポートを生成できます。 Data API で作成されたコンバージョン レポートは、Google アナリティクス UI の [広告 > コンバージョン] セクションにあるアトリビューション レポートに似ています。詳しくは、コンバージョン パフォーマンス レポートに関するヘルプセンターの記事をご覧ください。

コンバージョン レポートの目的

コンバージョン レポートを使用すると、コンバージョンを特定のキャンペーン、ソース、メディアに帰属させることで、マーケティング活動の効果を分析できます。イベントのみをカウントする標準のイベントベースのレポートとは異なり、コンバージョン レポートでは、コンバージョンにつながったタッチポイントに貢献度を分配するためにアトリビューション モデルが適用されます。

コンバージョン レポートとイベントベースのレポート

  • イベントベースのレポート: イベントの生カウント（eventCountなど）を提供し、プロパティの一般的なアクティビティを把握するのに役立ちます。
  • コンバージョン レポート: コンバージョンとしてマークされたイベントに焦点を当てます。特定のディメンションと指標（ コンバージョン レポートのスキーマを参照） を使用し、データドリブンや ラストクリックなどのモデルに基づいて帰属データを表示できます。

コンバージョン レポートを有効にする

コンバージョン レポートを実行するには、 runReport メソッドを使用します。1 つ以上の コンバージョン指標（たとえば、 allConversionsByInteractionDate）をクエリする場合、またはリクエスト本文に conversionSpec フィールドが入力されている場合、リクエストはコンバージョン レポートとして扱われます。

conversionSpec オブジェクトには次のフィールドが含まれます。

  • conversionActions: レポートに含めるコンバージョン アクション リソース名のリスト（["conversionActions/12345"] など）。空の場合、すべてのコンバージョンが含まれます。有効なコンバージョン アクション ID は、GetMetadata メソッドのレスポンスの conversions リスト内の conversion_action フィールドから取得できます。
  • attributionModel: 使用するアトリビューション モデル。サポートされている値は、DATA_DRIVEN（デフォルト）と LAST_CLICK です。

コンバージョン レポートを生成する

以下は、runReport メソッドを使用して、データドリブン アトリビューション モデルを使用して キャンペーン名別のコンバージョンを示すコンバージョン レポートを生成するリクエストのサンプルです。

HTTP

API Explorer で開く 
{
    "dateRanges": [
        {
            "startDate": "2026-04-01",
            "endDate": "2026-04-30"
        }
    ],
    "dimensions": [
        {
            "name": "campaignName"
        }
    ],
    "metrics": [
        {
            "name": "allConversionsByConversionDate"
        }
    ],
    "conversionSpec": {
        "conversionActions": [],
        "attributionModel": "DATA_DRIVEN"
    }
}

例: コンバージョン パフォーマンス レポートを再作成する

この例では、まずプロパティで使用可能なコンバージョン アクション を取得し、それを使用して、[Google アナリティクス UI] の [広告 > コンバージョン > コンバージョン パフォーマンス] に表示されるコンバージョン パフォーマンス レポートと同様のレポートを作成する方法を示します。

ステップ 1: コンバージョン アクションを取得する

getMetadata メソッドを呼び出して、プロパティの有効なコンバージョン アクション ID を確認します。プロパティ用に作成されたコンバージョン アクションを表示するには、すべてのプロパティに共通するフィールドを取得するために 0 を使用するのではなく、GA プロパティ ID を指定してください。

レスポンスには、使用可能なコンバージョン アクションを含む conversions リストが含まれます。

{
  ...

  "conversions": [
    {
      "conversionAction": "conversionActions/12345",
      "displayName": "purchase"
    },
    {
      "conversionAction": "conversionActions/67890",
      "displayName": "sign_up"
    }
  ]
}

ステップ 2: レポートを実行する

runReport メソッドを呼び出します。 ステップ 1 で見つけたコンバージョン アクション ID を使用してレポートをフィルタするか、conversionActions を空のままにしてすべてのコンバージョンをレポートします。このリクエストでは、広告のクリック数、広告費用、クリック単価、すべてのコンバージョンあたりの広告費用、広告のインプレッション数、広告費用対効果、総収益、すべてのコンバージョンをデフォルト チャネル グループ別に表示して、コンバージョン パフォーマンス UI レポートを再作成します。

HTTP

API Explorer で開く 
{
    "dateRanges": [
        {
            "startDate": "2026-04-01",
            "endDate": "2026-04-30"
        }
    ],
    "dimensions": [
        {
            "name": "defaultChannelGroup"
        }
    ],
    "metrics": [
        {
            "name": "allConversionsByInteractionDate"
        },
        {
            "name": "advertiserAdCost"
        },
        {
            "name": "advertiserAdCostPerAllConversionsByInteractionDate"
        },
        {
            "name": "advertiserAdImpressions"
        },
        {
            "name": "advertiserAdClicks"
        },
        {
            "name": "advertiserAdCostPerClick"
        },
        {
            "name": "totalRevenueByInteractionDate"
        },
        {
            "name": "returnOnAdSpendByInteractionDate"
        }
    ],
    "conversionSpec": {
        "conversionActions": [
            "conversionActions/12345"
        ],
        "attributionModel": "DATA_DRIVEN"
    }
}

このリクエストのレスポンスのサンプルは次のようになります。

{
  "dimensionHeaders": [
    {
      "name": "defaultChannelGroup"
    }
  ],
  "metricHeaders": [
    {
      "name": "allConversionsByInteractionDate",
      "type": "TYPE_FLOAT"
    },
    {
      "name": "advertiserAdCost",
      "type": "TYPE_CURRENCY"
    },
    {
      "name": "advertiserAdCostPerAllConversionsByInteractionDate",
      "type": "TYPE_CURRENCY"
    },
    {
      "name": "advertiserAdImpressions",
      "type": "TYPE_INTEGER"
    },
    {
      "name": "advertiserAdClicks",
      "type": "TYPE_INTEGER"
    },
    {
      "name": "advertiserAdCostPerClick",
      "type": "TYPE_CURRENCY"
    },
    {
      "name": "totalRevenueByInteractionDate",
      "type": "TYPE_CURRENCY"
    },
    {
      "name": "returnOnAdSpendByInteractionDate",
      "type": "TYPE_FLOAT"
    }
  ],
  "rows": [
    {
      "dimensionValues": [
        {
          "value": "Paid Search"
        }
      ],
      "metricValues": [
        {
          "value": "75.2"
        },
        {
          "value": "500"
        },
        {
          "value": "6.65"
        },
        {
          "value": "10000"
        },
        {
          "value": "500"
        },
        {
          "value": "1"
        },
        {
          "value": "1500"
        },
        {
          "value": "3"
        }
      ]
    }
  ],
  "rowCount": 1,
  "metadata": {
    "schemaRestrictionResponse": {},
    "currencyCode": "USD",
    "timeZone": "America/Los_Angeles",
    "section": "SECTION_ADVERTISING"
  },
  "kind": "analyticsData#runReport"
}

レスポンスがコンバージョン レポートとして扱われたことを確認するには、レスポンスの metadata.section フィールドが SECTION_ADVERTISING に設定されていることを確認します。

コンバージョン レポートで使用可能なディメンションと指標の完全なリストについては、 コンバージョン レポートのスキーマをご覧ください。