# CSV Uploads

  Import campaign data via CSV. Track historical data, custom metrics like Bitcoin costs, and platforms not yet integrated.

   [Start Free](https://signup.flyweel.co/?variant=control) [Docs](#setup)            

## About CSV Uploads Integration

  

## Import Campaign Data Without API Limitations[](#import-campaign-data-without-api-limitations)

### The Problem[](#the-problem)

Not all advertising platforms offer API access, and historical data may predate your platform integrations. Manual data entry is tedious and error-prone. Your campaign performance data is scattered across spreadsheets, legacy systems, and platforms that don’t integrate with your analytics stack.

Stop losing visibility on campaigns that don’t have API access. Flyweel’s CSV Upload feature lets you consolidate all campaign performance data regardless of source, giving you a complete picture of your advertising spend.

### Why CSV Uploads + Flyweel Unifies Your Data[](#why-csv-uploads--flyweel-unifies-your-data)

Flyweel’s CSV Upload provides a flexible alternative to API integrations. Import historical data, track custom metrics like Bitcoin costs, and analyse campaigns from platforms without native integrations—all in one unified dashboard.

**Key Benefits:**

- **Historical Data Import**: Backfill performance data that predates your Flyweel account or API connections

- **Platform Flexibility**: Import data from any advertising source, affiliate network, or legacy system

- **Custom Metrics**: Track Bitcoin costs, custom conversion values, and platform-specific metrics

- **Unified Analysis**: CSV data appears alongside Google Ads and Meta Ads in AdGrid for cross-platform comparison

- **Multi-Account Support**: Organise imports by account name for clear data segmentation

### Required CSV Columns[](#required-csv-columns)

| Column | Type | Description |
| --- | --- | --- |
| `campaign_id` | String | Unique identifier for the campaign |
| `campaign_name` | String | Human-readable campaign name |
| `date` | Date (YYYY-MM-DD) | Performance date |
| `impressions` | Number | Total impressions |
| `clicks` | Number | Total clicks |
| `ctr` | Decimal | Click-through rate (e.g., 0.025 for 2.5%) |
| `cost` | Decimal | Total cost in specified currency |
| `cpm` | Decimal | Cost per thousand impressions |

### Optional CSV Columns[](#optional-csv-columns)

| Column | Type | Description |
| --- | --- | --- |
| `conversions` | Number | Conversion count |
| `cost_btc` | Decimal | Cost in Bitcoin |
| `account_name` | String | Account identifier for grouping |
| `currency` | String | Currency code (USD, EUR, GBP, etc.) |

### Use Cases[](#use-cases)

**Historical Data Migration**
Import years of campaign data from spreadsheets or legacy systems to establish complete performance history. Compare historical trends against current API-connected campaigns.

**Crypto Advertising Tracking**
Track Bitcoin-denominated advertising costs alongside fiat currencies for complete financial visibility. Essential for teams running campaigns on crypto-native ad networks.

**Offline Campaign Data**
Import data from platforms without API access, direct media buys, or offline advertising channels. Consolidate TV, radio, and print campaign metrics with digital performance.

**Agency Data Consolidation**
Aggregate campaign data from multiple sources into a single unified dashboard. Perfect for agencies managing diverse client portfolios across various platforms.

### How CSV Data Appears in Flyweel[](#how-csv-data-appears-in-flyweel)

Uploaded CSV data appears as “CSV Imports” in the platform filter dropdown, allowing you to:

- Filter AdGrid to show only CSV-imported campaigns

- Compare CSV data against Google Ads and Meta Ads performance

- Generate unified reports across all data sources

- Track spend and performance trends over time

### Getting Started[](#getting-started)

Upload your first CSV file in the Flyweel app to start consolidating your campaign data. Navigate to the AdGrid Campaign Manager and click the “Upload CSV” button to get started.

*Flyweel: Save two days a week. Make great decisions faster.*

       

## FAQ about CSV Uploads

### What data can I import via CSV to Flyweel?

You can import campaign performance data including campaign ID, campaign name, date, impressions, clicks, CTR, cost, and CPM. Optional fields include conversions, Bitcoin costs (cost_btc), account name for grouping, and currency code. This allows you to consolidate data from any advertising platform into Flyweel's unified dashboard.

### How do I format my CSV file for Flyweel upload?

Your CSV must include these required columns: campaign_id, campaign_name, date (YYYY-MM-DD format), impressions, clicks, ctr (as decimal, e.g., 0.025 for 2.5%), cost, and cpm. Optional columns include conversions, cost_btc, account_name, and currency. Column headers must be lowercase with underscores. Save the file as UTF-8 encoded CSV.

### Can I use CSV uploads alongside Google Ads and Meta Ads integrations?

Yes. CSV uploads work seamlessly alongside API integrations. Uploaded data appears as 'CSV Imports' in the platform filter dropdown alongside Google Ads and Meta Ads, allowing unified cross-platform analysis. You can compare performance across all data sources in AdGrid's unified dashboard.

### What is the maximum file size for CSV uploads?

Flyweel supports CSV files up to 10MB per upload. For larger datasets, split your data into multiple files organised by date range and upload them sequentially. Each upload processes independently, and data accumulates in your dashboard.

### Can I track Bitcoin advertising costs with CSV uploads?

Yes. The optional cost_btc column allows you to track campaign costs in Bitcoin alongside fiat currencies. This is particularly useful for teams running campaigns on crypto-native ad networks, DeFi platforms, or affiliate networks that pay in cryptocurrency.

### How do I update previously uploaded CSV data?

Upload a new CSV file with the same campaign_id and date combinations. Flyweel automatically updates existing records with new values. This allows you to correct historical data or add conversions that were tracked after the initial upload.

### What date format should I use in my CSV file?

Use ISO 8601 format (YYYY-MM-DD) for the date column. For example, January 15, 2024 should be formatted as 2024-01-15. This ensures consistent date parsing across different locales and spreadsheet applications.

### Can I import data from multiple ad platforms in one CSV file?

Yes. Use the optional account_name column to differentiate data sources within a single CSV. For example, set account_name to 'TikTok Campaigns' or 'Affiliate Network' to group campaigns by their source platform. This enables side-by-side comparison in AdGrid.

### How quickly does uploaded CSV data appear in Flyweel?

CSV data typically processes within 1-2 minutes after upload. Once processed, data immediately appears in AdGrid Campaign Manager under the 'CSV Imports' filter. Refresh the page if data doesn't appear after a few minutes.

### What happens if my CSV has formatting errors?

Flyweel validates your CSV during upload and displays specific error messages for any issues. Common errors include missing required columns, invalid date formats, or text in numeric fields. Fix the identified issues in your spreadsheet and re-upload the corrected file.

       

## Works well with

 [Browse all](/integrations)           [](/integrations/facebook-ads)   

### [Facebook Ads](/integrations/facebook-ads)

 Connect Facebook Ads to Flyweel. Reconcile Meta invoices automatically and track ad spend against realized revenue, not just ROAS.

         

    Advertising   [View Facebook Ads](/integrations/facebook-ads)             [](/integrations/instagram-ads)   

### [Instagram Ads](/integrations/instagram-ads)

 Connect Instagram Ads to Flyweel. See which visual campaigns drive pipeline revenue — not just engagement — and auto-match invoices.

             Advertising   [View Instagram Ads](/integrations/instagram-ads)             [](/integrations/meta-ads)   

### [Meta Ads](/integrations/meta-ads)

 

Integrate Meta Ads with Flyweel. Unify Facebook and Instagram spend, auto-reconcile invoices, and measure campaigns against closed-won revenue.

             Advertising   [View Meta Ads](/integrations/meta-ads)            

### Ready to connect CSV Uploads?

 

Get early access to Flyweel and unify your growth stack with a liquid, blazing-fast workflow that scales from ads to revenue.

 [Start Free](https://signup.flyweel.co/?variant=control)