The following are our guidelines for the business information and file format for Display Ad manifests. Keep in mind that the use of a manifest is preferred, but not absolutely required.
What to Include in a Manifest
Here are the business data points that we are looking for in your manifest file. Note that only three pieces of information are required (marked with *). The others are useful and appreciated, but not necessary.
Custom ID (frequently an account #)*
PDF Filename (frequently the ad #)*
Business Phone 1
Business Phone 2
Business Address Line 1
Business Address Line 2
Hours of Operation
Business Contact Name
Business Contact Phone
Business Contact Email
Ad-Rep Contact Name
Ad-Rep Contact Phone
Ad-Rep Contact Email
If your data contains additional or misleading information, we can purposefully ignore attributes (for example if the exported address is the billing address, not the business address). Just be sure to let us know when providing your sample manifest.
The recommended format is an XML file with the following structure (see below), however we are able to parse manifests in .txt, .csv, and .tsv formats as well, and are happy to work with publications on an individual basis to meet their needs.
Here is an XML file with our suggested structure:
<?xml version="1.0" encoding="utf-8"?>
<BusinessName>SYNERGY HOMECARE -SD</BusinessName>
<Address1>3205 - 4TH AVE. #3205 ROSE GRIFFEN</Address1>
Important Rules for XMLs:
For XMLs to work, they need the following:
- Declaration: This looks like <?xml version="1.0" encoding="UTF-8"?> and tells the computer the file is an XML file.
- Root Tags: These signify the beginning and the end of the collection of XML elements. In the example below, the root tag is simply called <Root>, although it can be any word (like <RootBeerFloat>) The last line of the file should always be the closing root tag.
- Proper Nesting/Ordering: Inside the root tags, you can have any number of nested elements with sub-elements. You just have to make sure every tag that is opened is closed (using a </TagName>, the / is very important here). Elements are NOT required to be spaced in a certain way, but the order of the tags and their respective closing tags is essential to getting correct results.
Don't worry! Ad order entry systems, whether well-known software or in-house solutions, vary significantly from partner to partner. For this reason, generating manifests and sending manifests has required many unique iterations over the years. If you have questions or concerns, contact our Onboarding Team. They will work with you to figure out the best manifest solution for your current system.