שירות הנתונים של Analytics

שירות Analytics Data מאפשר להשתמש ב-Google Analytics Data API v1 ב-Apps Script. ה-API הזה נותן למשתמשי Google Analytics גישה פרוגרמטית לנתוני הדוחות של Google Analytics 4 (GA4).

הערה: זהו שירות מתקדם שצריך להפעיל לפני השימוש בו.

חומר עזר

מידע מפורט על השירות הזה זמין במשאבי העזרה בנושא גרסה 1 של Google Analytics Data API.

בדומה לכל השירותים המתקדמים ב-Apps Script, גם השירות AnalyticsData משתמש באותם אובייקטים, שיטות ופרמטרים כמו ה-API הציבורי. למידע נוסף, קראו את המאמר איך נקבעות חתימות ל-methods.

בדף התמיכה של Google Analytics Data API v1 תוכלו לדווח על בעיות ולמצוא תמיכה אחרת.

קוד לדוגמה

הרצת דוח

בדוגמה מופעל דוח שמאחזר את מספר המשתמשים הפעילים לפי עיר, והתוצאות נשמרות בגיליון אלקטרוני חדש.

advanced/analyticsData.gs

הצגת הקוד ב-GitHub

/**
 * Runs a report of a Google Analytics 4 property ID. Creates a sheet with the
 * report.
 */
function runReport() {
  /**
   * TODO(developer): Uncomment this variable and replace with your
   *   Google Analytics 4 property ID before running the sample.
   */
  const propertyId = 'YOUR-GA4-PROPERTY-ID';

  try {
    const metric = AnalyticsData.newMetric();
    metric.name = 'activeUsers';

    const dimension = AnalyticsData.newDimension();
    dimension.name = 'city';

    const dateRange = AnalyticsData.newDateRange();
    dateRange.startDate = '2020-03-31';
    dateRange.endDate = 'today';

    const request = AnalyticsData.newRunReportRequest();
    request.dimensions = [dimension];
    request.metrics = [metric];
    request.dateRanges = dateRange;

    const report = AnalyticsData.Properties.runReport(request,
        'properties/' + propertyId);
    if (!report.rows) {
      console.log('No rows returned.');
      return;
    }

    const spreadsheet = SpreadsheetApp.create('Google Analytics Report');
    const sheet = spreadsheet.getActiveSheet();

    // Append the headers.
    const dimensionHeaders = report.dimensionHeaders.map(
        (dimensionHeader) => {
          return dimensionHeader.name;
        });
    const metricHeaders = report.metricHeaders.map(
        (metricHeader) => {
          return metricHeader.name;
        });
    const headers = [...dimensionHeaders, ...metricHeaders];

    sheet.appendRow(headers);

    // Append the results.
    const rows = report.rows.map((row) => {
      const dimensionValues = row.dimensionValues.map(
          (dimensionValue) => {
            return dimensionValue.value;
          });
      const metricValues = row.metricValues.map(
          (metricValues) => {
            return metricValues.value;
          });
      return [...dimensionValues, ...metricValues];
    });

    sheet.getRange(2, 1, report.rows.length, headers.length)
        .setValues(rows);

    console.log('Report spreadsheet created: %s',
        spreadsheet.getUrl());
  } catch (e) {
    // TODO (Developer) - Handle exception
    console.log('Failed with error: %s', e.error);
  }
}