Podstawy raportowania konwersji

Ten przewodnik wyjaśnia, jak korzystać z funkcji raportowania konwersji w Google Analytics Data API w wersji 1. Ta funkcja umożliwia generowanie raportów skupiających się na zdarzeniach konwersji z obsługą różnych modeli atrybucji. Raporty o konwersjach utworzone za pomocą Data API są podobne do raportów atrybucji, które można znaleźć w sekcji Reklamy > Konwersje interfejsu Google Analytics. Więcej informacji znajdziesz w artykule w Centrum pomocy Raport skuteczności 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 przeciwieństwie do standardowych raportów opartych na zdarzeniach, które zliczają tylko zdarzenia, raportowanie konwersji stosuje model atrybucji, aby rozdzielić udział między punkty styczności, 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 zrozumienia ogólnej aktywności w usłudze.
  • Raporty o konwersjach: skupiają się na zdarzeniach oznaczonych jako konwersje. Używają one określonych wymiarów i danych (patrz Schemat raportów o konwersjach) i umożliwiają wyświetlanie przypisanych danych na podstawie modeli takich jak model oparty na danych lub model ostatniego kliknięcia.

Włączanie raportów o konwersjach

Aby uruchomić raport o konwersjach, użyj metody runReport. Żądanie jest traktowane jako raport o konwersjach, jeśli zawiera zapytanie o co najmniej 1 dane 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 należy użyć. Obsługiwane wartości to DATA_DRIVEN (domyślna) i LAST_CLICK.

Generowanie raportu o konwersjach

Oto przykładowe żądanie używające metody runReport do wygenerowania raportu o konwersjach, który pokazuje konwersje według nazwy kampanii z użyciem modelu atrybucji opartego na danych.

HTTP

Otwórz w narzędziu 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 utworzenie raportu skuteczności konwersji

Ten przykład pokazuje, jak najpierw pobrać dostępne działania powodujące konwersję w usłudze, a następnie użyć ich do utworzenia raportu podobnego do raportu skuteczności konwersji wyświetlanego 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 usłudze, wywołaj metodę getMetadata. Aby zobaczyć działania powodujące konwersję utworzone w Twojej usłudze, 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. Uruchom raport

Wywołaj metodę runReport. Aby filtrować raport, użyj identyfikatorów działań powodujących konwersję znalezionych w kroku 1 lub pozostaw pole conversionActions puste, aby raportować wszystkie konwersje. To żądanie ponownie tworzy raport skuteczności konwersji w interfejsie, wyświetlając kliknięcia reklam, koszt reklam, koszt kliknięcia, 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 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. Zobacz schemat raportów o konwersjach.