Conectar dados do Commerce ao Adobe Experience Platform

No Administrador do Commerce, navegue até Lojas > Configurações > Configuração > Serviços > Data Connection.

Selecione o método de autorização de servidor para servidor que você implementou no menu Tipo de Autorização do Adobe Developer. O Adobe recomenda usar o OAuth. O JWT foi descontinuado. Saiba mais.

(Somente JWT) Copie e cole o conteúdo do seu arquivo private.key no campo Segredo do cliente. Use o comando a seguir para copiar o conteúdo.

cat config/private.key | pbcopy

Consulte Autenticação de Conta de Serviço (JWT) para obter mais informações sobre o arquivo private.key.

Copie o conteúdo do arquivo <workspace-name>.json no campo Detalhes da Conta/Credencial de Serviço.

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

Clique em Salvar configuração.

No Admin, vá para Sistema > Serviços > Data Connection.

Na guia Configurações em Geral, verifique a ID associada à sua conta do Adobe Experience Platform, conforme configurado no Commerce Services Connector. A ID da organização é global. Somente uma ID de organização pode ser associada por instância do Adobe Commerce.

No menu suspenso Escopo, defina o contexto como Site.

(Opcional) Se você já tiver um AEP Web SDK (alloy) implantado em seu site, habilite a caixa de seleção e adicione o nome de seu AEP Web SDK. Caso contrário, deixe esses campos em branco e a extensão Data Connection implantará um para você.

Selecione Eventos de vitrine se desejar enviar dados comportamentais de vitrine.

Selecione Eventos do back office se desejar enviar informações sobre o status do pedido, como se um pedido foi feito, cancelado, reembolsado ou remetido.

(Ignore esta etapa se estiver usando seu próprio SDK da Web da AEP.) Crie uma sequência de dados na Adobe Experience Platform ou selecione uma sequência de dados existente que você deseja usar para a coleção. Insira essa ID de sequência de dados no campo ID de sequência de dados.

Insira a ID do conjunto de dados que você deseja que contenha seus dados do Commerce. Para localizar a ID do conjunto de dados:

1. Abra a interface do Experience Platform e selecione Conjuntos de dados no menu de navegação esquerdo para abrir o painel Conjuntos de dados. O painel lista todos os conjuntos de dados disponíveis para sua organização. Os detalhes são exibidos para cada conjunto de dados listado, incluindo o nome, o esquema ao qual o conjunto de dados pertence e o status da execução de assimilação mais recente.
2. Abra o conjunto de dados associado à sua sequência de dados.
3. No painel direito, exiba os detalhes sobre o conjunto de dados. Copie a ID do conjunto de dados.

Para garantir atualizações de dados de eventos de back office com base em um agendamento de acordo com um trabalho cron, você deve alterar o índice Sales Orders Feed para Update by Schedule.

1. Na barra lateral Admin, vá para System > Tools>Index Management.

2. Marque a caixa de seleção do indexador Sales Orders Feed.

3. Defina Actions como Update by Schedule.

4. Se você estiver ativando os dados de back office pela primeira vez, execute os seguintes comandos para reindexar e acionar uma ressincronização. Ressincronizações subsequentes ocorrem automaticamente desde que o trabalho cron esteja configurado corretamente.

   code language-bash
   bin/magento index:reindex sales_order_data_exporter_v2

   code language-bash
   bin/magento saas:resync --feed orders

Verifique se você forneceu a conta de serviço e os detalhes da credencial.

Verifique se você tem um esquema e um conjunto de dados especificados para assimilação de dados de registro de perfil e assimilação de dados de evento de perfil de série temporal.

Marque a caixa de seleção Perfis de clientes se desejar enviar dados de perfil para o Experience Platform.

Insira a ID do Conjunto de Dados de Perfil.

Os dados do registro de perfil devem usar um conjunto de dados diferente do que você está usando atualmente para dados de evento comportamentais e de back office.

Se você não quiser transmitir eventos de perfil por meio da mesma ID de sequência de dados que está usando para dados comportamentais e de back office, remova a marca de seleção de Transmitir perfis de clientes por meio da mesma ID de sequência de dados e insira a ID de sequência de dados que deseja usar.

Verifique se você forneceu a conta de serviço e os detalhes da credencial.

Habilitar RabbitMQ.

Habilite os consumidores da fila de mensagens pelo trabalho cron em .magento.env.yaml usando a variável de ambiente CRON_CONSUMERS_RUNNER.

   stage:
     deploy:
       CRON_CONSUMERS_RUNNER:
         cron_run: true

No Admin, vá para Sistema > Serviços > Data Connection.

Selecione a guia Histórico de pedidos.

Em Sincronização do Histórico de Pedidos, a caixa de seleção Copiar ID do Conjunto de Dados das Configurações já está habilitada. Isso garante que você esteja usando o mesmo conjunto de dados especificado na guia Configurações.

Nos campos De e Até, especifique o intervalo de datas para os dados históricos de ordem que você deseja enviar. Não é possível selecionar um intervalo de datas que exceda cinco anos.

Selecione Start Sync para iniciar a sincronização. Os dados históricos de pedidos são dados em lote, e não dados de vitrine e back-office que estão transmitindo dados. Os dados em lote levam cerca de 45 minutos para chegar no Experience Platform.

Selecione Consultas na navegação à esquerda do Experience Platform e clique em Create Query.

Quando o Editor de consultas for aberto, insira uma consulta que selecione dados do conjunto de dados.

Por exemplo, sua consulta pode ser semelhante ao seguinte:

SELECT * from `your_dataset_name` ORDER by TIMESTAMP DESC

Após a execução da consulta, os resultados serão exibidos na guia Resultados, ao lado da guia Console. Essa exibição mostra a saída em tabela da sua query.