Ta strona została przetłumaczona przez Cloud Translation API.

Tworzenie raportu

Ten przewodnik wyjaśnia, jak utworzyć podstawowy raport na podstawie danych Analytics za pomocą interfejsu Google Analytics Data API w wersji 1. Raporty z interfejsu Data API w wersji 1 są podobne do raportów, które możesz generować w sekcji Raporty w interfejsie Google Analytics.

W tym przewodniku omawiamy podstawowe funkcje raportowania, czyli ogólną funkcję raportowania w interfejsie Data API. Interfejs Data API w wersji 1 zawiera też specjalistyczne raporty w czasie rzeczywistym i raporty ścieżek.

runReport to zalecana metoda wykonywania zapytań. Jest ona używana we wszystkich przykładach w tym przewodniku. Omówienie innych podstawowych metod raportowania znajdziesz w sekcji Zaawansowane funkcje. Aby przetestować zapytania, użyj Eksploratora zapytań.

Raporty – omówienie

Raporty to tabele danych zdarzeń w usłudze w Google Analytics. Każda tabela raportu zawiera wymiary i dane żądane w zapytaniu, z danymi w poszczególnych wierszach.

Użyj filtrów, aby zwrócić tylko wiersze spełniające określony warunek, oraz przewijania, aby poruszać się po wynikach.

Oto przykładowa tabela raportu, która zawiera 1 wymiar (Country) i 1 rodzaj danych (activeUsers):

Kraj	Aktywni użytkownicy
Japonia	2541
Francja	12

Określanie źródła danych

Każde żądanie runReport wymaga podania identyfikatora usługi w Google Analytics. Wskazywana usługa w Analytics będzie używana jako zbiór danych dla tego zapytania. Oto przykład:

POST https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID:runReport

Odpowiedź na to żądanie zawiera tylko dane z usługi w Analytics, którą podasz jako parametr GA_PROPERTY_ID.

Jeśli używasz bibliotek klienta interfejsu Data API, podaj źródło danych w parametrze property w formacie properties/GA_PROPERTY_ID. Przykłady korzystania z bibliotek klienta znajdziesz w przewodniku dla początkujących.

Jeśli chcesz uwzględniać w raportach zdarzenia Measurement Protocol, przeczytaj artykuł Wysyłanie zdarzeń Measurement Protocol do Google Analytics.

Generowanie raportu

Aby wygenerować raport, utwórz obiekt RunReportRequest. Zalecamy rozpoczęcie od tych parametrów:

prawidłowy wpis w polu dateRanges,
co najmniej 1 prawidłowy wpis w polu dimensions;
co najmniej 1 prawidłowy wpis w polu metrics;

Oto przykładowa prośba z zalecanymi polami:

HTTP

