Onboarding Status Report
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.
Only users with Admin privileges can see this report in the Audience Manager user interface. You can have non-admin users be notified of the uploaded inbound files' status by adding their e-mails to the report. See Receive E-mail Notifications .
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.
Error Reporting and Error 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 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
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
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
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.
The report does not highlight record errors with this current release. To find and fix file errors, you should review the results and compare those to the specifications in the Inbound Data File Contents documentation.
Receive E-mail 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
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
A reference guide for the labels and terms used in this report.
Data Sync File Name
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 records that failed processing because they did not match the syntax or formatting requirements. See Inbound Data File Contents: Syntax, Variables, and Examples for information on how to format your data.
Invalid AAM ID
Lists the number of improperly formatted Audience Manager user IDs (UUID). Usually, this indicates the IDs:
Invalid Device ID
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.
No Matching AAM ID
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 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.
No Trait Realized
Lists traits that 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 .
The percentage of records in your file that were stored successfully. Percent success = records processed / number of records in a file.
The total number of records received. In most cases, this number should match the total number of records (lines) in your inbound data file.
Number of records stored successfully. Because of file format errors, some of the records received may not be stored by Audience Manager . The number of stored records can be less than the number of records received.
Total Realized Traits
The number of traits for all users across all inbound files that get stored in the Audience Manager platform.
Total Unused Signals
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.