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 przez 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 rozdzielić udział między punkty styczności z klientem, które doprowadziły do konwersji.

Konwersje a raporty oparte na zdarzeniach

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

Włączanie raportów konwersji

Aby wygenerować raport konwersji, użyj metody runReport. Żądanie jest traktowane jako raport konwersji, jeśli wysyła zapytanie o co najmniej 1 rodzaj 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, którego chcesz używać. Obsługiwane wartości to DATA_DRIVEN (domyślna) i LAST_CLICK.

Generowanie raportu konwersji

Oto przykładowe żądanie, które używa metody runReport do wygenerowania raportu konwersji pokazującego konwersje według nazwy kampanii z zastosowaniem modelu atrybucji opartej na danych.

HTTP

Otwórz w narzędziu APIs 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 przypadku usługi, a potem użyć ich do utworzenia raportu podobnego do raportu skuteczności konwersji widocznego 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 przypadku Twojej usługi, wywołaj metodę getMetadata. Aby zobaczyć działania powodujące konwersję utworzone dla Twojej usługi, podaj identyfikator usługi GA (zamiast używać 0 do pobierania pól wspólnych 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. Wygeneruj raport

Wywołaj metodę runReport. Użyj identyfikatorów działań powodujących konwersję z kroku 1, aby przefiltrować raport, lub pozostaw pole conversionActions puste, aby raport obejmował wszystkie konwersje. To żądanie odtwarza raport UI skuteczności konwersji, pokazując kliknięcia reklam, koszt reklamy, koszt reklamy na kliknięcie, 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 narzędziu APIs 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"
}

Możesz sprawdzić, czy odpowiedź została potraktowana jako raport konwersji, sprawdzając, czy pole metadata.section w odpowiedzi ma wartość SECTION_ADVERTISING.

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