Loading
Marketing de referencias
Cartucho Marketing de referencias para Commerce

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:
    1. Navegue a Administración | Desarrollo de sitio | Importación y exportación de sitios .
    2. Seleccione Establecer sitios de demostración de Arquitectura de referencia y haga clic en Importar.
    3. 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

  1. 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.
  2. Si dw.json está disponible en su carpeta referral-marketing-for-commerce/src/sfcc, elimínela.
  3. En su CLI, ejecute estos comandos:
    1. npm ci
    2. npm run compile:js && npm run compile:scss
    3. npm run -s deploy:auto
Ejemplo
Ejemplo Para MacOS y Linux, este es un parámetro de variable de entorno de ejemplo:
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

  1. 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.
  2. En su CLI, ejecute estos comandos:
    1. npm ci
    2. npm run compile:js && npm run compile:scss
    3. npm run -s deploy
  3. Autentique si se le solicita.
Ejemplo
Ejemplo Este es el aspecto de un archivo dw.json de muestra:
{
  "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

  1. Navegue a Gestor de cuentas.
  2. Haga clic en Administración | Sitios | Gestionar sitios .
  3. Abra el sitio al que agregó el cartucho y luego haga clic en Configuración.

El cartucho aparece en el campo Cartuchos.

Importante
Importante Si el cartucho no está disponible en el campo Cartucho, ingrese plugin_b2creferral:int_b2creferral:int_b2ccrmsync:app_storefront_base.

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.

Importante
Importante Al actualizar la credencial de servicio web, recuerde sustituir /success por /token en la URL de devolución de llamada.
 
Cargando
Salesforce Help | Article