Documentação Commerce Optimizer Connector

[Somente PaaS]{class="badge informative" title="Aplica-se somente a projetos do Adobe Commerce na nuvem (infraestrutura do PaaS gerenciada pela Adobe) e a projetos locais."}

Introdução

Última atualização: 29 de julho de 2026

Criado para:

{"id":"b5a62a22-46f7-4f0d-b151-3fc640bef588"}
{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

Instale e configure o Adobe Commerce Optimizer Connector para sincronizar seus dados de catálogo do Adobe Commerce com o Adobe Commerce Optimizer e, em seguida, monitore o status de sincronização de dados para garantir que sua vitrine eletrônica esteja atualizada.

IMPORTANT

Sempre conecte instâncias do sandbox Otimizer a ambientes de não produção e instâncias de produção a ambientes de produção. Ambientes incompatíveis causam dados de catálogo inconsistentes, resultados de pesquisa e recomendações.

Requisitos para usar a integração requirements-to-use-the-integration

Adobe Commerce 2.4.7+. Para obter requisitos detalhados, consulte Requisitos do sistema.
Commerce Optimizer licença com uma instância de sandbox provisionada.
Chaves de autenticação para baixar o metapackage do conector usando o Composer.
Acesso de administrador a uma Commerce Optimizer instância da sandbox.

O usuário Adobe Commerce que está configurando a integração deve ter:

Acesso de administrador ao Administrador do Commerce.
Acesso de linha de comando ao Adobe Commerce servidor de aplicativos.
Acesso de desenvolvedor à Organização de IMS onde o projeto Commerce Optimizer é provisionado.

Remover extensões conflitantes remove-conflicting-extensions

Se você tiver uma das seguintes extensões instaladas, desinstale-as antes de instalar o Adobe Commerce Optimizer Connector:

Adobe Commerce Live Search (magento/live-search)
Adobe Commerce Product Recommendations (magento/product-recommendations)
Adobe Commerce Catalog Service (magento/catalog-service, magento/catalog-service-installer)
Data Management Dashboard (magento-catalog-sync-admin)

Os dados associados a essas extensões ainda estão disponíveis no banco de dados do Commerce. No entanto, ele não é exportado para Commerce Optimizer quando o conector está habilitado. Para implementar os recursos de pesquisa e merchandising do Adobe Commerce fornecidos por essas extensões após habilitar o conector, configure-os na Commerce Optimizer Interface do usuário do administrador.

IMPORTANT

Falha ao remover essas extensões antes de habilitar o conector causa telas de configuração com falha, dados duplicados no Commerce Optimizer e erros de autenticação 401 ou 403.

style

shade-box

Etapas de configuração configuration-steps

Para habilitar o Adobe Commerce Optimizer Connector e começar a sincronizar dados do Adobe Commerce com sua instância do Commerce Optimizer, siga estas etapas.

Instale o Adobe Commerce Optimizer Connector pacote usando o Composer para conectar sua instância do Adobe Commerce ao Commerce Optimizer.
Personalize a configuração de exportação de escopos do Commerce do Administrador.
Habilitar a Commerce Optimizer integração.
Verifique se a sincronização de dados está funcionando.

Instalar o pacote Adobe Commerce Optimizer Connector install-the-adobe-commerce-optimizer-connector-package

O Adobe Commerce Optimizer Connector é fornecido como um metapackage do Composer disponível a todos os comerciantes do Commerce com uma licença ativa para Commerce Optimizer.

Etapas de instalação

Adicionar o módulo adobe-commerce/commerce-data-export-aco-adapter usando o Composer:

code language-shell
`composer require adobe-commerce/commerce-data-export-aco-adapter`

Implante as alterações no ambiente de preparo do Adobe Commerce.

Após a conclusão da implantação, a opção Commerce Optimizer fica disponível no menu Admin do Commerce. Selecione Commerce Optimizer para abrir a instância do Commerce Optimizer diretamente do Administrador do Commerce.

NOTE

Para obter instruções detalhadas sobre a instalação de extensões, consulte os guias a seguir:

Instalar extensão em Adobe Commerce na Infraestrutura em Nuvem

Instalar extensão em Adobe Commerce no local

Personalizar a configuração de exportação de escopos do Commerce customize-the-commerce-scopes-export-configuration

Por padrão, a sincronização de dados do catálogo é habilitada para todos os escopos do Commerce (sites, grupos de clientes e exibições de loja). Você pode personalizar as configurações de exportação para sincronizar dados apenas para escopos específicos com base nas necessidades comerciais. Por exemplo, se várias exibições de armazenamento compartilharem o mesmo idioma, você poderá exportar dados para uma exibição de armazenamento e usá-los como a origem do catálogo para várias exibições de catálogo em Commerce Optimizer.

IMPORTANT

A alteração das configurações de exportação aciona uma reindexação completa, que pode levar um tempo significativo, dependendo do tamanho do catálogo. A Adobe recomenda configurar os escopos do Commerce para sincronização com o Commerce Optimizer antes de habilitar a integração e iniciar a sincronização de dados inicial.

A tabela a seguir descreve quais dados são exportados em cada nível de escopo:

Escopo

Dados exportados

Notas

Site e grupo de clientes

Preços e catálogos de preços

Cada conjunto de preços é exportado como um catálogo de preços usando a convenção de nomenclatura <website>::<SHA1 of customer group ID>. Todos os grupos de clientes do site estão incluídos.

Exibição de loja

Produtos e atributos do produto

Cada exibição de armazenamento cria uma origem do catálogo separada em Commerce Optimizer.

Armazenar grade com configurações de sincronização do Commerce Optimizer {width="600" modal="regular"}

Para alterar as configurações de exportação do escopo

No Administrador do Commerce, vá para Stores > Settings > All Stores.
Selecione o site ou a exibição de loja que deseja configurar.
Nas Commerce Optimizerconfigurações do exportador, use a caixa de seleção para habilitar ou desabilitar a sincronização de dados conforme necessário.

{width="500" modal="regular"}
Salve as alterações.

Ativar e desativar comportamento

Ação

Resultado

Desabilitar uma exibição de loja

Desabilitar a sincronização remove os dados do catálogo da loja. A origem do catálogo permanece em Commerce Optimizer, mas todos os dados sincronizados são removidos na próxima execução de cron.

Desabilitar e depois habilitar novamente uma exibição de loja

A mesma origem de catálogo é preenchida novamente com uma ressincronização de dados completa.

Habilitar a integração do Commerce Optimizer enable-the-adobe-commerce-optimizer-integration

Você habilita a integração e inicia a sincronização de dados executando o comando da CLI do aco:config:init. Esse comando conclui as seguintes etapas:

Obtém um token de acesso IMS usando credenciais fornecidas como argumentos de linha de comando.
Chama o serviço Commerce Cloud Manager (CCM) em https://ccm.api.commerce.adobe.com/api/v1/tenants/{tenantId}/owner/{orgId} para validar o locatário e extrair a URL de assimilação e a URL de Estúdio Commerce Optimizer.
Salva toda a configuração (segredo do cliente criptografado) em core_config_data.
Agenda a sincronização completa inicial, invalidando todos os Commerce Optimizer indexadores de feed.

IMPORTANT

O processamento da sincronização de dados é iniciado em segundo plano assim que você conclui a configuração. Dependendo do tamanho do catálogo, o processo de sincronização de dados pode levar de alguns minutos a várias horas.

Obter detalhes de conexão necessários

No Adobe Developer Console, crie um novo projeto habilitado para o serviço de Assimilação do Commerce Optimizer e gere credenciais OAuth de servidor para servidor. Para obter instruções detalhadas, consulte Obter credenciais IMS no Guia do Desenvolvedor de Merchandising para o Adobe Commerce Optimizer.

Salve os seguintes valores da página de credenciais:

ID da Organização (org_id)
ID do Cliente (client_id)
Segredo do Cliente (client_secret)

Obter detalhes da credencial da página de projeto do Adobe Developer Console {width="500" modal="regular"}

Obter detalhes da instância Commerce Optimizer

Obtenha a ID do locatário do campo Instance Idna Instance details página da instância Commerce Optimizer ou da URL usada para acessar a instância. Por exemplo, em https://experience.adobe.com/#/@<your organization>/in:<tenant ID>/commerce-optimizer-studio/home.

No Administrador do Commerce, selecione Adobe Commerce Optimizer para exibir a página de configuração com instruções.

{width="500" modal="regular"}
Na linha de comando, use SSH para se conectar ao ambiente de preparo Adobe Commerce.

Para configurar a integração, execute o seguinte comando da CLI do Adobe Commerce, substituindo os valores de espaço reservado pelos valores do seu projeto Commerce Optimizer:

code language-shell
`bin/magento aco:config:init --org_id=your-org --tenant_id=your-tenant --client_id=your-client-id --client_secret=your-secret`

Verifique a conexão retornando ao Administrador do Commerce e selecionando a opção Adobe Commerce Optimizer.

Ao selecionar a opção, ela abrirá a interface do usuário do Commerce Optimizer em uma nova guia.

Verifique se a sincronização de dados está funcionando verify-that-the-data-sync-is-working

Confirme se os dados foram exportados com êxito do Administrador do Commerce e se foram entregues com êxito a Commerce Optimizer. Comece com a exportação no Administrador do Commerce e confirme a entrega em Commerce Optimizer.

Verifique o status de sincronização no Administrador do Commerce:

Vá para System > Data Transfer > Data Feed Sync Status.

{width="700" modal="regular"}

Quando a sincronização está em execução, os dados do feed mostram registros enviados com êxito. Selecione um feed para ver detalhes ou solucionar problemas de sincronização.
Confirmar dados entregues para Commerce Optimizer:

No menu Commerce Optimizer, selecione Data Sync.

{width="700" modal="regular"}

Verifique se os produtos, preços e atributos esperados aparecem.

Quando a sincronização estiver funcionando como esperado:

Data Feed Sync Status mostra registros enviados com êxito para feeds de conector, sem erros de nível de item não resolvidos.
Data Sync em Commerce Optimizer lista as fontes de catálogo, os produtos, os preços e os atributos esperados.

TIP

Se você tiver algum problema com a sincronização de dados, consulte o guia de Solução de problemas.

Próximas etapas

Configurar Commerce Optimizer exibições e políticas de catálogo

Crie políticas e exibições de catálogo na interface do usuário do Commerce Optimizer. Observe que os catálogos de preços são criados automaticamente de Adobe Commerce grupos de clientes. Para obter instruções, consulte a documentação das Exibições de catálogo e Políticas no Commerce OptimizerGuia do Usuário. Para restringir o acesso a uma exibição de catálogo, consulte Exibições de catálogo privado.
Configurar uma Commerce Storefront emEdge Delivery Services

Para conectar sua loja à instância do Commerce Optimizer e começar a fornecer experiências de comércio personalizadas, siga a documentação de configuração da loja.

recommendation-more-help

commerce-help-aco-connector