Onboarding Status Report onboarding-status-report-about
The Onboarding Status Report checks success and failure rates for processing records in your inbound data source files. This report displays data in an interactive bar chart and provides summary metrics in tabular form. And, it includes an option that samples files for a fixed time interval and displays the most common errors for each error type. You can find this report in Analytics > Onboarding Status Report. This report is also available when you create an inbound data source.
Onboarding Status Report: About onboarding-status-about
The Onboarding Status Report checks success and failure rates for processing records in your inbound data source files. This report displays data in an interactive bar chart and provides summary metrics in tabular form. And, it includes an option that samples files for a fixed time interval and displays the most common errors for each error type. You can find this report in Analytics > Onboarding Status Report. This report is also available when you create an inbound data source.
Error Reporting and Error Sampling error-reporting-sampling
Error reporting and error sampling are 2 separate features of the Onboarding Status report.
Error reporting shows you the success and failure rates for the number of records processed in an inbound data source. It returns data in an interactive, stacked bar graph and as summary metrics in tables below the graph.
Error reporting is automatic. It runs continuously for all of your inbound data sources. It returns data based on range of preset time intervals or a customized time interval that you set with a calendar widget.
Error sampling parses the contents of your data files and returns the 10 most common errors for each error type. The errors in your inbound data files prevent individual records from being processed. Use this report as a troubleshooting tool to help reduce the number of file errors and improve processing rates.
You must activate error sampling manually. It runs for 14-days from the day of activation and then turns itself off. You can turn error sampling back on after the 14-day interval expires. You activate error sampling when you create an inbound data source or by checking the Error Sampling check box from the Data Source Settings section of an existing inbound data source.
Error sampling is a computationally demanding process. As a result, it only returns first 10 errors for each error category. It is not designed to return every error contained in an inbound data source. These errors are a representative sample of a potentially larger group of similar errors. Review your entire file for the types of errors this report flags, reformat the file, and send it in again.
See Inbound Data File Contents: Syntax, Variables, and Examples for more information about how to properly format an data file for an inbound data source.
Error Report Bar Chart error-report-bar-chart
The error report graphs the success and failure rates for record processing in a stacked bar graph as shown in the following example. The graph is interactive. Clicking on a bar shows summary metrics for that day in a table below the graph.
Error Report Tables error-report-tables
The error report displays tabular data below the bar graph. The table shows success and failure rates along with totals and percentages.
Successful and Failed Records
This default view shows you a frequency count of the total records in your report and includes a breakdown of the errors by error type.
Totals & Percentages
Click Totals & Percentages to see what % of your files were processed successfully.
Error Sampling Report for 14 Days error-reporting-14-days
With error sampling active, the report will show you the top 10 errors for each error type. Click on an error type button at the top of the report to see each set of sampled data.
Receive E-mail Notifications receive-email-notifications
You can add the e-mail addresses of recipients that you want to be notified of the uploaded inbound files’ status. Note that you can select different recipients for different data sources.
Create an Onboarding Status Report create-onboard-status-report
A Sample Error Report returns the number records in a data source were processed successfully and how many failed. Follow these steps to generate a Sample Error Report.
-
Go to Analytics > Onboarding Status Report. Search for a data source or choose one from the list.
-
Select a date range. Options include:
- A set of fixed report intervals.
- Calendar widgets that let you create a custom date range.
-
Click OK.
Onboarding Status Report Terms and Definitions report-terms-conditions
A reference guide for the labels and terms used in this report.
Lists files that Audience Manager received and processed from you selected inbound data source.
File processing will fail if the file name is formatted improperly. File name requirements vary depending on how you send this data to Audience Manager. Delivery methods include Amazon S3 and FTP. For instructions on how to name your files, see:
Lists the number of improperly formatted Audience Manager user IDs (UUID). Usually, this indicates the IDs:
- Did not match the expected 38-digit format.
- Contain alphabetical characters. IDs should be numbers only.
Lists the number of improperly formatted Global Device IDs. See Index of IDs in Audience Manager and Global Data Sources for details on how device IDs should be formatted and what global data sources you should use, based on the device type.
The error sampling section of the report includes detailed information about the invalid device IDs, such as:
- The data source ID corresponding to the invalid device ID;
- The invalid device ID;
- The type of expected device ID, based on the data source.
These are onboarded IDs Audience Manager cannot match to an existing ID. Onboarded IDs can have this status when Audience Manager has not yet performed an ID sync or it still can't match the ID even after a synch.
In the case of unmatched mobile IDs, Audience Manager will:
- Continue to store and try to synch this ID.
- Record it as a Stored Record in the report if the ID cannot be synched.
If your onboarded file contains mobile IDs, then you can treat these numbers a bit more lightly than the other metrics. They will not affect the success and match rates for subsequent files.
Lists traits that Audience Manager cannot match to an onboarded trait. This could be the result of:
- Improperly formatted traits in your inbound data file. For on how to format your data file, see Inbound Data File Contents: Syntax, Variables, and Examples.
- Traits that have not yet been defined in Audience Manager.
Total number of unused signals received in the report. This total is based on the total number of successfully stored records.
See Unused Signals Report for more information.