Skip to main content
NoteThe data upload feature is available only to Owner and In-house Marketer users. Agency and Media Partner users cannot access it.If the [Integrations]>[DATA UPLOAD] menu is not visible on your Airbridge dashboard, check your app role.
You can upload cost data to Airbridge in a CSV file format to add data that is not collected by Airbridge via channel integration or tracking links. Such cost data could include ad spending on influencer marketing or outdoor advertisements. Once you upload the data on the [Integrations]>[Cost Data] page, you can view the cost data in the Actuals Report.

​
CSV File Preparation

The cost data shall be uploaded in a CSV file format. Refer to the following sample CSV file.

​
Data input rules

Make sure to abide by the following data input rules when preparing the CSV file to avoid errors.
  • GroupBy data shall be input in the same way as displayed in Airbridge so that the data you upload can be aggregated along with the data collected via the SDK and tracking links. For example, if the CSV includes “Android,” the data won’t be aggregated as “android” data because Airbridge displays data as “android,” not “Android.”
  • The maximum file size for CSV is 1MB with a limit of 10,000 rows.
  • Make sure no blank fields are included. For string-type data, 1 to 256 characters are allowed.
Only designated row names shall be used. Make sure no spaces are included in the row names. No blank cells should be included. The data won’t be uploaded properly if there is a blank cell in the required rows. If there is no data to input, input 0 or none, depending on the data type of the required row.
After uploading the cost data file to Airbridge, the row names will be available as metrics and GroupBys which you can use in the Actuals reports.ChannelNote that the channel field must be input with the Airbridge dashboard display names so that the uploaded data can be aggregated along with the data Airbridge collects from the ad channels. The Airbridge dashboard display names of the ad channels can also be found on the [Integrations]>[Ad Channel Integration] page in grey.Date and currencyThe date and currency fields must be input in the required formats. For example, if 2022.01.02 is input in the date row, or usd is input instead of USD in the currency row, the data won’t be uploaded properly.Note that the currency of the cost data won’t be converted to the standard currency configured for your Airbridge App. For example, if the standard currency of your Airbridge App is set to USD, and you input 1 in the cost field and VND in the currency field, the dashboard will display the data as 1 USD.Impression, clicks, and costDon’t input commas in the impressions, clicks, and cost fields as the data may not be uploaded properly.
Airbridge supports the following OS platforms:
  • Windows, Ubuntu, Tizen, Other, Mac OS X, Linux, iOS, Chrome OS, Android

​
Uploading CSV File

01-en-AdSpend
  1. Navigate to [Integrations]>[Cost Data], and click CSV File Upload.
  2. Drag and drop the CSV file or select your file from the finder.
  3. Make sure you dropped or selected the correct file and click Upload.
  4. Data processing may take up to 10 minutes. After clicking Confirm, you can use other features of Airbridge.

​
Upload status

The upload status can be found in the Status column. The upload status is updated automatically. Refer to the table below for the status details.

​
Troubleshooting

The majority of problems occur when the CSV file does not abide by the designated format or in the process of overwriting. Make sure your network connection status is working.
The error code can be found by selecting [Action]>[View Details]. Refer to the table below to address errors.
The cost data you upload can overwrite the data uploaded before.

​
Attention

Only designated row names are allowed in the CSV file. The row names are case-sensitive and space-sensitive.
The data you input in the CSV file must be in the designated format. The required row fields shall not include blanks. If there is no data to input, enter 0 or none, depending on the data type.GroupBy data shall be input in the same way as displayed in Airbridge so that the data you upload can be aggregated along with the data collected via the SDK and tracking links. For example, if the CSV includes “Android,” the data won’t be aggregated as “android” data because Airbridge displays data as “android,” not “Android.”Also, make sure to input the currency row fields with 3-letter currency codes in capital letters. For example, if you input usd instead of USD, the data won’t be uploaded properly.
The last uploaded data overwrites the data uploaded before when the data overlaps in date, channel, and campaign rows.For example, if you upload a file with the cost data of channel Z on Jan 1 as 100 USD, and a couple days later upload a file with the cost data of channel Z on Jan 1 as 200 USD, Airbridge reports will show 200 USD as the cost data of channel Z on Jan 1.
When data overlap occurs between the data collected by Airbridge and the data uploaded to Airbridge, the numbers are summed.For example, if Airbridge has collected the cost data of channel Z on Jan 1 as 100 USD via the Airbridge SDK, and you uploaded a file with the cost data of channel Z on Jan 1 as 200 USD, Airbridge reports will show 300 USD as the cost data of channel Z on Jan 1.
Note that the currency of the cost data won’t be converted to the standard currency configured for your Airbridge App. For example, if the standard currency of your Airbridge App is set to USD, and you input 1 in the cost field and VND in the currency field, the dashboard will display the data as 1 USD.