Introdução
Instale e configure o Commerce Optimizer Connector para sincronizar os dados do 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 loja esteja atualizada.
Requisitos para usar a integração
-
Adobe Commerce 2.4.7+
- PHP 8.2, 8.3 ou 8.4
- Composer 2.x
-
Adobe Commerce Optimizer licença com uma instância de sandbox provisionada.
-
Acesse o repo.magento.com para baixar o metapackage do Conector Commerce usando o Composer.
-
Acesso de administrador a uma instância da sandbox do Adobe Commerce Optimizer.
O usuário do Adobe Commerce que configura a integração deve ter:
-
Acesso de administrador ao Administrador do Adobe Commerce.
-
Acesso de linha de comando ao servidor de aplicativos do Adobe Commerce.
-
Acesso de desenvolvedor à Organização de IMS onde o projeto Adobe Commerce Optimizer é provisionado.
Pré-requisitos
Se você tiver uma das seguintes extensões instaladas, desinstale-as antes de instalar o Commerce Optimizer Connector:
- Adobe Commerce Live Search (
magento/live-search) - Recomendações de produto do Adobe Commerce (
magento/product-recommendations) - Serviço de Catálogo da Adobe Commerce (
magento/catalog-service,magento/catalog-service-installer) - Painel de Gerenciamento de Dados (
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 Adobe Commerce Optimizer quando o Conector está habilitado. Para implementar os recursos de pesquisa e merchandising fornecidos por essas extensões após habilitar o Conector, configure-os na Adobe Commerce Optimizer Interface do usuário do administrador.
Etapas de configuração
Siga estas etapas para habilitar o conector e começar a sincronizar dados do Commerce com a sua instância do Adobe Commerce Optimizer.
-
Instale o pacote Commerce Optimizer Connector usando o Composer para conectar sua instância do Commerce ao Adobe Commerce Optimizer.
-
Revise e personalize a configuração da exportação de dados do Administrador.
Instale o pacote Commerce Optimizer Connector
O Adobe Commerce Optimizer Connector é fornecido como um metappackage do Composer disponível para todos os comerciantes do Commerce com uma licença ativa para Adobe Commerce Optimizer.
Etapas de instalação
-
Adicionar o módulo
adobe-commerce/commerce-data-export-aco-adapterusando 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. Clique em Commerce Optimizer para abrir a instância do Commerce Optimizer diretamente do Administrador do Commerce.
Obter detalhes de conexão necessários
Na Adobe Developer Console, crie um projeto de desenvolvedor habilitado para o serviço de Assimilação do Adobe 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.
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 instância Adobe Commerce Optimizer
Salve a ID da instância (também chamada de ID do locatário) da instância Adobe Commerce Optimizer. Você pode encontrá-los no URL usado para acessar a instância. Por exemplo, em https://experience.adobe.com/#/@<project-id>/in:TToyu73daQRn66KAYaq8YZ/commerce-optimizer-studio/home, a ID da instância é TToyu73daQRn66KAYaq8YZ.
Personalizar a configuração da exportação de dados do Commerce
Por padrão, a sincronização de dados do catálogo é habilitada para todos os escopos do Commerce (sites 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 você tiver várias exibições de loja, mas quiser exportar apenas os dados de uma delas, poderá desativar o exportador para as outras exibições de loja.
Exportação de dados por escopo
A tabela a seguir descreve quais dados são exportados em cada nível de escopo:
website::customergroupcode. Todos os grupos de clientes do site estão incluídos.Ativar e desativar comportamento
Atualizar a configuração de exportação
Após instalar o pacote de conectores, a grade Loja no Admin agora mostra as configurações de exportação do Commerce Optimizer.
Para alterar as configurações de um modo de exibição de site ou loja:
-
No Administrador do Commerce, navegue até Stores > Settings > All Stores.
-
Selecione o site ou a exibição de loja que deseja configurar.
-
Nas Adobe 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.
Habilitar a integração do Adobe Commerce Optimizer
Usando as credenciais de API e os detalhes de instância coletados nas etapas anteriores, agora é possível configurar a integração entre as instâncias do Commerce e do Adobe Commerce Optimizer.
-
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 do Commerce.
-
Execute o seguinte comando da CLI do Commerce para configurar a integração, substituindo os valores de espaço reservado pelos valores do seu projeto do Commerce Optimizer:
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.
Quando você clica na opção, ela abre a interface do usuário do Adobe Commerce Optimizer em uma nova guia.
Verifique se a sincronização de dados está funcionando
Após habilitar a integração, a sincronização de dados é iniciada automaticamente. Dependendo do tamanho do catálogo, a sincronização inicial pode levar de alguns minutos a várias horas.
-
Verifique o status de sincronização no Administrador do Commerce:
Vá para System > Data Transfer > Data Feed Sync Status.
{width="500" 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 recebidos no Commerce Optimizer:
No menu Adobe Commerce Optimizer, selecione Data Sync.
{width="500" modal="regular"}
Verifique se os produtos, preços e atributos esperados aparecem.
Próximas etapas
-
Configurar Adobe Commerce Optimizer exibições e políticas de catálogo
Crie políticas e exibições de catálogo no Guia do Adobe Commerce Optimizer. Observe que os catálogos de preços são criados automaticamente a partir dos grupos de clientes do Adobe Commerce.
-
Configurar uma Commerce Storefront no Edge Delivery Services
Siga a documentação de configuração da loja para conectar sua loja à instância do Adobe Commerce Optimizer e começar a fornecer experiências de comércio personalizadas.