Podstawy raportowania konwersji

Z tego przewodnika dowiesz się, jak korzystać z funkcji raportowania konwersji w interfejsie Google Analytics Data API w wersji 1. Ta funkcja umożliwia generowanie raportów dotyczących zdarzeń konwersji z obsługą różnych modeli atrybucji. Raporty konwersji utworzone za pomocą interfejsu Data API są podobne do raportów atrybucji, które można znaleźć w sekcji Reklamy > Konwersje w interfejsie Google Analytics. Więcej informacji znajdziesz w artykule w Centrum pomocy na temat raportu Skuteczność konwersji.

Cel raportowania konwersji

Raportowanie konwersji umożliwia analizowanie skuteczności działań marketingowych poprzez przypisywanie konwersji do konkretnych kampanii, źródeł i mediów. W odróżnieniu od standardowych raportów opartych na zdarzeniach, które tylko zliczają zdarzenia, raportowanie konwersji stosuje model atrybucji, aby rozdzielać udział między punkty styczności z klientem, które doprowadziły do konwersji.

Raporty o konwersjach a raporty oparte na zdarzeniach

  • Raporty oparte na zdarzeniach: zawierają surowe liczby zdarzeń (np. eventCount) i są przydatne do poznawania ogólnej aktywności w usłudze.
  • Raporty o konwersjach: skupiają się na zdarzeniach oznaczonych jako konwersje. Korzystają one z określonych wymiarów i rodzajów danych (patrz schemat raportów o konwersjach) i umożliwiają wyświetlanie przypisanych danych na podstawie modeli takich jak atrybucja oparta na danych czy ostatnie kliknięcie.

Włączanie raportów o konwersjach

Aby wygenerować raport o konwersjach, użyj metody runReport. Żądanie jest traktowane jako raport o konwersjach, jeśli wysyła zapytanie do co najmniej 1 rodzaju danych o konwersjach (np. allConversionsByInteractionDate) lub jeśli w treści żądania jest wypełnione pole conversionSpec.

Obiekt conversionSpec zawiera te pola:

  • conversionActions: lista nazw zasobów działań powodujących konwersję, które mają być uwzględnione w raporcie (np. ["conversionActions/12345"]). Jeśli jest pusta, uwzględniane są wszystkie konwersje. Prawidłowe identyfikatory działań powodujących konwersję można pobrać z pola conversion_action na liście conversions w odpowiedzi metody GetMetadata.
  • attributionModel: model atrybucji do użycia. Obsługiwane wartości to DATA_DRIVEN (domyślna) i LAST_CLICK.

Generowanie raportu o konwersjach

Oto przykładowe żądanie wykorzystujące metodę runReport do wygenerowania raportu o konwersjach z podziałem na nazwy kampanii z użyciem modelu atrybucji opartej na danych.

HTTP

Otwórz w API Explorer 
{
    "dateRanges": [
        {
            "startDate": "2026-04-01",
            "endDate": "2026-04-30"
        }
    ],
    "dimensions": [
        {
            "name": "campaignName"
        }
    ],
    "metrics": [
        {
            "name": "allConversionsByConversionDate"
        }
    ],
    "conversionSpec": {
        "conversionActions": [],
        "attributionModel": "DATA_DRIVEN"
    }
}

Przykład: ponowne tworzenie raportu Skuteczność konwersji

Ten przykład pokazuje, jak najpierw pobrać dostępne działania powodujące konwersję w usłudze, a potem użyć ich do utworzenia raportu podobnego do raportu Skuteczność konwersji, który jest widoczny w interfejsie Google Analytics w sekcji Reklamy > Konwersje > Skuteczność konwersji.

Krok 1. Pobierz działania powodujące konwersję

Aby znaleźć prawidłowe identyfikatory działań powodujących konwersję w swojej usłudze, wywołaj metodę getMetadata. Aby wyświetlić działania powodujące konwersję utworzone w usłudze, podaj identyfikator usługi w GA (zamiast używać znaku 0, aby uzyskać pola wspólne dla wszystkich usług).

Odpowiedź zawiera listę conversions z dostępnymi działaniami powodującymi konwersję:

{
  ...

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

Krok 2. Uruchom raport

Wywołaj metodę runReport. Użyj identyfikatorów działań powodujących konwersję z kroku 1, aby filtrować raport, lub pozostaw pole conversionActions puste, aby raportować wszystkie konwersje. To żądanie odtwarza raport interfejsu Skuteczność konwersji, wyświetlając kliknięcia reklam, koszt reklam, koszt kliknięcia reklamy, koszt reklamy na wszystkie konwersje, wyświetlenia reklam, zwrot z nakładów na reklamę, łączne przychody i wszystkie konwersje według domyślnej grupy kanałów.

HTTP

Otwórz w 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"
    }
}

Oto przykładowa odpowiedź na to żądanie:

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

Aby sprawdzić, czy odpowiedź została potraktowana jako raport o konwersjach, sprawdź, czy pole metadata.section w odpowiedzi ma wartość SECTION_ADVERTISING.

Pełną listę dostępnych wymiarów i danych w raportach o konwersjach znajdziesz w schemacie raportów o konwersjach.