How to Set Up Alerts for Conversion Rate in Google Analytics 4

// GA4 custom alerts are managed through the Admin UI, but you can query
// the current conversion rate to set intelligent thresholds
const {BetaAnalyticsDataClient} = require('@google-analytics/data');

const client = new BetaAnalyticsDataClient();
const request = {
  property: `properties/${propertyId}`,
  dateRanges: [{startDate: '30daysAgo', endDate: 'today'}],
  metrics: [{name: 'conversionRate'}],
  dimensions: [{name: 'date'}]
};

const response = await client.runReport(request);
console.log('30-day baseline conversion rate:', response[0].rows);
// Use this baseline to set your alert threshold

// Example: Alert configuration structure for GA4 Admin API
const alertConfig = {
  displayName: 'Conversion Rate Drop Alert',
  customAlertConditions: [
    {
      name: 'conversion_rate_threshold',
      condition: 'LESS_THAN',
      threshold: 2.5,  // 2.5% threshold
      durationDays: 1,
      metric: 'conversionRate'
    }
  ],
  notificationChannels: ['email']
};
// GA4 will compare this threshold against daily conversion rate

const {AnalyticsAdminServiceClient} = require('@google-analytics/admin');
const path = require('path');

const keyFilePath = path.join(process.env.HOME, '.config/ga-admin-key.json');
const adminClient = new AnalyticsAdminServiceClient({
  keyFilename: keyFilePath
});

console.log('Authenticated with GA4 Admin API');
// You're now ready to create or list alerts programmatically

const request = {
  parent: `properties/${propertyId}`,
  customAlert: {
    displayName: 'Conversion Rate Below 2.5%',
    customAlertConditions: [
      {
        name: 'conversion_rate_drop',
        condition: 'LESS_THAN',
        threshold: 2.5,
        durationDays: 1,
        metric: 'conversionRate'
      }
    ]
  }
};

try {
  const [alert] = await adminClient.createCustomAlert(request);
  console.log('Alert created:', alert.name);
} catch (error) {
  console.error('Failed to create alert:', error.message);
}

const {BetaAnalyticsDataClient} = require('@google-analytics/data');
const analyticsData = new BetaAnalyticsDataClient();

async function checkConversionRateAndAlert() {
  const response = await analyticsData.runReport({
    property: `properties/${propertyId}`,
    dateRanges: [{startDate: '1daysAgo', endDate: 'today'}],
    metrics: [{name: 'conversionRate'}],
    dimensions: [{name: 'date'}]
  });
  
  const currentRate = parseFloat(response[0].rows[0].metricValues[0].value);
  const threshold = 2.5;
  
  if (currentRate < threshold) {
    // Trigger custom action: post to Slack, call webhook, etc.
    await notifySlack(`⚠️ Conversion rate dropped to ${currentRate}%`);
  }
}

// Schedule this function to run every hour via Cloud Scheduler

// Using Google Sheets API to read GA4 data from the connector
const {google} = require('googleapis');
const sheets = google.sheets({version: 'v4', auth: sheetsAuth});

const range = 'Sheet1!A1:B2';
const response = await sheets.spreadsheets.values.get({
  spreadsheetId: SHEET_ID,
  range: range
});

const conversionRate = parseFloat(response.data.values[1][1]);
console.log('Current GA4 conversion rate:', conversionRate + '%');
// The connector refreshes this value every few hours automatically