Grundlagen von Conversion-Berichten

In diesem Leitfaden wird erläutert, wie Sie die Conversion-Berichtsfunktion in der Google Analytics Data API v1 verwenden. Mit dieser Funktion können Sie Berichte erstellen, die sich auf Conversion-Ereignisse konzentrieren, und verschiedene Attributionsmodelle verwenden. Conversion-Berichte, die mit der Data API erstellt werden, ähneln den Attributionsberichten, die Sie in der Google Analytics-Benutzeroberfläche im Bereich Werbung > Conversions finden. Weitere Informationen finden Sie im Hilfeartikel Leistungsbericht zu Conversions.

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 die Rohanzahl von Ereignissen (z.B. eventCount) und sind nützlich, um die allgemeine Aktivität in Ihrer Property zu verstehen.
  • Conversion-Berichte: Hier liegt der Schwerpunkt 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 auszuführen. Eine Anfrage wird als Conversion-Bericht behandelt, wenn sie einen oder mehrere Conversion-Messwerte abfragt (z. B. allConversionsByInteractionDate) oder wenn das Feld conversionSpec im Anfragetext ausgefüllt ist.

Das Objekt conversionSpec 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 leer, werden alle Conversions einbezogen. 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 Methode runReport, um einen Conversion-Bericht zu erstellen, in dem Conversions nach Kampagnenname mit dem datengetriebenen Attributionsmodell angezeigt werden.

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 Sie die für Ihre Property erstellten Conversion-Aktionen sehen können.

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 in Schritt 1 ermittelten Conversion-Aktions-IDs, um den 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 neu erstellt. Er enthält Anzeigenklicks, Anzeigenkosten, Anzeigenkosten pro Klick, Anzeigenkosten pro Conversion, Anzeigenimpressionen, ROAS (Return on Advertising Spend), Gesamteinnahmen und alle Conversions nach Standard-Channelgruppe.

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 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 gesetzt ist.

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