Grundlagen von Conversion-Berichten

In diesem Leitfaden wird beschrieben, wie Sie die Conversion-Berichtsfunktion in der Google Analytics Data API v1 verwenden. Mit dieser Funktion können Sie Berichte zu Conversion-Ereignissen erstellen, die verschiedene Attributionsmodelle unterstützen. Mit der Data API erstellte Conversion-Berichte ähneln den Attributionsberichten, die Sie in der Google Analytics-Benutzeroberfläche im Bereich Werbung > Conversions finden. Weitere Informationen finden Sie im Hilfeartikel zum Conversion-Leistungsbericht.

Zweck von Conversion-Berichten

Mithilfe von Conversion-Berichten können Sie die Effektivität Ihrer Marketingmaßnahmen analysieren, indem Sie Conversions bestimmten Kampagnen, Quellen und Media zuordnen. Im Gegensatz zu Standardberichten, die auf Ereignissen basieren und nur Ereignisse zählen, 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: Diese Berichte enthalten Rohzahlen für Ereignisse (z.B. eventCount) und sind nützlich, um die allgemeine Aktivität in Ihrer Property zu analysieren.
  • Conversions-Berichte: Hier liegt der Fokus auf Ereignissen, die als Conversions markiert wurden. Sie verwenden bestimmte Dimensionen und Messwerte (siehe Schema für Conversion-Berichte) und ermöglichen es Ihnen, zugeordnete Daten basierend auf Modellen wie „Datengetrieben“ oder „Letzter Klick“ zu sehen.

Conversion-Berichte aktivieren

Verwenden Sie die Methode runReport, um einen Conversion-Bericht zu erstellen. Eine Anfrage wird als Conversion-Bericht behandelt, wenn sie einen oder mehrere Conversion-Messwerte (z. B. allConversionsByInteractionDate) abfragt 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 die Liste 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 (Standardeinstellung) und LAST_CLICK.

Conversion-Bericht erstellen

Hier ist ein Beispiel für eine Anfrage mit der Methode runReport, um einen Conversion-Bericht mit Conversions nach Kampagnennamen mit dem datengetriebenen Attributionsmodell zu generieren.

HTTP

Im APIs 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 dann damit einen Bericht erstellen, der dem Bericht zur Conversion-Leistung in der Google Analytics-Benutzeroberfläche unter Werbung > Conversions > Conversion-Leistung ähnelt.

Schritt 1: Conversion-Aktionen abrufen

Rufen Sie die Methode getMetadata auf, um die gültigen Conversion-Aktions-IDs für Ihre Property zu ermitteln. Geben Sie die GA-Property-ID an (anstatt 0 zu verwenden, um Felder abzurufen, die für alle Properties gelten), damit die für Ihre Property erstellten Conversion-Aktionen angezeigt werden.

Die Antwort enthält eine conversions-Liste 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 Methode runReport auf. Verwenden Sie die Conversion-Aktions-IDs aus Schritt 1, um Ihren Bericht zu filtern, oder lassen Sie conversionActions leer, um Berichte zu allen Conversions zu erstellen. Mit dieser Anfrage wird ein Bericht zur Conversion-Leistung in der Benutzeroberfläche erstellt, in dem standardmäßig Werbeklicks, Werbekosten, Werbekosten pro Klick, Werbekosten pro Conversion, Anzeigenimpressionen, ROAS (Return on Advertising Spend), Gesamteinnahmen und alle Conversions nach Standardchannelgruppe angezeigt werden.

HTTP

Im APIs 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 auf 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 das Feld metadata.section in der Antwort auf den Wert SECTION_ADVERTISING prüfen.

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