POST https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID:runReport
  {
    "dateRanges": [{ "startDate": "2023-09-01"", "endDate": "2023-09-15" }],
    "dimensions": [{ "name": "country" }],
    "metrics": [{ "name": "activeUsers" }]
  }

Java

google-analytics-data/src/main/java/com/google/analytics/data/samples/RunReportSample.java

Otwórz w Cloud Shell Wyświetl na GitHubie

import com.google.analytics.data.v1beta.BetaAnalyticsDataClient;
import com.google.analytics.data.v1beta.DateRange;
import com.google.analytics.data.v1beta.Dimension;
import com.google.analytics.data.v1beta.DimensionHeader;
import com.google.analytics.data.v1beta.Metric;
import com.google.analytics.data.v1beta.MetricHeader;
import com.google.analytics.data.v1beta.Row;
import com.google.analytics.data.v1beta.RunReportRequest;
import com.google.analytics.data.v1beta.RunReportResponse;

/**
 * Google Analytics Data API sample application demonstrating the creation of a basic report.
 *
 * <p>See
 * https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runReport
 * for more information.
 *
 * <p>Before you start the application, please review the comments starting with "TODO(developer)"
 * and update the code to use correct values.
 *
 * <p>To run this sample using Maven:
 *
 * <pre>{@code
 * cd google-analytics-data
 * mvn compile exec:java -Dexec.mainClass="com.google.analytics.data.samples.RunReportSample"
 * }</pre>
 */
public class RunReportSample {

  public static void main(String... args) throws Exception {
    /**
     * TODO(developer): Replace this variable with your Google Analytics 4 property ID before
     * running the sample.
     */
    String propertyId = "YOUR-GA4-PROPERTY-ID";
    sampleRunReport(propertyId);
  }

  // Runs a report of active users grouped by country.
  static void sampleRunReport(String propertyId) throws Exception {

    // Using a default constructor instructs the client to use the credentials
    // specified in GOOGLE_APPLICATION_CREDENTIALS environment variable.
    try (BetaAnalyticsDataClient analyticsData = BetaAnalyticsDataClient.create()) {
      RunReportRequest request =
          RunReportRequest.newBuilder()
              .setProperty("properties/" + propertyId)
              .addDimensions(Dimension.newBuilder().setName("country"))
              .addMetrics(Metric.newBuilder().setName("activeUsers"))
              .addDateRanges(
                  DateRange.newBuilder().setStartDate("2020-09-01").setEndDate("2020-09-15"))
              .build();

      // Make the request.
      RunReportResponse response = analyticsData.runReport(request);
      printRunResponseResponse(response);
    }
  }

  // Prints results of a runReport call.
  static void printRunResponseResponse(RunReportResponse response) {
    System.out.printf("%s rows received%n", response.getRowsList().size());

    for (DimensionHeader header : response.getDimensionHeadersList()) {
      System.out.printf("Dimension header name: %s%n", header.getName());
    }

    for (MetricHeader header : response.getMetricHeadersList()) {
      System.out.printf("Metric header name: %s (%s)%n", header.getName(), header.getType());
    }

    System.out.println("Report result:");
    for (Row row : response.getRowsList()) {
      System.out.printf(
          "%s, %s%n", row.getDimensionValues(0).getValue(), row.getMetricValues(0).getValue());
    }
  }
}RunReportSample.java

PHP

google-analytics-data/src/run_report.php

Otwórz w Cloud Shell Wyświetl na GitHubie

use Google\Analytics\Data\V1beta\Client\BetaAnalyticsDataClient;
use Google\Analytics\Data\V1beta\DateRange;
use Google\Analytics\Data\V1beta\Dimension;
use Google\Analytics\Data\V1beta\Metric;
use Google\Analytics\Data\V1beta\MetricType;
use Google\Analytics\Data\V1beta\RunReportRequest;
use Google\Analytics\Data\V1beta\RunReportResponse;

/**
 * @param string $propertyId Your GA-4 Property ID
 */
function run_report(string $propertyId)
{
    // Create an instance of the Google Analytics Data API client library.
    $client = new BetaAnalyticsDataClient();

    // Make an API call.
    $request = (new RunReportRequest())
        ->setProperty('properties/' . $propertyId)
        ->setDateRanges([
            new DateRange([
                'start_date' => '2020-09-01',
                'end_date' => '2020-09-15',
            ]),
        ])
        ->setDimensions([
            new Dimension([
                'name' => 'country',
            ]),
        ])
        ->setMetrics([
            new Metric([
                'name' => 'activeUsers',
            ]),
        ]);
    $response = $client->runReport($request);

    printRunReportResponse($response);
}

/**
 * Print results of a runReport call.
 * @param RunReportResponse $response
 */
function printRunReportResponse(RunReportResponse $response)
{
    printf('%s rows received%s', $response->getRowCount(), PHP_EOL);
    foreach ($response->getDimensionHeaders() as $dimensionHeader) {
        printf('Dimension header name: %s%s', $dimensionHeader->getName(), PHP_EOL);
    }
    foreach ($response->getMetricHeaders() as $metricHeader) {
        printf(
            'Metric header name: %s (%s)%s',
            $metricHeader->getName(),
            MetricType::name($metricHeader->getType()),
            PHP_EOL
        );
    }

    print 'Report result: ' . PHP_EOL;

    foreach ($response->getRows() as $row) {
        print $row->getDimensionValues()[0]->getValue()
        . ' ' . $row->getMetricValues()[0]->getValue() . PHP_EOL;
    }
}run_report.php

przesunięcie	limit	Zwracany zakres indeksów wierszy
`0`	`250000`	`[ 0, 249999]`
`250000`	`250000`	`[250000, 499999]`
`500000`	`250000`	`[500000, 572345]`

Tworzenie raportu

Raporty – omówienie

Określanie źródła danych

Generowanie raportu

HTTP

Java

PHP

Python

Node.js

Zapytanie o dane

HTTP

Java

PHP

Python

Node.js

Czytanie odpowiedzi

Grupowanie i filtrowanie danych

Grupa

HTTP

Java

PHP

Python

Node.js

Filtr

HTTP

Java

PHP

Python

Node.js

HTTP

Java

PHP

Python

Node.js

HTTP

Java

PHP

Python

Node.js

HTTP

Java

PHP

Python

Node.js

Przechodzenie po długich raportach

HTTP

Java

PHP

Python

Node.js

HTTP

Java

PHP

Python

Node.js

Używanie wielu zakresów dat

HTTP

Java

PHP

Python

Node.js

Dalsze kroki