Use this article to add campaign costs in Avid so ROI, net revenue, and response metrics can calculate in reporting. You can add costs while building direct mail or upload a cost file for direct mail and digital efforts.
Use this article when
- You want ROI to appear in the Matchback report.
- You want ROI, ROI Net, net revenue, or response rate to appear in the Appeal Analysis report.
- You are building a direct mail appeal in Direct Mail.
- You have a spreadsheet of costs by appeal code, campaign, or event.
- You need to add digital costs from an ad platform export, agency invoice, or internal campaign spreadsheet.
Applies to and prerequisites
| Requirement | Details |
|---|---|
| Product areas | Direct Mail, Settings > Connections, and Insights |
| Permissions | You need permission to edit direct mail, connections, files, or reports for your organization. |
| Direct mail requirements | Your appeal must include packages and appeal codes. |
| Cost file requirements | Your file must include appeal_code and at least one cost field, such as cost or cost_per_piece. |
| Appeal Analysis requirements | ROI charts require total cost data. Response-rate charts require audience size data. |
Choose the right cost method
| Your situation | Use this method |
|---|---|
| You are building a direct mail appeal in Avid. | Add Fixed Project Costs and Est. Package Cost in Direct Mail. |
| You have a spreadsheet of direct mail or digital campaign costs. | Create a file-based data set and choose Data Category > Cost. |
Add costs to a direct mail appeal
-
Open Direct Mail.
You see Direct Mail Selection (Early Access).
-
Click Appeals.
You see your list of appeals.
-
Click the appeal name you want to update.
You see the appeal workflow with tabs for Information, Audience, Packages, Selection, and Review.
-
On the Information tab, enter any shared campaign costs in Fixed Project Costs.
Use this field for costs such as copywriting, design, agency fees, or other project-level costs that are not tied to one package.
-
Click Packages.
You see the package list for the appeal.
-
Click Add Package, or edit an existing package.
The package modal opens.
-
Enter the package cost in Est. Package Cost.
Avid uses this value as the package price per piece.
-
If the package uses a test version, turn on Split for A/B Test and complete the Experiment Treatment Details (Optional) section.
If the treatment has a different cost, enter it in the treatment Est. Package Cost field.
-
Click Save Package.
The package is saved to the appeal.
-
Click Review.
You see the package cost rollup with Price / Piece, Audience Size, Total Cost, Fixed Costs, and Total.
-
Select an Export File Layout.
The selected layout controls the file generated for the mailing.
-
Check Include the exported data in Direct Mail and Matchback reporting.
Avid includes the exported accounts and appeal codes in Direct Mail and Matchback reporting.
-
Click Generate File.
Avid generates the file and uses the saved package and fixed costs for reporting.
Add costs for digital efforts
To add costs for digital efforts, upload a cost file and map it as a Cost data set. Use this method for costs from sources such as ad platform exports, agency invoices, or internal campaign spreadsheets.
Your cost file should include the cost amount and a value Avid can use to match the cost to results. For the current Cost data set mapping, include appeal_code and at least one cost field, such as cost or cost_per_piece.
Follow the steps in Upload a cost file for reporting.
Upload a cost file for reporting
Use this method when your costs live outside Avid, such as an agency invoice, print vendor file, ad platform export, or internal spreadsheet. Cost files should include the cost amount and a value Avid can use to match the cost to results.
Cost file format
| Column | Required? | Use |
|---|---|---|
appeal_code |
Required | Matches costs to appeal results. |
cost |
Optional | Total cost for the appeal, campaign, or event. |
cost_per_piece |
Optional | Per-person or per-piece cost. |
audience_size |
Optional | Number of people included in the audience. |
Tip: Use appeal codes exactly as they appear in your transaction or activity data. If the appeal code does not match the result data, Avid cannot connect the cost to reporting results.
-
Open Settings.
You see the organization settings page.
-
Click Connections.
You see tabs for Systems, Files, and Data Blends.
-
Click Files.
You see the Data Files table.
-
Find the uploaded cost file and click Add.
The Data Set Information screen opens.
-
Enter a clear Data Set Name.
Use a name your team can recognize later, such as
FY26 Spring Appeal Costs. -
Open Data Category and select Cost.
Avid shows this description: Cost: This is a list of costs associated with a campaign or event. It should include the cost, the appeal code or UTM information to be matched with results.
-
Choose a Refresh Type.
Choose Append: New files are merged with prior uploads when future files should add to the data set. Choose Replace: New files replace prior uploads when each new file should replace the prior file.
-
Leave Ignore Unused Column Changes checked unless your team needs Avid to stop processing when new unmapped columns appear in future uploads.
When this option is checked, files can still process when added or removed columns do not affect existing mappings.
-
Click Next.
The Inclusion Filters step opens.
-
Add filters if only some rows in the file should be included. Otherwise, continue without adding filters.
Filters are optional.
-
Click Next.
The Column Mapping step opens.
-
Map
appeal_codeand any available cost fields.Map at least one of
costorcost_per_piece. Mapaudience_sizewhen the file includes audience counts. -
Click Save.
After the file processes and reporting refreshes, Avid can use the costs in ROI reporting.
View ROI in Appeal Analysis
Use Appeal Analysis to review how appeals performed after costs have been added and matched to results.
-
Open Insights.
You see the Insights report list.
-
Open Appeal Analysis.
The report opens with sections such as Appeal Performance Overview, ROI Analysis, Donor Analysis, Day by Day Details, and Goal Tracking.
-
Review the report filters.
The report uses filters such as Gift Date. Adjust the date range or appeal filters so the report includes the appeals you want to review.
-
Click ROI Analysis.
This section is where Avid displays cost-aware appeal performance.
-
Review Top 10 Appeals by Net Revenue.
This chart shows revenue after cost is factored in. It requires total cost data.
-
Review Top 10 Appeals by Response Rate.
This chart uses Audience Size and Response Rate. It requires audience size data.
-
Review Top 10 Appeals by ROI.
This chart uses Audience Size, ROI, and ROI Net. It requires total cost data.
-
Review Appeal Details Table.
This table is grouped by Appeal Code and Appeal Name. It includes columns such as Revenue, ROI, and ROI Net.
How Avid calculates these values: Net Revenue is revenue minus total cost. ROI compares revenue to total cost. ROI Net compares net revenue to total cost. If total cost or audience size is missing, some ROI Analysis charts may not show results for that appeal.
What you will see
- Direct mail appeals show costs on the Review tab.
- The direct mail package table shows Price / Piece, Audience Size, and Total Cost.
- Cost data sets use Data Category > Cost.
- Insights > Appeal Analysis > ROI Analysis shows cost-aware charts after cost data is available.
- ROI and net revenue appear in reporting after Avid has matching cost and result data.
Troubleshooting
ROI does not appear in the Matchback Report
- Confirm the appeal code in your cost file matches the appeal code in your transaction or activity data.
- Confirm the uploaded file was added as a data set with Data Category set to Cost.
- Confirm you mapped
appeal_codeand at least one cost field. - Confirm reporting has refreshed after the file processed.
ROI does not appear in Appeal Analysis
- Open Insights > Appeal Analysis > ROI Analysis.
- Confirm the report filters include the gift dates and appeals you want to review.
- Confirm the appeal has total cost data. The ROI and net revenue charts require total cost.
- Confirm the cost file uses the same appeal code as the result data.
- Confirm the cost file was mapped as a Cost data set.
- Confirm reporting has refreshed after the cost data was added.
Response Rate does not appear in Appeal Analysis
- Confirm the appeal has audience size data.
- If you uploaded a cost file, map
audience_sizewhen the file includes that column. - Review the Top 10 Appeals by Response Rate chart in ROI Analysis. This chart requires audience size.
A direct mail package total looks wrong
- Review the package Est. Package Cost.
- Review the Audience Size on the Review tab.
- Check whether Split for A/B Test is turned on and whether the treatment version has a separate Est. Package Cost.
- Review Fixed Project Costs if the total includes shared campaign costs.