Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.agentforcemcp.com/llms.txt

Use this file to discover all available pages before exploring further.

The Salesforce Marketing Cloud Analytics Connector for ACP empowers Agentforce agents to access campaign performance data, email analytics, and reporting insights to drive data-driven marketing decisions.

​
Purpose and Capabilities

This Connector provides tools to interact with Marketing Cloud’s reporting and analytics APIs:
Tool NameDescriptionExample Inputs
marketing_cloud_get_email_send_summaryRetrieves performance summary for email sends.send_id, job_id, date_range, metrics_to_include
marketing_cloud_get_campaign_performanceGets comprehensive campaign performance metrics.campaign_id, date_range, metrics_list, segment_breakdown
marketing_cloud_list_recent_sendsLists recent email sends with basic performance data.date_range, limit, send_classification, sort_by
marketing_cloud_get_top_performing_emailsRetrieves top performing emails based on specified metrics.metric_type, date_range, limit, campaign_filter
marketing_cloud_get_email_engagement_dataGets detailed engagement metrics for specific emails.email_id, send_id, date_range, engagement_types
marketing_cloud_get_subscriber_engagementRetrieves engagement history for specific subscribers.subscriber_key, email_address, date_range, engagement_types
marketing_cloud_get_bounce_reportGets bounce and delivery failure details.send_id, bounce_types, date_range, include_details
marketing_cloud_get_unsubscribe_reportRetrieves unsubscribe data and trends.date_range, list_ids, unsubscribe_reasons, include_demographics
marketing_cloud_get_click_tracking_dataGets detailed click tracking and link performance.send_id, email_id, date_range, link_breakdown
marketing_cloud_get_open_tracking_dataRetrieves email open tracking and timing data.send_id, email_id, date_range, device_breakdown
marketing_cloud_get_journey_performanceGets performance metrics for Journey Builder journeys.journey_id, date_range, metrics_list, version_id
marketing_cloud_get_automation_reportRetrieves execution reports for Automation Studio.automation_id, date_range, execution_status, include_errors
marketing_cloud_get_data_extension_statsGets usage and growth statistics for Data Extensions.data_extension_key, date_range, stat_types
marketing_cloud_get_send_time_optimizationRetrieves send time optimization performance data.campaign_id, date_range, time_zone, optimization_metrics
marketing_cloud_export_tracking_dataExports detailed tracking data for analysis.send_ids, date_range, data_types, export_format

​
Prerequisites

  • Marketing Cloud Account: Your organization must have an active Salesforce Marketing Cloud account with Analytics/Intelligence features.
  • API Integration:
    • An Installed Package must be created in Marketing Cloud Setup with API Integration component.
    • Appropriate permissions for Analytics and Reporting data access.
    • Required Scopes: analytics_read, email_read, campaigns_read, tracking_read
  • Marketing Cloud Intelligence: Some advanced analytics features may require Marketing Cloud Intelligence license.
  • Data Retention: Ensure your Marketing Cloud account has appropriate data retention settings for historical reporting.

​
Setup Instructions

  1. Create Installed Package:
    • In Marketing Cloud Setup, go to Apps > Installed Packages.
    • Click New and provide package details.
    • Add API Integration component with these permissions:
      • Email: Read, Write (for email metadata)
      • Tracking: Read (for engagement data)
      • Analytics: Read (for performance metrics)
      • Campaigns: Read (for campaign data)
  2. Configure Authentication:
    • Note the Client ID and Client Secret from your API Integration.
    • Configure OAuth 2.0 authentication flow.
    • Obtain access tokens with appropriate scopes.
  3. Set Up Data Access:
    • Ensure your API user has access to the business units containing the campaigns you want to analyze.
    • Configure appropriate folder permissions for email and campaign assets.
  4. Test API Access:
    • Use the Marketing Cloud REST API to test basic operations.
    • Verify you can retrieve email send data and campaign information.

​
Authentication

The Marketing Cloud Analytics Connector uses OAuth 2.0 authentication: 
POST https://YOUR_SUBDOMAIN.auth.marketingcloudapis.com/v2/token
Content-Type: application/json

{
  "grant_type": "client_credentials",
  "client_id": "YOUR_CLIENT_ID",
  "client_secret": "YOUR_CLIENT_SECRET",
  "scope": "analytics_read email_read campaigns_read tracking_read"
}

​
Available Metrics

​
Email Performance Metrics

  • Delivery Metrics: Sent, Delivered, Bounced, Delivery Rate
  • Engagement Metrics: Opens, Clicks, Open Rate, Click Rate, Click-to-Open Rate
  • Conversion Metrics: Conversions, Revenue, ROI
  • List Growth: Subscribes, Unsubscribes, Net Growth

​
Campaign Metrics

  • Reach: Total Recipients, Unique Recipients
  • Engagement: Total Engagement, Engagement Rate
  • Performance: Campaign ROI, Cost per Engagement
  • Timing: Send Time Performance, Optimal Send Times

​
Advanced Analytics

  • Predictive Analytics: Engagement Scoring, Send Time Optimization
  • Segmentation: Performance by Segment, Demographic Breakdown
  • Journey Analytics: Journey Performance, Path Analysis
  • A/B Testing: Test Results, Statistical Significance

​
Common Use Cases

  • Performance Reporting: Generate automated reports on campaign performance.
  • Content Optimization: Identify top-performing email content for reuse.
  • Audience Insights: Analyze subscriber engagement patterns and preferences.
  • Campaign Planning: Use historical data to optimize future campaigns.
  • ROI Analysis: Track and measure marketing campaign return on investment.
  • Automated Alerts: Set up notifications for performance thresholds.

​
Data Freshness and Availability

  • Real-time Data: Some metrics are available in near real-time (5-15 minutes delay).
  • Historical Data: Historical reporting data is typically available within 2-4 hours.
  • Data Retention: Standard retention periods apply (typically 6-12 months for detailed tracking data).
  • Aggregated Data: Summary metrics may be available for longer periods.

​
Rate Limits and Best Practices

  • API Limits: Marketing Cloud enforces rate limits (typically 2,500 calls per minute).
  • Data Volume: Large data exports may take time to process and should be handled asynchronously.
  • Caching: Implement caching for frequently accessed metrics to reduce API calls.
  • Batch Requests: Use batch endpoints when available to retrieve multiple metrics efficiently.
  • Error Handling: Implement proper retry logic for transient errors and rate limit responses.

​
Security Considerations

  • Data Privacy: Ensure compliance with privacy regulations when accessing subscriber data.
  • Access Control: Use principle of least privilege for API access permissions.
  • Token Security: Store and rotate OAuth tokens securely.
  • Audit Logging: Maintain logs of analytics data access for compliance purposes.
  • Data Encryption: Ensure all API communications use HTTPS encryption.