google-analytics-api
API отчетов (Analytics v4)
Поиск…
замечания
API-интерфейс отчетности Google Analytics V4 - это самый передовой программный метод для доступа к данным отчета в Google Analytics . С помощью API отчетов Google Analytics вы можете:
- Создавайте настраиваемые информационные панели для отображения данных Google Analytics .
- Автоматизация сложных задач отчетности для экономии времени.
- Интеграция данных Google Analytics с другими бизнес-приложениями.
Характеристики
Google Analytics построена на мощной инфраструктуре передачи данных. API-интерфейс отчетности Google Analytics V4 предоставляет вам доступ к возможностям платформы Google Analytics . API предоставляет следующие ключевые функции:
- Метрические выражения: API позволяет запрашивать не только встроенные показатели, но и комбинацию показателей, выраженных в математических операциях. Например, вы можете использовать выражение ga: goal1completions / ga: sessions для запроса завершения цели на количество сеансов.
- Несколько диапазонов дат: API позволяет вам в одном запросе получать данные в двух диапазонах дат.
- Когорта и пожизненное значение: API имеет богатый словарный запас, чтобы запрашивать отчеты о значениях погодных и пожизненных значений.
- Несколько сегментов: API позволяет вам получать несколько сегментов в одном запросе.
Пример одного отчета с использованием Oauth2 C #
В этом примере используется официальная клиентская библиотека Google .net.
Авторизация Требуется одна из следующих областей 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),
});
Запрос на отчетность
// 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();
Одиночный пример отчета
Запросы API - это HTTP POST с токеном доступа, прикрепленным в конце конечной точки API.
Авторизация Требуется одна из следующих областей OAuth:
Обратите внимание, что при публикации данных используйте 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"
}]
}]
}