google-analytics-api
Raportowanie API (Analytics v4)
Szukaj…
Uwagi
Google Analytics Reporting API V4 to najbardziej zaawansowana programowa metoda dostępu do danych raportu w Google Analytics . Dzięki interfejsowi API do raportowania Google Analytics możesz:
- Twórz niestandardowe pulpity nawigacyjne do wyświetlania danych Google Analytics .
- Zautomatyzuj złożone zadania raportowania, aby zaoszczędzić czas.
- Zintegruj swoje dane Google Analytics z innymi aplikacjami biznesowymi.
cechy
Google Analytics opiera się na potężnej infrastrukturze raportowania danych. Interfejs API raportowania Google Analytics V4 zapewnia dostęp do możliwości platformy Google Analytics . Interfejs API zapewnia następujące kluczowe funkcje:
- Wyrażenia metryczne: API pozwala na żądanie nie tylko wbudowanych metryk, ale także kombinacji metryk wyrażonych w operacjach matematycznych. Na przykład możesz użyć wyrażenia ga: goal1completions / ga: session, aby zażądać realizacji celu na liczbę sesji.
- Wiele zakresów dat: API pozwala w jednym żądaniu uzyskać dane w dwóch zakresach dat.
- Kohorty i wartość dożywotnia: Interfejs API ma bogate słownictwo na żądanie raportów wartości kohortowych i dożywotnich.
- Wiele segmentów: interfejs API umożliwia uzyskanie wielu segmentów w jednym żądaniu.
Pojedynczy raport Przykład użycia Oauth2 C #
W tym przykładzie użyto oficjalnej biblioteki klienta Google .net.
Autoryzacja Wymaga jednego z następujących zakresów OAuth:
Oauth2
// These are the scopes of permissions you need.
string[] scopes = new string[] { AnalyticsReportingService.Scope.AnalyticsReadonly }; // View your Google Analytics Data
UserCredential credential;
using (var stream = new FileStream(clientSecretJson, FileMode.Open, FileAccess.Read))
{
string credPath = System.Environment.GetFolderPath(System.Environment.SpecialFolder.Personal);
credPath = Path.Combine(credPath, ".credentials/", System.Reflection.Assembly.GetExecutingAssembly().GetName().Name);
// Requesting Authentication or loading previously stored authentication for userName
credential = GoogleWebAuthorizationBroker.AuthorizeAsync(GoogleClientSecrets.Load(stream).Secrets,
scopes,
userName,
CancellationToken.None,
new FileDataStore(credPath, true)).Result;
}
// Create Reporting API service.
var service = new AnalyticsReportingService(new BaseClientService.Initializer()
{
HttpClientInitializer = credential,
ApplicationName = string.Format("{0} Authentication", System.Reflection.Assembly.GetExecutingAssembly().GetName().Name),
});
Żądanie zgłoszenia
// Create the DateRange object.
DateRange June2015 = new DateRange() { StartDate = "2015-01-01", EndDate = "2015-06-30" };
DateRange June2016 = new DateRange() { StartDate = "2016-01-01", EndDate = "2016-06-30" };
List<DateRange> dateRanges = new List<DateRange>() { June2016, June2015 };
// Create the ReportRequest object.
// This should have a large number of rows
ReportRequest reportRequest = new ReportRequest
{
ViewId = ConfigurationManager.AppSettings["GoogleAnaltyicsViewId"],
DateRanges = dateRanges,
Dimensions = new List<Dimension>() { new Dimension() { Name = "ga:date" }, new Dimension() { Name = "ga:usertype" } },
Metrics = new List<Metric>() { new Metric() { Expression= "ga:users" }, new Metric() { Expression = "ga:sessions" } },
PageSize = 1000,
};
List<ReportRequest> requests = new List<ReportRequest>();
requests.Add(reportRequest);
var getReport = new GetReportsRequest() { ReportRequests = requests };
var response = service.Reports.BatchGet(getReport).Execute();
Przykład jednego raportu Reszta
Żądania API to HTTP POST z tokenem dostępu dołączonym na końcu punktu końcowego API.
Autoryzacja Wymaga jednego z następujących zakresów OAuth:
Uwaga przy wysyłaniu danych użyj ContentType = "application/Json";
https://analyticsreporting.googleapis.com/v4/reports:batchGet?Access_token={from auth}
{
"reportRequests":[
{
"viewId":"XXXX",
"dateRanges":[
{
"startDate":"2015-06-15",
"endDate":"2015-06-30"
}],
"metrics":[
{
"expression":"ga:sessions"
}],
"dimensions": [
{
"name":"ga:browser"
}]
}]
}