AdvancedIntegrations
Advanced

Integrations and Connections

Learn how to extend Ad ROI's capabilities by integrating with third-party services, webhooks, and external marketing tools.

{
  "event": "lead.created",
  "data": {
    "id": "lead_123",
    "email": "user@example.com",
    "campaign": "summer_promo"
  },
  "timestamp": "2024-01-15T10:30:00Z"
}
await fetch('https://api.example.com/v1/integrations/ga', {
  method: 'POST',
  headers: { 
    'Authorization': 'Bearer YOUR_AD_ROI_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ 
    gaProperty: 'G-XXXXXXXXXX',
    events: ['page_view', 'conversion']
  })
});

Overview

Ad ROI supports seamless integrations with popular marketing tools, email providers, analytics platforms, and custom APIs. Use these connections to automate workflows, sync campaign data in real-time, and track performance across your entire stack.

Review your Ad ROI dashboard permissions before setting up integrations. Ensure you have admin access to generate API keys and webhook URLs.

Available Integrations

Explore key integrations to supercharge your Ad ROI setup.

Webhook Setup

Webhooks enable real-time data sync from Ad ROI events like new leads or campaign updates.

Generate Webhook URL

Navigate to your Ad ROI dashboard > Integrations > Webhooks.

Copy the unique webhook URL for your account.

Configure Events

Select events to subscribe to, such as lead.created or campaign.updated.

Test the Webhook

Trigger a test event and verify the payload at your endpoint.

Here is a sample webhook payload:

Email Provider Integrations

Connect Ad ROI to email services for automated list building.

Get API Key

In Mailchimp, go to Account > Extras > API Keys. Create a new key.

Add to Ad ROI

In Ad ROI dashboard, Integrations > Email > Mailchimp. Paste your {MAILCHIMP_API_KEY}.

const response = await fetch('https://api.example.com/v1/integrations/mailchimp', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer YOUR_AD_ROI_TOKEN' },
  body: JSON.stringify({ apiKey: 'YOUR_MAILCHIMP_KEY' })
});

Analytics Integrations

Track Ad ROI performance alongside your analytics data.

Google Analytics

query
ga_propertystring
Required

Your Google Analytics property ID (e.g., GA_MEASUREMENT_ID).

header
Authorizationstring
Required

Bearer token from Ad ROI.

Use this API call to link accounts:

Custom API Integrations

For advanced use cases, interact directly with Ad ROI's REST API.

Secure your {API_KEY} and never expose it in client-side code. Use server-to-server calls for production.

Visit the API Reference for full endpoint details.