Documentation

How Can We Help?

Everything you need to start using Kensa, generate reports, and get the most out of your subscription.

🔍
Popular: Getting started Uploading CSV Meta Ads setup PDF reports
🚀

Getting Started

Introduction to Kensaworks

Kensaworks is an automated report generation tool that turns raw advertising data into professional PDF reports in seconds. Upload a CSV export from your ad platform, choose your settings, and download a client-ready PDF — no spreadsheet editing, no manual formatting.

Currently supported data source: Meta Ads (Facebook & Instagram).

Quickstart: Log in at https://app.kensaworks.com, export your Meta Ads data as CSV using the steps below, and generate your first report in under 2 minutes.

Account Setup

  1. Purchase a plan from the Kensaworks store.
  2. You will receive a welcome email with a link to set your password.
  3. Click the link in the email, set your password, and your account is activated.
  4. Log in at https://app.kensaworks.com.
Did not receive the email? Check your spam folder. If it's not there, contact info@kensaworks.com and we'll resend it.

Your First Report — Step by Step

  1. Log in and click Generator in the top navigation bar.
  2. Select your data source: Meta Ads.
  3. Export your CSV from Meta Ads Manager (see Meta Ads export guide below).
  4. Upload the CSV file by clicking the upload area or dragging and dropping.
  5. Choose a report template from the dropdown.
  6. Optionally fill in Company Name and Prepared by to personalise the report.
  7. Click Generate Report.
  8. You can preview or download your report.
Tip: The Company Name and Prepared by fields are optional. If left blank, these fields will not be included in the report.
📂

Uploading Data

Supported File Formats

Kensaworks accepts .csv and .xlsx (Excel) files. The file must contain one row per campaign, ad or ad set, with the required columns present.

  • Maximum file size: 32 MB
  • Encoding: UTF-8 (standard for all Meta Ads exports)
  • Column names are detected automatically — minor variations in naming are handled

Exporting from Meta Ads Manager

The easiest way is to use the default export with no column changes. The default "Performance and clicks" column preset already includes all the columns Kensaworks needs.

  1. Go to Meta Ads Manager.
  2. Click the Campaigns (or Ad Sets / Ads) tab at the top.
  3. Set your date range using the date picker in the top right (e.g. last 30 days, or a custom range for a client report period).
  4. Make sure the column preset reads Performance and clicks — this is the default and no changes are needed.
  5. Click the Export button (download icon, top right of the table).
  6. Select Export Table Data (CSV).
  7. The file downloads to your computer. Upload it directly to Kensaworks.
Important: Do not add, remove, or reorder columns before exporting. Kensaworks uses smart features to detect columns — the default export is already in the correct format.
Campaigns vs Ad Sets vs Ads: You can export at any level — campaigns, ad sets, or individual ads. Kensaworks will detect which level you exported and label the report accordingly.

Here's where to find these controls in Meta Ads Manager:

Campaigns 100 Opportunity score ▾
Updated just now
Search to filter by: name, ID or metrics
1 Select this preset
2 Export as CSV
Off / On Campaign Delivery Attribution setting Results Reach Frequency
Instagram post: Marketers, creators, and busi… ● Completed
7-day click or …All conversions
249
Instagram profile visits
 21,130 1
Instagram post: Struggling to understand yo… ● Completed
7-day click or …All conversions
1,390
Instagram profile visits
 132,477 1
Instagram post: Struggling to understand yo… ● Completed
7-day click or …All conversions
745
Instagram profile visits
 58,260 1
Results from 3 campaigns

Required Columns

The following columns must be present in your CSV. All of these are included in the default Meta Ads export — no manual changes required.

Column in Meta export What it represents
Reporting startsStart date of the reporting period
Reporting endsEnd date of the reporting period
ImpressionsTotal number of times your ads were shown
ReachUnique people who saw your ads
Clicks (all)All clicks on your ads
ResultsNumber of times your ads achieved the campaign objective
Amount spentTotal budget spent in the reporting period
Missing columns? If any required column is absent, Kensaworks will show an error message listing exactly which columns could not be detected. Check that you are exporting from the Campaigns tab with the default column preset.

Optional Columns

If these columns are present in your export they will be used to enrich the report with additional metrics. They are all included in the default Meta Ads export.

Column in Meta export Used for
Campaign namePer-campaign breakdown in the report
Link clicksMore precise click metric (vs all clicks)
Cost per resultPre-calculated cost efficiency metric
CPM (cost per 1,000 impressions)Pre-calculated CPM (overrides calculated value)
CTR (all)Pre-calculated CTR (overrides calculated value)
CPC (all)Pre-calculated CPC (overrides calculated value)
Result indicatorShows the campaign objective type

Metrics that cannot be calculated or are not present in the file are automatically omitted from the report — you will never see empty or broken data sections.

📄

Reports

PDF Report Overview

Every Kensaworks report is a professionally designed PDF that includes:

  • Cover page — report title, date range, company name, prepared by
  • Summary KPIs cards — impressions, results, CPC (all), amount spent
  • Performance Funel chart
  • Campaign summary table
Tip: The report date range is taken directly from your CSV data — it does not need to be entered manually.

KPI Calculations

Kensaworks calculates the following metrics automatically from your uploaded data:

MetricFormulaRequires
CTR (Click-Through Rate)Clicks (all) ÷ Impressions × 100Clicks, Impressions
CPC (Cost per Click)Amount spent ÷ Clicks (all)Amount spent, Clicks
CPM (Cost per 1,000 Impressions)Amount spent ÷ Impressions × 1,000Amount spent, Impressions
Cost per resultAmount spent ÷ ResultsAmount spent, Results
Conversion rateResults ÷ Clicks (all) × 100Results, Clicks

Report Templates

Kensaworks offers multiple report templates selectable before generating:

  • Default — Clean, structured layout. Available on all plans.
  • Modern Compact — Denser layout with visual accents. Available on Professional & Agency plans.

More templates are available with the Agency plan.

💳

Account & Billing

Plans & Limits

PlanReports / billing periodPlatforms
Starter10Meta Ads
Professional40Meta Ads
AgencyUnlimitedMeta Ads + Custom CSVs

Your report count resets at the start of each billing period. You can track usage in real time from My Profile.

Billing FAQ

How do I know how many reports I have left?
Log in and go to My Profile. Your usage for the current billing period is shown there.

Can I cancel anytime?
Yes. Go to Settings in the app and click Cancel subscription. Your access continues until the end of the current billing period.

Do unused reports roll over?
No — the report count resets at the start of each new billing period.

I have a question not covered here.
Contact us at info@kensaworks.com and our team will get back to you.