Troubleshoot the Adobe Commerce Optimizer Connector
Use this guide to diagnose and resolve common issues with the Adobe Commerce Optimizer Connector during initial setup, catalog feed synchronization, and scope export configuration. The sections below cover credential and tenant validation, data sync failures, and related SaaS Data Export diagnostics.
Credentials or tenant validation fails
If aco:config:init fails during credential validation:
- Run the
bin/magento aco:config:showAdobe Commerce CLI command to verify the stored values. - Confirm that the tenant ID belongs to the IMS organization used to obtain the credentials.
- Confirm that the OAuth client has the necessary scopes for the Adobe Commerce Optimizer ingestion service (see Obtain IMS Credentials).
Data not syncing
Check item-level error details:
See Verify that the data sync is working for steps to open Data Feed Sync Status in the Commerce Admin. Select the failing feed to view per-item error details.
Key points about error handling:
- 400 errors are not retried. Inspect the payload for malformed or missing required fields. See Field mapping for connector feeds for the expected format.
- 5xx errors are automatically retried by the
*_resend_failed_itemscron job (runs every 5 minutes).
Check scope configuration:
If the problem affects only a specific catalog source (store view code) or price book, check whether the corresponding website or store view has sync disabled. See Customize the Commerce scopes export configuration.
When resolved:
Connector feeds show a successful status in Data Feed Sync Status, and the expected products, prices, and attributes appear on the Data Sync page in Commerce Optimizer.
Misconfiguration and result interpretation
For a catalog of specific behaviors caused by misconfiguration or misinterpretation of sync results - such as missing products, incorrect prices, or scope-level data gaps - see Troubleshooting scenarios.
SaaS Data Export diagnostics
For lower-level SaaS Data Export diagnostics including log locations and feed resync commands, see the SaaS Data Export troubleshooting guide.