Cartucho de Marketing de indicação para Comércio

Você pode baixar o cartucho Referral Marketing for Commerce para o seu sistema local do GitHub.

Depois de adicionar o cartucho ao seu sistema local, use uma interface de linha de comando (CLI) para adicionar o cartucho automaticamente ou adicione o cartucho manualmente ao seu site do B2C Commerce.

Pré-requisitos para usar a CLI para adicionar o cartucho

• Obtenha as versões compatíveis de:
  • Node.js: 14.21.3
  • npm: Versão 6.14.18
• Baixe o Arquitetura de Referência da Loja (SFRA) 6.2.0. Renomeie a pasta para storefront-reference-architecture.
• Mova a pasta Indicação que você baixou para a mesma pasta que contém a pasta storefront-reference-architecture.
• Execute npm ci e npm run compile:js && npm run compile:scss & & & npm run compile:fonts para a pasta SFRA.
• Implementar sites de demonstração da Arquitetura de referência da vitrine em sua instância:
  1. Navegue até Administração | Desenvolvimento do site | Importação e exportação do site .
  2. Selecione Sites de demonstração de Arquitetura de Referência da Loja e clique em Importar.
  3. Clique em Implantar.
• Conceda acesso à sua chave de API à sua instância se você estiver adicionando o cartucho manualmente.

  Para obter mais informações, consulte a seção Conceder acesso à chave de API às suas instâncias no Salesforce Commerce Cloud CLI.

Adicionar automaticamente o cartucho

1. Configure estas variáveis de ambiente em seu site do B2C Commerce:

   Variável	Descrição
   SFCC_OAUTH_CLIENT_ID	O ID do cliente usado para autenticação. O ID do cliente está disponível no Gerente de conta.
   SFCC_OAUTH_CLIENT_SECRET	O segredo do cliente usado para autenticação. O segredo do cliente é a senha que você criou ao criar seu ID de cliente.
   SFCC_HOSTNAME	O alias do seu sandbox.
   SFCC_CODE_VERSION	A versão do código para a qual você deseja adicionar o cartucho. Você pode encontrar a versão do código do seu site em Administração | Implantação de código no Account Manager.
   SFCC_SITE_IDS	O ID do site do B2C Commerce ao qual adicionar o cartucho.

2. Se dw.json estiver disponível na sua pasta referral-marketing-for-commerce/src/sfcc, exclua-a.
3. Na sua CLI, execute estes comandos:
   1. npm ci
   2. npm run compile:js && npm run compile:scss
   3. npm run -s deploy:auto

Adicionar manualmente o cartucho

1. Certifique-se de que dw.json esteja disponível na sua pasta referral-marketing-for-commerce/src/sfcc e contenha estas variáveis:

   Variável	Descrição
   client-id	O ID do cliente usado para autenticação. O ID do cliente está disponível no Gerente de conta.
   hostname	O alias do seu sandbox.
   code-version	A versão do código para a qual você deseja adicionar o cartucho. Você pode encontrar a versão do código do seu site em Administração | Implantação de código no Account Manager.
   site-ids	Opcional. O ID do site do B2C Commerce ao qual adicionar o cartucho.
   senha	A senha que você recebe ao gerar a chave de acesso para WebDav File Access e UX Studio no Business Manager.
   username	O nome de usuário que você usa para fazer login no Business Manager.

2. Na sua CLI, execute estes comandos:
   1. npm ci
   2. npm run compile:js && npm run compile:scss
   3. implementação de npm run -s
3. Autenticar se solicitado.

Visualizar o cartucho no site do B2C Commerce

1. Navegue para o Gerente de contas.
2. Clique em Administração | Sites | Gerenciar sites .
3. Abra o site ao qual você adicionou o cartucho e clique em Configurações.

O cartucho aparece no campo Cartuchos.

Importante Se o cartucho não estiver disponível no campo Cartucho, insira plugin_b2creferral:int_b2creferral:int_b2ccrmsync:app_storefront_base.

Atualizar a credencial de serviço da Web

O cartucho adiciona um serviço da Web chamado b2ccrmsync.RefArch ao seu site do B2C Commerce. Você deve atualizar a credencial de serviço da Web com a chave de consumidor, o segredo de consumidor do aplicativo conectado e o URL de retorno do aplicativo conectado.

Importante Ao atualizar a credencial do serviço da Web, lembre-se de substituir /success por /token no URL de retorno.