Overview
Akeneo Activation provides comprehensive reporting capabilities to monitor the execution of various data exchange jobs configured within your Activation Channels, such as product exports, offer imports, order exports, and shipment confirmation imports.
This reporting feature allows you to track the status of these jobs, identify any issues that may arise, and access detailed logs and reports for troubleshooting and analysis.
To view the reports for jobs associated with a specific Activation Channel, follow these steps:
Navigate to Activation Channel Settings: Access the settings for the specific Activation channel for which you want to view the job reports.
Go to the Reports Tab: Within the channel settings, locate and navigate to the Reports tab. This section is dedicated to providing insights into the execution of jobs configured for this particular channel.
Understanding the Job Reports
Within the Reports tab, you will find various tools and information to help you monitor and analyze your data exchange jobs:
Job Type Selection: You will find a filter at the top of the page that allows you to select the specific job type you want to review. This could include Offer Import, Order Export, Shipment Confirmation Import, etc. Selecting a job type will display the reports relevant to that specific process.
Job Status: For each job execution listed, you will see its status. This will generally indicate whether the job was successful or resulted in a failure. This high-level overview helps you quickly identify any jobs that require attention.
Error Details: In case of a job failure, the reports will provide details about the errors encountered during the process. This information is crucial for diagnosing the root cause of the issue and taking corrective actions.
Job History: The reports section maintains a history of job executions, allowing you to review past instances of the import and export jobs. This historical data can be valuable for identifying trends or recurring issues.
Timestamps: Each job execution in the history will be accompanied by timestamps, indicating the exact date and time when the job was initiated and completed. This helps in tracking the timing and frequency of your data exchange processes.
Number of Imports/Exports: For successful jobs, the report may display the number of records that were successfully imported or exported during that execution. This provides a quantitative measure of the job's outcome.
Download Error Reports: In the event of job failures, you will find an option to download error reports. These reports contain more detailed information about the specific errors encountered, the affected products, the source, and potential reasons for the failure. This is a key resource for troubleshooting.
Download Generated Files: For export jobs, the reports provide an option to download the files that were generated and transferred during the job execution. This allows you to verify the exported data.
Product Exports Reports List
Once you have sent your product catalogs to the retailer or marketplace, a report is generated to provide the status of your catalog export on the retailer or marketplace side. It highlights errors related to the retailer or marketplace requirements for a particular family of products and, depending on the activation channel you are connected to, offers a way to fix them.
The reports are organized in chronological order, with the newest export report appearing at the top. The list is limited to the 100 most recent exports for easy navigation and reference. Open the received report to check for any errors. Retailers or marketplaces typically provide error logs or notifications indicating where issues might have occurred.
Within the reports tab, you can find the following essential information related to each product export within the report table:
- Report Generation Date: Indicates the exact date and time when the export process was initiated and completed.
- Products from Your Source: Refers to the number of products coming from your PIM, combining all your catalogs.
- Products Sent for Integration: Refers to the number of products sent to the retailer or marketplace.
- Products Accepted: Depending on the channel, refers to the number of products successfully accepted by the retailer.
- Errors: Refers to the total number of errors generated in the latest report.
Next to the report time, there is also an indication of whether the report was a "dry run." The concept of a dry run is explained in the article related to product exports
Individual Reports
You can analyze a specific report by clicking on the report line. This will open a detailed view of the report, showing all the errors associated with that product export. Retailers or marketplaces usually provide error logs or notifications that indicate where issues might have occurred.
Example of an error:
| Message | From | Actions |
|---|---|---|
| 'list_price' is required but not supplied. | Amazon | Open the product directly in the PIM | Copy Logs |
On this page, you can view each error in clear, easy-to-understand language. The errors are linked to specific PIM attributes (or a combination of them if multiple sources were used in the mapping). The error log descriptions are written to be easily understood by non-technical users.
To address an error listed in your report, click on Open Products to go directly to your PIM’s product enrichment page. Use this feature to troubleshoot and fix potential errors or warnings from your export.
You can copy the logs for a specific error by clicking on Copy Logs.
The Generated Files button in the top right of the screen allows you to download:
- Exported products in an Excel file
- The retailer or marketplace template file
- Sent/Displayed product comparison (Amazon only)
Once inside a single report, you can go back to the full reports list by clicking back to all reports