Usted está aquí:
Cartucho Marketing de referencias para Commerce
El cartucho Marketing de referencias contiene metadatos y páginas HTML que le permiten configurar sus preferencias de programa de referencias y ejecutar el programa en el sitio de B2C Commerce. El cartucho debe agregarse a su sitio de B2C Commerce. Solo puede agregar el cartucho a sitios en los que SFRA 6.1.0 está instalado y la configuración de API de Open Commerce (OCAPI) está completa.
Ediciones necesarias
| Disponible en: Lightning Experience |
| Disponible en: Enterprise Edition, Performance Edition, Unlimited Edition y Developer Edition con Marketing de referencias |
Puede descargar el cartucho Marketing de referencias para Commerce en su sistema local desde GitHub.
Después de agregar el cartucho a su sistema local, utilice una Interfaz de línea de comandos (CLI) para agregar automáticamente el cartucho, o agregue el cartucho manualmente a su sitio de B2C Commerce.
Requisitos previos para utilizar la CLI para agregar el cartucho
- Obtenga las versiones compatibles de:
- Nodo.js: 14.21.3
- npm: Versión 6.14.18
- Descargue la Arquitectura de referencia frontal de tienda (SFRA) 6.2.0. Cambie el nombre de la carpeta a storefront-reference-architecture.
- Mueva la carpeta Referencia que descargó a la misma carpeta que contiene la carpeta storefront-reference-architecture.
- Ejecute npm ci y npm run compile:js && npm run compile:scss && npm run compile:fonts para la carpeta SFRA.
- Implemente sitios de demostración de Arquitectura de referencia de escaparate en su instancia:
- Navegue a Administración | Desarrollo de sitio | Importación y exportación de sitios .
- Seleccione Establecer sitios de demostración de Arquitectura de referencia y haga clic en Importar.
- Haga clic en Implementar.
- Otorgue acceso de clave de API a su instancia si está agregando el cartucho manualmente.
Para obtener más información, consulte la sección Otorgar acceso de clave de API a sus instancias en Salesforce Commerce Cloud CLI.
Agregar automáticamente el cartucho
- Configure estas variables de entorno en su sitio de B2C Commerce:
Variable Descripción SFCC_OAUTH_CLIENT_ID El Id. de cliente utilizado para la autenticación. El Id. de cliente está disponible en Gestor de cuentas. SFCC_OAUTH_CLIENT_SECRET El secreto de cliente utilizado para la autenticación. El secreto de cliente es la contraseña que creó al crear su Id. de cliente. SFCC_HOSTNAME El alias de su entorno sandbox. SFCC_CODE_VERSION La versión de código para la que desea agregar el cartucho. Puede encontrar la versión de código de su sitio en Administración | Implementación de código en Gestor de cuentas. SFCC_SITE_IDS El Id. del sitio de B2C Commerce al que agregar el cartucho. - Si dw.json está disponible en su carpeta referral-marketing-for-commerce/src/sfcc, elimínela.
- En su CLI, ejecute estos comandos:
- npm ci
- npm run compile:js && npm run compile:scss
- npm run -s deploy:auto
export SFCC_OAUTH_CLIENT_ID=xxxxxxa1-xxx2-xxx3-xxx4-xxxxxxxxx5 && \
export SFCC_OAUTH_CLIENT_SECRET=samplepassword && \
export SFCC_HOSTNAME=sandbox-01-inside-the-realm.cloudkicks.net && \
export SFCC_CODE_VERSION=version1
export SFCC_SITE_IDS="sampleSiteID"
Para Windows, este es un parámetro de variable de entorno de ejemplo:set SFCC_OAUTH_CLIENT_ID=xxxxxxa1-xxx2-xxx3-xxx4-xxxxxxxxx5 &&
set SFCC_OAUTH_CLIENT_SECRET=samplepassword &&
set SFCC_HOSTNAME=sandbox-01-inside-the-realm.cloudkicks.net &&
set SFCC_CODE_VERSION=version1
set SFCC_SITE_IDS=sampleSiteID
Agregar manualmente el cartucho
- Asegúrese de que dw.json está disponible en su carpeta referral-marketing-for-commerce/src/sfcc y contiene estas variables:
Variable Descripción client-id El Id. de cliente utilizado para la autenticación. El Id. de cliente está disponible en Gestor de cuentas. nombre de host El alias de su entorno sandbox. code-version La versión de código para la que desea agregar el cartucho. Puede encontrar la versión de código de su sitio en Administración | Implementación de código en Gestor de cuentas. site-ids Opcional. El Id. del sitio de B2C Commerce al que agregar el cartucho. password La contraseña que recibe cuando genera la clave de acceso para Acceso a archivos WebDav y UX Studio en Business Manager. username El nombre de usuario que utiliza para iniciar sesión en Business Manager. - En su CLI, ejecute estos comandos:
- npm ci
- npm run compile:js && npm run compile:scss
- npm run -s deploy
- Autentique si se le solicita.
{
"client-id": "xxxxxxa1-xxx2-xxx3-xxx4-xxxxxxxxx5",
"hostname": "sandbox-01-inside-the-realm.cloudkicks.net",
"code-version": "version1",
"site-ids": "sampleSiteID",
"password": "yourpwd",
"username": "mevans@cloudkicks.net"
}Ver el cartucho en el sitio de B2C Commerce
- Navegue a Gestor de cuentas.
- Haga clic en Administración | Sitios | Gestionar sitios .
- Abra el sitio al que agregó el cartucho y luego haga clic en Configuración.
El cartucho aparece en el campo Cartuchos.
Actualizar la credencial de servicio web
El cartucho agrega un servicio web denominado b2ccrmsync.RefArch a su sitio de B2C Commerce. Debe actualizar la credencial de servicio web con la clave de consumidor, el secreto de consumidor de la aplicación conectada y la URL de devolución de llamada de la aplicación conectada.
/success por /token en la URL de devolución de llamada.