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 konwersji utworzone za pomocą Data API są podobne do raportów atrybucji , które znajdziesz w interfejsie Google Analytics UI w sekcji Advertising > Conversions. 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 konwersji 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 konwersji: skupiają się na zdarzeniach oznaczonych jako konwersje. Używają one określonych wymiarów i danych (patrz Schemat raportów konwersji) i umożliwiają wyświetlanie przypisanych danych na podstawie modeli takich jak model oparty na danych czy model ostatniego kliknięcia.

Włączanie raportów konwersji

Aby uruchomić raport konwersji, użyj metody runReport. Żądanie jest traktowane jako raport konwersji, 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 konwersji

Oto przykładowe żądanie używające metody runReport do wygenerowania raportu konwersji pokazującego 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 uwzględnić wszystkie konwersje. To żądanie ponownie tworzy raport skuteczności konwersji w interfejsie, wyświetlając kliknięcia reklam, koszt reklam, koszt reklamy na kliknięcie, koszt reklamy na wszystkie konwersje, wyświetlenia reklam, zwrot z nakładów na reklamę, łączny przychód 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 konwersji, sprawdź, czy pole metadata.section w odpowiedzi ma wartość SECTION_ADVERTISING.

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