Grundlagen von Conversion-Berichten

In diesem Leitfaden wird erläutert, wie Sie die Funktion für Conversion-Berichte in der Google Analytics Data API v1 verwenden. Mit dieser Funktion können Sie Berichte zu Conversion-Ereignissen mit Unterstützung für verschiedene Attributionsmodelle erstellen. Conversion-Berichte, die mit der Data API erstellt wurden, ähneln den Attributionsberichten im Bereich Werbung > Conversions der Google Analytics-Benutzeroberfläche. Weitere Informationen finden Sie im Bericht zur Conversion-Leistung Hilfeartikel.

Zweck von Conversion-Berichten

Mit Conversion-Berichten können Sie die Effektivität Ihrer Marketingmaßnahmen analysieren, indem Sie Conversions bestimmten Kampagnen, Quellen und Medien zuordnen. Im Gegensatz zu standardmäßigen ereignisbasierten Berichten, in denen nur Ereignisse gezählt werden, wird bei Conversion-Berichten ein Attributionsmodell angewendet, um den Beitrag auf die Touchpoints zu verteilen, die zu einer Conversion geführt haben.

Conversions im Vergleich zu ereignisbasierten Berichten

  • Ereignisbasierte Berichte: enthalten Rohdaten zu Ereignissen (z.B. eventCount) und sind nützlich, um allgemeine Aktivitäten in Ihrer Property zu verstehen.
  • Conversion-Berichte: konzentrieren sich auf Ereignisse, die als Conversions markiert wurden. Sie verwenden bestimmte Dimensionen und Messwerte (siehe das Conversion-Berichtsschema) und ermöglichen es Ihnen, zugeordnete Daten basierend auf Modellen wie „Datengetrieben“ oder „Letzter Klick“ zu sehen.

Conversion-Berichte aktivieren

Verwenden Sie die runReport Methode, um einen Conversion-Bericht auszuführen. Eine Anfrage wird als Conversion-Bericht behandelt, wenn sie eine oder mehrere Conversion-Messwerte abfragt (z. B. allConversionsByInteractionDate) oder wenn das Feld conversionSpec im Anfragetext ausgefüllt ist.

Das conversionSpec Objekt enthält die folgenden Felder:

  • conversionActions: Eine Liste der Ressourcennamen von Conversion-Aktionen, die in den Bericht aufgenommen werden sollen (z.B. ["conversionActions/12345"]). Wenn das Feld leer ist, werden alle Conversions berücksichtigt. Gültige Conversion-Aktions-IDs können aus dem Feld conversion_action in der Liste conversions in der Antwort der Methode GetMetadata abgerufen werden.
  • attributionModel: Das zu verwendende Attributionsmodell. Unterstützte Werte sind DATA_DRIVEN (Standard) und LAST_CLICK.

Conversion-Bericht erstellen

Hier ist eine Beispielanfrage mit der runReport Methode, um einen Conversion-Bericht zu erstellen, in dem Conversions nach Kampagnennamen mit dem datengetriebenen Attributionsmodell angezeigt werden.

HTTP

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

Beispiel: Bericht zur Conversion-Leistung neu erstellen

In diesem Beispiel wird gezeigt, wie Sie zuerst die verfügbaren Conversion-Aktionen für eine Property abrufen und sie dann verwenden, um einen Bericht zu erstellen, der dem Bericht zur Conversion-Leistung auf der Google Analytics-Benutzeroberfläche unter Werbung > Conversions > Conversion-Leistung ähnelt.

Schritt 1: Conversion-Aktionen abrufen

Rufen Sie die getMetadata Methode auf, um die gültigen Conversion-Aktions-IDs für Ihre Property zu finden. Geben Sie die Google Analytics-Property-ID an (anstatt 0 zu verwenden, um Felder abzurufen, die für alle Properties gleich sind), damit Conversion-Aktionen angezeigt werden, die für Ihre Property erstellt wurden.

Die Antwort enthält eine Liste conversions mit den verfügbaren Conversion-Aktionen:

{
  ...

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

Schritt 2: Bericht ausführen

Rufen Sie die runReport Methode auf. Verwenden Sie die in Schritt 1 gefundenen Conversion-Aktions-IDs, um Ihren Bericht zu filtern, oder lassen Sie conversionActions leer, um einen Bericht zu allen Conversions zu erstellen. Mit dieser Anfrage wird ein Bericht zur Conversion-Leistung auf der Benutzeroberfläche neu erstellt, in dem standardmäßig Werbeklicks, Anzeigenkosten, Anzeigenkosten pro Klick, Anzeigenkosten pro alle Conversions, Anzeigenimpressionen, Return on Advertising Spend, Gesamtumsatz und alle Conversions nach Standard-Channel-Gruppe angezeigt werden.

HTTP

Im API Explorer öffnen 
{
    "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"
    }
}

Hier ist eine Beispielantwort für diese Anfrage:

{
  "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"
}

Sie können prüfen, ob die Antwort als Conversion-Bericht behandelt wurde, indem Sie prüfen, ob das Feld metadata.section in der Antwort auf SECTION_ADVERTISING festgelegt ist.

Eine vollständige Liste der verfügbaren Dimensionen und Messwerte für Conversion-Berichte finden Sie unter Conversion Reports Schema.