Skip to content

CSV Uploads

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

About CSV Uploads Integration

Import Campaign Data Without API Limitations

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

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

ColumnTypeDescription
campaign_idStringUnique identifier for the campaign
campaign_nameStringHuman-readable campaign name
dateDate (YYYY-MM-DD)Performance date
impressionsNumberTotal impressions
clicksNumberTotal clicks
ctrDecimalClick-through rate (e.g., 0.025 for 2.5%)
costDecimalTotal cost in specified currency
cpmDecimalCost per thousand impressions

Optional CSV Columns

ColumnTypeDescription
conversionsNumberConversion count
cost_btcDecimalCost in Bitcoin
account_nameStringAccount identifier for grouping
currencyStringCurrency code (USD, EUR, GBP, etc.)

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

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

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.

Frequently Asked Questions

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.

Browse all

Facebook Ads

Integrate Facebook Ads with Flyweel for unified campaign optimization, real-time reporting, and AI-powered creative insights.

Instagram Ads

Integrate Instagram Ads with Flyweel for unified campaign optimization, real-time reporting, and AI-powered creative insights.

Meta Ads

Integrate Meta Ads (Facebook & Instagram) with Flyweel for unified cross-channel optimization, real-time reporting, and AI-powered audience insights.

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