Ads Sync developer documentation

Configure, verify, and understand the Patronage Ads Sync public contract.

Ads Sync is a Cloudflare-hosted ingestion toolkit for Google Ads and Meta Ads data. The public product has two parts: the @patronage/ads-sync package and its nested reference deployment.

start with a working configuration

import { defineAdsSyncConfig } from "@patronage/ads-sync";

export const adsSyncConfig = defineAdsSyncConfig({
  connections: [
    {
      catalog: { streams: [] },
      destinationSchema: "airbyte_google_ads_performance",
      provider: "google_ads",
      sourceConfigSecret: "GOOGLE_ADS_SOURCE_CONFIG_JSON",
    },
  ],
});

The config names a secret. It does not contain the credential value. Follow configure your first sync, then run the detailed configure-connections.ts source tutorial.

use the pages by task

• Configure your first sync is the package happy path.
• Verify a bounded run covers canary evidence, backfill policy, storage keys, and the historical comparison gate.
• Public contract reference lists the exact shipped inputs, defaults, provider definitions, and reference routes.
• Architecture and boundaries explains the package, reference deployment, and private dogfood split.