External Ad Networks Guide

import { AdsClient } from '@eventzr/ads-client';

const client = new AdsClient({
  baseUrl: 'https://api.eventzr.com/ads/v1',
  tenantId: '<your-tenant-id>',
  accessToken: '<jwt>',
});

// Initiate OAuth connection
const connection = await client.external.connectAccount({
  platform: 'google_ads',
  redirectUri: 'https://yourapp.com/callbacks/google-ads',
  scopes: ['campaigns', 'audiences', 'conversions'],
});

// Redirect the user to authorize
console.log('Authorize URL:', connection.data.authorizeUrl);
// => https://accounts.google.com/o/oauth2/v2/auth?client_id=...

// After OAuth callback, the account appears in your connected accounts
const accounts = await client.external.listAccounts();
console.log(accounts.data);
// [{ id: 'ext_abc123', platform: 'google_ads', status: 'active', accountName: 'My Google Ads' }]

// Update sync configuration for a connected account
await client.external.updateAccount('ext_abc123', {
  syncDirection: 'bidirectional',  // 'push' | 'pull' | 'bidirectional'
  syncFrequency: 'hourly',        // 'realtime' | 'hourly' | 'daily' | 'manual'
  syncEntities: {
    campaigns: true,
    audiences: true,
    conversions: true,
    budgets: false,   // Do not sync budget changes
  },
  conflictResolution: 'eventzr_wins',  // 'eventzr_wins' | 'external_wins' | 'manual'
});